Azure Databricks 中的错误条件

未能创建数据源表 <tableName>：

有关详细信息，请参阅 CANNOT_CREATE_DATA_SOURCE_TABLE

无法解码网址

无法解码提供的 URL：<url>。请确保 URL 格式正确，然后重试。

无法删除系统所有的

SQLSTATE：42832

无法删除系统拥有的 <resourceType>。

无法删除不明确的约束

SQLSTATE：42K0C

无法删除名称 <constraintName> 由 CHECK 约束共享的约束

和 PRIMARY KEY 或 FOREIGN KEY 约束。可以删除 PRIMARY KEY 或

按查询划分的 FOREIGN KEY 约束：

ALTER TABLE .. DROP PRIMARY KEY 或

ALTER TABLE .. DROP FOREIGN KEY ..

无法建立连接

SQLSTATE：08001

无法与远程 <jdbcDialectName> 数据库建立连接。请检查连接信息和凭据，例如主机、端口、用户、密码和数据库选项。 ** 如果你认为信息正确，请检查工作区的网络设置，并确保它对主机不存在出站限制。此外，请检查主机是否不会阻止来自部署工作区 Spark 群集的网络的入站连接。 ** 详细错误消息：<causeErrorMessage>。

无法建立无服务器连接

SQLSTATE：08001

无法与远程 <jdbcDialectName> 数据库建立连接。请检查连接信息和凭据，例如主机、端口、用户、密码和数据库选项。 ** 如果你认为信息正确，请允许从 Internet 到主机的入站流量，因为你使用的是无服务器计算。如果你的网络策略不允许入站 Internet 流量，请使用非无服务器计算，或者可以联系 Databricks 代表了解无服务器专用网络。 ** 详细错误消息：<causeErrorMessage>。

无法在转换中调用

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

无法加载函数类

SQLSTATE：46103

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

无法加载PROTOBUF类

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

无法加载状态存储

加载状态期间出错。

有关详细信息，请参阅 CANNOT_LOAD_STATE_STORE

无法合并不兼容的数据类型

SQLSTATE：42825

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

无法合并模式

架构合并失败：

初始架构：

<left>

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

<right>。

无法修改配置

SQLSTATE：46110

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

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

无法解析小数

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

无法解析间隔

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

无法解析JSON字段

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

不能解析PROTOBUF描述符

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

无法解析时间戳

SQLSTATE：22007

<message>。使用 <func> 来容忍无效的输入字符串并改为返回 NULL。

初始化期间无法查询表

初始化期间无法查询 MV/ST。

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

无法读取归档文件

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

无法读取文件

无法将非UC托管表作为源或目标进行浅克隆

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

CANNOT_UPDATE_FIELD

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

有关详细信息，请参阅 CANNOT_UPDATE_FIELD

CANNOT_UP_CAST_DATATYPE

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

<details>

无法使用KRYO

SQLSTATE：22KD3

无法加载 Kryo 序列化编解码器。无法在 Spark Connect 客户端中使用 Kryo 序列化。使用 Java 序列化、提供自定义编解码器或使用 Spark 经典版。

无法验证连接

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

无法写入状态存储

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

有关详细信息，请参阅 CANNOT_WRITE_STATE_STORE

CAST_INVALID_INPUT

类型 <expression> 的值 <sourceType> 无法强制转换为 <targetType>，因为其格式错误。根据语法更正值，或更改其目标类型。使用 try_cast 来容许格式错误的输入并改为返回 NULL。

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

CAST_OVERFLOW

由于溢出，类型 <value> 的值 <sourceType> 无法强制转换为 <targetType>。使用 try_cast 容许溢出，并返回 NULL。

表插入中的类型溢出

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

目录未找到

SQLSTATE：42P08

找不到目录 <catalogName>。请考虑将 SQL 配置 <config> 设置为目录插件。

CHECKPOINT_RDD_BLOCK_ID_NOT_FOUND

SQLSTATE：56000

找不到检查点块 <rddBlockId>!

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

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

循环类引用

类中不能有循环引用，但获得了类 <t> 的循环引用。

类未覆盖预期的方法

<className> 必须替代 <method1> 或 <method2>。

类不受地图对象支持

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

无法支持洁净室命令

不支持清洁室命令

CLEANROOM_INVALID_SHARED_DATA_OBJECT_NAME

引用清洁室内 <type> 的名称无效。按照 [catalog].[schema].[<type>] 的格式，在清洁室内使用 <type> 的名称。

如果不确定要使用的名称，则可以运行“SHOW ALL IN CLEANROOM [clean_room]”，并使用“name”列中的值。

克隆历史无效选项

使用历史记录进行克隆时指定了无效选项： <invalidOption>。

有效语法：CREATE （或 REPLACE) TABLE ... 深 CLONE ... WITH HISTORY.

克隆_不支持_历史记录

不支持带历史记录的克隆。

云文件源文件未找到

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

云服务提供商错误

SQLSTATE：58000

云提供商错误：<message>

聚类列不匹配

指定的聚类分析与现有表 <tableName> 的聚类分析不匹配。

编解码器 <codecName> 不可用。

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

CODEC_SHORT_NAME_NOT_FOUND

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

排序无效名称

值 <collationName> 不表示正确的排序规则名称。建议的有效排序规则名称：[<proposals>]。

排序无效提供程序

值 <provider> 不表示正确的排序规则提供程序。支持的提供程序包括：[<supportedProviders>]。

排序不匹配

SQLSTATE：42P21

无法确定要用于字符串函数和运算符的排序规则。

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

集合大小超出限制

属性如下：<attributes>。

逗号前置约束错误

约束定义前出现意外的“,”。确保未定义列（和预期）时，约束子句不以逗号开头。

尚未实现连接注释

命令 COMMENT ON CONNECTION 尚未实现

比较器返回空值

SQLSTATE：22004

对于 NULL 和 <firstValue> 之间的比较，比较器返回了 <secondValue>。

它应为“大于”运算符返回正整数，为“等于”运算符返回 0，为“小于”运算符返回负整数。

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

复杂表达式不支持的输入

无法处理表达式的输入数据类型：<expression>。

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

并发查询

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

CONCURRENT_SCHEDULER_INSUFFICIENT_SLOT

SQLSTATE：53000

群集中所需的最小可用槽数是 <numTasks>，而群集只有 <numSlots> 个可用槽。查询将停止或失败。增加群集大小以继续。

并行流日志更新

SQLSTATE：40000

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

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

配置不可用

SQLSTATE：42K0I

配置 <config> 不可用。

目录结构冲突

检测到冲突的目录结构。

可疑路径：

<discoveredBasePaths>

如果提供的路径是分区目录，请在数据源的选项中设置“basePath”，以指定表的根目录。

如果有多个根目录，请单独加载它们，然后将它们联合起来。

冲突的分区列名称

检测到的分区列名称冲突：

<distinctPartColLists>

对于已分区表目录，数据文件应仅位于叶目录中。

同一级别的目录应具有相同的分区列名称。

请检查以下目录是否有意外文件或不一致的分区列名称：

<suspiciousPaths>

冲突的提供者

指定的提供程序 <provider> 与现有目录提供程序 <expectedProvider> 不一致。请使用“USING <expectedProvider>”，然后重试该命令。

连接

SQLSTATE：56K00

泛型 Spark 连接错误。

有关详细信息，请参阅 CONNECT

连接已存在

约束需要统一目录

表约束仅在 Unity Catalog 中受支持。

转换_输入无效

无法将值 <str> (<fmt> 转换为 <targetType>，因为它的格式错误。请根据语法更正值，或更改其格式。使用 <suggestion> 来容许格式错误的输入并改为返回 NULL。

COPY_INTO_COLUMN_ARITY_MISMATCH

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

COPY_OPTIONS（‘mergeSchema’ = ‘true’）

架构差异：

<schemaDiff>

复制到源文件格式不受支持

源文件的格式必须为 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>”的内容。

通过将“<config>”设置为“false”，可以将错误静音。

COPY_INTO_STATE_INTERNAL_ERROR

处理 COPY INTO 状态时出现内部错误。

有关详细信息，请参阅 COPY_INTO_STATE_INTERNAL_ERROR

复制到语法错误

创建视图列数目不匹配

SQLSTATE：21S01

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

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

资凭证丢失

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

凭据目的不匹配

凭据 <credentialName> 具有用途 <actualPurpose> ，但命令中给出的用途是 <expectedPurpose>。

CSV_ENFORCE_SCHEMA_NOT_SUPPORTED

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

循环函数引用

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

DATABRICKS_DELTA_NOT_ENABLED

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

数据类型不匹配

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

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

数据类型缺少大小

SQLSTATE：42K01

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

DATA_LINEAGE_SECURE_VIEW_LEAF_NODE_HAS_NO_RELATION

写入世系失败：缺少与 CLM/RLS 策略对应的关系。

数据源已存在

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

数据源外部错误 (DATA_SOURCE_EXTERNAL_ERROR)

SQLSTATE：KD010

保存到外部数据源时遇到错误。

数据源不存在 (DATA_SOURCE_NOT_EXIST)

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

数据源未找到 (DATA_SOURCE_NOT_FOUND)

SQLSTATE：42K02

未能找到数据源：<provider>。请确保提供程序名称正确，并且包已正确注册且与 Spark 版本兼容。

数据源选项包含无效字符

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

数据源选项是必填项

选项 <option> 是必需的。

DATA_SOURCE_TABLE_SCHEMA_MISMATCH (数据源表模式不匹配)

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

数据源架构：<dsSchema>

预期架构：<expectedSchema>

数据源URL不允许

SQLSTATE：42KDB

数据源选项中不允许使用 JDBC URL，请指定“host”、“port”和“database”选项。

日期时间字段超出范围

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

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

默认数据库不存在

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

默认文件未找到

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

默认位置无效

SQLSTATE：42608

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

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

默认不支持

SQLSTATE：42623

无法执行 <statementType> 命令，因为不支持使用表提供程序“DEFAULT”为目标数据源分配 <dataSource> 值。

描述_JSON_未扩展

DESCRIBE TABLE ...仅当指定 [EXTENDED|FORMATTED] 时，才支持 AS JSON。

例如：DESCRIBE EXTENDED <tableName> 支持 AS JSON，但 DESCRIBE <tableName> AS JSON 不受支持。

不同 Delta 表由流媒体源读取

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

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

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

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

以从头开始。

不支持的 DISTINCT 窗口函数

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

DIVIDE_BY_ZERO

SQLSTATE：22012

重复的指标名称

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

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

重复分配

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

SQLSTATE：42711

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

不允许发出超过时间标记的行

SQLSTATE：42815

上一个节点发出了 eventTime=<emittedRowEventTime> 早于 current_watermark_value=<currentWatermark> 的行

这可能会导致执行管道下游有状态运算符出现正确性问题。

请更正运算符逻辑，以在当前全局水印值之后发出行。

空的JSON字段值

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

本地文件在阶段访问查询中为空

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

数据源不支持空架构

<format> 数据源不支持编写空架构或嵌套的空架构。请确保数据架构至少有一列或多列。

编码器未找到

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

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

标签结束未见标签开始

SQLSTATE：42K0L

没有开始标签情况下结束标签 <endLabel> 无法存在。

结束偏移量的主题分区偏移量大于最新可用触发器偏移量

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

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

结束偏移量对主题分区大于预取偏移量

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

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

ERROR_READING_AVRO_UNKNOWN_FINGERPRINT (错误读取AVRO数据: 未知指纹)

SQLSTATE：KD00B

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

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

事件日志需要共享计算资源

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

事件日志 TVF 不支持流水线

EVENT_LOG 使用“架构”字段或发布到默认存储的管道不支持 Table-Valued 函数。

若要查询事件日志，请在管道设置中指定event_log字段，将其发布到元存储。

有关详细信息，请参阅“监控 DLT 管道”文档： https://docs.databricks.com/aws/en/dlt/observability

事件日志不可用

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

EVENT_LOG_UNSUPPORTED_TABLE_TYPE

SQLSTATE：42832

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

查询事件日志仅支持具体化视图、流式表或 DLT 管道。

事件时间不在时间戳类型上

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

超出限制长度

SQLSTATE：54006

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

除外_嵌套列_类型无效

SQLSTATE：428H2

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

EXCEPT_OVERLAPPING_COLUMNS

SQLSTATE：42702

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

减去未匹配的已解决列

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

结构扩展过程中未解析的列异常

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

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

执行器_广播_连接_内存不足

SQLSTATE：53200

内存不足，无法生成广播关系 <relationClassName>。关系大小 = <relationSize>. 此任务使用的内存总量 = <taskMemoryUsage>。 onHeapExecutionMemoryUsed = <onHeapExecutionMemoryUsed>，offHeapExecutionMemoryUsed = <offHeapExecutionMemoryUsed>，onHeapStorageMemoryUsed = <onHeapStorageMemoryUsed>，offHeapStorageMemoryUsed = <offHeapStorageMemoryUsed>。 [sparkPlanId: <sparkPlanId>] 使用“set spark.sql.autoBroadcastJoinThreshold=-1”或联接提示强制随机联接来禁用此查询的广播。

EXECUTOR_BROADCAST_JOIN_STORE_OOM

SQLSTATE：53200

内存不足，无法存储广播关系 <relationClassName>。关系大小 = <relationSize>. StorageLevel = <storageLevel>。 [sparkPlanId: <sparkPlanId>] 使用“set spark.sql.autoBroadcastJoinThreshold=-1”或联接提示强制随机联接来禁用此查询的广播。

EXEC_IMMEDIATE_DUPLICATE_ARGUMENT_ALIASES

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

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

表达式编码失败 (EXPRESSION_ENCODING_FAILED)

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

表达式类型不可排序

SQLSTATE：42822

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

EXTERNAL_SHALLOW_CLONE_STILL_EXISTS

SQLSTATE：42893

无法在源表<sourceTable>上运行操作，因为浅表克隆<targetTable>仍然存在，其状态无效。如果确实想要继续此操作，请通过显式运行 DROP 命令清理这个浅表克隆。

外部表无效方案

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

FABRIC_REFRESH_INVALID_SCOPE (无效的刷新范围)

运行“REFRESH FOREIGN <scope> <name>”时出错。无法直接刷新 Fabric <scope>，请改用“REFRESH FOREIGN CATALOG <catalogName>”刷新 Fabric Catalog。

执行用户自定义函数失败

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

函数调用失败

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

FAILED_JDBC

SQLSTATE：HV000

操作上的 JDBC <url> 失败：

有关详细信息，请参阅 FAILED_JDBC

解析结构类型失败

解析结构 <raw> 失败。

文件读取失败

SQLSTATE：KD001

读取文件 <path> 时出错。

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

使用KRYO注册类失败

无法向 Kryo 注册课程。

重命名路径失败

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

无法重命名临时文件

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

行转换为JSON失败

未能将类 <value> 的行值 <class> 转换为 JSON 格式的目标 SQL 类型 <sqlType>。

无法加载例程

无法加载例程 <routineName>。

解析失败_内容过于复杂

SQLSTATE：54001

该语句（包括潜在的 SQL 函数和引用的视图）太复杂，无法分析。

若要缓解此错误，可将语句划分为多个不太复杂的区块。

功能未启用

功能 <featureName> 未启用。请考虑将配置 <configKey> 设置为 <configValue> 以启用此功能。

功能_不在_经典仓库

<feature> 在经典 SQL 仓库上不受支持。若要使用此功能，请使用专业或无服务器 SQL 仓库。

FEATURE_REQUIRES_UC

SQLSTATE：0AKUD

<feature> 在没有 Unity Catalog 的情况下不受支持。若要使用此功能，请启用 Unity Catalog。

功能不可用

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

字段已存在

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

字段未找到

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

文件在暂存路径中已存在

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

FLATMAPGROUPSWITHSTATE 用户函数错误 (USER_FUNCTION_ERROR)

用户在 flatMapGroupsWithState 中提供的函数出错。原因：<reason>

禁止的数据源在无服务器环境中

不允许在无服务器计算中查询数据源 <source>。无服务器计算仅支持 <allowlist> 数据源。

禁止操作

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

FOREACH_BATCH_USER_FUNCTION_ERROR

用户在 foreach 批处理接收器中提供的函数中发生错误。原因：<reason>

针对每个用户的函数错误

用户在 foreach 接收器中提供的函数中发生错误。原因：<reason>

外键不匹配

SQLSTATE：42830

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

外部对象名称不能为空

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

发现多个数据源

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

来自JSON的冲突模式更新

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

FROM_JSON_CORRUPT_RECORD_COLUMN_IN_SCHEMA

from_json found columnNameOfCorruptRecord (<columnNameOfCorruptRecord>)

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

选项“columnNameOfCorruptRecord”。

从JSON格式损坏的模式

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

FROM_JSON_INFERENCE_FAILED (从 JSON 推断失败)

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

不支持FROM_JSON推断

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

从JSON无效配置

GROUP_BY_AGGREGATE

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

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

按位置分组聚合

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

分组位置超出范围

SQLSTATE：42805

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

分组表达式类型不可排序

SQLSTATE：42822

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

HDFS_HTTP_ERROR

SQLSTATE：KD00F

尝试从 HDFS 读取时，HTTP 请求失败。

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

HLL_INVALID_INPUT_SKETCH_BUFFER

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

HLL_INVALID_LG_K

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

HLL_UNION_DIFFERENT_LG_K

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

HMS_FEDERATION_浅克隆_未找到_IN_UC

浅克隆路径“<path>”无法解析为Unity目录中的表。请确保该表存在并且已集成到 Unity Catalog。

HYBRID_ANALYZER_EXCEPTION

尝试使用旧的固定点分析器和单传递解析程序解析查询或命令时出现失败。

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

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

连接选项的不当URI方案

由于为连接选项“<uri>”提供的 URI <option> 架构不当，无法创建连接。

允许的架构：<allowedSchemes>。

如果架构不存在于 URI 中，请添加架构，或从允许的值指定架构。

无法比较的透视列

SQLSTATE：42818

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

列类型不兼容 (INCOMPATIBLE_COLUMN_TYPE)

SQLSTATE：42825

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

不兼容的数据源注册

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

表格不兼容的数据

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

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

INCOMPATIBLE_JOIN_TYPES

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

视图模式更改不兼容

SQLSTATE：51024

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

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

不完整类型定义

SQLSTATE：42K01

不完整的复杂类型：

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

版本间行为不一致

使用不同的触发器类型，例如 AvailableNow、Once。

插入列数量不匹配

SQLSTATE：21S01

无法写入 <tableName>，原因是

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

插入分区列的元数不匹配

SQLSTATE：21S01

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

表列：<tableColumns>。

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

数据列：<dataColumns>。

使用的列集合无效，无法进行插入或替换操作

表必须分区，所有指定的列都必须表示表的分区列的完整集。

以下列不是分区列： <nonPartitionColumns>

缺少以下分区列： <missingPartitionsColumns>

插入替换未启用

请联系 Databricks 代表启用 INSERT INTO ... REPLACE USING （...）功能。

权限不足

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

<underlyingReport>

间隔算术溢出 (INTERVAL_ARITHMETIC_OVERFLOW)

SQLSTATE：22015

使用间隔操作时的整数溢出。

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

INTERVAL_DIVIDED_BY_ZERO

SQLSTATE：22012

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

无效的聚合过滤器

聚合函数中的 FILTER 表达式 <filterExpr> 无效。

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

INVALID_无偏编码器

SQLSTATE：42001

找到无效的不可知编码器。预计会得到 AgnosticEncoder 的一个实例，但却得到 <encoderType>。有关详细信息，请参阅“<docroot>/api/java/index.html?org/apache/spark/sql/Encoder.html”。

无效算法值

无效或不受支持的边缘内插算法值 <alg>。

无效的数组索引

索引 <indexValue> 超出界限。数组具有 <arraySize> 个元素。使用 SQL 函数 get() 容许访问无效索引上的元素，并改为返回 NULL。

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

元素中的无效数组索引

索引 <indexValue> 超出界限。数组具有 <arraySize> 个元素。使用 try_element_at 容许访问无效索引上的元素，并返回 NULL。

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

无效的属性名称语法

属性名称中的语法错误：<name>。检查反引号是否成对显示，带引号的字符串是一个完整的名称部分，并且仅在带引号的名称部分内使用反引号。

无效的AWS认证

请选择以下身份验证方法之一：

提供 Databricks 服务凭据（<serviceCredential>）的名称（作为 spark 流选项或群集环境变量）。
提供 AWS AccessKey（<awsAccessKey>）和 SecretAccessKey（<awsSecretKey>）以使用 AWS 密钥。
请勿提供 AWS 密钥或 Databricks 服务凭据，以使用用于 Kinesis 身份验证的默认 AWS 凭据提供程序链。

AWS身份验证显式选项无效

请提供您的 Databricks 服务凭据的名称或编号（<serviceCredential>）

或 <awsAccessKey> 和 <awsSecretKey>

无效的位图位置

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

无效布尔声明

期望条件中有布尔语句，但 <invalidStatement> 已找到。

无效边界

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

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

无效的分桶列数据类型

不能对存储桶列使用 <type>。存储桶不支持排序规则数据类型。

无效的桶文件

无效的桶文件：<path>。

INVALID_BYTE_STRING

SQLSTATE：22P03

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

无效的列名称作为路径

SQLSTATE：46121

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

无效的列或字段数据类型

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

INVALID_CONF_VALUE

SQLSTATE：22022

配置“<confValue>”中的值“<confName>”无效。

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

无效或损坏的记录类型

SQLSTATE：42804

损坏记录的列 <columnName> 必须具有可为 STRING null 的类型，但获得了 <actualType>。

无效的坐标参考系统值

无效或不受支持的 CRS（坐标引用系统）值 <crs>。

当前收件人用法无效

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

INVALID_CURSOR

SQLSTATE：HY109

游标无效。

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

无效日期时间模式

SQLSTATE：22007

无法识别的日期/时间模式：<pattern>。

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

无效的默认值

SQLSTATE：42623

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

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

无效的分隔符值

分隔符的值无效。

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

无效的目标目录

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

无效的驱动程序内存 (INVALID_DRIVER_MEMORY)

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

请通过在 Spark 配置中使用 --driver-memory 选项或 "<config>" 来增加内存堆的大小。

无效的动态选项

SQLSTATE：42K10

禁止为外部表 <option_list> 提供的选项 <table_name>。

无效的空位置

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

无效错误条件声明

SQLSTATE：42K0R

条件声明无效。

有关详细信息，请参阅INVALID_ERROR_CONDITION_DECLARATION

INVALID_ESC

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

无效的转义字符

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

无效的执行器内存

执行程序内存 <executorMemory> 必须至少为 <minSystemMemory>。

请使用 Spark 配置中的 --executor-memory 选项或“”<config>增加执行程序内存。

表达式编码器无效

SQLSTATE：42001

找到无效的表达式编码器。需要 ExpressionEncoder 的实例，但获得 <encoderType>。有关详细信息，请参阅“<docroot>/api/java/index.html?org/apache/spark/sql/Encoder.html”。

无效的外部类型

SQLSTATE：42K0N

外部类型 <externalType> 对表达式 <type> 中的类型 <expr> 无效。

无效提取基本字段类型

无法从 <base> 中提取值。需要复杂类型 [STRUCT, ARRAY, MAP]，但得到 <other>。

INVALID_EXTRACT_FIELD (提取字段无效)

无法从 <field> 中提取 <expr>。

无效的提取字段类型

字段名称应是非 null 字符串文本，但它是 <extraction>。

无效字段名称

字段名称 <fieldName> 无效：<path> 不是结构。

格式无效

格式无效：<format>。

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

无效的秒分数错误

秒的有效范围为 [0， 60]（含首尾），但提供的值为 <secAndMicros>。若要避免此错误，请使用 try_make_timestamp，将在发生错误时返回 NULL。

如果不想使用此函数的会话默认时间戳版本，请使用 try_make_timestamp_ntz 或 try_make_timestamp_ltz。

无效的获取诊断使用

SQLSTATE：42612

GET DIAGNOSTICS 语句的使用无效。

有更详细的信息请参阅INVALID_GET_DIAGNOSTICS_USAGE

INVALID_GET_DIAGNOSTICS_USAGE_CONDITION_NUMBER_MUST_BE_ONE

SQLSTATE：35000

GET DIAGNOSTICS 语句的使用无效。 GET DIAGNOSTICS 语句中条件编号的唯一支持值为 1。

INVALID_HANDLE

SQLSTATE：HY000

句柄 <handle> 无效。

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

无效的处理程序声明

SQLSTATE：42K0Q

处理程序声明无效。

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

无效的HTTP请求方法

输入参数：方法、值：<paramValue> 不是 http_request 的有效参数，因为它不是有效的 HTTP 方法。

无效的HTTP请求路径

输入参数：路径、值：<paramValue> 不是 http_request 的有效参数，因为不允许路径遍历。

INVALID_IDENTIFIER

未加引号的标识符 <ident> 无效，必须反引号为：<ident>。

不带引号的标识符只能包含 ASCII 字母（“a”-“z”、“A”-“Z”）、数字（“0”-“9”）和下划线（“_”）。

未加引号的标识符也不得以数字开头。

不同的数据源和元存储可能会对有效标识符施加额外的限制。

无效的零索引

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

无效内联表

无效的内联表。

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

无效的时间间隔格式

将“<input>”分析为间隔时出错。请确保提供的值采用用于定义间隔的有效格式。可以参考文档获取正确的格式。

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

无效的间隔微秒添加

无法将间隔添加到日期，因为它的微秒部分不是 0。若要解决此问题，请将输入日期转换为时间戳，以支持添加包含非零微秒的间隔。

INVALID_INVERSE_DISTRIBUTION_FUNCTION

SQLSTATE：42K0K

反向分布函数 <funcName> 无效。

有关详细信息，请参阅 INVALID_INVERSE_DISTRIBUTION_FUNCTION

无效的 Java 标识符作为字段名称

SQLSTATE：46121

<fieldName> 不是 Java 的有效标识符，不能用作字段名称

<walkedTypePath>。

无效的JoinWith连接类型

joinWith 中的加入类型无效：<joinType>。

INVALID_JSON_DATA_TYPE (JSON 数据类型无效)

无法将 JSON 字符串“<invalidType>”转换为数据类型。请输入有效的数据类型。

无效的JSON数据类型用于排序规则

排序规则只能应用于字符串类型，但 JSON 数据类型为 <jsonType>。

无效的 JSON 记录类型

在推断模式 <failFastMode> 中的通用架构时检测到 JSON 记录的类型无效。期望 STRUCT 类型，但找到 <invalidType>。

无效的JSON根字段

SQLSTATE：22032

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

无效的_JSON_模式_映射_类型

SQLSTATE：22032

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

INVALID_KRYO_SERIALIZER_BUFFER_SIZE（无效的 Kryo 序列化器缓冲区大小）

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

标签使用无效

SQLSTATE：42K0L

标签 <labelName> 的使用无效。

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

INVALID_LAMBDA_FUNCTION_CALL

SQLSTATE：42K0D

无效的 lambda 函数调用。

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

INVALID_LATERAL_JOIN_TYPE

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

INVALID_LIMIT_LIKE_EXPRESSION

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

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

INVALID_LOG_VERSION

UnsupportedLogVersion。

有关详细信息，请参阅 INVALID_LOG_VERSION

无效的非绝对路径

提供的非绝对路径 <path> 不符合资格。请将路径更新为有效的 dbfs 装载位置。

无效的非确定性表达式

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

无效数字字面量范围

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

无效观察指标

观察到的指标无效。

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

无效选项

无效选项：

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

INVALID_PANDAS_UDF_PLACEMENT（无效的Pandas用户定义函数位置）

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

INVALID_PARAMETER_MARKER_VALUE

提供的参数映射无效：

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

参数值无效

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

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

无效的分区列数据类型

不能对分区列使用 <type>。

无效分区操作

分区命令无效。

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

无效的分区值

未能将分区列 <value> 的值 <dataType> 强制转换为数据类型 <columnName>。确保该值与此分区列的预期数据类型匹配。

无效_PIPELINE_ID

管道 ID <pipelineId> 无效。

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

无效权限

SQLSTATE：42852

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

无效的属性键

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

属性值无效

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

无效的合格列名

列名 <columnName> 无效，因为它没有限定表名，或者由超过 4 个名称部分组成。

查询无效，混合查询参数。

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

无效的递归CTE

SQLSTATE：42836

找到的递归定义无效。递归查询必须包含一个 UNION 或一个包含 2 个子项的 UNION ALL 语句。首个子级必须是锚定词，并且没有任何递归引用。

INVALID_RECURSIVE_REFERENCE

SQLSTATE：42836

在 WITH RECURSIVE 子句中找到无效的递归引用。

有关详细信息，请参阅INVALID_RECURSIVE_REFERENCE

无效的正则表达式替换

无法对源 =“<source>”、模式 =“<pattern>”、更换 =“<replacement>”和位置 = <position> 执行 regexp_replace。

无效重置命令格式

预期格式为“RESET”或“RESET key”。如果你要在键中包含特殊字符，请使用引号，例如 RESET key。

无效的重新信号使用

SQLSTATE：0K000

RESIGNAL 当处理程序未处于活动状态时。 RESIGNAL 语句只能在异常处理程序正文中使用。

无效的S3复制凭证

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

无效保存模式

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

INVALID_SCHEMA

SQLSTATE：42K07

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

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

无效的架构或关系名称

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

无效方案

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

INVALID_SECRET_LOOKUP

SQLSTATE：22531

机密查找无效：

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

无效的设置语法

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

无效共享别名名称

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

无效单一变量列 (INVALID_SINGLE_VARIANT_COLUMN)

如果还有用户指定的架构，则无法使用 singleVariantColumn 选项。

无效的来源目录

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

无效的过滤服务合并命令源

SQLSTATE：42KDH

筛选服务 MERGE 操作的源只能包含映射和筛选器。

请调整 MERGE 命令或使用暂存表作为源。

<stmt>

INVALID_SQLSTATE（无效的SQL状态）

SQLSTATE：428B3

无效 SQLSTATE 值：“<sqlState>”。 SQLSTATE 长度必须为 5 个字符，且仅包含 A-Z 和 0-9。 SQLSTATE 不得以“00”、“01”或“XX”开头。

SQL参数无效

SQLSTATE：42K08

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

SQL语法错误

无效的 SQL 语法：

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

INVALID_STAGING_PATH_IN_STAGING_ACCESS_QUERY

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

无效的执行语句

SQLSTATE：07501

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

无效语句或子句

语句或子句：<operation> 无效。

流媒体实时模式触发间隔无效 (INVALID_STREAMING_REAL_TIME_MODE_TRIGGER_INTERVAL)

实时触发器间隔设置为 <interval> ms。这小于 <minBatchDuration> spark.databricks.streaming.realTimeMode.minBatchDuration 指定的毫秒最小值。

无效的流媒体实时模式触发覆盖间隔

无法分析实时触发器的检查点间隔 <interval>。请验证已传递正整数。

无效的子查询表达式

SQLSTATE：42823

子查询无效：

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

用于ALTER命令的目标无效

ALTER <commandTableType> ... <command> 不支持 <tableName>。请改用ALTER <targetTableType>... <command>

无效的目标用于SET_TBLPROPERTIES命令

ALTER <commandTableType> ... SET TBLPROPERTIES 不支持 <tableName>。请改用ALTER <targetTableType>... SET TBLPROPERTIES

INVALID_TEMP_OBJ_REFERENCE

SQLSTATE：42K0F

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

时间戳格式无效

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

无效时区

SQLSTATE：22009

时区：<timeZone> 无效。时区必须是基于地区的区域 ID 或区域偏移量。区域 ID 必须具有“区域/城市”的格式，如“America/Los_Angeles”。区域偏移量必须采用“(+|-)HH”、“(+|-)HH:mm”或“(+|-)HH:mm:ss”格式，例如“-08”、“+01:00”或“-13:33:33”，并且必须位于 -18:00 到 +18:00 的范围内。 “Z”和“UTC”被接受为“+00:00”的同义词。

时间旅行规范无效 (INVALID_TIME_TRAVEL_SPEC)

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

时间旅行时间戳表达式无效

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

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

无效的类型化文字

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

INVALID_UDF_IMPLEMENTATION

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

无效的升级语法

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

无效的URL

SQLSTATE：22P02

URL 无效：<url>。使用 try_parse_url 来容许无效的 URL 并改为返回 NULL。

INVALID_USAGE_OF_STAR_OR_REGEX（星号或正则表达式的无效使用）

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

无效的UTF8字符串

SQLSTATE：22029

在字符串中找到的 UTF8 字节序列无效：<str>。

无效的UUID

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

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

请检查 UUID 的格式。

无效变量声明

SQLSTATE：42K0M

变量声明无效。

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

INVALID_VARIABLE_TYPE_FOR_QUERY_EXECUTE_IMMEDIATE（查询执行即时的变量类型无效）

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

信号语句的变量类型无效

变量类型必须是“MAP<STRING, STRING>”类型，但得到的是<varType>。

架构 <schema> 不是有效的变体分片架构。

无效的WHERE条件

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

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

无效窗口规格定义用于聚合函数 (INVALID_WINDOW_SPEC_FOR_AGGREGATION_FUNC)

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

无效的编写者提交消息

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

无效写入分配

请求的写入分发无效。

有关详细信息，请参阅 INVALID_WRITE_DISTRIBUTION

隔离命令失败

未能执行 <command>。命令输出：

<output>

隔离命令未知故障

未能执行 <command>。

联接条件不是布尔类型

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

KAFKA_数据丢失

有些数据可能已经丢失，因为它们在 Kafka 中不再可用；

数据已被 Kafka 设为过期，或者主题可能在其中的所有数据处理完毕之前

已被删除。

如果不希望流式查询在这种情况下失败，请将源选项 failOnDataLoss 设置为 false。

原因：

有关更多详情，请参阅 KAFKA_DATA_LOSS

KINESIS_无法读取分片至结束偏移量

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

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

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

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

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

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

KINESIS_EFO_CONSUMER_NOT_FOUND

SQLSTATE：51000

对于 kinesis 流 <streamId>，已删除以前注册的流 EFO 使用者 <consumerId>。

重启查询，以便注册新的使用者。

KINESIS_EFO_SUBSCRIBE_LIMIT_EXCEEDED（超出 Kinesis EFO 订阅限制）

SQLSTATE：51000

对于分片 <shard>，上一次 subscribeToShard API 调用在下一次调用的 5 秒内。

在 5 秒或更长时间后重启查询。

KINESIS_FETCHED_SHARD_LESS_THAN_TRACKED_SHARD（Kinesis 获取的分片小于追踪的分片）

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

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

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

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

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

KINESIS_POLLING_MODE_UNSUPPORTED

不支持 Kinesis 轮询模式。

KINESIS_RECORD_SEQ_NUMBER_ORDER_VIOLATION（Kinesis记录序列号顺序违反）

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

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

畸形的_AVRO_消息

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

格式错误的字符编码

使用 <function> 执行 <charset> 时找到的值无效

错误格式的CSV记录

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

格式错误的日志文件

日志文件格式不正确：无法从 <text> 中读取正确的日志版本。

格式错误的_PROTOBUF_消息

在消息反序列化中检测到格式不正确的 Protobuf 消息。分析模式：<failFastMode>。若要将格式不正确的 protobuf 消息作为 null 结果处理，请尝试将选项“mode”设置为“PERMISSIVE”。

解析中的记录格式错误

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

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

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

格式错误变体

变体二进制格式不正确。请检查数据源是否有效。

MANAGED_ICEBERG_OPERATION_NOT_SUPPORTED

托管冰山表不支持 <operation>。

MANAGED_TABLE_WITH_CRED

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

物化视图_MESA_刷新_无_PIPELINE_ID

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

物化视图操作不允许

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

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

物化视图输出未明确别名

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

流式查询上的物化视图无效

无法使用流式处理查询来创建具体化视图 <name>。请在您的CREATE [OR REFRESH] STREAMING TABLE子句中使用STREAM或删除FROM关键字，以便将此关系转换为批处理查询。

物化视图不支持的操作

具体化视图目前不支持操作 <operation>。

会话中的变量数量已超出最大限制

SQLSTATE：54KD1

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

每次获取的记录数对Kinesis源无效

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

合并基数违法

SQLSTATE：23K01

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

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

合并无条件执行

WHEN 语句中必须至少包含一个 MERGE 子句。

指标约束不受支持

未启用 METRIC CONSTRAINT。

METRIC_STORE_INVALID_ARGUMENT_VALUE_ERROR

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

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

聚合缺失

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

MULTIPLE_LOAD_PATH（多重加载路径）

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

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

生成单个数据帧，请加载

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

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

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

多个匹配的约束条件

SQLSTATE：42891

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

多重查询结果子句与管道运算符

<clause1> 和 <clause2> 无法使用“|>”在同一 SQL 管道操作符中共存。请将多个结果子句分隔为单独的管道操作符，然后再次重试查询。

多次时间旅行规范

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

多个_XML_数据来源

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

MULTI_ALIAS_WITHOUT_GENERATOR

<names> 不支持多部分别名 (<expr>)，因为它不是生成器函数。

多源不支持表达式

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

不支持多语句事务

未能执行该语句。

有关详细信息，请参阅MULTI_STATEMENT_TRANSACTION_NOT_SUPPORTED

MULTI_STATEMENT_TRANSACTION_NO_ACTIVE_TRANSACTION

没有活动事务到<action>。

多UDF接口错误

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

互斥条款

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

MV_ST_改变查询不正确的支持类型

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

不支持命名参数

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

不支持用于SQL UDF的命名参数

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

已禁用命名参数支持

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

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

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

命名空间已存在

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

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

命名空间不为空

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

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

命名空间未找到

找不到命名空间 <nameSpaceName>。请验证该命名空间的拼写和正确性。

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

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

NATIVE_IO_ERROR（本地输入/输出错误）

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

非分区列

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

不支持流媒体中的非时间窗口

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

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

不允许在来源中

FROM 子句中不允许：

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

不允许在管道操作符WHERE中使用

管道 WHERE 子句中不允许：

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

NOT_A_CONSTANT_STRING

用于例程或 <expr> 子句的表达式 <name> 必须是 STRING 的常量 NOT NULL。

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

不是分区表

不允许对 <operation> 执行操作 <tableIdentWithDB>，因为它不是已分区表。

NOT_A_SCALAR_FUNCTION

<functionName> 此处显示为标量表达式，但函数定义为表函数。请更新查询以将函数调用移动到 FROM 子句中，或者将 <functionName> 重新定义为标量函数。

不是表函数

<functionName> 此处显示为表函数，但函数定义为标量函数。请更新查询以将函数调用移动到 FROM 子句外部，或者将 <functionName> 重新定义为表函数。

NOT_NULL_ASSERT_VIOLATION

NULL 值出现在不可为 null 的字段中：<walkedTypePath>如果架构是从 Scala 元组/大小写类或 Java bean 推断的，请尝试使用 scala.Option[_]，或其他可为 null 的类型（如 java.lang.Integer 而不是 int/scala.Int）。

非空约束违规

此处不允许分配 NULL。

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

不支持的更改列

ALTER TABLE ALTER / CHANGE COLUMN 不支持将 <table> 的类型为 <originName> 的列 <originType> 更改为类型为 <newName> 的 <newType>。

不支持更改相同列

ALTER TABLE ALTER / CHANGE COLUMN 不支持在同一命令中多次更改 <table>其列 <fieldName> ，包括其嵌套字段。

不支持V2表格命令

v2 表不支持 <cmd>。

不支持不含 Hive 支持的命令

不支持 <cmd>，如果要启用它，请将“spark.sql.catalogImplementation”设置为“hive”。

NOT_SUPPORTED_IN_JDBC_CATALOG

数字表值别名不匹配

SQLSTATE：42826

给定别名的数目与输出列数不匹配。

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

未提供 OAUTH_CUSTOM_IDENTITY_CLAIM

SQLSTATE：22KD2

未提供自定义标识声明。

此处仅支持秘密功能

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

仅支持UC_SQL_CONNECTOR

只有支持 Unity Catalog 的 Databricks SQL 连接器才支持 SQL 操作 <operation>。

操作已取消

SQLSTATE：HY008

操作已取消。

操作需要 Unity 目录

SQLSTATE：0AKUD

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

操作不支持：只读模式

SQLSTATE：42KD1

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

按位置排序超出范围

SQLSTATE：42805

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

PARQUET_CONVERSION_FAILURE

无法为 Parquet 类型为<dataType>的数据类型 <parquetType> 创建 Parquet 转换器。

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

PARQUET类型非法

非法 Parquet 类型：<parquetType>。

PARQUET_TYPE_NOT_RECOGNIZED

无法识别的 Parquet 类型：<field>。

PARQUET类型不被支持

尚不支持 Parquet 类型：<parquetType>。

PARSE_EMPTY_STATEMENT

SQLSTATE：42617

语法错误，意外空语句。

PARSE_MODE_UNSUPPORTED

<funcName> 模式不支持函数 <mode>。可接受的模式为 PERMISSIVE 和 FAILFAST。

解析语法错误

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

分区已存在

SQLSTATE：428FT

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

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

分区未找到

SQLSTATE：428FT

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

请验证分区规范和表名。

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

分区列在模式中未找到

在架构 <column> 中找不到分区列 <schema>。请提供用于分区的现有列。

分区位置已存在

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

分区位置不在表目录下

SQLSTATE：42KD5

无法执行 ALTER TABLE SET PARTITION LOCATION 语句，因为

分区位置 <location> 不在表目录 <table> 下。

若要修复此问题，请将分区的位置设置为 <table> 的子目录。

PARTITION_METADATA

不允许对表 <action> 执行 <tableName>，因为 Unity Catalog 中不支持存储分区元数据。

分区编号不匹配

值 (<partitionNumber>) 的数量与架构大小 (<partitionSchemaSize>) 不匹配：值为 <partitionValues>，架构为 <partitionSchema>，文件路径为 <urlEncodedPath>。

请重新具体化表或联系所有者。

分区转换表达式不在分区中

SQLSTATE：42S23

表达式 <expression> 必须位于“partitionedBy”内。

路径已存在

路径 <outputPath> 已存在。请将模式设置为“overwrite”以覆盖现有路径。

路径未找到

路径不存在：<path>。

PHOTON_反序列化_PROTOBUF_内存限制_已超出

反序列化 Photon protobuf 计划至少需要 <size> 个字节数，超过

<limit> 个字节的限制。这可能是由于非常大的计划或存在非常

宽的架构。尝试简化查询、删除不必要的列或禁用 Photon。

PHOTON序列化的PROTOBUF内存限制已超出

序列化的 Photon protobuf 计划的大小为 <size> 字节数，超过

<limit> 个字节的限制。计划中数据类型的序列化大小为 <dataTypeSize> 个字节。

这可能是由于非常大的计划或存在非常宽的架构。

请考虑重写查询，以删除不需要的操作和列或禁用 Photon。

管道操作符聚合表达式不包含聚合函数

非分组表达式 <expr> 作为管道运算符的参数 |> AGGREGATE 提供，但不包含任何聚合函数;请更新它以包含聚合函数，然后再次重试查询。

管道操作符_包含聚合函数

使用管道运算符<expr>子句时不允许聚合函数|> <clause>;请改用管道运算符|> AGGREGATE子句。

透视值数据类型不匹配

透视值“<value>”无效：值数据类型 <valueType> 与透视列数据类型 <pivotType> 不匹配。

策略已存在

无法创建策略 <policyName> ，因为它已存在。

选择其他名称或删除现有策略以容忍预先存在的连接。

策略_未找到

Python 流式处理数据源执行 <action> 时失败：<msg>

查询表与列掩码策略不兼容

SQLSTATE：428HD

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

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

查询的表与行级安全策略不兼容

SQLSTATE：428HD

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

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

查询执行超时时间已超出

SQLSTATE：57KD0

由于超时（<timeoutSec>秒）而取消了查询执行。可以通过设置 <config>来增加限制（以秒为单位）。

查询结果写入云存储权限错误

工作区内部存储配置可防止 Databricks 访问云存储。

无法找到当前文件

<message>

可能已更新基础文件。可在 SQL 中运行“REFRESH TABLE tableName”命令或重新创建所涉及的数据集/数据帧，显式地使 Spark 中的缓存失效。

READ_FILES_AMBIGUOUS_ROUTINE_PARAMETERS

为 <functionName> 函数调用设置了 <parameterName> 和 <alternativeName>，它们是彼此的别名。请仅设置其中一个。

READ_FILES_CREDENTIALS_PARSE_ERROR

所需参数已按位置提供

已在没有名称的位置 <routineName> 分配例程 <parameterName> 的必需参数 <positionalIndex>。

请更新函数调用以删除此参数带 <parameterName> 的命名参数，或删除

位于 <positionalIndex> 的位置参数，然后重试查询。

必需的参数未找到

无法调用例程 <routineName>，因为需要名为 <parameterName> 的参数，但例程调用未提供值。请更新例程调用，以（在索引 <index> 按位置或按名称）提供参数值，然后重试查询。

需要单一部分命名空间

<sessionCatalog> 需要单部分命名空间，但收到了 <namespace>。

救援数据列与单一变体冲突

“rescuedDataColumn”DataFrame API 读取器选项与“singleVariantColumn”DataFrame API 选项互斥。

请删除其中一项，然后再次重试 DataFrame 操作。

写入时保留的CDC列

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

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

这些列，或者将

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

受限流媒体选项权限已强制执行

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

有关详细信息，请参阅 RESTRICTED_STREAMING_OPTION_PERMISSION_ENFORCED

例程已存在

SQLSTATE：42723

无法创建 <newRoutineType> <routineName>，因为该名称的 <existingRoutineType> 已存在。

选择其他名称、删除或替换现有 <existingRoutineType>，或者添加 IF NOT EXISTS 子句以容许现有 <newRoutineType>。

未找到例程

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

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

若要在放置时容忍错误，请使用DROP ... IF EXISTS。

找不到例程参数

例程 <routineName> 不支持位置 <parameterName> 处指定的参数 <pos>。<suggestion>

例程使用系统保留的类名

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

行级安全与ABAC不匹配

无法解析 <tableName> 上的行筛选器，因为从策略继承的行筛选器与显式定义的行筛选器之间存在不匹配。若要继续，请禁用基于属性的访问控制（ABAC），并联系 Databricks 支持部门。

行级安全检查约束不支持

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

行级安全重复列名称

SQLSTATE：42734

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

ROW_LEVEL_SECURITY_FEATURE_NOT_SUPPORTED

SCALAR_SUBQUERY_IS_IN_GROUP_BY_OR_AGGREGATE_FUNCTION

相关的标量查询“<sqlExpr>”既不存在于 GROUP BY 中，也不存在于聚合函数中。

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

标量子查询返回行数过多 (SCALAR_SUBQUERY_TOO_MANY_ROWS)

SQLSTATE：21000

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

已存在的时间表

无法添加 <scheduleType> 到已具有 <existingScheduleType> 的表。请删除现有计划或使用 ALTER TABLE ... ALTER <scheduleType> 更改它。

调度期无效

<timeUnit> 的计划期限必须是介于 1 和 <upperBound> （含）之间的整数值。已收到：<actual>。

SCHEMA_ALREADY_EXISTS

SQLSTATE：42P06

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

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

SCHEMA_NOT_EMPTY

SQLSTATE：2BP01

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

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

模式未找到

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

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

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

模式注册表配置错误

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

第二个函数参数不是整数 (SECOND_FUNCTION_ARGUMENT_NOT_INTEGER)

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

秘密功能_位置无效

无法使用对 <commandType> 函数的一个或多个非加密引用执行 SECRET 命令；请使用 AES_ENCRYPT 加密每个此类函数调用的结果，然后重试该命令

种子表达式是不可展开的

SQLSTATE：42K08

表达式 <seedExpr> 的种子表达式 <exprWithSeed> 必须可折叠。

服务器正忙

SQLSTATE：08KD1

服务器正忙，无法处理该请求。请稍等片刻，然后重试。

SFTP_无法连接

SQLSTATE：08006

因此，它不支持状态数据源中的 snapshotStartBatchId 或 readChangeFeed 选项。

状态存储状态模式文件阈值超限

状态架构文件数 <numStateSchemaFiles> 超过此查询的最大状态架构文件数：<maxStateSchemaFiles>。

已添加：<addedColumnFamilies>，已删除：<removedColumnFamilies>

请将“spark.sql.streaming.stateStore.stateSchemaFilesThreshold”设置为更高的数字，或还原状态架构修改

状态存储_在缺失的列族上不支持的操作

不支持对缺少的列系列“<operationType>”执行状态存储操作“<colFamilyName>”。

STATE_STORE_VALUE_SCHEMA_EVOLUTION_THRESHOLD_EXCEEDED（状态存储值模式演变阈值超出）

<numSchemaEvolutions> 的状态架构演变数超过了允许此列系列的最大状态架构演变数（<maxSchemaEvolutions>）。

有冲突的列系列：<colFamilyName>

请将“spark.sql.streaming.stateStore.valueStateSchemaEvolutionThreshold”设置为更大的数值，或恢复状态架构修改。

状态存储不支持以可变大小排序的列

范围扫描编码器不支持名称为“<fieldName>”、索引为“<index>”的变量大小排序列。

静态分区列在插入列列表中

SQLSTATE：42713

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

STDS_COMMITTED_BATCH_UNAVAILABLE

SQLSTATE：KD006

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

性病冲突选项

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

STDS_无法读取操作员元数据

未能读取 checkpointLocation=<checkpointLocation> 和 batchId=<batchId> 的运算符元数据。

文件不存在，或者文件已损坏。

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

STDS_未能读取状态模式

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

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

STDS_INVALID_OPTION_VALUE

源选项“<optionName>”的值无效：

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

必须指定“<optionName>”。

不支持状态操作符的流式AQE

结构化流式处理中的有状态运算符不支持自适应查询执行。

从物化视图流式传输

无法从具体化视图 <viewName> 流式处理。不支持从具体化视图流式处理。

流式输出模式

流式处理输出模式无效：<outputMode>。

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

流媒体实时模式

流式处理实时模式具有以下限制：

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

流式有状态运算符在状态元数据中不匹配

流式处理的有状态运算符名称与状态元数据中的运算符不匹配。当用户添加/删除/更改现有流式处理查询的有状态运算符时，可能会发生这种情况。

元数据中的有状态运算符：[<OpsInMetadataSeq>]；当前批次中的有状态运算符：[<OpsInCurBatchSeq>]。

流媒体表需要刷新

需要刷新流式处理表 <tableName> 才能执行 <operation>。

如果表是从 DBSQL 中创建的，请运行 REFRESH STREAMING TABLE。

如果表是由 DLT 中的管道创建的，请运行管道更新。

不支持流式表

只能在 DLT 和 Databricks SQL 数据仓库中创建和刷新流式处理表。

不允许流表操作

不允许 <operation> 操作：

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

流表查询无效

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

找不到Kinesis的流STREAM_NOT_FOUND_FOR_KINESIS_SOURCE

SQLSTATE：42K02

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

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

结构数组长度不匹配

SQLSTATE：2201E

输入行不包含架构所需的预期值数。提供 <expected> 值时，<actual> 字段是必填字段。

限制和偏移量之和超出最大整数限制

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

SYNC_METADATA_DELTA_ONLY

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

同步源目标表不一致

SQLSTATE：42KD2

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

SYNTAX_DISCONTINUED

在此上下文中，已停止支持子句或关键字：<clause>。

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

表或视图已存在

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

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

未找到表或视图

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

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

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

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

尚未为 SQL 函数实现的表值参数

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

表值函数在Python中分析失败

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

表值函数所需的元数据与调用不兼容

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

表值函数所需的元数据无效

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

表值函数表参数过多

SQLSTATE：54023

表值函数的表参数太多。

允许一个表参数，但收到了：<num>。

如果要设置为允许，请将“spark.sql.allowMultipleTableArguments.enabled”设置为“true”

找不到具有指定ID的表

找不到 ID 为 <tableId> 的表。请验证 UUID 是否正确。

任务写入失败 (TASK_WRITE_FAILED)

将行写入 <path> 时任务失败。

临时表或视图已存在

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

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

临时视图名称包含过多名称部分

SQLSTATE：428EK

CREATE TEMPORARY VIEW 或相应的数据集 API 仅接受单部分视图名称，但收到了：<actualName>。

SELECT 中的尾随逗号

在子句 SELECT 中检测到尾随逗号。删除 FROM 子句前的尾随逗号。

转置超出行限制

SQLSTATE：54006

行数超过<maxValues>的允许限制为TRANSPOSE。如果这是预期的，请将 <config> 设置为至少与当前行数相同。

转置操作中无效的索引列

SQLSTATE：42804

由于 TRANSPOSE，索引列 <reason> 无效。

无最小公共类型的转置

转置要求非索引列共享一个最低的公共类型，但<dt1>和<dt2>不满足这一条件。

触发间隔无效

触发器间隔必须是可以转换为整数秒的正持续时间。接收时间：<actual> 秒。

UC_BUCKETED_TABLES

Unity Catalog 中不支持存储桶表。

未提供UC目录名称

对于 Unity Catalog，请显式指定目录名称。例如 SHOW GRANT your.address@email.com ON CATALOG main。

UC_COMMAND_NOT_SUPPORTED

Unity Catalog 不支持命令 <commandName>。

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

<errorMessage>

外部存储卷缺少位置

外部卷必须存在 LOCATION 子句。请检查用于创建外部卷的语法“CREATE EXTERNAL VOLUME ... LOCATION ...”。

UC_失败的供应状态

查询失败，因为它尝试引用表 <tableName>，但无法执行此操作：<failureReason>。请更新表 <tableName> 以确保它处于活动预配状态，然后再次重试查询。

UC_不支持用于表创建的文件方案

不支持在 Unity Catalog 中使用文件方案 <schemeName> 创建表。

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

UC_HIVE_METASTORE_联邦跨目录视图不支持

Hive 元存储联合视图不支持跨多个目录的依赖项。 Hive 元存储联合目录中的视图 <view> 必须使用 hive_metastore 或 spark_catalog 目录中的依赖项，但其依赖项 <dependency> 位于另一个目录 <referencedCatalog> 中。请更新依赖项以满足此约束，然后再次重试查询或命令。

UC_蜂巢_元存储_联邦_未启用

UC_VOLUME_NOT_FOUND

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

UDF_ENVIRONMENT_ERROR

无法为 <udfName>安装 UDF 依赖项。

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

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_ERROR

Python 辅助角色意外退出

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

UDF_PYSPARK_UNSUPPORTED_TYPE

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

UDF_PYSPARK_USER_CODE_ERROR

执行失败。

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

UDF_UNSUPPORTED_PARAMETER_DEFAULT_VALUE

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

UDF_USER_CODE_ERROR

函数 <fn> 执行失败。

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

UDTF别名数量不匹配

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

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

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

请求排序字符串中的别名无效 - 来自ANALYZE方法

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

UDTF_请求分析方法中选择的表达式无效，需要别名

未能计算用户定义的表函数，因为它的“analyze”方法返回了请求的“select”表达式 (<expression>)，但不包含相应的别名；请更新 UDTF 以在此处指定别名，然后再次尝试查询。

无法获取内存

SQLSTATE：53200

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

无法转换为PROTOBUF消息类型

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

无法获取 Hive 表

无法提取 Hive 数据库 <dbName> 的表。错误类名称：<className>.

无法推断架构

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

未经授权的访问

未授权访问：

<report>

未绑定的SQL参数

SQLSTATE：42P02

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

UNCLOSED_BRACKETED_COMMENT

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

意外输入类型

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

命名参数的输入类型意外

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

意外操作符_在流视图中

SQLSTATE：42KDD

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

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

意外的定位参数

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

类的意外序列化器

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

未知字段异常

分析期间遇到 <changeType>：<unknownFieldBlob>，可通过自动重试 <isRetryable> 进行修复：

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

UNKNOWN_POSITIONAL_ARGUMENT

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

未知的变体中基本类型

在变体值中找到 ID 为 <id> 的未知基元类型。

未知_PROTOBUF_消息类型

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

UNPIVOT_REQUIRES_ATTRIBUTES

SQLSTATE：42K0A

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

UNPIVOT要求值列

SQLSTATE：42K0A

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

取消透视值数据类型不匹配

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

反透视值大小不匹配

SQLSTATE：428C4

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

未识别的参数名称 (UNRECOGNIZED_PARAMETER_NAME)

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

未识别的SQL类型

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

未识别的统计数据

无法识别统计信息 <stats>。有效统计信息包括 count、count_distinct、approx_count_distinct、mean、stddev、min、max 和百分位值。百分位必须是数字值，后跟“%”，范围介于 0% 到 100%。

未解析的表值函数

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

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

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

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

UNRESOLVED_ALL_IN_GROUP_BY

SQLSTATE：42803

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

未解析的列

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

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

UNRESOLVED_FIELD

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

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

未解决的插入或替换使用栏

REPLACE USING 列 <colName> 无法在 <relationType> 中解析。

您是否指的是以下列之一？ [<suggestion>]。

未解析的映射键

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

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

未解决的例程

无法解析搜索路径 <routineName> 上的例程 <searchPath>。

验证 <routineName>的拼写，检查例程是否存在，并确认你对目录和架构具有 USE 权限，以及对例程具有 EXECUTE 权限。

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

未解决的使用列进行连接

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

未解决的变量

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

非结构化数据处理不支持的文件格式

不支持非结构化文件格式 <format>。支持的文件格式为 <supportedFormats>。

请将 format 表达式中的 <expr> 更新为受支持的格式之一，然后再次重试查询。

非结构化数据处理不支持的模型选项

不支持非结构化模型选项（'<option>' -> ''<value>）。支持的值为： <supportedValues>。

切换到其中一个受支持的值，然后再次重试查询。

UNSTRUCTURED_OCR_COLUMN_NOT_ALLOWED_WITH_METADATA_MODEL_OPTION

指定“metadataModel”选项时，函数参数“ocrText”必须是NULL，或者被省略。指定的“metadataModel”选项会触发数据提取功能，并禁止使用提供的“ocrText”。

不支持的添加文件

不支持添加文件。

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

不支持的修改列参数

不支持使用 <parameter> 指定 ALTER <commandTableType>。

不支持的箭头类型

不支持的箭头类型 <typeName>。

不支持的批量表值函数

函数 <funcName> 不支持批处理查询。

不支持的调用

无法调用“<methodName>”类的“<className>”方法。

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

UNSUPPORTED_CHAR_OR_VARCHAR_AS_STRING

不能在表架构中使用 char/varchar 类型。

如果希望 Spark 将其视为与 Spark 3.0 及更早版本所视为的相同字符串类型，请将“spark.sql.legacy.charVarcharAsString”设置为“true”。

不支持的操作条款

<clause> 不支持 <operation>。

不支持的排序规则

排序规则 <collationName> 不受支持：

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

不支持的文件流源的通用祖先位置

应向 UC 注册源路径和 sourceArchiveDir 的公共上级。

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

运算符不支持的表达式

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

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

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

不支持的参数表达式

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

参数可以是变量或文本。

无效表达式：[<invalidExprSql>]

不支持窗口的表达式

SQLSTATE：42P20

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

不支持的功能

不支持该功能：

有关详细信息，请参阅 UNSUPPORTED_FEATURE

不受支持的功能类型

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

不支持的生成器

不支持生成器：

有关详细信息，请参阅 UNSUPPORTED_GENERATOR

不支持的分组表达式

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

不支持的Kinesis源初始位置和触发器对

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

UNSUPPORTED_INSERT

无法插入目标。

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

单传递分析器无法处理此查询或命令，因为它尚不支持 <feature>。

不支持无水印的流操作符

<outputMode> 在没有水印的流式处理 DataFrame/数据集上不支持 <statefulOperator> 输出模式。

视图不支持的流选项

使用类型化的 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。

升级不支持

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

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

用户定义函数

用户定义函数无效：

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

USER_RAISED_EXCEPTION

SQLSTATE：P0001

<errorMessage>

用户引发的异常：参数不匹配

SQLSTATE：P0001

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

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

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

用户引发异常_未知错误类

SQLSTATE：P0001

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

变量已存在

SQLSTATE：42723

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

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

变量未找到

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

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

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

VARIANT_CONSTRUCTOR_SIZE_LIMIT

无法构造大于 16 MiB 的变体。变体值的最大允许大小为 16 MiB。

VARIANT_DUPLICATE_KEY (变体重复键)

由于对象键 <key> 重复，无法构建变体。

VARIANT_SIZE_LIMIT

无法在 <sizeLimit> 中生成大于 <functionName> 的变体。

请避免在此表达式中输入较大的字符串（例如，添加函数调用来检查表达式大小，如果太大，则首先将其转换为 NULL）。

视图已存在

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

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

视图超过最大嵌套深度

SQLSTATE：54K00

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

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

视图未找到

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

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

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

卷已经存在

命令与对象类型不匹配

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

WRONG_NUM_ARGS

SQLSTATE：42605

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

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

XML行标签缺失

SQLSTATE：42KDD

<rowTag> 是以 XML 格式读取/写入文件所需的选项。

XML_不支持的嵌套类型

SQLSTATE：0N000

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

XML通配符数据恢复冲突错误

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

ZORDERBY_COLUMN_DOES_NOT_EXIST (排序列不存在)

SQLSTATE：42702

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

创建表时的DELTA模糊路径

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

可以从 LOCATION 语句中删除 CREATE TABLE 子句，也可以设置

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

已归档文件在限制内

SQLSTATE：42KDC

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

扫描中的增量归档文件

SQLSTATE：42KDC

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

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

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

DELTA_BLOCK_COLUMN_MAPPING_AND_CDC_OPERATION

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

DELTA_BLOOM_FILTER_DROP_ON_NON_EXISTING_COLUMNS

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

增量布隆过滤器写入时内存不足

SQLSTATE：82100

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

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

DELTA_CANNOT_CHANGE_DATA_TYPE

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

DELTA_CANNOT_CHANGE_LOCATION

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

DELTA_无法更改供应商

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

无法为不存在的列创建布隆过滤器_DELTA

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

DELTA_无法创建日志路径

SQLSTATE：42KD5

无法创建 <path>

无法描述视图历史的Delta操作或功能限制

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

无法在非索引列上删除布隆过滤器

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

DELTA_CANNOT_DROP_CHECK_CONSTRAINT_FEATURE

无法删除 CHECK 约束表功能。

必须先删除以下约束：<constraints>。

DELTA_CANNOT_DROP_COLLATIONS_FEATURE

无法删除排序规则表功能。

具有非默认排序规则的列必须更改为首先使用 UTF8_BINARY：<colNames>。

DELTA_无法评估表达式

无法计算表达式：<expression>

无法找到桶规格_DELTA

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

DELTA_无法为表达式生成代码

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

无法修改仅追加的DELTA

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

不能修改协调提交的依赖关系

<Command> 无法替代或取消设置提交中的时间戳表属性，因为在此表中启用了协调提交，并依赖于这些提交。请从 TBLPROPERTIES 子句中删除它们（“delta.enableInCommitTimestamps”、“delta.inCommitTimestampEnablementVersion”、“delta.inCommitTimestampEnablementTimestamp”），然后再次重试该命令。

DELTA_无法修改表属性

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

无法覆盖协调提交的配置 (DELTA_CANNOT_OVERRIDE_COORDINATED_COMMITS_CONFS)

<Command> 无法替代现有目标表的协调提交配置。请从 TBLPROPERTIES 子句中删除它们（“delta.coordinatedCommits.commitCoordinator-preview”、“delta.coordinatedCommits.tableConf-preview”），然后再次重试该命令。

无法从URI重建路径的DELTA

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

DELTA_CANNOT_RELATIVIZE_PATH

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

DELTA_CAST_OVERFLOW_IN_TABLE_WRITE（表写入中的DElta转换溢出）

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

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

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

增量变更表已禁用

SQLSTATE：42807

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

DELTA_检查点_不可用表

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

DELTA_CLONE_AMBIGUOUS_TARGET

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

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

<targetIdentifier>。

DELTA_CLONE_INCOMPATIBLE_SOURCE

克隆源具有有效的格式，但具有 Delta 不支持的功能

有关详细信息，请参阅DELTA_CLONE_INCOMPATIBLE_SOURCE

DELTA_克隆_不完整_文件_复制

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

增量克隆不支持的源

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

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

DELTA_CLONE_WITH_HISTORY_UNSUPPORTED_SOURCE

不支持的源表：

有关详细信息，请参阅DELTA_CLONE_WITH_HISTORY_UNSUPPORTED_SOURCE

DELTA_CLONE_WITH_HISTORY_UNSUPPORTED_TARGET

不支持的目标表：

有关详细信息，请参阅DELTA_CLONE_WITH_HISTORY_UNSUPPORTED_TARGET

DELTA_CLUSTERING_CLONE_TABLE_NOT_SUPPORTED（不支持DELTA聚类克隆表）

不支持 DBR 版本 CLONE 的 Liquid 群集 Delta 表中的 < 14.0。

DELTA 聚类列的数据类型不支持

不支持 CLUSTER BY，因为以下列 <columnsWithDataTypes> 不支持跳过数据。

DELTA聚类列不匹配

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

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

DELTA_CLUSTERING_COLUMN缺少统计数据

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

<schema>

DELTA_CLUSTERING_CREATE_EXTERNAL_NON_LIQUID_TABLE_FROM_LIQUID_TABLE (用于从流动表创建外部非流动表的Delta群集操作)

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

不支持DELTA聚类

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

DELTA_集群_阶段_失败

无法使用 <phaseOutType> 表功能完成表的 <tableFeatureToAdd>（原因：<reason>）。请再次尝试 OPTIMIZE 命令。

== 错误 ==

<error>

数据聚类将表替换为分区表

不允许使用已分区表 REPLACE 使用 Liquid 聚类分析的 Delta 表。

DELTA_CLUSTERING_SHOW_CREATE_TABLE_WITHOUT_CLUSTERING_COLUMNS

无任何聚类分析列的 Liquid 聚类分析 Delta 表不支持 SHOW CREATE TABLE。

保持原英文标识符不变以确保技术准确性：DELTA_CLUSTERING_TO_PARTITIONED_TABLE_WITH_NON_EMPTY_CLUSTERING_COLUMNS

在架构中找不到DELTA列

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

<tableSchema>

DELTA列路径未嵌套

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

嵌套字段中 <column> 的索引。

架构：

<schema>

DELTA_COLUMN_STRUCT_TYPE_MISMATCH（Delta列结构类型不匹配）

SQLSTATE：2200G

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

增量提交中间重定向状态

无法处理重定向表状态“<state>”内表的提交。

DELTA_压缩验证失败

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

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

不支持在命令中覆盖 DELTA 配置

在 <command> 期间，无法从命令设置配置“<configuration>”。请将其从 TBLPROPERTIES 子句中移除，然后再次重试该命令。

DELTA_CONF_OVERRIDE_NOT_SUPPORTED_IN_SESSION (在会话中不支持 Delta 配置覆盖)

在 <command> 期间，无法从 SparkSession 配置设置配置“<configuration>”。请通过运行 spark.conf.unset("<configuration>") 来取消设置它，然后再次重试该命令。

DELTA_CONSTRAINT_ALREADY_EXISTS

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

旧约束：

<oldConstraint>

DELTA_CONSTRAINT_DATA_TYPE_MISMATCH

列 <columnName> 具有数据类型 <columnType>，无法更改为数据类型 <dataType>，因为以下检查约束引用了此列：

<constraints>

增量约束依赖列更改

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

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

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

SET <statisticsCollectionPropertyKey> = 真

在没有 NO CONVERT 选项的情况下运行 DELTA TO STATISTICS。

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

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

RESET <rowTrackingTableFeatureDefaultKey>

通过运行以下命令停用默认表属性：

SET <rowTrackingDefaultPropertyKey> = false

DELTA_COPY_INTO_TARGET_FORMAT

COPY INTO 目标必须是 Delta 表。

DELTA_创建外部表时没有架构

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

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

未指定架构。

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

DELTA_创建外部表_无事务日志

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

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

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

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

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

增量创建表标识符位置不匹配

不支持创建具有不同位置的基于路径的 Delta 表。标识符：<identifier>，位置：<location>

缺少表名或位置的DELTA_CREATE_TABLE错误

必须指定表单名称或位置。

DELTA_创建表_模式不匹配

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

== 指定的 ==

<specifiedSchema>

== 现有 ==

<existingSchema>

== 差异 ==

<schemaDifferences>

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

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

架构匹配。

DELTA创建表设置聚类表功能不允许

无法使用 <tableFeature> 启用 TBLPROPERTIES 表功能。请使用 CREATE 或 REPLACE TABLE CLUSTER BY 创建包含聚类分析的 Delta 表。

DELTA_创建不同聚簇的表

指定的聚类分析列与 <path> 的现有聚类分析列不匹配。

== 指定的 ==

<specifiedColumns>

== 现有 ==

<existingColumns>

DELTA_创建带有不同分区的表

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

== 指定的 ==

<specifiedColumns>

== 现有 ==

<existingColumns>

DELTA_使用不同属性创建表

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

== 指定的 ==

<specifiedProperties>

== 现有 ==

<existingProperties>

DELTA_在非空位置创建表

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

DELTA_DATA_CHANGE_FALSE

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

DELTA_删除的_PARQUET_文件_未找到

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

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

增量删除向量缺少记录数量

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

不支持域元数据更改

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

DELTA_DROP_COLUMN_AT_INDEX_LESS_THAN_ZERO (删除列时，索引不能小于零)

SQLSTATE：42KD8

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

DELTA_DROP_COLUMN_ON_SINGLE_FIELD_SCHEMA

无法从具有单个列的架构中删除列。架构：

<schema>

DELTA_DUPLICATE_ACTIONS_FOUND

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

它与 <conflictingPath> 冲突。

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

发现重复的列

SQLSTATE：42711

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

DELTA_DUPLICATE_COLUMNS_ON_INSERT

INSERT 子句中的重复列名

DELTA_DUPLICATE_COLUMNS_ON_UPDATE_TABLE

<message>

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

DELTA_重复数据跳过列

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

DELTA_DUPLICATE_DOMAIN_METADATA_INTERNAL_ERROR

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

DELTA_DV_HISTOGRAM_DESERIALIZATION

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

DELTA_动态分区覆盖_禁用

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

DELTA_EMPTY_DATA (数据为空)

SQLSTATE：428GU

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

DELTA_EMPTY_DIRECTORY

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

DELTA_EXCEED_CHAR_VARCHAR_LIMIT（字符或可变字符长度超出限制）

SQLSTATE：22001

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

分区值转换失败

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

DELTA_无法在输出列中找到属性

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

DELTA_推断模式失败

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

DELTA_FAILED_MERGE_SCHEMA_FILE

SQLSTATE：42KDA

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

<schema>

DELTA_浅层克隆操作失败

SQLSTATE：42893

由于浅克隆<sourceTable>仍然存在，并且其中发生了以下错误：<targetTable>，所以无法在源表<message>上运行操作。

DELTA_读取文件尾部失败

SQLSTATE：KD001

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

DELTA_FAILED_RECOGNIZE_PREDICATE

无法识别谓词“<predicate>”

DELTA扫描失败，具有历史版本

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

DELTA_合并字段失败

SQLSTATE：22005

未能合并字段“<currentField>”和“<updateField>”

DELTA_FEATURES_PROTOCOL_METADATA_MISMATCH

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

需要手动启用的增量功能

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

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

ALTER TABLE SET TBLPROPERTIES table_name （'delta.feature.feature_name' = 'supported'）

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

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

DELTA_FEATURE仅能通过历史截断来撤销检查点保护

无法删除检查点保护功能。

只能通过截断历史记录来删除此功能。

请使用 TRUNCATE HISTORY 选项重试：

ALTER TABLE DROP FEATURE table_name checkpointProtectionTRUNCATE HISTORY

DELTA_功能_删除_检查点_失败

SQLSTATE：22KD0

由于检查点创建失败，删除 <featureName> 失败。

请稍后再试。如果该问题仍然存在，请联系 Databricks 支持部门。

DELTA_FEATURE_DROP_CHECKPOINT保护等待保留期

SQLSTATE：22KD0

操作未成功，因为仍然存在已删除特征的痕迹。

表历史记录中。 CheckpointProtection 在这些历史版本过期之前

无法删除。

若要删除 CheckpointProtection，请等待历史版本

过期，然后重复此命令。历史版本的保持期为

当前配置为 <truncateHistoryLogRetentionPeriod>。

增量功能丢弃冲突重新验证失败

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

请重试此操作。

<concurrentCommit>

删除依赖功能

无法删除表特征 <feature>，因为此表中的一些其他特征 (<dependentFeatures>) 依赖于 <feature>。

在删除此特征之前，请考虑先删除它们。

DELTA_功能删除_未呈现功能

无法从此表中删除 <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 就足够了。

架构：

<schema>

DELTAX生成的列数据类型不匹配

列 <columnName> 具有数据类型 <columnType>，无法更改为数据类型 <dataType>，因为以下生成的列引用了此列：

<generatedColumns>

DELTA_GENERATED_COLUMNS_DEPENDENT_COLUMN_CHANGE

无法更改列 <columnName>，因为以下生成的列引用了此列：

<generatedColumns>

DELTA 生成列表达式类型不匹配

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

Delta生成列更新类型不匹配

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

DELTA_GEOSPATIAL_不受支持

此版本的 Delta Lake 不支持地理空间类型。

DELTA_GEOSPATIAL_SRID_NOT_SUPPORTED

地理空间类型具有不支持的空间参考标识符 srid：<srid>。 Delta 表仅支持非负 srid 值。

DELTA_ICEBERG_COMPAT_VIOLATION

IcebergCompatV<version> 的验证失败。

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

DELTA_ICEBERG_WRITER_COMPAT_VIOLATION

IcebergWriterCompatV<version> 的验证失败。

有关详细信息，请参阅 DELTA_ICEBERG_WRITER_COMPAT_VIOLATION

DELTA_标识列_修改列_不支持

ALTER TABLE ALTER COLUMN 列不支持 IDENTITY。

Delta_Identity_Columns_Alter_Non_Delta_Format

ALTER TABLE ALTER COLUMN SYNC IDENTITY 仅受 Delta 支持。

DELTA_IDENTITY_COLUMNS_ALTER_NON_IDENTITY_COLUMN

ALTER TABLE ALTER COLUMN SYNC IDENTITY 不能对非 IDENTITY 列调用。

DELTA 不支持对身份列的显式插入

SQLSTATE：42808

不支持为 GENERATED ALWAYS AS IDENTITY 列 <colName> 提供值。

DELTA_标识列_非法步长

SQLSTATE：42611

IDENTITY 列步长不能为 0。

增量标识列非增量格式

IDENTITY 列仅受 Delta 支持。

不支持DELTA标识列分区

不支持列 PARTITIONED BY IDENTITY 列 <colName>。

DELTA_IDENTITY_COLUMNS_REPLACE_COLUMN_NOT_SUPPORTED

具有 ALTER TABLE REPLACE COLUMNS 列的表不支持 IDENTITY。

DELTA_IDENTITY_COLUMNS_UNSUPPORTED_DATA_TYPE

SQLSTATE：428H2

<dataType> 列不支持 DataType IDENTITY。

不支持对 Delta 标识列进行更新

SQLSTATE：42808

不支持 UPDATE 列 IDENTITY 上的 <colName>。

DELTA_标识列_带有_生成的_表达式

不能使用生成的列表达式来指定 IDENTITY 列。

DELTA_非法选项

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

DELTA_非法使用

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

增量_不一致_桶规格

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

DELTA_INCONSISTENT_LOGSTORE_CONFS

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

DELTA_数组访问错误

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

添加到数组。

DELTA_使用名称访问数组时出错

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

<rightName>，而不是 <wrongName>。

架构：

<schema>

DELTA_INCORRECT_GET_CONF

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

DELTA_错误日志存储实现

在架构的列名中，发现了' ,;{}()\n\t='包含无效字符。

无效的列名：<invalidColumnNames>。

请使用其他字符，然后重试。

或者，启用列映射以继续使用这些字符。

DELTA_无效克隆路径

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

绝对路径而不是 <path>。

DELTA_移除列映射时无效的列名称

在架构的列名中，发现了' ,;{}()\n\t='包含无效字符。

无效的列名：<invalidColumnNames>。

如果列名中存在无效字符，则无法删除列映射。

请重命名列以删除该无效字符，然后再次执行此命令。

DELTA_格式无效

检测到不兼容的格式。

在 <deltaRootPath>/_delta_log 找到了 Delta 的事务日志

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

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

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

DELTA_INVALID_GENERATED_COLUMN_REFERENCES

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

DELTA无效幂等写入选项

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

DELTA_INVALID_INTERVAL

<interval> 不是有效的 INTERVAL。

DELTA_库存架构无效

指定的 INVENTORY 的架构未包含所有必填字段。必填字段为：<expectedSchema>

DELTA_无效隔离级别

无效隔离级别“<isolationLevel>”

DELTA_INVALID_LOGSTORE_CONF

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

DELTA_无效的托管表语法_无模式

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

超过最大数组大小限制

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

DELTA_MAX_COMMIT_RETRIES_EXCEEDED (超过最大提交重试次数)

SQLSTATE：40000

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

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

造成的。

提交开始于版本：<startVersion>

提交失败的版本：<failVersion>

尝试提交的操作数：<numActions>

尝试此提交所花费的总时间：<timeSpent> ms

DELTA_MAX_LIST_FILE_EXCEEDED

文件列表必须最多有 <maxFileListSize> 个条目，实际有 <numFiles> 个。

DELTA_MERGE_ADD_VOID_COLUMN

无法添加类型为 VOID 的列 <newColumn>。请显式指定非 void 类型。

DELTA_MERGE_INCOMPATIBLE_DATATYPE

未能合并不兼容的数据类型 <currentDataType> 和 <updateDataType>

不兼容的十进制类型合并在DELTA中

SQLSTATE：42806

无法将十进制类型与不兼容的 <decimalRanges> 合并

DELTA合并物化源反复失败

使 MERGE 语句的源保持具体化状态反复失败。

DELTA_MERGE_MISSING_WHEN

WHEN 语句中必须至少包含一个 MERGE 子句。

DELTA_合并_已解决_属性_缺失_自输入

运算符 <missingAttributes> 中的 <input> 缺失已解析属性 <merge>

增量合并的意外分配键

SQLSTATE：22005

意外分配密钥：<unexpectedKeyClass> - <unexpectedKeyObject>

DELTA_MERGE_未解析表达式

无法解析给定 <sqlExpr> 中 <clause> 的 <cols>。

元数据变更

MetadataChangedException：Delta 表的元数据已由并发更新更改。请重试该操作。<conflictingCommit>

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

增量缺失变更数据

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

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

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

否则，若要开始记录更改数据，请使用 ALTER TABLEtable_nameSET TBLPROPERTIES'

(<key>=true)`。

DELTA_MISSING_COLUMN

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

DELTA_缺少提交信息

此表启用了特征 <featureName>，这要求每次提交中都存在 CommitInfo 操作。但是，提交版本 <version> 中缺少 CommitInfo 操作。

增量缺失提交时间戳

此表启用了特征 <featureName>，这要求 CommitInfo 操作中存在 commitTimestamp。但是，提交版本 <version> 中尚未设置此字段。

DELTA_MISSING_DELTA_TABLE

<tableName> 不是 Delta 表。

DELTA_MISSING_DELTA_TABLE_COPY_INTO

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

DELTA_缺失_冰山_类

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

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

DELTA_MISSING_NOT_NULL_COLUMN_VALUE

SQLSTATE：23502

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

DELTA_缺失的分区列

SQLSTATE：42KD6

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

DELTA_MISSING_PART_FILES (缺少部分文件)

SQLSTATE：42KD6

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

DELTA_MISSING_PROVIDER_FOR_CONVERT (缺少转换提供者)

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

DELTA_缺失设置列

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

DELTA_缺失交易日志

检测到不兼容的格式。

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

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

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

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

不支持增量模式

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

DELTA_MULTIPLE_CDC_BOUNDARY

SQLSTATE：42614

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

布隆过滤器中的单列多重配置差异

SQLSTATE：42614

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

多个源行在合并中匹配目标行

SQLSTATE：21506

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

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

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

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

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

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

<usageReference>

DELTA_MUST_SET_ALL_COORDINATED_COMMITS_CONFS_IN_COMMAND

在 <command> 期间，两个协调提交配置（“delta.coordinatedCommits.commitCoordinator-preview”、“delta.coordinatedCommits.commitCoordinatorConf-preview”）均在命令中设置或两者均未设置。缺失值：“<configuration>”。请在 TBLPROPERTIES 子句中指定此配置或移除其他配置，然后再次重试该命令。

所有协调提交确认必须在会话中设置DELTA

在 <command> 期间，两个协调提交配置（“coordinatedCommits.commitCoordinator-preview”、“coordinatedCommits.commitCoordinatorConf-preview”）均在命令中设置或两者均未设置。缺失值：“<configuration>”。请在 SparkSession 中设置此配置或取消设置其他配置，然后再次重试该命令。

DELTA_NAME_CONFLICT_IN_BUCKETED_TABLE

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

DELTA_嵌套字段需要重命名

输入架构包含大小写与目标表不同的嵌套字段。

需要重命名它们，以避免在写入 Delta 时丢失这些字段中的数据。

字段：

<fields>。

原始架构：

<schema>

增量嵌套非空约束

字段 <nestType> 的 <parent> 类型包含 NOT NULL 约束。 Delta 不支持嵌套在数组或映射中的 NOT NULL 约束。若要消除此错误并以静默方式忽略指定的约束，请设置 <configKey> = true。

分析的 <nestType> 类型：

<nestedPrettyJson>

增量嵌套子查询不支持

<operation> 条件不支持嵌套子查询。

增量_新检查约束违规

SQLSTATE：23512

<numRows> 中有 <tableName> 行违反新的 CHECK 约束 (<checkConstraint>)

DELTA_NEW_NOT_NULL_VIOLATION (新的Delta不允许为空的违规)

SQLSTATE：23512

<numRows> 中有 <tableName> 行违反 NOT NULL 上的新 <colName> 约束

Delta非布尔检查约束

CHECK 约束“<name>”(<expr>) 应是一个布尔表达式。

生成列中的非确定性表达式

已找到 <expr>。生成的列不能使用非确定性表达式。

DELTA_不支持非确定性函数

<operation> <expression> 中不支持非确定性函数

非最后匹配子句的增量忽略条件

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

DELTA_非最后组_不通过源子句匹配_排除条件

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

DELTA非最后不匹配子句省略条件

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

DELTA_NON_PARSABLE_TAG

无法分析标记 <tag>。

文件标记为：<tagList>

DELTA_NON_PARTITION_COLUMN_ABSENT

SQLSTATE：KD005

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

DELTA_非分区列引用

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

DELTA_NON_PARTITION_COLUMN_SPECIFIED (指定了非分区列)

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

DELTA_非单独部分命名空间_用于目录

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

DELTA_NON_UC_COMMIT_COORDINATOR_NOT_SUPPORTED_IN_COMMAND

不支持通过命令将提交协调器设置为“<nonUcCoordinatorName>”，因为 UC 管理的表只能将“unity-catalog”设置为提交协调器。请将其更改为“unity-catalog”，或者从 TBLPROPERTIES 子句中删除所有协调提交表属性，然后再次重试该命令。

DELTA_NON_UC_COMMIT_COORDINATOR_NOT_SUPPORTED_IN_SESSION

不支持从 SparkSession 配置中将提交协调器设置为<nonUcCoordinatorName>，因为 UC 管理的表格只能使用“unity-catalog”作为提交协调器。请通过运行 spark.conf.set("<coordinatorNameDefaultKey>", "unity-catalog") 将其更改为“unity-catalog”，或者通过运行 spark.conf.unset("<coordinatorNameDefaultKey>")、spark.conf.unset("<coordinatorConfDefaultKey>") 和 spark.conf.unset("<tableConfDefaultKey>") 从 SparkSession 配置中删除所有协调提交表属性，然后再次重试该命令。

DELTA_NOT_A_DATABRICKS_DELTA_TABLE

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

DELTA_NOT_A_DELTA_TABLE（不是一个 Delta 表）

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

找不到非空列在结构中

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

DELTA_非空约束_违反

SQLSTATE：23502

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

DELTA_不可为空的嵌套字段

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

未找到提交记录

SQLSTATE：KD006

未在 <logPath> 处找到提交

DELTA_NO_RECREATABLE_HISTORY_FOUND

SQLSTATE：KD006

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

DELTA_无重定向规则违规

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

DELTA_PROTOCOL_PROPERTY_NOT_INT (增量协议属性不是整数)

协议属性 <key> 需是整数。已找到 <value>

增量读取功能协议需要写入

无法仅升级读取器协议版本以使用表功能。写入器协议版本必须至少为 <writerVersion> 才能继续。有关表协议版本的详细信息，请参阅 <docLink>。

DELTA_READ_TABLE_WITHOUT_COLUMNS

SQLSTATE：428GU

尝试读取没有任何列的 Delta 表 <tableName>。

使用 mergeSchema = true 选项写入一些新数据，以便能够读取表。

DELTA_REGEX_OPT_SYNTAX_ERROR

SQLSTATE：2201B

请重新检查“<regExpOption>”的语法

三角关系路径不匹配

SQLSTATE：2201B

关系路径“<relation>”与 <targetType>“路径”<targetPath>不匹配。

DELTA_REPLACE_WHERE_IN_OVERWRITE

不能将 replaceWhere 与“按筛选器覆盖”结合使用

DELTA替换条件不匹配

SQLSTATE：44000

写入的数据不符合部分表覆盖条件或约束“<replaceWhere>”。

<message>

DELTA_REPLACE_WHERE_WITH_DYNAMIC_PARTITION_OVERWRITE

“replaceWhere”表达式和“partitionOverwriteMode”=“dynamic”不能在 DataFrameWriter 选项中设置。

DELTA_REPLACE_WHERE_WITH_FILTER_DATA_CHANGE_UNSET

当“dataChange”设置为 false 时，“replaceWhere”不能与数据筛选器结合使用。筛选器：<dataFilters>

DELTA_ROW_ID_ASSIGNMENT_WITHOUT_STATS（增量行ID分配缺少统计信息）

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

Collect statistics for the table by running the following code in a Scala notebook and retry:

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_模式_已更改

检测到架构更改：

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

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

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

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

增量模式已更改，包含启动选项

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

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

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

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

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

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

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

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

DELTA_架构随着版本而改变

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

流式处理源架构：<readSchema>

数据文件架构：<dataSchema>

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

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

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

增量模式分析后的模式更改

自创建 DataFrame 或 DeltaTable 对象以来，

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

更改：

<schemaDiff> <legacyFlagMessage>

未提供增量模式

SQLSTATE：42908

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

增量模式未设置

SQLSTATE：KD008

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

DELTA_设置位置模式不匹配

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

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

DELTA_SHOW_PARTITION_IN_NON_PARTITIONED_TABLE

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

DELTA源忽略删除

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

DELTA_SOURCE_TABLE_IGNORE_CHANGES（忽略更改的Delta源表）

在版本 <file> 的源表中检测到数据更新（例如 <version>）。目前不支持。如果这种情况经常发生，并且可以跳过更改，请将选项“skipChangeCommits”设置为“true”。如果你想要反映数据更新，请使用全新的检查点目录重启此查询，或者如果你使用的是 DLT，请进行完全刷新。如果需要处理这些更改，请切换到 MV。源表可以在路径 <dataPath> 中找到。

增量起始版本和时间戳均已设置

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

DELTA_STATS_COLLECTION_COLUMN_NOT_FOUND

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

增量流无法在模式演变后继续处理

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

请在我们使用最终定稿架构版本<currentSchemaChangeVersion>进行流处理之前，查看是否需要手动传播架构更改到汇聚表。

一旦您修复了目标表的架构或决定无需修复，您可以设置以下配置以解除非累加架构更改的阻碍并继续流处理。

使用数据框架读取器的选项：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeOptions>

若要解除屏蔽此特定流：

<unblockStreamOptions>

使用 SQL 配置：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeConfs>

若要解除屏蔽此特定流：

<unblockStreamConfs>

要解除所有流的阻止：

<unblockAllConfs>

无法继续处理类型扩展

我们检测到一些数据类型在 Delta 版本<previousSchemaChangeVersion>和<currentSchemaChangeVersion>之间被扩大了。

<wideningTypeChanges>

流式处理查询包含可能在类型更改后失败或产生不同结果的操作。

请在我们继续使用版本 <currentSchemaChangeVersion>最终的架构进行流处理之前，请检查是否要更新流查询。

更新流查询或决定无需更新流查询后，可以设置以下配置以取消阻止类型更改并继续流处理。

使用数据框读取选项：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeOptions>

若要解除屏蔽此特定流：

<unblockStreamOptions>

使用 SQL 配置：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeConfs>

若要解除屏蔽此特定流：

<unblockStreamConfs>

要解除所有流的阻止：

<unblockAllConfs>

增量流检查列映射无快照

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

DELTA_STREAMING_INCOMPATIBLE_SCHEMA_CHANGE

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

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

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

流式处理中的不兼容架构更改，请使用架构日志

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

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

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

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

DELTA_STREAMING_METADATA_EVOLUTION

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

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

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

更新的架构：<schema>。

更新的表配置：<config>。

更新的表协议：<protocol>

不支持的行过滤列屏蔽在 DELTA 流式模式演变中

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

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

DELTA_STREAMING_SCHEMA_LOCATION_CONFLICT

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

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

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

DELTA_STREAMING_SCHEMA_LOCATION_NOT_UNDER_CHECKPOINT

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

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

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

DELTA_流式_架构日志_解析架构失败

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

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

DELTA 表已经包含变更数据捕获列

SQLSTATE：42711

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

保留的列 <columnList>，

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

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

DELTA表已存在

表 <tableName> 已存在。

路径不支持的Hadoop配置的DELTA_TABLE

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

DELTA_TABLE_ID_MISMATCH

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

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

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

DELTA_TABLE_INVALID_REDIRECT_STATE_TRANSITION

无法更新表重定向状态：尝试状态转换无效。

Delta 表<table>无法从<oldState>更改为<newState>。

DELTA表无效的设置或取消重定向

无法对SET上的属性 UNSET 或 <table> 重定向：当前属性 '<currentProperty>' 与新属性 '<newProperty>' 不匹配。

DELTA_TABLE_LOCATION_MISMATCH

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

DELTA_TABLE_NOT_FOUND（未找到Delta表）

Delta 表 <tableName> 不存在。

DELTA表格在操作中不受支持

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

DELTA_TABLE_ONLY_OPERATION（仅限于Delta表的操作）

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

DELTA_TABLE_未识别的重定向规范

Delta 日志包含无法识别的表重定向规范“<spec>”。

最终目标表 Delta 架构为空

SQLSTATE：428GU

目标表最终架构为空。

增量时间戳大于提交时间

SQLSTATE：42816

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

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

DELTA_TIMESTAMP_INVALID

SQLSTATE：42816

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

增量时间旅行无效起始值

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

截断的增量事务日志

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

DELTA_TRUNCATE_TABLE_PARTITION_NOT_SUPPORTED（不支持的表分区截断）

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

DELTA_UDF_IN_GENERATED_COLUMN

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

意外行动表达式_delta

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

意外的Delta分区列数来自文件名

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

无预期的部分扫描异常

SQLSTATE：KD00A

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

DELTA_UNEXPECTED_PARTITION_COLUMN_FROM_FILE_NAME

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

DELTA用户意外分区架构

用于调用CONVERT TO DELTA 的分区架构不同于从目录推理的分区架构，请避免提供架构，以便可以从目录中选择分区架构。

目录分区架构：

<catalogPartitionSchema>

提供的分区架构：

<userPartitionSchema>

DELTA_统一性_兼容性位置不能更改

无法更改 delta.universalFormat.compatibility.location。

DELTA_UNIFORM_COMPATIBILITY_LOCATION_NOT_REGISTERED

SQLSTATE：42K0I

delta.universalFormat.compatibility.location 未在目录中注册。

DELTA_UNIFORM_COMPATIBILITY_MISSING_OR_INVALID_LOCATION

统一兼容性格式的位置缺失或无效。请为 delta.universalFormat.compatibility.location 设置空目录。

失败的原因：

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

DELTA_UNIFORM_ICEBERG_INGRESS_VIOLATION

具有 Delta Uniform 的 Read Iceberg 的失败。

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

待命_均匀_入口_不明确_格式

发现多个 Delta Uniform 入口格式（<formats>），最多只能设置一个。

不支持 DELTA_UNIFORM_INGRESS

不支持创建或刷新统一入口表。

DELTA_UNIFORM_入口不支持的格式

不支持格式 <fileFormat>。仅支持冰山和 hudi 作为原始文件格式。

三角形统一入口违规

无法对列 <opName> 执行列映射操作 <columnNames>

因为这些列包含布隆筛选索引。

如果你要对包含布隆筛选索引的列执行

列映射操作，

请先删除布隆筛选器索引：

DROP BLOOMFILTER INDEX ON TABLE tableName FOR COLUMNS(<columnNames>）

如果要删除表上的所有 Bloom 筛选器索引，请使用：

DROP BLOOMFILTER INDEX ON TABLE 表名

DELTA_UNSUPPORTED_COLUMN_MAPPING_PROTOCOL (DELTA不支持的列映射协议)

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

使用 <config>。

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

<requiredVersion>

表的当前 Delta 协议版本：

<currentVersion>

<advice>

DELTA 不支持的列映射模式更改

检测到架构更改：

预期表功能 <feature> 的状态是“supported”，但却是“<status>”。

DELTA_不支持字段更新_非结构型

仅 StructType 支持更新嵌套字段，但你在尝试更新类型为 <columnName> 的 <dataType> 的字段。

DELTA_UNSUPPORTED_FSCK_WITH_DELETION_VECTORS（不支持删除向量的文件系统一致性检查）

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

请联系客户支持。

DELTA_UNSUPPORTED_GENERATE_WITH_DELETION_VECTORS

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

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

因为这些列包含布隆筛选索引。

如果要使用 Bloom Filter Index（es）更改列的数据类型，

请先删除布隆筛选器索引：

DROP BLOOMFILTER INDEX ON TABLE tableName FOR COLUMNS(<columnNames>）

如果要删除表上的所有 Bloom 筛选器索引，请使用：

DROP BLOOMFILTER INDEX ON TABLE 表名

DELTA_不支持清理特定分区

清空 Delta 表时，请提供基本路径 (<baseDeltaPath>)。目前不支持清空特定分区。

DELTA不支持写入暂存表

SQLSTATE：42807

表实现不支持写入操作：<tableName>

不支持协调器的写入操作

您正尝试对已向提交协调器 <coordinatorName> 注册的表执行写入操作。但是，当前环境中不提供此协调器实现，而且不允许在没有协调器的情况下进行写入。

DELTA_UNSUPPORTED_WRITE_SAMPLE_TABLES

不支持写入示例表

DELTA_UPDATE_SCHEMA_MISMATCH_EXPRESSION

无法将 <fromCatalog> 强制转换为 <toCatalog>。所有嵌套列必须匹配。

DELTA_VACUUM_COPY_INTO_STATE_FAILED（状态复制失败）

数据文件上的 VACUUM 成功，但 COPY INTO 状态垃圾回收失败。

DELTA_VERSIONS_NOT_CONTIGUOUS

SQLSTATE：KD00C

版本 (<versionList>) 不是连续的。

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

DELTA_违反约束条件_包含值

SQLSTATE：23001

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

<values>

DELTA_VIOLATE_TABLE_PROPERTY_VALIDATION_FAILED

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

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

不支持将增量写入视图

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

DELTA_ZORDERING_COLUMN_DOES_NOT_EXIST

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

DELTA_ZORDERING_ON_COLUMN_WITHOUT_STATS

SQLSTATE：KD00D

<cols> 上的 Z 排序将

SQLSTATE：未分配

<dsError>：未找到工作区 <workspaceId>。

自动换带机

不支持添加新项

指定了架构时不支持架构演变模式 <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_重复数据中的列

尝试推断表的分区架构时出错。在数据和分区路径中复制了相同的列。若要忽略分区值，请显式地通过 .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_未找到错误

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

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

CF_FAILED_TO_WRITE_TO_SCHEMA_LOG

无法写入位于 <path> 的架构日志。

CF_FILE_FORMAT_REQUIRED (文件格式要求)

无法找到所需选项：cloudFiles.format。

CF_FOUND_MULTIPLE_AUTOLOADER_PUBSUB_SUBSCRIPTIONS

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

<subscriptionList>

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

CF_GCP_认证

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

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

<optionList>

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

CF_INVALID_MANAGED_FILE_EVENTS_RESPONSE

来自托管文件事件服务的响应无效。请联系 Databricks 支持人员获取帮助。

有关更多详情，请参阅 CF_INVALID_MANAGED_FILE_EVENTS_RESPONSE

CF_无效的模式演化模式

cloudFiles。 <schemaEvolutionModeKey> 必须是以下项之一

“<addNewColumns>”

“<failOnNewColumns>”

“<rescue>”

“<noEvolution>”

CF_INVALID_SCHEMA_HINTS_OPTION

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

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

多次重新定义列

<schemaHints>

CF_无效的架构提示列

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

CF_缺少分区列错误

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

以恢复流。请参阅：

必须为 SFTP 指定密码或密钥文件。

请在源 URI 中或通过 <passwordOption>指定密码，或通过 <keyFileOption>指定密钥文件内容。

CF_SFTP_NOT_ENABLED (SFTP功能未启用)

未启用访问 SFTP 文件。请联系 Databricks 支持人员获取帮助。

CF_SFTP_REQUIRE_UC_CLUSTER

访问 SFTP 文件需要启用 UC 的群集。请联系 Databricks 支持人员获取帮助。

CF_SFTP_USERNAME_NOT_FOUND

找到未知选项密钥：

<optionList>

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

选项验证步骤并忽略这些未知选项，你可以设置：

.option（“cloudFiles.<validateOptions>”， “false”）

CF_UNKNOWN_READ_LIMIT（未知读取限制）

未知 ReadLimit：<readLimit>

CF_UNSUPPORTED_CLOUD_FILES_SQL_FUNCTION (不支持的云文件SQL函数)

SQL 函数“cloud_files”仅在 DLT 管道中支持创建自动加载器的流式处理源。有关详细信息，请参阅：

<docLink>

不支持格式以进行模式推断

格式 <format> 不支持架构推理。请指定架构。

CF_不支持的日志版本

UnsupportedLogVersion：支持的最大日志版本为 v<maxVersion>，但遇到的是 v<version>。日志文件由较新的 DBR 版本生成，但无法由此版本读取。请升级。

CF_UNSUPPORTED_SCHEMA_EVOLUTION_MODE不支持的模式进化方案

格式 <mode> 不支持架构演变模式 <format>。请将架构演变模式设置为“none”。

CF_USE_DELTA_FORMAT

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

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

WKT_PARSE_ERROR

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

SQLSTATE：未分配

无法访问此工作区的存储配置。

分布式账本技术 (DLT)

不允许对管道表进行ALTER操作

不允许对由 a 管理的表使用

有关详细信息，请参阅ALTER_NOT_ALLOWED_FOR_PIPELINE_TABLE

修改的计划不存在

在没有现有计划或触发器的情况下无法更改表上的 <type>。在尝试更改计划或触发器之前，请向表添加计划或触发器。

API配额已超出

已超出数据源 <sourceName>的 API 配额。

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

应用更改错误

在APPLY CHANGES操作期间发生错误。

有关详细信息，请参阅APPLY_CHANGES_ERROR

从快照应用更改错误

在APPLY CHANGES FROM SNAPSHOT操作期间发生错误。

有关详细信息，请参阅APPLY_CHANGES_FROM_SNAPSHOT_ERROR

不支持从快照应用变更的预期

数据集 <datasetName> 定义了预期，但目前不支持使用 APPLY CHANGES FROM SNAPSHOT数据集的预期。

消除对解决此错误的期望。作为替代方法，请考虑使用以下结构通过组合 APPLY CHANGES 和 APPLY CHANGES FROM SNAPSHOT应用预期：

使用 SCD 类型 1 将快照的更改应用到中间表中，无需任何期望。
使用spark.readStream.option("readChangeFeed", "true").table从中间表中读取更改。
将中间表的更改应用到最终目标表 dlt.apply_changes，使用以下参数以及当前已与 dlt.apply_changes_from_snapshot 使用的参数：

处理更改： apply_as_deletes = "_change_type == 'delete'"
删除 CDF 添加的列： except_column_list = ["_change_type", "_commit_version", "_commit_timestamp"]

包括用于 dlt.apply_changes的最终目标表的当前预期集。

应用更改部分更新未启用

功能 COLUMNS 到 UPDATE 处于预览状态，并未在您的工作区中启用。请联系 Databricks 代表，详细了解此功能并访问个人预览版。

架构迁移失败

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

无法将列添加到包含的列中

新列 (<columnNames>) 已添加到表 <qualifiedTableName> 的管道定义中的 include_columns 字段。请完全刷新表以避免潜在的数据丢失或从include_columns中删除这些列。

无法构建装饰器

SQLSTATE：未分配

@<decoratorName>修饰器无法与<otherDecorators>组合。

无法排除不存在的列

管道定义排除源 <columnNames>表 <qualifiedTableName> 中不存在的列（<sourceType>）。请从exclude_columns字段中删除这些列。

无法筛选出必需列

管道定义不包括源 <columnNames> 的引入表 <qualifiedTableName> 所需的列 (<sourceType>)。请将其添加到include_columns，或将其从exclude_columns中删除。

无法包含不存在的列

管道定义包括源 <columnNames>表 <qualifiedTableName> 中不存在的列（<sourceType>）。请从include_columns字段中删除这些列。

无法导入没有主键的表

源中的<qualifiedTableName>表<sourceType>没有主键。

请在连接器配置中指定主键以引入表（如果存在）。

无法从排除列中移除列

在表 <columnNames>的管道定义中，列（<qualifiedTableName>）被从 exclude_columns 字段中删除。请对表格进行完全刷新以避免潜在的数据丢失，或者将这些列重新添加到 exclude_columns 中。

无法为HMS_PIPELINE设置目录

如果要使用 UC 创建新管道并设置目录，则无法将目录添加到具有已定义存储位置的现有管道。

无法合并表 <tableName>的当前架构和新架构。

若要继续执行此架构更改，可以触发此表的完全刷新。

根据用例和架构更改，你也许能够删除架构更改 -- 可以更新查询，以便输出架构与现有架构兼容（例如，通过显式将列强制转换为正确的数据类型）。

不能写入非活动列

目标中的下表具有与当前源表冲突的非活动列：

<details>

这些列在目标表中保持非活动状态，因为它们以前已从源表中删除。

若要继续更新，请对表执行 FULL REFRESH，或者通过 ALTER TABLE DROP COLUMN 命令从目标表中删除这些非活动列，然后重试更新。

无法写入非活动表

目标中的下表处于非活动状态，并且与当前源表冲突：<tables>。

这些表保持非活动状态，因为它们以前已从源中删除或未从连接器中选择。

若要继续更新，请对表执行 FULL REFRESH，或者从目录资源管理器中的目标中删除这些非活动表，或通过 DROP TABLE 命令删除这些非活动表，然后重试更新。

无法写入待重置的表格

在上一次完整刷新中，目标中的下列表格未正确重置：<tables>。

请对其触发完全刷新以恢复。

目录映射在UC中不可用

UC 目录没有针对目录 <sourceCatalog> 的映射。

目录模式与目标管道不匹配

ID 为 <destPipelineCatalog> 的目标管道的目录 <destPipelineSchema> 和架构 <destPipelineId> 与表 <tableName> 的目录和架构不匹配。目标管道应具有与表相同的目录和架构，或者目标管道必须使用直接发布模式。

目录规范不支持

数据库连接器当前不支持 CatalogSpecs。请删除目录规范。

CDC_APPLIER_COLUMN_UOID_NOT_SUPPORTED

CDC 托管引入管道不支持表 <columnNames> 中具有 UOID <tableName> 的列。

请检查引入管道是否支持列 UOID，或请求完全刷新。

从网关来的CDC应用程序致命故障

网关管道遇到严重错误：

<errorMessage>

请在这里查看管道更新失败：<link>

CDC_应用程序要求对所有目标表进行完全刷新

不支持完全刷新一个目标表，不支持从同一源对另一个目标表进行正常更新。

请完全刷新这两个表，以便尽可能继续。

完全刷新表：<fullRefreshTables>

源 <sourceTable> 的目标表：<destinationTables>

CDC应用程序在流式传输期间架构发生更改

架构版本 <dataSchemaVersion> 与读取的架构版本 <readSchemaVersion>不同。

DLT 将重试更新。

CDC_INCOMPATIBLE_SCHEMA_CHANGES

我们从架构版本 <cause> 到 <previousSchemaVersion>遇到不兼容的架构更改（<currentSchemaVersion>）。

因此，我们不能继续对 <tableName>应用更改。请请求完全刷新表。

以前的架构：<previousSchema>

当前架构：<currentSchema>

CDC_潜在数据差距

下表 [<needFullRefreshTableList>] 在 <retention> 天内没有成功的更新。

请对这些表或整个数据管道进行全面刷新。

从多个来源获取相同表的CDC

从多个源找到同一个表名 <table>：<sources>。

请将它们拆分为不同的管道，以避免冲突。

CDC_TABLE_NOT_FOUND_IN_ALL_TABLES

在源数据库的所有表快照中找不到表 <table>。

检查管道群集配置和关联的群集策略。

集群创建额度已耗尽

SQLSTATE：57000

无法创建群集，因为已耗尽可用额度。请添加付款方式以升级帐户。

群集创建资源耗尽

SQLSTATE：57000

无法创建群集，因为已超出资源限制： <errorMessage>

集群启动客户端错误

SQLSTATE：KDL01

未能启动管道群集 <clusterId>：<clusterStateMessage>

此错误可能是由于管道中的配置错误。

检查管道群集配置和关联的群集策略。

集群启动云端失败

SQLSTATE：58000

未能启动管道群集 <clusterId>：<clusterStateMessage>

此错误可能是暂时性的 - 重启管道，如果仍然看到相同的问题，请报告。

CLUSTER_SETUP_CLIENT_ERROR（集群设置客户端错误）

SQLSTATE：KDL01

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

集群无法访问

与驱动程序通信丢失。群集 <clusterId> 有 <timeoutSeconds> 秒无法访问。

未找到要更新的列

在源数据帧中找不到 <column> TO COLUMNS 中指定的列 UPDATE。

无法停止以前的更新导致并行升级失败

启动了升级的更新“<upgradedUpdateId>”，但未能停止之前的更新“<oldUpdateId>”。

此错误可能是暂时性的。管道将自动重试，问题应自行解决。

如果仍然看到相同的问题，请将此错误报告给 Databricks。

数据集装饰器应用两次

SQLSTATE：未分配

数据集 <datasetName> 已存在。确保查询函数仅标记为视图或表一次。

数据集_未定义

未能读取数据集“”。<datasetName> 管道中未定义此数据集。

如果此表由其他管道管理，则不要使用 dlt.read / dlt.readStream 读取该表，也不要将名称加上 LIVE 关键字。

找不到目标管道

找不到 ID 为“”<pipelineId>的目标管道。请确保您所在的工作区与管道所在的工作区一致，您是该管道的所有者，并且该管道至少运行过一次。

目标管道不处于直接发布模式

ID 为“”<pipelineId>的目标管道未使用直接发布模式。

目的地管道权限被拒绝

不允许执行此操作，因为您不是ID为“<pipelineId>”的目标管道的所有者。只有所有者才能更改表的管道。

目标管道类型不是工作空间管道类型

ID 为“”<pipelineId>的目标管道不是 ETL 管道。

删除计划_计划不存在

在没有现有计划或触发器的情况下无法删除表上的 SCHEDULE。

DUPLICATED_FROM_JSON_SCHEMA_LOCATION

重复的“from_json”模式位置键：<schemaLocationKey>。

请在管道中为每个from_json查询选择唯一的架构位置键

重复的摄取配置表规格

引入管道配置包含重复表。请确保每个表都是唯一的。

EMPTY_INGESTION_CONFIG_OBJECTS

引入配置对象为空。

事件日志选择器功能不支持

此管道不支持将事件日志发布到 Unity 目录。如果这是意外的，请联系 Databricks 支持部门。

期望违例

流“<flowName>”未能满足预期。

有关详细信息，请参阅EXPECTATION_VIOLATION

无法创建事件日志

未能使用标识符 <pipelineId>创建管道（id=<eventLogIdentifier>）事件日志。有关更多详细信息，请参阅下面的异常。

无法更新事件日志

未能将管道（id=<pipelineId>）事件日志标识符更新为 <newEventLogIdentifier>。有关更多详细信息，请参阅下面的异常。

流程架构已更改

流 <flowName> 已终止，因为它在执行期间遇到架构更改。

架构更改与现有目标架构兼容，下一次流程运行可以使用新架构恢复。

FORACH_BATCH_SINK_ONLY_SUPPORTED_IN_PREVIEW_CHANNEL仅在预览频道中支持

目前不支持 DLT ForeachBatch 接收器。

DLT ForeachBatch 接收器的专用预览版需要 PREVIEW 通道。

DLT 接收器：<sinkNames>

网关管道初始化脚本不允许

网关管道不允许群集初始化脚本。请将其从 <from>中删除。

GATEWAY_PIPELINE_SPARK_CONF_NOT_ALLOWED

网关管道不允许 spark 配置 [<configs>]。请将其从 <from>中删除。

ILLEGAL_COLUMN_TO_UPDATE_DATA_TYPE (非法列更新数据类型)

COLUMNS TO UPDATE 中指定的列的数据类型必须是字符串数组，但找到了 <illegalDataType>。

管道规范中的非法模式字段

管道设置中的指定“schema”字段是非法的。原因：<reason>。

根路径类型不正确

根路径“<rootPath>”必须是目录，但发现 <objectType>。

摄取配置重复的架构

引入管道配置包含重复的架构。请确保每个架构都是唯一的。

INGESTION_GATEWAY_AUTHENTICATION_FAILURE

身份验证失败

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

INGESTION_GATEWAY_主机或端口不可达故障

由于源数据库的主机名 <host> 和/或端口 <port> 不正确，连接失败。

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

无效的应用更改命令

APPLY CHANGES 命令无效。 <reason>。

无效的参数类型

SQLSTATE：未分配

传递给参数<paramName> 的值类型无效。应为 <expectedType>。 <additionalMsg>。

无效兼容性选项

为表 <table> 指定的表选项无效，因为

有关详细信息，请参阅INVALID_COMPATIBILITY_OPTIONS

装饰器使用无效

SQLSTATE：未分配

传递给 @<decoratorName> 的第一个位置参数必须可调用。在函数中添加没有参数的 @<decoratorName>，或者使用关键字参数（例如）<decoratorName>将选项传递给 @<exampleUsage> 。

无效的事件日志配置

在管道规格中找到的事件日志配置无效： <message>

名称无效或已在使用命令

<name>命令中的名称“<command>”无效。原因：<reason>

无效的刷新选择

缺少创建模式的权限

用户“<userName>”无权在目录中创建架构 <catalogName>

缺少创建表权限

用户“<userName>”无权在架构中创建表 <schemaName>

缺少“作为用户运行”配置

SQLSTATE：28000

未为更新指定运行方式用户。

互斥选项

互斥选项 <options>。请删除其中一个选项。

负值

SQLSTATE：未分配

值 <arg_name> 必须大于或等于 0，得到“<arg_value>”。

非UC表已由其他管道管理

表 '<tableName>' 已由管道 <otherPipelineId>管理。

如果希望表<tableName>由此管道管理，

从管道“”<otherPipelineId>中删除表。
启动此管道的完整刷新更新。

如果要继续从多个管道管理表，请在管道设置中将配置 pipelines.tableManagedByMultiplePipelinesCheck.enabled 更改为 false，以禁用此检查。

管道未处于直接发布模式

ID 为“”<pipelineId>的管道（管理表 <tableName>）不使用直接发布模式。

管道未准备好进行计划更新

将所有 %pip install 单元格移动到该笔记本的开头。

PY4J_BLOCKED_API

SQLSTATE：未分配

你使用的是当前环境中不支持的 Python API。

请查看 Databricks 文档了解替代项。

<additionalInfo>

REFERENCE_DLT_DATASET_OUTSIDE_QUERY_DEFINITION

不支持引用数据集查询定义外部的 DLT 数据集 <identifier>（即 @dlt.table 批注）。请改为在数据集查询定义中读取它。

刷新模式已存在

无法添加 <type> 到已具有 <existingType> 的表。请删除现有计划或使用 ALTER TABLE ... ALTER <type> 更改它。

在使用中的保留关键字目录

USE CATALOG “”<reservedKeyword>是非法的，因为“”<reservedKeyword>是 DLT 中的保留关键字。

保留关键字使用模式

USE SCHEMA “”<reservedKeyword>是非法的，因为“”<reservedKeyword>是 DLT 中的保留关键字。

根路径未找到

无法访问根路径“”。<rootPath> 请确保拥有所需的访问权限。

RUN_AS_USER_NOT_FOUND

SQLSTATE：28000

在工作区中，不存在被指定为用户“<runAsUserId>”的任务。

SAAS连接错误

未能连接到 <sourceName> 源。错误代码：<saasConnectionErrorCode>。

有关详细信息，请参阅 SAAS_CONNECTION_ERROR

SAAS连接器架构更改错误

架构更改发生在 <tableName> 源的表 <sourceName> 中。

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

SAAS_CONNECTOR_SOURCE_API_ERROR

<sourceName> API 调用中发生错误。源 API 类型：<saasSourceApiType>。错误代码：<saasSourceApiErrorCode>。

尝试刷新目标表。如果问题仍然存在，请提交票证。

SAAS_CONNECTOR_UNSUPPORTED_ERROR

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

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

SAAS_初始化期间的不兼容架构变更

初始化管道时检测到不兼容的架构更改：

<details>

请对受影响的表执行完全刷新。

软件即服务_模式在分析过程中出现分歧

源表（<table>）的分析架构与预期架构存在分歧。

请重试管道更新，看看问题是否已解决。

如果此问题仍然存在，请对上述表执行完全刷新

预期架构：

<expectedSchema>

实际架构：

<actualSchema>

SAAS_UC_CONNECTION_INACCESSIBLE（SaaS UC 连接不可访问）

提供的连接 <connectionName> 不可访问。请检查连接，然后重试。

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

架构规范_空目录

SchemaSpec 在目录字段中有一个空字符串。

请删除空字符串或添加目录名称。（如果此架构不属于源中的目录，请不要设置字段。

架构规格详细信息：

<schemaSpec>

SCHEMA_SPEC_EMPTY_SCHEMA

SQLSTATE：3F000

SchemaSpec 在架构字段中有一个空字符串。

请删除空字符串或添加架构名称。（如果此表不属于源中的架构，请不要设置字段。

架构规格详细信息：

<schemaSpec>

SCHEMA_SPEC_REQUIRE_ONE_OF_CATALOG_SCHEMA

必须存在至少一个源目录和源架构。但两者都是空的。

架构规格详细信息：

ServiceNow 中发生错误。源 API 类型：<saasSourceApiType>。

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

不允许为管道表设置表属性

ALTER <commandTableType> ... SET TBLPROPERTIES 不支持。若要修改表属性，请更改原始定义并运行更新。

SFDC_CONNECTOR_BULK_QUERY_JOB_INCOMPLETE

对象 <objName> 的引入不完整，因为 Salesforce API 查询作业花费的时间过长、失败或已手动取消。

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

SFDC_CONNECTOR_BULK_QUERY_NOT_FOUND（未找到SFDC连接器批量查询）

对象 <objName> 引入失败，因为找不到 Salesforce 批量 API 查询作业。

请对特定目标表执行 FULL REFRESH。

SFDC_CONNECTOR_CREATE_BULK_QUERY_JOB_FAILED (请注意：Salesforce 连接器创建批量查询作业失败)

由于创建 Salesforce 批量 API 查询作业失败，对象 <objName> 引入不完整。错误代码：<saasSourceApiErrorCode>。

<actionText>。

水槽不支持在SEG中

启用了无服务器出口控件的工作区不支持管道中的 DLT 接收器。支持的 DLT 数据流接收端包括 Kafka 和 Delta。

找到以下不支持的接收器：<sinkNames>，其相应的格式为：<sinkFormats>。

独立私有MVST不支持

不支持创建独立的 PRIVATE MV/ST。请删除 PRIVATE 修饰符

未定义的流目标

找不到用于 <target> 命令的目标表 <command>。管道中未定义目标表 <target>。

在操作期间表已更改

表 <tableName> 已在此事务之外进行了修改，并且此事务已回滚。重试操作。

表物化循环外键依赖关系

管道更新：<pipelineId> 检测到外键约束的循环链：<tables>。

表规范需要同时目录和模式

TableSpec 缺少源目录和/或源架构之一。

表规范详细信息：

<tableSpec>

表格规范为空目录

TableSpec 在目录字段中有一个空字符串。

请删除空字符串或添加目录名称。（如果此表不属于源中的目录，请不要设置字段。

表规范详细信息：

<tableSpec>

表格规范为空的架构

SQLSTATE：3F000

TableSpec 在架构字段中有一个空字符串。

请删除空字符串或添加架构名称。（如果此表不属于源中的架构，请不要设置字段。

表规范详细信息：

<tableSpec>

表格规格_空表

表名为空。请提供表名。

表规范详细信息：

<tableSpec>

表令牌不存在于架构演变遗留表中

由于缺少元数据，无法启用架构演变。请触发完全刷新。

原因：启用架构演变时必须定义快照表令牌。

目标数据库已满

SQLSTATE：53100

目标数据库 <databaseName> 空间已满。无法继续摄取。

触发间隔值无效

触发器间隔必须是正持续时间，最大可接受的值为 2,147,483,647 秒。接收时间：<actual> 秒。

触发源类型不被支持

触发器当前不支持类型为 <source> 的源 <type>。

UC清算目标架构不允许

SQLSTATE：0AKD0

不允许在 UC 管道中清除目标架构字段。原因：<reason>。

UC_TARGET_SCHEMA_REQUIRED

SQLSTATE：0AKD0

UC 管道需要目标架构字段。原因：<reason>。

无法推断表架构

无法从其上游流推断表 <tableName> 的架构。

请修改写入此表的流，使其架构兼容。

到目前为止，推断的架构：

<inferredDataSchema>

不兼容的架构：

<incompatibleDataSchema>

意外的管道方案权限错误

检查管道 <pipelineId>的架构权限时出现意外错误。请联系 Databricks 支持人员。

统一兼容性无法与行过滤器或列掩码设置

不能对应用行筛选器或列掩码的物化视图或流式表设置统一的兼容性。

未解决的下游路径

无法解析接收器 <identifier> 的存储路径。请联系 Databricks 支持人员。

未解决的维护表格

不支持提供的引入类型 <ingestionType>。

如果此问题仍然存在，请联系 Databricks 支持部门。

不支持的SPARK SQL命令

DLT Python 中的 spark.sql（“...”） API 不支持'<command>' 。支持的命令：<supportedCommands>。

USE_CATALOG_IN_HMS

USE CATALOG 仅在启用了 UC 的 DLT 管道中受支持

查看未在UC中保存的文本

无法刷新表 <tableName>，因为它没有保存在 Unity 目录中的查询。请联系 Databricks 支持人员。

Workday 报告连接器未授权访问错误

Workday 报表中发生错误。源 API 类型：<saasSourceApiType>。

有关详细信息，请参阅WORKDAY_REPORTS_CONNECTOR_UNAUTHORIZED_ACCESS_ERROR

工作日报告网址为空

Workday 报表 URL 为空。必须至少提供一个报表。

工作区配额已超限