Apache Druid

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.

Como ativar o 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 estima 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 seu banco de dados para mais informações. Algumas das configurações são descritas a seguir:

• Nome: o nome da conexão.
• Dialeto: Apache Druid, Apache Druid 0.13+ ou Apache Druid 0.18+
• Host: endereço DNS ou IP do cluster Broker Você pode encontrar essa informação no arquivo broker/runtime.properties.
• Porta: a porta do agente. 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 se o cluster do Apache Druid estiver configurado para usar o Druid Basic Security. Se não for, você poderá especificar qualquer string.
• Senha: a senha do usuário. Se o cluster não estiver configurado para usar o Druid Basic Security, você poderá especificar qualquer string.
• Esquema: é o esquema padrão a ser usado quando não há um esquema especificado. Inserir um esquema é opcional.

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

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

  Exemplo: 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 as tabelas derivadas permanentes. Leia mais sobre essa configuração na documentação Programação de manutenção do PDT e do grupo de dados.

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

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

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

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

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

• 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 concluída, 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 realizar um teste de consulta. Ele não valida a combinação entre o catálogo e o esquema, nem garante que o usuário tenha acesso a esse esquema.

Se você tiver problemas, confira nossa documentação Como testar conexões.

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

Teste a conexão no SQL Runner. Acesse o SQL Runner, selecione a conexão e o esquema e verifique se é possível ver as tabelas do banco de dados.

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.

Apache Druid

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

Recurso	Compatível?
Nível do suporte	Compatível
Looker (Google Cloud Core)	Não
Agregados simétricos	Não
Tabelas derivadas	Sim
Tabelas derivadas do SQL permanente	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Eliminação de consultas	Não
Tabelas dinâmicas baseadas em SQL	Não
Fusos horários	Não
SSL	Sim
Subtotais	Não
Parâmetros adicionais de 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 do SQL Runner Show	Não
Tabela de descrição do SQL Runner	Não
Índices do SQL Runner Show	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
Explicação do SQL	Sim
Credenciais do OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
HLL Sketches	Não
Reconhecimento agregado	Não
PDTs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada diferente	Não

Apache Druid 0.13 ou posterior

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

Recurso	Compatível?
Nível do suporte	Compatível
Looker (Google Cloud Core)	Não
Agregados simétricos	Não
Tabelas derivadas	Sim
Tabelas derivadas do SQL permanente	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Eliminação de consultas	Não
Tabelas dinâmicas baseadas em SQL	Não
Fusos horários	Sim
SSL	Sim
Subtotais	Não
Parâmetros adicionais de 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 do SQL Runner Show	Não
Tabela de descrição do SQL Runner	Não
Índices do SQL Runner Show	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
Explicação do SQL	Sim
Credenciais do OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
HLL Sketches	Não
Reconhecimento agregado	Não
PDTs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada diferente	Não

Apache Druid 0.18 ou posterior

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

Recurso	Compatível?
Nível do suporte	Compatível
Looker (Google Cloud Core)	Sim
Agregados simétricos	Não
Tabelas derivadas	Sim
Tabelas derivadas do SQL permanente	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Eliminação de consultas	Não
Tabelas dinâmicas baseadas em SQL	Não
Fusos horários	Sim
SSL	Sim
Subtotais	Não
Parâmetros adicionais de 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 do SQL Runner Show	Não
Tabela de descrição do SQL Runner	Não
Índices do SQL Runner Show	Não
SQL Runner Select 10	Sim
Contagem de executores do SQL	Sim
Explicação do SQL	Sim
Credenciais do OAuth	Não
Comentários de contexto	Sim
Pool de conexão	Não
HLL Sketches	Não
Reconhecimento agregado	Não
PDTs incrementais	Não
Milissegundos	Sim
Microssegundos	Não
Visualizações materializadas	Não
Contagem aproximada diferente	Não

Próximas etapas

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