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.

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and 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.

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

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 comando (para configurar uma conta existente do Cosmos DB) com o --enable-analytical-storage true az cosmosdb create 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 (para configurar uma conta existente do Cosmos DB) com o New-AzCosmosDBAccount -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 do Azure) ou (PowerShell) para especificar o --analytical-storage-schema-type tipo de esquema como WellDefined (padrão) ou -AnalyticalStorageSchemaType 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.