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

Conecte sua ferramenta SQL, como Tableau, Power BI ou DBeaver ao seu banco de dados MongoDB Atlas ou Enterprise Advanced (EA).

Todas as três opções de implantação da Interface SQL usam os mesmos drivers JDBC e ODBC , portanto, as etapas nesta página são as mesmas, independentemente de você se conectar a um cluster dedicado do Atlas , a uma instância do banco de dados federado do Atlas ou a um sistema autogerenciado do Enterprise Advanced (EA). Configure seu sistema para aceitar primeiro as conexões SQL. Para saber como, consulte Configuração do servidor de interface SQL.

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

Conecte um cluster dedicado do Atlas , uma instância do banco de dados federado do Atlas ou um banco de dados Enterprise Advanced (EA) auto-hospedado ao Tableau (desktop ou servidor) usando o conector do Tableau para 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 uma string de conexão compatível com o driver Java do MongoDB . Para saber mais, consulte URI de conexão.

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

Conecte um cluster dedicado do Atlas , uma instância do banco de dados federado do Atlas ou um banco de dados Enterprise Advanced (EA) auto-hospedado ao Power BI usando o Power BI Connector para MongoDB.

Pré-requisitos

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 seu URI de MongoDB deployment. Para saber mais,consulte 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.

    Por padrão, os usuários podem acessar todos os namespaces que suas funções e URI de conexão permitem. Se você usar funções personalizadas para restringir o acesso, poderá conceder aos usuários acesso a namespaces adicionais no menu Edit User. Para saber mais, consulte Configurar usuários do banco de dados.

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

Direct Query

Direct Query é um modo de conexão disponível com o BI Connector para MongoDB versão 1.2 e posterior. Para usar o Direct Query, você deve instalar o MongoDB ODBC Driver versão 1.2 ou posterior. Você não precisa configurar um 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

Conecte seu cluster dedicado do Atlas , instância do banco de dados federado do Atlas ou sistema Enterprise Advanced (EA) autogerenciado ao DBeaver usando o 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 uma string de conexão compatível com o driver Java do MongoDB . Para saber mais, consulte URI de conexão.

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