Conector do MongoDB para BI

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:

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:

  1. Conseguir o endereço IP do Looker.
  2. 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:

  1. Verifique se você está em um cluster do 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 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

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&#39 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

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:

Próximas etapas

Depois de concluir a configuração do banco de dados, conecte-se ao banco de dados no Looker.