使用 Microsoft Purview 設定事件中樞以傳送和接收 Atlas Kafka 主題訊息

重要事項

先前Azure Purview) (Microsoft Purview 整合式目錄 和傳統 Microsoft Purview 資料控管功能即將淘汰。 Microsoft 正在 Microsoft Fabric 中合併其資料控管功能。 您無法再建立新帳戶,現有功能將維持在維護模式,直到 2027 年 11 月 12 日為止。 如需淘汰時間表、轉換指引,以及建議的後續步驟,請參閱 Microsoft Purview 資料控管淘汰公告。

本文說明如何設定 Microsoft Purview,以便能夠使用 Azure 事件中樞傳送和接收 Atlas Kafka 主題事件。

如果您已設定環境,請瞭解如何開始使用 Azure。Messaging.EventHubs .NET 程式庫來傳送和接收訊息。

必要條件

若要設定您的環境,您需要具備某些必要條件:

  • Microsoft Azure 訂閱。 若要使用 Azure 服務,包括事件中樞,您需要 Azure 訂閱。 如果您沒有 Azure 帳戶,您可以註冊免費試用,或在建立帳戶時使用 MSDN 訂閱者權益。
  • 有效的 Microsoft Purview 帳戶。

設定事件中樞

若要傳送或接收 Atlas Kafka 主題訊息,您必須設定至少一個事件中樞命名空間。 您可以:

注意事項

如果您的 Microsoft Purview 帳戶是在 2022 年 12 月 15 日之前建立,則可能已有受管理的事件中樞資源與您的帳戶相關聯。 您可以在 Azure 入口網站中 Microsoft Purview 帳戶頁面上的設定底下簽入受管理的資源。 螢幕擷取畫面,顯示在 Azure 入口網站中 Microsoft Purview 帳戶頁面的 [受管理的資源] 頁面上醒目提示的 [事件中樞] 命名空間切換。

  • 如果您沒有看到此資源,或其已 停用,請按照以下步驟設定您的事件中樞。

  • 如果 已啟用,您可以視需要繼續使用此受管理的事件中樞命名空間。 (有相關成本。請參閱 價格頁面。) 如果您想要管理自己的事件中樞帳戶,必須先 停用 此功能,然後遵循下列步驟。 若要讓事件中樞支援的 TLS 版本保持最新,建議您使用 BYO 事件中樞。如果您停用受控事件中樞資源,將無法重新啟用受控事件中樞資源。您只能設定自己的事件中樞。

自備事件中樞命名空間

您可以使用事件中樞設定現有的 Azure 事件中樞命名空間,或建立新的命名空間來與 Microsoft Purview 連線。

事件中樞權限

若要向事件中樞進行驗證,您可以使用:

  • Microsoft Purview 受控身分識別 (建議)
  • 使用者指派的受控識別 - 只有在帳戶建立後設定命名空間時 ,以及 在開放式網路中使用事件中樞時才能使用。

這些身分識別 至少需要事件中樞的參與者權限 ,才能將它們設定為與 Microsoft Purview 搭配使用。

事件中樞網路

  1. 如果您的 Microsoft Purview 帳戶使用私人端點,請 設定擷取私人端點以連線到事件中樞。

  2. 您的事件中樞工作區網路必須以下列兩種方式之一進行設定:

    • 公用網路存取 設定為 [ 選取的網路] 或 [已停用], [允許信任的 Microsoft 服務繞過此防火牆] 設定為 [是],並使用 Microsoft Purview 受控身分識別進行驗證。
    • 公用網路存取 設定為 [所有網路 ],並使用 Microsoft Purview 受控身分識別或使用者指派的受控身分識別進行驗證。

    Microsoft Purview 做為受信任服務的狀態表示,只要事件中樞資源上的 [允許受信任的 Microsoft 服務略過此防火牆] 設定為 [是 ],您的勾點仍然可以接收來自事件中樞的訊息。

事件中樞網路流程圖,顯示透過所有網路或啟用受信任服務的成功路徑。

如需事件中樞網路的詳細資訊,請參閱 Azure 事件中樞文件。

設定事件中樞以發佈訊息至 Microsoft Purview

  1. 在 Azure 入口網站中,瀏覽至 Microsoft Purview 帳戶頁面上 [設定] 下的 [Kafka 設定]。

    螢幕擷取畫面顯示 Azure 入口網站中 Microsoft Purview 功能表中的 Kafka 設定選項。

  2. 選取 [新增設定 ] 和 [勾點設定]。

    注意事項

    您可以視需要新增任意數量的掛勾設定。

    顯示 [Kafka 設定] 頁面的螢幕擷取畫面,其中醒目提示 [新增設定] 和 [掛勾設定] 。

  3. 為您的勾點設定命名、選取您的訂閱、現有的事件中樞命名空間、要向其傳送通知的現有事件中樞、您想要使用的消費者群組,以及您想要使用的驗證類型。

    提示

    您可以多次使用相同的事件中樞命名空間,但每個設定都需要自己的事件中樞。

    顯示已填入所有值的勾點設定頁面的螢幕擷取畫面。

  4. 選取 [儲存]。 組態需要幾分鐘的時間完成。

  5. 設定完成後,您就可以開始發佈 訊息至 Microsoft Purview 的步驟。

設定事件中樞以接收來自 Microsoft Purview 的訊息

  1. 在 Azure 入口網站中,瀏覽至 Microsoft Purview 帳戶頁面上 [設定] 下的 [Kafka 設定]。

    螢幕擷取畫面顯示 Azure 入口網站中 Microsoft Purview 功能表中的 Kafka 設定選項。

  2. 如果有設定列為類型 通知,則已設定事件中樞,您可以開始接收 Microsoft Purview 訊息的步驟。

    注意事項

    一次只能設定一個 通知 事件中樞。

    顯示 Kafka 設定選項的螢幕擷取畫面,其中通知類型設定已準備就緒。

  3. 如果尚未列出 通知設定, 請選取 [新增設定 ] 和 [通知設定]。

    顯示 [Kafka 設定] 頁面的螢幕擷取畫面,其中醒目提示 [新增設定] 和 [通知設定] 。

  4. 為您的通知設定命名、選取您的訂閱、現有的事件中樞命名空間、要向其傳送通知的現有事件中樞、您想要使用的磁碟分割,以及您想要使用的驗證類型。

    提示

    您可以多次使用相同的事件中樞命名空間,但每個設定都需要自己的事件中樞。

    顯示已填入所有值的 [通知中樞設定] 頁面的螢幕擷取畫面。

  5. 選取 [儲存]。 組態需要幾分鐘的時間完成。

  6. 設定完成後,您就可以開始 接收 Microsoft Purview 訊息的步驟。

移除已設定的事件中樞

若要移除已設定的事件中樞命名空間,請遵循下列步驟:

  1. 在 Azure 入口網站中搜尋並開啟您的 Microsoft Purview 帳戶。

  2. 在 Azure 入口網站中,您在 Microsoft Purview 帳戶頁面上的設定下,選取 [Kafka 設定]。

  3. 選取您要停用的事件中樞。 (Hook 中樞會傳送訊息至 Microsoft Purview。通知中樞會收到通知。)

  4. 選取 [移除] 以儲存選擇並開始停用程序。 這可能需要幾分鐘才能完成。

    螢幕擷取畫面顯示 Azure 入口網站中 Microsoft Purview 帳戶頁面的 Kafka 設定頁面,其中醒目提示 [移除] 按鈕。

建立受管理的命名空間

如果您想要擁有受管理的事件中樞命名空間,您必須使用 REST API 來設定您的帳戶。

您可以使用下列指令碼 (設定 apiVersion = 2021-12-01) 來更新帳戶,這種方式只會影響事件中樞設定:

$body = @{"properties" = @{ "managedEventHubState" = "Enabled" }; "location" = $($location); "identity" = @{ "type"= $($type) } } | ConvertTo-Json
$Token=Get-AzAccessToken
$Headers = @{ "Authorization" = "Bearer $($Token.Token)" }
$Uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($rg)/providers/Microsoft.Purview/accounts/$($accountName)?api-version=$($apiVersion)"

Invoke-WebRequest -URI $Uri -Method Put -Body $body -Headers $Headers -ContentType "application/json"

後續步驟