MongoSQL

Conecte o Looker diretamente ao cluster do MongoSQL usando o dialeto 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.

O Looker inclui um driver JDBC oficialmente empacotado e licenciado pelo Apache-2.0 para a interface MongoSQL. Ao contrário do dialeto legado do MongoBI, não é necessário instalar manualmente os arquivos JAR do driver JDBC personalizados não empacotados.

Pré-requisitos e configuração do MongoSQL

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

Criar um esquema relacional usando o Criador de Esquemas SQL

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 SQL padrão, você precisa usar o SQL Schema Builder no MongoSQL para criar um esquema SQL.

A interface do MongoSQL depende do esquema relacional criado pelo SQL Schema Builder 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 suas coleções do MongoDB.

Consulte a documentação do MongoSQL Schema Builder 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 MongoDB SQL Schema Builder 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. Consulte a lista de endereços IP do Looker para a região da sua instância do Looker.
  2. Adicione esses endereços IP à lista de acesso de IP do seu 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 de 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. Digite um nome de usuário (por exemplo, looker) e uma senha segura.
  5. Em Privilégios do usuário do banco de dados, selecione Papel integrado e atribua o papel 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.

Acessar os parâmetros de conexão do Atlas SQL

Para criar a conexão do Looker, insira os parâmetros da conexão do Atlas SQL. Para conferir as informações do parâmetro, siga estas etapas:

  1. Faça login no console do MongoDB Atlas.
  2. Acesse o cluster e clique em Conectar.
  3. Selecione Atlas SQL (ou Conectar 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 Administrador 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 Como 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 do Atlas SQL (padrão: 27017).
    • Banco de dados: nome do banco de dados para o qual você criou um esquema usando o SQL Schema Builder.
    • 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 o SSL (ssl=true).
    • Parâmetros JDBC adicionais: (opcional) parâmetros JDBC adicionais compatíveis com o driver do MongoDB, como authSource=admin ou connectTimeoutMS=10000. Consulte Parâmetros JDBC compatíveis.
  3. Para verificar a conectividade do banco de dados, clique em Testar conexão.

  4. 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.

Parâmetros JDBC compatíveis

Para o dialeto MongoSQL, o Looker aceita os 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 do LookML e consultar o MongoSQL usando a interface SQL, lembre-se das seguintes características do dialeto:

  • Requisito do SQL Schema Builder: conforme observado nos pré-requisitos, as consultas SQL exigem um esquema relacional pré-configurado definido no Atlas SQL Schema Builder.
  • Tabelas derivadas: as tabelas derivadas temporárias (regulares) são compatíveis, mas as tabelas derivadas persistentes (PDTs) não são.
  • Tipos de data e carimbo de data/hora: o tipo de dados date não é compatível. 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 seja compatível com alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

O MongoSQL é 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