Conecte-se com o driver JDBC
Esta página descreve como instalar e configurar o Driver MongoDB JDBC para conectar a uma instância do banco de dados federado.
mecanismo de autenticação suportados
Você pode autenticar com SCRAM-SHA-1, SCRAM-SHA-256, MONGODB-X509 e MongoDB Passwordless Authentication com AWS.
Pré-requisitos
Uma instância de banco de dados federado mapeada para um ou mais armazenamentos de dados.
Observação
Se alguns ou todos os seus dados vierem de um Atlas cluster, você deverá usar o MongoDB versão 5.0 ou superior para que esse cluster aproveite o Atlas SQL.
Um aplicativo ou ferramenta BI que você deseja conectar à instância do banco de dados federado com o driver JDBC.
Procedimento
Você pode usar o driver JDBC para se conectar a aplicativos Java baseados em SQL que aceitam uma API JDBC, como um projeto Maven.
Baixe e verifique 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 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
Integrar ao projeto Maven
Configure o driver para seu aplicativo Maven.
Para se conectar ao aplicativo Maven, copie o trecho de dependência do Repositório central Maven. Edite o número da versão no trecho de dependência para corresponder à versão do driver do JDBC. Por exemplo:
<dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-jdbc</artifactId> <version>2.1.0</version> </dependency>
Conecte-se à sua instância do banco de dados federado.
Para se conectar à instância do banco de dados federado, crie uma cadeia de conexão e abra uma conexão do aplicativo. A cadeia de conexão para o driver JDBC segue o formato da cadeia de conexão padrão do MongoDB, exceto com o prefixo jdbc:
:
jdbc:mongodb://[username:password]@[host].a.query.mongodb.net/<databaseName>[?option1=value1[&option2=value2]...]
Você pode obter a string de conexão na IU do Atlas. Para obter a string de conexão da IU do Atlas, faça o seguinte:
Na interface do usuário do Atlas, acesse a página Data Federation e clique em Connect para a instância do banco de dados federado à qual você deseja se conectar.
Em Access your data through tools, selecione Atlas SQL.
Em Select your driver, selecione JDBC Driver no menu suspenso.
Em Get Connection String, selecione o banco de dados ao qual você deseja se conectar e copie a string de conexão.
O exemplo a seguir demonstra como abrir uma conexão. Além da cadeia de conexão, você também deve especificar o banco de dados a ser usado por meio de um parâmetro de objeto Properties
. Para saber mais, consulte Cadeias de conexão e Propriedades de conexão.
java.util.Properties p = new java.util.Properties(); p.setProperty("database", "<databaseName>"); Connection conn = DriverManager.getConnection("<connectionString>", p);
Observação
O driver só pode se conectar ao Atlas e não a uma instância mongod
. Quaisquer caracteres especiais na cadeia de conexão do driver JDBC devem ser codificados em URL.