Conexão do Microsoft Azure Cosmos DB

Para acessar seus dados no banco de dados Microsoft Azure Cosmos, crie um ativo de conexão para ele.

O Azure Cosmos DB é um serviço de banco de dados NoSQL totalmente gerenciado.

Crie uma conexão com o banco de dados Microsoft Azure Cosmos

Para criar o ativo de conexão, estes detalhes da conexão são necessários:

  • Nome do Host
  • Número da porta
  • Chave mestra: a chave somente leitura primária do banco de dados Azure Cosmos
Nota:Pré-requisito para autenticação do Entra ID:

O Microsoft Entra ID é um serviço de gerenciamento de identidade e acesso baseado em nuvem. Para obter valores de conexão para o método de autenticação Entra ID, entre no portal do Microsoft Azure e acesse sua conta de armazenamento. Para obter informações sobre o Microsoft Entra ID, consulte O que é o Microsoft Entra ID?.

Credencial de segredo do cliente do Entra ID

  • ID do locatário: a ID do locatário do Microsoft Entra. Para localizar o ID do locatário, vá para Microsoft Entra ID> Properties. Role para baixo até o campo Tenant ID. Para obter mais informações, consulte Como encontrar seu ID de locatário do Microsoft Entra.
  • ID do cliente : O ID do cliente para autorizar o acesso a Microsoft Azure Cosmos DB. Para localizar o Client ID do seu aplicativo, selecione Microsoft Entra ID. Em Registros de aplicativos, selecione seu aplicativo. Clique em Copy para copiar o Client ID do seu aplicativo. Para obter mais informações, consulte Registrar um aplicativo Microsoft Entra e criar uma entidade de serviço.
  • Segredo do cliente : a chave de autenticação associada ao ID do cliente para autorizar o acesso a Microsoft Azure Cosmos DB. Para localizar o segredo do cliente para seu aplicativo, selecione Microsoft Entra ID. Em Registros de aplicativos, selecione seu aplicativo. Vá para Certificates & secrets > Client secrets. Clique em Copiar para copiar o segredo do cliente existente ou clique em Novo segredo do cliente para criar um novo segredo do cliente e copiá-lo. Para obter mais informações, consulte Registrar um aplicativo Microsoft Entra e criar uma entidade de serviço.
  • Conta de armazenamento URL : Conta de armazenamento URL.

Credencial de nome de usuário e senha do Entra ID

  • ID do cliente: O ID do cliente para autorizar o acesso a Microsoft Azure Cosmos DB. Para localizar o Client ID do seu aplicativo, selecione Microsoft Entra ID. Em Registros de aplicativos, selecione seu aplicativo. Clique em Copy para copiar o Client ID do seu aplicativo. Para obter mais informações, consulte Registrar um aplicativo Microsoft Entra e criar uma entidade de serviço.
  • Nome de usuário e senha : Nome de usuário e senha da conta Microsoft Azure Cosmos DB. Você precisa de permissão para acessar sem a autenticação multifator.
  • Conta de armazenamento URL : Conta de armazenamento URL.

No caso da Conectividade privada, para se conectar a um banco de dados que não é exposto à Internet (por exemplo, que está atrás de um firewall), deve-se configurar uma conexão segura.

Configuração do Azure Cosmos DB

Restrições

  • Apenas a API do Núcleo (SQL) é suportada.
  • Ao usar as credenciais do Entra ID para autenticação com a conexão Azure Cosmos DB, não há suporte para a criação ou exclusão de uma coleção/contêiner. Só há suporte para listar coleções existentes e fazer alterações nelas. Para obter mais informações, consulte a Azure Cosmos DB.

Executando instruções SQL

Para garantir que suas instruções SQL sejam executadas corretamente, consulte a documentação Azure Cosmos DB para a sintaxe correta.

Saiba Mais