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:

A screenshot of Azure Synapse Studio showing the Connect to external data page.

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:

A screenshot of Azure Synapse Studio showing the Data page with an Azure Cosmos DB linked service.

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
An icon showing interlocking rectangles and a bar chart. An icon showing interlocking rectangles but no bar chart.

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.