Apache Druid

Como criptografar o tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo Looker e seu banco de dados. Considere uma das opções descritas na página de documentação Como ativar o acesso seguro ao banco de dados.

Como configurar o cluster do Apache Druid

<DRUID_BASE_DIR> refere-se ao diretório base em que o cluster do Apache Druid está instalado em um servidor.

Ativação do SQL

Para ativar o SQL no banco de dados Druid, adicione esta linha ao arquivo de configuração broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

Desativando a aproximação de COUNT DISTINCT (opcional)

Por padrão, o Druid se aproxima de COUNT DISTINCT. Para resultados precisos, adicione esta linha ao arquivo de configuração broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

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

Preencher os detalhes de conexão. A maioria das configurações é comum à maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao banco de dados para mais informações. Algumas das configurações são descritas a seguir:

  • Nome: o nome da conexão.
  • Dialect: Apache Druid, Apache Druid 0.13+ ou Apache Druid 0.18+.

  • Host: DNS ou endereço IP do Agente do cluster. Ele está no arquivo broker/runtime.properties.

  • Porta: a porta do Broker. A porta padrão é 8082. Se o cluster for protegido por SSL, a porta padrão será 8182.

  • Banco de dados: o nome do seu banco de dados. O padrão é druid.

  • Nome de usuário: o nome de usuário do banco de dados, caso o cluster do Apache Druid esteja configurado para usar o Druid Basic Security. Se não for, você pode especificar qualquer string.

  • Senha: a senha do usuário. Se o cluster não estiver configurado para usar a Druid Basic Security, especifique qualquer string.

  • Esquema: o esquema padrão a ser usado quando não houver um esquema especificado. Inserir um esquema é opcional.

  • Parâmetros JDBC adicionais: Parâmetros JDBC do Avatica delimitados por ponto e vírgula.

    • Essas propriedades podem ser definidas como propriedades de conexão:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    Exemplo: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Programação de manutenção de TDP e grupo de dados: uma expressão cron que indica quando o Looker precisa verificar grupos de dados e tabelas derivadas persistentes. Leia mais sobre essa configuração na documentação Programação de manutenção de TDP e grupo de dados.

  • SSL: verifique se o cluster do Apache Druid está configurado para usar o TLS do Druid.

  • Verificar SSL: marque para aplicar uma verificação rígida do nome do host.

  • Máximo de conexões por nó: o padrão é 25. Inicialmente, essa configuração pode ser deixada com o valor padrão. Para mais informações, consulte a página de documentação Como conectar o Looker ao banco de dados.

  • Tempo limite do pool de conexão: o padrão é 120 segundos.

  • Pré-cache do SQL Runner: para fazer com que o SQL Runner não pré-carregue informações da tabela e só carregue quando uma tabela for selecionada, desmarque esta opção. Leia mais sobre essa configuração na documentação do SQL Runner Precache.

  • Database Time Zone: fuso horário do banco de dados. Compatível com o Apache Druid 0.13+ e o Apache Druid 0.18+.

Para verificar se a conexão foi estabelecida, clique em Testar. Consulte a página de documentação Como testar a conectividade do banco de dados para ver informações sobre solução de problemas.

O Looker executa uma consulta SELECT 1 para verificar uma conexão básica e fazer um teste de consulta. Ele não valida se a combinação de catálogo e esquema existe ou se o usuário tem o acesso necessário a esse esquema.

Se tiver algum problema, confira a documentação Como testar conexões.

Para salvar as configurações, clique em Conectar.

Teste a conexão no SQL Runner. Acesse SQL Runner, selecione a conexão e o esquema e verifique se as tabelas do banco de dados são exibidas.

Suporte a recursos

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

Apache Druid

O Apache Druid é compatível com os seguintes recursos a partir do Looker 24.8:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
No
Agregações simétricas
No
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
No
Tabelas derivadas nativas nativas
No
Visualizações estáveis
No
Encerramento da consulta
No
Tabelas dinâmicas baseadas em SQL
No
Fusos horários
No
SSL
Sim
Subtotais
No
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
No
Percentil
No
Percentil distinto
No
Processos da exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Índices de exibição do SQL Runner
No
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
No
Esboços do HLL
No
Reconhecimento agregado
No
TDPs incrementais
No
Milissegundos
Sim
Microssegundos
No
Visualizações materializadas
No
Contagem aproximada distinta
No

Apache Druid 0.13 ou superior

O Apache Druid 0.13+ é compatível com os seguintes recursos a partir do Looker 24.8:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
No
Agregações simétricas
No
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
No
Tabelas derivadas nativas nativas
No
Visualizações estáveis
No
Encerramento da consulta
No
Tabelas dinâmicas baseadas em SQL
No
Fusos horários
Sim
SSL
Sim
Subtotais
No
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
No
Tipo de lista
No
Percentil
No
Percentil distinto
No
Processos da exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Índices de exibição do SQL Runner
No
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
No
Esboços do HLL
No
Reconhecimento agregado
No
TDPs incrementais
No
Milissegundos
Sim
Microssegundos
No
Visualizações materializadas
No
Contagem aproximada distinta
No

Apache Druid 0.18 ou superior

O Apache Druid 0.18+ é compatível com os seguintes recursos a partir do Looker 24.8:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
No
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
No
Tabelas derivadas nativas nativas
No
Visualizações estáveis
No
Encerramento da consulta
No
Tabelas dinâmicas baseadas em SQL
No
Fusos horários
Sim
SSL
Sim
Subtotais
No
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
No
Percentil
No
Percentil distinto
No
Processos da exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Índices de exibição do SQL Runner
No
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
No
Esboços do HLL
No
Reconhecimento agregado
No
TDPs incrementais
No
Milissegundos
Sim
Microssegundos
No
Visualizações materializadas
No
Contagem aproximada distinta
No

Próximas etapas

Depois de concluir a conexão do banco de dados, configure as opções de autenticação.