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.

Um diagrama que mostra a integração do Link do Azure Synapse ao Azure Cosmos DB e ao 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.

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

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.