Apache Druid

Criptografia do tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo do 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.

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

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+ (Apache Druide 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 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, é possível 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, especifique 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 do Avatica delimitados por ponto e vírgula. Consulte a seção Parâmetros JDBC compatíveis nesta página para ver a lista de parâmetros compatíveis com o Looker.

    • 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 os grupos de dados e as 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 no valor padrão inicialmente. Para mais informações, consulte a página de documentação Como conectar o Looker ao seu banco de dados.

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

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

  • 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 no botão Testar conexão na seção Detalhes do status na parte de baixo da página Configurações de conexões.

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 o Looker exibir Pode se conectar, pressione Conectar para criar a conexão.

A conexão do banco de dados é adicionada à lista na página Administrador de Conexões do Looker.

Teste a conexão no SQL Runner. Acesse o SQL Runner, selecione sua conexão e esquema e verifique se as tabelas do banco de dados estão visíveis.

Parâmetros JDBC compatíveis

Para o Apache Druid, o Looker é compatível com os seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais da conexão. Consulte a documentação do seu banco de dados para mais informações sobre esses parâmetros.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

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 26.22:

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas 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
Tabela de descrição 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 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

Apache Druid 0.13.x - 0.17.x

O Apache Druid 0.13.x - 0.17.x é compatível com os seguintes recursos a partir do Looker 26.22:

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas 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
Tabela de descrição 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 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

Apache Druid 0.18+

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

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas 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
Tabela de descrição 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 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

Próximas etapas

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