Learn the "why" behind slow queries and how to fix them in our 2-Part Webinar.
Register now >
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 de BI

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

Observação

O MongoDB suporta oficialmente Tableau (Desktop ou Servidor) 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 de BI SQL-92, mas o MongoDB não pode garantir compatibilidade. Teste seus recursos específicos da interface SQL para confirmar o suporte.

Conectar o Tableau

Conecte 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

  • Um banco de dados MongoDB, configurado para a interface SQL.

  • O driver JDBC do MongoDB . Para instalar, consulte Instalar o Driver JDBC.

  • Tableau Desktop ou servidor. Para o Tableau Server, autenticação SCRAM é o único mecanismo de autenticação suportado no momento.

Procedimento

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

1

Baixe o Connector Tableau para MongoDB.

  1. Baixe o arquivo mais recente do Tableau Connector taco na central de downloads 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 a instância do banco de dados federado do Atlas para seu projeto.

  2. Clique no botão 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 sua string de conexão para mongosh.

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.

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

Conectar o Power BI

Conecte 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

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

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 é o URL da etapa anterior.

    Você também pode inserir uma query SQL no campo Native query. O Power BI usa a query SQL como fonte direta para os dados.

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

    Por padrão, um usuário pode acessar todos os clusters e instâncias do banco de dados federado em projetos aos quais tem acesso. Se há restrição ao acesso a clusters específicos e instâncias do banco de dados federado, você poderá conceder acesso à nova instância do banco de dados federado no menu Edit User. Para aprender mais, consulte Configurar usuários de banco de dados.

Sobre direct query

Direct Query é um modo de conexão disponível com o Power BI Connector para MongoDB versão 1.2 e posterior. Para usar o Direct Query, você deve instalar o Driver do MongoDB ODBC versão 1.2 ou posterior.

a query direta é 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 sua instância do banco de dados federado do Atlas ao DBeaver usando o driver JDBC do MongoDB.

Pré-requisitos

Procedimento

Para se conectar à sua instância de banco de dados federado a partir do DBeaver:

1

No Atlas, acesse sua instância de banco de dados federado para seu projeto.

  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Data Federation sob o título Services.

A página Data Federation é exibida.

2

Clique em Connect para abrir o modal de conexão da instância do banco de dados federado.

3

Selecione MongoSQL.

4

Selecione JDBC Driver.

5

Copie suas informações de conexão.

O Atlas Data Federation fornece uma cadeia de conexão para conectar à sua instância do banco de dados federado. Você precisará disso em uma etapa posterior.

6

Abra seu aplicativo DBeaver.

7

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.

8

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 BI ao banco de dados MongoDB, você pode consultar seus dados. Para aprender mais, consulte:

Observação

Para se conectar usando um ponto de extremidade privado, consulte Conectar-se ao MongoSQL com um ponto de extremidade privado de instância do banco de dados federado. Para se conectar usando o MongoDB Shell, consulte Conectar-se a partir do MongoDB Shell.

Voltar

Configuração do driver

Próximo

Query

Nesta página