教學課程：使用命名空間主題將 MQTT 訊息路由傳送至 Azure 事件中樞 （Azure 入口網站）

在本教學課程中，您將瞭解如何使用命名空間主題，將數據從 MQTT 用戶端路由傳送至 Azure 事件中樞。 高階步驟如下：

必要條件

• 如果您沒有 Azure 訂用帳戶，請在開始之前建立 Azure 免費帳戶 。
• 如果您不熟悉事件方格，請先閱讀 事件方格概觀 ，再開始本教學課程。
• 根據註冊事件方格資源提供者中的 步驟，註冊事件方格資源提供者。
• 請確定您的防火牆中已開啟埠 8883 。 本教學課程中的範例會使用透過埠 8883 通訊的 MQTT 通訊協定。 在某些公司和教育網路環境中，此埠可能會遭到封鎖。

在 Azure 入口網站中建立命名空間

Azure 事件方格中的命名空間是一或多個主題、用戶端、用戶端群組、主題空間和權限繫結的邏輯容器。 提供唯一的命名空間，可讓您在相同 Azure 區域中擁有多個資源。 有了 Azure 事件方格命名空間，您現在可以將相關資源分組在一起，並以 Azure 訂用帳戶中單一單位的形式進行管理。

請遵循下列各節來建立、檢視及管理 Azure 事件方格命名空間。

若要建立命名空間：

1. 登入 Azure 入口網站。

2. 在 [搜尋方塊] 中，輸入 [事件方格命名空間]，然後從結果中選取 [事件方格命名空間]。

   

3. 在 [事件方格命名空間] 頁面上，選取工具列上的 [+ 建立]。

   

4. 在 [基本] 頁面上，遵循下列步驟。

   1. 選取您要在其中建立命名空間的 [Azure 訂用帳戶]。

   2. 選取現有的資源群組，或建立資源群組。

   3. 輸入命名空間的名稱。

   4. 選取您要在其中建立命名空間的區域或 [位置]。

   5. 選取頁面底部的 [檢閱 + 建立] 。

      

5. 在 [檢閱 + 建立] 分頁上檢閱設定，然後選取 [建立]。

6. 在 [部署成功] 頁面上，選取 [移至資源] 以瀏覽至您的命名空間。

建立命名空間主題

1. 如果您不在 [事件方格命名空間] 頁面上，請遵循 [建立、檢視和管理命名空間] 步驟來檢視您想要用來建立主題的命名空間。

2. 在 [事件方格命名空間] 頁面上，選取左側功能表上 [事件] 區段中的 [主題] 選項。

3. 在 [主題] 頁面上，選取命令列上的 [+ 主題] 按鈕。

   

4. 在 [建立主題] 頁面上，輸入您要建立的主題名稱，然後選取 [建立]。

   

啟用事件方格命名空間的受控識別

1. 在 [事件方格命名空間] 頁面上，選取左側功能表上 設定 下的 [身分識別]。

2. 開啟 參數以啟用系統指派的受控識別。

3. 選取工具列上的 [儲存] 來儲存設定。

   

4. 選取確認訊息上的 [是]。

5. 確認您看到系統指派的受控識別的物件識別碼，並查看指派角色的連結。

   

   檢查入口網站中的通知，以確認命名空間已啟用受控識別。

啟用事件方格命名空間的 MQTT 訊息代理程式

1. 在 [事件方格命名空間] 頁面上，選取左側功能表上 設定 下的 [組態]。

2. 選取 [啟用 MQTT 訊息代理程式] 旁的複選框。

3. 選取 頁面底部的 [套用 ]。

   

   檢查入口網站中的通知，以確認已針對命名空間啟用 MQTT 訊息代理程式。

在網頁瀏覽器或個別視窗中的個別索引標籤中，使用 Azure 入口網站 建立事件中樞命名空間與事件中樞。

建立事件中樞命名空間

事件中樞命名空間提供唯一的範圍容器，您可以在其中一個或多個事件中樞。 若要使用入口網站在您的資源群組中建立命名空間，請執行下列動作：

1. 在 Azure 入口網站中，選取左側功能表中的 [所有服務] ，然後選取 [分析] 類別中 [事件中樞] 旁邊的 星號 (*)。 確認 [事件中樞] 已新增至左側導覽功能表中的 [我的最愛]。

   

2. 選取左側導覽功能表中 [我的最愛] 下方的 [事件中樞]，然後選取工具列上的 [建立]。

   

3. 在 [建立命名空間] 頁面上，採取下列步驟：

   1. 選取您要在其中建立命名空間的訂用帳戶。

   2. 選取您在上一個步驟中建立的資源群組。

   3. 輸入命名空間的名稱。 系統會立即檢查此名稱是否可用。

   4. 選取命名空間的位置。

   5. 選擇 [基本] 作為定價層。 如果您打算從 Apache Kafka 應用程式使用命名空間，請使用標準層。 基本層不支援 Apache Kafka 工作負載。 若要了解各層之間的差異，請參閱配額和限制、事件中樞進階版和事件中樞專用版文章。

   6. 將輸送量單位 (標準層) 或處理單位 (進階層) 設定保留為原本的值。 了解輸送量單位或處理單位：事件中樞可擴縮性。

   7. 選取頁面底部的 [檢閱 + 建立]。

      

   8. 在 [檢閱 + 建立] 頁面上檢閱設定，然後選取 [建立]。 等待部署完成。

4. 在 [部署] 頁面上，選取 [移至資源] 以瀏覽至您命名空間的頁面。

   

5. 確認您看到的 [事件中樞命名空間] 頁面類似下列範例：

   

建立事件中樞

若要在命名空間內建立事件中樞，請執行下列動作：

1. 在[概觀] 頁面上，選取命令列上的 [+ 事件中樞]。

   

2. 輸入事件中樞的名稱，然後選取 [檢閱 + 建立]。

   

3. 在 [檢閱 + 建立] 頁面上，選取 [建立]。

4. 您可以檢查警示中事件中樞建立的狀態。 建立事件中樞之後，您會在事件中樞清單中看到該中樞。

   

為事件方格命名空間提供將事件傳送至事件中樞的存取權

1. 在 [事件中樞命名空間] 頁面上，選取左側功能表上的 [存取控制 (IAM)]。

2. 在 [訪問控制] 頁面上，選取命令行上的 [+ 新增]，然後選取 [新增角色指派]。

   

3. 在 [新增角色指派] 頁面上，從角色清單中選取 [Azure 事件中樞 數據發件人]，然後選取頁面底部的 [下一步]。

   

4. 在 [ 成員] 頁面上，遵循下列步驟：

   1. 針對 [ 指派存取權] 字段，選取 [ 受控識別]。

   2. 選擇 [ + 選取成員]。

      

5. 在 [選取受控識別] 頁面上，遵循下列步驟：

   1. 選取您的 Azure 訂用帳戶。

   2. 針對 [受控識別]，選取 [事件方格命名空間]。

   3. 選取與事件方格命名空間同名的受控識別。

   4. 選擇頁面底部的 [ 選取 ]。

      

6. 在 [ 新增角色指派 ] 頁面上，選取頁面底部的 [ 檢閱 + 指派 ]。

7. 在 [檢閱 + 指派] 頁面，選取 [檢閱 + 指派]。

使用事件中樞作為端點建立事件訂用帳戶

1. 切換至已開啟事件方格命名空間的網頁瀏覽器視窗索引標籤。

2. 在 [ 事件方格命名空間] 頁面上，選取 左側功能表上的 [主題]。

3. 在 [ 主題] 頁面上，選取您稍早建立的命名空間主題。

   

4. 在 [ 事件方格命名空間主題 ] 頁面上，選取 頂端命令行上的 [+ 訂用帳戶 ]。

   

5. 在 [ 建立訂用帳戶] 頁面上，遵循下列步驟：

   1. 輸入事件訂閱的 [名稱]。

   2. 針對 [ 傳遞模式]，選取 [ 推送]。

   3. 確認 [端點類型 ] 已設定為 [事件中樞]。

   4. 選取 [ 設定端點]。

      

   5. 在 [選取事件中 樞] 上，遵循下列步驟：

      1. 選取具有事件中 樞的 Azure 訂 用帳戶。

      2. 選取具有事件中 樞的資源群組 。

      3. 選取事件中 樞命名空間。

      4. 選取 事件中樞命名空間中的事件中樞 。

      5. 然後，選取 [ 確認選取專案]。

         

   6. 回到 [建立訂用帳戶] 頁面，選取 [為受控識別類型指派的系統]。

   7. 選取 頁面底部的 [建立 ]。

      

在事件方格命名空間中設定路由

1. 在 [事件方格命名空間主題] 頁面的 [基本資訊] 區段中選取命名空間，或在頂端的階層連結功能表中選取命名空間名稱，以巡覽回事件方格命名空間頁面。

2. 在 [事件方格命名空間] 頁面上，選取 MQTT 訊息代理程式區段中左側功能表上的 [路由]。

3. 在 [ 路由 ] 頁面上，選取 [ 啟用路由]。

4. 針對 [ 主題類型]，選取 [命名空間主題]。

5. 針對 [主題]，選取您所建立的事件方格命名空間主題，以路由傳送所有 MQTT 訊息。

6. 選取套用。

   

   檢查通知以確認命名空間已啟用路由資訊。

建立客戶端、主題空間和許可權系結

請遵循快速入門： 發佈和訂閱 MQTT 主題 中的步驟，以：

1. 建立用戶端。 如果您想要，您可以建立第二個用戶端，但這是選擇性的。

2. 建立主題空間。

3. 建立發行者和訂閱者許可權系結。

4. 使用 MQTTX 傳送一些訊息。

5. 確認事件中樞已在事件中樞命名空間的 [概觀] 頁面上收到這些訊息。

   

使用串流分析查詢檢視事件中樞的路由 MQTT 訊息

在 Azure 入口網站 中，流覽至事件訂用帳戶內的事件中樞實例（事件中樞）。 使用串流分析處理事件中樞的數據。 如需詳細資訊，請參閱使用串流分析處理來自 Azure 事件中樞 的數據 - Azure 事件中樞 |Microsoft Learn。 您可以在查詢中看到 MQTT 訊息。

下一步

如需程式代碼範例，請移至 此 GitHub 存放庫。