阿帕奇·德鲁伊

加密网络流量

最佳实践是对 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 连接到您的数据库文档页面。下面将介绍其中一些设置:

  • 名称:连接的名称。
  • DialectApache DruidApache Druid 0.13+Apache Druid 0.18+

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

  • 端口Broker 的端口。默认端口为 8082。如果您的集群受 SSL 保护,则默认端口为 8182。

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

  • 用户名:数据库用户名(如果您的 Apache Druid 集群配置为使用 Druid Basic Security)。如果不相同,则可以指定任何字符串。

  • 密码:用户密码。如果您的集群未配置为使用 Druid Basic Security,则您可以指定任何字符串。

  • 架构:未指定架构时要使用的默认架构。架构输入为可选项。

  • 其他 JDBC 参数:以英文分号分隔的 Avatica JDBC 参数

    • 以下属性可设置为连接属性:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

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

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

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

  • Verify SSL(验证 SSL):选中后可强制执行严格的主机名验证。

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

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

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

  • Database Time Zone:数据库时区。在 Apache Druid 0.13 及更高版本和 Apache Druid 0.18 及更高版本中受支持。

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

Looker 会运行 SELECT 1 查询来验证基本连接并执行查询测试。它不会验证目录和架构组合是否存在,或者用户是否具有访问该架构所需的访问权限。

如果您有任何问题,请参阅我们的测试连接文档。

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

在 SQL Runner 中测试连接。转到 SQL Runner,选择您的连接和架构,然后检查您是否能看到数据库表

功能支持

为了让 Looker 支持某些功能,您的数据库方言也必须支持这些功能。

阿帕奇·德鲁伊

从 Looker 24.6 开始,Apache Druid 支持以下功能:

特征 是否支持?
支持级别
受支持
Looker (Google Cloud Core)
对称聚合
派生表
永久性 SQL 派生表
永久性原生派生表
稳定版视图
查询终止
基于 SQL 的数据透视
时区
SSL
小计
JDBC 其他参数
区分大小写
位置类型
列表类型
百分位
非重复百分位
SQL Runner 显示进程
SQL Runner 描述表
SQL Runner 显示索引
SQL Runner 优选 10
SQL 运行程序数量
SQL 说明
OAuth 凭据
上下文注释
连接池
HLL 素描
总体认知度
递增 PDT
毫秒
微秒
具体化视图
近似计数不重复

Apache Druid 0.13 及更高版本

从 Looker 24.6 开始,Apache Druid 0.13 及更高版本支持以下功能:

特征 是否支持?
支持级别
受支持
Looker (Google Cloud Core)
对称聚合
派生表
永久性 SQL 派生表
永久性原生派生表
稳定版视图
查询终止
基于 SQL 的数据透视
时区
SSL
小计
JDBC 其他参数
区分大小写
位置类型
列表类型
百分位
非重复百分位
SQL Runner 显示进程
SQL Runner 描述表
SQL Runner 显示索引
SQL Runner 优选 10
SQL 运行程序数量
SQL 说明
OAuth 凭据
上下文注释
连接池
HLL 素描
总体认知度
递增 PDT
毫秒
微秒
具体化视图
近似计数不重复

Apache Druid 0.18 及更高版本

从 Looker 24.6 开始,Apache Druid 0.18 及更高版本支持以下功能:

特征 是否支持?
支持级别
受支持
Looker (Google Cloud Core)
对称聚合
派生表
永久性 SQL 派生表
永久性原生派生表
稳定版视图
查询终止
基于 SQL 的数据透视
时区
SSL
小计
JDBC 其他参数
区分大小写
位置类型
列表类型
百分位
非重复百分位
SQL Runner 显示进程
SQL Runner 描述表
SQL Runner 显示索引
SQL Runner 优选 10
SQL 运行程序数量
SQL 说明
OAuth 凭据
上下文注释
连接池
HLL 素描
总体认知度
递增 PDT
毫秒
微秒
具体化视图
近似计数不重复

后续步骤

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