Azure Databricks 中的错误类

数据集转换和操作只能由驱动程序调用，而不能在其他数据集转换内部调用；例如，dataset1.map(x => dataset2.values.count() * x) 无效，因为无法在 dataset1.map 转换内部执行值转换和计数操作。有关详细信息，请参阅 SPARK-28702。

CANNOT_LOAD_FUNCTION_CLASS

SQLSTATE：46103

注册函数 <functionName> 时无法加载类 <className>，请确保它位于类路径上。

CANNOT_LOAD_PROTOBUF_CLASS

无法加载名称为 <protobufClassName> 的 Protobuf 类。 <explanation>。

CANNOT_LOAD_STATE_STORE

SQLSTATE: 58030

加载状态期间出错。

有关详细信息，请参阅 CANNOT_LOAD_STATE_STORE

CANNOT_MERGE_INCOMPATIBLE_DATA_TYPE

SQLSTATE：42825

无法合并不兼容的数据类型 <left> 和 <right>。请检查要合并的列的数据类型，并确保它们兼容。如有必要，请考虑在尝试合并之前将列强制转换为兼容的数据类型。

CANNOT_MERGE_SCHEMAS

架构合并失败：

初始架构：

<left>

无法与初始架构合并的架构：

<right>。

CANNOT_MODIFY_CONFIG

SQLSTATE：46110

无法修改 Spark 配置值：<key>。

另请参阅 https://spark.apache.org/docs/latest/sql-migration-guide.html#ddl-statements。

CANNOT_PARSE_DECIMAL

无法分析十进制数。请确保输入是具有可选小数点或逗号分隔符的有效数字。

CANNOT_PARSE_INTERVAL

SQLSTATE：22006

无法分析 <intervalString>。请确保提供的值采用用于定义间隔的有效格式。可以参考文档获取正确的格式。如果问题仍然存在，请仔细检查输入值不为 null 或为空，然后重试。

CANNOT_PARSE_JSON_FIELD

SQLSTATE：2203G

无法将 JSON 标记类型 <jsonType> 的字段名称 <fieldName> 和值 <fieldValue> 分析为目标 Spark 数据类型 <dataType>。

CANNOT_PARSE_PROTOBUF_DESCRIPTOR

将描述符字节解析为 Protobuf FileDescriptorSet 时出错。

CANNOT_PARSE_TIMESTAMP

SQLSTATE：22007

<message>。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

CANNOT_READ_ARCHIVED_FILE

无法读取路径 <path> 处的文件，因为该文件已存档。请调整查询筛选器以排除已存档的文件。

CANNOT_READ_FILE

无法读取路径 <path> 处的 <format> 文件。

有关详细信息，请参阅 CANNOT_READ_FILE

CANNOT_READ_FILE_FOOTER

无法对已经是浅度克隆的表 <table> 执行浅度克隆。

CANNOT_SHALLOW_CLONE_NON_UC_MANAGED_TABLE_AS_SOURCE_OR_TARGET

SQLSTATE：0AKUC

只有 MANAGED 表类型支持浅度克隆。表 <table> 不是托管表。

CANNOT_UPDATE_FIELD

无法更新 <table> 字段 <fieldName> 类型：

有关详细信息，请参阅 CANNOT_UPDATE_FIELD

CANNOT_UP_CAST_DATATYPE

无法将 <expression> 从 <sourceType> 强制转换为 <targetType>。

<details>

CANNOT_VALIDATE_CONNECTION

SQLSTATE：08000

不支持验证 <jdbcDialectName> 连接。请联系 Databricks 支持团队获取替代解决方案，或将“spark.databricks.testConnectionBeforeCreation”设置为“false”，以跳过创建连接对象前的连接测试。

CANNOT_WRITE_STATE_STORE

为提供程序 <providerClass> 写入状态存储文件时出错。

有关详细信息，请参阅 CANNOT_WRITE_STATE_STORE

CAST_INVALID_INPUT

类型 <sourceType> 的值 <expression> 无法强制转换为 <targetType>，因为其格式错误。根据语法更正值，或更改其目标类型。使用 try_cast 来容许格式错误的输入并改为返回 NULL。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

有关更多详细信息，请参阅 CAST_INVALID_INPUT

CAST_OVERFLOW

由于溢出，类型 <sourceType> 的值 <value> 无法强制转换为 <targetType>。使用 try_cast 容许溢出，并返回 NULL。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

CAST_OVERFLOW_IN_TABLE_INSERT

由于溢出，无法将 <sourceType> 类型分配到 <targetType> 类型列或变量 <columnName>。对输入值使用 try_cast 以容许溢出并改为返回 NULL。

CHECKPOINT_RDD_BLOCK_ID_NOT_FOUND

SQLSTATE：56000

找不到检查点块 <rddBlockId>!

可能是最初为此分区设置检查点的执行程序不再处于活动状态，或者未保留原始 RDD。

如果此问题仍然存在，可以考虑改用 rdd.checkpoint()，这个检查点比本地检查点慢，但容错能力更高。

CLASS_UNSUPPORTED_BY_MAP_OBJECTS

MapObjects 不支持将类 <cls> 作为生成的集合。

CLOUD_FILE_SOURCE_FILE_NOT_FOUND

已收到文件 <filePath> 的文件通知，但该文件不再存在。请确保在处理文件之前该文件未被删除。若要继续处理流，可以将 Spark SQL 配置 <config> 设置为 true。

CODEC_NOT_AVAILABLE

编解码器 <codecName> 不可用。请考虑将配置 <configKey> 设置为 <configVal>。

CODEC_SHORT_NAME_NOT_FOUND

找不到编解码器 <codecName> 的短名称。

COLLECTION_SIZE_LIMIT_EXCEEDED

SQLSTATE：54000

无法使用超过数组大小限制 <maxRoundedArrayLength> 的 <numberOfElements> 元素创建数组，

有关详细信息，请参阅 COLLECTION_SIZE_LIMIT_EXCEEDED

COLUMN_ALIASES_IS_NOT_ALLOWED

<op> 中不允许使用列别名。

COLUMN_ALREADY_EXISTS

列 <columnName> 已存在。请考虑选择其他名称或重命名现有列。

COLUMN_MASKS_CHECK_CONSTRAINT_UNSUPPORTED

不支持使用列掩码策略对表 <tableName> 创建 CHECK 约束。

COLUMN_MASKS_DUPLICATE_USING_COLUMN_NAME

SQLSTATE：42734

<statementType> 语句尝试将列掩码策略分配到某个列，而该列包含 USING COLUMNS 列表中的其他两个或更多个具有名称 <columnName> 的被引用列，这是无效操作。

COLUMN_MASKS_FEATURE_NOT_SUPPORTED

若要恢复已弃用的行为，即，将 NULL 视为 0（使用“等于”运算符），必须将“spark.sql.legacy.allowNullComparisonResultInArraySort”设置为“true”。

CONCURRENT_QUERY

此查询的另一个实例 [id：<queryId>] 刚刚由并发会话启动 [现有 runId：<existingQueryRunId>，新 runId：<newQueryRunId>]。

CONCURRENT_STREAM_LOG_UPDATE

SQLSTATE：40000

并发更新日志。检测到多个流式处理作业的 <batchId>。

请确保一次只有一个流式处理作业在特定检查点位置运行。

CONNECT

SQLSTATE：56K00

泛型 Spark 连接错误。

有关详细信息，请参阅 CONNECT

CONNECTION_ALREADY_EXISTS

COPY_INTO_ROCKSDB_MAX_RETRY_EXCEEDED

SQLSTATE：25000

COPY INTO 无法加载其状态，超过最大重试次数。

COPY_INTO_SCHEMA_MISMATCH_WITH_TARGET_TABLE

SQLSTATE：42KDG

复制到 Delta 表（表：<table>）时检测到架构不匹配。

这可能表示传入数据存在问题，或者 Delta 表架构通过以下设置根据传入数据进行了自动演变：

COPY_OPTIONS ('mergeSchema' = 'true')

架构差异：

<schemaDiff>

COPY_INTO_SOURCE_FILE_FORMAT_NOT_SUPPORTED

源文件的格式必须为 CSV、JSON、AVRO、ORC、PARQUET、TEXT 或 BINARYFILE 中的一种。不支持在 Delta 表上使用 COPY INTO 作为源，因为在进行 OPTIMIZE 操作后可能会引入重复数据。可以通过运行 SQL 命令 set spark.databricks.delta.copyInto.formatCheck.enabled = false 来关闭此检查。

COPY_INTO_SOURCE_SCHEMA_INFERENCE_FAILED

源目录不包含 <format> 类型的任何可分析文件。请检查“<source>”的内容。

COPY_INTO_SYNTAX_ERROR

未能分析 COPY INTO 命令。

有关详细信息，请参阅 COPY_INTO_SYNTAX_ERROR

CREATE_PERMANENT_VIEW_WITHOUT_ALIAS

不允许在未显式分配表达式 <attr> 的别名的情况下创建永久视图 <name>。

CREATE_TABLE_COLUMN_DESCRIPTOR_DUPLICATE

CREATE TABLE 列 <columnName> 多次指定了描述符“<optionName>”，这是无效的。

CREATE_VIEW_COLUMN_ARITY_MISMATCH

SQLSTATE：21S01

无法创建视图 <viewName>，原因为

有关更多详细信息，请参阅 CREATE_VIEW_COLUMN_ARITY_MISMATCH

CREDENTIAL_MISSING

创建或更新外部位置时请提供凭据。

CSV_ENFORCE_SCHEMA_NOT_SUPPORTED

使用 rescuedDataColumn 或 failOnUnknownFields 时，无法设置 CSV 选项 enforceSchema，因为列是按名称读取的，而不是序号。

CYCLIC_FUNCTION_REFERENCE

SQLSTATE：42887

检测到循环函数引用：<path>。

DATABRICKS_DELTA_NOT_ENABLED

未在帐户中启用 Databricks Delta。<hints>

DATATYPE_MISMATCH

由于数据类型不匹配，无法进行解析 <sqlExpr>：

有关更多详细信息，请参阅 DATATYPE_MISMATCH

DATATYPE_MISSING_SIZE

SQLSTATE：42K01

DataType <type> 需要长度参数，例如 <type>(10)。请指定长度。

DATA_SOURCE_ALREADY_EXISTS

数据源“<provider>”已存在。请为新数据源选择其他名称。

DATA_SOURCE_NOT_EXIST

找不到数据源“<provider>”。请确保已注册该数据源。

DATA_SOURCE_NOT_FOUND

SQLSTATE：42K02

无法找到数据源：<provider>。请在 https://spark.apache.org/third-party-projects.html 中查找包。

DATA_SOURCE_OPTION_CONTAINS_INVALID_CHARACTERS

选项 <option> 不能为空，且不应包含无效字符、查询字符串或参数。

DATA_SOURCE_OPTION_IS_REQUIRED

选项 <option> 是必需的。

DATA_SOURCE_TABLE_SCHEMA_MISMATCH

数据源表的架构与预期的架构不匹配。如果使用 DataFrameReader.schema API 或要创建表，请避免指定该架构。

请增加 Salesforce 中的配额或更新配置的阈值。

DC_SFDC_API_ERROR

Salesforce API 调用中出错，errorCode：<errorCode>。

有关详细信息，请参阅 DC_SFDC_API_ERROR

DC_SQLSERVER_ERROR

SQL Server 连接器中发生错误。

有关详细信息，请参阅 DC_SQLSERVER_ERROR

DC_UNSUPPORTED_ERROR

数据源 <sourceName> 中出现“不受支持”错误。

有关更多详细信息，请参阅 DC_UNSUPPORTED_ERROR

DECIMAL_PRECISION_EXCEEDS_MAX_PRECISION

小数精度 <precision> 超过最大精度 <maxPrecision>。

DEFAULT_DATABASE_NOT_EXISTS

默认数据库 <defaultDatabase> 不存在，请先创建该数据库，或将默认数据库更改为 <defaultDatabase>。

DEFAULT_FILE_NOT_FOUND

可能已更新基础文件。可在 SQL 中运行“REFRESH TABLE tableName”命令或重新创建所涉及的数据集/数据帧，显式地使 Spark 中的缓存失效。如果磁盘缓存已过时，或者基础文件已删除，可以通过重启群集手动使磁盘缓存失效。

DEFAULT_PLACEMENT_INVALID

SQLSTATE：42608

无法将 MERGE、INSERT、UPDATE 或 SET VARIABLE 命令中的 DEFAULT 关键字直接分配给目标列，因为它是表达式的一部分。

例如，允许 UPDATE SET c1 = DEFAULT，但不允许 UPDATE T SET c1 = DEFAULT + 1。

DIFFERENT_DELTA_TABLE_READ_BY_STREAMING_SOURCE

流式处理查询从意外的 Delta 表（id =“<newTableId>”）中读取。

它用于根据检查点从另一个 Delta 表（id =“<oldTableId>”）中读取。

当更改代码以从新表读取，或删除并重新创建表时，

可能会发生此错误。请还原更改或删除流式处理查询检查点

以从头开始。

DISTINCT_WINDOW_FUNCTION_UNSUPPORTED

不支持不同的窗口函数：<windowExpr>。

DIVIDE_BY_ZERO

SQLSTATE：22012

SQLSTATE：23505

找到重复的映射键 <key>，请检查输入数据。

如果你要删除重复的键，可以将 <mapKeyDedupPolicy> 设置为“LAST_WIN”，使最后插入的键优先。

DUPLICATED_METRICS_NAME

指标名称不唯一：<metricName>。同一名称不能用于具有不同结果的指标。

但是，允许具有相同结果和名称的多个指标实例（例如自联接）。

DUPLICATE_ASSIGNMENTS

列或变量 <nameList> 作为赋值目标出现多次。

DUPLICATE_CLAUSES

SQLSTATE：42614

发现重复子句：<clauseName>。请删除其中的一个。

DUPLICATE_KEY

SQLSTATE：23505

发现重复键 <keyColumn>。

DUPLICATE_ROUTINE_PARAMETER_ASSIGNMENT

对函数 <functionName> 的调用无效，因为它包含对同一参数名称 <parameterName> 的多个参数赋值。

有关更多详细信息，请参阅 DUPLICATE_ROUTINE_PARAMETER_ASSIGNMENT

DUPLICATE_ROUTINE_PARAMETER_NAMES

SQLSTATE：42734

在用户定义的例程 <routineName> 的参数列表中发现重复的名称：<names>。

DUPLICATE_ROUTINE_RETURNS_COLUMNS

在用户定义的例程 <routineName> 的 RETURNS 子句列列表中发现重复的列：<columns>。

EMPTY_JSON_FIELD_VALUE

无法分析数据类型 <dataType> 的空字符串。

EMPTY_LOCAL_FILE_IN_STAGING_ACCESS_QUERY

暂存 <operation> 查询中包含空本地文件

ENCODER_NOT_FOUND

找不到 Spark SQL 内部表示形式的 <typeName> 类型编码器。

考虑将输入类型更改为“<docroot>/sql-ref-datatypes.html”支持的其中一个类型。

END_OFFSET_HAS_GREATER_OFFSET_FOR_TOPIC_PARTITION_THAN_LATEST_WITH_TRIGGER_AVAILABLENOW

在使用 Trigger.AvailableNow 运行查询期间，Kafka 主题中某些分区报告的可用偏移量小于结束偏移量。此错误可能是暂时性的 - 请重启查询，如果仍然看到相同问题，请予以报告。

最新偏移量：<latestOffset>，结束偏移量：<endOffset>

END_OFFSET_HAS_GREATER_OFFSET_FOR_TOPIC_PARTITION_THAN_PREFETCHED

对于具有 Trigger.AvailableNow 的 Kafka 数据源，每个主题分区的结束偏移量应小于或等于预提取的偏移量。此错误可能是暂时性的 - 请重启查询，如果仍然看到相同问题，请予以报告。

预提取的偏移量：<prefetchedOffset>，结束偏移量：<endOffset>

ERROR_READING_AVRO_UNKNOWN_FINGERPRINT

SQLSTATE：KD00B

读取 avro 数据时出错 - 遇到未知指纹: <fingerprint>，不确定要使用的架构。

如果在启动 Spark 上下文后注册了其他架构，则可能会发生这种情况。

EVENT_LOG_REQUIRES_SHARED_COMPUTE

无法从“已分配”或“无隔离共享”群集查询事件日志，请改用共享群集或 Databricks SQL 仓库。

EVENT_LOG_UNAVAILABLE

没有任何适用于 <tableOrPipeline> 的事件日志。请稍后在生成事件后重试

EVENT_LOG_UNSUPPORTED_TABLE_TYPE

SQLSTATE：42832

<tableIdentifier> 的表类型为 <tableType>。

查询事件日志仅支持具体化视图、流式处理表或增量实时表管道

EVENT_TIME_IS_NOT_ON_TIMESTAMP_TYPE

事件时间 <eventName> 的 <eventType> 类型无效，应为“TIMESTAMP”。

EXCEED_LIMIT_LENGTH

SQLSTATE：54006

超过 char/varchar 类型长度限制：<limit>。

EXCEPT_NESTED_COLUMN_INVALID_TYPE

SQLSTATE：428H2

EXCEPT 列 <columnName> 已解析，本应该为 StructType，但发现类型为 <dataType>。

EXCEPT_OVERLAPPING_COLUMNS

SQLSTATE：42702

EXCEPT 列表中的列必须非重复且不重叠，但出现了 (<columns>)。

EXCEPT_RESOLVED_COLUMNS_WITHOUT_MATCH

EXCEPT 列 [<exceptColumns>] 已解析，但不与星形扩展中的任何 [<expandedColumns>] 列匹配。

EXCEPT_UNRESOLVED_COLUMN_IN_STRUCT_EXPANSION

无法解析 EXCEPT 子句中的列/字段名称 <objectName>。你是否指的是下列其中一项：[<objectList>]？

注意：在结构扩展期间，EXCEPT 子句中的嵌套列可能不包含限定符（表名、父结构列名等）；如果将限定符用于嵌套列，请尝试删除限定符。

EXECUTOR_BROADCAST_JOIN_OOM

SQLSTATE：53200

内存不足，无法生成广播关系 <relationClassName>。关系大小 = <relationSize>. 生成段端随机大小 = <shuffleSize>。此任务使用的内存总量 = <taskMemoryUsage>。 onHeapExecutionMemoryUsed = <onHeapExecutionMemoryUsed>，offHeapExecutionMemoryUsed = <offHeapExecutionMemoryUsed>，onHeapStorageMemoryUsed = <onHeapStorageMemoryUsed>，offHeapStorageMemoryUsed = <offHeapStorageMemoryUsed>。 [shuffleId: <shuffleId>]

EXEC_IMMEDIATE_DUPLICATE_ARGUMENT_ALIASES

此 EXECUTE IMMEDIATE 命令的 USING 子句包含多个具有相同别名 (<aliases>) 的参数，这是无效的；请更新命令以指定唯一的别名，然后重试。

无法将行解码为表达式的值：<expressions>。

EXPRESSION_ENCODING_FAILED

无法将表达式的值 <expressions> 解码为行。

EXPRESSION_TYPE_IS_NOT_ORDERABLE

SQLSTATE：42822

列表达式 <expr> 无法排序，因为其类型 <exprType> 不可排序。

EXTERNAL_TABLE_INVALID_SCHEME

外部表不支持 <scheme> 方案。

FAILED_EXECUTE_UDF

SQLSTATE：39000

由于 <reason>，用户定义函数 (<functionName>: (<signature>) =><result>) 失败。

FAILED_FUNCTION_CALL

SQLSTATE：38000

为调用准备函数 <funcName> 失败。请仔细检查函数的参数。

FAILED_JDBC

SQLSTATE: HV000

操作上的 JDBC <url> 失败：

有关详细信息，请参阅 FAILED_JDBC

FAILED_PARSE_STRUCT_TYPE

解析结构 <raw> 失败。

FAILED_REGISTER_CLASS_WITH_KRYO

无法向 Kryo 注册课程。

FAILED_RENAME_PATH

无法将 <sourcePath> 重命名为 <targetPath>，因为目标已存在。

FAILED_RENAME_TEMP_FILE

无法将临时文件 <srcPath> 重命名为<dstPath>，因为 FileSystem.rename 返回 false。

FEATURE_NOT_ON_CLASSIC_WAREHOUSE

<feature> 在经典 SQL 仓库上不受支持。若要使用此功能，请使用专业或无服务器 SQL 仓库。若要详细了解仓库类型，请参阅 <docLink>

FEATURE_REQUIRES_UC

SQLSTATE：0AKUD

<feature> 在没有 Unity Catalog 的情况下不受支持。若要使用此功能，请启用 Unity Catalog。若要详细了解 Unity Catalog，请参阅 <docLink>

FEATURE_UNAVAILABLE

<feature> 在你的环境中不受支持。若要使用此功能，请联系 Databricks 支持人员。

FIELDS_ALREADY_EXISTS

无法 <op> 列，因为 <fieldNames> 已在 <struct> 中存在。

FIELD_NOT_FOUND

<fields> 中没有此类结构字段 <fieldName>。

FILE_IN_STAGING_PATH_ALREADY_EXISTS

暂存路径 <path> 中的文件已存在，但未设置 OVERWRITE

FORBIDDEN_OPERATION

不允许对 <objectType> 执行 <statement> 操作：<objectName>。

FOREIGN_KEY_MISMATCH

SQLSTATE：42830

外键父列 <parentColumns> 与主键子列 <childColumns> 不匹配。

FOREIGN_OBJECT_NAME_CANNOT_BE_EMPTY

无法执行此命令，因为外部 <objectType> 名称必须非空。

FOUND_MULTIPLE_DATA_SOURCES

检测到名称为“<provider>”的多个数据源。请检查数据源未同时注册并位于 classpath 中。

FROM_JSON_CONFLICTING_SCHEMA_UPDATES

from_json 推理在以下位置遇到冲突的架构更新：<location>

FROM_JSON_CORRUPT_RECORD_COLUMN_IN_SCHEMA

from_json found columnNameOfCorruptRecord (<columnNameOfCorruptRecord>)

在 JSON 对象中，无法再继续。请为 columnNameOfCorruptRecord

选项“columnNameOfCorruptRecord”。

FROM_JSON_CORRUPT_SCHEMA

from_json 推理无法读取存储在以下位置的架构：<location>

FROM_JSON_INFERENCE_FAILED

from_json 无法推断架构。请改为提供一个架构。

FROM_JSON_INFERENCE_NOT_SUPPORTED

仅当定义流式处理表时，才支持 from_json 推理

FROM_JSON_INVALID_CONFIGURATION

from_json 配置无效：

有关更多详细信息，请参阅 FROM_JSON_INVALID_CONFIGURATION

FROM_JSON_SCHEMA_EVOLUTION_FAILED

SQLSTATE：22KD3

from_json 无法从 <old> 发展为 <new>

GENERATED_COLUMN_WITH_DEFAULT_VALUE

SQLSTATE：42623

列不能同时具有默认值和生成表达式，但列 <colName> 具有默认值 (<defaultValue>) 和生成表达式 (<genExpr>)。

GET_TABLES_BY_TYPE_UNSUPPORTED_BY_HIVE_VERSION

Hive 2.2 和更低版本不支持 getTablesByType。请使用 Hive 2.3 或更高版本。

GRAPHITE_SINK_INVALID_PROTOCOL

无效的 Graphite 协议：<protocol>。

GRAPHITE_SINK_PROPERTY_MISSING

Graphite 接收器需要“<property>”属性。

GROUPING_COLUMN_MISMATCH

在分组列 <groupingColumns> 中找不到分组 (<grouping>) 的列。

GROUPING_ID_COLUMN_MISMATCH

grouping_id (<groupingIdColumn>) 的列与分组列 (<groupByColumns>) 不匹配。

GROUPING_SIZE_LIMIT_EXCEEDED

SQLSTATE：54000

分组集大小不能大于 <maxSize>。

GROUP_BY_AGGREGATE

SQLSTATE：42903

GROUP BY 中不允许使用聚合函数，但找到了 <sqlExpr>。

有关更多详细信息，请参阅 GROUP_BY_AGGREGATE

GROUP_BY_POS_AGGREGATE

SQLSTATE：42903

GROUP BY <index> 引用了包含聚合函数的表达式 <aggExpr>。 GROUP BY 中不允许使用聚合函数。

GROUP_BY_POS_OUT_OF_RANGE

SQLSTATE：42805

GROUP BY 位置 <index> 不在选择列表中（有效范围为 [1, <size>]）。

GROUP_EXPRESSION_TYPE_IS_NOT_ORDERABLE

SQLSTATE：42822

表达式 <sqlExpr> 无法用作分组表达式，因为其数据类型 <dataType> 不是可排序的数据类型。

HLL_INVALID_INPUT_SKETCH_BUFFER

SQLSTATE：22546

对 <function> 的调用无效；仅支持有效的 HLL 草图缓冲区作为输入（例如 hll_sketch_agg 函数生成的缓冲区）。

HLL_INVALID_LG_K

SQLSTATE：22546

对 <function> 的调用无效；lgConfigK 值必须介于 <min> 和 <max> 之间，包括：<value>。

HLL_UNION_DIFFERENT_LG_K

草图具有不同的 lgConfigK 值：<left> 和 <right>。将 allowDifferentLgConfigK 参数设置为 true 以使用不同的 lgConfigK 值调用 <function>。

IDENTIFIER_TOO_MANY_NAME_PARTS

<identifier> 不是有效的标识符，因为它的名称部分超过 2 个。

INCOMPARABLE_PIVOT_COLUMN

SQLSTATE：42818

无效透视列 <columnName>。透视列必须可比较。

INCOMPATIBLE_COLUMN_TYPE

SQLSTATE：42825

只能对具有兼容列类型的表执行 <operator>。 <tableOrdinalNumber> 表的 <columnOrdinalNumber> 列是 <dataType1> 类型，与第一个表同一列的 <dataType2> 不兼容。<hint>。

INCOMPATIBLE_DATASOURCE_REGISTER

检测到不兼容的 DataSourceRegister。请从类路径中删除不兼容的库或升级它。错误：<message>

INCOMPATIBLE_DATA_FOR_TABLE

无法为表 <tableName> 写入不兼容的数据：

有关更多详细信息，请参阅 INCOMPATIBLE_DATA_FOR_TABLE

INCOMPATIBLE_JOIN_TYPES

联接类型 <joinType1> 和 <joinType2> 不兼容。

INCOMPATIBLE_VIEW_SCHEMA_CHANGE

SQLSTATE：51024

视图 <viewName> 的 SQL 查询包含不兼容的架构更改，无法解析列 <colName>。需要名为 <colName> 的 <expectedNum> 列，但收到的列为 <actualCols>。

请尝试通过运行 <suggestion> 重新创建视图。

INCOMPLETE_TYPE_DEFINITION

SQLSTATE：42K01

不完整的复杂类型：

有关更多详细信息，请参阅 INCOMPLETE_TYPE_DEFINITION

INCONSISTENT_BEHAVIOR_CROSS_VERSION

SQLSTATE：42K0B

由于升级到，可能会得到其他结果

有关详细信息，请参阅 INCONSISTENT_BEHAVIOR_CROSS_VERSION

INCORRECT_NUMBER_OF_ARGUMENTS

SQLSTATE：42605

<failure>，<functionName> 至少需要 <minArgs> 个参数，最多需要 <maxArgs> 个参数。

INCORRECT_RAMP_UP_RATE

<rowsPerSecond> rowsPerSecond 的最大偏移量为 <maxSeconds>，但“rampUpTimeSeconds”为 <rampUpTimeSeconds>。

INDEX_ALREADY_EXISTS

无法在表 <tableName> 上创建索引 <indexName>，因为它已存在。

INDEX_NOT_FOUND

在表 <tableName> 上找不到索引 <indexName>。

INSERT_COLUMN_ARITY_MISMATCH

SQLSTATE：21S01

无法写入 <tableName>，原因是

有关更多详细信息，请参阅 INSERT_COLUMN_ARITY_MISMATCH

INSERT_PARTITION_COLUMN_ARITY_MISMATCH

SQLSTATE：21S01

无法中写入“<tableName>”，<reason>：

表列：<tableColumns>。

使用静态值对列进行分区：<staticPartCols>。

数据列：<dataColumns>。

INSUFFICIENT_PERMISSIONS

由于对基础安全对象的权限，用户无法对 <securableName> 执行 <action>：

<underlyingReport>

INTERVAL_ARITHMETIC_OVERFLOW

SQLSTATE：22015

<message>。<alternative>

INTERVAL_DIVIDED_BY_ZERO

SQLSTATE：22012

被零除。使用 try_divide 容许除数为 0，并返回 NULL。

INVALID_ARRAY_INDEX

索引 <indexValue> 超出界限。数组具有 <arraySize> 个元素。使用 SQL 函数 get() 容许访问无效索引上的元素，并改为返回 NULL。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

有关更多详细信息，请参阅 INVALID_ARRAY_INDEX

INVALID_ARRAY_INDEX_IN_ELEMENT_AT

索引 <indexValue> 超出界限。数组具有 <arraySize> 个元素。使用 try_element_at 容许访问无效索引上的元素，并返回 NULL。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

有关更多详细信息，请参阅 INVALID_ARRAY_INDEX_IN_ELEMENT_AT

INVALID_BITMAP_POSITION

索引为 0 的位图位置 <bitPosition> 超出边界。位图具有 <bitmapNumBits> 位（<bitmapNumBytes> 字节）。

INVALID_BOUNDARY

边界 <boundary> 无效：<invalidValue>。

有关更多详细信息，请参阅 INVALID_BOUNDARY

INVALID_BUCKET_FILE

无效的桶文件：<path>。

INVALID_BYTE_STRING

SQLSTATE：22P03

预期的格式为 ByteString，但实际为 <unsupported> (<class>)。

INVALID_COLUMN_NAME_AS_PATH

SQLSTATE：46121

数据源 <datasource> 无法保存列 <columnName>，因为它的名称包含文件路径中不允许的某些字符。请使用别名将其重命名。

INVALID_COLUMN_OR_FIELD_DATA_TYPE

列或字段 <name> 的类型是 <type>，但必须是 <expectedType>。

INVALID_CURRENT_RECIPIENT_USAGE

SQLSTATE：42887

要在 Unity Catalog 中定义仅共享视图，current_recipient 函数只能在 CREATE VIEW 语句或 ALTER VIEW 语句中使用。

INVALID_CURSOR

SQLSTATE: HY109

游标无效。

有关更多详细信息，请参阅 INVALID_CURSOR

INVALID_DEFAULT_VALUE

SQLSTATE：42623

无法执行 <statement> 命令，因为目标列或变量 <colName> 具有 DEFAULT 值 <defaultValue>，

有关更多详细信息，请参阅 INVALID_DEFAULT_VALUE

INVALID_DEST_CATALOG

SYNC 命令的目标目录必须位于 Unity Catalog 中。已找到 <catalog>。

INVALID_DRIVER_MEMORY

系统内存 <systemMemory> 必须至少为 <minSystemMemory>。

请在 Spark 配置中使用 -driver-memory 选项或“<config>”增加堆大小。

INVALID_EMPTY_LOCATION

位置名称不能为空字符串，但已给出 <location>。

INVALID_ESC

发现无效的转义字符串：<invalidEscape>。转义字符串只能包含一个字符。

INVALID_ESCAPE_CHAR

EscapeChar 应该是长度为 1 的字符串字面量，但收到了 <sqlExpr>。

INVALID_EXECUTOR_MEMORY

INVALID_FRACTION_OF_SECOND

秒的分数必须为零。有效的范围为 [0, 60]。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

INVALID_HANDLE

SQLSTATE：HY000

句柄 <handle> 无效。

有关更多详细信息，请参阅 INVALID_HANDLE

INVALID_HIVE_COLUMN_NAME

无法创建其列 <columnName> 的名称包含 Hive 元存储中的无效字符 <invalidChars> 的表 <tableName>。

INVALID_IDENTIFIER

标识符 <ident> 无效。请考虑用反引号将其引用为 <ident>。

INVALID_INDEX_OF_ZERO

索引 0 无效。索引应 < 0 或 > 0（第一个元素的索引为 1）。

INVALID_INLINE_TABLE

无效的内联表。

有关更多详细信息，请参阅 INVALID_INLINE_TABLE

INVALID_INVERSE_DISTRIBUTION_FUNCTION

SQLSTATE: 42K0K

逆分布函数 <funcName> 无效。

有关详细信息，请参阅 INVALID_INVERSE_DISTRIBUTION_FUNCTION。

INVALID_JSON_ROOT_FIELD

SQLSTATE：22032

无法将 JSON 根字段转换为目标 Spark 类型。

INVALID_JSON_SCHEMA_MAP_TYPE

SQLSTATE：22032

输入架构 <jsonSchema> 只能包含 STRING 作为 MAP 的键类型。

INVALID_KRYO_SERIALIZER_BUFFER_SIZE

配置“<bufferSizeConfKey>”的值必须小于 2048 MiB，但却为 <bufferSizeConfValue> MiB。

INVALID_LAMBDA_FUNCTION_CALL

SQLSTATE：42K0D

无效的 lambda 函数调用。

有关更多详细信息，请参阅 INVALID_LAMBDA_FUNCTION_CALL

INVALID_LATERAL_JOIN_TYPE

不允许使用具有 LATERAL 关联的 <joinType> JOIN，因为 OUTER 子查询无法与其连接伙伴相关联。删除 LATERAL 关联，或者改用 INNER JOIN 或 LEFT OUTER JOIN。

INVALID_LIMIT_LIKE_EXPRESSION

表达式 <expr> 等限制无效。

有关更多详细信息，请参阅 INVALID_LIMIT_LIKE_EXPRESSION

INVALID_NON_DETERMINISTIC_EXPRESSIONS

运算符需要确定性表达式，但实际表达式为 <sqlExprs>。

INVALID_NUMERIC_LITERAL_RANGE

数值 <rawStrippedQualifier> 超出了 <typeName> 的有效范围，最小值为 <minValue>，最大值为 <maxValue>。请相应地调整值。

INVALID_OBSERVED_METRICS

观察到的指标无效。

有关更多详细信息，请参阅 INVALID_OBSERVED_METRICS

INVALID_OPTIONS

SQLSTATE：42K06

无效选项：

有关更多详细信息，请参阅 INVALID_OPTIONS

INVALID_PANDAS_UDF_PLACEMENT

组聚合 pandas UDF <functionList> 不能与其他非 pandas 聚合函数一起调用。

INVALID_PARAMETER_MARKER_VALUE

提供的参数映射无效：

有关更多详细信息，请参阅 INVALID_PARAMETER_MARKER_VALUE

INVALID_PARAMETER_VALUE

<functionName> 中参数 <parameter> 的值无效：

有关更多详细信息，请参阅 INVALID_PARAMETER_VALUE

INVALID_PARTITION_OPERATION

分区命令无效。

有关更多详细信息，请参阅 INVALID_PARTITION_OPERATION

INVALID_PIPELINE_ID

管道 ID <pipelineId> 无效。

管道 ID 应该是格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”的 UUID

INVALID_PRIVILEGE

SQLSTATE：42852

特权 <privilege> 对于 <securable> 无效。

INVALID_PROPERTY_KEY

<key> 是一个无效的属性键，请使用引号，例如 SET <key>=<value>。

INVALID_PROPERTY_VALUE

<value> 是一个无效的属性值，请使用引号，例如 SET <key>=<value>

INVALID_QUERY_MIXED_QUERY_PARAMETERS

参数化查询必须使用位置参数或命名参数，但不能同时使用这两种参数。

INVALID_S3_COPY_CREDENTIALS

COPY INTO 凭据必须包括 AWS_ACCESS_KEY、AWS_SECRET_KEY 和 AWS_SESSION_TOKEN。

INVALID_SAVE_MODE

指定的保存模式 <mode> 无效。有效的保存模式包括“append”、“overwrite”、“ignore”、“error”、“errorifexists”和“default”。

INVALID_SCHEMA

SQLSTATE：42K07

输入架构 <inputSchema> 不是有效的架构字符串。

有关更多详细信息，请参阅 INVALID_SCHEMA

INVALID_SCHEMA_OR_RELATION_NAME

<name> 不是表/架构的有效名称。有效名称仅包含字母字符、数字和 _。

INVALID_SCHEME

SQLSTATE：0AKUC

Unity Catalog 不支持 <name> 作为默认文件方案。

INVALID_SECRET_LOOKUP

SQLSTATE：22531

机密查找无效：

有关更多详细信息，请参阅 INVALID_SECRET_LOOKUP

INVALID_SET_SYNTAX

预期格式为“SET”、“SET key”或“SET key=value”。如果你要在键中包含特殊字符，或者在值中包含分号，请使用反引号，例如 SET key=value。

INVALID_SHARED_ALIAS_NAME

<sharedObjectType> 别名必须采用“schema.name”格式。

INVALID_SOURCE_CATALOG

源目录不得位于 SYNC 命令的 Unity Catalog 中。已找到 <catalog>。

INVALID_SQL_ARG

SQLSTATE：42K08

sql() 的参数 <name> 无效。请考虑将其替换为 SQL 文本或集合构造函数 (如 map()、array()、struct())。

INVALID_SQL_SYNTAX

无效的 SQL 语法：

有关更多详细信息，请参阅 INVALID_SQL_SYNTAX

INVALID_STAGING_PATH_IN_STAGING_ACCESS_QUERY

暂存 <operation> 查询中的暂存路径无效：<path>

INVALID_STATEMENT_FOR_EXECUTE_INTO

SQLSTATE: 07501

EXECUTE IMMEDIATE 的 INTO 子句仅适用于查询，但给定语句不是查询：<sqlString>。

INVALID_SUBQUERY_EXPRESSION

SQLSTATE：42823

子查询无效：

有关更多详细信息，请参阅 INVALID_SUBQUERY_EXPRESSION

INVALID_TEMP_OBJ_REFERENCE

SQLSTATE：42K0F

无法创建类型为 <obj> 的持久对象 <objName>，因为该对象引用了类型为 <tempObj> 的临时对象 <tempObjName>。请将临时对象 <tempObjName> 设为持久对象，或将持久对象 <objName> 设为临时对象。

INVALID_TIMESTAMP_FORMAT

提供的时间戳 <timestamp> 与预期的语法 <format> 不匹配。

INVALID_TIME_TRAVEL_SPEC

在按时间顺序查看表时，无法同时指定版本和时间戳。

INVALID_TIME_TRAVEL_TIMESTAMP_EXPR

时间回溯时间戳表达式 <expr> 无效。

有关更多详细信息，请参阅 INVALID_TIME_TRAVEL_TIMESTAMP_EXPR

INVALID_TYPED_LITERAL

类型化文本 <valueType> 的值无效：<value>。

INVALID_UDF_IMPLEMENTATION

SQLSTATE：38000

函数 <funcName> 未实现 ScalarFunction 和 AggregateFunction。

INVALID_UPGRADE_SYNTAX

<command><supportedOrNot> 源表在 Hive 元存储中，而目标表在 Unity Catalog 中。

INVALID_URL

SQLSTATE：22P02

URL 无效：<url>。如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

INVALID_USAGE_OF_STAR_OR_REGEX

在 <prettyName> 中使用的 <elem> 无效。

INVALID_UUID

输入 <uuidInput> 不是有效的 UUID。

UUID 应采用“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”格式

请检查 UUID 的格式。

INVALID_VARIABLE_TYPE_FOR_QUERY_EXECUTE_IMMEDIATE

变量类型必须是字符串类型，但实际类型是 <varType>。

INVALID_WHERE_CONDITION

SQLSTATE：42903

WHERE 条件 <condition> 包含无效表达式：<expressionList>。

重写查询以避免 WHERE 子句中的窗口函数、聚合函数和生成器函数。

INVALID_WINDOW_SPEC_FOR_AGGREGATION_FUNC

无法为 <aggFunc> 指定 ORDER BY 或窗口框架。

INVALID_WRITER_COMMIT_MESSAGE

SQLSTATE：42KDE

数据源写入器生成了无效数量的提交消息。每个任务中应仅有一条写入器提交消息，但收到了 <detail>。

INVALID_WRITE_DISTRIBUTION

请求的写入分发无效。

有关详细信息，请参阅 INVALID_WRITE_DISTRIBUTION

JOIN_CONDITION_IS_NOT_BOOLEAN_TYPE

联接条件 <joinCondition> 的 <conditionType> 类型无效，应为“BOOLEAN”。

KINESIS_COULD_NOT_READ_SHARD_UNTIL_END_OFFSET

在以下 Kinesis 流的分片 <shardId> 达到所需的序列号 <endSeqNum> 之前无法读取：

使用使用者模式 <consumerMode> 的 kinesis 流 <stream>。由于潜在的数据丢失，此

查询将失败。最后读取记录的序列号为 <lastSeqNum>。

如果存在以下条件，则可能会发生这种情况：具有 endSeqNum 的数据已过期，或者 Kinesis 流已

删除并以相同名称进行了重建。可以

在 spark 配置中将 spark.databricks.kinesis.failOnDataLoss 设置为 false 替代此失败行为。

KINESIS_FETCHED_SHARD_LESS_THAN_TRACKED_SHARD

从 Kinesis 提取的最小 shardId (<fetchedShardId>)

小于跟踪的最小 shardId (<trackedShardId>)。

此为意外错误，当删除 Kinesis 流并使用相同的名称重新创建，

并使用现有检查点位置重启使用此 Kinesis 流的流式处理查询时，会发生这种情况。

使用新的检查点位置重启流式处理查询，或使用新名称创建流。

KRYO_BUFFER_OVERFLOW

SQLSTATE：54006

Kryo 序列化失败：<exceptionMsg>。若要避免这种情况，请增加“<bufferSizeConfKey>”值。

LOAD_DATA_PATH_NOT_EXISTS

LOAD DATA 输入路径不存在：<path>。

LOCAL_MUST_WITH_SCHEMA_FILE

LOCAL 必须与 file 的架构配合使用，但收到了：<actualSchema>。

LOCATION_ALREADY_EXISTS

无法将托管表命名为 <identifier>，因为它的关联位置 <location> 已存在。请选择其他表名，或者先删除现有位置。

LOST_TOPIC_PARTITIONS_IN_END_OFFSET_WITH_TRIGGER_AVAILABLENOW

在使用 Trigger.AvailableNow 运行查询期间，Kafka 主题中某些分区丢失。此错误可能是暂时性的 - 请重启查询，如果仍然看到相同问题，请予以报告。

最新偏移量 <tpsForLatestOffset> 的主题分区，结束偏移量 <tpsForEndOffset> 的主题分区

MALFORMED_AVRO_MESSAGE

在消息反序列化中检测到格式错误的 Avro 消息。分析模式：<mode>。若要将格式错误的 Avro 消息作为 null 结果进行处理，请尝试将选项“mode”设置为“PERMISSIVE”。

MALFORMED_CSV_RECORD

CSV 记录的格式错误：<badRecord>

MALFORMED_RECORD_IN_PARSING

在记录分析中检测到格式错误的记录：<badRecord>。

分析模式：<failFastMode>。若要将格式错误的记录作为 null 结果处理，请尝试将选项“mode”设置为“PERMISSIVE”。

有关更多详细信息，请参阅 MALFORMED_RECORD_IN_PARSING

MANAGED_TABLE_WITH_CRED

不支持使用存储凭据创建托管表。

MATERIALIZED_VIEW_MESA_REFRESH_WITHOUT_PIPELINE_ID

无法对具体化视图运行 <refreshType>，因为它之前包含 pipelineId。若要启用 <refreshType>，请删除再重新创建具体化视图。

MATERIALIZED_VIEW_OPERATION_NOT_ALLOWED

不允许具体化视图操作 <operation>：

有关更多详细信息，请参阅 MATERIALIZED_VIEW_OPERATION_NOT_ALLOWED

MATERIALIZED_VIEW_OUTPUT_WITHOUT_EXPLICIT_ALIAS

必须显式为具体化视图中的输出表达式 <expression> 指定别名。

MAX_NUMBER_VARIABLES_IN_SESSION_EXCEEDED

SQLSTATE: 54KD1

无法创建新变量 <variableName>，因为会话中的变量数超过允许的最大数目 (<maxNumVariables>)。

MAX_RECORDS_PER_FETCH_INVALID_FOR_KINESIS_SOURCE

maxRecordsPerFetch 必须是小于或等于 <kinesisRecordLimit> 的正整数

MERGE_CARDINALITY_VIOLATION

SQLSTATE：23K01

MERGE 语句的 ON 搜索条件将目标表中的单行与源表的多行匹配。

这可能会导致对目标行执行多次更新或删除操作，这是不允许的。

MISMATCHED_TOPIC_PARTITIONS_BETWEEN_END_OFFSET_AND_PREFETCHED

Trigger.AvailableNow 中的 Kafka 数据源应在预提取的偏移量中提供相同的主题分区给每个微批的结束偏移量。此错误可能是暂时性的 - 请重启查询，如果仍然看到相同问题，请予以报告。

预提取偏移量 <tpsForPrefetched> 的主题分区，结束偏移量 <tpsForEndOffset> 的主题分区。

MISSING_AGGREGATION

非聚合表达式 <expression> 基于不参与 GROUP BY 子句的列。

将列或表达式添加到 GROUP BY、聚合表达式，或者在不关心返回组中哪些值时使用 <expressionAnyValue>。

有关更多详细信息，请参阅 MISSING_AGGREGATION

MISSING_CONNECTION_OPTION

“<connectionType>”类型的连接必须包括以下选项：<requiredOptions>。

MISSING_GROUP_BY

查询不包含 GROUP BY 子句。添加 GROUP BY 或使用 OVER 子句将其转换为窗口函数。

MISSING_NAME_FOR_CHECK_CONSTRAINT

CHECK 约束必须具有名称。

MISSING_PARAMETER_FOR_KAFKA

SQLSTATE：42KDD

参数 <parameterName> 对于 Kafka 是必需的，但未在 <functionName> 中指定。

MISSING_PARAMETER_FOR_ROUTINE

SQLSTATE：42KDD

需要参数 <parameterName>，但未在 <functionName> 中指定。

MODIFY_BUILTIN_CATALOG

SQLSTATE：42832

不支持修改内置目录 <catalogName>。

MULTIPLE_LOAD_PATH

Databricks Delta 在 load() API 中不支持多个输入路径。

路径：<pathList>。若要通过从同一 Delta 表加载多个路径来

生成单个数据帧，请加载

具有相应分区筛选器的 Delta 表。如果多个路径

来自不同的 Delta 表，请使用数据集的 union()/unionByName() API

来合并由单独的 load() API 调用生成的数据帧。

MULTIPLE_MATCHING_CONSTRAINTS

SQLSTATE：42891

找到至少两个与给定条件匹配的约束。

MULTIPLE_TIME_TRAVEL_SPEC

无法在按时间顺序查看子句和选项中指定按时间顺序查看。

MULTIPLE_XML_DATA_SOURCE

检测到多个名为 <provider> (<sourceNames>) 的数据源。请指定完全限定的类名，或者从类路径中删除 <externalSource>。

MULTI_SOURCES_UNSUPPORTED_FOR_EXPRESSION

表达式 <expr> 不支持多个源。

MULTI_UDF_INTERFACE_ERROR

不允许实现多个 UDF 接口，UDF 类 <className>。

MUTUALLY_EXCLUSIVE_CLAUSES

子句 <clauses> 或选项互斥。请删除其中的一个子句。

MV_ST_ALTER_QUERY_INCORRECT_BACKING_TYPE

输入查询需要 <expectedType>，但基础表是 <givenType>。

NAMED_PARAMETERS_NOT_SUPPORTED

函数 <functionName> 不支持命名参数；请改为使用函数调用的位置参数重试查询。

NAMED_PARAMETERS_NOT_SUPPORTED_FOR_SQL_UDFS

无法调用函数 <functionName>，因为不支持 SQL UDF 的命名参数引用。在此情况下，命名参数引用为 <argument>。

NAMED_PARAMETER_SUPPORT_DISABLED

无法调用函数 <functionName>，因为此处未启用命名参数引用。

在此情况下，命名参数引用为 <argument>。

将“spark.sql.allowNamedFunctionArguments”设置为“true”以启用功能。

NAMESPACE_ALREADY_EXISTS

无法创建命名空间 <nameSpaceName>，因为它已存在。

选择其他名称、删除现有命名空间，或添加 IF NOT EXISTS 子句以容许现有的命名空间。

NAMESPACE_NOT_EMPTY

无法删除命名空间 <nameSpaceNameName>，因为它包含对象。

使用 DROP NAMESPACE ... CASCADE 删除命名空间及其所有对象。

NAMESPACE_NOT_FOUND

必须为透视值提供文本表达式，但找到的是 <expression>。

NON_PARTITION_COLUMN

PARTITION 子句不能包含非分区列：<columnName>。

NON_TIME_WINDOW_NOT_SUPPORTED_IN_STREAMING

SQLSTATE：42KDE

流式处理数据帧/数据集的 <windowFunc>（如列 <columnName>）不支持窗口函数。

结构化流式处理仅支持使用 WINDOW 函数的时间窗口聚合。（窗口规范：<windowSpec>）

NOT_ALLOWED_IN_FROM

函数名称：<funcName>；别名数：<aliasesNum>；输出列数：<outColsNum>。

OAUTH_CUSTOM_IDENTITY_CLAIM_NOT_PROVIDED

SQLSTATE：22KD2

未提供自定义标识声明。

ONLY_SECRET_FUNCTION_SUPPORTED_HERE

此 <location> 不支持调用函数 <functionName>；此处支持 <supportedFunctions>。

OPERATION_CANCELED

SQLSTATE: HY008

操作已取消。

OPERATION_REQUIRES_UNITY_CATALOG

SQLSTATE：0AKUD

操作 <operation> 需要启用 Unity Catalog。

OP_NOT_SUPPORTED_READ_ONLY

SQLSTATE：42KD1

<plan> 在只读会话模式下不受支持。

ORDER_BY_POS_OUT_OF_RANGE

SQLSTATE：42805

ORDER BY 位置 <index> 不在选择列表中（有效范围为 [1, <size>]）。

PARSE_EMPTY_STATEMENT

SQLSTATE：42617

语法错误，意外空语句。

PARSE_SYNTAX_ERROR

<error><hint> 位置或附近有语法错误。

PARTITIONS_ALREADY_EXIST

SQLSTATE：428FT

无法在表 <tableName> 中添加 (ADD) 或重命名 (RENAME TO) 分区 <partitionList>，因为它们已存在。

选择其他名称、删除现有分区，或添加 IF NOT EXISTS 子句以容许现有的分区。

PARTITIONS_NOT_FOUND

SQLSTATE：428FT

在表 <tableName> 中找不到分区 <partitionList>。

请验证分区规范和表名。

若要容许删除时出错，请使用 ALTER TABLE ... DROP IF EXISTS PARTITION。

PARTITION_LOCATION_ALREADY_EXISTS

表 <tableName> 中已存在分区位置 <locationPath>。

PARTITION_LOCATION_IS_NOT_UNDER_TABLE_DIRECTORY

无法访问被引用表，因为以前分配的列掩码当前与表架构不兼容；若要继续，请联系表的所有者以更新策略：

有关更多详细信息，请参阅 QUERIED_TABLE_INCOMPATIBLE_WITH_COLUMN_MASK_POLICY

QUERIED_TABLE_INCOMPATIBLE_WITH_ROW_LEVEL_SECURITY_POLICY

RESERVED_CDC_COLUMNS_ON_WRITE

写入包含保留列 <columnList>，这些列

在内部用作更改数据馈送的元数据。若要写入表，可以重命名/删除

这些列，或者将

<config> 设置为 false 来禁用表上的更改数据馈送。

RESTRICTED_STREAMING_OPTION_PERMISSION_ENFORCED

选项 <option> 在 <source> 源的共享群集上具有受限值。

有关详细信息，请参阅 RESTRICTED_STREAMING_OPTION_PERMISSION_ENFORCED

ROUTINE_ALREADY_EXISTS

SQLSTATE：42723

无法创建函数 <routineName>，因为它已存在。

选择其他名称、删除或替换现有函数，或者添加 IF NOT EXISTS 子句以容许现有的函数。

ROUTINE_NOT_FOUND

找不到函数 <routineName>。请验证架构和目录的拼写和正确性。

如果未使用架构和目录限定名称，请验证 current_schema() 输出，或使用正确的架构和目录限定名称。

若要容许删除时出错，请使用 DROP FUNCTION IF EXISTS。

ROUTINE_PARAMETER_NOT_FOUND

函数 <functionName> 不支持位置 <pos> 处指定的参数 <parameterName>。<suggestion>

ROUTINE_USES_SYSTEM_RESERVED_CLASS_NAME

无法创建函数 <routineName>，因为指定的类名“<className>”保留供系统使用。请重命名该类，然后重试。

ROW_LEVEL_SECURITY_CHECK_CONSTRAINT_UNSUPPORTED

不支持使用行级别安全策略对表 <tableName> 创建 CHECK 约束。

ROW_LEVEL_SECURITY_DUPLICATE_COLUMN_NAME

SQLSTATE：42734

<statementType> 语句尝试将行级别安全策略分配到某个表，但两个或更多个被引用列具有相同的名称 <columnName>，这是无效操作。

ROW_LEVEL_SECURITY_FEATURE_NOT_SUPPORTED

不支持 <tableName> 的行级别安全策略：

有关更多详细信息，请参阅 ROW_LEVEL_SECURITY_FEATURE_NOT_SUPPORTED

使用序号位置将其添加到 GROUP BY，或者将其包装在 first()（或 first_value）中（如果你不在意收到的值）。

SCALAR_SUBQUERY_TOO_MANY_ROWS

SQLSTATE：21000

用作表达式的子查询返回了多个行。

SCHEMA_ALREADY_EXISTS

SQLSTATE：42P06

无法创建架构 <schemaName>，因为它已存在。

选择其他名称、删除现有架构，或添加 IF NOT EXISTS 子句以容许现有的架构。

SCHEMA_NOT_EMPTY

SQLSTATE：2BP01

无法删除架构 <schemaName>，因为它包含对象。

使用 DROP SCHEMA … CASCADE 删除架构及其所有对象。

SCHEMA_NOT_FOUND

找不到架构 <schemaName>。请验证架构和目录的拼写和正确性。

如果你未使用目录限定名称，请验证 current_schema() 输出，或使用正确的目录限定名称。

若要容许删除时出错，请使用 DROP SCHEMA IF EXISTS。

SCHEMA_REGISTRY_CONFIGURATION_ERROR

SQLSTATE：42K0G

无法初始化架构注册表中的架构。 <reason>。

SECOND_FUNCTION_ARGUMENT_NOT_INTEGER

<functionName> 函数的第二个参数需是整数。

SECRET_FUNCTION_INVALID_LOCATION

使用 GROUP BY 和序号位置时，不允许在选择列表中使用星号 (*)。

STATIC_PARTITION_COLUMN_IN_INSERT_COLUMN_LIST

SQLSTATE：42713

列列表中还指定了静态分区列 <staticName>。

STDS_COMMITTED_BATCH_UNAVAILABLE

SQLSTATE：KD006

未找到提交的批处理，检查点位置：<checkpointLocation>。在停止之前，请确保查询已运行并提交任何微批次。

STDS_CONFLICT_OPTIONS

这些选项 <options> 不能一起指定。请指定一个。

STDS_FAILED_TO_READ_STATE_SCHEMA

未能读取状态架构。文件不存在，或者文件已损坏。选项：<sourceOptions>。

请重新运行流式处理查询以构造状态架构，如果错误仍然存在，则向相应的社区或供应商报告。

STDS_INVALID_OPTION_VALUE

需要刷新流式处理表 <tableName>。请运行 CREATE OR REFRESH STREAMING TABLE <tableName> AS 来更新该表。

STREAMING_TABLE_NOT_SUPPORTED

只能在增量实时表和 Databricks SQL 仓库中创建和刷新流式处理表。

STREAMING_TABLE_OPERATION_NOT_ALLOWED

不允许 <operation> 操作：

有关更多详细信息，请参阅 STREAMING_TABLE_OPERATION_NOT_ALLOWED

STREAMING_TABLE_QUERY_INVALID

只能从流式处理查询创建流式处理表 <tableName>。请将 STREAM 关键字添加到 FROM 子句，以将此关系转换为流式处理查询。

STREAM_NOT_FOUND_FOR_KINESIS_SOURCE

SQLSTATE：42K02

在 <region> 中找不到 Kinesis 流 <streamName>。

请启动指向正确流名称的新查询。

SUM_OF_LIMIT_AND_OFFSET_EXCEEDS_MAX_INT

LIMIT 子句和 OFFSET 子句的总和不得大于最大 32 位整数值 (2,147,483,647)，但发现限值 = <limit>，偏移值 = <offset>。

SYNC_METADATA_DELTA_ONLY

仅 delta 表支持修复表同步元数据命令。

SYNC_METADATA_NOT_SUPPORTED

SQLSTATE：0AKUD

仅 Unity Catalog 表支持修复表同步元数据命令。

SYNC_SRC_TARGET_TBL_NOT_SAME

SQLSTATE：42KD2

源表名 <srcTable> 必须与目标表名 <destTable> 相同。

TABLE_OR_VIEW_ALREADY_EXISTS

SQLSTATE：42P07

无法创建表或视图 <relationName>，因为它已存在。

选择其他名称、删除或替换现有对象、添加 IF NOT EXISTS 子句以容许预先存在的对象，或添加 OR REFRESH 子句来刷新现有的流式处理表。

TABLE_OR_VIEW_NOT_FOUND

找不到表或视图 <relationName>。请验证架构和目录的拼写和正确性。

如果未使用架构限定名称，请验证 current_schema() 输出，或使用正确的架构和目录限定名称。

若要容许删除时出错，请使用 DROP VIEW IF EXISTS 或 DROP TABLE IF EXISTS。

有关更多详细信息，请参阅 TABLE_OR_VIEW_NOT_FOUND

TABLE_VALUED_ARGUMENTS_NOT_YET_IMPLEMENTED_FOR_SQL_FUNCTIONS

无法对带有 TABLE 参数的 SQL 用户定义函数 <functionName> 执行 <action>，因为此功能尚未实现。

TABLE_VALUED_FUNCTION_FAILED_TO_ANALYZE_IN_PYTHON

SQLSTATE：38000

无法分析 Python 用户定义表函数：<msg>

TABLE_VALUED_FUNCTION_REQUIRED_METADATA_INCOMPATIBLE_WITH_CALL

无法评估表函数 <functionName>，因为其表元数据为 <requestedMetadata>，但函数调用 <invalidFunctionCallProperty>。

TABLE_VALUED_FUNCTION_REQUIRED_METADATA_INVALID

无法评估表函数 <functionName>，因为其表元数据无效；<reason>。

TABLE_VALUED_FUNCTION_TOO_MANY_TABLE_ARGUMENTS

请改为使用同一表提供程序的 CREATE CONNECTION 命令创建联合数据源连接，然后使用 CREATE FOREIGN CATALOG 命令创建基于连接的目录以引用其中的表。

UC_HIVE_METASTORE_FEDERATION_NOT_ENABLED

UC_VOLUME_NOT_FOUND

卷 <name> 不存在。请使用“SHOW VOLUMES”列出可用卷。

UDF_ERROR

SQLSTATE：未分配

函数 <fn> 执行失败

有关更多详细信息，请参阅 UDF_ERROR

UDF_LIMITS

SQLSTATE：54KD0

违反了一个或多个 UDF 限制。

有关更多详细信息，请参阅 UDF_LIMITS

UDF_MAX_COUNT_EXCEEDED

SQLSTATE：54KD0

超出了 <maxNumUdfs> 个 UDF 的查询范围 UDF 限制（公共预览期间受限制）。已找到 <numUdfs>。 UDF 为：<udfNames>。

UDF_PYSPARK_UNSUPPORTED_TYPE

处于共享访问模式的群集不支持 PySpark UDF <udf> (<eval-type>)。

UDF_UNSUPPORTED_PARAMETER_DEFAULT_VALUE

用户定义的 <functionType> 函数不支持参数默认值。

UDF_USER_CODE_ERROR

SQLSTATE：39000

函数 <fn> 执行失败。

有关更多详细信息，请参阅 UDF_USER_CODE_ERROR

UDTF_ALIAS_NUMBER_MISMATCH

SQLSTATE：42802

AS 子句中提供的别名数与 UDTF 输出的列数不一致。

需要 <aliasesNames> 别名，但收到了 <aliasesSize>。

请确保提供的别名数与 UDTF 输出的列数一致。

UDTF_INVALID_ALIAS_IN_REQUESTED_ORDERING_STRING_FROM_ANALYZE_METHOD

SQLSTATE：42802

未能计算用户定义的表函数，因为其“analyze”方法返回了请求的 OrderingColumn，其列名表达式包含不必要的别名 <aliasName>；请删除此别名，然后再次尝试查询。

UDTF_PYSPARK_NOT_SUPPORTED

处于共享访问模式的群集不支持 PySpark UDTF。若要继续，请改为创建单用户群集并重新运行笔记本。

UNABLE_TO_ACQUIRE_MEMORY

SQLSTATE：53200

无法获取内存的 <requestedBytes> 字节，收到了 <receivedBytes>。

UNABLE_TO_CONVERT_TO_PROTOBUF_MESSAGE_TYPE

SQLSTATE：42K0G

无法将 SQL 类型 <toType> 转换为 Protobuf 类型 <protobufType>。

UNABLE_TO_FETCH_HIVE_TABLES

无法提取 Hive 数据库 <dbName> 的表。

UNABLE_TO_INFER_SCHEMA

无法推理 <format> 的架构。必须手动指定。

UNAUTHORIZED_ACCESS

未授权访问：

<report>

UNBOUND_SQL_PARAMETER

SQLSTATE：42P02

找到未绑定的参数：<name>。请修复 args 并提供对 SQL 文本或集合构造函数 (例如 map()、array()、struct()) 的映射参数。

UNCLOSED_BRACKETED_COMMENT

找到未闭合的方括号注释。请在注释的末尾追加 */。

UNEXPECTED_INPUT_TYPE

函数 <functionName> 的参数 <paramIndex> 需要 <requiredType> 类型，但 <inputSql> 的类型为 <inputType>。

UNEXPECTED_OPERATOR_IN_STREAMING_VIEW

SQLSTATE: 42KDD

CREATE VIEW 语句中作为流式处理源的意外运算符 <op>。

流式处理视图查询只能包含 SELECT、WHERE 和 UNION ALL 操作。

UNEXPECTED_POSITIONAL_ARGUMENT

无法调用函数 <functionName>，因为它在分配到 <parameterName> 的已命名参数之后包含位置参数；请重新排列它们，使位置参数排在前面，然后重试查询。

UNEXPECTED_SERIALIZER_FOR_CLASS

类 <className> 具有意外的表达式序列化程序。预期返回“STRUCT”的“STRUCT”或“IF”，但找到了 <expr>。

UNKNOWN_FIELD_EXCEPTION

分析期间遇到未知字段 <unknownFieldBlob>，可通过自动重试将其修复：<isRetryable>

有关更多详细信息，请参阅 UNKNOWN_FIELD_EXCEPTION

UNKNOWN_POSITIONAL_ARGUMENT

函数 <functionName> 的调用在位置 <pos> 处包含一个未知的位置自变量 <sqlExpr>。这是无效的。

UNKNOWN_PROTOBUF_MESSAGE_TYPE

SQLSTATE：42K0G

尝试将 <descriptorName> 视为消息，但它是 <containingType>。

UNPIVOT_REQUIRES_ATTRIBUTES

SQLSTATE：42K0A

当未给定 <empty> 表达式时，UNPIVOT 要求所有给定的 <given> 表达式都是列。这些表达式不是列：[<expressions>]。

UNPIVOT_REQUIRES_VALUE_COLUMNS

SQLSTATE：42K0A

至少需要为 UNPIVOT 指定一个值列，所有列均指定为 ID。

UNPIVOT_VALUE_DATA_TYPE_MISMATCH

逆透视值列必须共享一个最不常见的类型，不包括某些类型：[<types>]。

UNPIVOT_VALUE_SIZE_MISMATCH

SQLSTATE：428C4

所有逆透视值列的大小必须与值列名称 (<names>) 相同。

UNRECOGNIZED_PARAMETER_NAME

无法调用函数 <functionName>，因为函数调用包含名为 <argumentName> 的参数的命名参数引用，但此函数不包括任何包含具有此名称的参数的签名。你是否指以下其中一项？ [<proposal>]。

UNRECOGNIZED_SQL_TYPE

无法识别的 SQL 类型 - 名称：<typeName>，ID：<jdbcType>。

UNRESOLVABLE_TABLE_VALUED_FUNCTION

无法将 <name> 解析为表值函数。

请确保 <name> 定义为表值函数，并且正确提供了所有必需的参数。

如果未定义 <name>，请在使用表值函数之前创建它。

有关定义表值函数的详细信息，请参阅 Apache Spark 文档。

UNRESOLVED_ALL_IN_GROUP_BY

无法基于 select 子句推断 GROUP BY ALL 的分组列。请显式指定分组列。

UNRESOLVED_COLUMN

无法解析名称为 <objectName> 的列、变量或函数参数。

有关更多详细信息，请参阅 UNRESOLVED_COLUMN

UNRESOLVED_FIELD

无法使用结构类型列 <columnPath> 解析具有名称 <fieldName> 的字段。

有关更多详细信息，请参阅 UNRESOLVED_FIELD

UNRESOLVED_MAP_KEY

无法将列 <objectName> 解析为映射键。如果键是字符串字面量，请在其两侧添加单引号 ''。

有关更多详细信息，请参阅 UNRESOLVED_MAP_KEY

UNRESOLVED_ROUTINE

无法解析搜索路径 <searchPath> 上的函数 <routineName>。

有关更多详细信息，请参阅 UNRESOLVED_ROUTINE

UNRESOLVED_USING_COLUMN_FOR_JOIN

无法解析联接的 <side> 一侧的 USING 列 <colName>。 <side> 一侧的列：[<suggestion>]。

UNRESOLVED_VARIABLE

无法解析搜索路径 <searchPath> 上的变量 <variableName>。

SQLSTATE：42621

无法使用生成表达式 <expressionStr> 创建生成的列 <fieldName>，因为 <reason>。

UNSUPPORTED_EXPR_FOR_OPERATOR

查询运算符包含一个或多个不受支持的表达式。

考虑重写该查询，以避免 WHERE 子句中的窗口函数、聚合函数和生成器函数。

无效的表达式：[<invalidExprSqls>]

UNSUPPORTED_EXPR_FOR_PARAMETER

查询参数包含不受支持的表达式。

参数可以是变量或文本。

无效表达式：[<invalidExprSql>]

UNSUPPORTED_EXPR_FOR_WINDOW

SQLSTATE：42P20

窗口函数中不支持表达式 <sqlExpr>。

UNSUPPORTED_FEATURE

不支持该功能：

有关详细信息，请参阅 UNSUPPORTED_FEATURE

UNSUPPORTED_FN_TYPE

不支持的用户定义函数类型：<language>

UNSUPPORTED_GENERATOR

不支持生成器：

有关详细信息，请参阅 UNSUPPORTED_GENERATOR

UNSUPPORTED_GROUPING_EXPRESSION

grouping()/grouping_id() 只能与 GroupingSets/Cube/Rollup 结合使用。

UNSUPPORTED_INITIAL_POSITION_AND_TRIGGER_PAIR_FOR_KINESIS_SOURCE

SQLSTATE：42616

Kinesis 源不支持初始位置为 <initialPosition> 的 <trigger>

UNSUPPORTED_INSERT

无法插入目标。

有关更多详细信息，请参阅 UNSUPPORTED_INSERT

UNSUPPORTED_MANAGED_TABLE_CREATION

不支持使用数据源 <dataSource> 创建托管表 <tableName>。需要使用数据源 DELTA 或使用 CREATE EXTERNAL TABLE <tableName>，使用 <dataSource> 创建外部表

UNSUPPORTED_MERGE_CONDITION

MERGE 操作包含不受支持的 <condName> 条件。

有关更多详细信息，请参阅 UNSUPPORTED_MERGE_CONDITION

UNSUPPORTED_NESTED_ROW_OR_COLUMN_ACCESS_POLICY

表 <tableName> 包含的行级别安全策略或列掩码间接引用了另一个包含行级别安全策略或列掩码的表；这种情况不受支持。调用序列：<callSequence>

UNSUPPORTED_OVERWRITE

SQLSTATE：42902

无法覆盖正在读取的目标。

有关更多详细信息，请参阅 UNSUPPORTED_OVERWRITE

UNSUPPORTED_SAVE_MODE

以下对象不支持保存模式 <saveMode>：

有关详细信息，请参阅 UNSUPPORTED_SAVE_MODE

UNSUPPORTED_STREAMING_OPTIONS_FOR_VIEW

使用类型化的 Scala UDF API（没有返回类型参数），例如 udf((x: Int) => x)。
如果输入类型都是非基元，则使用 Java UDF API，例如 udf(new UDF1[String, Integer] { override def call(s: String): Integer = s.length() }, IntegerType)。
将“spark.sql.legacy.allowUntypedScalaUDF”设置为“true”，并谨慎使用此 API。

UPGRADE_NOT_SUPPORTED

SQLSTATE：0AKUC

表不符合从 Hive 元存储升级到 Unity Catalog 的条件。原因:

有关更多详细信息，请参阅 UPGRADE_NOT_SUPPORTED

USER_DEFINED_FUNCTIONS

用户定义函数无效：

有关更多详细信息，请参阅 USER_DEFINED_FUNCTIONS

USER_RAISED_EXCEPTION

SQLSTATE：P0001

<errorMessage>

USER_RAISED_EXCEPTION_PARAMETER_MISMATCH

SQLSTATE：P0001

raise_error() 函数用于引发错误类：<errorClass>，需要参数：<expectedParms>。

提供的参数 <providedParms> 与需要的参数不匹配。

请确保提供所有需要的参数。

USER_RAISED_EXCEPTION_UNKNOWN_ERROR_CLASS

SQLSTATE：P0001

raise_error() 函数用于引发未知错误类：<errorClass>

VARIABLE_ALREADY_EXISTS

SQLSTATE：42723

无法创建变量 <variableName>，因为它已存在。

选择其他名称，或者删除或替换现有变量。

VARIABLE_NOT_FOUND

找不到 <variableName> 变量。请验证架构和目录的拼写和正确性。

如果未使用架构和目录限定名称，请验证 current_schema() 输出，或使用正确的架构和目录限定名称。

若要容许删除时出错，请使用 DROP VARIABLE IF EXISTS。

VIEW_ALREADY_EXISTS

SQLSTATE：42P07

无法创建视图 <relationName>，因为它已存在。

选择其他名称、删除或替换现有对象，或者添加 IF NOT EXISTS 子句以容许现有的对象。

VIEW_EXCEED_MAX_NESTED_DEPTH

SQLSTATE：54K00

视图 <viewName> 的深度超出了最大视图分辨率深度 (<maxNestedDepth>)。

分析已中止以避免错误。若要解决此问题，请尝试增加“spark.sql.view.maxNestedViewDepth”的值。

VIEW_NOT_FOUND

找不到视图 <relationName>。请验证架构和目录的拼写和正确性。

如果未使用架构限定名称，请验证 current_schema() 输出，或使用正确的架构和目录限定名称。

若要容许删除时出错，请使用 DROP VIEW IF EXISTS。

VOLUME_ALREADY_EXISTS

WRONG_COMMAND_FOR_OBJECT_TYPE

操作 <operation> 需要 <requiredType>。但 <objectName> 是 <foundType>。请改用 <alternative>。

WRONG_NUM_ARGS

SQLSTATE：42605

<functionName> 需要 <expectedNum> 个参数，但实际数量为 <actualNum>。

有关更多详细信息，请参阅 WRONG_NUM_ARGS

XML_ROW_TAG_MISSING

SQLSTATE：42KDD

读取 XML 格式的文件需要 <rowTag> 选项。

XML_UNSUPPORTED_NESTED_TYPES

SQLSTATE：0N000

XML 不支持 <innerDataType> 作为内部类型 <dataType>。在 <dataType> 中使用时，请将 <innerDataType> 包装在 StructType 字段中。

XML_WILDCARD_RESCUED_DATA_CONFLICT_ERROR

无法同时启用已获救的数据和通配符列。请删除 wildcardColumnName 选项。

ZORDERBY_COLUMN_DOES_NOT_EXIST

SQLSTATE：42702

不明确的分区列 <column> 可以是 <colMatches>。

DELTA_AMBIGUOUS_PATHS_IN_CREATE_TABLE

CREATE TABLE 包含两个不同的位置：<identifier> 和 <location>。

可以从 CREATE TABLE 语句中删除 LOCATION 子句，或将

<config> 设置为 true 以跳过此检查。

DELTA_ARCHIVED_FILES_IN_LIMIT

SQLSTATE：42KDC

表 <table> 不包含非存档文件中的足够记录，无法满足指定的限制（<limit> 条记录）。

DELTA_ARCHIVED_FILES_IN_SCAN

SQLSTATE：42KDC

在表 <table> 中找到 <numArchivedFiles> 个需要作为此查询的一部分扫描的可能已存档文件。

无法访问已存档的文件。当前存档前时间配置为 <archivalTime>。

请调整查询筛选器以排除所有已存档的文件。

DELTA_BLOCK_COLUMN_MAPPING_AND_CDC_OPERATION

SQLSTATE：42KD4

当表启用了更改数据馈送 (CDF) 并使用 DROP COLUMN 或 RENAME COLUMN 进行了架构更改后，不允许执行操作“<opName>”。

DELTA_BLOOM_FILTER_DROP_ON_NON_EXISTING_COLUMNS

无法删除以下不存在的列的 Bloom 筛选器索引：<unknownColumns>

DELTA_BLOOM_FILTER_OOM_ON_WRITE

SQLSTATE: 82100)

在为以下列编写 bloom 筛选器索引时发生 OutOfMemoryError：<columnsWithBloomFilterIndices>。

可以通过为“numItems”选项选择更小的值、为“fpp”选项选择更大的值或为更少的列编制索引来减少 bloom 筛选器索引的内存占用。

DELTA_CANNOT_CHANGE_DATA_TYPE

SQLSTATE：429BQ

无法更改数据类型：<dataType>

DELTA_CANNOT_CHANGE_LOCATION

无法使用 SET TBLPROPERTIES 更改 Delta 表的“位置”。请改用 ALTER TABLE SET LOCATION。

DELTA_CANNOT_CHANGE_PROVIDER

“provider”是保留的表属性，不能更改。

DELTA_CANNOT_CREATE_BLOOM_FILTER_NON_EXISTING_COL

无法为以下不存在的列创建 Bloom 筛选器索引：<unknownCols>

DELTA_CANNOT_CREATE_LOG_PATH

SQLSTATE：42KD5

无法创建 <path>

DELTA_CANNOT_DESCRIBE_VIEW_HISTORY

无法描述视图的历史记录。

DELTA_CANNOT_DROP_BLOOM_FILTER_ON_NON_INDEXED_COLUMN

无法删除非索引列上的 bloom 筛选器索引：<columnName>

DELTA_CANNOT_EVALUATE_EXPRESSION

无法计算表达式：<expression>

DELTA_CANNOT_FIND_BUCKET_SPEC

需要 Bucket 存储 Delta 表，但在表中找不到 Bucket 规格

DELTA_CANNOT_GENERATE_CODE_FOR_EXPRESSION

无法生成表达式的代码：<expression>

DELTA_CANNOT_MODIFY_APPEND_ONLY

此表配置为仅允许追加。如果你要允许更新或删除，请使用“ALTER TABLE <table_name> SET TBLPROPERTIES (<config>=false)”。

DELTA_CANNOT_MODIFY_TABLE_PROPERTY

用户无法指定 Delta 表配置 <prop>

DELTA_CANNOT_RECONSTRUCT_PATH_FROM_URI

SQLSTATE：22KD1

在事务日志中找到无法转换为相对路径的 uri (<uri>)。

DELTA_CANNOT_RELATIVIZE_PATH

一个无法通过事务日志中找到的当前输入相对化的 (<path>)

无法将所有列用于分区列

DELTA_CANNOT_WRITE_INTO_VIEW

<table> 是视图。不支持对视图的写入。

DELTA_CAST_OVERFLOW_IN_TABLE_WRITE

由于溢出，无法将 <sourceType> 类型值写入 <targetType> 类型列 <columnName>。

对输入值使用 try_cast 以容许溢出并改为返回 NULL。

找不到事务日志中引用的文件 <filePath>。如果已从文件系统中手动删除数据，而不是使用表 DELETE 语句进行删除，则可能会发生这种情况。此请求似乎针对更改数据馈送，如果是这样，当更改数据文件超出保留期并由 VACUUM 语句删除时，可能会发生此错误。有关详细信息，请参阅 <faqPath>

DELTA_CHANGE_TABLE_FEED_DISABLED

SQLSTATE：42807

无法写入到设置了 delta.enableChangeDataFeed 的表。来自 Delta 的更改数据馈送不可用。

DELTA_CHECKPOINT_NON_EXIST_TABLE

无法为不存在的表 <path> 创建检查点。是否手动删除了 _delta_log 目录中的文件？

DELTA_CLONE_AMBIGUOUS_TARGET

提供两条路径作为 CLONE 目标，因此使用哪条路径是不明确的。在提供

路径的同时，还在 <externalLocation> 处提供 CLONE 的外部位置

<targetIdentifier>。

DELTA_CLONE_INCOMPLETE_FILE_COPY

未完全复制文件 (<fileName>)。预期文件大小 <expectedSize>，找到：<actualSize>。若要忽略文件大小检查以继续操作，请将 <config> 设置为 false。

DELTA_CLONE_UNSUPPORTED_SOURCE

克隆源“<name>”不受支持 <mode>，其格式为 <format>。

支持的格式为“delta”、“iceberg”和“parquet”。

DELTA_CLUSTERING_CLONE_TABLE_NOT_SUPPORTED

使用适用于 DBR 版本 < 14.0 的 Liquid 聚类分析的 Delta 表不支持 CLONE。

DELTA_CLUSTERING_COLUMNS_MISMATCH

提供的聚类分析列与现有的表不匹配。

提供的：<providedClusteringColumns>
现有的：<existingClusteringColumns>

DELTA_CLUSTERING_COLUMN_MISSING_STATS

液体聚类分析需要聚类分析列具有统计信息。在统计信息架构中找不到聚类分析列“<columns>”：

<schema>

DELTA_CLUSTERING_CREATE_EXTERNAL_NON_LIQUID_TABLE_FROM_LIQUID_TABLE

不允许从使用液体聚类分析的表目录创建不使用液体聚类分析的外部表；路径：<path>。

DELTA_CLUSTERING_NOT_SUPPORTED

“<operation>”不支持聚类分析。

DELTA_CLUSTERING_PHASE_OUT_FAILED

无法从 INSERT 列找到目标表的列“<targetCol>”：<colNames>。 INSERT 子句必须为目标表的所有列指定值。

DELTA_COLUMN_NOT_FOUND_IN_SCHEMA

在下列位置无法找到 <columnName> 列：

<tableSchema>

DELTA_COLUMN_PATH_NOT_NESTED

<columnPath> 应为嵌套数据类型，但找到的类型为 <other>。正在查找

嵌套字段中 <column> 的索引

DELTA_COLUMN_STRUCT_TYPE_MISMATCH

SQLSTATE：2200G

结构列 <source> 无法插入到 <targetTable> 中的 <targetType> 字段 <targetField>。

DELTA_COMPACTION_VALIDATION_FAILED

路径 <compactedPath> 到 <newPath> 的压缩验证失败：请提交 bug 报告。

DELTA_COMPLEX_TYPE_COLUMN_CONTAINS_NULL_TYPE

SQLSTATE：22005

在数据类型为 <dataType> 的 <columName> 列中找到嵌套的 NullType。 Delta 不支持在复杂类型中写入 NullType。

DELTA_CONFLICT_SET_COLUMN

这些 SET 列之间存在冲突：<columnList>。

DELTA_CONSTRAINT_ALREADY_EXISTS

约束“<constraintName>”已存在。请先删除旧约束。

旧约束：

<oldConstraint>

DELTA_CONSTRAINT_DOES_NOT_EXIST

无法从表 <tableName> 中删除不存在的约束 <constraintName>。若要避免引发错误，请提供参数 IF EXISTS 或将 SQL 会话配置 <config> 设置为 <confValue>。

DELTA_CONVERSION_NO_PARTITION_FOUND

SQLSTATE：42KD6

在目录中找不到表 <tableName> 的分区信息。你是否已对该表运行“MSCK REPAIR TABLE”来发现分区？

DELTA_CONVERSION_UNSUPPORTED_COLUMN_MAPPING

使用 CONVERT TO DELTA 时，无法将配置“<config>”设置为 <mode>。

DELTA_CONVERT_NON_PARQUET_TABLE

CONVERT TO DELTA 仅支持 Parquet 表，但你尝试转换 <sourceName> 源：<tableId>

DELTA_CONVERT_TO_DELTA_ROW_TRACKING_WITHOUT_STATS

无法在不收集统计信息的情况下启用行跟踪。

如果要启用行跟踪，请执行以下操作：

通过运行以下命令启用统计信息收集：

SET <statisticsCollectionPropertyKey> = true
1. 运行 CONVERT TO DELTA 而不使用“NO STATISTICS”选项。

如果不需要收集统计信息，请禁用行跟踪：

通过运行以下命令停用默认启用表功能：

RESET <rowTrackingTableFeatureDefaultKey>
1. 通过运行以下命令停用默认表属性：
  
  SET <rowTrackingDefaultPropertyKey> = false

DELTA_COPY_INTO_TARGET_FORMAT

COPY INTO 目标必须是 Delta 表。

DELTA_CREATE_EXTERNAL_TABLE_WITHOUT_SCHEMA

你正在尝试使用 Delta 从以下位置创建外部表 <tableName>：

<path> 创建外部表，但在输入路径为空时

未指定架构。

若要详细了解 Delta，请参阅 <docLink>

DELTA_CREATE_EXTERNAL_TABLE_WITHOUT_TXN_LOG

你正在尝试使用 Delta 从以下位置创建外部表 <tableName>：

%2$s 创建外部表，但 %2$s/_delta_log 中不存在事务日志。

%2$s/_delta_log。检查上游作业，确保它正在使用

格式（“delta”）写入，并且该路径是表的根。

若要详细了解 Delta，请参阅 <docLink>

DELTA_CREATE_TABLE_SCHEME_MISMATCH

指定的架构与位于 <path> 的现有架构不匹配。

== Specified ==

<specifiedSchema>

== Existing ==

<existingSchema>

== Differences ==

<schemaDifferences>

如果打算保留现有架构，可以

从 create table 命令省略该架构。否则请确保

架构匹配。

DELTA_CREATE_TABLE_SET_CLUSTERING_TABLE_FEATURE_NOT_ALLOWED

无法使用 TBLPROPERTIES 启用 Liquid 表功能。请使用 CREATE OR REPLACE TABLE CLUSTER BY 创建使用 Liquid 聚类分析的 Delta 表。

DELTA_CREATE_TABLE_WITH_DIFFERENT_PARTITIONING

指定的分区与 <path> 处的现有分区不匹配。

== Specified ==

<specifiedColumns>

== Existing ==

<existingColumns>

DELTA_CREATE_TABLE_WITH_DIFFERENT_PROPERTY

指定的属性与 <path> 处的现有属性不匹配。

== Specified ==

<specificiedProperties>

== Existing ==

<existingProperties>

DELTA_CREATE_TABLE_WITH_NON_EMPTY_LOCATION

无法创建表（“<tableId>”）。关联的位置（“<tableLocation>”）不为空，也不是 Delta 表。

DELTA_DATA_CHANGE_FALSE

无法更改表元数据，因为“dataChange”选项设置为 false。尝试的操作：“<op>”。

DELTA_DELETED_PARQUET_FILE_NOT_FOUND

找不到事务日志中引用的文件 <filePath>。可以在 Delta 的数据保留策略下删除此 parquet 文件。

默认数据保留持续时间：<logRetentionPeriod>。 Prquet 文件的修改时间：<modificationTime>。 Prquet 文件的删除时间：<deletionTime>。删除的 Delta 版本：<deletionVersion>。

DELTA_DELETION_VECTOR_MISSING_NUM_RECORDS

SQLSTATE：2D521

提交删除向量缺少 numRecords 统计信息的文件是无效操作。

DELTA_DOMAIN_METADATA_NOT_SUPPORTED

检测到域 <domainNames> 的 DomainMetadata 操作，但未启用 DomainMetadataTableFeature。

DELTA_DROP_COLUMN_AT_INDEX_LESS_THAN_ZERO

SQLSTATE：42KD8

删除列的索引 <columnIndex> 低于 0

DELTA_DUPLICATE_ACTIONS_FOUND

SQLSTATE：2D521

针对路径 <path> 多次指定了文件操作“<actionType>”。

它与 <conflictingPath> 冲突。

单个提交中不能存在使用相同路径的多个文件操作。

DELTA_DUPLICATE_COLUMNS_FOUND

已找到重复列 <coltype>：<duplicateCols>

DELTA_DUPLICATE_COLUMNS_ON_INSERT

INSERT 子句中的重复列名

DELTA_DUPLICATE_COLUMNS_ON_UPDATE_TABLE

<message>

请在更新表之前删除重复的列。

DELTA_DUPLICATE_DATA_SKIPPING_COLUMNS

发现跳过列的重复数据：<columns>。

DELTA_DUPLICATE_DOMAIN_METADATA_INTERNAL_ERROR

内部错误：同一事务中的两个 DomainMetadata 操作具有相同的域 <domainName>

DELTA_DV_HISTOGRAM_DESERIALIZATON

在表完整性验证期间，无法反序列化已删除的记录计数直方图。

DELTA_DYNAMIC_PARTITION_OVERWRITE_DISABLED

动态分区覆盖模式由会话配置或写入选项指定，但它已被 spark.databricks.delta.dynamicPartitionOverwrite.enabled=false 禁用。

DELTA_EMPTY_DATA

SQLSTATE：428GU

创建 Delta 表时使用的数据没有任何列。

DELTA_EMPTY_DIRECTORY

在以下目录中未找到任何文件：<directory>。

DELTA_EXCEED_CHAR_VARCHAR_LIMIT

SQLSTATE：22001

超过 char/varchar 类型长度限制。检查失败：<expr>。

DELTA_FAILED_CAST_PARTITION_VALUE

无法将分区值 <value> 强制转换为 <dataType>

DELTA_FAILED_FIND_ATTRIBUTE_IN_OUTPUT_COLUMNS

在现有目标输出 <targetOutputColumns> 中找不到 <newAttributeName>

DELTA_FAILED_INFER_SCHEMA

无法从给定的文件列表推断架构。

DELTA_FAILED_MERGE_SCHEMA_FILE

SQLSTATE：42KDA

无法合并文件 <file> 的架构：

<schema>

DELTA_FAILED_READ_FILE_FOOTER

SQLSTATE：KD001

无法读取文件的页脚：<currentFile>

DELTA_FAILED_RECOGNIZE_PREDICATE

无法识别谓词“<predicate>”

DELTA_FAILED_SCAN_WITH_HISTORICAL_VERSION

需要对最新版本的 Delta 源进行完全扫描，但找到了版本 <historicalVersion> 的历史扫描

DELTA_FAILED_TO_MERGE_FIELDS

SQLSTATE：22005

无法合并字段“<field>”和“<fieldRoot>”。 <fieldChild>

DELTA_FEATURES_PROTOCOL_METADATA_MISMATCH

无法对此表执行操作，因为以下表功能已在元数据中已启用，但在协议中未列出：<features>。

DELTA_FEATURES_REQUIRE_MANUAL_ENABLEMENT

需要手动为表架构启用以下表功能：<unsupportedFeatures>。

为此，请对上面列出的每个功能运行以下命令：

ALTER TABLE table_name SET TBLPROPERTIES ('delta.feature.feature_name' = 'supported')

将“table_name”和“feature_name”替换为实际值。

当前支持的功能：<supportedFeatures>。

DELTA_FEATURE_DROP_CONFLICT_REVALIDATION_FAIL

无法删除功能，因为并发事务修改了表。

请重试此操作。

<concurrentCommit>

DELTA_FEATURE_DROP_FEATURE_NOT_PRESENT

无法从此表中删除 <feature>，因为它当前不存在于该表的协议中。

DELTA_FEATURE_DROP_HISTORICAL_VERSIONS_EXIST

无法删除 <feature>，因为 Delta 日志包含使用该功能的历史版本。

请等到历史记录保持期 (<logRetentionPeriodKey>=<logRetentionPeriod>)

是时间已经过去，自上次激活该功能以来。

或者，请等待 TRUNCATE HISTORY 保留期到期 (<truncateHistoryLogRetentionPeriod>)

然后运行：

ALTER TABLE table_name DROP FEATURE feature_name TRUNCATE HISTORY

删除 <feature> 部分成功。

当前版本的表中不再使用该功能。但是，该功能

仍存在于表的历史版本中。无法删除表功能

从表协议中，直到到这些历史版本已过期。

若要从协议中删除表功能，请等待历史版本

未在候选文件中找到要重写的文件 (<path>)：

<pathList>

DELTA_FOUND_MAP_TYPE_COLUMN

已找到 MapType。若要访问 MapType 的键或值，请指定一个

：

<key> 或

<value>

后跟列的名称（仅当该列是结构类型时）。

例如 mymap.key.mykey

如果列是基本类型，mymap.key 或 mymap.value 就足够了。

DELTA_GENERATED_COLUMNS_DATA_TYPE_MISMATCH

列 <columnName> 是生成的列或由生成的列使用的列。数据类型为 <columnType>。它不接受数据类型 <dataType>

DELTA_GENERATED_COLUMNS_EXPR_TYPE_MISMATCH

生成的列 <columnName> 的表达式类型为 <expressionType>，但列类型为 <columnType>

DELTA_GENERATED_COLUMN_UPDATE_TYPE_MISMATCH

列 <currentName> 是生成的列或由生成的列使用的列。数据类型为 <currentDataType>，无法转换为数据类型 <updateDataType>

DELTA_ICEBERG_COMPAT_VIOLATION

SQLSTATE：KD00E

IcebergCompatV<version> 的验证失败。

有关更多详细信息，请参阅 DELTA_ICEBERG_COMPAT_VIOLATION

DELTA_ILLEGAL_OPTION

SQLSTATE：42616

选项“<name>”的值“<input>”无效，<explain>

DELTA_ILLEGAL_USAGE

对 Delta 表执行 <operation> 时不允许使用 <option>。

DELTA_INCONSISTENT_BUCKET_SPEC

Delta 存储表上的 BucketSpec 与元数据中的 BucketSpec 不匹配。应为：<expected>。实际为：<actual>。

DELTA_INCONSISTENT_LOGSTORE_CONFS

(<setKeys>) 不能设置为不同的值。请仅设置其中的一个，或将其设置为相同的值。

DELTA_INCORRECT_ARRAY_ACCESS

错误访问 ArrayType。使用 arrayname.element.elementname 位置

添加到数组。

DELTA_INCORRECT_ARRAY_ACCESS_BY_NAME

已找到 ArrayType。要访问 ArrayType 的元素，请指定

<rightName>

而不是 <wrongName>

DELTA_INCORRECT_GET_CONF

使用 getConf() 而不是 `conf.getConf()

DELTA_INCORRECT_LOG_STORE_IMPLEMENTATION

在架构列名的“,;{}()\n\t=”中发现无效字符。请使用其他字符，然后重试。

DELTA_INVALID_CLONE_PATH

SQLSTATE：22KD1

CLONE 的目标位置需要是绝对路径或表名。使用

绝对路径而不是 <path>。

DELTA_INVALID_FORMAT

检测到不兼容的格式。

在 <deltaRootPath>/_delta_log`` 处找到 Delta 的事务日志，

但你正在尝试使用 format("<format>") 执行 <operation><path>。读取和写入 Delta 表时

必须使用“format("delta")”。

若要详细了解 Delta，请参阅 <docLink>

DELTA_INVALID_GENERATED_COLUMN_REFERENCES

SQLSTATE：42621

生成的列不能使用不存在的列或其他生成的列

DELTA_INVALID_IDEMPOTENT_WRITES_OPTIONS

SQLSTATE：42616

幂等 Dataframe 写入的选项无效：<reason>

DELTA_INVALID_INTERVAL

SQLSTATE：22006

<interval> 不是有效的 INTERVAL。

DELTA_INVALID_ISOLATION_LEVEL

SQLSTATE：25000

无效隔离级别“<isolationLevel>”

DELTA_INVALID_LOGSTORE_CONF

无法同时设置 <classConfig> 和 <schemeConfig>。请仅设置其中一组。

DELTA_INVALID_MANAGED_TABLE_SYNTAX_NO_SCHEMA

<tableName> 缺少具体化行 <rowTrackingColumn> 列名称。

DELTA_MAX_ARRAY_SIZE_EXCEEDED

请使用小于 Int.MaxValue - 8 的限制。

DELTA_MAX_COMMIT_RETRIES_EXCEEDED

SQLSTATE：40000

此提交失败，因为它已尝试 <numAttempts> 次，但均未成功。

这可能是由多个并发提交连续提交 Delta 表

获取 [<startVersion>, <endVersion>] 范围的更改数据时出错，因为未记录

版本 [<version>] 的更改数据。如果在此表上启用了更改数据馈送，

请使用 DESCRIBE HISTORY 查看它首次启用的时间。

否则，若要开始记录更改数据，请使用 `ALTER TABLE table_name SET TBLPROPERTIES

(<key>=true)`。

DELTA_MISSING_COLUMN

无法在表列中找到 <columnName>：<columnList>

DELTA_MISSING_DELTA_TABLE

<tableName> 不是 Delta 表。

DELTA_MISSING_DELTA_TABLE_COPY_INTO

表不存在。首先使用 CREATE TABLE <tableName> 创建空的 Delta 表。

DELTA_MISSING_ICEBERG_CLASS

找不到 Iceberg 类。请确保已安装 Delta Iceberg 支持。

有关更多详细信息，请参阅 <docLink>。

DELTA_MISSING_NOT_NULL_COLUMN_VALUE

SQLSTATE：23502

写入表中的数据中缺失具有 NOT NULL 约束的 <columnName> 列。

DELTA_MISSING_PARTITION_COLUMN

SQLSTATE：42KD6

在架构 <columnList> 中找不到分区列 <columnName>

DELTA_MISSING_PART_FILES

SQLSTATE：42KD6

找不到检查点版本的所有组成部分文件：<version>

DELTA_MISSING_PROVIDER_FOR_CONVERT

CONVERT TO DELTA 仅支持 Parquet 表。请将目标重写为 Parquet。如果它是 Parquet 目录，则为 <path>

DELTA_MISSING_SET_COLUMN

SET 列 <columnName> 没有找到给定列：<columnList>。

DELTA_MISSING_TRANSACTION_LOG

检测到不兼容的格式。

你正在尝试使用 Delta 执行 <operation><path>，但没有

事务日志。检查上游作业，确保它正在使用

format("delta") 进行写入，并且你正在尝试对表基本路径执行 %1$s。

若要详细了解 Delta，请参阅 <docLink>

DELTA_MODE_NOT_SUPPORTED

不支持指定模式“<mode>”。支持的模式包括：<supportedModes>

DELTA_MULTIPLE_CDC_BOUNDARY

SQLSTATE：42614

为 CDC 读取提供的多个 <startingOrEnding> 参数。请提供一个 <startingOrEnding> 时间戳或 <startingOrEnding> 版本。

DELTA_MULTIPLE_CONF_FOR_SINGLE_COLUMN_IN_BLOOM_FILTER

SQLSTATE：42614

传递给列命令的多个 bloom 筛选器索引配置：<columnName>

DELTA_MULTIPLE_SOURCE_ROW_MATCHING_TARGET_ROW_IN_MERGE

SQLSTATE：21506

无法执行合并，因为多个源行匹配并尝试

以可能冲突的方式修改 Delta 表中的同一目标行。根据合并的 SQL 语义，

当多个源行在同一目标行上匹配时，结果可能是不明确的，

因为不清楚应该使用哪一个源行来更新或删除匹配的

目标行。你可以预处理源表来消除

出现多个匹配项的可能性。请参阅在“建议的文档”中提供的链接中的

<usageReference>

DELTA_NAME_CONFLICT_IN_BUCKETED_TABLE

以下列名仅限 Delta Bucket 表内部使用：<names>

DELTA_NESTED_FIELDS_NEED_RENAME

需要重命名嵌套字段以避免数据丢失。字段：

<fields>。

原始架构：

<schema>

DELTA_NESTED_NOT_NULL_CONSTRAINT

当 MERGE 语句中有多个 NOT MATCHED 子句时，只有最后一个 NOT MATCHED 子句可以省略该条件

DELTA_NON_PARSABLE_TAG

无法分析标记 <tag>。

文件标记为：<tagList>

DELTA_NON_PARTITION_COLUMN_ABSENT

SQLSTATE：KD005

写入 Delta 的数据需要包含至少一个非分区列。<details>

DELTA_NON_PARTITION_COLUMN_REFERENCE

谓词引用非分区列“<columnName>”。只能引用分区列：[<columnList>]

DELTA_NON_PARTITION_COLUMN_SPECIFIED

指定了非分区列 <columnList>，但只能指定分区列：<fragment>。

DELTA_NON_SINGLE_PART_NAMESPACE_FOR_CATALOG

Delta 目录需要一个单部分命名空间，但 <identifier> 是多部分命名空间。

DELTA_NOT_A_DATABRICKS_DELTA_TABLE

<table> 不是 Delta 表。如果要使用 Databricks Delta 创建表，请先删除此表。

DELTA_NOT_A_DELTA_TABLE

<tableName> 不是 Delta 表。如果要使用 Delta Lake 重新创建表，请先删除此表。

DELTA_NOT_NULL_COLUMN_NOT_FOUND_IN_STRUCT

未在结构中找到不可为 null 的列：<struct>

DELTA_NOT_NULL_CONSTRAINT_VIOLATED

SQLSTATE：23502

列违反了 NOT NULL 约束：<columnName>。

DELTA_NOT_NULL_NESTED_FIELD

不能将不可为 null 的嵌套字段添加到可为 null 的父级。请相应地设置父列的可为 null 性。

DELTA_NO_COMMITS_FOUND

SQLSTATE：KD006

未在 <logPath> 处找到提交

DELTA_NO_RECREATABLE_HISTORY_FOUND

SQLSTATE：KD006

在 <logPath> 处找不到可重新创建的提交

DELTA_NO_RELATION_TABLE

找不到表 <tableIdent>

DELTA_NO_START_FOR_CDC_READ

没有为 CDC 读取提供 startingVersion 或 startingTimestamp。

DELTA_NULL_SCHEMA_IN_STREAMING_WRITE

SQLSTATE：42P18

Delta 不接受在架构中使用 NullTypes 进行流写入。

DELTA_ONEOF_IN_TIMETRAVEL

请提供“timestampAsOf”或“versionAsOf”以按时间顺序查看。

DELTA_ONLY_OPERATION

<operation> 仅支持用于 Delta 表。

DELTA_OPERATION_MISSING_PATH

请为 <operation> 提供路径或表标识符。

DELTA_OPERATION_NOT_ALLOWED

不允许操作：Delta 表不支持 <operation>

DELTA_OPERATION_NOT_ALLOWED_DETAIL

不允许的操作：不支持对 Delta 表执行 <operation>：<tableName>

DELTA_OPERATION_ON_TEMP_VIEW_WITH_GENERATED_COLS_NOT_SUPPORTED

不支持在引用 Delta 表（包含生成列）的临时视图上执行 <operation> 命令。请直接对 Delta 表运行 <operation> 命令

DELTA_OVERWRITE_MUST_BE_TRUE

如果不设置 OVERWRITE = 'true'，则无法指定复制选项 overwriteSchema。

DELTA_OVERWRITE_SCHEMA_WITH_DYNAMIC_PARTITION_OVERWRITE

“overwriteSchema”不能在动态分区覆盖模式下使用。

DELTA_PARTITION_COLUMN_CAST_FAILED

SQLSTATE：22525

未能将分区列 <columnName> 的值 <value> 强制转换为 <dataType>

DELTA_PARTITION_COLUMN_NOT_FOUND

在架构 [<schemaMap>] 中找不到分区列 <columnName>

DELTA_PARTITION_SCHEMA_IN_ICEBERG_TABLES

转换 Iceberg 表时，无法指定分区架构。系统会自动推理该架构。

DELTA_PATH_DOES_NOT_EXIST

<path> 不存在或不是 Delta 表。

DELTA_PATH_EXISTS

如果不设置 OVERWRITE = 'true'，则无法写入已存在的路径 <path>。

无法分配缺少行计数统计信息的行 ID。

通过在 Scala 笔记本中运行以下代码来收集表的统计信息，然后重试：

import com.databricks.sql.transaction.tahoe.DeltaLog

import com.databricks.sql.transaction.tahoe.stats.StatisticsCollection

import org.apache.spark.sql.catalyst.TableIdentifier

val log = DeltaLog.forTable(spark, TableIdentifier(table_name))

StatisticsCollection.recompute(spark, log)

DELTA_SCHEMA_CHANGED

检测到架构更改：

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

请尝试重启查询。如果每次重启查询后此问题重复出现，并且没有

进展，则原因是你做出了不兼容的架构更改，需要

使用新的检查点目录从头开始启动查询。

DELTA_SCHEMA_CHANGED_WITH_STARTING_OPTIONS

在版本 <version> 中检测到架构更改：

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

请尝试重启查询。如果每次重启查询后此问题重复出现，并且没有

进展，则原因是你做出了不兼容的架构更改，需要

使用新的检查点目录从头开始启动查询。如果该问题在更改为

新的检查点目录后仍然出现，你可能需要更改现有的

“startingVersion”或“startingTimestamp”选项，以使用新的检查点目录

从高于 <version> 的版本重新开始。

DELTA_SCHEMA_CHANGED_WITH_VERSION

在版本 <version> 中检测到架构更改：

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

请尝试重启查询。如果每次重启查询后此问题重复出现，并且没有

进展，则原因是你做出了不兼容的架构更改，需要

使用新的检查点目录从头开始启动查询。

DELTA_SCHEMA_CHANGE_SINCE_ANALYSIS

自创建 DataFrame 或 DeltaTable 对象以来，

Delta 表的架构已经以不兼容的方式发生更改。请重新定义 DataFrame 或 DeltaTable 对象。

更改：

<schemaDiff> <legacyFlagMessage>

DELTA_SCHEMA_NOT_PROVIDED

SQLSTATE：42908

未提供表架构。使用 REPLACE 表且未提供 AS SELECT 查询时，请提供表的架构（列定义）。

DELTA_SCHEMA_NOT_SET

SQLSTATE：KD008

表架构未设置。将数据写入其中或使用 CREATE TABLE 设置架构。

DELTA_SET_LOCATION_SCHEMA_MISMATCH

新 Delta 位置的架构不同于当前表架构。

原始架构：

<original>

目标架构：

<destination>

如果这是预期更改，可以通过运行以下内容来关闭此检查：

%%sql set <config> = true

DELTA_SHALLOW_CLONE_FILE_NOT_FOUND

找不到事务日志中引用的文件 <filePath>。如果已从文件系统中手动删除数据，而不是使用表 DELETE 语句进行删除，则可能会发生这种情况。此表似乎是浅表克隆，如果是这样，当从中克隆此表的原始表删除了该克隆仍在使用的文件时，可能会发生此错误。如果你希望任何克隆独立于原始表，请改用 DEEP 克隆。

DELTA_SHARING_CURRENT_RECIPIENT_PROPERTY_UNDEFINED

数据受收件人属性 <property> 的限制，此属性不适用于会话中的当前收件人。请与数据提供商联系以解决此问题。

DELTA_SHOW_PARTITION_IN_NON_PARTITIONED_COLUMN

为 SHOW PARTITIONS 指定了非分区列 <badCols>

DELTA_SHOW_PARTITION_IN_NON_PARTITIONED_TABLE

在未分区的表上不允许 SHOW PARTITIONS：<tableName>

DELTA_SOURCE_IGNORE_DELETE

在版本 <version> 的流源中检测到已删除的数据（例如 <removedFile>）。目前不支持。如果要忽略删除，请将选项“ignoreDeletes”设置为“true”。源表可以在路径 <dataPath> 中找到。

DELTA_SOURCE_TABLE_IGNORE_CHANGES

在版本 <version> 的源表中检测到数据更新（例如 <file>）。目前不支持。如果你想要忽略更新，请将选项“skipChangeCommits”设置为“true”。如果你想要反映数据更新，请使用全新的检查点目录重启此查询。源表可以在路径 <dataPath> 中找到。

DELTA_STARTING_VERSION_AND_TIMESTAMP_BOTH_SET

请提供“<version>”或“<timestamp>”

DELTA_STATS_COLLECTION_COLUMN_NOT_FOUND

在 Parquet 元数据中找不到列的 <statsType> 统计信息：<columnPath>。

DELTA_STREAMING_CANNOT_CONTINUE_PROCESSING_POST_SCHEMA_EVOLUTION

我们检测到 Delta 流式处理源中 Delta 版本 <previousSchemaChangeVersion> 与 <currentSchemaChangeVersion> 之间的一个或多个非累加架构更改 (<opType>)。

在我们使用 <currentSchemaChangeVersion> 处的最终架构继续进行流处理之前，请检查是否要手动将架构更改传播到接收器表。

修复接收器表的架构或确定无需修复后，可以设置以下 SQL 配置之一，以解除阻止非累加架构更改并继续进行流处理。

若要仅针对此系列架构更改解除阻止此特定流，请设置 <allowCkptVerKey>` = `<allowCkptVerValue>。

若要解除阻止此特定流，请设置 <allowCkptKey>` = `<allowCkptValue>

若要解除阻止所有流，请设置 <allowAllKey>` = `<allowAllValue>。

或者，在适用的情况下，可以在 SQL 配置中将 <allowAllMode> 替换为 <opSpecificMode>，以便仅解除阻止此架构更改类型的流。

DELTA_STREAMING_CHECK_COLUMN_MAPPING_NO_SNAPSHOT

检查列映射架构更改时无法获取起始版本的 Delta 日志快照。请选择其他起始版本，或通过将“<config>”设置为“true”来强制启用流式读取，但需自负风险。

DELTA_STREAMING_INCOMPATIBLE_SCHEMA_CHANGE

SQLSTATE：42KD4

流式读取在具有读取不兼容的架构更改（例如重命名或删除或数据类型更改）的表上不受支持。

有关解决此问题的更多信息和可能的后续步骤，请查看 <docLink> 上的文档

读取的架构：<readSchema>。不兼容的数据架构：<incompatibleSchema>。

DELTA_STREAMING_INCOMPATIBLE_SCHEMA_CHANGE_USE_SCHEMA_LOG

SQLSTATE：42KD4

流式读取在具有读取不兼容的架构更改（例如重命名或删除或数据类型更改）的表上不受支持。

请提供“schemaTrackingLocation”，以便为 Delta 流处理启用非累加架构演变。

有关详细信息，请参阅 <docLink> 。

读取的架构：<readSchema>。不兼容的数据架构：<incompatibleSchema>。

DELTA_STREAMING_METADATA_EVOLUTION

Delta 表的架构、表配置或协议在流式处理期间已更改。

架构或元数据跟踪日志已更新。

请重启流以使用更新的元数据继续处理。

更新的架构：<schema>。

更新的表配置：<config>。

更新的表协议：<protocol>

DELTA_STREAMING_SCHEMA_EVOLUTION_UNSUPPORTED_ROW_FILTER_COLUMN_MASKS

使用架构跟踪从源表 <tableId> 进行流式处理不支持行筛选器或列掩码。

请删除行筛选器或列掩码，或禁用架构跟踪。

DELTA_STREAMING_SCHEMA_LOCATION_CONFLICT

从位于“<table>”的表流式传输时检测到有冲突的架构位置“<loc>”。

另一个流可能正在重用相同的架构位置，这是不允许的。

请为此表中的某个流提供新的唯一 schemaTrackingLocation 路径或 streamingSourceTrackingId 作为读取器选项。

DELTA_STREAMING_SCHEMA_LOCATION_NOT_UNDER_CHECKPOINT

架构位置“<schemaTrackingLocation>”必须放在检查点位置“<checkpointLocation>”下。

无法初始化 Delta 流式处理源架构日志，因为

在提供从表版本 <a> 到 <b> 的流式处理批时，我们检测到不兼容的架构或协议更改。

DELTA_STREAMING_SCHEMA_LOG_PARSE_SCHEMA_FAILED

无法从 Delta 流式处理源架构日志分析架构。

架构日志可能已损坏。请选择新的架构位置。

DELTA_TABLE_ALREADY_CONTAINS_CDC_COLUMNS

无法对表启用变更数据捕获。表已包含

保留的列 <columnList>，

这些列将在内部用作表的更改数据馈送的元数据。若要为

表上的更改数据馈送将重命名/删除这些列。

DELTA_TABLE_ALREADY_EXISTS

SQLSTATE：42P07

表 <tableName> 已存在。

DELTA_TABLE_FOR_PATH_UNSUPPORTED_HADOOP_CONF

DeltaTable.forPath 目前仅支持以 <allowedPrefixes> 开头的 hadoop 配置键，但获取的键为 <unsupportedOptions>

DELTA_TABLE_ID_MISMATCH

<tableLocation> 处的 Delta 表已替换，但此命令使用的是该表。

表 ID 之前为 <oldId>，但现在为 <newId>。

请重试当前命令，确保它读取的是一致的表视图。

DELTA_TABLE_LOCATION_MISMATCH

现有表 <tableName> 的位置为 <existingTableLocation>。它与指定的位置 <tableLocation> 不匹配。

DELTA_TABLE_NOT_FOUND

Delta 表 <tableName> 不存在。

DELTA_TABLE_NOT_SUPPORTED_IN_OP

表在 <operation> 中不受支持。请改用路径。

DELTA_TABLE_ONLY_OPERATION

<tableName> 不是 Delta 表。 <operation> 仅支持用于 Delta 表。

DELTA_TARGET_TABLE_FINAL_SCHEMA_EMPTY

SQLSTATE：428GU

目标表最终架构为空。

DELTA_TIMESTAMP_GREATER_THAN_COMMIT

SQLSTATE：42816

提供的时间戳 (<providedTimestamp>) 晚于此

表 (<tableName>) 可用的最新版本。请使用早于或等于 <maximumTimestamp> 的时间戳。

DELTA_TIMESTAMP_INVALID

SQLSTATE：42816

提供的时间戳 (<expr>) 无法转换为有效时间戳。

DELTA_TIME_TRAVEL_INVALID_BEGIN_VALUE

<timeTravelKey> 需是有效的开始值。

DELTA_TRUNCATED_TRANSACTION_LOG

<path>：由于手动删除或日志保留策略 (<logRetentionKey>=<logRetention>) 和检查点保留策略 (<checkpointRetentionKey>=<checkpointRetention>) 导致事务日志被截断，无法在版本 <version> 中重构状态

DELTA_TRUNCATE_TABLE_PARTITION_NOT_SUPPORTED

不允许操作：Delta 表上的 TRUNCATE TABLE 不支持分区谓词；使用 DELETE 删除特定的分区或行。

DELTA_UDF_IN_GENERATED_COLUMN

SQLSTATE：42621

已找到 <udfExpr>。生成的列不能使用用户定义的函数

DELTA_UNEXPECTED_ACTION_EXPRESSION

意外的操作表达式 <expression>。

DELTA_UNEXPECTED_NUM_PARTITION_COLUMNS_FROM_FILE_NAME

SQLSTATE：KD009

需要 <expectedColsSize> 分区列 <parsedColsSize>，但通过分析文件名 <path> 找到了 <expectedCols> 分区列 <parsedCols>

DELTA_UNEXPECTED_PARTIAL_SCAN

SQLSTATE：KD00A

应对 Delta 源进行完整扫描，但发现只扫描了一部分。 path：<path>

DELTA_UNEXPECTED_PARTITION_COLUMN_FROM_FILE_NAME

SQLSTATE：KD009

需要分区列 <expectedCol>，但通过分析文件名 <path> 找到了分区列 <parsedCol>

DELTA_UNEXPECTED_PARTITION_SCHEMA_FROM_USER

SQLSTATE：KD009

当前表协议版本不支持使用更改

使用 <config>。

列映射所需的 Delta 协议版本：

<requiredVersion>

表的当前 Delta 协议版本：

<currentVersion>

<advice>

DELTA_UNSUPPORTED_COLUMN_MAPPING_SCHEMA_CHANGE

检测到架构更改：

缺少删除向量文件的表版本不支持“FSCK REPAIR TABLE”命令。

请联系支持人员。

DELTA_UNSUPPORTED_GENERATE_WITH_DELETION_VECTORS

包含删除向量的表版本不支持“GENERATE symlink_format_manifest”命令。

若要生成不包含删除向量的表的版本，请运行“REORG TABLE table APPLY (PURGE)”。然后重新运行“GENERATE”命令。

有关更多详细信息，请参阅 DELTA_VERSIONS_NOT_CONTIGUOUS

DELTA_VIOLATE_CONSTRAINT_WITH_VALUES

SQLSTATE：23001

具有值的行违反了 CHECK 约束 <constraintName><expression>：

<values>

DELTA_VIOLATE_TABLE_PROPERTY_VALIDATION_FAILED

违反了表 <table> 的属性验证：

有关更多详细信息，请参阅 DELTA_VIOLATE_TABLE_PROPERTY_VALIDATION_FAILED

DELTA_WRITE_INTO_VIEW_NOT_SUPPORTED

<viewIdentifier> 是视图。不能将数据写入视图。

DELTA_ZORDERING_COLUMN_DOES_NOT_EXIST

数据架构中不存在 Z 排序列 <columnName>。

DELTA_ZORDERING_ON_COLUMN_WITHOUT_STATS

SQLSTATE：KD00D

<cols> 上的 Z 排序将

无效，因为我们目前不收集这些列的统计数据。请参阅在“建议的文档”中提供的链接中的

<link>

有关数据跳过和 Z 排序的详细信息。可以通过

设置“%%sql set = false”

'%%sql set <zorderColStatKey> = false'

DELTA_ZORDERING_ON_PARTITION_COLUMN

<colName> 是分区列。只能对数据列执行 Z 排序

自动换带机

CF_ADD_NEW_NOT_SUPPORTED

指定了架构时不支持架构演变模式 <addNewColumnsMode>。若要使用此模式，可以通过 cloudFiles.schemaHints 提供架构。

CF_AMBIGUOUS_AUTH_OPTIONS_ERROR

找到了（默认）目录列表模式的通知设置

身份验证选项：

<options>

如果要使用文件通知模式，请显式设置：

.option("cloudFiles.<useNotificationsKey>", "true")

如果要跳过选项验证步骤并忽略这些

身份验证选项，也可以设置：

.option("cloudFiles.ValidateOptionsKey>", "false")

CF_AMBIGUOUS_INCREMENTAL_LISTING_MODE_ERROR

增量列表模式 (cloudFiles.<useIncrementalListingKey>)

和文件通知 (cloudFiles.<useNotificationsKey>)

自动加载程序无法删除已处理的文件，因为它对源目录没有写入权限。

<reason>

若要修复，可以执行以下操作之一：

授予对源目录的写入权限，或
将 cleanSource 设置为“OFF”

还可以通过将 SQLConf spark.databricks.cloudFiles.cleanSource.disabledDueToAuthorizationErrors 设置为“true”来解除阻止流。

CF_DUPLICATE_COLUMN_IN_DATA

尝试推断表的分区架构时出错。在数据和分区路径中复制了相同的列。若要忽略分区值，请使用 .option("cloudFiles.<partitionColumnsKey>", "{comma-separated-list}") 显式提供分区列

CF_EMPTY_DIR_FOR_SCHEMA_INFERENCE

输入路径 <path> 为空时无法推断架构。请在输入路径中存在文件时尝试启动流，或指定架构。

CF_EVENT_GRID_AUTH_ERROR

无法创建事件网格订阅。请确保服务

主体具有 <permissionType> 事件网格订阅。有关详细信息，请参阅：

<docLink>

CF_EVENT_GRID_CREATION_FAILED

无法创建事件网格订阅。请确保 Microsoft.EventGrid

在订阅中注册为资源提供程序。有关详细信息，请参阅：

<docLink>

CF_EVENT_GRID_NOT_FOUND_ERROR

无法创建事件网格订阅。请确保存储

帐户 (<storageAccount>) 位于资源组 (<resourceGroup>) 的下面，并且

发现主题 <topicName> 有多个（<num> 个）订阅使用自动加载程序前缀：

<subscriptionList>

每个主题只能有一个订阅。请手动确保主题没有多个订阅。

CF_GCP_AUTHENTICATION

请提供以下所有凭据：<clientEmail>、<client>、

CF_INVALID_MANAGED_FILE_EVENTS_OPTION_KEYS

自动加载程序与托管文件事件一起使用时，不支持以下选项：

<optionList>

建议删除这些选项，然后重启流。

CF_INVALID_SCHEMA_EVOLUTION_MODE

cloudFiles.<schemaEvolutionModeKey> 必须是下列其中一项：{

"<addNewColumns>"

"<failOnNewColumns>"

"<rescue>"

"<noEvolution>"}

CF_INVALID_SCHEMA_HINTS_OPTION

架构提示只能指定特定列一次。

在这种情况下，请在架构提示中多次重新定义列：<columnName>

多次重新定义列

<schemaHints>

CF_INVALID_SCHEMA_HINT_COLUMN

文件包含流的重要默认选项，因此流无法立即

重启。请联系 Databricks 支持人员获取帮助。

CF_MISSING_PARTITION_COLUMN_ERROR

配置：“<sourceProtocolVersionKey> = <value>”

以恢复流。请参阅：

请确保所有提供的选项密钥都正确。如果要跳过

计算网格距离为 <k> 的 <h3Cell> 的六边形环时出现五边形

H3_UNDEFINED_GRID_DISTANCE

<h3Cell1> 和 <h3Cell2> 之间的 H3 网格距离未定义

WKB_PARSE_ERROR

分析 WKB 时出错：<pos> 位置处的 <parseError>

有关更多详细信息，请参阅 WKB_PARSE_ERROR

WKT_PARSE_ERROR