Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/ /
Instalar
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Instalar
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Instalar

Conecte sua ferramenta SQL ao MongoDB

Connect your SQL tool, such as Tableau, Power BI, or DBeaver to your MongoDB Atlas or Enterprise Advanced (EA) database.

All three SQL Interface deployment options use the same JDBC and ODBC drivers, so the steps on this page are the same whether you connect to an Atlas dedicated cluster, an Atlas federated database instance, or a self-managed Enterprise Advanced (EA) deployment. Configure your deployment to accept SQL connections first. To learn how, see SQL Interface Server Setup.

Observação

O MongoDB suporta oficialmente o Tableau (Desktop, Servidor ou Nuvem) e Power BI Desktop (Desktop e Serviço) com seus drivers JDBC e ODBC. Você pode usar os drivers JDBC e ODBC com outras ferramentas compatíveis com SQL92, mas o MongoDB não pode garantir a compatibilidade. Teste seus recursos específicos da interface SQL para confirmar o suporte.

Conectar o Tableau

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Tableau (Desktop or Server) using the Tableau Connector for MongoDB.

Pré-requisitos

Procedimento

As etapas a seguir mostram como se conectar ao MongoDB com o Tableau:

1

Baixe o Connector Tableau para MongoDB.

Observação

O Tableau Desktop e o Tableau Server versão 2025 e posterior incluem o Tableau Connector para MongoDB. Se a sua versão do Tableau já incluir o conector, pule esta etapa. Para usar uma versão diferente da fornecida com o Tableau, conclua esta etapa.

Para o Tableau desktop, você também pode instalar o conector do Tableau. Pesquise no Tableau Troca de MongoDB SQL interface by MongoDB e clique em Install and restart Tableau.

  1. Baixe o arquivo mais recente do Connector Tableau taco no centro de download do MongoDB.

  2. Mova o arquivo taco para o diretório correto do seu sistema operacional:

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • macOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

Importante

Se você baixar uma nova versão do Tableau Connector for MongoDB, exclua o arquivo taco anterior do seu diretório Connectors para garantir que o Tableau usará a versão mais recente.

2

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse o cluster dedicado do Atlas ou a instância do banco de dados federado do seu projeto.

  2. Clique em Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção Tableau Connector no menu suspenso Select your driver.

  5. Selecione Tableau no menu suspenso.

  6. Selecione o banco de dados ao qual deseja se conectar no menu suspenso Database.

  7. Copie a string de conexão e os parâmetros de conexão.

    Use essas informações para se conectar ao Tableau em uma etapa posterior.

Use a connection string that is compatible with the MongoDB Java driver. To learn more, see Connection URI.

3

Abra o Tableau desktop ou o Tableau servidor.

4

Vá para o menu Connect.

5

Selecione MongoDB SQL Interface by MongoDB.

Um modal de conexão é exibido.

6

Insira suas informações de conexão do banco de dados :

Insira a string de conexão da Interface SQL que você salvou em uma etapa anterior.

7

Selecione seu método de autenticação.

Escolha seu Authentication Mechanism no menu suspenso.

Para obter informações sobre todos os mecanismos de autenticação suportados, consulte Autenticação de interface SQL.

  • Username: Insira seu nome de usuário MongoDB .

  • Password: Insira sua senha do MongoDB .

Configure seu certificado PEM usando um dos seguintes métodos:

  • Usar um caminho de arquivo PEM:

    No seu arquivo mongodb_jdbc.properties, defina a propriedade x509pempath para o caminho do arquivo PEM. Por exemplo, x509pempath=/certs/client-cert.pem.

    • Se seu arquivo PEM não estiver criptografado, não selecione Provide PEM Contents. Nenhuma ação adicional é necessária.

    • Se o seu arquivo PEM estiver criptografado, selecione Provide PEM Contents e digite a senha do arquivo no campo Password.

  • Fornecer conteúdo PEM:

    Marque a caixa de seleção ao lado de Provide PEM Contents e insira os dados do seu certificado no campo Password :

    • Conteúdo não criptografado: cole o conteúdo completo do certificado diretamente no campo.

    • Conteúdo criptografado: cole um objeto JSON contendo o conteúdo e a senha:

      { "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }

Insira o nome principal do Kerberos no campo Username. Por exemplo, user@EXAMPLE.COM.

Nenhuma propriedade ou campo adicional é necessário na caixa de diálogo de conexão do OIDC.

8

Clique em Sign In.

Configurar registro do Tableau

Para alterar a configuração de registro do driver JDBC do MongoDB , adicione propriedades de registro ao arquivo mongodb_jdbc.properties. A localização deste arquivo depende da sua plataforma:

Plataforma
Caminho

macOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau Server (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

Copie este arquivo para todos os nós do servidor .

Para configurar o registro, adicione as seguintes propriedades ao arquivo:

loglevel=INFO
logdir=<path-to-log-directory>

A propriedade loglevel define a verbosidade dos registros do driver. Aceita os seguintes valores, em ordem de verbosidade crescente: OFF, SEVERE, WARNING, INFO, FINE e FINER. O padrão é OFF.

A propriedade logdir define o diretório onde o driver grava arquivos de log. O diretório já deve existir. Se você omitir logdir ou defini-lo como console, o driver gravará registros no console em vez de em um arquivo.

Importante

Em ambientes de produção, comece com o nível de registro SEVERE. Aumente o nível somente quando precisar diagnosticar um problema, pois cada nível adiciona uma grande quantidade de saída. No nível FINER, o driver registra cada chamada que recupera dados para cada célula de cada conjunto de resultados.

Para saber mais sobre arquivos de propriedades no Tableau, consulte a documentação do Tableau.

Conectar o Power BI

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Power BI using the Power BI Connector for MongoDB.

Pré-requisitos

  • The MongoDB ODBC driver. To install, see SQL Interface Driver Setup. To use Direct Query, you must install version 1.2 or later.

  • bits do Power BI para 64 Desktop. A Microsoft atualiza e lança o Power BI mensalmente, e o Atlas oferece suporte apenas à versão mais recente do Power BI para Desktop.

  • Sistema operacional Windows. Para conhecer as versões do sistema operacional Windows compatíveis com o Power BI Desktop, consulte a documentação da Microsoft.

Procedimento

As etapas a seguir mostram como se conectar ao MongoDB com o Power BI:

1

Baixe o BI Connector para MongoDB.

  1. Baixe o arquivo mais recente do BI Connector pqx no centro de download do MongoDB.

    Observação

    O BI Connector para MongoDB é fornecido com o desktop do Power BI. Se a sua versão do desktop do Power BI já tiver o conector do MongoDB Atlas SQL, pule esta etapa. Para usar uma versão diferente da fornecida com o desktop do Power BI, conclua esta etapa.

  2. Mova o arquivo do conector para o seguinte caminho de diretório:

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    Crie a pasta caso ela ainda não exista.

2

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse o cluster dedicado do Atlas ou a instância do banco de dados federado do seu projeto.

  2. Clique no botão Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção Power BI Connector no menu suspenso Select your driver.

  5. Copie a string de conexão

    Use essas informações para se conectar ao Power BI em uma etapa posterior.

Use your MongoDB deployment URI. To learn more, see Connection Strings.

3

Conecte-se a partir do desktop do Power BI.

  1. Abra o Power BI Desktop.

  2. Selecione Get data no menu Home.

  3. Encontre e selecione o conector MongoDB Atlas SQL.

    1. Digite mongo na barra de pesquisa para encontrar o novo conector.

    2. Selecione MongoDB Atlas SQL.

    3. Clique em Connect.

  4. Insira o URI e o nome do banco de dados e clique em OK.

    O MongoDB URI é a string de conexão que você copiou em uma etapa anterior.

    No campoNative query, você pode opcionalmente inserir uma query SQL. O Power BI usa a query SQL como fonte direta para os dados. Você também pode adicionar ou alterar a query SQL no editor de Power Query depois de se conectar.

  5. Insira seu Atlas User name e Password e clique em Connect.

    By default, users can access all namespaces that their roles and connection URI permit. If you use custom roles to restrict access, you can grant users access to additional namespaces in the Edit User menu. To learn more, see Configure Database Users.

    Para obter informações sobre outros mecanismos de autenticação suportados, consulte Autenticação de interface SQL.

Direct Query

Direct Query is a connection mode available with the Power BI Connector for MongoDB version 1.2 and later. To use Direct Query, you must install MongoDB ODBC Driver version 1.2 or later. You don't need to configure a DSN.

A query direta é uma alternativa ao modo de importação padrão e permite consultar seu banco de dados diretamente. Isso garante dados atualizados, mas pode levar mais tempo para retornar resultados.

a query direta não suporta algumas ações. Se você tentar executar uma ação sem suporte, o Power BI solicitará que você alterne para o Modo de Importação.

Conecte o DBeaver

Connect your Atlas dedicated cluster, Atlas federated database instance, or self-managed Enterprise Advanced (EA) deployment to DBeaver using the MongoDB JDBC Driver.

Pré-requisitos

Procedimento

Para se conectar a partir do DBeaver:

1

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse o cluster dedicado do Atlas ou a instância do banco de dados federado do seu projeto.

  2. Clique no botão Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção JDBC Driver no menu suspenso Select your driver.

  5. Selecione o banco de dados ao qual deseja se conectar no menu suspenso Database.

  6. Copie a string de conexão

    Use essas informações para se conectar ao DBeaver em uma etapa posterior.

Use a connection string that is compatible with the MongoDB Java driver. To learn more, see Connection URI.

2

Abra seu aplicativo DBeaver.

3

Adicione um driver ao DBeaver.

  1. No DBeaver, clique em Database e selecione Driver Manager no menu suspenso.

  2. Clique em New para abrir o modal Create new driver.

  3. Na aba Settings, especifique as seguintes informações:

    Nome do driver

    MongoSQL

    Nome da classe

    com.mongodb.jdbc.MongoDriver

  4. Na guia Libraries, clique em Add File e adicione seu arquivo JDBC driver all.jar.

    Clique em Find Class.

  5. Clique em OK. O modal Create new driver fecha.

4

Cria uma conexão do banco de dados.

  1. No DBeaver, clique em Database e selecione New Database Connection no menu suspenso para abrir o modal Connect to a database.

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

  3. Na guia Main, insira as seguintes informações:

    JDBC URL

    String de conexão obtida em uma etapa anterior.

    Nome de usuário

    Usuário MongoDB autorizado para a conexão.

    Senha

    Senha associada ao usuário MongoDB .

  4. Na guia Driver properties, expanda User Properties. Adicione as seguintes propriedades de valor chave:

    database

    O nome do seu banco de dados virtual.

    utilizador

    O usuário do MongoDB com o qual se conectar. Não é obrigatório se você inseriu Username na etapa anterior.

Próximos passos

Depois de conectar sua ferramenta SQL ao banco de dados MongoDB , você pode consultar seus dados. Para saber mais, consulte:

Observação

Para se conectar usando um endpoint privado, consulte Conectar-se à interface do MongoDB SQL com um endpoint privado.

Voltar
Configuração do driver
Próximo
Query
Avalie esta página

Nesta página