openeuler/kyuubi

Kyuubi | openEuler 镜像文档

镜像概述和主要用途

该镜像为官方Kyuubi Docker镜像，基于openEuler构建，由openEuler CloudNative SIG维护。Apache Kyuubi是一个分布式多租户网关，为数据仓库和数据湖提供无服务器SQL服务，支持大规模数据查询与分析。

获取帮助：openEuler CloudNative SIG、openEuler社区

核心功能和特性

• 分布式多租户架构：支持多用户隔离与资源管理
• 无服务器SQL：降低数据查询的运维复杂度
• 自动引擎管理：引擎自动启动、复用与隔离，提升资源利用率
• 跨平台支持：基于openEuler，支持amd64和arm64架构
• 免费无限制：无用户速率限制，可自由使用

支持的标签及Dockerfile链接

镜像标签由Kyuubi版本和基础镜像版本组成，详情如下：

使用场景和适用范围

• 数据仓库与数据湖的SQL查询服务
• 多租户环境下的数据分析与资源隔离
• 需要弹性扩展的无服务器数据处理场景
• 大规模数据集的交互式查询与分析

使用方法和配置说明

拉取镜像

根据需求选择对应{Tag}拉取镜像：

bash
docker pull openeuler/kyuubi:{Tag}

后台运行容器

启动容器并映射端口（默认JDBC端口***）：

bash
docker run -d -p 10009:10009 --name kyuubi openeuler/kyuubi:{Tag}

• 容器成功运行后，服务器PID存储于pid/kyuubi-<username>-org.apache.kyuubi.server.KyuubiServer.pid
• JDBC连接URL可在日志文件logs/kyuubi-<username>-org.apache.kyuubi.server.KyuubiServer-<hostname>.out中获取

进入容器

进入容器查看日志：

bash
docker exec -it kyuubi bash

日志中JDBC连接URL示例：

Starting and exposing JDBC connection at: jdbc:kyuubi://localhost:10009/

建立连接

使用kyuubi-beeline工具连接Kyuubi服务（替换实际主机和端口）：

bash
bin/kyuubi-beeline -u 'jdbc:kyuubi://localhost:10009/' -n apache

上述命令以用户apache身份建立会话

执行SQL语句

连接成功后，在kyuubi-beeline控制台执行SQL：

sql
> SHOW DATABASES;

执行结果示例：

omitted logs
+------------+
| namespace  |
+------------+
| default    |
+------------+
1 row selected (0.2 seconds)

引擎启动与复用

• 引擎由服务器自动启动，用户无需干预
• 同一用户再次连接时复用已有引擎（连接耗时更短）
• 不同用户连接时启动新引擎（实现租户隔离）

示例（新用户连接）：

bash
bin/kyuubi-beeline -u 'jdbc:kyuubi://localhost:10009/' -n kentyao

关闭连接

在kyuubi-beeline控制台执行!quit关闭会话：

> !quit
Closing: 0: jdbc:kyuubi://localhost:10009/

停止Kyuubi服务

在容器内$KYUUBI_HOME目录执行：

bash
bin/kyuubi stop

问题与反馈

如遇问题或需使用特殊功能，请在openeuler-docker-images提交issue或PR。