Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/ /
Tutoriais do SQL
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Tutoriais do SQL
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Tutoriais do SQL

Conecte-se e consulte dados com ferramentas SQL gratuitas

Este tutorial mostra como se conectar a um cluster dedicado do Atlas ou a uma instância do banco de dados federado com as FERRAMENTAS gratuitas: driver JDBC do MongoDB e DBeaver (Community Edition).

Se você carregou dados de amostra em sua implantação, este guia também o orientará a fazer a query deles.

Antes de começar, configure sua implantação para aceitar conexões SQL. Para aprender como, consulte Configurar servidor de interface SQL.

Instalar software cliente

Instale o seguinte software cliente para conectar e consultar seus dados com o MongoSQL.

1

Instalar o DBeaver

O DBeaver é uma ferramenta de banco de dados universal gratuita. Você pode usá-lo para explorar seus dados de amostra neste tutorial. Baixe e instale o DBeaver (Community Edition).

2

Instale o driver JDBC

  1. Download the latest MongoDB JDBC Driver version.

  2. Verifique a integridade do pacote baixado:

    A equipe de lançamento do MongoDB assina digitalmente todos os pacotes de software para certificar que um determinado pacote do MongoDB é uma versão válida e inalterada do MongoDB. O MongoDB assina cada ramificação de lançamento com uma chave PGP diferente no formato .asc.

    1. Execute o seguinte comando para baixar o arquivo .asc do Repositório Central Maven. Substitua {version-number} pela versão do driver que você baixou e {artifact_to_verify} pelo nome do arquivo que você baixou.

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/{version-number}/{artifact_to_verify}.asc

      Por exemplo, se baixou mongodb-jdbc-2.2.3-all.jar, você executaria o seguinte comando.

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.2.3/mongodb-jdbc-2.2.3-all.jar.asc

    2. Execute o seguinte comando para baixar e importar o arquivo de chave. Substitua {server_url} por um dos servidores de chaves GPG atuais suportados pelo Maven:

      • keyserver.ubuntu.com

      • keys.openpgp.org

      • pgp.mit.edu

      gpg --keyserver {server_url} --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954
      gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
      gpg: Total number processed: 1
      gpg:               imported: 1

    3. Execute o comando a seguir para verificar o arquivo de instalação do driver MongoDB JDBC. Substitua detached_signature_file e artifact_to_verify pelos nomes dos arquivos que você baixou.

      gpg --verify {detached_signature_file} {artifact_to_verify}

      Por exemplo, se baixou mongodb-jdbc-2.2.3-all.jar e mongodb-jdbc-2.2.3-all.jar.asc para o seu diretório atual, você executaria o seguinte.

      gpg --verify mongodb-jdbc-2.2.3-all.jar.asc mongodb-jdbc-2.2.3-all.jar

      O GPG deve retornar uma resposta semelhante à seguinte:

      gpg: Signature made Wed May 22 13:24:36 2024 MDT
      gpg:                using RSA key BDDC8671F1BE6F4D5464096624A4A8409351E954
      gpg: Good signature from "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>"

      Se o pacote estiver devidamente assinado, mas você ainda não confia na chave de assinatura em seu trustdb local, gpg também retornará a seguinte mensagem:

      gpg: WARNING: This key is not certified with a trusted signature!
      gpg:          There is no indication that the signature belongs to the owner.
      Primary key fingerprint: D2C4 5B7E 66A5 DCA1 8B76  57A8 91A2 1577 3066 6110

      Se você receber a seguinte mensagem de erro, confirme se importou a chave pública correta:

      gpg: Can't check signature: public key not found

Conectar-se a partir do DBeaver

Escolha seu tipo de implantação para obter sua string de conexão e configurar o DBeaver:

Para aprender mais sobre os diferentes métodos que você pode usar para se conectar, consulte Conectar sua ferramenta SQL ao MongoDB.

Executar queries do MongoSQL

Para executar queries do MongoSQL no DBeaver:

1

Expanda sua conexão com o MongoDB.

O DBeaver Database Navigator exibe seus bancos de dados virtuais.

2

Abra um console SQL.

  1. Clique com o botão direito do mouse no banco de dados virtual no qual deseja fazer query.

  2. Selecione SQL Editor.

  3. Selecione Open SQL console.

    Uma nova janela do console SQL será aberta e estará conectada ao banco de dados virtual selecionado.

3

Insira uma query SQL no console.

4

Clique em Execute SQL Statement para executar sua query SQL.

Se a query for bem-sucedida, o MongoSQL exibirá os resultados em uma exibição de tabela abaixo da sua query.

Exemplo de query MongoSQL

Se você carregou uma amostra de dados em sua implantação, tente executar as seguintes querys MongoSQL nela.

Caso contrário, você pode modificar as queries de exemplo para seus namespaces.

Declaração SELECT

SELECT *
FROM Sessions

O MongoSQL retorna todos os documentos da collection Sessions.

Declaração LIMIT

SELECT *
FROM Users
LIMIT 2

O MongoSQL retorna dois documentos da collection Users.

Declaração ONDE

SELECT *
FROM Users
WHERE name = 'Jon Snow'

O MongoSQL retorna documentos da collection Users onde o name do usuário é Jon Snow.

Para ver uma referência de comando MongoSQL, consulte Referência de linguagem MongoSQL.

Voltar
Tutoriais do SQL
Próximo
Autenticação
Avalie esta página