Kyuubi 迁移指南

从 Kyuubi 1.8 升级到 1.9

• 自 Kyuubi 1.9.0 起，kyuubi.session.conf.advisor 可以设置为序列，Kyuubi 支持链式的 SessionConfAdvisor。
• 自 Kyuubi 1.9.0 起，Kyuubi metastore 移除了对 Derby 的支持。
• 自 Kyuubi 1.9.0 起，Spark SQL 引擎对 Spark 3.1 的支持已废弃，并将在未来移除。
• 自 Kyuubi 1.9.0 起，Spark 扩展对 Spark 3.1 的支持已移除，请使用 Spark 3.2 或更高版本。
• 自 Kyuubi 1.9.0 起，kyuubi.frontend.login.timeout、kyuubi.frontend.thrift.login.timeout、kyuubi.frontend.backoff.slot.length、kyuubi.frontend.thrift.backoff.slot.length 已被移除。
• 自 Kyuubi 1.9.0 起，Flink 引擎对 Flink 1.16 的支持已废弃，并将在未来移除。

从 Kyuubi 1.8.0 升级到 1.8.1

• 自 Kyuubi 1.8.1 起，对于 DELETE /batches/${batchId}，请求参数中不再需要 hive.server2.proxy.user。
• 自 Kyuubi 1.8.1 起，Metadata store 的默认 SQLite 文件 kyuubi_state_store.db 位于 $KYUUBI_HOME 下，而不再位于 $PWD。如需恢复之前的行为，请将 kyuubi.metadata.store.jdbc.url 设置为 jdbc:sqlite:kyuubi_state_store.db。

从 Kyuubi 1.7 升级到 1.8

• 自 Kyuubi 1.8 起，新增了 SQLite，并成为 Kyuubi metastore 的默认数据库类型，而 Derby 已被废弃。Derby 和 SQLite 主要用于测试目的，不建议在生产环境中使用。如需恢复之前的行为，请设置 kyuubi.metadata.store.jdbc.database.type=DERBY 和 kyuubi.metadata.store.jdbc.url=jdbc:derby:memory:kyuubi_state_store_db;create=true。
• 自 Kyuubi 1.8 起，如果嵌入式 zookeeper 配置的目录（kyuubi.zookeeper.embedded.directory 与 kyuubi.zookeeper.embedded.data.dir 与 kyuubi.zookeeper.embedded.data.log.dir）是相对路径，则该路径将相对于 $KYUUBI_HOME 解析，而不再相对于 $PWD。
• 自 Kyuubi 1.8 起，PROMETHEUS 成为默认的 metrics reporter。如需恢复之前的行为，请设置 kyuubi.metrics.reporters=JSON。

从 Kyuubi 1.7.1 升级到 1.7.2

• 自 Kyuubi 1.7.2 起，对于 Kyuubi BeeLine，请使用 --python-mode 选项来运行 python 代码或脚本。

从 Kyuubi 1.7.0 升级到 1.7.1

• 自 Kyuubi 1.7.1 起，REST API Open(create) a session 的请求参数中移除了 protocolVersion。所有被移除或未知的参数都会被静默忽略，不会产生任何影响。
• 自 Kyuubi 1.7.1 起，REST API Create an operation with EXECUTE_STATEMENT type 的请求参数中支持了 confOverlay。

从 Kyuubi 1.6 升级到 1.7

• 在 Kyuubi 1.7 中，kyuubi.ha.zookeeper.engine.auth.type 不会回退到 kyuubi.ha.zookeeper.auth.type。
  当 Kyuubi 引擎与 ZooKeeper 进行 Kerberos 认证时，用户需要显式地将 kyuubi.ha.zookeeper.engine.auth.type 设置为 KERBEROS。
• 从 Kyuubi 1.7 起，Kyuubi 对 GetInfo 请求返回的是引擎信息，而非服务器信息。若要恢复之前的行为，请将 kyuubi.server.info.provider 设置为 SERVER。
• 从 Kyuubi 1.7 起，Kyuubi 会话类型 SQL 被重构为 INTERACTIVE，因为 Kyuubi 不仅支持 SQL 会话，还支持 SCOLA 和 PYTHON 会话。用户需要使用 INTERACTIVE sessionType 来查找会话事件。
• 从 Kyuubi 1.7 起，Open(create) a session 的 REST API 不再包含 user、password 和 IpAddr 参数。如有需要，用户和密码应设置在 HTTP 请求的 Authorization 中。

从 Kyuubi 1.6.0 升级到 1.6.1

• 从 Kyuubi 1.6.1 起，kyuubi.ha.zookeeper.engine.auth.type 不会回退到 kyuubi.ha.zookeeper.auth.type。
  当 Kyuubi 引擎与 ZooKeeper 进行 Kerberos 认证时，用户需要显式地将 kyuubi.ha.zookeeper.engine.auth.type 设置为 KERBEROS。

从 Kyuubi 1.5 升级到 1.6

• Kyuubi 引擎通过 kyuubi.ha.zookeeper.auth.principal 和 kyuubi.ha.zookeeper.auth.keytab 获取 ZooKeeper 的 principal 与 keytab。
  kyuubi.ha.zookeeper.auth.principal 和 kyuubi.ha.zookeeper.auth.keytab 在未设置时会回退到 kyuubi.kinit.principal 和 kyuubi.kinit.keytab。
  从 Kyuubi 1.6 起，出于更好的安全性考虑，kyuubi.kinit.principal 和 kyuubi.kinit.keytab 会被从 Kyuubi 引擎的配置中过滤掉。
  当 Kyuubi 引擎与 ZooKeeper 进行 Kerberos 认证时，用户需要显式地设置 kyuubi.ha.zookeeper.auth.principal 和 kyuubi.ha.zookeeper.auth.keytab。