共用方式為

連線至適用於 Azure Cosmos DB 的 Azure Synapse Link

  • 發行項

本文說明如何使用 Azure Synapse Link 從 Azure Synapse Analytics Studio 存取 Azure Cosmos DB 資料庫。

必要條件

將 Azure Cosmos DB 資料庫連線到工作區之前，您需要：

若要對 Azure Cosmos DB 執行大規模的分析，而不會影響您的作業效能，建議您啟用適用於 Azure Cosmos DB 的 Synapse Link。 Synapse Link 將 HTAP 功能帶入 Azure Synapse 中的容器和內建支援。

移至 Synapse Studio

從您的 Azure Synapse 工作區中，選取 [ 啟動 Synapse Studio]。 在 Synapse Studio 首頁上，選取 [數據]，這會帶您前往 [數據 物件總管]。

將 Azure Cosmos DB 資料庫連線至 Azure Synapse 工作區

將 Azure Cosmos DB 資料庫連線為連結服務。 使用 Azure Cosmos DB 連結服務，您可以流覽和探索 Azure Synapse Analytics 的 Apache Spark 或 SQL 中的數據、讀取和寫入至 Azure Cosmos DB。

從數據 物件總管，您可以依照下列步驟直接連線到 Azure Cosmos DB 資料庫：

  1. +選取 [數據] 附近的圖示。
  2. 選取 [ 連線到外部數據]。
  3. 選取您想要連線到的 API，例如 SQL API 或 MongoDB 的 API。
  4. 選取繼續。
  5. 使用易記名稱來命名連結的服務。 名稱會出現在數據 物件總管 中，並由 Azure Synapse 運行時間用來連線到資料庫和容器。
  6. 選取 Azure Cosmos DB 帳戶名稱和資料庫名稱。
  7. （選擇性）如果未指定任何區域，Azure Synapse 運行時間作業將會路由傳送至啟用分析存放區的最接近區域。 您也可以手動設定您希望使用者用來存取 Azure Cosmos DB 分析存放區的區域。 選取 [其他連線屬性]，然後選取 [ 新增]。 在 [屬性名稱] 底下，輸入 PreferredRegions。 將 [值 ] 設定為您想要的區域，例如 WestUS2。 （字組與數字之間沒有空格。
  8. 選取 建立。

Azure Cosmos DB 資料庫會出現在 [Azure Cosmos DB] 區段下方的 [連結] 索引標籤上。 透過 Azure Cosmos DB，您可以透過下列圖示，區分已啟用 HTAP 的容器與僅限 OLTP 的容器：

僅限 OLTP 的容器：

顯示 OLTP 容器圖示的視覺效果。

已啟用 HTAP 的容器：

顯示 HTAP 容器圖示的視覺效果。

快速與程式代碼產生的動作互動

在容器中按下滑鼠右鍵，您就會有觸發 Spark 或 SQL 運行時間的手勢清單。 寫入容器將會透過 Azure Cosmos DB 的交易存放區進行，並取用要求單位。

下一步