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 及更高版本。

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

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

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

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

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

• 架构：未指定架构时要使用的默认架构。输入架构是可选操作。

• 其他 JDBC 参数：以半角分号分隔的 Avatica 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，选择您的连接和架构，然后检查是否能看到数据库表。

功能支持

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

Apache Druid

自 Looker 25.12 起，Apache Druid 支持以下功能：

Apache Druid 0.13 及更高版本 (Apache Druid 0.13.x - 0.17.x)

自 Looker 25.12 起，Apache Druid 0.13 及更高版本支持以下功能：

Apache Druid 0.18 及更高版本

自 Looker 25.12 起，Apache Druid 0.18 及更高版本支持以下功能：

后续步骤

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