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

  • 5 minutos

O Link do Azure Synapse para Azure Cosmos DB é uma funcionalidade de HTAP nativa 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, são ilustrados os seguintes recursos principais da arquitetura do Link do Azure Synapse para Cosmos DB:

  1. Um contêiner do Azure Cosmos DB fornece um repositório transacional baseado em linha otimizado para operações de leitura/gravação.
  2. O contêiner também fornece um repositório analítico baseado em coluna otimizado para cargas de trabalho analíticas. Um processo de sincronização automática totalmente gerenciado mantém os armazenamentos de dados em sincronia.
  3. O Link do Azure Synapse fornece um serviço vinculado que conecta o contêiner habilitado para repositório analítico no Azure Cosmos DB a um workspace do Azure Synapse Analytics.
  4. O Azure Synapse Analytics fornece runtimes do SQL do Synapse e do 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 Link do Azure Synapse para Cosmos DB é habilitá-lo em uma conta do Azure Cosmos DB. O Link do Azure Synapse é compatível com os seguintes tipos de conta do Azure Cosmos DB:

  • Azure Cosmos DB para NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for Apache Gremlin (versão prévia)

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

Usando o portal do Azure

No portal do Azure, você pode habilitar o Link do Azure Synapse para uma conta do Cosmos DB na página Link do Azure Synapse, 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.

Dica

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

Usando a CLI do Azure

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

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

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

Usando o PowerShell do Azure

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

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

Ao planejar a habilitação do Link do Azure Synapse para uma conta do Cosmos DB, considere os seguintes fatos:

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

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

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

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

    Observação

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