更新时间:2026-11-05 GMT+08:00
分享

Python UDF

与Python UDF相关的GUC参数介绍。

参数说明

表1 Python UDF相关参数说明

参数

参数类型

说明

python_udf_spec_options

String

参数解释:配置python UDF执行时WITH ARGUMENTS中常用参数的默认值。当WITH ARGUMENTS未指定相应参数时,会默认使用python_udf_spec_options设置的GUC值。WITH ARGUMENTS中显式指定的参数优先级高于GUC值。

  • set python_udf_spec_options = '(key1:value1),(key2:value2)',表示在保留已有设置的基础上,追加或更新指定key的值。若某个key已存在则覆盖其值,不存在则新增。
  • set python_udf_spec_options = '' 或reset python_udf_spec_options,表示清除所有已有设置。

取值范围:字符串,格式为逗号分隔的(key:value)对形式。目前支持6个参数设置timeout、cpu、memory、arch、apu、concurrency。详细介绍,请参考WITH ARGUMENTS语法。

默认值:空('')。

enable_udf_global_actor_pool

Boolean

参数解释:启用全局Python UDF Actor池。启用后,Python UDF Actor由全局CN统一管理,而非各执行DN独立管理。

需先开启udf_split(设置sql_opt_options='on(udf_split)'),否则该参数不生效。

取值范围:布尔值(on/off)。

默认值:off

enable_udf_scheduler

Boolean

参数解释:启用全局Python UDF动态调度策略。启用后,系统会根据语句中不同的Python UDF的运行时间,动态进行Python UDF actor的调度,减少单点UDF执行瓶颈。

需先开启udf_split(设置sql_opt_options='on(udf_split)')和enable_udf_global_actor_pool,且语句中不能包含Join等多分支操作,否则该参数不生效。

取值范围:布尔值(on/off)。

默认值:off

enable_udf_log_trace

Boolean

参数解释:启用Python UDF日志可追溯功能。启用后,系统自动为UDF执行期间的所有日志输出(print、logging、loguru、warnings)注入SESSIONID/STATEMENTID标签。

取值范围:布尔值(on/off)。

默认值:on

相关文档