Apache Druid

加密网络流量

对 Looker 应用与数据库之间的网络流量进行加密是一种最佳实践。可以考虑启用安全的数据库访问文档页面上介绍的某个选项。

配置 Apache Druid 集群

<DRUID_BASE_DIR> 是指 Apache Druid 集群安装在服务器上的基本目录。

启用 SQL

如需在 Druid 数据库上启用 SQL，请将以下这行代码添加到 broker/runtime.properties 配置文件中：

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

druid.sql.enable=true

关闭 COUNT DISTINCT 近似值（可选）

默认情况下，Druid 会近似计算 COUNT DISTINCT。如需获得精确的结果，请将以下这行代码添加到 broker/runtime.properties 配置文件中：

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

`druid.sql.planner.useApproximateCountDistinct=false`

创建 Looker 与数据库的连接

在 Looker 的管理 部分中，选择连接 ，然后点击添加连接 。

填写连接详情。大多数设置对于大多数数据库方言都是通用的。如需了解相关信息，请参阅将 Looker 连接到数据库文档页面。下面介绍了一些设置：

  • 名称：连接的名称。

  • 方言：Apache Druid、Apache Druid 0.13+（Apache Druid 0.13.x - 0.17.x）或Apache Druid 0.18+。

  • 主机：集群代理的 DNS 或 IP 地址。您可以在 broker/runtime.properties 文件中找到此信息。

  • 端口：代理的端口。默认端口为 8082。如果您的集群受 SSL 保护，则默认端口为 8182。

  • 数据库：数据库的名称。默认值为 druid。

  • 用户名：数据库用户名（如果您的 Apache Druid 集群配置为使用 Druid 基本安全性）。如果未配置，您可以指定任何字符串。

  • 密码：用户密码。如果您的集群未配置为使用 Druid 基本安全性，您可以指定任何字符串。

  • 架构：未指定架构时要使用的默认架构。您可以选择是否输入架构。

  • 其他 JDBC 参数：以分号分隔的 Avatica JDBC 参数。如需查看 Looker 支持的参数列表，请参阅本页面的支持的 JDBC 参数部分。

    • 您可以将这些属性设置为连接属性：
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    示例： none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • 维护时间表：一个 cron 表达式，用于指示 Looker 何时应检查 数据组 和永久性派生表。如需详细了解此设置，请参阅维护时间表文档。

  • SSL：检查您的 Apache Druid 集群是否配置为使用 Druid TLS。

  • 验证 SSL：选中此选项可强制执行严格的主机名验证。

  • 每个节点的最大连接数：默认值为 25。此设置最初可以保留默认值。如需了解详情，请参阅将 Looker 连接到数据库文档页面。

  • 连接池超时时间：默认值为 120 秒。

  • SQL Runner 预缓存：如需让 SQL Runner 不预加载表信息，并且仅在选择表时加载表信息，请清除此选项。如需详细了解此设置，请参阅 SQL Runner 预缓存 文档。

  • 数据库时区：数据库时区。Apache Druid 0.13+ 和 Apache Druid 0.18+ 支持此设置。

如需验证连接是否成功，请点击测试 。如需了解问题排查信息，请参阅测试数据库连接文档页面。

Looker 会运行 SELECT 1 查询来验证基本连接并执行查询测试。它不会验证目录和架构组合是否存在，也不会验证用户是否拥有对该架构的必要访问权限。

如果您遇到任何问题，请查看我们的测试连接文档。

如需保存这些设置，请点击连接 。

在 SQL Runner 中测试连接。前往 SQL Runner，选择您的连接和架构，然后 检查是否可以看到数据库表。

支持的 JDBC 参数

对于 Apache Druid，Looker 支持在连接的 其他 JDBC 参数 字段中使用以下 JDBC 参数。如需了解这些参数的信息，请参阅数据库的相关文档。

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

功能支持

如需让 Looker 支持某些功能，您的数据库方言也必须支持这些功能。

Apache Druid

截至 Looker 26.8，Apache Druid 支持以下功能：

功能 是否支持？
Looker (Google Cloud Core)
对称聚合
派生表
基于 SQL 的永久性派生表
原生永久性派生表
稳定视图
终止查询
基于 SQL 的数据透视
时区
SSL
小计
其他 JDBC 参数
区分大小写
位置类型
名单类型
百分位
不同值百分位
SQL Runner “Show Processes”
SQL Runner “Describe Table”
SQL Runner “Show Indexes”
SQL Runner “Select 10”
SQL Runner “Count”
SQL “Explain”
OAuth 2.0 凭证
上下文注释
连接池
HLL 草图
汇总感知
增量 PDT
毫秒
微秒
具体化视图
与前一时间段相比的指标
近似计数不同
自定义日历

Apache Druid 0.13.x - 0.17.x

截至 Looker 26.8，Apache Druid 0.13.x - 0.17.x 支持以下功能：

功能 是否支持？
Looker (Google Cloud Core)
对称聚合
派生表
基于 SQL 的永久性派生表
原生永久性派生表
稳定视图
终止查询
基于 SQL 的数据透视
时区
SSL
小计
其他 JDBC 参数
区分大小写
位置类型
名单类型
百分位
不同值百分位
SQL Runner “Show Processes”
SQL Runner “Describe Table”
SQL Runner “Show Indexes”
SQL Runner “Select 10”
SQL Runner “Count”
SQL “Explain”
OAuth 2.0 凭证
上下文注释
连接池
HLL 草图
汇总感知
增量 PDT
毫秒
微秒
具体化视图
与前一时间段相比的指标
近似计数不同
自定义日历

Apache Druid 0.18+

截至 Looker 26.8，Apache Druid 0.18+ 支持以下功能：

功能 是否支持？
Looker (Google Cloud Core)
对称聚合
派生表
基于 SQL 的永久性派生表
原生永久性派生表
稳定视图
终止查询
基于 SQL 的数据透视
时区
SSL
小计
其他 JDBC 参数
区分大小写
位置类型
名单类型
百分位
不同值百分位
SQL Runner “Show Processes”
SQL Runner “Describe Table”
SQL Runner “Show Indexes”
SQL Runner “Select 10”
SQL Runner “Count”
SQL “Explain”
OAuth 2.0 凭证
上下文注释
连接池
HLL 草图
汇总感知
增量 PDT
毫秒
微秒
具体化视图
与前一时间段相比的指标
近似计数不同
自定义日历

后续步骤

完成数据库连接后，配置身份验证选项。