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.
Instalar software cliente
Instale o seguinte software cliente para conectar e fazer a query de seus dados com o Atlas SQL.
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 (MongoDB Community Edition).
Instalar JDBC Driver
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 branch de versão com uma chave PAG diferente no formato
.asc
.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 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 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
Conecte-se à sua instância do banco de dados federado
Para se conectar à sua instância de banco de dados federado a partir do DBeaver:
No Atlas, acesse sua instância de banco de dados federado para seu projeto.
Se ainda não estiver exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Data Federation sob o título Services.
A página Data Federation é exibida.
Selecione JDBC Driver.
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.
Conecte-se a partir do DBeaver.
Inicie o DBeaver.
Adicione um novo driver.
No DBeaver, clique em Database e selecione Driver Manager no menu suspenso.
Clique em New para abrir o modal Create new driver.
Na guia Settings, insira as seguintes informações:
Nome do driverMongoDB
Nome da classecom.mongodb.jdbc.MongoDriver
Na guia Libraries, clique em Add File e adicione seu arquivo JDBC driver
all.jar
.Clique em Find Class.
Clique em OK. O modal Create new driver fecha.
Cria uma conexão do banco de dados.
No DBeaver, clique em Database e selecione New Database Connection no menu suspenso para abrir o modal Connect to a database.
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.
Na guia Main, insira as seguintes informações:
JDBC URLSua cadeia de conexão da etapa 5.Nome de usuárioO usuário MongoDB com o qual se conectar.SenhaA senha do usuário MongoDB.Na guia Driver properties, expanda User Properties. Adicione as seguintes propriedades de valor chave:
databaseO nome do seu banco de dados virtual.utilizadorO usuário do MongoDB com o qual se conectar. Não é obrigatório se você inseriuUsername
na etapa anterior.SenhaA senha do usuário MongoDB. Não é necessário se introduziu umPassword
no passo anterior.
Clique em Finish.
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.
Executar queries SQL do Atlas
Para executar queries do SQL do Atlas no DBeaver:
Exemplo de queries do Atlas SQL
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.
Declaração SELECT
SELECT * FROM Sessions
O Atlas SQL retorna todos os documentos da collection Sessions
.
Declaração LIMIT
SELECT * FROM Users LIMIT 2
O Atlas SQL retorna dois documentos da collection Users
.
Declaração ONDE
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.