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

Conecte-se com o driver JDBC

Nesta página

  • mecanismo de autenticação suportados
  • Pré-requisitos
  • Procedimento

Esta página descreve como instalar e configurar o Driver MongoDB JDBC para conectar a uma instância do banco de dados federado.

Você pode autenticar com SCRAM-SHA-1, SCRAM-SHA-256, MONGODB-X509 e MongoDB Passwordless Authentication com AWS.

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

  • O driver JDBC do MongoDB.

Você pode usar o driver JDBC para se conectar a aplicativos Java baseados em SQL que aceitam uma API JDBC, como um projeto Maven.

1
2

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
1

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

No arquivo pom.xml do seu projeto, cole o snippet na lista de dependências da seguinte maneira:

<dependencies>
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-jdbc</artifactId>
<version>2.1.0</version>
</dependency>
</dependencies>
3

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:

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

  2. Em Access your data through tools, selecione Atlas SQL.

  3. Em Select your driver, selecione JDBC Driver no menu suspenso.

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

Voltar

MongoDB Shell