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 a 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, especifique 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 Como 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, confira 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 25.10:

Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x)

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

Apache Druid 0.18 ou mais recente

O Apache Druid 0.18 e versões mais recentes são compatíveis com os seguintes recursos a partir do Looker 25.10:

Próximas etapas

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