O Looker requer pelo menos o MongoDB versão 4.0 ou mais recente e o MongoDB Connector para BI versão 2.6.0 ou mais recente (em que a variável de sessão
type_conversion_mode
foi introduzida).
O Looker pode acessar o MongoDB usando o conector do MongoDB para BI com duas opções:
- Como 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 use um banco de dados MongoDB em execução no MongoDB Atlas, é preciso usar o Conector do MongoDB para BI (MongoBI). Ativar o conector de BI para o Atlas requer que o MongoDB Atlas use um cluster M10+.
Também é necessário 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, que são explicadas nesta página:
- Adicione o servidor Looker à lista de acesso IP do Versa 3
- Ativar o conector do MongoDB para BI
- Permitir o uso de tabelas derivadas regulares (recomendado)
Como adicionar o servidor Looker à lista de acesso IP do Versa 3
O Versa 3 só permite conexões de cliente de entradas da lista de acesso de IP do projeto. Adicione o endereço IP do Looker à lista de acesso de IP do projeto Atlas:
- Conseguir o endereço IP do Looker.
- Siga as instruções de configuração da lista de acesso de IP do Versa 3 para adicionar o endereço IP do Looker à lista de acesso do IP do Versa 3.
Como ativar o conector do MongoDB para BI
Ative o conector do MongoDB para BI:
- Verifique se você está em um cluster do M10+.
- No Atlas, abra a página de conexão 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 conector do Mongo para BI usando as etapas a seguir, que são explicadas nesta página:
- Como instalar o conector do Mongo para BI
- Criptografia do tráfego de rede
- Como configurar o usuário e as permissões do Looker
- Como permitir o uso de tabelas derivadas regulares (recomendado)
Como instalar o conector do 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 Instalar o conector de BI no local do MongoDB.
Como criptografar o tráfego de rede
O conector do MongoDB para BI requer o uso de criptografia SSL entre o servidor do MongoDB' e o aplicativo do Looker. Siga as instruções de configuração do SSL na página de documentação do MongoDB sobre Configurar o SSL para o conector BI.
Como configurar o usuário e as permissões do Looker
No shell do MongoDB, insira o comando use
para alternar com o banco de dados ao qual o Looker 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 JDBC do MongoBI
Para ambas as opções do MongoDB Connector para BI, o Looker exige a configuração de arquivos do 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ê usa 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 para colocar o driver no diretório do dialeto, os caminhos para esses arquivos terão a seguinte aparência: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 e permitem expandir a sofisticação das análises. Eles também desempenham um papel valioso na melhoria do desempenho da consulta. Em alto nível, a funcionalidade 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 ainda não é compatível com tabelas derivadas permanentes.
Como as tabelas derivadas regulares são temporárias, elas não precisam ser armazenadas. Assim, você não precisa criar um esquema para eles. No entanto, é necessário conceder o papel dbOwner
ao esquema looker_tmp
, mesmo que esse esquema não exista.
Siga a seção "Modificar usuários do MongoDB" nesta página de documentação do MongoDB para adicionar o papel dbOwner
em looker_tmp
ao usuário que o Looker usará para se conectar.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Como adicionar a conexão
Configure uma conexão de banco de dados pela interface do Looker. Na seção Administrador, selecione Conexões e clique em Adicionar conexão. Preencha os detalhes de conexão. Para mais informações, consulte a página de documentação Como conectar o Looker ao seu banco de dados.
Clique em Testar estas configurações para verificar se a conexão foi concluída. A página de documentação Como testar a conectividade do banco de dados tem informações de solução de problemas.
Como usar funções e operadores SQL com o conector do MongoDB para BI
Ao desenvolver usando um conector MongoDB para conexão de BI, você pode usar as funções e os operadores SQL listados nesta página de documentação do MongoDB.
Suporte a recursos
Para que o Looker ofereça suporte a alguns recursos, seu dialeto do banco de dados também precisa aceitá-los.
Na versão mais recente do Looker, o MongoDB é compatível com os seguintes recursos do Looker:
Além disso:
- O MongoDB não é compatível com períodos de milissegundo e microssegundo para grupos de dimensões.
- O MongoDB não é compatível com tipos de milissegundos, milissegundosX e microssegundos para dimensões.
- O Looker trata todos os carimbos de data/hora acessados a partir do MongoBI como se estivessem no fuso horário universal coordenado (UTC, na sigla em inglês).
Próximas etapas
Depois de concluir a configuração do banco de dados, conecte-se ao banco de dados no Looker.