Como migrar do MongoBI para o MongoSQL
O Looker agora é compatível com o MongoSQL e recomenda a migração do MongoDB Connector for BI para o MongoSQL.
Devido às diferenças de sintaxe SQL entre o MongoDB Connector for BI (MongoBI) e o MongoSQL, os modelos do LookML que usam blocos SQL personalizados, formatação de data ou funções de banco de dados podem exigir ajustes de sintaxe. Não mude uma conexão de produção atual diretamente para o MongoSQL sem antes validar o código LookML, porque isso pode corromper painéis, Looks, programações ou alertas.
Para migrar com segurança do MongoBI para o MongoSQL, siga estas etapas:
- Revise as diferenças de sintaxe SQL entre o MongoBI e o MongoSQL na documentação do MongoDB Transição do Atlas BI Connector para o MongoSQL.
- Crie uma nova conexão para o MongoSQL no Looker como uma conexão secundária.
- Em uma nova ramificação de desenvolvimento no seu projeto do LookML, atualize o parâmetro
connectionno arquivo de modelo para apontar para a nova conexão do MongoSQL. - No SQL Runner, teste e execute consultas de amostra das suas Análises para verificar a sintaxe e os resultados da consulta.
- Valide o projeto e o conteúdo:
- Use o Validador de Conteúdo para verificar todos os dashboards e Looks em busca de campos ou referências corrompidos.
- Use o validador de SQL do CI do Looker para validar as dimensões nas suas análises em relação ao banco de dados.
- Depois de resolver os erros de validação, implante as mudanças na produção.
Como usar o conector do MongoDB para BI (MongoBI)
O Looker pode acessar o MongoDB usando o MongoDB Connector for BI de duas maneiras:
- Usando 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 do MongoDB em execução no MongoDB Atlas, use o MongoDB Connector for BI (MongoBI). Para ativar o BI Connector para o Atlas, o MongoDB Atlas precisa usar um cluster M10+.
Você também precisa criar uma conta de usuário com permissões de leitura para o banco de dados escolhido.
Como configurar o MongoDB Connector for 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 as etapas abaixo, que são explicadas nesta página:
- Adicionar o servidor do Looker à lista de acesso de IP do Atlas
- Ativar o MongoDB Connector for BI
- Permitir o uso de tabelas derivadas comuns (recomendado)
Adicionar o servidor do Looker à lista de acesso de 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 de IP do projeto do Atlas:
- Acesse o endereço IP do Looker.
- Siga as instruções de 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 MongoDB Connector for BI:
- Verifique se você está em um cluster M10+.
- No Atlas, abra a página "Connect" 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 Mongo Connector for BI seguindo as etapas abaixo, que são explicadas nesta página:
- Como instalar o Mongo Connector for 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 Mongo para BI
Instale o MongoDB Connector for BI no mesmo servidor que o banco de dados do MongoDB, conforme explicado na página de documentação do MongoDB Install BI Connector On Premises.
Criptografia do tráfego de rede
O MongoDB Connector for BI exige o uso de criptografia SSL entre o servidor do MongoDB e o aplicativo do Looker. Siga as instruções de configuração de SSL na página de documentação do MongoDB Configurar SSL para o conector de BI.
Como configurar o usuário e as permissões do Looker
No shell do MongoDB, digite o comando use para alternar para o banco de dados ao qual o Looker vai 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 do driver JDBC do MongoBI
Para as duas opções do MongoDB Connector for BI, o Looker exige a configuração dos 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 não empacotados usando os seguintes valores:
símbolo do driver: mongobi
driver entry:
- 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 dialeto, os caminhos para esses arquivos serão assim:
looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jarlooker/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 ampliar a sofisticação das suas análises. Eles também podem desempenhar um papel importante na melhoria do desempenho da consulta. Em alto nível, o recurso de tabela derivada do Looker permite criar novas tabelas que ainda não existem no banco de dados.
O MongoDB Connector for BI é compatível com tabelas derivadas regulares temporárias, mas não com tabelas derivadas persistentes.
Como as tabelas derivadas regulares são temporárias, elas não precisam ser armazenadas. Portanto, não é necessário criar um esquema para eles. No entanto, é preciso conceder o papel dbOwner ao esquema looker_tmp, mesmo que ele não exista.
Siga a seção "Modify MongoDB Users" nesta página de documentação do MongoDB sobre como configurar usuários de banco de dados para adicionar o papel 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:
- Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.
Selecione MongoBI no menu suspenso Dialeto.
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 bem-sucedida, clique no botão Testar conexão na seção Detalhes do status na parte de baixo da página Configurações de conexões.
Se o Looker exibir Pode se conectar, pressione Conectar para criar a conexão.
A conexão do banco de dados é adicionada à lista na página Administrador de Conexões do Looker.
Como usar funções e operadores SQL com o MongoDB Connector for BI
Ao desenvolver usando uma conexão do MongoDB Connector for BI, é possível usar as funções e os operadores SQL listados na documentação do MongoDB.
Parâmetros JDBC compatíveis
Para o conector do MongoDB para BI, o Looker é compatível com os seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais da conexão. Consulte a documentação do seu banco de dados para mais informações sobre esses parâmetros.
allowMultiQueriesappNameauthSourceautoReconnectcachePrepStmtscharacterEncodingconnectTimeoutconnectTimeoutMSelideSetAutoCommitsenabledSslProtocolSuitesenabledTLSProtocolsexplainSlowQueriesmaxAllowedPacketpasswordqueryInterceptorsqueryTimeoutKillsConnectionreplicaSetrewriteBatchedStatementssocketTimeoutsslsslModetcpKeepAliveuseCompressionuseCursorFetchuseLocalSessionStateuseruseServerPrepStmtsuseSSLverifyServerCertificatezeroDateTimeBehavior
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 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |
Além disso:
- O MongoDB não é compatível com períodos de milissegundos e microssegundos para grupos de dimensões.
- O MongoDB não é compatível com os tipos de milissegundo, millisecondX e microssegundo para dimensões.
- O Looker trata todos os carimbos de data/hora acessados do MongoBI como se estivessem no fuso horário universal coordenado (UTC).