Configuração do driver de interface SQL

Baixe o driver JDBC do MongoDB.

Baixe o driver JDBC mais recente no centro de download do MongoDB.

Mova o arquivo jar para o diretório correto do seu sistema operacional.

Copie o arquivo jar no diretório apropriado para sua ferramenta de BI. Por exemplo, se você estiver instalando o driver JDBC para o Tableau:

• Windows: C:\Program Files\Tableau\Drivers

• macOS: ~/Library/Tableau/Drivers

• Linux: /opt/tableau/tableau_driver/jdbc

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.

1. Execute o seguinte comando para baixar o arquivo .asc do Repositório Central Maven. Substitua <versionNumber> pela versão do driver que você baixou e <artifactToVerify> pelo nome do arquivo que você baixou.

   curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/<versionNumber>/<artifactToVerify>.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

2. Execute o seguinte comando para baixar e importar o arquivo de chave. Substitua <serverUrl> por um dos servidores de chaves GPG atuais suportados pelo Maven:

   • keyserver.ubuntu.com

   • keys.openpgp.org

   • pgp.mit.edu

   gpg --keyserver <serverUrl> --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954

   OCULTAR SAÍDA

   gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1

3. Execute o comando a seguir para verificar o arquivo de instalação do driver JDBC do MongoDB. Substitua <detachedSignatureFile> e <artifactToVerify> pelos nomes dos arquivos que você baixou.

   gpg --verify <detachedSignatureFile> <artifactToVerify>

   Por exemplo, se baixou mongodb-jdbc-2.2.3-all.jar e mongodb-jdbc-2.2.3-all.jar.asc para 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 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

Configure o driver para seu aplicativo Maven.

Copie o trecho de dependência do Repositório Central do 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>

Adicione a dependência ao seu projeto Maven.

No arquivo pom.xml do seu projeto, cole o trecho de código 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>

Conecte-se à sua instância do banco de dados federado.

Para se conectar à instância do banco de dados federado, crie uma string de conexão e abra uma conexão do aplicativo. A string de conexão para o driver JDBC segue o formato da string 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]...]

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);