Criar um serviço vinculado para Cosmos DB

Concluído

Quando você tem um contêiner do Azure Cosmos DB com suporte a repositório analítico, pode criar um serviço vinculado em um workspace do Azure Synapse Analytics para se conectar a ele.

Para criar um serviço vinculado a um armazenamento de dados analítico do Azure Cosmos DB, use o Azure Synapse Studio e adicione um serviço vinculado na página Dados, selecionando a opção Conectar-se a dados externos, conforme mostrado aqui:

Uma captura de tela do Azure Synapse Studio que mostra a página Conectar-se a dados externos.

Ao concluir as etapas para criar seu serviço vinculado, selecione o tipo de conta do Azure Cosmos DB, atribua um nome significativo ao serviço vinculado e forneça as informações necessárias para se conectar ao banco de dados do Azure Cosmos DB.

Para se conectar ao banco de dados do Azure Cosmos DB, você pode usar qualquer uma das seguintes opções de autenticação:

  • Chave da conta: especifique uma chave de autenticação para sua conta do Cosmos DB.
  • Entidade de Serviço: use a identidade do serviço Azure Synapse Analytics.
  • Identidade Gerenciada Atribuída pelo Sistema: use uma identidade gerenciada atribuída pelo sistema.
  • Identidade Gerenciada Atribuída pelo Usuário: use uma identidade gerenciada definida pelo usuário.

Dica

Para obter mais informações sobre como usar identidades gerenciadas no Microsoft Entra ID, confira O que são identidades gerenciadas para recursos do Azure?

Depois de criar um serviço vinculado, o banco de dados do Azure Cosmos DB e os respectivos contêineres serão mostrados na página Dados do Azure Synapse Studio, conforme mostrado aqui:

Uma captura de tela do Azure Synapse Studio mostrando a página

Observação

A interface do usuário diferencia entre contêineres com e sem suporte a repositório analítico usando os seguintes ícones:

Repositório analítico habilitado Repositório analítico não habilitado
Um ícone mostrando retângulos interligados e um gráfico de barras. Um ícone mostrando retângulos interligados, mas sem um gráfico de barras.

Você pode consultar um contêiner sem um repositório analítico, mas não se beneficiará das vantagens de uma solução HTAP que descarrega a sobrecarga de consulta analítica do armazenamento de dados operacional.