Conector MongoDB para BI

O Looker requer pelo menos o MongoDB versão 4.0+ e o MongoDB Connector para BI versão 2.6.0+ (em que a variável de sessão type_conversion_mode foi introduzida).

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

  • Como 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, é preciso usar o MongoDB Connector para BI (MongoBI). A ativação do conector de BI para o Atlas exige que o MongoDB Atlas use um cluster M10+.

Também é necessário criar uma conta de usuário que tenha permissões de leitura no 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 estas etapas:

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

O Atlas só permite conexões de cliente de entradas na lista de acesso de 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 na 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 conector do MongoDB para BI

Ative o conector do MongoDB para BI:

  1. Verifique se você está em um cluster M10+.
  2. 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 Mongo Connector para BI seguindo as etapas a seguir, que são explicadas nesta página:

Como instalar o conector Mongo para BI

Instale o conector do MongoDB para BI no mesmo servidor que o 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 Looker. Siga as instruções de configuração do SSL na página de documentação Configurar o SSL para o conector de BI do MongoDB.

Como 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 se conectará. Em seguida, crie um usuário para o Looker com a 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 JDBC do MongoBI

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

Faça o download destes dois arquivos JAR:

Siga as etapas na página de documentação dos drivers JDBC descompactados usando os seguintes valores:

símbolo do motorista: mongobi

entrada do driver:

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

Se você usar o Looker 6.2 ou 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 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

As tabelas derivadas são ferramentas importantes no Looker que permitem expandir a sofisticação das suas análises. Eles também podem desempenhar um papel valioso no aprimoramento do desempenho da consulta. Em um 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 elas. 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 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.

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 concluída, clique em Testar. Consulte a página de documentação Como testar a conectividade do banco de dados para ver 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 MongoDB para BI

Ao desenvolver usando uma conexão do MongoDB Connector para 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 seja compatível com alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

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

Recurso Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Não
Agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas do SQL permanente
Não
Tabelas derivadas nativas nativas
Não
Visualizações estáveis
Não
Eliminação de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Não
Fusos horários
Não
SSL
Sim
Subtotais
Não
Parâmetros adicionais de 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 do SQL Runner Show
Sim
Tabela de descrição do SQL Runner
Sim
Índices do SQL Runner Show
Sim
SQL Runner Select 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pool de conexão
Não
HLL Sketches
Não
Reconhecimento agregado
Não
PDTs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Visualizações materializadas
Não
Contagem aproximada diferente
Não

Além disso: