O Looker pode acessar o MongoDB usando o conector do 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+. Para que o Looker use um banco de dados MongoDB em execução no MongoDB Atlas, você precisa usar o MongoDB Connector para BI (MongoBI). Para ativar o conector de BI para o Atlas, é necessário que o MongoDB Atlas use um cluster M10+.
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 seguindo as etapas a seguir, explicadas nesta página:
- Adicionar o servidor do Looker à lista de acesso de IP do Atlas
- Ativar o conector do MongoDB para BI
- Permitir o uso de tabelas derivadas comuns (recomendado)
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 IP do projeto. Adicione o endereço IP do Looker à lista de acesso IP do projeto do Atlas:
- Conheça o endereço IP do Looker.
- Siga as instruções de configuração da lista de acesso por IP do Atlas para adicionar o endereço IP do Looker à lista de acesso de IP do Atlas.
Como ativar o conector do MongoDB para BI
Ative o conector do MongoDB para BI:
- Verifique se você está em um cluster M10 ou mais recente.
- 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 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 conector Mongo para BI usando as seguintes etapas, explicadas nesta página:
- Como instalar o conector Mongo para BI
- Como criptografar o tráfego de rede
- Configurar o usuário e as permissões do Looker
- Permitir o uso de tabelas derivadas comuns (recomendado)
Como instalar o Mongo Connector 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, digite 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()
com o papel readWrite
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Como instalar os arquivos de driver do MongoBI JDBC
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 motorista: mongobi
Entrada do motorista:
- 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
Na etapa para colocar o driver no diretório do seu dialeto, os caminhos para esses arquivos ficam 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. 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 conector do MongoDB para BI é compatível com tabelas derivadas regulares temporárias, mas não com tabelas derivadas persistentes.
Como as tabelas derivadas normais são temporárias, elas não precisam ser armazenadas. Portanto, não é preciso criar um esquema para eles. 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"} ])
Como 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:
- Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.
Selecione MongoBI no menu suspenso Dialeto.
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.
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.
Para salvar essas configurações, clique em Conectar.
Como usar funções e operadores SQL com o MongoDB Connector 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.16:
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 de SQL persistentes | Não |
Tabelas derivadas nativas nativas | Não |
Visualizações estáveis | Não |
Consulta de interrupção | Sim |
Dinâmicas baseadas 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 executor do SQL | Sim |
Mostrar índices 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 |
Pool de conexões | 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 distinta | Não |
Além disso:
- O MongoDB não oferece suporte a intervalos de milissegundos e microssegundos para grupos de dimensão.
- O MongoDB não aceita os tipos de milissegundos, millisecondX e microssegundos para dimensões.
- O Looker considera que todas as marcações de tempo acessadas no MongoBI estão no fuso horário universal coordenado (UTC).