Apache Druid

Como criptografar o tráfego de rede

É recomendável criptografar o tráfego de rede entre o aplicativo Looker e o 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> 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

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 o banco de dados

Na seção Admin do Looker, selecione Connections e clique em Add Connection.

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. Algumas das configurações são descritas a seguir:

  • Nome: o nome da conexão.

  • Dialect: 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 cluster Broker. Você pode encontrar isso 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, você poderá 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.

  • Schema: o esquema padrão a ser usado quando nenhum esquema for especificado. A inserção de um esquema é opcional.

  • Additional JDBC parameters: 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

  • Maintenance Schedule: 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 da 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.

  • Max connections per node: o padrão é 25. Essa configuração pode ser deixada no valor padrão inicialmente. Consulte a página de documentação Como conectar o Looker ao banco de dados para mais informações.

  • Connection Pool Timeout: o padrão é 120 segundos.

  • SQL Runner Precache: para que o SQL Runner não pré-carregue informações da tabela e carregue informações da tabela somente quando uma tabela for 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 estabelecida, clique em Test. 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 você tiver algum problema, consulte nossa documentação sobre como testar conexões.

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

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

Suporte a recursos

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

Apache Druid

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

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes com base em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas com base em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da 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
Selecionar 10 do SQL Runner
Contagem do SQL Runner
Explicar SQL
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
PDTs incrementais
Milissegundos
Microssegundos
Visualizações materializadas
Medidas de comparação de períodos
Contagem aproximada aproximada

Apache Druid 0.13.x - 0.17.x

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

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes com base em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas com base em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da 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
Selecionar 10 do SQL Runner
Contagem do SQL Runner
Explicar SQL
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
PDTs incrementais
Milissegundos
Microssegundos
Visualizações materializadas
Medidas de comparação de períodos
Contagem aproximada aproximada

Apache Druid 0.18+

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

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes com base em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas com base em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da 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
Selecionar 10 do SQL Runner
Contagem do SQL Runner
Explicar SQL
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
PDTs 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.