更新时间:2026-10-16 GMT+08:00
分享

Python UDF

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

python_udf_spec_options

参数说明:配置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

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

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

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

默认值:off。

enable_udf_scheduler

参数说明:启用全局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

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

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

默认值:on。

相关文档