將 Azure IoT 中樞 資源新增到事件流

本文將示範如何將 Azure IoT 中樞 來源加入 Microsoft Fabric 事件串流。

先決條件

• 以 Fabric 容量授權模式或試用授權模式（Contributor 或更高權限）存取工作空間。

• 取得物聯網中樞存取金鑰的適當權限。 如果你的物聯網中樞位於受保護的網路中，請使用受管理的私有端點連接。 否則，請確保物聯網中樞對外開放，且不設於防火牆後方。

• 取得物聯網中樞存取金鑰的適當權限。 如果你的物聯網中樞位於受保護的網路中，請透過 串流 vNet 資料閘道器連接。 否則，請確保物聯網中樞對外開放，且不設於防火牆後方。

• 事件流。 如果你沒有事件串流，就 建立一個。

啟動選擇資料來源的嚮導

如果你還沒在事件串流中新增任何來源，請選擇 「連接資料來源 」磁貼。 你也可以選擇在色帶上選擇「新增來源>」連接資料來源。

如果你是將原始碼加入已發布的事件串流，請切換到 編輯 模式。 在功能區上，選擇 新增來源>連接資料來源。

在 Select a data source 頁面，搜尋 Azure IoT 中樞。 在 Azure IoT 中樞 圖塊上，選擇 Connect。

設定 Azure IoT 中樞 連接器

1. 在連線頁面上，選取新增連線。

   

   如果已有連接到你的物聯網集線器，選擇該連線，然後在接下來的步驟中設定 資料格式 。

   

2. 在 Connection settings 設定區段中，為 IoT 中樞 指定你的 IoT hub 的名稱。

   

3. 在 連線憑證 區，請依照以下步驟操作：

   1. 如果有現有的連線，請從下拉式清單中選取它。 如果沒有，請確認已針對此選項選取 [ 建立新連線 ]。

   2. 針對 [ 連線名稱]，輸入IoT中樞連線的名稱。

   3. 針對 [ 驗證種類]，確認已 選取 [共用存取密鑰 ]。

   4. 針對 [共用存取金鑰名稱]，輸入共用存取金鑰的名稱。

   5. 針對 [共用存取金鑰]，輸入共用存取金鑰的值。

      要取得共享存取金鑰的名稱與值，請依照以下步驟操作：

      1. 請前往 Azure 入口網站中關於你的物聯網中樞的頁面。
      2. 在左側窗格，在 安全性設定中選擇 共享存取政策。
      3. 從清單中選擇保單名稱。 記下原則名稱。
      4. 選擇主鍵旁的 [複製]按鈕。

      

4. 選擇 連線。

   

5. 對於 消費者群組，請輸入消費者群組的名稱。 物聯網樞紐的預設消費者群組是 $Default。

6. 在資料 格式中，選擇你想從物聯網樞紐接收的即時事件資料格式。 你可以選擇 JSON、Avro 和 CSV 資料格式。 然後選取 [Connect]。

串流或來源詳情

1. 在 Connect 頁面，根據你使用的是 Eventstream 還是 Real-Time hub，依照以下步驟進行。

   • Eventstream：

     在右側 的來源詳情 窗格中，請依照以下步驟操作：

     1. 對於 來源名稱，請選擇 鉛筆 按鈕來更改名稱。

     2. 請注意，事件流名稱 和 串流名稱 為唯讀。

   • 實時樞紐：

     在右側的 [串流詳細數據 ] 區段中，遵循下列步驟：

     1. 選擇你想建立事件串流的 Fabric workspace。

     2. 對於 事件串流名稱，請選擇 鉛筆 按鈕，並輸入事件串流的名稱。

     3. 串流名稱的值會自動為您生成，方法是將-stream附加到事件流名稱上。 當嚮導結束時，這條串流會出現在即時集線器的 「所有資料串流」 頁面上。

2. 在「配置」頁面底部選擇「下一步」。

評論與連結

在 Review + connect 畫面，檢視摘要，選擇 新增 （事件串流）或 連接 （Real-Time hub）。

1. 在 [ 連線 ] 頁面上，針對 [功能層級]，選取 [擴充功能 （預覽版）]。

   

   如果已有連接到你的 Azure IoT 中樞，選擇該連線，然後進入設定 Azure IoT 中樞 資料來源的步驟。

2. 在Connection settings區塊，輸入你的Azure IoT 中樞名稱：

   

3. 在 [ 連線認證 ] 區段中，執行下列步驟：

   1. 如果有現有的連線，請從下拉式清單中選取它。 如果沒有，請確認已針對此選項選取 [ 建立新連線 ]。

   2. 對於 Connection 名稱，請輸入與IoT 中樞的連線名稱。

   3. 對於 Data gateway，請根據您的IoT 中樞網路設定選擇適當的選項：

      • 如果你的IoT 中樞是公開的，請選擇none。
      • 如果你的IoT 中樞在私人網路下，想透過串流虛擬網路資料閘道連接，請選擇串流 vNet 資料閘道（前綴為 [Streaming VNet]）。 你可以選擇更新圖示，以列出新建立的閘道器。

      備註

      若選擇資料閘道器，請跳過此連線建立精靈中的測試連線步驟。

   4. 對於 認證類型，預設值為 共享存取金鑰。

   5. 針對 [共用存取金鑰名稱]，輸入共用存取金鑰的名稱。

   6. 針對 [共用存取金鑰]，輸入共用存取金鑰的值。

   7. 選取頁面底部的 [連線]。

      

      若要取得存取金鑰名稱和值，請遵循下列步驟：

      1. 請前往Azure入口網站的IoT 中樞頁面，查看您的Azure IoT 中樞。

      2. 在 [IoT 中樞] 頁面上，選取左側導覽功能表上 [安全性設定] 底下的 [共用存取原則]。

      3. 從清單中選取原則 名稱 。 記下原則名稱。

      4. 選擇主鍵旁的 [複製]按鈕。

         

4. 現在，在精靈的 [ 連線 ] 頁面上，針對 [ 取用者] 群組輸入取用者群組的名稱。 預設情況下，會選擇 $Default，這是該IoT 中樞的預設消費者群組。

5. 對於 起始位置，選擇在資料流中從哪裡開始讀取紀錄。

6. 然後，選取頁面底部的 下一步 。

   

7. 在 [ 檢閱 + 連線 ] 頁面上，選取 [立即 新增 ]。

   

串流或來源詳情

1. 在 Connect 頁面，根據你使用的是 Eventstream 還是 Real-Time hub，依照以下步驟進行。

   • Eventstream：

     在右側 的來源詳情 窗格中，請依照以下步驟操作：

     1. 對於 來源名稱，請選擇 鉛筆 按鈕來更改名稱。

     2. 請注意，事件流名稱 和 串流名稱 為唯讀。

   • 實時樞紐：

     在右側的 [串流詳細數據 ] 區段中，遵循下列步驟：

     1. 選擇你想建立事件串流的 Fabric workspace。

     2. 對於 事件串流名稱，請選擇 鉛筆 按鈕，並輸入事件串流的名稱。

     3. 串流名稱的值會自動為您生成，方法是將-stream附加到事件流名稱上。 當嚮導結束時，這條串流會出現在即時集線器的 「所有資料串流」 頁面上。

2. 在「配置」頁面底部選擇「下一步」。

備註

只有當你使用以下類型時，事件串流最多可支援 11 個合併的來源與目的地：

• 來源：自定義端點。
• 目的地：自訂端點與事件屋，並可直接擷取。

未包含在前述清單中的來源或目的地，以及未附加在預設串流中的目的地，不計入此限制。

查看更新後的事件串流

1. 請確認已將 Azure IoT 中樞 來源加入到你的畫布上的事件串流中，並切換到 Edit 模式。 要實作這個新加入的物聯網中樞，請在功能區選擇 發佈 。

   

2. 物聯網中樞可在 即時 檢視中進行視覺化。 在圖中選擇 物聯網樞紐 圖塊，顯示類似以下範例的頁面。

   

相關內容

• 有關支援來源的清單，請參見 「新增與管理事件串流中的事件來源」。