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：22010

无法将输入字符串 <input> 分析为 TIME 值，因为它与日期时间格式 <format>不匹配。

无法解析时间戳

SQLSTATE：22007

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

初始化期间无法查询表

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

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

无法读取归档文件

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

无法读取文件

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

仅 MANAGED 表类型支持浅克隆。表 <table> 不是 MANAGED 表。

无法更新字段

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

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

无法进行数据类型向上转换

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

<details>

无法使用KRYO

SQLSTATE：22KD3

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

无法验证连接

SQLSTATE：08000

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

无法写入状态存储

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

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

转化无效输入

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

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

转换溢出

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

表插入中的类型溢出

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

目录未找到

SQLSTATE：42P08

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

不允许创建属于目录的表格

不允许使用 <feature> 表功能创建 Delta 表。请联系 Databricks 支持部门。

CHECKPOINT_RDD_BLOCK_ID_NOT_FOUND

SQLSTATE：56000

找不到检查点块 <rddBlockId>!

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

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

循环类引用

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

类未覆盖预期的方法

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

类不受地图对象支持

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

无法支持洁净室命令

不支持清洁室命令

洁净室_无效_共享数据对象名称

引用清洁室内 <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>]。

并行调度器槽位不足

SQLSTATE：53000

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

并行流日志更新

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

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

配置不可用

SQLSTATE：42K0I

配置 <config> 不可用。

冲突的集群配置

以下配置与 spark.databricks.streaming.realTimeMode.enabled 冲突： <confNames> 从群集配置中删除这些配置并重启 Spark 群集。

目录结构冲突

检测到有冲突的目录结构。

可疑路径：

<discoveredBasePaths>

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

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

冲突的分区列名称

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

<distinctPartColLists>

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

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

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

<suspiciousPaths>

与保留字冲突的分区列名

分区列名称“”<partitionColumnName>与保留列名称冲突。

Spark 会为 Hive 不兼容的 <tableName> 模式自动生成保留列“<partitionColumnName>”，以特定方式存储表。

请对分区列使用不同的名称。

冲突的提供者

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

SQL配置冲突

以下配置与 spark.databricks.streaming.realTimeMode.enabled 冲突： <confNames> 从 SparkSession 配置中删除这些配置。

连接

SQLSTATE：56K00

泛型 Spark Connect 错误。

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

连接已存在

约束需要统一目录

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

转换_输入无效

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

COPY_INTO_列数不匹配

这可能表示传入数据出现问题，或者可以通过设置使 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关闭此检查。

复制到源架构推断失败

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

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

COPY_INTO_STATE_INTERNAL_ERROR（复制到状态内部错误）

处理 COPY INTO 状态时发生内部错误。

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

复制到语法错误

创建表列描述符重复

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

创建视图列数目不匹配

SQLSTATE：21S01

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

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

资凭证丢失

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

凭据目的不匹配

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

CSV_ENFORCE_SCHEMA_NOT_SUPPORTED (CSV强制模式不支持)

使用 enforceSchema 或 rescuedDataColumn时，不能配置 CSV 选项 failOnUnknownFields，因为此时列是按名称而不是编号来读取的。

循环函数引用

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

Databricks Delta 未启用

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

数据类型不匹配

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

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

数据类型缺少大小

SQLSTATE：42K01

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

数据关系_安全查看_叶节点无关联

写入世系失败：缺少与 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>。

有关详细信息，请参阅 DATETIME_FIELD_OUT_OF_BOUNDS

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

默认数据库不存在

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

默认文件未找到

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

默认位置无效

SQLSTATE：42608

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

例如： UPDATE SET c1 = DEFAULT 是允许的，但 UPDATE T SET c1 = 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 上下文后注册了其他架构，可能会发生这种情况。

事件日志为空

与<tableOrPipeline>相关的事件日志没有架构，也不包含任何事件。稍后等待事件生成后再尝试

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

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

事件日志 TVF 不支持流水线

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

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

有关详细信息，请参阅 Monitor Lakeflow 声明性管道文档： https://docs.databricks.com/aws/en/delta-live-tables/observability。

事件日志不可用

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

事件日志_不支持的表类型

SQLSTATE：42832

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

查询事件日志仅支持物化视图、流表或 Lakeflow 声明性管道。

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

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

超出限制长度

SQLSTATE：54006

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

除外_嵌套列_类型无效

SQLSTATE：428H2

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

排除重叠列

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”或联接提示强制随机联接来禁用此查询的广播。

执行者_广播连接_存储_内存不足

SQLSTATE：53200

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

立即执行_重复参数别名

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

期望永久表而非临时表

“<operation>”需要永久表，但 <tableName> 是临时表。请改为指定一个永久表。

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

表达式编码失败 (EXPRESSION_ENCODING_FAILED)

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

表达式类型不可排序

SQLSTATE：42822

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

外部浅复制仍然存在

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> 以启用此功能。

功能_不在_经典仓库

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

功能需要UC

SQLSTATE：0AKUD

如果不使用 Unity Catalog，则不支持 <feature>。若要使用此功能，请启用 Unity 目录。

功能不可用

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

字段已存在

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

字段未找到

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

文件在暂存路径中已存在

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

FLATMAPGROUPSWITHSTATE 用户函数错误 (USER_FUNCTION_ERROR)

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

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

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

禁止操作

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

每个批次用户功能错误

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

针对每个用户的函数错误

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

外键不匹配

SQLSTATE：42830

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

外部对象名称不能为空

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

外部表转换不支持

表不符合从 UC Foreign 升级到 UC External 的条件。原因：

有关详细信息，请参阅FOREIGN_TABLE_CONVERSION_UNSUPPORTED

发现多个数据源

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

来自JSON的冲突模式更新

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

FROM_JSON损坏记录列在架构中

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中使用聚合函数，但发现了 <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

JDBC方言不支持的提示

SQLSTATE：42822

JDBC 数据源不支持此选项hint<jdbcDialect>。支持的方言是 MySQLDialect， OracleDialect 以及 DatabricksDialect。

HIVE_METASTORE_INVALID_PLACEHOLDER_PATH (仓库元存储无效占位符路径)

查询或命令无法执行，因为“spark.databricks.hive.metastore.tablePlaceholderPath”配置提供了无效的 Hive 元存储表占位符路径。请使用新值更新此配置，以提供有效的路径，然后再次运行查询或命令。

HIVE_METASTORE_表_占位符_路径_未设置

查询或命令失败，因为未设置 Hive 元存储表占位符路径，当架构位置位于 DBFS 上时，该路径是必需的，而表位置是对象/文件。请将 spark.databricks.hive.metastore.tablePlaceholderPath 设置为有权访问的路径，然后重新运行查询或命令。

HLL_无效输入草图缓冲区

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

HLL_INVALID_LG_K（无效的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

标识符_名称部分过多

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

身份列重复序列生成器选项

重复 IDENTITY 列序列生成器选项：<sequenceGeneratorOption>。

标识列不合法步骤

SQLSTATE：42611

IDENTITY 列步骤不能为 0。

唯一标识列不支持的数据类型

SQLSTATE：428H2

<dataType> 列不支持 DataType IDENTITY。

非法的星期几

SQLSTATE：22009

非法输入的星期几：<string>。

非法状态存储值

提供给状态存储的非法值

有关更多详细信息，请参阅 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。请从 classpath 中删除不兼容的库或对其进行升级。错误：<message>

表格不兼容的数据

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

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

类型不兼容的连接

<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 （...）功能。

权限不足

间隔算术溢出 (INTERVAL_ARITHMETIC_OVERFLOW)

SQLSTATE：22015

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

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

区间除以零

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>。

无效字节串

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> 必须具有可为 null 的 STRING 类型，但收到了 <actualType>。

无效的坐标参考系统值

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

当前收件人用法无效

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

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>。

无效的驱动程序内存 (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

语句的 GETDIAGNOSTICS 用法无效。

有更详细的信息请参阅INVALID_GET_DIAGNOSTICS_USAGE

无效_GET_诊断_用法_条件编号必须为1

SQLSTATE：35000

语句的 GETDIAGNOSTICS 用法无效。语句中 GETDIAGNOSTICS 条件编号的唯一支持值为 1。

INVALID_HANDLE

SQLSTATE：HY000

句柄 <handle> 无效。

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

无效的处理程序声明

SQLSTATE：42K0Q

处理程序声明无效。

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

无效的HTTP请求方法

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

无效的HTTP请求路径

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

无效标识符

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

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

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

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

无效的零索引

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

无效内联表

内联表无效。

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

无效的时间间隔格式

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

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

无效的间隔微秒添加

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

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

SQLSTATE：46121

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

<walkedTypePath>。

无效的_JDBC_连接选项 (INVALID_JDBC_CONNECTION_OPTION)

此选项 <optionKey> 不是此 jdbc 连接的有效参数。

无效的 JDBC 连接选项值

具有值<optionKey>的选项<optionValue>不是此 jdbc 连接的有效选项。

无效的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

无效的Lambda函数调用

SQLSTATE：42K0D

lambda 函数调用无效。

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

无效的横向连接类型

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

无效的LIMIT_LIKE表达式

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

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

日志版本无效

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

参数值无效

<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 语句。首个子级必须是锚定词，并且没有任何递归引用。

无效递归引用

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”。

无效架构

SQLSTATE：42K07

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

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

无效的架构或关系名称

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

无效方案

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

无效的密钥查询

SQLSTATE：22531

机密查找无效：

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

无效的设置语法

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

无效共享别名名称

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

无效单一变量列 (INVALID_SINGLE_VARIANT_COLUMN)

在启用<schema>选项时，用户指定的架构singleVariantColumn无效。架构必须是变体字段，或者是变体字段加上损坏的列字段。

无效的来源目录

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

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

SQLSTATE：42KDH

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

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

<stmt>

无效的SPARK配置

Spark 配置无效：

有关详细信息请参阅INVALID_SPARK_CONFIG

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>。

无效的UDF实现

函数 <funcName> 不实现 ScalarFunction 或 AggregateFunction。

无效的升级语法

<command> <supportedOrNot> 源表位于 Hive 元存储中，目标表位于 Unity 目录中。

无效的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>。

架构 <schema> 不是有效的变体切碎架构。

无效的WHERE条件

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

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

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

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

组内表达式无效

SQLSTATE：42K0K

使用 <funcName> 时，函数 WITHIN GROUP 无效。

有关详细信息，请参阅 INVALID_WITHIN_GROUP_EXPRESSION

无效的编写者提交消息

数据源写入器生成了不合理数量的提交消息。每个任务中应仅有一条写入器提交消息，但收到了 <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（无法找到KINESIS EFO消费者）

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_轮询模式不受支持

不支持 Kinesis 轮询模式。

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

禁止标签名称 <label> 。

湖仓联邦数据源需要更新的DBR版本

Lakehouse 联合数据源“<provider>”需要更新的 Databricks Runtime 版本。

有关详细信息，请参阅LAKEHOUSE_FEDERATION_DATA_SOURCE_REQUIRES_NEWER_DBR_VERSION

加载数据路径不存在

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

本地必须包含模式文件

LOCAL 必须与 file 的架构一起使用，但收到了 <actualSchema>。

位置已存在

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

丢失主题分区_在结束偏移量中_触发器_当前可用

使用 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

每微批处理源中的状态异常

RatePerMicroBatch 源中的状态格式错误。

有关详细信息，请参阅 MALFORMED_STATE_IN_RATE_PER_MICRO_BATCH_SOURCE

格式错误变体

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

控制的冰山尝试启用聚类，而未禁用DVS或行跟踪

尝试在 Managed Iceberg 表上启用 Liquid 聚类分析，而无需禁用删除矢量和行跟踪。 Managed Iceberg 表不支持删除向量和行跟踪，而这些功能是 Liquid 表实现行级并发所必需的。若要在托管 Iceberg 表上启用低并发控制的 Liquid 聚类，必须对此表禁用删除矢量和行跟踪。

ICEBERG操作不支持管理功能

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

管理表_含凭证

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

物化视图_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 未启用。

指标存储无效参数值错误

<table> 不支持迁移到 UC 托管表，因为它不是 <tableKind> 表。

确保要迁移的表是 UC 外部增量表，并且

引用的是名称而不是路径。

不支持迁移回滚

<table> 不支持从托管表回滚至外部表，因为它不是 <tableKind> 表。

主题分区在结束偏移量与预取数据之间不匹配

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

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

聚合缺失

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

MULTIPLE_LOAD_PATH（多重加载路径）

Databricks Delta 不支持加载 API 中的多个输入路径。

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

生成单个数据帧，请加载

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

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

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

多个匹配的约束条件

SQLSTATE：42891

发现至少有两个具有给定条件的匹配约束。

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

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

多次时间旅行规范

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

多个_XML_数据来源

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

多重别名但无生成器

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

多源不支持表达式

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

多语句事务CDF架构_带保留列名

无法在多语句事务中启用数据更改馈送，因为表中包含保留列名称（<column_name>）。

若要继续作，请确保表仅使用非保留列名称。

多语句事务设定高水位线不允许

不允许手动设置 CDC 标识高水印。

多语句事务并发目录元数据更改

表/视图 <table>上检测到并发元数据更改。请运行 ROLLBACK 并重试此事务。详细信息：

有关详细信息，请参阅MULTI_STATEMENT_TRANSACTION_CONCURRENT_CATALOG_METADATA_CHANGE

MULTI_STATEMENT_TRANSACTION_CONTEXT_MISMATCH（多语句事务上下文不匹配）

在当前线程和 Spark 会话之间检测到事务上下文不一致。当 Spark 会话跨多个线程共享时，通常会发生这种情况。请在重复使用新事务的会话和线程之前，对每个事务使用专用会话和线程，并在其线程中提交/回滚事务。详细信息：

有关详细信息，请参阅MULTI_STATEMENT_TRANSACTION_CONTEXT_MISMATCH

不支持多语句事务

未能执行该语句。

有关详细信息，请参阅MULTI_STATEMENT_TRANSACTION_NOT_SUPPORTED

多语句事务没有活动的事务

没有活动事务到<action>。

多语句事务中止后需要回滚

当前事务已中止。请在继续之前运行 ROLLBACK TRANSACTION 。中止原因：

有关详细信息，请参阅MULTI_STATEMENT_TRANSACTION_ROLLBACK_REQUIRED_AFTER_ABORT

多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> 作为表函数。

非空断言违规

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”。

JDBC目录中不支持

数字表值别名不匹配

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类型

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

PARQUET类型不被支持

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

解析空语句

SQLSTATE：42617

语法错误，意外的空语句。

解析模式不支持

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

解析语法错误

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

分区已存在

SQLSTATE：428FT

无法在表 RENAME 中添加 ADD 或 <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>的子目录。

分区元数据

<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。

管道不存在

管道“<pipelineId>”不存在

有关详细信息，请参阅PIPELINE_DOES_NOT_EXIST

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

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

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

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

透视值数据类型不匹配

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

** 指针数组内存不足

SQLSTATE：82002

内存不足，无法增长指针数组

策略已存在

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

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

策略_未找到

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

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

SQLSTATE：428HD

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

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

查询执行超时时间已超出

SQLSTATE：57KD0

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

查询被拒绝

SQLSTATE：08004

查询执行被拒绝。

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

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

无法找到当前文件

<message>

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

参数不明确的例程文件读取

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

READ_FILES_CREDENTIALS_PARSE_ERROR

重命名源路径未找到

由于未找到 <sourcePath>，重命名失败。

重复条款

SQLSTATE：42614

在每个 <clause> 操作中，<operation> 子句最多只能使用一次。

所需参数已按位置提供

例程 <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

标量函数未完全实现

SQLSTATE：42K0P

ScalarFunction <scalarFunc> 不会实现或重写“produceResult(InternalRow)”方法。

标量子查询存在于GROUP BY或聚合函数中

相关的标量查询“<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>。

模式已存在

SQLSTATE：42P06

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

选择其他名称、删除现有架构或添加 IF NOT EXISTS 子句以容忍预先存在的架构。

架构_非空

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

无法使用用户名<host>连接到端口<port>上的 SFTP 服务器<user>。

SFTP用户不匹配

SQLSTATE：08006

从凭据 <credentialUser> 检索的用户与 SFTP 路径 <path>中指定的用户不匹配。

显示带有冲突的命名空间列

SHOW COLUMNS 包含有冲突的命名空间：<namespaceA> != <namespaceB>。

不分桶排序

sortBy 必须与 bucketBy 一起使用。

SPARK作业已取消

SQLSTATE：HY008

作业 <jobId> 已取消 <reason>

不允许指定分桶

没有显式列列表的 CREATE TABLE 无法指定存储桶信息。

请使用具有显式列列表的表单，然后指定存储桶信息。

或者，允许通过省略此子句来推断存储桶信息。

无法指定具有分桶功能的集群划分

不能同时指定 CLUSTER BY 和 CLUSTERED BY INTO BUCKETS。

不允许指定 CLUSTER BY 与 PARTITIONED BY一起使用

不能同时指定 CLUSTER BY 和 PARTITIONED BY。

不允许指定分区

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

状态架构文件数 <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已提交批次不可用

SQLSTATE：KD006

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

性病冲突选项

选项 <options> 不能同时指定。请指定一个。

STDS_无法读取操作员元数据

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

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

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

STDS_未能读取状态模式

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

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

无效的选项值

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

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

必须指定“<optionName>”。

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

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

从物化视图流式传输

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

流式输出模式

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

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

流媒体实时模式

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

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

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

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

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

流媒体表需要刷新

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

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

如果表是由 Lakeflow 声明性管道创建的，请运行管道更新。

不支持流式表

只能在 Lakeflow 声明性管道和 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 = <limit>，offset = <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> 参数 <functionName> SQL 用户定义函数 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> 时任务失败。

不支持临时检查点位置

当前工作区不支持隐式临时流式处理检查点位置，请显式指定检查点位置。

对于 display()，请使用以下方法设置检查点位置：

display（df， checkpointLocation = “your_path”）

临时表不支持与HMS一起使用

Hive 元存储不支持临时表操作 <operation>。

TEMP_TABLE_OPERATION_NOT_SUPPORTED（临时表操作不支持）

不支持对会话本地的临时表 <tableName> 执行的操作。

有关详细信息，请参阅 TEMP_TABLE_OPERATION_NOT_SUPPORTED

临时表或视图已存在

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

选择其他名称、删除现有对象或添加 IF NOT EXISTS 子句以容忍预先存在的对象。

TEMP_TABLE_REQUIRES_DELTA

在会话本地临时表上进行操作需要启用 Delta 目录。请打开 Delta 目录，然后重试。

临时表需要UC

SQLSTATE：0AKUD

对会话本地临时表的操作需要 Unity Catalog。请在正在运行的环境中启用 Unity 目录，然后重试。

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

SQLSTATE：428EK

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

SELECT 中的尾随逗号

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

交易最大提交时间戳超限

事务无法提交，因为超出最大提交时间戳。 maxCommitTimestamp：<maxCommitTimestampMs> commitTimestamp：<commitTimestampMs>

状态用户函数转换错误

StatefulProcessor 的用户定义函数 <function> 中发生错误。原因：<reason>。

转置超出行限制

SQLSTATE：54006

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

转置操作中无效的索引列

SQLSTATE：42804

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

无最小公共类型的转置

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

触发间隔无效

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

元组为空

SQLSTATE：22004

由于 Scala 对元组的支持有限，因此不支持空元组。

元组大小超出限制

SQLSTATE：54011

由于 Scala 对元组的支持有限，不支持包含 22 个以上的元素的元组。

UC_BUCKETED_TABLES

Unity Catalog 中不支持存储桶表。

未提供UC目录名称

SQLSTATE：3D000

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

不支持的命令

命令：<commandName> 在 Unity Catalog 中不受支持。

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

<errorMessage>

外部存储卷缺少位置

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

UC_失败的供应状态

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

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

不支持在 Unity 目录中创建包含文件方案 <schemeName> 的表。

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

UC_HIVE_METASTORE_联邦跨目录视图不支持

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

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

未找到UC卷

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

UDF环境错误

由于系统错误，无法安装 UDF 依赖项 <udfName> 。

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

UDF_ENVIRONMENT用户错误

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

有关详细信息，请参阅UDF_ENVIRONMENT_USER_ERROR

UDF_ERROR

SQLSTATE：未分配

函数 <fn> 执行失败

有关详细信息，请参阅 UDF_ERROR

UDF_LIMITS

SQLSTATE：54KD0

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

有关详细信息，请参阅 UDF_LIMITS

用户自定义函数数量超出最大限制 (UDF_MAX_COUNT_EXCEEDED)

SQLSTATE：54KD0

超出了查询范围的 <maxNumUdfs> 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()。

未封闭的括号注释

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

意外输入类型

函数 <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>。

递归CTE中不支持UNION

SQLSTATE：42836

在递归公共表表达式（直接或间接引用自身的子句）中尚不支持UNION运算符。请改用 UNION ALL。

未知字段异常

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

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

未知的定位参数

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

未知的变体中基本类型

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

未知_PROTOBUF_消息类型

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

反透视需要属性

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 文档。

未解决_全_在_分组_中

SQLSTATE：42803

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

未解析的列

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

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

未解决的字段

名为 <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>。

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

不允许使用元数据模型选项的非结构化 OCR 列

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

不支持的添加文件

不支持添加文件。

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

不支持的修改列参数

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

不支持的箭头类型

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

不支持的批量表值函数

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

不支持的调用

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

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

不支持的字符或VARCHAR作为字符串

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

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

不支持的操作条款

<clause> 不支持 <operation>。

不支持的排序规则

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

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

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

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

如果看到此错误消息，则可能是在不同的外部位置注册了源路径和 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

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

不支持的 SQL 用户定义函数使用

在<functionName>中使用 SQL 函数<nodeName>是不支持的。

不支持无水印的流操作符

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

视图不支持的流选项

你正在使用非类型化的 Scala UDF，则该 UDF 没有输入类型信息。

Spark 可能会盲目地将 null 传递给具有基元类型参数的 Scala 闭包，闭包将会看到该 null 参数对应的 Java 类型的默认值，例如 udf((x: Int) => x, IntegerType)，对于 null 输入结果是 0。若要摆脱此错误，可以：

使用类型化的 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 的 Variant。 Variant 值的最大允许大小为 16 MiB。

VARIANT_DUPLICATE_KEY (变体重复键)

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

变体大小限制

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

请避免向此表达式添加大型输入字符串（例如，添加函数调用）以检查表达式大小，并在太大时将其转换为 NULL。

版本克隆不支持的表特性

源表历史记录包含一些在此 DBR 版本中版本克隆不支持的表特性：<unsupportedFeatureNames>

请升级到较新的 DBR 版本。

视图已存在

无法创建视图 <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：42KDF

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

XML_不支持的嵌套类型

SQLSTATE：0N000

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

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

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

ZORDERBY_COLUMN_DOES_NOT_EXIST (排序列不存在)

ALTER TABLE <table> SET MANAGED 失败。

有关详细信息，请参阅 DELTA_ALTER_TABLE_SET_MANAGED_FAILED

DELTA_ALTER_TABLE_SET_MANAGED_NOT_ENABLED (修改表设置为非管理状态未启用)

ALTER TABLE ... SET MANAGED 命令未启用。请联系 Databricks 支持团队以获取帮助。

DELTA_ALTER_TABLE_UNSET_MANAGED_FAILED (尝试取消表的托管属性失败)

<table> 无法从托管表回滚到外部表。

有关详细信息，请参阅DELTA_ALTER_TABLE_UNSET_MANAGED_FAILED

DELTA_更改_表_未启用_取消_管理权限

ALTER TABLE ... UNSET MANAGED 命令未启用。请联系 Databricks 支持团队以获取帮助。

DELTA_数据类型变更歧义

无法将 <column> 数据类型从 <from> 更改为 <to>。此更改包含列删除和添加，因此它们不明确。请使用 ALTER TABLE [ADD | DROP | RENAME] COLUMN单独进行这些更改。

DELTA_AMBIGUOUS_PARTITION_COLUMN（不明确的分区列）

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块列映射和CDC操作

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

DELTA_布隆过滤器_删除_不存在的列

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

增量布隆过滤器写入时内存不足

SQLSTATE：82100

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

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

无法更改数据类型

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

无法更改位置

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

DELTA_无法更改供应商

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

无法为不存在的列创建布隆过滤器_DELTA

无法为以下不存在的列创建布隆过滤器索引：<unknownCols>。

DELTA_无法创建日志路径

SQLSTATE：42KD5

无法创建 <path>。

无法描述视图历史的Delta操作或功能限制

无法描述视图的历史。

无法在非索引列上删除布隆过滤器

无法删除未编入索引的列上的 Bloom 过滤器索引：<columnName>。

DELTA_CANNOT_DROP_CHECK_CONSTRAINT_FEATURE (无法删除检查约束的功能)

无法删除 CHECK 约束表功能。

必须先删除以下约束：<constraints>。

无法删除排序规则功能

无法从URI重建路径的DELTA

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

DELTA_无法相对化路径

VACUUM LITE 无法删除所有符合条件的文件，因为 Delta 日志未引用某些文件。请运行 VACUUM FULL。

无法将增量写入视图

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

DELTA_CAST_OVERFLOW_IN_TABLE_WRITE（表写入中的DElta转换溢出）

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

请对输入值使用 try_cast 来容忍溢出并改为返回 NULL。

如有必要，将 <storeAssignmentPolicyFlag> 设置为“LEGACY”以绕过此错误，或将 <updateAndMergeCastingFollowsAnsiEnabledFlag> 设置为 true 以还原旧行为，并遵循 <ansiEnabledFlag> 和 UPDATE 中的 MERGE。

此版本中不允许使用DELTA_CDC

配置 delta.enableChangeDataFeed 无法被设置。来自 Delta 的更改数据馈送尚不可用。

增量_CDC_读取空范围边界

SQLSTATE：22004

CDC 读取开始/结束参数不能为空。请提供有效的版本或时间戳。

增量变更数据馈送不兼容的数据架构

由于数据架构不兼容，检索版本 <start> 和 <end> 之间的表更改失败。

你的读取架构是版本 <readSchema> 中的 <readVersion>，但我们发现版本 <incompatibleVersion> 中的数据架构不兼容。

如果可能，请通过将 <config> 设置为 endVersion 使用最终版本的架构来检索表更改，或者联系支持人员。

DELTA_CHANGE_DATA_FEED_INCOMPATIBLE_SCHEMA_CHANGE

由于架构更改不兼容，在版本 <start> 和 <end> 之间检索表更改失败。

您的读取架构为版本 <readSchema>的 <readVersion>，但我们在版本 <incompatibleVersion>中发现了不兼容的架构更改。

如果可能，请分别查询表从版本 <start> 到 <incompatibleVersion> - 1 的更改，以及从版本 <incompatibleVersion> 到 <end>的更改。

DELTA_CHANGE_DATA_FILE_NOT_FOUND (增量更改数据文件未找到)

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

增量变更表已禁用

SQLSTATE：42807

无法写入具有 delta.enableChangeDataFeed 集的表。来自 Delta 的更改数据馈送不可用。

DELTA_检查点_不可用表

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

DELTA_CLONE_不明确的目标

提供了两个路径作为 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_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 表替换为已分区表。

增量聚类展示创建表无聚类列

使用 Liquid 聚类分析的 Delta 表（无任何聚类分析列）不支持 SHOW CREATE TABLE。

保持原英文标识符不变以确保技术准确性：DELTA_CLUSTERING_TO_PARTITIONED_TABLE_WITH_NON_EMPTY_CLUSTERING_COLUMNS

当现有表具有非空聚类分析列时，不允许将具有 Liquid 聚类分析的 Delta 表转换为分区表：<operation>。

请先运行 ALTER TABLE CLUSTER BY NONE 来删除聚类列。

增量聚类与动态分区覆写

使用 Liquid 集群的 Delta 表不允许动态分区覆盖模式。

增量聚类_含分区谓词

使用 Liquid 聚类分析的 Delta 表的 OPTIMIZE 命令不支持分区谓词。请删除谓词：<predicates>。

增量聚类及排序功能 (DELTA_CLUSTERING_WITH_ZORDER_BY)

具有 Liquid 聚类分析的 Delta 表的 OPTIMIZE 命令不能指定 ZORDER BY。请删除 ZORDER BY (<zOrderBy>。

自动不匹配的DELTA_CLUSTER (if translation is applicable and the term is not proprietary)

提供的 clusterByAuto 值与现有表的值不匹配。

按无效列数聚类的Delta

Liquid 聚类分析的 CLUSTER BY 支持最多 <numColumnsLimit> 个聚类分析列，但该表具有 <actualNumColumns> 个聚类分析列。请删除额外的聚类列。

DELTA_CLUSTER_BY_SCHEMA_NOT_PROVIDED（未提供按架构分组的 Delta 集群）

不允许在未定义架构时指定 CLUSTER BY。请为表 <tableName>定义架构。

DELTA_按分桶聚类

无法同时指定聚类分析和分桶。如果要创建包含群集的 Delta 表，请删除 CLUSTERED BY INTO BUCKETS/bucketBy。

DELTA_按组分区_CLUSTER_BY_WITH_PARTITIONED_BY

无法同时指定聚类分析和分区。如果要创建具有聚类分析的 Delta 表，请删除 PARTITIONED BY/partitionBy/partitionedBy。

增量排序不支持

Delta Lake 不支持排序规则。

DELTA列数据跳过不支持分区列

分区列“<column>”不支持跳过数据。

增量列数据跳过不支持类型

类型为 <column> 的列“<type>”不支持跳过数据。

DELTA_COLUMN_MAPPING_MAX_COLUMN_ID_NOT_SET (Delta 列映射最大列 ID 未设置)

未在启用列映射的表中设置最大列 ID 属性（<prop>）。

DELTA_COLUMN_MAPPING_MAX_COLUMN_ID 未正确设置

启用列映射的表的最大列 ID 属性（<prop>）是 <tableMax>，不能小于所有字段的最大列 ID（<fieldMax>）。

DELTA_COLUMN_MISSING_DATA_TYPE (字段缺少数据类型)

未提供列 <colName> 的数据类型。

Δ列未找到

找不到给定 [<columnName>] 的列<columnList>。

在合并中找不到 DELTA 列

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

在架构中找不到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_约束_数据类型不匹配

列 <columnName> 具有数据类型 <columnType>，无法更改为数据类型 <dataType>，因为以下检查约束引用了此列：

<constraints>

增量约束依赖列更改

如果不收集统计信息，则无法启用行跟踪。

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

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

SET <statisticsCollectionPropertyKey> = 真

在没有 NO CONVERT 选项的情况下运行 DELTA TO STATISTICS。

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

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

RESET <rowTrackingTableFeatureDefaultKey>

默认情况下，通过运行以下命令停用表属性：

SET <rowTrackingDefaultPropertyKey> = 假

DELTA_COPY_INTO_TARGET_FORMAT

COPY INTO 目标必须是 Delta 表。

DELTA_创建外部表时没有架构

你正在尝试创建外部表 <tableName>

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

输入路径为空。

若要了解有关 Delta 的详细信息，请参阅 <docLink>

DELTA_创建外部表_无事务日志

您正在尝试使用 Delta 从 <tableName> 创建外部表 <path>，但 <logPath> 没有事务日志。检查上游作业，确保它使用 format("delta") 编写，并且路径是表的根目录。

若要了解有关 Delta 的详细信息，请参阅 <docLink>

增量创建表标识符位置不匹配

不支持创建具有不同位置的基于路径的 Delta 表。标识符： <identifier>，位置： <___location>.

缺少表名或位置的DELTA_CREATE_TABLE错误

必须指定表单名称或位置。

DELTA_创建表_模式不匹配

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

== 指定的 ==

<specifiedSchema>

== 现有 ==

<existingSchema>

== 差异 ==

<schemaDifferences>

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

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

架构匹配。

DELTA创建表设置聚类表功能不允许

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

DELTA_创建不同聚簇的表

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

== 指定的 ==

<specifiedColumns>

== 现有 ==

<existingColumns>

DELTA_创建带有不同分区的表

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

== 指定的 ==

<specifiedColumns>

== 现有 ==

<existingColumns>

DELTA_使用不同属性创建表

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

== 指定的 ==

<specifiedProperties>

== 现有 ==

<existingProperties>

DELTA_在非空位置创建表

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

数据变化为假

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

DELTA_删除的_PARQUET_文件_未找到

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

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

增量删除向量缺少记录数量

提交包含缺少 numRecords 统计信息的删除向量的文件无效。

不允许在合并操作中禁止源实体化

不允许通过将“spark.databricks.delta.merge.materializeSource”设置为“none”来禁用MERGE中的源具体化。

不支持域元数据更改

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

DELTA_DROP_COLUMN_AT_INDEX_LESS_THAN_ZERO (删除列时，索引不能小于零)

SQLSTATE：42KD8

要删除列的索引 <columnIndex> 小于 0。

DELTA_删除单字段架构中的列

无法从具有单个列的架构中删除列。图式：

<schema>

DELTA_重复操作_已找到

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

它与 <conflictingPath>冲突。

在单个提交中，不允许存在具有相同路径的多个文件操作。

发现重复的列

SQLSTATE：42711

找到重复的列<coltype>：<duplicateCols>。

DELTA_DUPLICATE_COLUMNS_ON_INSERT 复制列在插入时的重复事项

子句中的 INSERT 列名重复。

更新表时的DELTA重复列错误

<message>

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

DELTA_重复数据跳过列

找到了重复的数据跳过列：<columns>。

增量重复域元数据内部错误

内部错误：同一事务中的两个 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_合并架构文件失败

SQLSTATE：42KDA

未能合并文件 <file>的架构：

<schema>

DELTA_浅层克隆操作失败

SQLSTATE：42893

由于浅克隆<sourceTable>仍然存在，并且其中发生了以下错误：<targetTable>，所以无法在源表<message>上运行操作。

DELTA_读取文件尾部失败

SQLSTATE：KD001

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

DELTA_识别谓词失败

无法识别谓词“<predicate>”。

DELTA扫描失败，具有历史版本

预期会对最新版本的 Delta 源进行完整扫描，但却发现了版本 <historicalVersion> 的历史扫描。

DELTA_合并字段失败

SQLSTATE：22005

未能合并字段“<currentField>”和“<updateField>”。

增量功能协议元数据不匹配

无法对此表进行作，因为下表功能在元数据中已启用，但未在协议中列出：<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_功能_删除_检查点_失败

由于检查点创建失败，删除 <featureName> 失败。

请稍后重试。此问题仍然存在，请与 Databricks 支持部门联系。

DELTA_FEATURE_DROP_CHECKPOINT保护等待保留期

操作未成功，因为仍然存在已删除特征的痕迹。

表历史记录中。 CheckpointProtection 在这些历史版本过期之前

无法删除。

若要删除 CheckpointProtection，请等待历史版本

过期，然后重复此命令。历史版本的保留期为

当前配置为 <truncateHistoryLogRetentionPeriod>。

增量功能丢弃冲突重新验证失败

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

请再次尝试该操作。

<concurrentCommit>

删除依赖功能

无法删除表功能 <feature>，因为此表中的一些其他功能（<dependentFeatures>）依赖于 <feature>。

在删除此功能之前，请考虑先删除它们。

DELTA_功能删除_未呈现功能

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

DELTA_特性_删除历史版本存在

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

请等到历史记录保留期（<logRetentionPeriodKey>=<logRetentionPeriod>）

自该功能上次处于活动状态以来，时间已过去。

或者，请等待 TRUNCATE HISTORY 保留期到期（<truncateHistoryLogRetentionPeriod>）

然后运行：

ALTER TABLE DROP FEATURE table_name TRUNCATE HISTORY feature_name TRUNCATE HISTORY

三角洲功能删除历史记录截断不允许

特定功能不需要历史记录截断。

DELTA_FEATURE_DROP_NONREMOVABLE_FEATURE

无法删除 <feature>，因为不支持删除此功能。

请联系 Databricks 支持部门。

功能删除_不支持的客户端功能

无法删除 <feature>，因为此 Databricks 版本不支持它。

请考虑将 Databricks 与更高版本配合使用。

增量特性删除等待保留期

删除 <feature> 部分成功。

此功能现在不再用于表的当前版本。但是，该功能

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

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

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

在候选文件中找不到要重写的文件（<path>）：

<pathList>

DELTA_发现地图类型列

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

：

<key> 或

<value>

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

例如 mymap.key.mykey

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

图式：

<schema>

DELTAX生成的列数据类型不匹配

列 <columnName> 具有数据类型 <columnType>，无法更改为数据类型 <dataType>，因为以下生成的列引用了此列：

<generatedColumns>。

增量生成列依赖列更改

无法更改列 <columnName>，因为以下生成的列引用了此列：

<generatedColumns>。

DELTA 生成列表达式类型不匹配

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

Delta生成列更新类型不匹配

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

DELTA_GEOSPATIAL_不受支持

此版本的 Delta Lake 不支持地理空间类型。

DELTA_GEOSPATIAL_SRID_NOT_SUPPORTED (不支持的地理空间SRID)

地理空间类型具有不支持的空间参考标识符 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_标识列_更改非标识列

不能对非 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 (Delta 标识列不支持的数据类型)

SQLSTATE：428H2

<dataType> 列不支持 DataType IDENTITY。

不支持对 Delta 标识列进行更新

SQLSTATE：42808

不支持对 UPDATE 列 IDENTITY 运行 <colName>。

DELTA_标识列_带有_生成的_表达式

不能使用生成的列表达式指定 IDENTITY 列。

DELTA_非法选项

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

DELTA_非法使用

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

增量_不一致_桶规格

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

Δ_不一致_日志存储_配置

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

DELTA_数组访问错误

错误地访问数组类型。使用 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>。必须在读取和

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

若要了解有关 Delta 的详细信息，请参阅 <docLink>

DELTA_INVALID_生成列引用无效

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

DELTA无效幂等写入选项

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

Δ无效时间间隔

<interval> 不是有效的 INTERVAL。

DELTA_库存架构无效

指定 INVENTORY 的架构不包含所有必填字段。必填字段为：<expectedSchema>

DELTA_无效隔离级别

无效的隔离级别“<isolationLevel>”。

增量无效日志存储配置

（<classConfig>）和（<schemeConfig>）不能同时设置。请仅设置其中一组。

DELTA_无效的托管表语法_无模式

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

超过最大数组大小限制

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

DELTA_MAX_COMMIT_RETRIES_EXCEEDED (超过最大提交重试次数)

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

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

造成的。

提交开始于版本：<startVersion>

提交失败的版本：<failVersion>

尝试提交的操作数：<numActions>

尝试此提交所用的总时间：<timeSpent> ms

DELTA_MAX_LIST_FILE_EXCEEDED

文件列表必须最多有 <maxFileListSize> 个条目，实际有 <numFiles> 个。

增量合并新增空列

无法添加类型为 VOID 的列 <newColumn>。请显式指定非 void 类型。

DELTA_MERGE_INCOMPATIBLE_DATATYPE

未能合并不兼容的数据类型 <currentDataType> 和 <updateDataType>。

不兼容的十进制类型合并在DELTA中

SQLSTATE：42806

无法合并与 <decimalRanges> 不兼容的十进制类型。

DELTA合并物化源反复失败

保留已具体化的 MERGE 语句的源已一再失败。

DELTAMERGE缺失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 TABLE table_name SET TBLPROPERTIES

(<key>=true)`。

DELTA_MISSING_COLUMN 缺失列

在表列中找不到<columnName>： <columnList>

DELTA_缺少提交信息

此表启用了特征 <featureName>，这要求每次提交中都存在 CommitInfo 操作。但是，提交版本 <version>中缺少 CommitInfo操作。

增量缺失提交时间戳

此表启用了编号为 <featureName> 的功能，这要求在 CommitInfo 操作中存在 commitTimestamp。但是，此字段尚未在提交版本 <version>中设置。

DELTA_MISSING_DELTA_TABLE（缺失的 Delta 表格）

<tableName> 不是 Delta 表。

DELTA_缺少_DELTA_表复制导入

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

DELTA_缺失_冰山_类

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

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

DELTA_缺失非空列值

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边界

SQLSTATE：42614

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

布隆过滤器中的单列多重配置差异

SQLSTATE：42614

多个布隆过滤器索引配置传递给了列命令：<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 分桶表内部使用：<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_非分区列缺失

SQLSTATE：KD005

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

DELTA_非分区列引用

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

DELTA_NON_PARTITION_COLUMN_SPECIFIED (指定了非分区列)

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

DELTA_非单独部分命名空间_用于目录

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

命令不支持DELTA_NON_UC_COMMIT_COORDINATOR

不支持通过命令将提交协调器设置为“<nonUcCoordinatorName>”，因为 UC 管理的表只能将“unity-catalog”设置为提交协调器。请将其更改为“unity-catalog”，或者从 TBLPROPERTIES 子句中删除所有协调提交表属性，然后再次重试该命令。

DELTA 非 UC 提交协调器在会话中不支持

不支持从 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_不是_DATABRICKS_DELTA表

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

DELTA_NOT_A_DELTA_TABLE（不是一个 Delta 表）

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

找不到非空列在结构中

在结构中找不到不可为空的列：<struct>。

DELTA_非空约束_违反

SQLSTATE：23502

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

DELTA_不可为空的嵌套字段

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

未找到提交记录

SQLSTATE：KD006

在<logPath>中找不到任何提交。

未找到可重建的历史_DELTA

SQLSTATE：KD006

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

DELTA_无重定向规则违规

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

DELTA_PROTOCOL_PROPERTY_NOT_INT (增量协议属性不是整数)

协议属性 <key> 必须是整数。已找到 <value>。

增量读取功能协议需要写入

无法仅升级读取器协议版本以使用表功能。写入器协议版本必须至少为 <writerVersion> 才能继续。有关表协议版本的详细信息，请参阅 <docLink>。

DELTA_读取无列表格

SQLSTATE：428GU

尝试读取不包含任何列的 Delta 表 <tableName>。

使用选项 mergeSchema = true 写入一些新数据，以便能够读取表。

增量正则表达式选项语法错误

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>

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

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

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

增量模式分析后的模式更改

Delta 表的架构已因您的 DataFrame 发生不兼容的更改，导致该表不可正确使用。

或者 DeltaTable 对象已被创建。请重新定义 DataFrame 或 DeltaTable 对象。

变化：

<schemaDiff> <legacyFlagMessage>

未提供增量模式

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

增量模式未设置

SQLSTATE：KD008

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

DELTA_设置位置模式不匹配

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

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

非分区表中的 DELTA 显示分区

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>)。

变化：

<columnChangeDetails>

请在我们使用最终定稿架构版本<currentSchemaChangeVersion>进行流处理之前，查看是否需要手动传播架构更改到汇聚表。

一旦您修复了目标表的架构或决定无需修复，您可以设置以下配置以解除非累加架构更改的阻碍并继续流处理。

使用数据框架读取器的选项：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeOptions>

若要解除屏蔽此特定流：

<unblockStreamOptions>

使用 SQL 配置：

要取消对这特定数据流的阻止，仅针对这一系列架构更改：

<unblockChangeConfs>

若要解除屏蔽此特定流：

<unblockStreamConfs>

要解除所有流的阻止：

<unblockAllConfs>

增量流检查列映射无快照

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

数据流不兼容的模式更改

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

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

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

流式处理中的不兼容架构更改，请使用架构日志

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

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

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

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

DELTA流媒体元数据演变

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

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

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

更新的架构：<schema>。

更新的表配置：<config>。

更新的表协议：<protocol>

DELTA_STREAMING_SCHEMA_EVOLUTION_UNSUPPORTED_ROW_FILTER_COLUMN_MASKS

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

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

DELTA_STREAMING_SCHEMA_LOCATION_CONFLICT (Delta流媒体模式位置冲突)

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

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

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

DELTA_STREAMING_SCHEMA_LOCATION_NOT_UNDER_CHECKPOINT（Delta流数据架构位置未在检查点下）

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

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

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

DELTA_流式_架构日志_解析架构失败

无法从 Delta 流式处理源架构日志文件中解析架构。

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

DELTA 表已经包含变更数据捕获列

SQLSTATE：42711

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

保留的列 <columnList>，

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

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

DELTA表已存在

表 <tableName> 已存在。

路径不支持的Hadoop配置的DELTA_TABLE

目前 DeltaTable.forPath 仅支持以 <allowedPrefixes> 开头的 hadoop 配置密钥，但输入为 <unsupportedOptions>。

DELTA_表_ID_不匹配

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

表的 ID 从 <oldId> 变为 <newId>。

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

DELTA表无效重定向状态转换

无法更新表重定向状态：尝试状态转换无效。

Delta 表<table>无法从<oldState>更改为<newState>。

DELTA表无效的设置或取消重定向

无法对SET上的属性 UNSET 或 <table> 重定向：当前属性 '<currentProperty>' 与新属性 '<newProperty>' 不匹配。

DELTA_TABLE_位置不匹配

现有的表 <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

目标表最终架构为空。

增量时间戳大于提交时间

目录分区架构：

<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统一兼容性位置）

统一兼容性格式的位置缺失或无效。请为 delta.universalFormat.compatibility.___location 设置空目录。

失败的原因：

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

DELTA_UNIFORM_ICEBERG_入口违规

具有 Delta Uniform 的 Read Iceberg 的失败。

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

待命_均匀_入口_不明确_格式

发现多个 Delta Uniform 入口格式（<formats>），最多只能设置一个。

不支持 DELTA_UNIFORM_INGRESS

不支持创建或刷新统一入口表。

DELTA_UNIFORM_入口不支持的格式

不支持格式 <fileFormat>。仅支持冰山和 hudi 作为原始文件格式。

三角形统一入口违规

通用格式（<format>）的验证失败： <violation>。

DELTA_未知配置

无法对列 <opName> 执行列映射操作 <quotedColumnNames>

因为这些列包含布隆筛选索引。

如果你要对包含布隆筛选索引的列执行

列映射操作，

请先删除布隆筛选器索引：

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

包含删除向量的表版本不支持“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_不支持写入示例表

不支持写入示例表。

DELTA_UPDATE_SCHEMA_MISMATCH_EXPRESSION (增量更新中架构不匹配表达式)

无法将 <fromCatalog> 强制转换为 <toCatalog>。所有嵌套列必须匹配。

DELTA_V2_操作所需检查点

CHECKPOINT 操作需要在表上启用 V2 检查点。

DELTA_VACUUM_COPY_INTO_STATE_FAILED（状态复制失败）

数据文件上的 VACUUM 操作已成功，但 COPY INTO 状态的垃圾回收操作失败。

DELTA_VERSIONS_NOT_CONTIGUOUS

SQLSTATE：KD00C

版本（<versionList>）不是连续的。

在尝试加载版本<startVersion>时检测到版本<endVersion><versionToLoad>之间的增量日志中的差距。

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

DELTA_VERSION_INVALID（增量版本无效）

SQLSTATE：42815

提供的版本（<version>）不是有效的版本。

DELTA_违反约束条件_包含值

SQLSTATE：23001

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

<values>。

DELTA违反了表属性验证失败

表 <table> 的属性验证已被违反。

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

不支持将增量写入视图

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

DELTA_ZORDERING_COLUMN_DOES_NOT_EXIST (Delta Z排序列不存在)

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

无统计数据的列上的DELTA层排序

DS 工作空间域未设置

SQLSTATE：未分配

<dsError>：未设置工作区 <workspaceId> 域。

DS_工作空间_未找到

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>

若要修复，可以：

向源目录授予写入权限并移动目标 OR
将 cleanSource 设置为“OFF”

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

CF_重复数据中的列

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

用于模式推断的空目录 CF

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

事件网格认证错误

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

主体具有 <permissionType> 事件网格订阅。请参阅以下位置的更多详细信息：

<docLink>

CF_EVENT_GRID_CREATION_FAILED (事件网格创建失败)

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

在订阅中注册为资源提供程序。请参阅以下位置的更多详细信息：

<docLink>

CF_EVENT_GRID_未找到错误

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

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

CF_无法写入架构日志

无法在位置 <path>写入架构日志。

CF_FILE_FORMAT_REQUIRED (文件格式要求)

找不到所需的选项：cloudFiles.format。

找到多个自动加载器的发布订阅订阅项

发现主题 <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 中多次：

<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（找不到SFTP用户名）

找到未知选项键：

<optionList>

H3 网格距离 <k> 必须为非负

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

H3_无效解析值

H3 分辨率 <r> 必须介于 <minR> 和 <maxR>之间（含两端）

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

H3_NOT_ENABLED

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

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

WKT_PARSE_ERROR

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

SQLSTATE：未分配

已存在一个活动更新“<updateId>”用于链接的管道“<linkedPipelineId>”。

管道存在有效更新

对于管道“<updateId>”，已经存在一个活动更新“<pipelineId>”。

不允许对管道表进行ALTER操作

不允许对由 a 管理的表使用

有关详细信息，请参阅ALTER_NOT_ALLOWED_FOR_PIPELINE_TABLE

修改的计划不存在

在没有现有计划或触发器的情况下，无法更改表上的 <type>。在尝试更改表格之前，请先向其添加日程或触发器。

API配额已超出

已超出数据源 <sourceName>的 API 配额。

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

应用更改错误

在自动CDC操作期间发生错误。

有关详细信息，请参阅APPLY_CHANGES_ERROR

从快照应用更改错误

在AUTO CDC FROM SNAPSHOT操作期间发生错误。

有关详细信息，请参阅APPLY_CHANGES_FROM_SNAPSHOT_ERROR

不支持从快照应用变更的预期

数据集 <datasetName> 定义了预期，但目前不支持使用 AUTO CDC FROM SNAPSHOT数据集的预期。

消除对解决此错误的期望。作为替代方法，请考虑使用以下结构通过组合 AUTO CDC 和 AUTO CDC FROM SNAPSHOT应用预期：

使用 SCD 类型 1 将快照的更改应用到中间表中，无需任何期望。
使用spark.readStream.option("readChangeFeed", "true").table从中间表中读取更改。
将中间表的更改应用到最终目标表 dlt.create_auto_cdc_flow，使用以下参数以及当前已与 dlt.acreate_auto_cdc_flow_from_snapshot 使用的参数：

处理更改： apply_as_deletes = "_change_type == 'delete'"
删除 CDF 添加的列： except_column_list = ["_change_type", "_commit_version", "_commit_timestamp"]

包括用于 dlt.create_auto_cdc_flow的最终目标表的当前预期集。

应用更改部分更新未启用

功能 COLUMNS 到 UPDATE 处于预览状态，并未在您的工作区中启用。请联系 Databricks 代表，详细了解此功能并访问个人预览版。

架构迁移失败

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

ARCLIGHT_需要_无服务器

使用默认存储定位目录的管道必须使用无服务器计算。如果您无权访问无服务器计算服务，请联系 Databricks 为您的工作区启用该功能。

无法将列添加到包含的列中

新列 (<columnNames>) 已添加到表 <qualifiedTableName> 的管道定义中的 include_columns 字段。请完全刷新表以避免潜在的数据丢失或从include_columns中删除这些列。

无法添加存储位置

如果要设置存储位置创建新管道，则无法将存储位置添加到具有已定义目录的现有管道。

现有目录：“<catalog>”。

请求的存储位置： <storageLocation>.

无法构建装饰器

SQLSTATE：未分配

@<decoratorName>修饰器无法组合与<otherDecorators>使用。

无法排除不存在的列

管道定义排除源 <columnNames>表 <qualifiedTableName> 中不存在的列（<sourceType>）。请从exclude_columns字段中删除这些列。

无法筛选出必需列

管道定义不包括源 <columnNames> 的引入表 <qualifiedTableName> 所需的列 (<sourceType>)。请将其添加到include_columns，或将其从exclude_columns中删除。

无法包含不存在的列

管道定义包括源 <columnNames>表 <qualifiedTableName> 中不存在的列（<sourceType>）。请从include_columns字段中删除这些列。

无法导入没有主键的表

源中的<qualifiedTableName>表<sourceType>没有主键。

请在连接器配置中指定主键以引入表（如果存在）。

无法修改UC管道的管道所有者

尚不支持更改非 UC 管道的所有者。

无法修改管道所有者 - 权限被拒绝

在表 <columnNames>的管道定义中，列（<qualifiedTableName>）被从 exclude_columns 字段中删除。请对表格进行完全刷新以避免潜在的数据丢失，或者将这些列重新添加到 exclude_columns 中。

无法为HMS_PIPELINE设置目录

根据用例和架构更改，你也许能够删除架构更改 -- 可以更新查询，以便输出架构与现有架构兼容（例如，通过显式将列强制转换为正确的数据类型）。

不能写入非活动列

<details>

但是，目标表已具有具有此名称的非活动列;这些列处于非活动状态，因为它们以前是从源表中删除的。

若要继续更新，请对表使用 FULL REFRESH 命令或使用 ALTER TABLE DROP COLUMN 命令删除这些非活动列。

无法写入非活动表

目标中的下表处于非活动状态，并且与当前源表冲突：<tables>。

这些表保持非活动状态，因为它们以前已从源中删除或未从连接器中选择。

若要继续更新，请对表执行 FULL REFRESH，或者从目录资源管理器中的目标中删除这些非活动表，或通过 DROP TABLE 命令删除这些非活动表，然后重试更新。

无法写入待重置的表格

在上一次完整刷新中，目标中的下列表格未正确重置：<tables>。

请对其触发完全刷新以恢复。

目录映射在UC中不可用

SQLSTATE：3D000

UC 目录没有针对目录 <sourceCatalog> 的映射。

目录模式与目标管道不匹配

ID 为 <destPipelineCatalog> 的目标管道的目录 <destPipelineSchema> 和架构 <destPipelineId> 与表 <tableName> 的目录和架构不匹配。目标管道应具有与表相同的目录和架构，或者目标管道必须使用直接发布模式。

目录规范不支持

数据库连接器当前不支持 CatalogSpecs。请删除目录规范。

CDC_APPLIER_COLUMN_UOID_不支持

CDC 托管引入管道不支持表 <columnNames> 中具有 UOID <tableName> 的列。

请检查引入管道是否支持列 UOID，或请求完全刷新。

从网关来的CDC应用程序致命故障

网关管道遇到严重错误：

<errorMessage>

请在这里查看管道更新失败：<link>

CDC_应用者_复制表_元数据_未准备好

表<tableName>的复制表元数据尚未准备就绪。

现有的作业请求时间戳是 <existingRequestTs>，但我们需要 <expectedRequestTs> 或更高版本。

CDC_应用程序要求对所有目标表进行完全刷新

不支持完全刷新一个目标表，不支持从同一源对另一个目标表进行正常更新。

请完全刷新这两个表，以便尽可能继续。

完全刷新表：<fullRefreshTables>

源 <sourceTable> 的目标表：<destinationTables>

CDC应用程序在流式传输期间架构发生更改

架构版本 <dataSchemaVersion> 与读取的架构版本 <readSchemaVersion>不同。

DLT 将重试更新。

CDC_应用_按列顺序未找到

在 sequenceBy 中指定的表 <columnName> 的列 <tableName> 在 <columns> 中不存在。

CDC_应用程序_序列_按_无效类型

sequenceBy 中指定的表<columnName>的列<tableName>的类型<typeName>不受支持。

sequenceBy 列支持的类型有<allowedTypes>。

不支持按多列排序的CDC应用程序顺序

在 CDC 管理的摄取管道的 sequenceBy 中最多只能指定一个列。

为表 <columns> 指定的列： <tableName>。

CDC_不兼容的模式更改

我们从架构版本 <cause> 到 <previousSchemaVersion>遇到不兼容的架构更改（<currentSchemaVersion>）。

因此，我们不能继续对 <tableName>应用更改。请请求完全刷新表。

以前的架构：<previousSchema>

当前架构：<currentSchema>

CDC_潜在数据差距

下表 [<needFullRefreshTableList>] 在 <retention> 天内没有成功的更新。

请对这些表或整个数据管道进行全面刷新。

从多个来源获取相同表的CDC

从多个源找到同一个表名 <table>：<sources>。

请将它们拆分为不同的管道，以避免冲突。

来自多个来源表的CDC映射到相同的目标表

找到多个源表： <source_tables> 映射到同一目标表 <destination_table>。

请将它们映射到不同的目标表名称或不同的目标架构。

CDC表在所有表中未找到

在源数据库的所有表快照中找不到表 <table>。

检查管道群集配置和关联的群集策略。

集群创建额度已耗尽

SQLSTATE：57000

无法创建群集，因为已耗尽可用额度。请添加付款方式以升级帐户。

群集创建资源耗尽

SQLSTATE：57000

无法创建群集，因为已超出资源限制： <errorMessage>

集群启动客户端错误

SQLSTATE：KDL01

未能启动管道群集 <clusterId>：<clusterStateMessage>

此错误可能是由于管道中的配置错误。

检查管道群集配置和关联的群集策略。

集群启动云端失败

SQLSTATE：58000

未能启动管道群集 <clusterId>：<clusterStateMessage>

此错误可能是暂时性的 - 重启管道，如果仍然看到相同的问题，请报告。

CLUSTER_SETUP_CLIENT_ERROR（集群设置客户端错误）

SQLSTATE：KDL01

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

集群无法访问

SQLSTATE：08000

与驱动程序通信丢失。群集 <clusterId> 有 <timeoutSeconds> 秒无法访问。

无列的列掩码

为 MV/ST 架构中不存在的列“”<columnName>找到的列掩码。如果这是因为对基表的架构进行更改，

请丢弃旧掩码ALTER TABLE [table_name] ALTER COLUMN [应用掩码的列] DROP MASK; 或还原该列。

未找到要更新的列

在源数据帧中找不到 <column> TO COLUMNS 中指定的列 UPDATE。

无法停止以前的更新导致并行升级失败

启动了升级的更新“<upgradedUpdateId>”，但未能停止之前的更新“<oldUpdateId>”。

此错误可能是暂时性的。管道将自动重试，问题应自行解决。

如果仍然看到相同的问题，请将此错误报告给 Databricks。

数据集装饰器应用两次

SQLSTATE：未分配

数据集 <datasetName> 已存在。确保查询函数仅标记为视图或表一次。

数据集_未定义

重复自JSON架构位置

重复的“from_json”模式位置键：<schemaLocationKey>。

请在管道中为每个from_json查询选择唯一的架构位置键

未启用“explore_only”更新。

仅在非数据摄取管道上探索

对于引入管道，explore_only只能设置为 true。

无法创建事件日志

未能使用标识符 <pipelineId>创建管道（id=<eventLogIdentifier>）事件日志。有关更多详细信息，请参阅下面的异常。

无法将视图发布到元存储

无法将视图 <viewName> 发布到元存储，因为 <reason>。

无法更新事件日志

未能将管道（id=<pipelineId>）事件日志标识符更新为 <newEventLogIdentifier>。有关更多详细信息，请参阅下面的异常。

流程架构已更改

流 <flowName> 已终止，因为它在执行期间遇到架构更改。

架构更改与现有目标架构兼容，下一次流程运行可以使用新架构恢复。

FORACH_BATCH_SINK_ONLY_SUPPORTED_IN_PREVIEW_CHANNEL仅在预览频道中支持

目前不支持 DLT ForeachBatch 接收器。

DLT ForeachBatch 接收器的专用预览版需要 PREVIEW 通道。

DLT 接收器：<sinkNames>

网关管道初始化脚本不允许

网关管道不允许群集初始化脚本。请将其从 <from>中删除。

网关管道Spark配置不允许

网关管道不允许 spark 配置 [<configs>]。请将其从 <from>中删除。

获取组织更新容量限制已超出

请求的组织 ID 数超过允许的最大限制 <limit>

GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SOURCE_CATALOG_MISSING (Google Analytics 原始数据连接器源目录丢失)

Google Analytics 原始数据连接器中发生错误。

数据接入网关 pG 发布更改失败

无法更改 “<entityType>” 的<entityName>复制发布

错误消息：<errorMessage>

有关详细信息，请参阅INGESTION_GATEWAY_PG_PUBLICATION_ALTER_FAILED

内容网关PG发布创建失败

无法为 <entityType><entityName> 创建复制发布

错误消息：<errorMessage>

有关详细信息，请参阅INGESTION_GATEWAY_PG_PUBLICATION_CREATION_FAILED

INGESTION_GATEWAY_PG_PUBLICATION_DROP_FAILED（数据传输网关PG发布删除失败）

未能删除“”<entityType> 的<entityName>复制发布

错误消息：<errorMessage>

有关详细信息，请参阅INGESTION_GATEWAY_PG_PUBLICATION_DROP_FAILED

入口网关已被其他进程消耗的PG插槽

由于复制槽被另一个 PID 使用，无法为 <entityType> “”<entityName>创建复制槽。

错误消息：<errorMessage>

数据网关PG插槽创建失败

无法为 <entityType> “”<entityName>创建复制槽

错误消息：<errorMessage>

有关详细信息，请参阅INGESTION_GATEWAY_PG_SLOT_CREATION_FAILED

数据网关源权限不足故障

用户没有访问此对象或执行存储过程所需的权限。请确保授予所有必要的特权。请参阅以下文档： https://docs.databricks.com/aws/en/ingestion/lakeflow-connect/sql-server/database-user-requirements

INGESTION_GATEWAY_主机或端口不可达故障

SQLSTATE：08000

由于源数据库的主机名 <host> 和/或端口 <port> 不正确，连接失败。

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

无效的应用更改命令

AUTO CDC 命令无效。 <reason>。

无效的参数类型

SQLSTATE：未分配

传递给参数<paramName> 的值类型无效。应为 <expectedType>。 <additionalMsg>。

无效兼容性选项

元数据存储操作超时 (METASTORE_OPERATION_TIMED_OUT)

SQLSTATE：58000

更新 <tableName> 元存储信息所涉及的操作所需的时间比 <timeout>长。

此问题可能是暂时性的，也可能指示配置的元存储客户端中的 bug。如果问题仍然存在，请尝试重启管道并报告此问题。

缺少创建模式的权限

用户“<userName>”无权在目录中创建架构 <catalogName>

缺少创建表权限

用户“<userName>”无权在架构中创建表 <schemaName>

缺少“作为用户运行”配置

SQLSTATE：28000

未为更新指定运行方式用户。

互斥选项

互斥选项 <options>。请删除其中一个选项。

负值

SQLSTATE：未分配

值 <arg_name> 必须大于或等于 0，得到“<arg_value>”。

非UC表已由其他管道管理

表 '<tableName>' 已由管道 <otherPipelineId>管理。

如果希望表<tableName>由此管道管理，

从管道“”<otherPipelineId>中删除表。
启动此管道的完整刷新更新。

ID 为“”<pipelineId>的管道不存在。

有关详细信息，请参阅PIPELINE_DOES_NOT_EXIST

管道环境未启用

未启用 DLT 中的环境。

不允许的管道环境版本

管道的环境当前不支持环境版本。

流水线因并发更新而未能更新UC表

管道在经历了<tableName>次尝试后因并发更改无法更新UC表（<attempts>）。

请验证是否有外部进程修改表，请重试更新，如果此问题仍然存在，请联系 Databricks 支持部门。

表格所需刷新管道

该表 <tableName> 未处于所需状态，该表最近尚未更新。必须再次运行 ID 为“”<pipelineId>的管道，然后重试该作。

未找到表的管道

找不到 ID 为“”<pipelineId>的管道，用于管理表 <tableName>。请确保您所在的工作区与管道所在的工作区一致，您是该管道的所有者，并且该管道至少运行过一次。

管道全局包含冲突

应在管道设置中的库下设置 glob 或笔记本/文件字段。请更改管道设置。

管道全局包含不支持

使用 glob 字段包含源文件是一项预览功能，目前处于禁用状态。

重新选择要包含的每个源文件，以便管道修复此错误。

联系 Databricks 支持人员，详细了解此功能并注册预览版。

调用 %pip 安装时出错。

在笔记本顶部位置不安装PIP

找到包含 %pip 安装的单元格，这些单元格不在“”<notebookPath>笔记本顶部

将所有 %pip install 单元格移动到该笔记本的开头。

PY4J_BLOCKED_API

SQLSTATE：未分配

你使用的是当前环境中不支持的 Python API。

请查看 Databricks 文档了解替代项。

<additionalInfo>

引用_DLT数据集_超出查询定义

不支持引用数据集查询定义外部的 DLT 数据集 <identifier>（即 @dlt.table 批注）。请改为在数据集查询定义中读取它。

从无效工作区启动的刷新

SAAS连接器刷新令牌已过期

连接的 <connectionName> 刷新令牌已过期。编辑连接、重新进行身份验证并重新运行管道。

SAAS连接器架构更改错误

架构更改发生在 <tableName> 源的表 <sourceName> 中。

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

软件即服务连接器来源API错误

提供的连接 <connectionName> 不可访问。请检查连接，然后重试。

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

架构规范_空目录

SQLSTATE：3D000

SchemaSpec 在目录字段中有一个空字符串。

请删除空字符串或添加目录名称。（如果此架构不属于源中的目录，请不要设置字段。

架构规格详细信息：

<schemaSpec>

SCHEMA_SPEC_EMPTY_SCHEMA

SQLSTATE：3F000

SchemaSpec 在架构字段中有一个空字符串。

请删除空字符串或添加架构名称。（如果此表不属于源中的架构，请不要设置字段。

架构规格详细信息：

<schemaSpec>

SCHEMA_SPEC_REQUIRE_ONE_OF_CATALOG_SCHEMA

ServiceNow 中发生错误。源 API 类型：<saasSourceApiType>。

有关详细信息，请参阅SERVICENOW_CONNECTION_ERROR

ServiceNow 中发生错误。源 API 类型：<saasSourceApiType>。

当表的数据提取时间过长时，通常会发生这种情况。作为第一步，请与 ServiceNow 管理员协作，在游标列上启用索引。

游标列是从以下列表中选择的，按可用性和首选项的顺序：sys_updated_on（第一个选项）、sys_created_on（第二个选项）、sys_archived（第三个选项）

有关在 ServiceNow 中启用索引的说明，请参阅： https://docs.databricks.com/ingestion/lakeflow-connect/servicenow-overview#why-is-my-servicenow-ingestion-performance-slow.

我们还建议将 REST API 查询超时增加到 60 秒以上，以允许更多时间提取记录。

然后，重试引入管道。如果问题仍然存在，请提交工单。

服务Now连接器方案字段类型不匹配

提取表架构时，ServiceNow 中发生错误。

为字段“”<fieldName>“”<firstDataType>和“”<secondDataType>找到了两种冲突的数据类型。

若要继续运行管道，请删除此表。如果错误仍然存在，请提交票证。

SERVICENOW连接器未经授权访问错误

ServiceNow 中发生错误。源 API 类型：<saasSourceApiType>。

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

不允许为管道表设置表属性

SQLSTATE：0AKLT

ALTER <commandTableType> ... SET TBLPROPERTIES 不支持。若要修改表属性，请更改原始定义并运行更新。

SFDC_CONNECTOR_BULK_QUERY_JOB_INCOMPLETE（SFDC 连接器批量查询作业未完成）

对象 <objName> 的引入不完整，因为 Salesforce API 查询作业花费的时间过长、失败或已手动取消。

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

SFDC_CONNECTOR_BULK_QUERY_NOT_FOUND（未找到SFDC连接器批量查询）

对象 <objName> 引入失败，因为找不到 Salesforce 批量 API 查询作业。

请对特定目标表执行 FULL REFRESH。

SFDC连接器创建批量查询API超出限制

Salesforce API 调用中出现错误：超出 API 限制

请等待 API 限制重置。然后尝试刷新目标表。

如果错误仍然存在，请提交票证。

SFDC_CONNECTOR_CREATE_BULK_QUERY_JOB_FAILED (请注意：Salesforce 连接器创建批量查询作业失败)

由于创建 Salesforce 批量 API 查询作业失败，对象 <objName> 引入不完整。错误代码：<saasSourceApiErrorCode>。

<actionText>。

水槽不支持在SEG中

启用了无服务器出口控件的工作区不支持管道中的 DLT 接收器。支持的 DLT 数据流接收端包括 Kafka 和 Delta。

找到以下不支持的接收器：<sinkNames>，其相应的格式为：<sinkFormats>。

源表未实现

无法读取依赖数据集“”<sourceTableName>，因为它未具体化。运行整个工作流以生成所有依赖的数据集。

独立私有MVST不支持

不支持创建独立的 PRIVATE MV/ST。请删除 PRIVATE 修饰符

未定义的流目标

找不到<target>对应的<command>命令的目标表。管道中未定义目标表 <target>。

同步表用户错误

同步表管道用户错误。

有关详细信息，请参阅SYNCED_TABLE_USER_ERROR

在操作期间表已更改

表 <tableName> 已在此事务之外进行了修改，并且此事务已回滚。重试操作。

表物化循环外键依赖关系

管道更新：<pipelineId> 检测到外键约束的循环链：<tables>。

表名为空。请提供表名。

表规范详细信息：

<tableSpec>

表令牌不存在于架构演变遗留表中

请修改写入此表的流，使其架构兼容。

到目前为止，推断的架构：

<inferredDataSchema>

不兼容的架构：

<incompatibleDataSchema>

意外的管道方案权限错误

检查管道 <pipelineId>的架构权限时出现意外错误。请联系 Databricks 支持部门。

ROW_FILTERSUNIFORM_COMPATIBILITY_CANNOT_SET_WITH__OR_COLUMN_MASKS

不能对应用行筛选器或列掩码的物化视图或流式表设置统一的兼容性。

UNITY_CATALOG_初始化失败

SQLSTATE：56000

在群集 <clusterId>上设置管道时遇到 Unity 目录错误。

确保 Unity 目录配置正确，并且所需的资源（例如目录、架构）存在且可访问。

此外，请验证群集是否具有访问 Unity 目录的适当权限。

详细信息：<ucErrorMessage>

未解决的下游路径

无法解析接收器 <identifier> 的存储路径。请联系 Databricks 支持部门。

未解决的维护表格

不支持提供的引入类型 <ingestionType>。

如果此问题仍然存在，请联系 Databricks 支持部门。

不支持的SPARK SQL命令

DLT Python 中的 spark.sql（“...”） API 不支持'<command>' 。支持的命令：<supportedCommands>。

更新后的非数据库SQL管道定义集

只有 DBSQL 管道才能有更新的定义。

在HMS中使用目录

仅在启用了 UC 的 Lakeflow 声明性管道中受支持 USE CATALOG

查看未在UC中保存的文本

无法刷新表 <tableName>，因为它没有保存在 Unity 目录中的查询。请联系 Databricks 支持部门。

WORKDAY_REPORTS_CONNECTOR_报告未找到错误

Workday 报表中发生错误。源 API 类型：<saasSourceApiType>。

报表 URL“”<reportUrl>不正确。请检查基 URL 或报表名称中的任何拼写错误以解决此问题。

如果问题仍然存在，请提交工单。

Workday 报告连接器未授权访问错误

Workday 报表中发生错误。源 API 类型：<saasSourceApiType>。

有关详细信息，请参阅WORKDAY_REPORTS_CONNECTOR_UNAUTHORIZED_ACCESS_ERROR

工作日报告网址为空

Workday 报表 URL 为空。必须至少提供一个报表。

工作区配额已超限