MongoSQL

Conecte o Looker diretamente ao seu cluster MongoSQL usando o dialeto MongoSQL (com tecnologia da interface 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 agrupado e licenciado pela Apache-2.0 para a interface MongoSQL pronto para uso. Ao contrário do dialeto legado do MongoBI, não é necessário instalar manualmente 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 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 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 em tabelas, linhas e colunas SQL padrão. Sem um esquema SQL ativo, a interface SQL não consegue traduzir consultas SQL nas suas 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 MongoDB SQL Schema Builder para definir seus esquemas.

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

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

  1. Consiga 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 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) ao banco de dados que o Looker vai acessar.
  6. Clique em Adicionar usuário para salvar as credenciais.

Extrair parâmetros de conexão do Atlas SQL

Para criar a conexão do Looker, você precisa inserir os parâmetros de conexão do Atlas SQL. Para acessar 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. Observe os requisitos gerados de Host, Porta (normalmente 27017), Banco de dados e SSL. 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 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 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 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 mostrar Pode se conectar, pressione Conectar para criar a conexão.

Sua conexão de banco de dados é adicionada à lista na página Conexões Administrador do Looker.

Parâmetros JDBC compatíveis

Para o dialeto MongoSQL, o Looker é compatível com 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 LookML e consultar o MongoSQL usando a interface SQL, lembre-se das 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 temporárias (regulares) são compatíveis, 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 é 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 ofereça suporte a 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.16:

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
Interrupçã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 no SQL Runner
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