Apache Druid

Encriptar o tráfego de rede

É uma prática recomendada encriptar o tráfego de rede entre a aplicação Looker e a sua base de dados. Considere uma das opções descritas na página de documentação Ativar o acesso seguro à base de dados.

Configurar o cluster do Apache Druid

<DRUID_BASE_DIR> refere-se ao diretório base no qual o cluster do Apache Druid está instalado num servidor.

Ativar SQL

Para ativar o SQL na sua base de dados Druid, adicione esta linha ao ficheiro 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 predefinição, o Druid aproxima COUNT DISTINCT. Para obter resultados precisos, adicione esta linha ao ficheiro de configuração broker/runtime.properties:

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

`druid.sql.planner.useApproximateCountDistinct=false`

Criar a ligação do Looker à sua base de dados

Na secção Administração do Looker, selecione Ligações e, de seguida, clique em Adicionar ligação.

Preencha os detalhes da ligação. A maioria das definições é comum à maioria dos dialetos de bases de dados. Consulte a página de documentação Associar o Looker à sua base de dados para ver informações. Algumas das definições são descritas a seguir:

  • Nome: o nome da associação.

  • Dialeto: Apache Druid, Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x) ou Apache Druid 0.18+.

  • Anfitrião: DNS ou endereço IP do agente do cluster. Pode encontrar esta informação no ficheiro broker/runtime.properties.

  • Porta: a porta do agente. A porta predefinida é 8082. Se o seu cluster estiver protegido por SSL, a porta predefinida é 8182.

  • Base de dados: o nome da sua base de dados. A predefinição é druid.

  • Nome de utilizador: o nome de utilizador da base de dados se o cluster do Apache Druid estiver configurado para usar a segurança básica do Druid. Se não for, pode especificar qualquer string.

  • Palavra-passe: a palavra-passe do utilizador. Se o seu cluster não estiver configurado para usar a segurança básica do Druid, pode especificar qualquer string.

  • Esquema: o esquema predefinido a usar quando não é especificado nenhum esquema. A introdução de um esquema é opcional.

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

    • Estas propriedades podem ser definidas como propriedades de ligação:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    Exemplo: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Agendamento 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 acerca desta definição na documentação do cronograma de manutenção.

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

  • Validar SSL: selecione esta opção para aplicar a validação rigorosa do nome do anfitrião.

  • Máximo de ligações por nó: a predefinição é 25. Inicialmente, pode deixar esta definição com o valor predefinido. Consulte a página de documentação Ligar o Looker à sua base de dados para mais informações.

  • Limite de tempo do conjunto de ligações: a predefinição são 120 segundos.

  • Pré-cache da execução de SQL: para que a execução de SQL não pré-carregue as informações das tabelas e carregue as informações das tabelas apenas quando uma tabela é selecionada, desmarque esta opção. Leia mais acerca desta definição na documentação Pré-cache da execução de SQL.

  • Fuso horário da base de dados: fuso horário da base de dados. Suportado no Apache Druid 0.13+ e Apache Druid 0.18+.

Para verificar se a associação foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a conetividade da base de dados para ver informações de resolução de problemas.

O Looker executa uma consulta SELECT 1 para validar uma ligação básica e fazer um teste de consulta. Não valida se a combinação de catálogo e esquema existe ou se o utilizador tem o acesso necessário a esse esquema.

Se tiver problemas, consulte a nossa documentação Testar ligações.

Para guardar estas definições, clique em Associar.

Teste a ligação no SQL Runner. Navegue para o SQL Runner, selecione a ligação e o esquema e, em seguida, verifique se consegue ver as tabelas da base de dados.

Suporte de funcionalidades

Para que o Looker suporte algumas funcionalidades, o dialeto da base de dados também tem de as suportar.

Apache Druid

O Apache Druid suporta as seguintes funcionalidades a partir do Looker 25.14:

Funcionalidade Compatível?
Nível de apoio técnico
Suportado
Looker (Google Cloud Core)
Não
Dados agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas persistentes
Não
Vistas estáveis
Não
Interrupçã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 JDBC adicionais
Sim
Sensível a maiúsculas e minúsculas
Sim
Tipo de localização
Sim
Tipo de lista
Não
Percentil
Não
Percentil distinto
Não
Execução de SQL Mostrar processos
Não
Execução de SQL Describe Table
Não
Execução de SQL Mostrar índices
Não
Execução de SQL Select 10
Sim
Contagem da execução de SQL
Sim
SQL Explain
Sim
Credenciais do OAuth 2.0
Não
Comentários de contexto
Sim
Agrupamento de ligações
Não
Esboços HLL
Não
Notoriedade agregada
Não
PDTs incrementais
Não
Milissegundos
Sim
Microssegundos
Não
Vistas materializadas
Não
Medidas de comparação de períodos
Não
Contagem distinta aproximada
Não

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

O Apache Druid 0.13 e superior suporta as seguintes funcionalidades a partir do Looker 25.14:

Funcionalidade Compatível?
Nível de apoio técnico
Suportado
Looker (Google Cloud Core)
Não
Dados agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas persistentes
Não
Vistas estáveis
Não
Interrupção de consultas
Não
Tabelas dinâmicas baseadas em SQL
Não
Fusos horários
Sim
SSL
Sim
Subtotais
Não
Parâmetros JDBC adicionais
Sim
Sensível a maiúsculas e minúsculas
Sim
Tipo de localização
Não
Tipo de lista
Não
Percentil
Não
Percentil distinto
Não
Execução de SQL Mostrar processos
Não
Execução de SQL Describe Table
Não
Execução de SQL Mostrar índices
Não
Execução de SQL Select 10
Sim
Contagem da execução de SQL
Sim
SQL Explain
Sim
Credenciais do OAuth 2.0
Não
Comentários de contexto
Sim
Agrupamento de ligações
Não
Esboços HLL
Não
Notoriedade agregada
Não
PDTs incrementais
Não
Milissegundos
Sim
Microssegundos
Não
Vistas materializadas
Não
Medidas de comparação de períodos
Não
Contagem distinta aproximada
Não

Apache Druid 0.18 ou superior

O Apache Druid 0.18 e superior suporta as seguintes funcionalidades a partir do Looker 25.14:

Funcionalidade Compatível?
Nível de apoio técnico
Suportado
Looker (Google Cloud Core)
Sim
Dados agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas persistentes
Não
Vistas estáveis
Não
Interrupção de consultas
Não
Tabelas dinâmicas baseadas em SQL
Não
Fusos horários
Sim
SSL
Sim
Subtotais
Não
Parâmetros JDBC adicionais
Sim
Sensível a maiúsculas e minúsculas
Sim
Tipo de localização
Sim
Tipo de lista
Não
Percentil
Não
Percentil distinto
Não
Execução de SQL Mostrar processos
Não
Execução de SQL Describe Table
Não
Execução de SQL Mostrar índices
Não
Execução de SQL Select 10
Sim
Contagem da execução de SQL
Sim
SQL Explain
Sim
Credenciais do OAuth 2.0
Não
Comentários de contexto
Sim
Agrupamento de ligações
Não
Esboços HLL
Não
Notoriedade agregada
Não
PDTs incrementais
Não
Milissegundos
Sim
Microssegundos
Não
Vistas materializadas
Não
Medidas de comparação de períodos
Não
Contagem distinta aproximada
Não

Passos seguintes

Depois de concluir a ligação à base de dados, configure as opções de autenticação.