Apache Druid

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 seu cluster do Apache Druid

<DRUID_BASE_DIR> se refere 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 do Druid, adicione esta linha ao arquivo de configuração broker/runtime.properties:

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

druid.sql.enable=true

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

Por padrão, o Druid faz uma aproximação 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`

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 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+ (Apache Druid 0.13.x - 0.17.x) ou Apache Druid 0.18+.

  • Host: DNS ou endereço IP 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 se o cluster do Apache Druid estiver configurado para usar a Segurança básica do Druid. Caso contrário, você pode especificar qualquer string.

  • Senha: a senha do usuário. Se o cluster não estiver configurado para usar a segurança básica do Druid, você poderá especificar qualquer string.

  • Esquema: o esquema padrão a ser usado quando nenhum esquema é especificado. A inserção 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: 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.

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

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

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

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

  • Pré-cache do SQL Runner: para que o SQL Runner não pré-carregue informações de tabela e carregue apenas quando uma tabela for selecionada, desmarque essa opção. Leia mais sobre essa configuração na documentação 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 o Apache Druid 0.18+.

Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a 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 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 problemas, consulte nossa documentação sobre 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 sua conexão e 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 é compatível com os seguintes recursos a partir do Looker 26.0:

Recurso Compatível?
Looker (Google Cloud Core)
Agregações simétricas
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 do 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
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
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

Apache Druid 0.13.x a 0.17.x

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

Recurso Compatível?
Looker (Google Cloud Core)
Agregações simétricas
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 do 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
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
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

Apache Druid 0.18 ou mais recente

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

Recurso Compatível?
Looker (Google Cloud Core)
Agregações simétricas
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 do 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
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
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

Próximas etapas

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