啟用 Cosmos DB 帳戶以使用 Azure Synapse Link

5 分鐘

適用於 Azure Cosmos DB 的 Azure Synapse Link 是雲端原生 HTAP 功能，可啟用 Azure Cosmos DB 與 Azure Synapse Analytics 之間的整合。

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and Azure Synapse Analytics.

上圖說明適用於 Cosmos DB 的 Azure Synapse Link 架構的下列主要功能：

Azure Cosmos DB 容器能提供針對讀取/寫入作業最佳化的資料列型交易式存放區。
該容器也能提供針對分析工作負載最佳化的資料行型分析存放區。完全受控的自動同步程序能讓資料存放區保持同步。
Azure Synapse Link 提供能將 Azure Cosmos DB 中已啟用分析存放區的容器連線到 Azure Synapse Analytics 工作區的連結服務。
Azure Synapse Analytics 能提供 Synapse SQL 和 Apache Spark 執行階段，您可以在其中執行程式碼，以從 Azure Cosmos DB 分析存放區擷取、處理和分析資料，而不會影響 Azure Cosmos DB 中的交易資料存放區。

在 Azure Cosmos DB 中啟用 Azure Synapse Link

使用 Cosmos DB 的 Azure Synapse Link 時，第一個步驟是在 Azure Cosmos DB 帳戶中啟用 Azure Synapse Link。下列 Azure Cosmos DB 帳戶類型支援 Azure Synapse Link：

適用於 NoSQL 的 Azure Cosmos DB
Azure Cosmos DB for MongoDB
Azure Cosmos DB for Apache Gremlin (預覽)

您可以在 [Azure 入口網站] 頁面中為 Cosmos DB 帳戶啟用 Azure Synapse Link，也可以從命令列或指令碼使用 Azure CLI 或 Azure PowerShell 來啟用 Azure Synapse Link。

使用 Azure 入口網站

在 Azure 入口網站中，您可以在 [整合] 區段中的 [Azure Synapse Link] 頁面上，為 Cosmos DB 帳戶啟用 Azure Synapse Link ，如下所示。

A screenshot showing the option to enable Azure Synapse Link for a Cosmos DB for NoSQL account.

提示

針對 Azure Cosmos DB for NoSQL 帳戶，[資料總管] 頁面上也有連結。

使用 Azure CLI

若要使用 Azure CLI 啟用 Azure Synapse Link，請執行 az cosmosdb create 命令 (建立新的 Cosmos DB 帳戶) 或執行具有 --enable-analytical-storage true 參數的 az cosmosdb update 命令 (設定現有的 Cosmos DB 帳戶)。例如，下列命令會更新名為 my-cosmos-db 的現有 Cosmos DB 帳戶，以啟用 Azure Synapse Link。

az cosmosdb update --name my-cosmos-db --resource-group my-rg --enable-analytical-storage true

若要為 Azure Cosmos DB for Apache Gremlin 帳戶啟用 Azure Synapse Link，請包含 --capabilities EnableGremlin 參數。

使用 Azure PowerShell

若要使用 Azure PowerShell 啟用 Azure Synapse Link，請執行 New-AzCosmosDBAccount Cmdlet (建立新的 Cosmos DB 帳戶) 或執行具有 -EnableAnalyticalStorage 1 參數的 Update-AzCosmosDBAccount Cmdlet (設定現有的 Cosmos DB 帳戶)。例如，下列命令會更新名為 my-cosmos-db 的現有 Cosmos DB 帳戶，以啟用 Azure Synapse Link。

Update-AzCosmosDBAccount -Name "my-cosmos-db" -ResourceGroupName "my-rg" -EnableAnalyticalStorage 1

啟用 Azure Synapse Link 的考量事項

規劃為 Cosmos DB 帳戶啟用 Azure Synapse Link 時，請考量下列事實：

為帳戶啟用 Azure Synapse Link 之後，您無法將其停用。
啟用 Azure Synapse Link 不會開始將操作資料同步處理至分析存放區 - 您必須也建立或更新具有分析存放區支援的容器。
使用 Azure CLI 或 PowerShell 為 Cosmos DB for NoSQL 帳戶啟用 Azure Synapse Link 時，您可以使用 --analytical-storage-schema-type (Azure CLI) 或 -AnalyticalStorageSchemaType (PowerShell) 參數，將結構描述類型指定為 WellDefined (預設) 或 FullFidelity。針對適用於 MongoDB 的 Cosmos DB 帳戶，預設的 (且僅支援的) 結構描述類型為 FullFidelity。
指派結構描述類型之後，您無法加以變更。

注意

您會在下個單元中深入了解分析存放區及其結構描述類型。

繼續