Apache Kyuubi 增强 beeline 工具支持 --conf 参数配置

背景介绍

Apache Kyuubi 是一个开源的分布式 SQL 引擎，提供了 JDBC 接口和命令行工具 kyuubi-beeline 来与 Kyuubi 服务进行交互。kyuubi-beeline 是基于 Apache Hive 的 beeline 工具开发的，继承了其大部分功能和参数选项。

当前问题

在现有版本中，kyuubi-beeline 主要通过 --hiveconf 和 --hivevar 参数来传递配置项。例如：

kyuubi-beeline -u 'jdbc:kyuubi://kyuubi:10009/' \
    --hiveconf kyuubi.operation.result.format=arrow \
    --hiveconf kyuubi.operation.incremental.collect=true \
    --hivevar spark.app.name=xxx \
    large_result_query.sql

这种方式虽然可行，但对于熟悉 Spark 生态的用户来说不够直观。在 Spark 生态中，配置参数通常使用 --conf 选项传递，例如：

spark-submit \
    --conf spark.app.name=xxx \
    --conf spark.driver.memory=1g
    ...

解决方案

为了提升用户体验和保持与 Spark 生态的一致性，Kyuubi 社区决定为 kyuubi-beeline 工具增加 --conf 参数支持。这个新参数将作为 --hiveconf 的别名，功能完全一致。

新的使用方式如下：

kyuubi-beeline -u 'jdbc:kyuubi://kyuubi:10009/' \
    --conf kyuubi.operation.result.format=arrow \
    --conf kyuubi.operation.incremental.collect=true \
    --conf spark.app.name=xxx \
    large_result_query.sql

实现细节

这个改进的实现相对简单，主要是在命令行参数解析部分增加 --conf 作为 --hiveconf 的别名。两者将共享相同的参数处理逻辑，确保行为完全一致。

兼容性考虑

为了保持向后兼容性，原有的 --hiveconf 和 --hivevar 参数仍然会被支持。新增加的 --conf 参数只是提供了另一种更符合 Spark 用户习惯的配置方式。

用户价值

1. 降低学习成本：Spark 用户可以沿用熟悉的 --conf 参数语法，无需额外学习 --hiveconf 的使用方式
2. 提升一致性：使 Kyuubi 的命令行工具与 Spark 生态保持一致的配置风格
3. 增强可用性：为用户提供更多选择，可以根据个人偏好选择配置方式

总结

这个改进虽然看似简单，但体现了 Kyuubi 项目对用户体验的重视。通过保持与 Spark 生态的一致性，降低了用户的学习成本和使用门槛，有助于 Kyuubi 在 Spark 生态中的进一步推广和应用。