SQLSTATE 错误代码
适用于: Databricks SQL Databricks Runtime 12.2 及更高版本
Azure Databricks 返回的所有错误类都与一个 5 字符 SQLSTATE
相关联。
SQLSTATE
是 JDBC
、ODBC
和其他客户端 API 常用的错误条件的 SQL 标准编码。
SQLSTATE
由两个部分组成:双字符类和三字符子类。
每个字符必须是数字 '0'
到 '9'
,或字母 'A'
到 'Z'
。
虽然许多 SQLSTATE
值是由 SQL 标准规定的,但有些值在行业中很常用且特定于 Spark 或 Azure Databricks。
如有必要,Spark 和 Azure Databricks 会将 'KD'
类和 'K**'
子类范围用于自定义 SQLSTATE。
类 'XX'
用于可保证 bug 报告的内部错误。
有关错误类的已排序列表,请参阅:Azure Databricks 中的错误处理
Azure Databricks 使用以下 SQLSTATE
类:
类 07
:动态 SQL 错误
SQLSTATE | 描述和发出错误类 |
---|---|
07001 |
using 子句与动态参数规范不匹配 |
ALL_PARAMETERS_MUST_BE_NAMED, FUNCTION_PARAMETERS_MUST_BE_NAMED | |
07501 |
在 PREPARE 或 EXECUTE 上指定的选项无效。 |
INVALID_STATEMENT_FOR_EXECUTE_INTO、NESTED_EXECUTE_IMMEDIATE |
类 08
:连接异常
SQLSTATE | 描述和发出错误类 |
---|---|
08000 |
连接异常 |
AI_FUNCTION_HTTP_REQUEST_ERROR、AI_FUNCTION_INVALID_HTTP_RESPONSE、CANNOT_VALIDATE_CONNECTION | |
08001 |
SQL 客户端无法建立 SQL 连接 |
CANNOT_ESTABLISH_CONNECTION、CANNOT_ESTABLISH_CONNECTION_SERVERLESS | |
08003 |
连接不存在 |
DELTA_ACTIVE_SPARK_SESSION_NOT_FOUND | |
08KD1 |
服务器忙 |
SERVER_IS_BUSY |
类 0A
:功能不受支持
SQLSTATE | 描述和发出错误类 |
---|---|
0A000 |
功能不受支持 |
AI_FUNCTION_UNSUPPORTED_REQUEST, AI_FUNCTION_UNSUPPORTED_RETURN_TYPE, AVRO_DEFAULT_VALUES_UNSUPPORTED, AVRO_POSITIONAL_FIELD_MATCHING_UNSUPPORTED, CANNOT_INVOKE_IN_TRANSFORMATIONS, CANNOT_SAVE_VARIANT, CANNOT_UPDATE_FIELD, CF_ADD_NEW_NOT_SUPPORTED, CF_EVENT_NOTIFICATION_NOT_SUPPORTED, CF_PERIODIC_BACKFILL_NOT_SUPPORTED, CF_SOURCE_UNSUPPORTED, CF_STATEFUL_STREAMING_SCHEMA_EVOLUTION, CF_UNSUPPORTED_CLOUD_FILES_SQL_FUNCTION, CF_UNSUPPORTED_FORMAT_FOR_SCHEMA_INFERENCE, CF_UNSUPPORTED_LOG_VERSION, CF_UNSUPPORTED_SCHEMA_EVOLUTION_MODE, CLASS_UNSUPPORTED_BY_MAP_OBJECTS, CLEANROOM_COMMANDS_NOT_SUPPORTED, COLUMN_MASKS_CHECK_CONSTRAINT_UNSUPPORTED, COLUMN_MASKS_FEATURE_NOT_SUPPORTED, COLUMN_MASKS_INCOMPATIBLE_SCHEMA_CHANGE, COLUMN_MASKS_MERGE_UNSUPPORTED_SOURCE, COLUMN_MASKS_MERGE_UNSUPPORTED_TARGET, COLUMN_MASKS_REQUIRE_UNITY_CATALOG, COLUMN_MASKS_TABLE_CLONE_SOURCE_NOT_SUPPORTED, COLUMN_MASKS_TABLE_CLONE_TARGET_NOT_SUPPORTED, COLUMN_MASKS_UNSUPPORTED_PROVIDER, COLUMN_MASKS_UNSUPPORTED_SUBQUERY, CONCURRENT_QUERY, CONSTRAINTS_REQUIRE_UNITY_CATALOG, COPY_INTO_CREDENTIALS_NOT_ALLOWED_ON, COPY_INTO_ENCRYPTION_NOT_ALLOWED_ON, COPY_INTO_ENCRYPTION_NOT_SUPPORTED_FOR_AZURE, COPY_INTO_SOURCE_FILE_FORMAT_NOT_SUPPORTED, CREATE_OR_REFRESH_MV_ST_ASYNC, CREATE_PERMANENT_VIEW_WITHOUT_ALIAS, CSV_ENFORCE_SCHEMA_NOT_SUPPORTED, DC_FEATURE_NOT_ENABLED, DC_UNSUPPORTED_ERROR, DELTA_ADDING_DELETION_VECTORS_DISALLOWED, DELTA_ADD_CONSTRAINTS, DELTA_CANNOT_WRITE_INTO_VIEW, DELTA_CLUSTERING_CLONE_TABLE_NOT_SUPPORTED, DELTA_CLUSTERING_SHOW_CREATE_TABLE_WITHOUT_CLUSTERING_COLUMNS, DELTA_CLUSTERING_WITH_PARTITION_PREDICATE, DELTA_DOMAIN_METADATA_NOT_SUPPORTED, DELTA_DYNAMIC_PARTITION_OVERWRITE_DISABLED, DELTA_NESTED_SUBQUERY_NOT_SUPPORTED, DELTA_NOT_NULL_NESTED_FIELD, DELTA_OPERATION_ON_TEMP_VIEW_WITH_GENERATED_COLS_NOT_SUPPORTED, DELTA_SOURCE_IGNORE_DELETE, DELTA_SOURCE_TABLE_IGNORE_CHANGES, DELTA_UNSUPPORTED_DEEP_CLONE, DELTA_UNSUPPORTED_EXPRESSION, DELTA_UNSUPPORTED_FSCK_WITH_DELETION_VECTORS, DELTA_UNSUPPORTED_GENERATE_WITH_DELETION_VECTORS, DELTA_UNSUPPORTED_LIST_KEYS_WITH_PREFIX, DELTA_UNSUPPORTED_MERGE_SCHEMA_EVOLUTION_WITH_CDC, DELTA_UNSUPPORTED_SORT_ON_BUCKETED_TABLES, DELTA_UNSUPPORTED_TRUNCATE_SAMPLE_TABLES, DELTA_UNSUPPORTED_WRITE_SAMPLE_TABLES, DELTA_VIOLATE_TABLE_PROPERTY_VALIDATION_FAILED, DELTA_WRITE_INTO_VIEW_NOT_SUPPORTED, DISTINCT_WINDOW_FUNCTION_UNSUPPORTED, EXTERNAL_TABLE_INVALID_SCHEME, FABRIC_REFRESH_INVALID_SCOPE, FROM_JSON_INFERENCE_NOT_SUPPORTED, H3_NOT_ENABLED, INFINITE_STREAMING_TRIGGER_NOT_SUPPORTED, INVALID_PANDAS_UDF_PLACEMENT, MATERIALIZED_VIEW_OUTPUT_WITHOUT_EXPLICIT_ALIAS, MATERIALIZED_VIEW_UNSUPPORTED_OPERATION, MULTI_UDF_INTERFACE_ERROR, NAMED_PARAMETERS_NOT_SUPPORTED_FOR_SQL_UDFS, NAMED_PARAMETER_SUPPORT_DISABLED, NOT_SUPPORTED_CHANGE_COLUMN, NOT_SUPPORTED_COMMAND_FOR_V2_TABLE, NOT_SUPPORTED_COMMAND_WITHOUT_HIVE_SUPPORT, NOT_SUPPORTED_IN_JDBC_CATALOG, NOT_SUPPORTED_WITH_DB_SQL, PROTOBUF_JAVA_CLASSES_NOT_SUPPORTED, PS_SPARK_SPECULATION_NOT_SUPPORTED, PS_UNSUPPORTED_GET_OFFSET_CALL, RESTRICTED_STREAMING_OPTION_PERMISSION_ENFORCED, ROW_LEVEL_SECURITY_CHECK_CONSTRAINT_UNSUPPORTED, ROW_LEVEL_SECURITY_FEATURE_NOT_SUPPORTED, ROW_LEVEL_SECURITY_INCOMPATIBLE_SCHEMA_CHANGE, ROW_LEVEL_SECURITY_MERGE_UNSUPPORTED_SOURCE, ROW_LEVEL_SECURITY_MERGE_UNSUPPORTED_TARGET, ROW_LEVEL_SECURITY_REQUIRE_UNITY_CATALOG, ROW_LEVEL_SECURITY_TABLE_CLONE_SOURCE_NOT_SUPPORTED, ROW_LEVEL_SECURITY_TABLE_CLONE_TARGET_NOT_SUPPORTED, ROW_LEVEL_SECURITY_UNSUPPORTED_PROVIDER, SCALAR_SUBQUERY_IS_IN_GROUP_BY_OR_AGGREGATE_FUNCTION, STAR_GROUP_BY_POS, STORED_PROCEDURE_NOT_SUPPORTED, STREAMING_AQE_NOT_SUPPORTED_FOR_STATEFUL_OPERATORS, STREAMING_FROM_MATERIALIZED_VIEW, ST_NOT_ENABLED, ST_UNSUPPORTED_RETURN_TYPE, TABLE_VALUED_ARGUMENTS_NOT_YET_IMPLEMENTED_FOR_SQL_FUNCTIONS, UC_HIVE_METASTORE_FEDERATION_NOT_ENABLED, UDF_PYSPARK_UNSUPPORTED_TYPE, UDF_UNSUPPORTED_PARAMETER_DEFAULT_VALUE, UDTF_PYSPARK_NOT_SUPPORTED, UNSUPPORTED_ADD_FILE, UNSUPPORTED_ARROWTYPE, UNSUPPORTED_CHAR_OR_VARCHAR_AS_STRING, UNSUPPORTED_CLAUSE_FOR_OPERATION, UNSUPPORTED_CONSTRAINT_CLAUSES, UNSUPPORTED_DATASOURCE_FOR_DIRECT_QUERY, UNSUPPORTED_DATATYPE, UNSUPPORTED_DATA_SOURCE_SAVE_MODE, UNSUPPORTED_DATA_TYPE_FOR_DATASOURCE, UNSUPPORTED_DEFAULT_VALUE, UNSUPPORTED_DESERIALIZER, UNSUPPORTED_FEATURE, UNSUPPORTED_FN_TYPE, UNSUPPORTED_NESTED_ROW_OR_COLUMN_ACCESS_POLICY, UNSUPPORTED_SAVE_MODE, UNSUPPORTED_STREAMING_OPTIONS_FOR_VIEW, UNSUPPORTED_STREAMING_OPTIONS_PERMISSION_ENFORCED, UNSUPPORTED_STREAMING_SINK_PERMISSION_ENFORCED, UNSUPPORTED_STREAMING_SOURCE_PERMISSION_ENFORCED, UNSUPPORTED_STREAM_READ_LIMIT_FOR_KINESIS_SOURCE, UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY, UNSUPPORTED_TIMESERIES_WITH_MORE_THAN_ONE_COLUMN, UNSUPPORTED_TRIGGER_FOR_KINESIS_SOURCE, UNSUPPORTED_TYPED_LITERAL | |
0AKD0 |
不支持跨目录或架构操作 |
CANNOT_COPY_STATE, CANNOT_REFERENCE_UC_IN_HMS, CANNOT_RENAME_ACROSS_CATALOG, CANNOT_RENAME_ACROSS_SCHEMA, CANNOT_SHALLOW_CLONE_ACROSS_UC_AND_HMS | |
0AKD1 |
不支持安全功能 |
COLUMN_MASKS_UNSUPPORTED_CONSTANT_AS_PARAMETER、ROW_LEVEL_SECURITY_UNSUPPORTED_CONSTANT_AS_PARAMETER | |
0AKDC |
在 Delta 中不受支持 |
DELTA_CANNOT_EVALUATE_EXPRESSION、DELTA_CANNOT_GENERATE_CODE_FOR_EXPRESSION、DELTA_CDC_NOT_ALLOWED_IN_THIS_VERSION、DELTA_CHANGE_DATA_FEED_INCOMPATIBLE_DATA_SCHEMA、DELTA_CHANGE_DATA_FEED_INCOMPATIBLE_SCHEMA_CHANGE、DELTA_CLONE_UNSUPPORTED_SOURCE、DELTA_COLLATIONS_NOT_SUPPORTED、DELTA_COLUMN_DATA_SKIPPING_NOT_SUPPORTED_PARTITIONED_COLUMN、DELTA_COLUMN_DATA_SKIPPING_NOT_SUPPORTED_TYPE、DELTA_CONVERSION_UNSUPPORTED_COLUMN_MAPPING、DELTA_CONVERT_NON_PARQUET_TABLE、DELTA_CREATE_TABLE_IDENTIFIER_LOCATION_MISMATCH、DELTA_DROP_COLUMN_ON_SINGLE_FIELD_SCHEMA、DELTA_INCORRECT_LOG_STORE_IMPLEMENTATION、DELTA_MISSING_PROVIDER_FOR_CONVERT、DELTA_MODE_NOT_SUPPORTED、DELTA_NESTED_NOT_NULL_CONSTRAINT、DELTA_NON_DETERMINISTIC_FUNCTION_NOT_SUPPORTED、DELTA_OPERATION_NOT_ALLOWED、DELTA_OPERATION_NOT_ALLOWED_DETAIL、DELTA_OPERATION_NOT_SUPPORTED_FOR_COLUMN_WITH_COLLATION、DELTA_OPERATION_NOT_SUPPORTED_FOR_EXPRESSION_WITH_COLLATION、DELTA_OPERATION_ON_VIEW_NOT_ALLOWED、DELTA_TABLE_FOR_PATH_UNSUPPORTED_HADOOP_CONF、DELTA_TRUNCATE_TABLE_PARTITION_NOT_SUPPORTED、DELTA_UNIFORM_INGRESS_NOT_SUPPORTED_FORMAT、DELTA_UNIFORM_NOT_SUPPORTED、DELTA_UNSUPPORTED_ABS_PATH_ADD_FILE、DELTA_UNSUPPORTED_ALTER_TABLE_CHANGE_COL_OP、DELTA_UNSUPPORTED_ALTER_TABLE_REPLACE_COL_OP、DELTA_UNSUPPORTED_CLONE_REPLACE_SAME_TABLE、DELTA_UNSUPPORTED_COLUMN_MAPPING_MODE_CHANGE、DELTA_UNSUPPORTED_COLUMN_MAPPING_SCHEMA_CHANGE、DELTA_UNSUPPORTED_COLUMN_MAPPING_WRITE、 DELTA_UNSUPPORTED_COLUMN_TYPE_IN_BLOOM_FILTER、DELTA_UNSUPPORTED_COMMENT_MAP_ARRAY、DELTA_UNSUPPORTED_DATA_TYPES、DELTA_UNSUPPORTED_DROP_CLUSTERING_COLUMN、DELTA_UNSUPPORTED_DROP_COLUMN、DELTA_UNSUPPORTED_DROP_NESTED_COLUMN_FROM_NON_STRUCT_TYPE、DELTA_UNSUPPORTED_DROP_PARTITION_COLUMN、DELTA_UNSUPPORTED_FIELD_UPDATE_NON_STRUCT、DELTA_UNSUPPORTED_INVARIANT_NON_STRUCT、DELTA_UNSUPPORTED_IN_SUBQUERY、DELTA_UNSUPPORTED_MANIFEST_GENERATION_WITH_COLUMN_MAPPING、DELTA_UNSUPPORTED_MULTI_COL_IN_PREDICATE、DELTA_UNSUPPORTED_NESTED_COLUMN_IN_BLOOM_FILTER、DELTA_UNSUPPORTED_NESTED_FIELD_IN_OPERATION、DELTA_UNSUPPORTED_NON_EMPTY_CLONE、DELTA_UNSUPPORTED_OUTPUT_MODE、DELTA_UNSUPPORTED_PARTITION_COLUMN_IN_BLOOM_FILTER、DELTA_UNSUPPORTED_RENAME_COLUMN、DELTA_UNSUPPORTED_SCHEMA_DURING_READ、DELTA_UNSUPPORTED_SUBQUERY、DELTA_UNSUPPORTED_SUBQUERY_IN_PARTITION_PREDICATES、DELTA_UNSUPPORTED_TIME_TRAVEL_VIEWS、DELTA_UNSUPPORTED_TYPE_CHANGE_IN_SCHEMA、DELTA_UNSUPPORTED_VACUUM_SPECIFIC_PARTITION、WRONG_COLUMN_DEFAULTS_FOR_DELTA_ALTER_TABLE_ADD_COLUMN_NOT_SUPPORTED | |
0AKDD |
功能需要 Delta |
DELTA_COPY_INTO_TARGET_FORMAT, DELTA_NOT_A_DELTA_TABLE, DELTA_ONLY_OPERATION, DELTA_TABLE_ONLY_OPERATION, DELTA_UNSUPPORTED_SOURCE, DELTA_UNSUPPORTED_STATIC_PARTITIONS, SYNC_METADATA_DELTA_ONLY, UNSUPPORTED_MANAGED_TABLE_CREATION | |
0AKDE |
未为此 Delta 表启用功能 |
DELTA_CLUSTERING_PHASE_OUT_FAILED, DELTA_DATA_CHANGE_FALSE, DELTA_FEATURES_PROTOCOL_METADATA_MISMATCH, DELTA_FEATURES_REQUIRE_MANUAL_ENABLEMENT, DELTA_FEATURE_DROP_CONFLICT_REVALIDATION_FAIL, DELTA_FEATURE_DROP_DEPENDENT_FEATURE, DELTA_FEATURE_DROP_FEATURE_NOT_PRESENT, DELTA_FEATURE_DROP_HISTORICAL_VERSIONS_EXIST, DELTA_FEATURE_DROP_HISTORY_TRUNCATION_NOT_ALLOWED, DELTA_FEATURE_DROP_NONREMOVABLE_FEATURE, DELTA_FEATURE_DROP_UNSUPPORTED_CLIENT_FEATURE, DELTA_FEATURE_DROP_WAIT_FOR_RETENTION_PERIOD, DELTA_FEATURE_REQUIRES_HIGHER_READER_VERSION, DELTA_FEATURE_REQUIRES_HIGHER_WRITER_VERSION, DELTA_UNSUPPORTED_FEATURE_STATUS, WRONG_COLUMN_DEFAULTS_FOR_DELTA_FEATURE_NOT_ENABLED | |
0AKUC |
在 Unity Catalog 中不受支持 |
CANNOT_SHALLOW_CLONE_NESTED, CANNOT_SHALLOW_CLONE_NON_UC_MANAGED_TABLE_AS_SOURCE_OR_TARGET, INVALID_SCHEME, PARTITION_METADATA, UC_BUCKETED_TABLES, UC_COMMAND_NOT_SUPPORTED, UC_DATASOURCE_NOT_SUPPORTED, UC_DATASOURCE_OPTIONS_NOT_SUPPORTED, UC_FAILED_PROVISIONING_STATE, UC_FILE_SCHEME_FOR_TABLE_CREATION_NOT_SUPPORTED, UC_INVALID_NAMESPACE, UC_INVALID_REFERENCE, UPGRADE_NOT_SUPPORTED | |
0AKUD |
功能需要 Unity Catalog |
FEATURE_REQUIRES_UC、OPERATION_REQUIRES_UNITY_CATALOG、SYNC_METADATA_NOT_SUPPORTED |
类 0B
:无效的事务启动
SQLSTATE | 描述和发出错误类 |
---|---|
0B000 |
无效的事务启动 |
DELTA_ACTIVE_TRANSACTION_ALREADY_SET |
类 0N
:SQL/XML 映射错误
SQLSTATE | 描述和发出错误类 |
---|---|
0N000 |
SQL/XML 映射错误 |
XML_UNSUPPORTED_NESTED_TYPES |
类 21
:基数冲突
SQLSTATE | 描述和发出错误类 |
---|---|
21000 |
基数冲突 |
ROW_SUBQUERY_TOO_MANY_ROWS, SCALAR_SUBQUERY_TOO_MANY_ROWS | |
21506 |
表的同一行不能是多个更新、删除或插入操作的目标。 |
DELTA_MULTIPLE_SOURCE_ROW_MATCHING_TARGET_ROW_IN_MERGE | |
21S01 |
插入值列表与列列表不匹配 |
COPY_INTO_COLUMN_ARITY_MISMATCH, CREATE_VIEW_COLUMN_ARITY_MISMATCH, INSERT_COLUMN_ARITY_MISMATCH, INSERT_PARTITION_COLUMN_ARITY_MISMATCH |
类 22
:数据异常
SQLSTATE | 描述和发出错误类 |
---|---|
22000 |
数据异常 |
AI_FUNCTION_JSON_PARSE_ERROR, CF_BUCKET_MISMATCH, CF_CANNOT_EVOLVE_SCHEMA_LOG_EMPTY, CF_CANNOT_PARSE_QUEUE_MESSAGE, CF_CANNOT_RESOLVE_CONTAINER_NAME, CF_CANNOT_RUN_DIRECTORY_LISTING, CF_DUPLICATE_COLUMN_IN_DATA, CF_EVENT_GRID_AUTH_ERROR, CF_EVENT_GRID_CREATION_FAILED, CF_EVENT_GRID_NOT_FOUND_ERROR, CF_FAILED_TO_CHECK_STREAM_NEW, CF_FAILED_TO_CREATED_PUBSUB_SUBSCRIPTION, CF_FAILED_TO_CREATED_PUBSUB_TOPIC, CF_FAILED_TO_DELETE_GCP_NOTIFICATION, CF_FAILED_TO_DESERIALIZE_PERSISTED_SCHEMA, CF_FAILED_TO_EVOLVE_SCHEMA, CF_FAILED_TO_INFER_SCHEMA, CF_FAILED_TO_WRITE_TO_SCHEMA_LOG, CF_FOUND_MULTIPLE_AUTOLOADER_PUBSUB_SUBSCRIPTIONS, CF_GCP_LABELS_COUNT_EXCEEDED, CF_GCP_RESOURCE_TAGS_COUNT_EXCEEDED, CF_INCOMPLETE_LOG_FILE_IN_SCHEMA_LOG, CF_INCOMPLETE_METADATA_FILE_IN_CHECKPOINT, CF_INVALID_MANAGED_FILE_EVENTS_RESPONSE, CF_LATEST_OFFSET_READ_LIMIT_REQUIRED, CF_LOG_FILE_MALFORMED, CF_MANAGED_FILE_EVENTS_BACKFILL_IN_PROGRESS, CF_METADATA_FILE_CONCURRENTLY_USED, CF_MULTIPLE_PUBSUB_NOTIFICATIONS_FOR_TOPIC, CF_NEW_PARTITION_ERROR, CF_PARTITON_INFERENCE_ERROR, CF_PREFIX_MISMATCH, CF_PROTOCOL_MISMATCH, CF_RESTRICTED_GCP_RESOURCE_TAG_KEY, CF_SAME_PUB_SUB_TOPIC_NEW_KEY_PREFIX, CF_THREAD_IS_DEAD, CF_UNABLE_TO_LIST_EFFICIENTLY, CF_UNEXPECTED_READ_LIMIT, CF_UNKNOWN_READ_LIMIT, DELTA_CANNOT_FIND_BUCKET_SPEC, DELTA_CLUSTERING_COLUMN_MISSING_STATS, DELTA_CLUSTERING_CREATE_EXTERNAL_NON_LIQUID_TABLE_FROM_LIQUID_TABLE, DELTA_COMPACTION_VALIDATION_FAILED, DELTA_CONVERT_TO_DELTA_ROW_TRACKING_WITHOUT_STATS, DELTA_DV_HISTOGRAM_DESERIALIZATON, DELTA_INVALID_FORMAT, DELTA_INVALID_TABLE_VALUE_FUNCTION, DELTA_MATERIALIZED_ROW_TRACKING_COLUMN_NAME_MISSING, DELTA_ROW_ID_ASSIGNMENT_WITHOUT_STATS, DELTA_STREAMING_METADATA_EVOLUTION, DELTA_STREAMING_SCHEMA_EVOLUTION_UNSUPPORTED_ROW_FILTER_COLUMN_MASKS, DELTA_STREAMING_SCHEMA_LOCATION_CONFLICT, DELTA_STREAMING_SCHEMA_LOCATION_NOT_UNDER_CHECKPOINT, DELTA_STREAMING_SCHEMA_LOG_DESERIALIZE_FAILED, DELTA_STREAMING_SCHEMA_LOG_INCOMPATIBLE_DELTA_TABLE_ID, DELTA_STREAMING_SCHEMA_LOG_INCOMPATIBLE_PARTITION_SCHEMA, DELTA_STREAMING_SCHEMA_LOG_INIT_FAILED_INCOMPATIBLE_METADATA, DELTA_STREAMING_SCHEMA_LOG_PARSE_SCHEMA_FAILED, HLL_UNION_DIFFERENT_LG_K, INVALID_TIMESTAMP_FORMAT, KAFKA_DATA_LOSS, KINESIS_COULD_NOT_READ_SHARD_UNTIL_END_OFFSET, PS_FETCH_RETRY_EXCEPTION, PS_INVALID_KEY_TYPE, PS_INVALID_UNSAFE_ROW_CONVERSION_FROM_PROTO, PS_MOVING_CHECKPOINT_FAILURE, PS_MULTIPLE_FAILED_EPOCHS, PS_OPTION_NOT_IN_BOUNDS, PS_UNABLE_TO_PARSE_PROTO, STAGING_PATH_CURRENTLY_INACCESSIBLE | |
22001 |
字符串数据,右截断 |
DELTA_EXCEED_CHAR_VARCHAR_LIMIT | |
22003 |
数值超出范围 |
ARITHMETIC_OVERFLOW, BINARY_ARITHMETIC_OVERFLOW, CAST_OVERFLOW, CAST_OVERFLOW_IN_TABLE_INSERT, DECIMAL_PRECISION_EXCEEDS_MAX_PRECISION, DELTA_CANNOT_RESTORE_TABLE_VERSION, DELTA_CANNOT_RESTORE_TIMESTAMP_EARLIER, DELTA_CANNOT_RESTORE_TIMESTAMP_GREATER, DELTA_CAST_OVERFLOW_IN_TABLE_WRITE, DELTA_INVALID_CDC_RANGE, INCORRECT_RAMP_UP_RATE, INVALID_ARRAY_INDEX, INVALID_ARRAY_INDEX_IN_ELEMENT_AT, INVALID_BITMAP_POSITION, INVALID_BOUNDARY, INVALID_INDEX_OF_ZERO, INVALID_NUMERIC_LITERAL_RANGE, NUMERIC_OUT_OF_SUPPORTED_RANGE, NUMERIC_VALUE_OUT_OF_RANGE, SUM_OF_LIMIT_AND_OFFSET_EXCEEDS_MAX_INT | |
22004 |
不允许为 null 值 |
COMPARATOR_RETURNS_NULL, NULL_QUERY_STRING_EXECUTE_IMMEDIATE, TWS_VALUE_SHOULD_NOT_BE_NULL | |
22005 |
分配错误 |
DELTA_COMPLEX_TYPE_COLUMN_CONTAINS_NULL_TYPE、DELTA_FAILED_TO_MERGE_FIELDS、DELTA_MERGE_UNEXPECTED_ASSIGNMENT_KEY | |
22006 |
无效的间隔格式 |
CANNOT_PARSE_INTERVAL, DELTA_INVALID_INTERVAL, INVALID_INTERVAL_FORMAT | |
22007 |
无效的日期/时间格式 |
CANNOT_PARSE_TIMESTAMP, DELTA_INVALID_TIMESTAMP_FORMAT, INVALID_DATETIME_PATTERN | |
22008 |
日期/时间字段溢出 |
DATETIME_OVERFLOW | |
2200E |
数组目标中包含 null 值 |
NULL_MAP_KEY | |
2200G |
最具体类型不匹配 |
DELTA_COLUMN_STRUCT_TYPE_MISMATCH | |
2200P |
间隔值超出范围 |
DELTA_INVALID_CALENDAR_INTERVAL_EMPTY | |
22012 |
被零除 |
DIVIDE_BY_ZERO、INTERVAL_DIVIDED_BY_ZERO | |
22015 |
间隔字段溢出 |
INTERVAL_ARITHMETIC_OVERFLOW | |
22018 |
要强制转换的字符值无效 |
CANNOT_PARSE_DECIMAL、CANNOT_PARSE_PROTOBUF_DESCRIPTOR、CAST_INVALID_INPUT、CONVERSION_INVALID_INPUT、DELTA_FAILED_CAST_PARTITION_VALUE、FAILED_PARSE_STRUCT_TYPE | |
2201B |
无效的正则表达式 |
DELTA_REGEX_OPT_SYNTAX_ERROR | |
2201E |
自然对数的无效参数 |
STRUCT_ARRAY_LENGTH_MISMATCH | |
22022 |
指示器溢出 |
INVALID_CONF_VALUE | |
22023 |
无效的参数值 |
CONFLICTING_PROVIDER, DELTA_INVALID_AUTO_COMPACT_TYPE, DELTA_INVALID_BUCKET_COUNT, DELTA_INVALID_BUCKET_INDEX, DELTA_UNSUPPORTED_STRATEGY_NAME, EMPTY_LOCAL_FILE_IN_STAGING_ACCESS_QUERY, EWKB_PARSE_ERROR, GEOJSON_PARSE_ERROR, H3_INVALID_CELL_ID, H3_INVALID_GRID_DISTANCE_VALUE, H3_INVALID_RESOLUTION_VALUE, H3_PENTAGON_ENCOUNTERED_ERROR, H3_UNDEFINED_GRID_DISTANCE, INVALID_FRACTION_OF_SECOND, INVALID_PARAMETER_MARKER_VALUE, INVALID_PARAMETER_VALUE, INVALID_VARIANT_CAST, INVALID_VARIANT_GET_PATH, MALFORMED_RECORD_IN_PARSING, MALFORMED_VARIANT, MAX_RECORDS_PER_FETCH_INVALID_FOR_KINESIS_SOURCE, METRIC_STORE_INVALID_ARGUMENT_VALUE_ERROR, RULE_ID_NOT_FOUND, SECOND_FUNCTION_ARGUMENT_NOT_INTEGER, ST_DIFFERENT_SRID_VALUES, ST_INVALID_ARGUMENT, ST_INVALID_ARGUMENT_TYPE, ST_INVALID_CRS_TRANSFORMATION_ERROR, ST_INVALID_ENDIANNESS_VALUE, ST_INVALID_GEOHASH_VALUE, ST_INVALID_PRECISION_VALUE, ST_INVALID_SRID_VALUE, TABLE_VALUED_FUNCTION_REQUIRED_METADATA_INCOMPATIBLE_WITH_CALL, TABLE_VALUED_FUNCTION_REQUIRED_METADATA_INVALID, VARIANT_CONSTRUCTOR_SIZE_LIMIT, VARIANT_DUPLICATE_KEY, VARIANT_SIZE_LIMIT, WKB_PARSE_ERROR, WKT_PARSE_ERROR, XML_WILDCARD_RESCUED_DATA_CONFLICT_ERROR | |
22032 |
无效的 JSON 文本 |
AI_FUNCTION_INVALID_MAX_WORDS、AI_INVALID_ARGUMENT_VALUE_ERROR、INVALID_JSON_ROOT_FIELD、INVALID_JSON_SCHEMA_MAP_TYPE、REMOTE_FUNCTION_HTTP_RESULT_PARSE_ERROR | |
2203G |
sql json 项无法强制转换为目标类型 |
AI_FUNCTION_HTTP_PARSE_CAST_ERROR, AI_FUNCTION_HTTP_PARSE_COLUMNS_ERROR, CANNOT_PARSE_JSON_FIELD, FAILED_ROW_TO_JSON, INVALID_JSON_DATA_TYPE, INVALID_JSON_DATA_TYPE_FOR_COLLATIONS | |
22525 |
分区键值无效。 |
DELTA_PARTITION_COLUMN_CAST_FAILED | |
22531 |
内置或系统提供的例程的参数导致错误。 |
INVALID_SECRET_LOOKUP | |
22546 |
例程参数的值无效。 |
CANNOT_DECODE_URL、HLL_INVALID_INPUT_SKETCH_BUFFER、HLL_INVALID_LG_K | |
22KD1 |
无效的 URI 或路径 |
DELTA_CANNOT_RECONSTRUCT_PATH_FROM_URI、DELTA_CANNOT_RENAME_PATH、DELTA_INVALID_CLONE_PATH、DELTA_INVALID_PARTITION_PATH | |
22KD2 |
未设置标识声明 |
OAUTH_CUSTOM_IDENTITY_CLAIM_NOT_PROVIDED | |
22KD3 |
无法将源类型演化为目标类型。 |
AVRO_INCOMPATIBLE_READ_TYPE、FROM_JSON_SCHEMA_EVOLUTION_FAILED | |
22P02 |
文本表示形式无效 |
INVALID_URL | |
22P03 |
二进制表示形式无效 |
INVALID_BYTE_STRING |
类 23
:完整性约束冲突
SQLSTATE | 描述和发出错误类 |
---|---|
23001 |
限制冲突 |
DELTA_VIOLATE_CONSTRAINT_WITH_VALUES | |
23502 |
插入或更新值为 null,但列不能包含 null 值。 |
DELTA_MISSING_NOT_NULL_COLUMN_VALUE、DELTA_NOT_NULL_CONSTRAINT_VIOLATED | |
23505 |
唯一索引或唯一约束施加的约束发生冲突。 |
DUPLICATED_MAP_KEY、DUPLICATE_KEY | |
23512 |
无法添加检查约束,因为表包含不满足约束定义的行。 |
DELTA_NEW_CHECK_CONSTRAINT_VIOLATION、DELTA_NEW_NOT_NULL_VIOLATION | |
23K01 |
MERGE 基数冲突 |
MERGE_CARDINALITY_VIOLATION |
类 25
:无效的事务状态
类 2B
:依赖特权描述符仍然存在
SQLSTATE | 描述和发出错误类 |
---|---|
2BP01 |
依赖对象仍然存在 |
SCHEMA_NOT_EMPTY |
类 2D
:无效的事务终止
SQLSTATE | 描述和发出错误类 |
---|---|
2D521 |
SQL COMMIT 或 ROLLBACK 在当前操作环境中无效。 |
DELTA_CONCURRENT_APPEND, DELTA_CONCURRENT_DELETE_DELETE, DELTA_CONCURRENT_DELETE_READ, DELTA_CONCURRENT_TRANSACTION, DELTA_CONCURRENT_WRITE, DELTA_DELETION_VECTOR_MISSING_NUM_RECORDS, DELTA_DUPLICATE_ACTIONS_FOUND, DELTA_METADATA_CHANGED, DELTA_PROTOCOL_CHANGED | |
2DKD0 |
提交后挂钩失败。 |
DELTA_POST_COMMIT_HOOK_FAILED |
类 38
:外部例程异常
类 39
:外部例程调用异常
SQLSTATE | 描述和发出错误类 |
---|---|
39000 |
外部例程调用异常 |
FAILED_EXECUTE_UDF、FOREACH_BATCH_USER_FUNCTION_ERROR、UDF_USER_CODE_ERROR |
类 3D
:无效的目录名称
SQLSTATE | 描述和发出错误类 |
---|---|
3D000 |
无效的目录名称 |
UC_CATALOG_NAME_NOT_PROVIDED |
类 40
:事务回滚
SQLSTATE | 描述和发出错误类 |
---|---|
40000 |
事务回滚 (transaction rollback) |
CONCURRENT_STREAM_LOG_UPDATE, DELTA_MAX_COMMIT_RETRIES_EXCEEDED |
类 42
:语法错误或访问规则冲突
类 44
:发生检查选项冲突
SQLSTATE | 描述和发出错误类 |
---|---|
44000 |
发生检查选项冲突 |
DELTA_REPLACE_WHERE_MISMATCH |
类 46
:Java DDL 1
SQLSTATE | 描述和发出错误类 |
---|---|
46103 |
未解析的类名 |
CANNOT_LOAD_FUNCTION_CLASS | |
46110 |
不支持的功能 |
CANNOT_MODIFY_CONFIG | |
46121 |
列名称无效 |
INVALID_COLUMN_NAME_AS_PATH |
类 51
:应用程序状态无效
SQLSTATE | 描述和发出错误类 |
---|---|
51024 |
不能使用对象,因为它已被标记为无效。 |
INCOMPATIBLE_VIEW_SCHEMA_CHANGE |
类 53
:资源不足
SQLSTATE | 描述和发出错误类 |
---|---|
53200 |
内存不足 |
EXECUTOR_BROADCAST_JOIN_OOM、UNABLE_TO_ACQUIRE_MEMORY |
类 54
:超出程序限制
SQLSTATE | 描述和发出错误类 |
---|---|
54000 |
超出程序限制 |
COLLECTION_SIZE_LIMIT_EXCEEDED、DELTA_CLUSTER_BY_INVALID_NUM_COLUMNS、GROUPING_SIZE_LIMIT_EXCEEDED、RELATION_LARGER_THAN_8G | |
54001 |
语句太长或太复杂。 |
FAILED_TO_PARSE_TOO_COMPLEX | |
54006 |
结果字符串太长。 |
EXCEED_LIMIT_LENGTH、KRYO_BUFFER_OVERFLOW | |
54023 |
参数太多 |
TABLE_VALUED_FUNCTION_TOO_MANY_TABLE_ARGUMENTS | |
54K00 |
已超出嵌套视图的最大深度。 |
VIEW_EXCEED_MAX_NESTED_DEPTH | |
54KD0 |
超出了查询计划中的最大 UDF 计数。 |
UDF_LIMITS、UDF_MAX_COUNT_EXCEEDED | |
54KD1 |
超过会话中的最大对象数。 |
MAX_NUMBER_VARIABLES_IN_SESSION_EXCEEDED |
类 55
:对象不处于先决条件状态
类 56
:其他 SQL 或产品错误
类 57
:操作员干预
SQLSTATE | 描述和发出错误类 |
---|---|
57012 |
非数据库资源不可用。 这不会影响后续语句的成功执行。 |
REMOTE_FUNCTION_HTTP_FAILED_ERROR、REMOTE_FUNCTION_HTTP_RESULT_UNEXPECTED_ERROR、REMOTE_FUNCTION_HTTP_RETRY_TIMEOUT、REMOTE_FUNCTION_MISSING_REQUIREMENTS_ERROR |
类 58
:系统错误
SQLSTATE | 描述和发出错误类 |
---|---|
58000 |
系统错误 |
CLOUD_PROVIDER_ERROR | |
58030 |
I/O 错误 |
CANNOT_LOAD_STATE_STORE、CANNOT_RESTORE_PERMISSIONS_FOR_PATH、CANNOT_WRITE_STATE_STORE、FAILED_RENAME_TEMP_FILE、INVALID_BUCKET_FILE、TASK_WRITE_FAILED、UNABLE_TO_FETCH_HIVE_TABLES |
类 82
:内存不足
SQLSTATE | 描述和发出错误类 |
---|---|
82100 |
内存不足(无法分配) |
DELTA_BLOOM_FILTER_OOM_ON_WRITE |
类 F0
:配置文件错误
类 HV
:特定于 FDW 的条件
SQLSTATE | 描述和发出错误类 |
---|---|
HV000 |
特定于 FDW 的条件 |
FAILED_JDBC | |
HV091 |
无效的描述符字段标识符 |
NONEXISTENT_FIELD_NAME_IN_LIST |
类 HY
:特定于 CLI 的条件
SQLSTATE | 描述和发出错误类 |
---|---|
HY000 |
特定于 CLI 的条件 |
INVALID_HANDLE | |
HY008 |
操作已取消 |
OPERATION_CANCELED | |
HY109 |
无效的游标位置 |
INVALID_CURSOR |
类 KD
:特定于数据源的错误
类 P0
:过程逻辑错误
SQLSTATE | 描述和发出错误类 |
---|---|
P0001 |
引发异常 |
USER_RAISED_EXCEPTION、USER_RAISED_EXCEPTION_PARAMETER_MISMATCH、USER_RAISED_EXCEPTION_UNKNOWN_ERROR_CLASS |