DBeaver

什么是 DBeaver

DBeaver 是一款免费的跨平台数据库工具，面向开发者、数据库管理员、分析师以及所有需要与数据库打交道的人员。它支持所有主流数据库，也支持 kyuubi JDBC。

另请参阅

DBeaver Wiki

安装

请前往 Download DBeaver 页面，下载并安装适合您的发行版本。

22.1.0 版本（dbeaver）新增：自 2022 年 6 月 6 日起，DBeaver 通过 PR 16567 正式支持 apache kyuubi JDBC 驱动。

在 Kyuubi 中使用 DBeaver

如果您已成功安装 dbeaver，只需点击按钮即可启动它。

新建连接

首先，我们需要针对一个正在运行的 kyuubi 服务器创建数据库连接。从 dbeaver 22.1.0 开始，您就可以找到 kyuubi jdbc 驱动，如下图所示。

注意

我们也可以选择 Apache Hive 或 Apache Spark 来为 Kyuubi 配置驱动，因为它们与 Kyuubi 使用相同的客户端协议，彼此兼容。

配置连接

其次，我们配置 JDBC 连接设置，以生成底层的 kyuubi JDBC 连接 URL 字符串。

基本连接设置

基本连接设置包含与 kyuubi 服务器通信所需的最小配置项：

• 主机 - kyuubi 服务器绑定的主机名或 IP 地址，默认：localhost。
• 端口 - kyuubi 服务器监听的端口，默认：10009。
• 数据库/模式 - 要使用的数据库或模式，默认：default。
• 身份认证 - 基于服务器认证机制的身份信息，例如用户名/密码。

会话配置

会话配置列表是 kyuubi JDBC URL 的可选部分，它对于在会话级别覆盖 kyuubi 服务器的某些配置非常有用。dbeaver 的设置页面并没有提供用于此用途的文本框。不过，我们可以将以井号（#）开头、以分号分隔的配置键值对追加到「数据库/模式」字段中。虽然看起来有点奇怪，但确实有效。

以图中所示为例，引擎为 kyuubi 引擎的驱动进程分配 2 GB 内存，并在空闲 30 秒后将其终止。

以 HA 模式连接

Kyuubi 通过基于 Apache Zookeeper 集群的服务发现来支持高可用（HA）。

如上图所示，Host 和 Port 字段可用于拼接以逗号分隔的 ZooKeeper 对等节点，而 serviceDiscoveryMode 和 zooKeeperNamespace 则追加到 Database/Schema 字段中。

测试连接

虽然不是必须的，但建议点击「测试连接（Test Connection）」来验证连接配置是否正确。如果客户端或服务端出现问题，我们可以根据错误信息提前进行排查。

SQL 操作

现在，我们可以使用 SQL 编辑器编写查询，通过该连接与 Kyuubi 服务端进行交互。

DESC NAMESPACE DEFAULT;

CREATE TABLE spark_catalog.`default`.SRC(KEY INT, VALUE STRING) USING PARQUET;
INSERT INTO TABLE spark_catalog.`default`.SRC VALUES (11215016, 'Kent Yao');

SELECT KEY % 10 AS ID, SUBSTRING(VALUE, 1, 4) AS NAME FROM spark_catalog.`default`.SRC;

DROP TABLE spark_catalog.`default`.SRC;

客户端认证

有关启用了 Kerberos 的 Kyuubi 集群，请参阅 Kerberos 认证 了解更多信息。