MongoSQL

Conecte o Looker ao cluster do MongoSQL diretamente usando o MongoSQL (com tecnologia da interface do MongoSQL). Ao conectar o Looker ao MongoSQL, você pode analisar dados de documentos usando consultas SQL relacionais e criar painéis interativos do Looker.

Observação: O dialeto MongoSQL sucede e substitui o conector do MongoDB para BI legado. Se você estiver usando o conector do MongoDB para BI legado, atualize sua conexão para usar o dialeto MongoSQL. Consulte a documentação do MongoDB Transição do conector do Atlas BI para o MongoSQL para saber como migrar do conector do Atlas BI para a interface SQL mais recente.

O Looker inclui um driver JDBC oficialmente agrupado e licenciado pelo Apache-2.0 para a interface do MongoSQL. Ao contrário do dialeto MongoBI legado, não é necessária a instalação manual de arquivos JAR de driver JDBC personalizados não empacotados.

Pré-requisitos e configuração do MongoSQL

Antes de criar uma conexão no Looker, conclua as etapas de configuração a seguir no MongoSQL:

• Criar um esquema relacional usando o criador de esquemas SQL
• Adicionar endereços IP do Looker à lista de acesso de IP do Atlas
• Criar uma conta de usuário do MongoDB para o Looker
• Receber parâmetros de conexão SQL do Atlas

Criar um esquema relacional usando o criador de esquemas SQL

Importante: esta é uma etapa obrigatória.

O MongoDB armazena dados em um formato de documento flexível e não relacional (JSON/BSON). Antes que o Looker possa consultar suas coleções do MongoDB usando o SQL padrão, você precisa usar o criador de esquemas SQL no MongoSQL para criar um esquema SQL.

A interface do MongoSQL depende do esquema relacional criado pelo criador de esquemas SQL para mapear estruturas de documentos, campos aninhados e matrizes para tabelas, linhas e colunas SQL padrão. Sem um esquema SQL ativo, a interface SQL não poderá traduzir consultas SQL nas coleções do MongoDB.

Consulte a documentação do criador de esquemas do MongoSQL para definir e publicar seus esquemas tabulares antes de criar a conexão no Looker.

Para instâncias locais do MongoDB Enterprise, use a CLI do criador de esquemas SQL do MongoDB para definir seus esquemas.

Adicionar endereços IP do Looker à lista de acesso de IP do Atlas

O MongoSQL restringe as conexões de clientes a endereços IP autorizados. Para consultar o MongoSQL na instância do Looker, adicione os endereços IP do Looker à lista de acesso de IP do Atlas seguindo estas etapas:

1. Receba a lista de endereços IP do Looker para a região da instância do Looker.
2. Adicione esses endereços IP à lista de acesso de IP do projeto do Atlas de acordo com a documentação da lista de acesso de IP do Atlas.

Criar uma conta de usuário do MongoDB para o Looker

Use o console da Web do MongoDB Atlas para criar uma conta de usuário do banco de dados para o Looker seguindo estas etapas:

1. Faça login no console do MongoDB Atlas.
2. No menu de navegação principal, em Segurança, selecione Acesso ao banco de dados.
3. Clique em Adicionar novo usuário do banco de dados.
4. Selecione Senha como o método de autenticação. Insira um nome de usuário (por exemplo, looker) e uma senha segura.
5. Em Privilégios do usuário do banco de dados, selecione Função integrada e atribua a função read (ou permissões de leitura personalizadas) para o banco de dados que o Looker vai acessar.
6. Clique em Adicionar usuário para salvar as credenciais do usuário.

Receber parâmetros de conexão SQL do Atlas

Para criar a conexão do Looker, é necessário inserir parâmetros de conexão para a conexão SQL do Atlas. Para receber as informações do parâmetro, siga estas etapas:

1. Faça login no console do MongoDB Atlas.
2. Navegue até o cluster e clique em Conectar.
3. Selecione Atlas SQL (ou Conecte seu aplicativo usando SQL).
4. Selecione Driver JDBC.
5. Anote os requisitos de host, porta (normalmente 27017), banco de dados e SSL gerados. Você vai inserir esses detalhes ao criar a conexão do Looker.

Criar a conexão do Looker com seu banco de dados

Siga estas etapas para estabelecer a conexão do Looker com o MongoSQL:

1. Na seção Admin do Looker, selecione Conexões e clique em Adicionar conexão.

2. 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. Algumas das configurações são descritas a seguir. Use os valores padrão em todos os outros campos ou deixe-os em branco.

   • Nome: insira um nome de conexão exclusivo.
   • Dialeto: selecione MongoSQL no menu suspenso.
   • Host: nome do host fornecido pela interface do MongoSQL (por exemplo, <cluster-name>.a.query.mongodb.net).
   • Porta: número da porta para SQL do Atlas (padrão: 27017).
   • Banco de dados: nome do banco de dados para o qual você criou um esquema usando o criador de esquemas SQL.
   • Nome de usuário: nome de usuário do banco de dados criado para o Looker.
   • Senha: senha do usuário do banco de dados.
   • SSL: ative SSL (ssl=true).
   • Parâmetros JDBC adicionais: (opcional) parâmetros JDBC adicionais com suporte do driver do MongoDB, como authSource=admin ou connectTimeoutMS=10000. Consulte Parâmetros JDBC com suporte.

3. Para verificar a conectividade do banco de dados, clique em Testar conexão.

4. Se o Looker mostrar Pode se conectar, pressione Conectar para criar a conexão.

A conexão do banco de dados será adicionada à lista na página Conexões Admin do Looker.

Parâmetros JDBC com suporte

Para o dialeto MongoSQL, o Looker oferece suporte aos seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais:

• appName
• authSource
• clientinfo
• connectTimeoutMS
• directConnection
• disableclientcache
• extjsonmode
• heartbeatFrequencyMS
• journal
• localThresholdMS
• maxIdleTimeMS
• maxWaitTimeMS
• readPreference
• replicaSet
• retryReads
• retryWrites
• serverSelectionTimeoutMS
• socketTimeoutMS
• ssl
• tls
• tlsAllowInvalidHostnames
• tlsInsecure
• w
• wtimeoutMS

Limitações de consulta e comportamento do SQL

Ao criar modelos LookML e consultar o MongoSQL usando a interface SQL, tenha em mente as seguintes características do dialeto:

• Requisito do criador de esquemas SQL: conforme observado nos pré-requisitos, as consultas SQL exigem um esquema relacional pré-configurado definido no criador de esquemas SQL do Atlas.
• Tabelas derivadas: as tabelas derivadas efêmeras (regulares) são aceitas, mas as tabelas derivadas persistentes (TDPs) não são.
• Tipos de data e carimbo de data/hora: o tipo de dados date não é aceito. A prática padrão é armazenar e modelar datas como campos timestamp.
• Fusos horários: todos os carimbos de data/hora acessados na interface do MongoSQL são tratados em UTC. O Looker não converte fusos horários no banco de dados para conexões do MongoDB.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa oferecer suporte a eles.

O MongoSQL oferece suporte aos seguintes recursos a partir do Looker 26.16:

Recurso	Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas SQL persistentes
Tabelas derivadas nativas persistentes
Visualizações estáveis
Eliminação de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferenciação entre maiúsculas e minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
Selecionar 10 do SQL Runner
Contagem do SQL Runner
Explicar 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