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.

Conecte sua ferramenta SQL ao MongoDB

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

Todas as três opções de implantação da SQL Interface 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, uma instância do banco de dados federado do Atlas ou uma implantação autogerenciada do Enterprise Advanced (EA). Configure sua implantação para aceitar conexões SQL primeiro. Para saber como, consulte Configurar do Servidor de Interface SQL.

Observação

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

FERRAMENTAS como Grafana e Metabase fornecem seus próprios conectores e plugins do MongoDB, mas o MongoDB não oferece suporte oficial a essas integrações. Para obter informações sobre como configurar, consulte a documentação da fonte de dados do Grafana MongoDB e do Metabase MongoDB.

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 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 servidor versão 2025 e posteriores incluem o 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 a partir do Tableau. Pesquise MongoDB SQL interface by MongoDB no Tableau Exchange 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 seu cluster dedicado do Atlas ou instância do banco de dados federado para 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.

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 .

8

Clique em Sign In.

Configurar o registro do Tableau

Para alterar a configuração de log do driver JDBC do MongoDB JDBC, adicione as propriedades de log 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 servidor (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 log, adicione as seguintes propriedades ao arquivo:

loglevel=INFOlogdir=<path-to-log-directory>

A propriedade loglevel define o detalhamento dos logs do driver. Ele aceita os seguintes valores, em ordem crescente de detalhamento: 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á logs no console em vez de em um arquivo.

Importante

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

Para aprender mais sobre arquivos de propriedade 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 BI Connector para MongoDB.

Pré-requisitos

  • O driver ODBC do MongoDB. Para instalar, consulte Configurar o driver da interface SQL. Para usar o Direct Query, você deve instalar a versão 1.2 ou posterior.

  • Power BI Desktop 64 bit. 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 seu cluster dedicado do Atlas ou instância do banco de dados federado para 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 estas informações para se conectar ao Power BI em uma etapa posterior.

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.

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

    No campo Native query, você pode inserir opcionalmente 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 do Power Query após 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 aprender mais, consulte Configurar usuários de 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 driver ODBC do MongoDB versão 1.2 ou posterior. Você não precisa configurar um DSN.

O Direct Query é uma alternativa ao modo de importação padrão e permite que você faça uma query no seu banco de dados diretamente. Isso dá garantias de 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 implantação Enterprise Advanced (EA) autogerenciada ao DBeaver usando o driver JDBC do MongoDB.

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 seu cluster dedicado do Atlas ou instância do banco de dados federado para 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 estas informações para se conectar ao DBeaver em uma etapa posterior.

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 seu banco de dados MongoDB, você pode fazer query nos seus dados. Para aprender mais, consulte:

Observação

Para se conectar usando um private endpoints, consulte Conectar à interface SQL do MongoDB com um private endpoints.

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

Nesta página