Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ / /

Conecte-se e consulte dados com ferramentas SQL gratuitas

Este tutorial mostra como se conectar a uma instância do banco de dados federado com as ferramentas gratuitas de JDBC Driver e DBeaver do MongoDB (Community Edition).

Se você tiver seguido o guia de configuração avançada, este tutorial também orientará você a fazer a query de dados de amostra.

Instale o seguinte software cliente para conectar e fazer a query de seus dados com o Atlas SQL.

1

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 (MongoDB Community Edition).

2
  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 Maven Central.

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.1.2/mongodb-jdbc-2.1.2.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 91A2157730666110
      gpg: key 91A2157730666110: public key "Huan Li <huan.li@10gen.com>" imported
      gpg: Total number processed: 1
      gpg: imported: 1
    3. Execute o comando a seguir para verificar o arquivo de instalação do MongoDB JDBC Driver.

      gpg --verify mongodb-jdbc-2.1.2.jar.asc mongodb-jdbc-2.1.2.jar

      O GPG deve retornar uma resposta semelhante à seguinte:

      gpg: Signature made Wed May 22 13:24:36 2024 MDT
      gpg: using RSA key 91A2157730666110
      gpg: Good signature from "Huan Li <huan.li@10gen.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

Para se conectar à sua instância de banco de dados federado a partir do DBeaver:

1
  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.

2
3
4

Observação

Este tutorial usa o Driver JDBC para se conectar. Consulte Ligar Utilizando a Interface Atlas SQL para métodos de ligação alternativos.

5

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.

6
  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.

7

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.

Para saber mais sobre os diferentes métodos que você pode usar para se conectar a uma instância do banco de dados federado, consulte Conectar-se usando a interface do Atlas SQL.

Para executar queries do SQL do Atlas no DBeaver:

1

O DBeaver Database Navigator exibe seus bancos de dados virtuais.

2
  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
4

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

Se você seguiu o guia de Configuração avançada utilizando dados de amostra, tente executar as seguintes queries do Atlas SQL em relação aos dados de amostra na sua instância do banco de dados federado.

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

SELECT *
FROM Sessions

O Atlas SQL retorna todos os documentos da collection Sessions.

SELECT *
FROM Users
LIMIT 2

O Atlas SQL retorna dois documentos da collection Users.

SELECT *
FROM Users
WHERE name = 'Jon Snow'

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

Para ver uma referência de comando do Atlas SQL, consulte Referência de linguagem do Atlas SQL.

Voltar

Tutoriais do SQL