Conector do MongoDB para BI

O Looker pode acessar o MongoDB usando o conector do MongoDB para BI de duas maneiras:

• Usando o conector do MongoDB para BI no MongoDB Atlas.
• Usando um conector do MongoDB para BI instalado no mesmo servidor que o banco de dados do MongoDB.

MongoDB Atlas

Seu MongoDB Atlas precisa usar um cluster M10 ou mais recente. Para que o Looker use um banco de dados MongoDB executado no MongoDB Atlas, é necessário usar o conector do MongoDB para BI (MongoBI). Para ativar o BI Connector para Atlas, o MongoDB Atlas precisa usar um cluster M10 ou mais recente.

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 seguindo estas etapas, que são explicadas nesta página:

• Adicionar o servidor do Looker à lista de acesso por IP do Atlas
• Ativar o conector do MongoDB para BI
• Permitir o uso de tabelas derivadas regulares (recomendado)

Adicionar o servidor do Looker à lista de acesso por IP do Atlas

O Atlas só permite conexões de clientes de entradas na lista de acesso por 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 por IP do Atlas para adicionar o endereço IP do Looker a essa lista.

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ê 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 do MongoDB para BI seguindo estas etapas, que são explicadas nesta página:

• Como instalar o Mongo Connector para BI
• Criptografia do tráfego de rede
• Configurar o usuário e as permissões do Looker
• Permitir o uso de tabelas derivadas regulares (recomendado)

Como instalar o conector do MongoDB para BI

Instale o conector do MongoDB para BI no mesmo servidor do banco de dados MongoDB, conforme explicado na página de documentação Instalar o conector de BI no local do MongoDB.

Criptografar o tráfego de rede

O conector do MongoDB para BI exige o uso da 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, insira o comando use para mudar para o banco de dados a que o Looker vai se conectar. Em seguida, crie um usuário do Looker com db.createUser() e a função readWrite:

use looker_database

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

Como instalar os arquivos do driver JDBC do MongoBI

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

Faça o download destes dois arquivos JAR:

• mongosql auth 1.0.0
• mysql connector java 5.1.47

Siga as etapas na página de 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 uma versão 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 vão ficar 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 aumentar a sofisticação das suas análises. Eles também podem ajudar a melhorar a performance da consulta. Em alto nível, a capacidade de tabela derivada do Looker oferece uma maneira de criar tabelas que ainda não existem no banco de dados.

O conector do MongoDB para BI é compatível com tabelas derivadas regulares temporárias, mas não com tabelas derivadas permanentes.

Como as tabelas derivadas regulares são temporárias, não é necessário armazená-las. Portanto, não é necessário criar um esquema para elas. No entanto, é necessário conceder a função 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 a função 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 Administrador do Looker, selecione Conexões e clique em Adicionar conexão.

2. Selecione MongoBI no menu suspenso Dialeto.

3. 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 Conectar o Looker ao seu banco de dados para mais informações.

4. Para verificar se a conexão foi bem-sucedida, clique em Testar. 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 Conectar.

Usar funções e operadores SQL com o conector do MongoDB para BI

Ao desenvolver usando uma conexão do conector do MongoDB para BI, é possível 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 ser compatível com eles.

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

Além disso:

• O MongoDB não oferece suporte a períodos de milissegundos e microssegundos para grupos de dimensões.
• O MongoDB não oferece suporte a tipos de milissegundo, milissegundoX e microssegundo para dimensões.
• O Looker trata todas as marcações de tempo acessadas do MongoBI como se estivessem no fuso horário universal coordenado (UTC).