Usar o Visual Studio Code para conectar e consultar instâncias do Azure Cosmos DB

Pré-requisitos

• Uma conta do Azure Cosmos DB para NoSQL configurada com um banco de dados e contêiner. Use qualquer um destes inícios rápidos aqui para configurar um recurso:
  • Portais
  • CLI do Azure

Instalar a extensão

Para conectar e gerenciar dados no Azure Cosmos DB no Visual Studio, primeiro instale a extensão Bancos de Dados do Azure.

1. Abra o Visual Studio Code.
2. Acesse o painel Extensões selecionando Exibir > extensões ou usando o atalho Ctrl + Shift + X no Windows e Command + Shift + X no macOS.
3. Na barra de pesquisa, digite Banco de Dados de Documentos para Visual Studio Code e selecione a extensão. Em seguida, selecione Instalar.
4. Após a instalação, recarregue o Visual Studio Code se solicitado.

Conectando-se a um Azure Cosmos DB para NoSQL

1. No Visual Studio Code, vá para o painel do Azure (selecione o ícone do Azure na Barra de Atividades).

2. Inicie sessão na sua conta do Azure Cosmos DB para NoSQL através do Microsoft Entra ID:

   Nota

   Use o controle de acesso baseado em função do Microsoft Entra ID ao acessar seus recursos do Azure Cosmos DB.

3. Depois de entrar, no modo de exibição de árvore do Azure, localize sua Assinatura do Azure e faça uma busca detalhada no Azure Cosmos DB.

4. Selecione uma conta existente ou clique com o botão direito do mouse para criar um novo recurso.

Consultar e exibir seus dados

As etapas a seguir usam o Editor de Consultas para executar uma consulta e exibir os resultados da consulta:

1. No menu da sua coleção, clique com o botão direito do rato na coleção para abrir o Editor de Consultas na Pré-visualização.

   

2. Execute a consulta fornecida no editor de consultas para exibir seus dados no Modo de Exibição de Tabela:

   

3. Explore os seus dados noutras vistas suportadas:

   • Visualização JSON: veja a estrutura de dados brutos.

     

   • Visualização em árvore: explore facilmente os dados aninhados.

     

Exibir métricas de consulta e índice

No editor de consultas, visualize mais métricas de consulta e índice para ajudar a otimizar o desempenho da consulta.

1. Selecione a guia Estatísticas ao lado dos Resultados da consulta.

2. Para obter mais informações sobre as definições de métrica, consulte a documentação de métricas de consulta.

Inserir, editar e excluir documentos

• Edição de documentos em tempo real: adicione, visualize, edite e exclua documentos instantaneamente, com alterações refletidas em tempo real.

• Importar de JSON: Carregue seus dados rapidamente de arquivos JSON.

Exportar resultados da consulta

• Resultados do download: Baixe os resultados da consulta para arquivos CSV ou JSON.

Conteúdo relacionado

• Introdução à API para NoSQL
• Guia de início rápido Node.js
• Início Rápido do Python
• Início Rápido do Java
• Ir Guia de início rápido

Pré-requisitos

• Uma conta do Azure Cosmos DB para NoSQL configurada com um banco de dados e contêiner.
• MongoDB shell (mongosh) instalado para interações de linha de comando (opcional, mas recomendado).

Instalar a extensão

Para conectar e gerenciar dados no Azure Cosmos DB, você precisa instalar a extensão de Bancos de Dados do Azure para Visual Studio Code.

1. Abra o Visual Studio Code.
2. Acesse o painel Extensões selecionando Exibir > extensões ou usando o atalho Ctrl + Shift + X no Windows e Command + Shift + X no macOS.
3. Na barra de pesquisa, digite Banco de Dados de Documentos para Visual Studio Code e selecione a extensão. Em seguida, selecione Instalar.
4. Após a instalação, recarregue o Visual Studio Code se solicitado.

Conectando-se a uma carga de trabalho do MongoDB

Gestão Intuitiva de Dados

Gerencie facilmente seus bancos de dados no Visual Studio Code:

• Criar e soltar bancos de dados/coleções: crie ou exclua bancos de dados e coleções usando o menu de contexto em sua conta, banco de dados ou coleção no painel de recursos.

• Importar de JSON: importe rapidamente dados de arquivos JSON para sua coleção.

  • Iniciar importação
    1. Clique com o botão direito do mouse no nome da coleção na visualização do recurso e selecione Importar documentos para a coleção.
    2. Em alternativa, abra a "Vista da coleção" clicando na entrada Documentos da sua coleção e, em seguida, selecione o botão Importar .
  • Selecionar arquivo JSON
    1. Navegue para localizar o arquivo *.json que contém seus dados.
    2. Confirme para iniciar o processo de importação.

• Exportar dados: salve coleções ou resultados de consultas como JSON para backup ou compartilhamento.

  • Iniciar exportação:
    • Opção 1
      1. Clique com o botão direito do mouse no nome da coleção na visualização de recursos e selecione Exportar documentos da coleção para exportar toda a coleção.
    • Opção 2
      1. Abra a "Visualização da coleção" clicando na entrada Documentos da sua coleção e, em seguida, selecione o botão Exportar .
      2. Escolha exportar toda a coleção ou os resultados da consulta atual.
  • Especifique o arquivo de destino:
    1. Introduza o nome e a localização do ficheiro *.json de destino.
    2. Confirme a exportação para começar a salvar os dados.

• Edição de documentos em tempo real: adicione, visualize, edite e exclua documentos instantaneamente com atualizações em tempo real.

  • Abrir Edição de Documentos:
    • Acesse as opções de edição de documentos diretamente na "Visualização da coleção". Esses controles estão convenientemente localizados acima da visualização de dados para facilitar o acesso.
  • Ações disponíveis:
    • Adicionar: Crie novos documentos dentro da coleção.
    • Exibir: exibir o conteúdo do documento selecionado.
    • Editar: edite o conteúdo dos documentos selecionados.
    • Excluir: remova documentos selecionados com alterações refletidas imediatamente.

Ferramentas de consulta poderosas

Execute e refine suas consultas perfeitamente:

• Resultados instantâneos: visualize imediatamente os resultados da consulta no formato de sua preferência: modo de exibição de tabela, JSON ou árvore.

  • Mude de vista facilmente utilizando o menu pendente Ver .

• Executar consultas diretamente: escreva e execute consultas do MongoDB com recursos como realce de sintaxe e preenchimento automático.

  • Para executar a consulta, selecione o botão Localizar consulta ou pressione Ctrl/Cmd+Enter o editor de consultas.

Visualizações de dados flexíveis

Explore seus dados usando várias visualizações para diferentes perspetivas:

• Visualização JSON: Consulte a estrutura de dados JSON brutos.

  

• Visualização em árvore: navegue e explore dados aninhados sem esforço.

  

• Visualização de tabela: digitalize rapidamente os dados e faça drill down em documentos aninhados.

  • Para detalhar: localize entradas com o {} ícone, que indicam objetos incorporados. Clique duas vezes para expandir e exibir conteúdo.

  • Para voltar: retorne aos níveis anteriores usando a trilha de navegação abaixo da Visualização de tabela.

  

Integração Mongo Shell

A funcionalidade de linha de comando está disponível:

• Launch mongosh: Execute comandos avançados do MongoDB diretamente do Visual Studio Code.

Gestão de Clusters

Mantenha-se a par dos seus recursos:

• Exibir detalhes do cluster: verifique a camada, a versão do servidor e o uso de recursos do cluster.

• Gerenciar tags: organize seus clusters com tags que sincronizam com o portal do Azure.