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.

O Looker inclui um driver JDBC com licença Apache 2.0 oficialmente agrupado 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:

Crie um esquema relacional usando o SQL Schema Builder

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 coleções do MongoDB.

Consulte a documentação do MongoSQL Schema Builder (link em inglês) 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.

Adicione 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. Acesse 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.

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

Receba os 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 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. 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.

Crie 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 o 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 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 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 efêmeras (regulares) são aceitas, mas as tabelas derivadas persistentes (TDPs) nã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.20:

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes com base em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas com base 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
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
Selecionar 10 do 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