Conector do MongoDB para BI

O Looker pode acessar o MongoDB usando o conector MongoDB para BI com duas opções:

  • Usar o conector do MongoDB para BI no MongoDB Atlas.
  • Usando um conector MongoDB para BI instalado no mesmo servidor que o banco de dados MongoDB.

MongoDB Atlas

O MongoDB Atlas precisa usar um cluster M10 ou mais recente. Para que o Looker use um banco de dados MongoDB executado no MongoDB Atlas, use o conector MongoDB para BI (MongoBI). A ativação do conector de BI para o Atlas exige que o MongoDB Atlas use um cluster M10 ou mais recente.

Você também precisa criar uma conta de usuário com permissões de leitura para o banco de dados desejado.

Como configurar o conector do MongoDB para BI

Antes de criar uma conexão no Looker, o administrador do MongoDB ou do Atlas precisa configurar o conector do MongoDB para BI usando as etapas a seguir, explicadas nesta página:

Como adicionar o servidor do Looker à lista de acesso IP do Atlas

O Atlas só permite conexões de clientes de entradas na lista de acesso a IP do projeto. Adicione o endereço IP do Looker à lista de acesso IP do projeto do Atlas:

  1. Conseguir o endereço IP do Looker.
  2. Siga as instruções de configuração da lista de acesso a IPs do Atlas para adicionar o endereço IP do Looker à lista de acesso a IPs do Atlas.

Como ativar o conector do MongoDB para BI

Ative o conector do MongoDB para BI:

  1. Verifique se você está em um cluster M10 ou mais recente.
  2. No Atlas, abra a página do Connect para o cluster. Anote o nome do host, a porta e o usuário. Você vai precisar dessas informações ao configurar a conexão no Looker.

MongoDB no mesmo servidor

Antes de criar uma conexão no Looker, o administrador do MongoDB precisa configurar o MongoDB e o conector Mongo para BI usando as etapas a seguir, explicadas nesta página:

Como instalar o conector Mongo para BI

Instale o conector do MongoDB para BI no mesmo servidor do banco de dados do MongoDB, conforme explicado na página de documentação do MongoDB Instalar o conector de BI localmente .

Como criptografar o tráfego de rede

O conector do MongoDB para BI exige o uso de criptografia SSL entre o servidor do MongoDB e o aplicativo Looker. Siga as instruções de configuração do SSL na página de documentação do MongoDB Configurar SSL para o BI Connector.

Configurar o usuário e as permissões do Looker

No shell do MongoDB, insira o comando use para alternar para o banco de dados ao qual o Looker vai se conectar. Em seguida, crie um usuário para o Looker com db.createUser() e a função readWrite:

use looker_database

db.createUser({ user: looker,
                pwd: `some_password_here`,
                roles: [ "readWrite" ]
              })

Como instalar os arquivos do driver JDBC do MongoBI

Para as duas opções do conector do MongoDB para BI, o Looker exige a configuração de arquivos de driver JDBC seguindo estas etapas:

Faça o download destes dois arquivos JAR:

Siga as etapas na página de documentação Drivers JDBC desempacotados usando os seguintes valores:

símbolo do driver: mongobi

entrada do driver:

- name: mongobi
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Se você estiver usando o Looker 6.2 ou uma versão anterior:

- name: maria15x
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Para a etapa de colocar o driver no diretório do seu dialeto, os caminhos para esses arquivos serão assim:

  • looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
  • looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

Permitir o uso de tabelas derivadas regulares (recomendado)

As tabelas derivadas são ferramentas importantes no Looker que permitem ampliar a sofisticação das suas análises. Eles também podem ter um papel importante na melhoria da performance da consulta. De forma geral, o recurso de tabela derivada do Looker oferece uma maneira de criar novas tabelas que ainda não existem no seu banco de dados.

O conector MongoDB para BI oferece suporte a tabelas derivadas normais temporárias, mas não a tabelas derivadas persistentes.

Como as tabelas derivadas normais são temporárias, elas não precisam ser armazenadas. Portanto, não é necessário criar um esquema para elas. No entanto, é necessário conceder o papel dbOwner ao esquema looker_tmp, mesmo que ele não exista.

Siga a seção "Modificar usuários do MongoDB" nesta página da documentação do MongoDB sobre como configurar usuários do banco de dados para adicionar o papel dbOwner em looker_tmp para o usuário que o Looker vai usar para se conectar.

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

Criar a conexão do Looker com seu banco de dados

Siga estas etapas para criar a conexão do Looker com seu banco de dados:

  1. Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.

  2. Selecione MongoBI no menu suspenso Dialect.

  3. Preencher os detalhes de conexão. A maioria das configurações é comum para a maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao seu banco de dados para mais informações.

  4. Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Teste de conectividade do banco de dados para informações sobre solução de problemas.

  5. Para salvar essas configurações, clique em Conectar.

Como usar funções e operadores SQL com o conector do MongoDB para BI

Ao desenvolver usando um conector do MongoDB para conexão de BI, você pode usar as funções e operadores SQL listados na documentação do MongoDB.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa oferecer suporte a eles.

O MongoBI é compatível com os seguintes recursos a partir do Looker 24.20:

Recurso Compatível?
Nível de suporte
Compatível
Looker (Google Cloud Core)
Não
Agregações simétricas
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas nativas
Não
Visualizações estáveis
Não
Consulta de interrupção
Sim
Pivots baseados em SQL
Não
Fusos horários
Não
SSL
Sim
Subtotais
Não
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Não
Percentil
Não
Percentil distinto
Não
SQL Runner Show Processes
Sim
Tabela de descrição do SQL Runner
Sim
Índices de exibição do SQL Runner
Sim
SQL Runner Select 10
Sim
Contagem do SQL Runner
Sim
SQL Explain
Sim
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pooling de conexão
Não
Esboços HLL
Não
Conscientização agregada
Não
PDTs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Visualizações materializadas
Não
Contagem aproximada de valores distintos
Não

Além disso: