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.
- Usar um conector do MongoDB para BI instalado no mesmo servidor que o banco de dados do MongoDB.
MongoDB Atlas
O MongoDB Atlas precisa usar um cluster M10+. Para que o Looker utilize 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 usando 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 regulares (recomendado)
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 IP do projeto. Adicione o endereço IP do Looker à lista de acesso IP do projeto Atlas:
- Descubra 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+.
- No Atlas, abra a página Conectar 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 Mongo Connector para BI seguindo estas etapas, explicadas nesta página:
- Como instalar o Mongo Connector para BI
- Como criptografar o tráfego de rede
- Configurar o usuário e as permissões do Looker
- Como permitir o uso de tabelas derivadas regulares (recomendado)
Como instalar o Mongo Connector para BI
Instale o conector do MongoDB para BI no mesmo servidor que o banco de dados do MongoDB, conforme explicado na seção Instalar o conector de BI no local Página de documentação do MongoDB.
Como criptografar o tráfego de rede
O MongoDB Connector 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 conector de BI.
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 da página da documentação Drivers JDBC não empacotados 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 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
Como 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 modo 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 do MongoDB para BI é compatível com tabelas derivadas regulares temporárias, mas não com tabelas derivadas persistentes.
Como as tabelas derivadas regulares são temporárias, elas não precisam ser armazenadas. Portanto, você não precisa criar um esquema para eles. No entanto, você precisa 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 do banco de dados para adicionar o papel dbOwner
no looker_tmp
do usuário que o Looker usará para se conectar.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Como criar a conexão do Looker com o 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 à maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao 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 Como testar a 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 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 oferece suporte aos seguintes recursos a partir do Looker 24.14:
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 |
Eliminação de consultas | 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 |
Processos de exibição do SQL Runner | Sim |
Tabela de descrição do executor do SQL | Sim |
Mostrar índices do SQL Runner | Sim |
Seleção do SQL Runner 10 | Sim |
Contagem de executores do SQL | Sim |
Explicação do SQL | Sim |
Credenciais OAuth | Não |
Comentários de contexto | Sim |
Pool de conexão | Não |
Esboços do HLL | Não |
Agregar reconhecimento | Não |
TDPs incrementais | Não |
Milissegundos | Não |
Microssegundos | Não |
Visualizações materializadas | Não |
Contagem aproximada diferente | Não |
Além disso:
- O MongoDB não aceita períodos de milissegundos e microssegundos para grupos de dimensões.
- O MongoDB não aceita os tipos de milissegundos, millisecondX e microssegundos para dimensões.
- O Looker trata todos os carimbos de data/hora acessados pelo MongoBI como no fuso horário universal coordenado (UTC).