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 de JDBC Driver e DBeaver do MongoDB (Community Edition).
Se você carregou dados de amostra em seu sistema, este tutorial também o orientará a consultá-los.
Antes de começar, configure seu sistema para aceitar conexões SQL. Para saber como, consulte Configuração do servidor de interface SQL.
Instalar software cliente
Instale o seguinte software cliente para conectar e consultar seus dados com o MongoSQL.
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).
Instale o driver JDBC
Baixe a versão mais recente do driver JDBC do MongoDB .
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.Execute o seguinte comando para baixar o arquivo
.ascdo Repositório Central do 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 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.comkeys.openpgp.orgpgp.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 Execute o comando a seguir para verificar o arquivo de instalação do driver MongoDB JDBC. Substitua
detached_signature_fileeartifact_to_verifypelos nomes dos arquivos que você baixou.gpg --verify {detached_signature_file} {artifact_to_verify} Por exemplo, se baixou
mongodb-jdbc-2.2.3-all.jaremongodb-jdbc-2.2.3-all.jar.ascpara 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
trustdblocal,gpgtambé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 sistema para obter sua string de conexão e configurar o DBeaver:
Para saber 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:
Exemplo de queries do MongoSQL
Se você carregou dados de amostra em sua implantação, tente executar as seguintes queries MongoSQL neles.
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.