Conecte-se e consulte dados com ferramentas SQL gratuitas

Instalar o DBeaver

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

Instalar JDBC Driver

1. Baixe a versão mais recente do driver JDBC do MongoDB.

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 branch de versão com uma chave PAG 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

      OCULTAR SAÍDA

      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

No Atlas, acesse sua instância de banco de dados federado para seu projeto.

1. Se ainda não estiver exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

3. Na barra lateral, clique em Data Federation sob o título Services.

A página Data Federation é exibida.

Clique em Connect para abrir o modal de conexão da instância do banco de dados federado.

Selecione MongoSQL.

Selecione JDBC Driver.

Copie suas informações de conexão.

O Atlas Data Federation fornece uma cadeia de conexão para conectar à sua instância do banco de dados federado. Você precisará disso em uma etapa posterior.

Conecte-se a partir do DBeaver.

1. Inicie o DBeaver.

2. Adicione um novo driver.

   1. No DBeaver, clique em Database e selecione Driver Manager no menu suspenso.

   2. Clique em New para abrir o modal Create new driver.

   3. Na guia Settings, insira as seguintes informações:

      Nome do driver	MongoDB
      Nome da classe	com.mongodb.jdbc.MongoDriver

   4. Na guia Libraries, clique em Add File e adicione seu arquivo JDBC driver all.jar.

      Clique em Find Class.

   5. Clique em OK. O modal Create new driver fecha.

3. Cria uma conexão do banco de dados.

   1. No DBeaver, clique em Database e selecione New Database Connection no menu suspenso para abrir o modal Connect to a database.

   2. Na lista de bancos de dados, selecione o driver de banco de dados do MongoDB que você criou na etapa anterior.

      Se não vir MongoDB, selecione a categoria All dentro do modal.

      Clique em Next.

   3. Na guia Main, insira as seguintes informações:

      JDBC URL	Sua cadeia de conexão da etapa 5.
      Nome de usuário	O usuário MongoDB com o qual se conectar.
      Senha	A senha do usuário MongoDB.

   4. Na guia Driver properties, expanda User Properties. Adicione as seguintes propriedades de valor chave:

      database	O nome do seu banco de dados virtual.
      utilizador	O usuário do MongoDB com o qual se conectar. Não é obrigatório se você inseriu Username na etapa anterior.
      Senha	A senha do usuário MongoDB. Não é necessário se introduziu um Password no passo anterior.

4. Clique em Finish.

(Opcional) Confirme que você pode acessar os dados da instância do banco de dados federado.

No Database Navigator, expanda sua conexão MongoDB para verificar se o armazenamento da instância do banco de dados federado mapeado para seus dados está acessível.

Expanda sua conexão com o MongoDB.

O DBeaver Database Navigator exibe seus bancos de dados virtuais.

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.

Insira uma query SQL no console.

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.