Criar um serviço vinculado para o Cosmos DB

Concluído

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

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

Uma captura de tela do Azure Synapse Studio mostrando a página Conectar a dados externos.

Ao concluir as etapas para criar seu serviço vinculado, selecione o tipo de conta do Azure Cosmos DB e, em seguida, atribua ao serviço vinculado um nome significativo e forneça as informações necessárias para se conectar ao seu 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 ao sistema: use a identidade gerenciada atribuída ao sistema.
  • Identidade gerenciada pelo usuário: use uma identidade gerenciada definida pelo usuário.

Gorjeta

Para obter mais informações sobre como usar identidades gerenciadas no Microsoft Entra ID, consulte 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 seus 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 Dados com um serviço vinculado do Azure Cosmos DB.

Nota

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

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

Você pode consultar um contêiner sem um armazenamento 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 operacionais.