Guia de início rápido: usar o Azure Data Studio para conectar e consultar a API do Azure Cosmos DB para MongoDB (Prévia)

Importante

O Azure Data Studio será desativado em 28 de fevereiro de 2026. Recomendamos que você use a extensão do MSSQL para Visual Studio Code. Para obter mais informações sobre como migrar para o Visual Studio Code, visite O que está acontecendo com o Azure Data Studio?

Este guia de início rápido mostra como usar o Azure Data Studio para se conectar à API do Azure Cosmos DB para MongoDB.

Observação

Embora o Microsoft Entra ID seja o novo nome do Azure Active Directory (Azure AD), para evitar a interrupção de ambientes existentes, o Azure AD ainda permanecerá em alguns elementos codificados, como campos de interface do usuário, provedores de conexão, códigos de erro e cmdlets. Neste artigo, os dois nomes são intercambiáveis.

Pré-requisitos

Para concluir este guia de início rápido, você precisa do Azure Data Studio e de uma conta da API do Azure Cosmos DB.

• Instale o Azure Data Studio.
• Instalar a extensão API do Azure Cosmos DB para MongoDB do Azure Data Studio.
• Criar uma conta da API do Azure Cosmos DB para MongoDB.

Conectar-se a uma conta do Azure Cosmos DB para MongoDB

API para MongoDB (baseada em RU)

1. Inicie o Azure Data Studio.

2. Na primeira vez que você iniciar o Azure Data Studio, a caixa de diálogo Conexão será aberta. Se a caixa de diálogo Conexão não abrir, clique no ícone Nova Conexão na página SERVIDORES:

   

3. Na caixa de diálogo exibida, clique em Procurar e selecione o ícone + para entrar no Azure.

   

4. Depois de entrar no Azure, selecione a conta do Azure Cosmos DB que você deseja acessar ou preencha os Detalhes da Conexão dos campos usando os detalhes nesta tabela.

   Configuração	Valor	Descrição
   Tipo de conexão	Conta do Mongo	Defina esse valor como a conta do Mongo a ser usada com a API do Azure Cosmos DB para MongoDB.
   Conta do Mongo	[cosmos-account-name]	Nome da conta do Azure Cosmos DB.
   Tipo de autenticação	Azure Active Directory – Universal compatível com MFA	Escolha entre as opções de autenticação Microsoft Entra ID ou Básica.
   Conta	[current-aad-user-name]	Visível apenas se estiver usando a autenticação do Microsoft Entra . Selecione a conta do Microsoft Entra que você deseja usar para autenticação.
   Locatário do Microsoft Entra		Visível apenas se estiver usando a autenticação do Microsoft Entra. Selecione o locatário do Microsoft Entra em que a instância do MongoDB reside.
   Nome de usuário		Visível somente quando a autenticação Básica é usada. Insira o nome de usuário para autenticação.
   Cadeia de Conexão		Visível somente quando a autenticação Básica é usada. Insira uma cadeia de conexão para autenticação.
   Grupo de servidores	<Padrão>
   Nome (opcional)		Insira qualquer nome exclusivo a ser usado na barra lateral SERVIDORES.

   

5. Selecione Conectar.

   Importante

   Se você selecionou a autenticação do Microsoft Entra , poderá ser solicitado a selecionar um valor de cadeia de conexão do MongoDB a ser usado para sua conexão.

O servidor será aberto na barra lateral SERVIDORES depois que você se conectar com êxito.

API para MongoDB (vCore)

1. Abra a nova conta do Azure Cosmos DB for MongoDB (vCore) no Portal do Azure.

2. Navegue até "Configurações" > "Cadeia de conexão" e copie a "Cadeia de conexão" mostrada.

   

3. Inicie o Azure Data Studio.

4. Na primeira vez que você iniciar o Azure Data Studio, a caixa de diálogo Conexão será aberta. Se a caixa de diálogo Conexão não abrir, clique no ícone Nova Conexão na página SERVIDORES:

   

5. Na caixa de diálogo exibida, selecione Conta do Mongo>Cadeia de Conexão. Cole a cadeia de conexão do portal do Azure no campo Cadeia de conexão. Substitua os tokens de usuário e senha dentro da cadeia de caracteres pelo nome de usuário e senha do administrador (encontrados no Portal do Azure).

   

6. Selecione Conectar.

Criar um banco de dados e uma coleção

O script a seguir criará um banco de dados chamado SourceDatabase e uma coleção chamada People:

1. Abra o menu de contexto da conta e selecione Criar Banco de Dados.

   

2. Nas caixas de diálogo pop-up Banco de Dados e Coleção, use os detalhes nesta tabela.

   Solicitação	Valor
   Nome do banco de dados	SourceDatabase
   Nome da coleção	Pessoas

3. Após a conclusão da operação, o novo banco de dados deverá aparecer na lista de bancos de dados.

   Dica

   Se o banco de dados não aparecer na lista, selecione Atualizar.

4. Expanda os nós SourceDatabase e People na barra lateral SERVIDORES.

   

Criar uma coleção de exemplo

As seguintes etapas popularão a coleção People com um conjunto de dados de exemplo:

1. Selecione Bancos de Dados para acessar a lista de bancos de dados em sua conta.

   

2. Selecione o item SourceDatabase na lista de bancos de dados.

   

3. No menu de cabeçalho, selecione Importar Dados de Exemplo. Escolha Sim no diálogo de confirmação.

   

4. Aguarde a conclusão da operação de importação.

   Dica

   A operação de importação pode demorar alguns minutos para ser concluída.

Consultar os dados

As seguintes etapas usarão o Mongo Shell para executar uma consulta e exibir seus resultados:

1. No menu do banco de dados, selecione Abrir o Mongo Shell.

   

2. Execute a seguinte consulta no shell.

   db.Persons.find().pretty()
   

   Dica

   O método pretty() no Mongo exibe os resultados de uma consulta em um formato fácil de ler. Para saber mais, confira a documentação oficial do MongoDB para cursor.pretty.

3. Observe a saída da consulta dentro do shell. A saída deve conter

   

Próximas etapas

Neste guia de início rápido, você aprendeu a criar uma conta da API para MongoDB, criar um banco de dados e uma coleção no Azure Data Studio e consultar dados de exemplo. Agora você pode usar o Azure Data Studio para examinar dados reais em seu banco de dados.

• Saiba mais sobre a extensão disponível para a API do Azure Cosmos DB para MongoDB.
• Quer importar dados do MongoDB para o Azure Cosmos DB? Veja Migrar o MongoDB para a API do Azure Cosmos DB para MongoDB
• Tentando fazer um planejamento de capacidade para uma migração para o Microsoft Azure Cosmos DB? Você pode usar informações sobre o seu cluster de banco de dados existente para planejamento de capacidade.
  • Se você sabe apenas o número de vCores e servidores do cluster de banco de dados existente, leia sobre como estimar unidades de solicitação com vCores ou vCPUs
  • Se souber as taxas de solicitação típicas da carga de trabalho do banco de dados atual, leia sobre como estimar unidades de solicitação usando o planejador de capacidade do Azure Cosmos DB