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

Ativar o SQL

Para ativar o SQL no seu 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

Como desativar a aproximação COUNT DISTINCT (opcional)

Por padrão, o Druid aproxima 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 para a 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. Confira a seguir a descrição de algumas configurações:

• Nome: o nome da conexão.

• Dialeto: Apache Druid, Apache Druid 0.13+ ou Apache Druid 0.18+.

  Observação: se você estiver em uma instância do Looker (Google Cloud Core) e não encontrar seu dialeto listado no menu suspenso Dialect, consulte a documentação do Looker (Google Cloud Core) para verificar se o dialeto é compatível com as instâncias do Looker (Google Cloud Core).

• Host: endereço IP ou DNS do broker do cluster. Você encontra essa informação no arquivo broker/runtime.properties.

• Porta: a porta do broker. A porta padrão é 8082. Se o cluster estiver 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 Segurança básica do Druid. Se não for, você pode especificar qualquer string.

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

• Esquema: o esquema padrão a ser usado quando nenhum esquema for especificado. A entrada de 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 PDT e grupo de dados: uma expressão cron que indica quando o Looker deve verificar grupos de dados e tabelas derivadas persistentes. Leia mais sobre essa configuração na documentação Programação de manutenção de grupos de dados e PDT.

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

• Verificar SSL: marque essa opção para aplicar a verificação rigorosa do nome do host.

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

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

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

• Fuso horário do banco de dados: fuso horário do banco de dados. Compatível com o Apache Druid 0.13 e versões mais recentes e o Apache Druid 0.18 e versões mais recentes.

Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Teste de conectividade do banco de dados para informações sobre solução de problemas.

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

Se você tiver algum problema, consulte nossa documentação Teste de conexões.

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

Teste a conexão no SQL Runner. Navegue até o SQL Runner, selecione a conexão e o esquema e verifique se as tabelas do banco de dados aparecem.

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.

Apache Druid

O Apache Druid oferece suporte aos seguintes recursos a partir do Looker 24.16:

Recurso	Compatível?
Nível de suporte	Compatível
Looker (Google Cloud Core)	Não
Agregações simétricas	Não
Tabelas derivadas	Sim
Tabelas derivadas de SQL persistentes	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Consulta de interrupção	Não
Dinâmicas baseadas em SQL	Não
Fusos horários	Não
SSL	Sim
Subtotais	Não
Parâmetros adicionais do JDBC	Sim
Diferenciar maiúsculas e minúsculas	Sim
Tipo de local	Sim
Tipo de lista	Não
Percentil	Não
Percentil distinto	Não
Processos de exibição do SQL Runner	Não
Tabela de descrição do SQL Runner	Não
Índices de exibição do SQL Runner	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
SQL Explain	Sim
Credenciais OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
Esboços do HLL	Não
Agregar reconhecimento	Não
TDPs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada de valores distintos	Não

Apache Druid 0.13 ou superior

O Apache Druid 0.13+ oferece suporte aos seguintes recursos a partir do Looker 24.16:

Recurso	Compatível?
Nível de suporte	Compatível
Looker (Google Cloud Core)	Não
Agregações simétricas	Não
Tabelas derivadas	Sim
Tabelas derivadas de SQL persistentes	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Consulta de interrupção	Não
Dinâmicas baseadas em SQL	Não
Fusos horários	Sim
SSL	Sim
Subtotais	Não
Parâmetros adicionais do JDBC	Sim
Diferenciar maiúsculas e minúsculas	Sim
Tipo de local	Não
Tipo de lista	Não
Percentil	Não
Percentil distinto	Não
Processos de exibição do SQL Runner	Não
Tabela de descrição do SQL Runner	Não
Índices de exibição do SQL Runner	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
SQL Explain	Sim
Credenciais OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
Esboços do HLL	Não
Agregar reconhecimento	Não
TDPs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada de valores distintos	Não

Apache Druid 0.18 ou superior

O Apache Druid 0.18+ oferece suporte aos seguintes recursos a partir do Looker 24.16:

Recurso	Compatível?
Nível de suporte	Compatível
Looker (Google Cloud Core)	Sim
Agregações simétricas	Não
Tabelas derivadas	Sim
Tabelas derivadas de SQL persistentes	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Consulta de interrupção	Não
Dinâmicas baseadas em SQL	Não
Fusos horários	Sim
SSL	Sim
Subtotais	Não
Parâmetros adicionais do JDBC	Sim
Diferenciar maiúsculas e minúsculas	Sim
Tipo de local	Sim
Tipo de lista	Não
Percentil	Não
Percentil distinto	Não
Processos de exibição do SQL Runner	Não
Tabela de descrição do SQL Runner	Não
Índices de exibição do SQL Runner	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
SQL Explain	Sim
Credenciais OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
Esboços do HLL	Não
Agregar reconhecimento	Não
TDPs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada de valores distintos	Não

Próximas etapas

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