Conector do MongoDB para BI

O Looker pode acessar o MongoDB usando o MongoDB Connector for BI com duas opções:

  • Usando o MongoDB Connector for BI em MongoDB Atlas.
  • Usando um MongoDB Connector for BI instalado no mesmo servidor que o banco de dados do MongoDB.

MongoDB Atlas

O MongoDB Atlas precisa usar um cluster M10 ou mais recente. Para que o Looker use um banco de dados do MongoDB em execução no MongoDB Atlas, é necessário usar o MongoDB Connector for BI (MongoBI). Para ativar o BI Connector for Atlas, o MongoDB Atlas precisa usar 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 MongoDB Connector for BI

Antes de criar uma conexão no Looker, o administrador do MongoDB ou do Atlas precisa configurar o MongoDB Connector for BI seguindo estas etapas, explicadas nesta página:

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

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

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

Como ativar o MongoDB Connector for BI

Ative o MongoDB Connector for BI:

  1. Verifique se você está em um cluster M10 ou mais recente.
  2. No Atlas, abra a página "Connect" do cluster. Anote o nome do host, a porta e o usuário. Você precisará usar essas 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 Mongo Connector for BI seguindo estas etapas, explicadas nesta página:

Instalar o Mongo Connector for BI

Instale o MongoDB Connector for BI no mesmo servidor que o banco de dados do MongoDB, conforme explicado na página de documentação do MongoDB Install BI Connector On Premises (link em inglês).

Criptografar o tráfego de rede

O MongoDB Connector for 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 Configure SSL for BI Connector (link em inglês).

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

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

use looker_database

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

Instalar os arquivos de driver JDBC do MongoBI

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

Faça o download destes dois arquivos JAR:

Siga as etapas na página de documentação Unpackaged JDBC drivers (link em inglês) 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 no Looker 6.2 ou 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 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 normais (recomendado)

As tabelas derivadas são ferramentas importantes no Looker que permitem expandir a sofisticação das suas análises. Elas também podem desempenhar um papel valioso na melhoria da performance da consulta. Em um nível alto, 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 MongoDB Connector for 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 de documentação do MongoDB sobre como configurar usuários de 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 Admin do Looker, selecione Connections e clique em Add Connection.

  2. Selecione MongoBI no menu suspenso Dialect.

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

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

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

Como usar funções e operadores SQL com o MongoDB Connector for BI

Ao desenvolver usando uma conexão do MongoDB Connector for BI, você pode usar as funções e os 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 oferece suporte aos seguintes recursos a partir do Looker 25.18:

Recurso Compatível?
Nível de suporteCom suporte
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas SQL persistentes
Tabelas derivadas nativas persistentes
Visualizações estáveis
Eliminação de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferenciação entre maiúsculas e minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
PDTs incrementais
Milissegundos
Microssegundos
Visualizações materializadas
Medidas de período a período
Contagem aproximada aproximada

Além disso: