Включение учетной записи Cosmos DB для использования Azure Synapse Link

  • 5 мин

Azure Synapse Link для Azure Cosmos DB — это облачная возможность HTAP, которая обеспечивает тесную интеграцию между Azure Cosmos DB и Azure Synapse Analytics.

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

На приведенной выше схеме показаны следующие ключевые функции Azure Synapse Link для архитектуры Cosmos DB:

  1. Контейнер Azure Cosmos DB предоставляет хранилище транзакций на основе строк, оптимизированное для операций чтения и записи.
  2. Контейнер также предоставляет аналитическое хранилище на основе столбцов, оптимизированное для аналитических рабочих нагрузок. Полностью управляемый процесс автосинхронизации обеспечивает синхронизацию хранилищ данных.
  3. Azure Synapse Link предоставляет связанную службу, которая подключает контейнер с поддержкой аналитического хранилища в Azure Cosmos DB к рабочей области Azure Synapse Analytics.
  4. Azure Synapse Analytics предоставляет среды выполнения Synapse SQL и Apache Spark, в которых можно запускать код для получения, обработки и анализа данных из аналитического хранилища Azure Cosmos DB без влияния на хранилище транзакций в Azure Cosmos DB.

Первым шагом при использовании Azure Synapse Link для Cosmos DB является включение его в учетной записи Azure Cosmos DB. Azure Synapse Link поддерживается в следующих типах учетной записи Azure Cosmos DB:

  • Azure Cosmos DB for NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB для Apache Gremlin (предварительная версия)

Azure Synapse Link можно включить на странице портала Azure для учетной записи Cosmos DB или с помощью Azure CLI или Azure PowerShell из командной строки или сценария.

Использование портала 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.

Совет

Для учетных записей NoSQL Для Azure Cosmos DB также есть ссылка на страницу "Данные Обозреватель".

Использование Azure CLI

Чтобы включить Azure Synapse Link с помощью Azure CLI, выполните командe az cosmosdb create (чтобы создать учетную запись Azure Cosmos DB) или команду az cosmosdb update (чтобы настроить существующую учетную запись Cosmos DB) с параметром --enable-analytical-storage true. Например, следующая команда обновляет существующую учетную запись Azure Cosmos DB с именем my-cosmos-db, чтобы включить Azure Synapse Link.

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

Чтобы включить Azure Synapse Link для учетной записи Apache Gremlin для Azure Cosmos DB, включите --capabilities EnableGremlin этот параметр.

Использование Azure PowerShell

Чтобы включить Azure Synapse Link с помощью PowerShell, выполните командлет New-AzCosmosDBAccount (чтобы создать учетную запись Azure Cosmos DB) или командлет Update-AzCosmosDBAccount (чтобы настроить существующую учетную запись Cosmos DB) с параметром -EnableAnalyticalStorage 1. Например, следующая команда обновляет существующую учетную запись Azure Cosmos DB с именем my-cosmos-db, чтобы включить Azure Synapse Link.

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

При планировании включения Azure Synapse Link для учетной записи Azure Cosmos DB учитывайте следующие факты:

  • После включения Azure Synapse Link для учетной записи ее нельзя отключить.

  • Включение Azure Synapse Link не запускает синхронизацию операционных данных с аналитическим хранилищем — вам также необходимо создать или обновить контейнер с поддержкой аналитического хранилища.

  • При включении Azure Synapse Link для учетной записи Cosmos DB для NoSQL с помощью Azure CLI или PowerShell можно использовать --analytical-storage-schema-type параметр (Azure CLI) или -AnalyticalStorageSchemaType (PowerShell), чтобы указать тип схемы как WellDefined (по умолчанию) или FullFidelity. Для учетной записи Cosmos DB для MongoDB используется тип схемы по умолчанию (и только поддерживается FullFidelity).

  • После назначения типа схемы его нельзя изменить.

    Примечание.

    Дополнительные сведения об аналитическом хранилище и его типах схем см. в следующем уроке.