百科 / 错误代码 / Class 22 数据异常
22014 invalid_argument_for_ntile_function
ERROR 源码确认 参考 未实测
- 条件名
invalid_argument_for_ntile_function- 宏名称
ERRCODE_INVALID_ARGUMENT_FOR_NTILE- 启用版本
- 8.4
- 状态
- 活跃
版本覆盖
速览
ntile 收到非正的桶数量。固定窗口函数路径以 SQLSTATE 22014 报告 argument of ntile must be greater than zero。
含义
当 context->ntile 仍为零、尚未成功初始化时，window_ntile 才会计算桶参数。参数为 NULL 时先返回 NULL，也不会设置这个状态，因此后续行可能再次计算参数；小于等于零时抛出 22014，正数则初始化状态并在后续行复用。空输入没有可供窗口函数计算的行，不属于这个错误。
诊断
检查受影响分区中 ntile 参数的解析值，区分三种情况：正数、NULL 和非正数。对实际求值的行，NULL 参数会给出 NULL；空分区则完全没有结果。二者都不应归为非正参数错误。
处理
检查提供参数的表达式后传入正整数桶数量。只有桶策略本来就允许时，才使用 COALESCE 或其他回退值。固定 guard 抛出 ERROR；显式事务需先回滚或回到已有保存点再重试，自动提交只重试修正后的语句。
报文
- Primary，
ERROR：argument of ntile must be greater than zero。 - 固定 guard 没有附加 DETAIL 或 HINT。
报文模板
源码里的格式串，不是某一次运行的输出。%s 之类是占位符，实际报文会填入对象名与取值。适用范围一栏是核验时留下的原始英文记录，未经翻译。
argument of ntile must be greater than zero
版本
锁定目录从 8.4.0 起记录该条件；固定源码覆盖 PostgreSQL 18.6。引用的是窗口函数实现，不是一般参数校验器。
来源
- 上游源码 src/backend/utils/errcodes.txt 第 184 行
- 上游源码 src/backend/utils/adt/windowfuncs.c
证据
断言
每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。
-
22014 is invalid_argument_for_ntile_function in SQLSTATE Class 22.
-
When ntile state is still uninitialized, the function evaluates the bucket argument; NULL returns before initialization, non-positive raises 22014, and a positive count initializes and is reused for later rows.
-
The locked catalogue records 22014 from 8.4.0 without proving an exact implementation introduction date.
同类错误代码
Class 22 数据异常 下的其他成员。
22000data_exception22001string_data_right_truncation22002null_value_no_indicator_parameter22003numeric_value_out_of_range22004null_value_not_allowed22005error_in_assignment22007invalid_datetime_format22008datetime_field_overflow22009invalid_time_zone_displacement_value2200Bescape_character_conflict2200Cinvalid_use_of_escape_character2200Dinvalid_escape_octet2200Fzero_length_character_string2200Gmost_specific_type_mismatch2200Hsequence_generator_limit_exceeded2200Lnot_an_xml_document2200Minvalid_xml_document2200Ninvalid_xml_content2200Sinvalid_xml_comment2200Tinvalid_xml_processing_instruction22010invalid_indicator_parameter_value22011substring_error22012division_by_zero22013invalid_preceding_or_following_size22015interval_field_overflow22016invalid_argument_for_nth_value_function22018invalid_character_value_for_cast22019invalid_escape_character2201Binvalid_regular_expression2201Einvalid_argument_for_logarithm2201Finvalid_argument_for_power_function2201Ginvalid_argument_for_width_bucket_function2201Winvalid_row_count_in_limit_clause2201Xinvalid_row_count_in_result_offset_clause22021character_not_in_repertoire22022indicator_overflow22023invalid_parameter_value22024unterminated_c_string22025invalid_escape_sequence22026string_data_length_mismatch22027trim_error2202Earray_subscript_error2202Ginvalid_tablesample_repeat2202Hinvalid_tablesample_argument22030duplicate_json_object_key_value22031invalid_argument_for_sql_json_datetime_function22032invalid_json_text22033invalid_sql_json_subscript22034more_than_one_sql_json_item22035no_sql_json_item22036non_numeric_sql_json_item22037non_unique_keys_in_a_json_object22038singleton_sql_json_item_required22039sql_json_array_not_found2203Asql_json_member_not_found2203Bsql_json_number_not_found2203Csql_json_object_not_found2203Dtoo_many_json_array_elements2203Etoo_many_json_object_members2203Fsql_json_scalar_required2203Gsql_json_item_cannot_be_cast_to_target_type22P01floating_point_exception22P02invalid_text_representation22P03invalid_binary_representation22P04bad_copy_file_format22P05untranslatable_character22P06nonstandard_use_of_escape_character