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

重要事項

僅淘汰 Microsoft Purview 資料控管功能

Microsoft Purview 統一目錄和傳統 Microsoft Purview 資料控管功能 (先前的 Azure Purview) 即將淘汰。 整個 Microsoft Purview 並未淘汰。 Microsoft Purview 資料安全性與合規性功能不受此公告影響,且 Microsoft 會繼續投資於此功能。

Microsoft 正在 Microsoft Fabric 中合併 其資料控管 功能。 無法再建立新的 Microsoft Purview 資料控管帳戶,而且現有的資料控管功能將維持在維護模式,直到 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"

後續步驟