Conetor do MongoDB para BI

O Looker pode aceder ao MongoDB através do conetor do MongoDB para BI com duas opções:

  • Usando o conetor do MongoDB para inteligência empresarial no MongoDB Atlas.
  • Usando um conetor do MongoDB para BI instalado no mesmo servidor que a base de dados do MongoDB.

MongoDB Atlas

O seu MongoDB Atlas tem de usar um cluster M10 ou superior. Para que o Looker use uma base de dados MongoDB em execução no MongoDB Atlas, tem de usar o MongoDB Connector for BI (MongoBI). A ativação do BI Connector para o Atlas requer que o MongoDB Atlas use um cluster M10 ou superior.

Também tem de criar uma conta de utilizador com autorizações de leitura para a base de dados pretendida.

Configurar o conetor do MongoDB para BI

Antes de criar uma ligação no Looker, o administrador do MongoDB ou do Atlas tem de configurar o conector do MongoDB para BI através dos seguintes passos, que são explicados nesta página:

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

O Atlas só permite ligações de clientes a partir de entradas na lista de acesso de IP do projeto. Adicione o endereço IP do Looker à lista de acesso por IP do projeto do Atlas:

  1. Obtenha o endereço IP do Looker.
  2. Siga as instruções de configuração da lista de acesso a IPs do Atlas para adicionar o endereço IP do Looker à lista de acesso a IPs do Atlas.

Ativar o conetor do MongoDB para BI

Ative o conetor do MongoDB para inteligência empresarial:

  1. Verifique se está num cluster M10+.
  2. No Atlas, abra a página Connect para o cluster. Tome nota do nome do anfitrião, da porta e do utilizador. Tem de usar essas informações quando configurar a ligação no Looker.

MongoDB no mesmo servidor

Antes de criar uma ligação no Looker, o administrador do MongoDB deve configurar o MongoDB e o Mongo Connector for BI através dos seguintes passos, que são explicados nesta página:

Instalar o conetor do Mongo para BI

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

Encriptar o tráfego de rede

O conector do MongoDB para BI requer a utilização da encriptação SSL entre o servidor do MongoDB e a aplicação Looker. Siga as instruções de configuração de SSL na página de documentação do MongoDB Configure o SSL para o BI Connector.

Configurar o utilizador e as autorizações do Looker

No shell do MongoDB, introduza o comando use para mudar para a base de dados à qual o Looker se vai ligar. Em seguida, crie um utilizador para o Looker com db.createUser() com a função readWrite:

use looker_database

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

Instalar os ficheiros do controlador JDBC do MongoBI

Para ambas as opções do conetor do MongoDB para BI, o Looker requer a configuração de ficheiros de controladores JDBC através dos seguintes passos:

Transfira estes dois ficheiros JAR:

Siga os passos na página de documentação Drivers JDBC não incluídos em pacotes com os seguintes valores:

Símbolo do condutor: mongobi

entrada do condutor:

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

Se estiver no Looker 6.2 ou anterior:

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

Para o passo para colocar o controlador no diretório do seu dialeto, os caminhos para estes ficheiros têm o seguinte aspeto:

  • 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 a utilização de tabelas derivadas normais (recomendado)

As tabelas derivadas são ferramentas importantes no Looker que lhe permitem expandir a sofisticação das suas análises. Também podem desempenhar um papel importante na melhoria do desempenho das consultas. A um nível elevado, a capacidade de tabelas derivadas do Looker oferece uma forma de criar novas tabelas que ainda não existem na sua base de dados.

O conetor do MongoDB para BI suporta tabelas derivadas regulares temporárias, mas não suporta tabelas derivadas persistentes.

Uma vez que as tabelas derivadas normais são temporárias, não precisam de ser armazenadas. Assim, não precisa de criar um esquema para os mesmos. No entanto, tem de conceder a função dbOwner ao esquema looker_tmp, mesmo que esse esquema não exista.

Siga a secção Modificar utilizadores do MongoDB nesta página de documentação do MongoDB sobre a configuração de utilizadores da base de dados para adicionar a função dbOwner em looker_tmp para o utilizador que o Looker vai usar para estabelecer ligação.

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

Criar a ligação do Looker à sua base de dados

Siga estes passos para criar a ligação do Looker à sua base de dados:

  1. Na secção Administração do Looker, selecione Ligações e, de seguida, clique em Adicionar ligação.

  2. Selecione MongoBI no menu pendente Dialeto.

  3. Preencha os detalhes da ligação. A maioria das definições é comum à maioria dos dialetos de bases de dados. Consulte a página de documentação Associar o Looker à sua base de dados para ver informações.

  4. Para verificar se a associação foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a conetividade da base de dados para ver informações de resolução de problemas.

  5. Para guardar estas definições, clique em Associar.

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

Quando desenvolve com uma ligação do MongoDB Connector for BI, pode usar as funções e os operadores SQL indicados na documentação do MongoDB.

Suporte de funcionalidades

Para que o Looker suporte algumas funcionalidades, o dialeto da base de dados também tem de as suportar.

O MongoBI suporta as seguintes funcionalidades a partir do Looker 25.14:

Funcionalidade Compatível?
Nível de apoio técnico
Suportado
Looker (Google Cloud Core)
Não
Dados agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas persistentes
Não
Vistas estáveis
Não
Interrupção de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Não
Fusos horários
Não
SSL
Sim
Subtotais
Não
Parâmetros JDBC adicionais
Sim
Sensível a maiúsculas e minúsculas
Sim
Tipo de localização
Sim
Tipo de lista
Não
Percentil
Não
Percentil distinto
Não
Execução de SQL Mostrar processos
Sim
Execução de SQL Describe Table
Sim
Execução de SQL Mostrar índices
Sim
Execução de SQL Select 10
Sim
Contagem da execução de SQL
Sim
SQL Explain
Sim
Credenciais do OAuth 2.0
Não
Comentários de contexto
Sim
Agrupamento de ligações
Não
Esboços HLL
Não
Notoriedade agregada
Não
PDTs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Vistas materializadas
Não
Medidas de comparação de períodos
Não
Contagem distinta aproximada
Não

Além disso: