配置 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 连接到数据库文档页面。下面将介绍部分设置:
- 名称:连接的名称。
- Dialect:Apache Druid、Apache Druid 0.13+ 或 Apache Druid 0.18+。
- 主机:集群 Broker 的 DNS 或 IP 地址。您可以在
broker/runtime.properties
文件中找到此信息。 - Port(端口):Broker 的端口。默认端口为 8082。如果您的集群受 SSL 保护,则默认端口为 8182。
- 数据库:您的数据库的名称。默认值为
druid
。 - 用户名:如果 Apache Druid 集群配置为使用 Druid Basic Security,则指数据库用户名。如果不是,您可以指定任何字符串。
- 密码:用户密码。如果您的集群未配置为使用 Druid 基本安全,您可以指定任意字符串。
- 架构:未指定架构时使用的默认架构。输入架构是可选的。
更多 JDBC 参数:以英文分号分隔的 Avatica JDBC 参数。
- 这些属性可以设置为连接属性:
useApproximateCountDistinct
useApproximateTopN
useFallback
sqlTimeZone
例如:
useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit
- 这些属性可以设置为连接属性:
数据组和 PDT 维护时间表:一个
cron
表达式,用于指示 Looker 何时应检查数据组和永久性派生表。如需详细了解此设置,请参阅 Datagroup 和 PDT 维护时间表文档。SSL:检查您的 Apache Druid 集群是否配置为使用 Druid TLS。
验证 SSL:选中此项可强制执行严格的主机名验证。
每个节点的连接数上限:默认值为 25。此设置最初可以保留默认值。如需了解详情,请参阅将 Looker 连接到数据库文档页面。
连接池超时:默认值为 120 秒。
SQL Runner 预缓存:若要防止 SQL Runner 预加载表信息以及仅在用户选择表时加载表信息,请取消选中此选项。如需详细了解此设置,请参阅 SQL 运行程序预缓存文档。
数据库时区:数据库时区。Apache Druid 0.13 及更高版本和 Apache Druid 0.18 及更高版本支持。
如需验证连接是否成功,请点击测试。如需了解问题排查信息,请参阅测试数据库连接文档页面。
Looker 运行 SELECT 1
查询来验证基本连接并执行查询测试。它不会验证清单和架构的组合是否存在,或者用户是否拥有对相应架构的必要访问权限。
如果您有任何疑问,请参阅我们的测试连接文档。
要保存这些设置,请点击连接。
在 SQL Runner 中测试连接。前往 SQL 运行程序,选择您的连接和架构,然后检查您是否可以看到数据库表。
功能支持
为了让 Looker 支持某些功能,您的数据库方言也必须支持这些功能。
Apache Druid
从 Looker 23.8 开始,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 23.8 开始,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 23.8 开始,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 增幅 | 否 |
毫秒 | 是 |
微秒 | 否 |
具体化视图 | 否 |
唯一计数 | 否 |
后续步骤
完成数据库连接后,配置身份验证选项。