快速入門：連線至適用於 Azure Cosmos DB 的 Azure Synapse Link
本文說明如何使用 Synapse Link 從 Azure Synapse Analytics Studio 存取 Azure Cosmos DB 資料庫。
必要條件
將 Azure Cosmos DB 帳戶連線到工作區之前，您需要一些事項。
- 現有的 Azure Cosmos DB 帳戶，或遵循本 快速入門建立新帳戶
- 現有的 Synapse 工作區，或遵循本 快速入門建立新的工作區
啟用 Azure Cosmos DB 分析存放區
若要對 Azure Cosmos DB 執行大規模的分析，而不會影響您的作業效能，建議您啟用適用於 Azure Cosmos DB 的 Synapse Link。 此函式會將 HTAP 功能帶入 Azure Synapse 中的容器和內建支援。 請遵循本快速入門來啟用適用於 Azure Cosmos DB 容器的 Synapse Link。
流覽至 Synapse Studio
從您的 Synapse 工作區中，選取 [ 啟動 Synapse Studio]。 在 Synapse Studio 首頁上，選取 [數據]，這會帶您前往 [數據 物件總管]。
將 Azure Cosmos DB 資料庫連線到 Synapse 工作區
將 Azure Cosmos DB 資料庫連線為連結服務。 Azure Cosmos DB 連結服務可讓用戶流覽和探索 Azure Synapse Analytics 或 SQL 的 Apache Spark 中的數據、讀取和寫入至 Azure Cosmos DB。
從數據 物件總管，您可以執行下列步驟，直接連線 Azure Cosmos DB 資料庫：
- 選取 + 數據附近的圖示
- 選取[ 連線到外部資料]
- 選取您要連線的 API：SQL 或 MongoDB
- 選取 [繼續]
- 將連結服務命名為 。 名稱會顯示在 物件總管 中，並供 Synapse 執行時間用來連線到資料庫和容器。 我們建議使用易記名稱。
- 選取 Cosmos DB 帳戶名稱和資料庫名稱
- （選擇性）如果未指定任何區域，Synapse 執行時間作業將會路由傳送至啟用分析存放區的最接近區域。 不過，您可以手動設定您希望使用者存取 Azure Cosmos DB 分析存放區的區域。 選取 [其他連線屬性]，然後選取 [新增]。 在 [屬性名稱] 下，撰寫 PreferredRegions 並將 [值] 設定為您想要的區域（例如：WestUS2，單字和數字之間沒有空格）
- 選取 [建立]
Azure Cosmos DB 資料庫會顯示在 [Azure Cosmos DB] 區段中的 [連結] 索引卷標底下。 您可以使用下列圖示，區分已啟用 HTAP 的 Azure Cosmos DB 容器與僅限 OLTP 容器：
Synapse 容器：
僅限 OLTP 容器：
快速與程式代碼產生的動作互動
當您以滑鼠右鍵按兩下容器時，將會有一份手勢清單，以觸發Spark或 SQL 執行時間。 寫入容器將會透過 Azure Cosmos DB 的交易存放區進行，並取用要求單位。