建立 Cosmos DB 的連結服務

已完成

當您擁有支援分析存放區的 Azure Cosmos DB 容器時,您可以在 Azure Synapse Analytics 工作區中建立連結服務,以連線到該容器。

若要建立 Azure Cosmos DB 分析資料存放區的連結服務,請使用 Azure Synapse Studio,並在 [資料] 頁面中選取 [連線到外部資料] 選項以新增連結服務,如下所示:

A screenshot of Azure Synapse Studio showing the Connect to external data page.

完成建立連結服務的步驟後,請選取 Azure Cosmos DB 帳戶類型,然後為連結服務指派有意義的名稱並提供必要的資訊,以連線到您的 Azure Cosmos DB 資料庫。

若要連線到 Azure Cosmos DB 資料庫,您可以使用下列任一驗證選項:

  • 帳戶金鑰:指定 Cosmos DB 帳戶的驗證金鑰。
  • 服務主體:使用 Azure Synapse Analytics 服務的身分識別。
  • 系統指派的受控識別:使用系統指派的受控識別。
  • 使用者受控識別:使用使用者定義的受控識別。

提示

如需在 Microsoft Entra ID 中使用受控識別的詳細資訊,請參閱 Azure 資源的受控識別是什麼?

建立連結服務之後,Azure Cosmos DB 資料庫及其容器將會出現在 Azure Synapse Studio 的 [資料] 頁面中,如下所示:

A screenshot of Azure Synapse Studio showing the Data page with an Azure Cosmos DB linked service.

注意

使用者介面會使用下列圖示,區分支援和不支援分析存放區的容器:

已啟用分析存放區 「未」啟用分析存放區
An icon showing interlocking rectangles and a bar chart. An icon showing interlocking rectangles but no bar chart.

您可以查詢沒有分析存放區的容器,但無法自 HTAP 解決方案的優點獲益,因為此解決方案會卸載來自作業資料存放區的分析查詢額外負荷。