Habilitar a conta do Cosmos DB para usar o Azure Synapse Link

  • 5 minutos

O Azure Synapse Link for Azure Cosmos DB é um recurso HTAP nativo da nuvem que permite a integração entre o Azure Cosmos DB e o Azure Synapse Analytics.

Um diagrama mostrando a integração do Azure Synapse Link com o Azure Cosmos DB e o Azure Synapse Analytics.

No diagrama acima, os seguintes recursos principais da arquitetura do Azure Synapse Link for Cosmos DB são ilustrados:

  1. Um contêiner do Azure Cosmos DB fornece um repositório transacional baseado em linha que é otimizado para operações de leitura/gravação.
  2. O contêiner também fornece um armazenamento analítico baseado em colunas que é otimizado para cargas de trabalho analíticas. Um processo de sincronização automática totalmente gerenciado mantém os armazenamentos de dados sincronizados.
  3. O Azure Synapse Link fornece um serviço vinculado que conecta o contêiner habilitado para armazenamento analítico no Azure Cosmos DB a um espaço de trabalho do Azure Synapse Analytics.
  4. O Azure Synapse Analytics fornece tempos de execução Synapse SQL e Apache Spark nos quais você pode executar código para recuperar, processar e analisar dados do repositório analítico do Azure Cosmos DB sem afetar o armazenamento de dados transacionais no Azure Cosmos DB.

A primeira etapa para usar o Azure Synapse Link for Cosmos DB é habilitá-lo em uma conta do Azure Cosmos DB. O Azure Synapse Link é suportado nos seguintes tipos de conta do Azure Cosmos DB:

  • Azure Cosmos DB para NoSQL
  • Azure Cosmos DB para MongoDB
  • Azure Cosmos DB para Apache Gremlin (visualização)

Você pode habilitar o Azure Synapse Link na página do portal do Azure para sua conta do Cosmos DB ou usando a CLI do Azure ou o Azure PowerShell em uma linha de comando ou em um script.

Utilizar o portal do Azure

No portal do Azure, você pode habilitar o Azure Synapse Link para uma conta do Cosmos DB na página Azure Synapse Link na seção Integrações , conforme mostrado abaixo.

Uma captura de tela mostrando a opção para habilitar o Azure Synapse Link para uma conta do Cosmos DB para NoSQL.

Gorjeta

Para contas do Azure Cosmos DB para NoSQL, também há um link na página Data Explorer .

Com a CLI do Azure

Para habilitar o Azure Synapse Link usando a CLI do Azure, execute o comando (para criar uma nova conta do Cosmos DB) ou az cosmosdb update o az cosmosdb create comando (para configurar uma conta existente do Cosmos DB) com o --enable-analytical-storage true parâmetro. Por exemplo, o comando a seguir atualiza uma conta existente do Cosmos DB chamada my-cosmos-db para habilitar o Azure Synapse Link.

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

Para habilitar o Azure Synapse Link para uma conta do Azure Cosmos DB para Apache Gremlin, inclua o --capabilities EnableGremlin parâmetro.

Utilizar o Azure PowerShell

Para habilitar o Azure Synapse Link usando o Azure PowerShell, execute o cmdlet (para criar uma nova conta do Cosmos DB) ou Update-AzCosmosDBAccount cmdlet New-AzCosmosDBAccount (para configurar uma conta existente do Cosmos DB) com o -EnableAnalyticalStorage 1 parâmetro. Por exemplo, o comando a seguir atualiza uma conta existente do Cosmos DB chamada my-cosmos-db para habilitar o Azure Synapse Link.

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

Ao planejar habilitar o Azure Synapse Link para uma conta do Cosmos DB, considere os seguintes fatos:

  • Depois de habilitar o Azure Synapse Link para uma conta, você não pode desativá-lo.

  • Habilitar o Azure Synapse Link não inicia a sincronização de dados operacionais com um repositório analítico - você também deve criar ou atualizar um contêiner com suporte para um repositório analítico.

  • Ao habilitar o Azure Synapse Link para uma conta do Cosmos DB para NoSQL usando a CLI do Azure ou o PowerShell, você pode usar o parâmetro (CLI --analytical-storage-schema-type do Azure) ou -AnalyticalStorageSchemaType (PowerShell) para especificar o tipo de esquema como WellDefined (padrão) ou FullFidelity. Para uma conta do Cosmos DB para MongoDB, o tipo de esquema padrão (e apenas suportado) é FullFidelity.

  • Depois que um tipo de esquema for atribuído, você não poderá alterá-lo.

    Nota

    Você aprenderá mais sobre o repositório analítico e seus tipos de esquema na próxima unidade.