错误条件
这是 Spark SQL 返回的常见命名错误条件列表。
另请参阅 SQLSTATE 代码。
AGGREGATE_FUNCTION_WITH_NONDETERMINISTIC_EXPRESSION
SQLSTATE：未分配
非确定性表达式 <sqlExpr> 不应出现在聚合函数的参数中。
ALL_PARTITION_COLUMNS_NOT_ALLOWED
SQLSTATE：未分配
不能对所有列使用分区列。
ALTER_TABLE_COLUMN_DESCRIPTOR_DUPLICATE
ALTER TABLE <type> 列 <columnName> 指定描述符 “<optionName>” 多次，这是无效的。
AMBIGUOUS_ALIAS_IN_NESTED_CTE
SQLSTATE：未分配
名称 <name> 在嵌套 CTE 中不明确。请将 <config> 设置为 “CORRECTED”，以便内部 CTE 中定义的名称优先。如果将其设置为 “LEGACY”，则外部 CTE 定义将优先。请参阅 ‘<docroot>/sql-migration-guide.html#query-engine’。
AMBIGUOUS_COLUMN_OR_FIELD
列或字段 <name> 不明确，有 <n> 个匹配项。
AMBIGUOUS_COLUMN_REFERENCE
列 <name> 不明确。这是因为您将多个 DataFrame 联合在一起，并且其中一些 DataFrame 是相同的。此列指向其中一个 DataFrame，但 Spark 无法确定是哪一个。请在联合 DataFrame 之前使用不同的名称通过 DataFrame.alias 为 DataFrame 设置别名，并使用限定名称指定列，例如 df.alias("a").join(df.alias("b"), col("a.id") > col("b.id"))。
AMBIGUOUS_LATERAL_COLUMN_ALIAS
横向列别名 <name> 不明确，有 <n> 个匹配项。
AMBIGUOUS_REFERENCE
引用 <name> 不明确，可能是：<referenceNames>。
AMBIGUOUS_REFERENCE_TO_FIELDS
对字段 <field> 的不明确引用。它在模式中出现 <count> 次。
ARITHMETIC_OVERFLOW
<message>.<alternative> 如果需要，请将 <config> 设置为 “false” 以绕过此错误。
AS_OF_JOIN
SQLSTATE：未分配
无效的 as-of 联接。
有关更多详细信息，请参阅 AS_OF_JOIN
AVRO_INCOMPATIBLE_READ_TYPE
SQLSTATE：未分配
无法将 Avro <avroPath> 转换为 SQL <sqlPath>，因为原始编码数据类型为 <avroType>，但是您尝试将字段读取为 <sqlType>，这会导致错误的答案。要允许读取此字段，请启用 SQL 配置：“spark.sql.legacy.avro.allowIncompatibleSchema”。
BATCH_METADATA_NOT_FOUND
无法找到批次 <batchMetadataFile>。
BINARY_ARITHMETIC_OVERFLOW
<value1> <symbol> <value2> 导致溢出。
CALL_ON_STREAMING_DATASET_UNSUPPORTED
SQLSTATE：未分配
方法 <methodName> 无法在流式 Dataset/DataFrame 上调用。
CANNOT_CAST_DATATYPE
无法将 <sourceType> 转换为 <targetType>。
CANNOT_CONVERT_PROTOBUF_FIELD_TYPE_TO_SQL_TYPE
SQLSTATE：未分配
无法将 Protobuf <protobufColumn> 转换为 SQL <sqlColumn>，因为模式不兼容（protobufType = <protobufType>，sqlType = <sqlType>）。
CANNOT_CONVERT_PROTOBUF_MESSAGE_TYPE_TO_SQL_TYPE
SQLSTATE：未分配
无法将 Protobuf 的 <protobufType> 转换为 SQL 类型 <toType>。
CANNOT_CONVERT_SQL_TYPE_TO_PROTOBUF_FIELD_TYPE
SQLSTATE：未分配
无法将 SQL <sqlColumn> 转换为 Protobuf <protobufColumn>，因为模式不兼容（protobufType = <protobufType>，sqlType = <sqlType>）。
CANNOT_CONVERT_SQL_VALUE_TO_PROTOBUF_ENUM_TYPE
SQLSTATE：未分配
无法将 SQL <sqlColumn> 转换为 Protobuf <protobufColumn>，因为 <data> 不在枚举的定义值中：<enumString>。
CANNOT_DECODE_URL
提供的 URL 无法解码：<url>。请确保 URL 格式正确，然后重试。
CANNOT_INVOKE_IN_TRANSFORMATIONS
SQLSTATE：未分配
Dataset 转换和操作只能由驱动程序调用，不能在其他 Dataset 转换中调用；例如，dataset1.map(x => dataset2.values.count() * x) 无效，因为 values 转换和 count 操作不能在 dataset1.map 转换中执行。有关更多信息，请参阅 SPARK-28702。
CANNOT_LOAD_FUNCTION_CLASS
SQLSTATE：未分配
在注册函数 <functionName> 时无法加载类 <className>，请确保它在类路径中。
CANNOT_LOAD_PROTOBUF_CLASS
SQLSTATE：未分配
无法加载名称为 <protobufClassName> 的 Protobuf 类。 <explanation>。
CANNOT_MERGE_INCOMPATIBLE_DATA_TYPE
无法合并不兼容的数据类型 <left> 和 <right>。请检查正在合并的列的数据类型，并确保它们兼容。如果需要，请考虑在尝试合并之前将列转换为兼容的数据类型。
CANNOT_MERGE_SCHEMAS
无法合并模式：初始模式：<left> 无法与初始模式合并的模式：<right>。
CANNOT_MODIFY_CONFIG
无法修改 Spark 配置的值：<key>。另请参阅 ‘<docroot>/sql-migration-guide.html#ddl-statements’。
CANNOT_PARSE_DECIMAL
无法解析十进制数。请确保输入是有效的数字，并带有可选的小数点或逗号分隔符。
CANNOT_PARSE_INTERVAL
SQLSTATE：未分配
无法解析 <intervalString>。请确保提供的值为定义间隔的有效格式。您可以参考文档以获取正确的格式。如果问题仍然存在，请仔细检查输入值是否为空或为空，然后重试。
CANNOT_PARSE_JSON_FIELD
无法将 JSON 令牌类型 <jsonType> 的字段名称 <fieldName> 和值 <fieldValue> 解析为目标 Spark 数据类型 <dataType>。
CANNOT_PARSE_PROTOBUF_DESCRIPTOR
SQLSTATE：未分配
将描述符字节解析为 Protobuf FileDescriptorSet 时出错。
CANNOT_PARSE_TIMESTAMP
<message>。如果需要，请将 <ansiConfig> 设置为 “false” 以绕过此错误。
CANNOT_READ_FILE_FOOTER
SQLSTATE：未分配
无法读取文件的文件页脚：<file>。请确保文件为 ORC 或 Parquet 格式。如果不是，请将其转换为有效的格式。如果文件为有效格式，请检查它是否已损坏。如果是，您可以选择忽略它或修复损坏。
CANNOT_RECOGNIZE_HIVE_TYPE
无法识别 Hive 类型字符串：<fieldType>，列：<fieldName>。指定字段的数据类型无法被 Spark SQL 识别。请检查指定字段的数据类型，并确保它是一个有效的 Spark SQL 数据类型。请参考 Spark SQL 文档以获取有效数据类型及其格式的列表。如果数据类型正确，请确保您使用的是受支持的 Spark SQL 版本。
CANNOT_RENAME_ACROSS_SCHEMA
不允许跨架构重命名 <type>。
CANNOT_RESOLVE_STAR_EXPAND
SQLSTATE：未分配
无法解析 <targetString>.*，给定输入列 <columns>。请检查指定的表或结构是否存在，并且是否可以在输入列中访问。
CANNOT_RESTORE_PERMISSIONS_FOR_PATH
SQLSTATE：未分配
无法将创建的路径 <path> 的权限设置回 <permission>。
CANNOT_UPDATE_FIELD
SQLSTATE：未分配
无法更新 <table> 字段 <fieldName> 类型
有关更多详细信息，请参见 CANNOT_UPDATE_FIELD
CANNOT_UP_CAST_DATATYPE
SQLSTATE：未分配
无法将 <expression> 从 <sourceType> 上升转换为 <targetType>。 <details>
CAST_INVALID_INPUT
类型为 <sourceType> 的值 <expression> 无法转换为 <targetType>，因为它格式错误。请根据语法更正值，或更改其目标类型。使用 try_cast 来容忍格式错误的输入并返回 NULL。如果需要，请将 <ansiConfig> 设置为“false”以绕过此错误。
CAST_OVERFLOW
类型为 <sourceType> 的值 <value> 无法转换为 <targetType>，因为发生了溢出。使用 try_cast 来容忍溢出并返回 NULL。如果需要，请将 <ansiConfig> 设置为“false”以绕过此错误。
CAST_OVERFLOW_IN_TABLE_INSERT
由于溢出，无法将 <sourceType> 类型的值插入到 <targetType> 类型列 <columnName> 中。对输入值使用 try_cast 来容忍溢出并返回 NULL。
CODEC_NOT_AVAILABLE
SQLSTATE：未分配
编解码器 <codecName> 不可用。请考虑将配置 <configKey> 设置为 <configVal>。
CODEC_SHORT_NAME_NOT_FOUND
SQLSTATE：未分配
无法找到编解码器 <codecName> 的简短名称。
COLUMN_ALIASES_IS_NOT_ALLOWED
SQLSTATE：未分配
在 <op> 中不允许使用列别名。
COLUMN_ALREADY_EXISTS
列 <columnName> 已经存在。请考虑选择另一个名称或重命名现有列。
COLUMN_NOT_DEFINED_IN_TABLE
SQLSTATE：未分配
<colType> 列 <colName> 在表 <tableName> 中未定义，定义的表列为：<tableCols>。
COLUMN_NOT_FOUND
找不到列 <colName>。请根据 SQL 配置 <caseSensitiveConfig> 验证列名的拼写和正确性。
COMPARATOR_RETURNS_NULL
SQLSTATE：未分配
比较器在比较 <firstValue> 和 <secondValue> 时返回了 NULL。它应该为“大于”返回正整数，为“等于”返回 0，为“小于”返回负整数。要恢复到将 NULL 视为 0（等于）的已弃用行为，您必须将“spark.sql.legacy.allowNullComparisonResultInArraySort”设置为“true”。
CONCURRENT_QUERY
SQLSTATE：未分配
此查询的另一个实例刚刚由并发会话启动。
CONCURRENT_STREAM_LOG_UPDATE
SQLSTATE: 40000
对日志进行并发更新。为 <batchId> 检测到多个流式作业。请确保一次只有一个流式作业在特定检查点位置运行。
CONNECT
SQLSTATE：未分配
通用 Spark Connect 错误。
有关更多详细信息，请参见 CONNECT
CONVERSION_INVALID_INPUT
值 <str> (<fmt>) 无法转换为 <targetType>，因为它格式错误。请根据语法更正值，或更改其格式。使用 <suggestion> 来容忍格式错误的输入并返回 NULL。
CREATE_PERMANENT_VIEW_WITHOUT_ALIAS
SQLSTATE：未分配
不允许在没有为表达式 <attr> 明确分配别名的情况下创建永久视图 <name>。
CREATE_TABLE_COLUMN_DESCRIPTOR_DUPLICATE
CREATE TABLE 列 <columnName> 指定描述符“<optionName>”多次，这是无效的。
CREATE_VIEW_COLUMN_ARITY_MISMATCH
无法创建视图 <viewName>，原因是
有关更多详细信息，请参见 CREATE_VIEW_COLUMN_ARITY_MISMATCH
DATATYPE_MISMATCH
由于数据类型不匹配，无法解析 <sqlExpr>
有关更多详细信息，请参见 DATATYPE_MISMATCH
DATATYPE_MISSING_SIZE
数据类型 <type> 需要长度参数，例如 <type>(10)。请指定长度。
DATA_SOURCE_NOT_FOUND
找不到数据源：<provider>。请在 https://spark.apache.org/third-party-projects.html 处查找包。
DATETIME_OVERFLOW
日期时间操作溢出：<operation>。
DECIMAL_PRECISION_EXCEEDS_MAX_PRECISION
十进制精度 <precision> 超过最大精度 <maxPrecision>。
DEFAULT_DATABASE_NOT_EXISTS
默认数据库 <defaultDatabase> 不存在，请先创建它或将默认数据库更改为 <defaultDatabase>。
DISTINCT_WINDOW_FUNCTION_UNSUPPORTED
SQLSTATE：未分配
不支持不同的窗口函数：<windowExpr>。
DIVIDE_BY_ZERO
除以零。使用 try_divide 来容忍除数为 0 并返回 NULL。如果需要，请将 <config> 设置为“false”以绕过此错误。
DUPLICATED_FIELD_NAME_IN_ARROW_STRUCT
SQLSTATE：未分配
不允许在 Arrow 结构中使用重复的字段名，得到 <fieldNames>。
DUPLICATED_MAP_KEY
找到重复的映射键 <key>，请检查输入数据。如果您想删除重复的键，可以将 <mapKeyDedupPolicy> 设置为“LAST_WIN”，以便最后插入的键优先。
DUPLICATED_METRICS_NAME
SQLSTATE：未分配
度量名称不唯一：<metricName>。相同名称不能用于具有不同结果的度量。但是，允许度量具有相同结果和名称的多个实例（例如，自连接）。
DUPLICATE_CLAUSES
SQLSTATE：未分配
找到重复的子句：<clauseName>。请删除其中一个。
DUPLICATE_KEY
找到重复的键 <keyColumn>。
DUPLICATE_ROUTINE_PARAMETER_ASSIGNMENT
对函数 <functionName> 的调用无效，因为它包含对相同参数名称 <parameterName> 的多个参数分配。
有关更多详细信息，请参见 DUPLICATE_ROUTINE_PARAMETER_ASSIGNMENT
EMPTY_JSON_FIELD_VALUE
无法为数据类型 <dataType> 解析空字符串。
ENCODER_NOT_FOUND
SQLSTATE：未分配
找不到类型为 <typeName> 的编码器到 Spark SQL 内部表示。请考虑将输入类型更改为在“<docroot>/sql-ref-datatypes.html”中支持的类型之一。
EVENT_TIME_IS_NOT_ON_TIMESTAMP_TYPE
SQLSTATE：未分配
事件时间 <eventName> 的类型无效 <eventType>，但预期为“TIMESTAMP”。
EXCEED_LIMIT_LENGTH
SQLSTATE：未分配
超过 char/varchar 类型长度限制：<limit>。
EXPRESSION_TYPE_IS_NOT_ORDERABLE
SQLSTATE：未分配
列表达式 <expr> 无法排序，因为其类型 <exprType> 不可排序。
FAILED_EXECUTE_UDF
无法执行用户定义函数 (<functionName>: (<signature>) => <result>)。
FAILED_FUNCTION_CALL
无法为调用准备函数 <funcName>。请仔细检查函数的参数。
FAILED_PARSE_STRUCT_TYPE
解析结构失败：<raw>。
FAILED_RENAME_PATH
无法将 <sourcePath> 重命名为 <targetPath>，因为目标已存在。
FAILED_RENAME_TEMP_FILE
SQLSTATE：未分配
无法将临时文件 <srcPath> 重命名为 <dstPath>，因为 FileSystem.rename 返回 false。
FIELDS_ALREADY_EXISTS
SQLSTATE：未分配
无法 <op> 列，因为 <fieldNames> 已经在 <struct> 中存在。
FIELD_NOT_FOUND
在 <fields> 中没有这样的结构字段 <fieldName>。
FORBIDDEN_OPERATION
不允许对 <objectType> 执行操作 <statement>：<objectName>。
GENERATED_COLUMN_WITH_DEFAULT_VALUE
SQLSTATE：未分配
列不能同时具有默认值和生成表达式，但列 <colName> 具有默认值：(<defaultValue>) 和生成表达式：(<genExpr>)。
GRAPHITE_SINK_INVALID_PROTOCOL
SQLSTATE：未分配
无效的 Graphite 协议：<protocol>。
GRAPHITE_SINK_PROPERTY_MISSING
SQLSTATE：未分配
Graphite 接收器需要“<property>”属性。
GROUPING_COLUMN_MISMATCH
分组 (<grouping>) 的列在分组列 <groupingColumns> 中找不到。
GROUPING_ID_COLUMN_MISMATCH
grouping_id (<groupingIdColumn>) 的列与分组列 (<groupByColumns>) 不匹配。
GROUPING_SIZE_LIMIT_EXCEEDED
分组集大小不能大于 <maxSize>。
GROUP_BY_AGGREGATE
聚合函数不允许在 GROUP BY 中使用，但发现了 <sqlExpr>。
GROUP_BY_POS_AGGREGATE
GROUP BY <index> 指的是包含聚合函数的表达式 <aggExpr>。聚合函数不允许在 GROUP BY 中使用。
GROUP_BY_POS_OUT_OF_RANGE
GROUP BY 位置 <index> 不在 select 列表中（有效范围是 [1, <size>]）。
GROUP_EXPRESSION_TYPE_IS_NOT_ORDERABLE
SQLSTATE：未分配
表达式 <sqlExpr> 不能用作分组表达式，因为它的数据类型 <dataType> 不是可排序的数据类型。
HLL_INVALID_INPUT_SKETCH_BUFFER
SQLSTATE：未分配
对 <function> 的调用无效；仅支持有效的 HLL 草图缓冲区作为输入（例如，由 hll_sketch_agg 函数生成的那些）。
HLL_INVALID_LG_K
SQLSTATE：未分配
对 <function> 的调用无效；lgConfigK 值必须介于 <min> 和 <max> 之间（含）：<value>。
HLL_UNION_DIFFERENT_LG_K
SQLSTATE：未分配
草图具有不同的 lgConfigK 值：<left> 和 <right>。将 allowDifferentLgConfigK 参数设置为 true 以使用不同的 lgConfigK 值调用 <function>。
IDENTIFIER_TOO_MANY_NAME_PARTS
<identifier> 不是有效的标识符，因为它包含超过 2 个名称部分。
INCOMPARABLE_PIVOT_COLUMN
无效的枢轴列 <columnName>。枢轴列必须可比较。
INCOMPATIBLE_COLUMN_TYPE
<operator> 只能对具有兼容列类型的表执行。<tableOrdinalNumber> 表的 <columnOrdinalNumber> 列是 <dataType1> 类型，与第一个表的同一列的 <dataType2> 类型不兼容。<hint>。
INCOMPATIBLE_DATASOURCE_REGISTER
SQLSTATE：未分配
检测到不兼容的 DataSourceRegister。请从类路径中删除不兼容的库或升级它。错误：<message>
INCOMPATIBLE_DATA_FOR_TABLE
SQLSTATE: KD000
无法为表 <tableName> 写入不兼容的数据
有关更多详细信息，请参阅 INCOMPATIBLE_DATA_FOR_TABLE
INCOMPATIBLE_JOIN_TYPES
连接类型 <joinType1> 和 <joinType2> 不兼容。
INCOMPATIBLE_VIEW_SCHEMA_CHANGE
SQLSTATE：未分配
视图 <viewName> 的 SQL 查询存在不兼容的模式更改，无法解析列 <colName>。预期 <expectedNum> 个名为 <colName> 的列，但得到 <actualCols> 个。请尝试通过运行以下命令重新创建视图：<suggestion>。
INCOMPLETE_TYPE_DEFINITION
不完整的复杂类型
有关更多详细信息，请参阅 INCOMPLETE_TYPE_DEFINITION
INCONSISTENT_BEHAVIOR_CROSS_VERSION
您可能会因升级到而获得不同的结果
有关更多详细信息，请参阅 INCONSISTENT_BEHAVIOR_CROSS_VERSION
INCORRECT_END_OFFSET
使用 <rowsPerSecond> rowsPerSecond 的最大偏移量为 <maxSeconds>，但现在为 <endSeconds>。
INCORRECT_RAMP_UP_RATE
使用 <rowsPerSecond> rowsPerSecond 的最大偏移量为 <maxSeconds>，但“rampUpTimeSeconds”为 <rampUpTimeSeconds>。
INDEX_ALREADY_EXISTS
无法在表 <tableName> 上创建索引 <indexName>，因为它已经存在。
INDEX_NOT_FOUND
无法在表 <tableName> 上找到索引 <indexName>。
INSERT_COLUMN_ARITY_MISMATCH
无法写入 <tableName>，原因是
有关更多详细信息，请参阅 INSERT_COLUMN_ARITY_MISMATCH
INSERT_PARTITION_COLUMN_ARITY_MISMATCH
无法写入“<tableName>”，<reason>：表列：<tableColumns>。具有静态值的分区列：<staticPartCols>。数据列：<dataColumns>。
INSUFFICIENT_TABLE_PROPERTY
SQLSTATE：未分配
找不到表属性
有关更多详细信息，请参阅 INSUFFICIENT_TABLE_PROPERTY
INTERNAL_ERROR
<message>
INTERNAL_ERROR_BROADCAST
<message>
INTERNAL_ERROR_EXECUTOR
<message>
INTERNAL_ERROR_MEMORY
<message>
INTERNAL_ERROR_NETWORK
<message>
INTERNAL_ERROR_SHUFFLE
<message>
INTERNAL_ERROR_STORAGE
<message>
INTERVAL_ARITHMETIC_OVERFLOW
<message>。<alternative>
INTERVAL_DIVIDED_BY_ZERO
除以零。使用 try_divide 来容忍除数为 0 并返回 NULL。
INVALID_ARRAY_INDEX
索引 <indexValue> 超出范围。数组有 <arraySize> 个元素。使用 SQL 函数 get() 来容忍访问无效索引处的元素并返回 NULL。如果需要，将 <ansiConfig> 设置为“false”以绕过此错误。
INVALID_ARRAY_INDEX_IN_ELEMENT_AT
索引 <indexValue> 超出范围。数组有 <arraySize> 个元素。使用 try_element_at 来容忍访问无效索引处的元素并返回 NULL。如果需要，将 <ansiConfig> 设置为“false”以绕过此错误。
INVALID_BITMAP_POSITION
0 索引位图位置 <bitPosition> 超出范围。位图有 <bitmapNumBits> 位（<bitmapNumBytes> 字节）。
INVALID_BOUNDARY
SQLSTATE：未分配
边界 <boundary> 无效：<invalidValue>。
有关更多详细信息，请参阅 INVALID_BOUNDARY
INVALID_BUCKET_FILE
SQLSTATE：未分配
无效的桶文件：<path>。
INVALID_BYTE_STRING
SQLSTATE：未分配
预期格式为 ByteString，但为 <unsupported>（<class>）。
INVALID_COLUMN_NAME_AS_PATH
数据源 <datasource> 无法保存列 <columnName>，因为它的名称包含一些不允许在文件路径中使用的字符。请使用别名重命名它。
INVALID_COLUMN_OR_FIELD_DATA_TYPE
列或字段 <name> 的类型为 <type>，而它需要为 <expectedType>。
INVALID_CURSOR
游标无效。
有关更多详细信息，请参阅 INVALID_CURSOR
INVALID_DEFAULT_VALUE
SQLSTATE：未分配
无法执行 <statement> 命令，因为目标表列 <colName> 具有 DEFAULT 值 <defaultValue>，
有关更多详细信息，请参阅 INVALID_DEFAULT_VALUE
INVALID_DRIVER_MEMORY
SQLSTATE: F0000
系统内存 <systemMemory> 必须至少为 <minSystemMemory>。请使用 –driver-memory 选项或 Spark 配置中的“<config>”增加堆大小。
INVALID_EMPTY_LOCATION
位置名称不能是空字符串，但给出了 <location>。
INVALID_ESC
SQLSTATE：未分配
发现无效的转义字符串：<invalidEscape>。转义字符串必须只包含一个字符。
INVALID_ESCAPE_CHAR
SQLSTATE：未分配
EscapeChar 应该是一个长度为一的字符串文字，但得到 <sqlExpr>。
INVALID_EXECUTOR_MEMORY
SQLSTATE: F0000
执行器内存 <executorMemory> 必须至少为 <minSystemMemory>。请使用 –executor-memory 选项或 Spark 配置中的“<config>”增加执行器内存。
INVALID_EXTRACT_BASE_FIELD_TYPE
无法从 <base> 中提取值。需要一个复杂类型 [STRUCT，ARRAY，MAP]，但得到 <other>。
INVALID_EXTRACT_FIELD
无法从 <expr> 中提取 <field>。
INVALID_EXTRACT_FIELD_TYPE
字段名称应为非空字符串文字，但它是 <extraction>。
INVALID_FIELD_NAME
字段名称 <fieldName> 无效：<path> 不是结构体。
INVALID_FORMAT
格式无效：<format>。
有关更多详细信息，请参阅 INVALID_FORMAT
INVALID_FRACTION_OF_SECOND
秒的小数部分必须为零。有效范围是 [0, 60]。如果需要，将 <ansiConfig> 设置为“false”以绕过此错误。
INVALID_HANDLE
句柄 <handle> 无效。
有关更多详细信息，请参阅 INVALID_HANDLE
INVALID_HIVE_COLUMN_NAME
SQLSTATE：未分配
无法创建包含嵌套列 <columnName> 的表 <tableName>，该列的名称包含 Hive 元存储中无效的字符 <invalidChars>。
INVALID_IDENTIFIER
标识符 <ident> 无效。请考虑使用反引号将其引用为 <ident>。
INVALID_INDEX_OF_ZERO
索引 0 无效。索引应为 < 0 或 > 0（第一个元素的索引为 1）。
INVALID_INLINE_TABLE
SQLSTATE：未分配
无效的内联表。
有关更多详细信息，请参阅 INVALID_INLINE_TABLE
INVALID_JSON_ROOT_FIELD
无法将 JSON 根字段转换为目标 Spark 类型。
INVALID_JSON_SCHEMA_MAP_TYPE
输入模式 <jsonSchema> 只能包含 STRING 作为 MAP 的键类型。
INVALID_LAMBDA_FUNCTION_CALL
SQLSTATE：未分配
无效的 lambda 函数调用。
有关更多详细信息，请参阅 INVALID_LAMBDA_FUNCTION_CALL
INVALID_LATERAL_JOIN_TYPE
由于外部子查询无法与其连接伙伴相关联，因此不允许使用 <joinType> JOIN 与 LATERAL 相关联。请移除 LATERAL 相关联，或使用 INNER JOIN 或 LEFT OUTER JOIN 代替。
INVALID_LIMIT_LIKE_EXPRESSION
SQLSTATE：未分配
类似限制的表达式 <expr> 无效。
有关更多详细信息，请参阅 INVALID_LIMIT_LIKE_EXPRESSION
INVALID_NON_DETERMINISTIC_EXPRESSIONS
SQLSTATE：未分配
运算符需要一个确定性表达式，但实际表达式为 <sqlExprs>。
INVALID_NUMERIC_LITERAL_RANGE
SQLSTATE：未分配
数值字面量 <rawStrippedQualifier> 超出了 <typeName> 的有效范围，最小值为 <minValue>，最大值为 <maxValue>。请相应地调整值。
INVALID_OBSERVED_METRICS
SQLSTATE：未分配
无效的观察指标。
有关更多详细信息，请参阅 INVALID_OBSERVED_METRICS
INVALID_OPTIONS
无效选项
有关更多详细信息，请参阅 INVALID_OPTIONS
INVALID_PANDAS_UDF_PLACEMENT
组聚合 pandas UDF <functionList> 不能与其他非 pandas 聚合函数一起调用。
INVALID_PARAMETER_VALUE
参数 <parameter> 在 <functionName> 中的值无效
有关更多详细信息，请参阅 INVALID_PARAMETER_VALUE
INVALID_PARTITION_OPERATION
SQLSTATE：未分配
分区命令无效。
有关更多详细信息，请参阅 INVALID_PARTITION_OPERATION
INVALID_PROPERTY_KEY
<key> 是一个无效的属性键，请使用引号，例如 SET <key>=<value>。
INVALID_PROPERTY_VALUE
<value> 是一个无效的属性值，请使用引号，例如 SET <key>=<value>
INVALID_SCHEMA
输入模式 <inputSchema> 不是有效的模式字符串。
有关更多详细信息，请参阅 INVALID_SCHEMA
INVALID_SET_SYNTAX
预期格式为“SET”、“SET key”或“SET key=value”。如果您想在键中包含特殊字符，或在值中包含分号，请使用反引号，例如 SET key=value。
INVALID_SQL_ARG
SQLSTATE：未分配
sql() 的参数 <name> 无效。考虑用 SQL 字面量替换它。
INVALID_SQL_SYNTAX
无效的 SQL 语法
有关更多详细信息，请参阅 INVALID_SQL_SYNTAX
INVALID_SUBQUERY_EXPRESSION
无效的子查询
有关更多详细信息，请参阅 INVALID_SUBQUERY_EXPRESSION
INVALID_TEMP_OBJ_REFERENCE
SQLSTATE：未分配
无法创建类型为 <obj> 的持久对象 <objName>，因为它引用了类型为 <tempObj> 的临时对象 <tempObjName>。请使临时对象 <tempObjName> 持久化，或使持久对象 <objName> 临时化。
INVALID_TIME_TRAVEL_TIMESTAMP_EXPR
SQLSTATE：未分配
时间旅行时间戳表达式 <expr> 无效。
有关更多详细信息，请参阅 INVALID_TIME_TRAVEL_TIMESTAMP_EXPR
INVALID_TYPED_LITERAL
类型化字面量 <valueType> 的值无效：<value>。
INVALID_UDF_IMPLEMENTATION
SQLSTATE：未分配
函数 <funcName> 未实现 ScalarFunction 或 AggregateFunction。
INVALID_URL
SQLSTATE：未分配
URL 无效：<url>。如果需要，请将 <ansiConfig> 设置为“false”以绕过此错误。
INVALID_USAGE_OF_STAR_OR_REGEX
在 <prettyName> 中使用 <elem> 无效。
INVALID_VIEW_TEXT
SQLSTATE：未分配
由于视图文本无效，因此无法显示视图 <viewName>：<viewText>。这可能是由于对视图进行了未经授权的修改或查询语法不正确造成的。请检查您的查询语法并验证视图是否未被篡改。
INVALID_WHERE_CONDITION
WHERE 条件 <condition> 包含无效表达式：<expressionList>。重写查询以避免在 WHERE 子句中使用窗口函数、聚合函数和生成器函数。
INVALID_WINDOW_SPEC_FOR_AGGREGATION_FUNC
SQLSTATE：未分配
无法为 <aggFunc> 指定 ORDER BY 或窗口框架。
INVALID_WRITE_DISTRIBUTION
SQLSTATE：未分配
请求的写入分布无效。
有关更多详细信息，请参阅 INVALID_WRITE_DISTRIBUTION
JOIN_CONDITION_IS_NOT_BOOLEAN_TYPE
SQLSTATE：未分配
连接条件 <joinCondition> 的类型无效 <conditionType>，预期为“BOOLEAN”。
LOAD_DATA_PATH_NOT_EXISTS
SQLSTATE：未分配
LOAD DATA 输入路径不存在：<path>。
LOCAL_MUST_WITH_SCHEMA_FILE
SQLSTATE：未分配
LOCAL 必须与 file 的模式一起使用，但得到：<actualSchema>。
LOCATION_ALREADY_EXISTS
无法将托管表命名为 <identifier>，因为其关联位置 <location> 已经存在。请选择不同的表名，或先删除现有位置。
MALFORMED_CSV_RECORD
SQLSTATE：未分配
格式错误的 CSV 记录：<badRecord>
MALFORMED_PROTOBUF_MESSAGE
SQLSTATE：未分配
在消息反序列化中检测到格式错误的 Protobuf 消息。解析模式：<failFastMode>。要将格式错误的 protobuf 消息处理为 null 结果，请尝试将选项“mode”设置为“PERMISSIVE”。
MALFORMED_RECORD_IN_PARSING
在记录解析中检测到格式错误的记录：<badRecord>。解析模式：<failFastMode>。要将格式错误的记录处理为 null 结果，请尝试将选项“mode”设置为“PERMISSIVE”。
有关更多详细信息，请参阅 MALFORMED_RECORD_IN_PARSING
MERGE_CARDINALITY_VIOLATION
MERGE 语句的 ON 搜索条件与目标表中的单行匹配，而源表中的多行匹配。这会导致目标行被更新或删除操作多次操作，这是不允许的。
MISSING_AGGREGATION
非聚合表达式 <expression> 基于未参与 GROUP BY 子句的列。将列或表达式添加到 GROUP BY，聚合表达式，或者如果不在乎组内返回哪个值，则使用 <expressionAnyValue>。
MISSING_ATTRIBUTES
SQLSTATE：未分配
在运算符 <operator> 中，<input> 中缺少解析的属性 <missingAttributes>。
有关更多详细信息，请参阅 MISSING_ATTRIBUTES
MISSING_GROUP_BY
查询不包含 GROUP BY 子句。添加 GROUP BY 或使用 OVER 子句将其转换为窗口函数。
MULTI_SOURCES_UNSUPPORTED_FOR_EXPRESSION
SQLSTATE：未分配
表达式 <expr> 不支持多个源。
MULTI_UDF_INTERFACE_ERROR
SQLSTATE：未分配
不允许实现多个 UDF 接口，UDF 类 <className>。
NAMED_PARAMETERS_NOT_SUPPORTED
函数 <functionName> 不支持命名参数；请使用函数调用的位置参数重新尝试查询。
NAMED_PARAMETER_SUPPORT_DISABLED
SQLSTATE：未分配
无法调用函数 <functionName>，因为此处未启用命名参数引用。在这种情况下，命名参数引用为 <argument>。将“spark.sql.allowNamedFunctionArguments”设置为“true”以启用该功能。
NESTED_AGGREGATE_FUNCTION
不允许在另一个聚合函数的参数中使用聚合函数。请在子查询中使用内部聚合函数。
NON_LAST_MATCHED_CLAUSE_OMIT_CONDITION
当 MERGE 语句中有多个 MATCHED 子句时，只有最后一个 MATCHED 子句可以省略条件。
NON_LAST_NOT_MATCHED_BY_SOURCE_CLAUSE_OMIT_CONDITION
当 MERGE 语句中有多个 NOT MATCHED BY SOURCE 子句时，只有最后一个 NOT MATCHED BY SOURCE 子句可以省略条件。
NON_LAST_NOT_MATCHED_BY_TARGET_CLAUSE_OMIT_CONDITION
当 MERGE 语句中有多个 NOT MATCHED [BY TARGET] 子句时，只有最后一个 NOT MATCHED [BY TARGET] 子句可以省略条件。
NON_LITERAL_PIVOT_VALUES
枢轴值需要字面量表达式，找到 <expression>。
NON_PARTITION_COLUMN
PARTITION 子句不能包含非分区列：<columnName>。
NON_TIME_WINDOW_NOT_SUPPORTED_IN_STREAMING
SQLSTATE：未分配
窗口函数在流式 DataFrame/Dataset 中的 <windowFunc>（作为列 <columnName>）中不受支持。结构化流式处理仅支持使用 WINDOW 函数进行时间窗口聚合。（窗口规范：<windowSpec>）
NOT_ALLOWED_IN_FROM
SQLSTATE：未分配
在 FROM 子句中不允许
有关更多详细信息，请参阅 NOT_ALLOWED_IN_FROM
NOT_A_CONSTANT_STRING
用于例程或子句 <name> 的表达式 <expr> 必须是常量 STRING，且不能为 NULL。
有关更多详细信息，请参阅 NOT_A_CONSTANT_STRING
NOT_A_PARTITIONED_TABLE
SQLSTATE：未分配
操作 <operation> 不允许用于 <tableIdentWithDB>，因为它不是分区表。
NOT_NULL_CONSTRAINT_VIOLATION
此处不允许分配 NULL。
有关更多详细信息，请参阅 NOT_NULL_CONSTRAINT_VIOLATION
NOT_SUPPORTED_CHANGE_COLUMN
SQLSTATE：未分配
ALTER TABLE ALTER/CHANGE COLUMN 不支持将 <table> 的列 <originName> 从类型 <originType> 更改为 <newName>，类型为 <newType>。
NOT_SUPPORTED_COMMAND_FOR_V2_TABLE
<cmd> 不支持 v2 表。
NOT_SUPPORTED_COMMAND_WITHOUT_HIVE_SUPPORT
SQLSTATE：未分配
<cmd> 不受支持，如果您想启用它，请将“spark.sql.catalogImplementation”设置为“hive”。
NOT_SUPPORTED_IN_JDBC_CATALOG
JDBC 目录中不支持的命令
有关更多详细信息，请参阅 NOT_SUPPORTED_IN_JDBC_CATALOG
NO_DEFAULT_COLUMN_VALUE_AVAILABLE
无法确定 <colName> 的默认值，因为它不可为空且没有默认值。
NO_HANDLER_FOR_UDAF
SQLSTATE：未分配
没有针对 UDAF ‘<functionName>’ 的处理程序。请使用 sparkSession.udf.register(…) 代替。
NO_SQL_TYPE_IN_PROTOBUF_SCHEMA
SQLSTATE：未分配
在 Protobuf 模式中找不到 <catalystFieldPath>。
NO_UDF_INTERFACE
SQLSTATE：未分配
UDF 类 <className> 未实现任何 UDF 接口。
NULLABLE_COLUMN_OR_FIELD
列或字段 <name> 可为空，但要求不可为空。
NULLABLE_ROW_ID_ATTRIBUTES
行 ID 属性不可为空：<nullableRowIdAttrs>。
NULL_MAP_KEY
不能使用 null 作为映射键。
NUMERIC_OUT_OF_SUPPORTED_RANGE
值 <value> 无法解释为数字，因为它包含超过 38 位数字。
NUMERIC_VALUE_OUT_OF_RANGE
<value> 无法表示为 Decimal(<precision>, <scale>)。如果需要，请将 <config> 设置为“false”以绕过此错误，并返回 NULL。
NUM_COLUMNS_MISMATCH
<operator> 只能对具有相同列数的输入执行，但第一个输入有 <firstNumColumns> 列，而 <invalidOrdinalNum> 输入有 <invalidNumColumns> 列。
NUM_TABLE_VALUE_ALIASES_MISMATCH
SQLSTATE：未分配
给定的别名数量与输出列数量不匹配。函数名称：<funcName>；别名数量：<aliasesNum>；输出列数量：<outColsNum>。
OPERATION_CANCELED
操作已取消。
ORDER_BY_POS_OUT_OF_RANGE
ORDER BY 位置 <index> 不在 select 列表中（有效范围为 [1, <size>]）。
PARSE_EMPTY_STATEMENT
语法错误，意外的空语句。
PARSE_SYNTAX_ERROR
语法错误，在或附近 <error><hint>。
PARTITIONS_ALREADY_EXIST
无法在表 <tableName> 中添加或重命名分区 <partitionList>，因为它们已存在。选择不同的名称，删除现有分区，或添加 IF NOT EXISTS 子句以容忍预先存在的分区。
PARTITIONS_NOT_FOUND
在表 <tableName> 中找不到分区 <partitionList>。验证分区规范和表名。要容忍删除时的错误，请使用 ALTER TABLE … DROP IF EXISTS PARTITION。
PATH_ALREADY_EXISTS
路径 <outputPath> 已存在。将模式设置为“overwrite”以覆盖现有路径。
PATH_NOT_FOUND
路径不存在：<path>。
PIVOT_VALUE_DATA_TYPE_MISMATCH
无效的透视值 ‘<value>’：值数据类型 <valueType> 与透视列数据类型 <pivotType> 不匹配。
PLAN_VALIDATION_FAILED_RULE_EXECUTOR
SQLSTATE：未分配
<ruleExecutor> 的输入计划无效：<reason>
PLAN_VALIDATION_FAILED_RULE_IN_BATCH
SQLSTATE：未分配
批次 <batch> 中的规则 <rule> 生成了一个无效的计划：<reason>
PROTOBUF_DEPENDENCY_NOT_FOUND
SQLSTATE：未分配
找不到依赖项：<dependencyName>。
PROTOBUF_DESCRIPTOR_FILE_NOT_FOUND
SQLSTATE：未分配
错误：无法读取路径为 <filePath> 的 Protobuf 描述符文件。
PROTOBUF_FIELD_MISSING
SQLSTATE：未分配
在 Protobuf 模式 <protobufSchema> 中搜索 <field> 得到了 <matchSize> 个匹配项。候选：<matches>。
PROTOBUF_FIELD_MISSING_IN_SQL_SCHEMA
SQLSTATE：未分配
在 Protobuf 模式中找到了 <field>，但在 SQL 模式中没有匹配项。
PROTOBUF_FIELD_TYPE_MISMATCH
SQLSTATE：未分配
字段 <field> 遇到类型不匹配。
PROTOBUF_MESSAGE_NOT_FOUND
SQLSTATE：未分配
无法在描述符中找到消息 <messageName>。
PROTOBUF_TYPE_NOT_SUPPORT
SQLSTATE：未分配
尚未支持 Protobuf 类型：<protobufType>。
RECURSIVE_PROTOBUF_SCHEMA
SQLSTATE：未分配
在 Protobuf 模式中找到了递归引用，默认情况下 Spark 无法处理：<fieldDescriptor>。尝试将选项 recursive.fields.max.depth 设置为 0 到 10。不允许超过 10 级递归。
RECURSIVE_VIEW
SQLSTATE：未分配
检测到递归视图 <viewIdent>（循环：<newPath>）。
REF_DEFAULT_VALUE_IS_NOT_ALLOWED_IN_PARTITION
SQLSTATE：未分配
PARTITION 子句中不允许引用 DEFAULT 列值。
RENAME_SRC_PATH_NOT_FOUND
重命名失败，因为找不到 <sourcePath>。
REPEATED_CLAUSE
<clause> 子句在每个 <operation> 操作中最多可以使用一次。
REQUIRED_PARAMETER_NOT_FOUND
无法调用函数 <functionName>，因为名为 <parameterName> 的参数是必需的，但函数调用未提供值。请更新函数调用以提供参数值（位置上在索引 <index> 或按名称），然后重试查询。
REQUIRES_SINGLE_PART_NAMESPACE
<sessionCatalog> 需要单部分命名空间，但得到了 <namespace>。
ROUTINE_ALREADY_EXISTS
无法创建函数 <routineName>，因为它已存在。选择不同的名称，删除或替换现有函数，或添加 IF NOT EXISTS 子句以容忍预先存在的函数。
ROUTINE_NOT_FOUND
找不到函数 <routineName>。验证模式和目录的拼写和正确性。如果您没有使用模式和目录限定名称，请验证 current_schema() 输出，或使用正确的模式和目录限定名称。要容忍删除时的错误，请使用 DROP FUNCTION IF EXISTS。
RULE_ID_NOT_FOUND
找不到规则名称“<ruleName>”的 ID。如果您添加了新的规则，请修改 RuleIdCollection.scala。
SCALAR_SUBQUERY_IS_IN_GROUP_BY_OR_AGGREGATE_FUNCTION
SQLSTATE：未分配
相关标量子查询 ‘<sqlExpr>’ 既不在 GROUP BY 中，也不在聚合函数中。使用序数位置将其添加到 GROUP BY，或者如果您不关心获取哪个值，请将其包装在 first()（或 first_value）中。
SCALAR_SUBQUERY_TOO_MANY_ROWS
用作表达式的子查询返回多于一行。
SCHEMA_ALREADY_EXISTS
无法创建模式 <schemaName>，因为它已存在。选择不同的名称，删除现有模式，或添加 IF NOT EXISTS 子句以容忍预先存在的模式。
SCHEMA_NOT_EMPTY
无法删除模式 <schemaName>，因为它包含对象。使用 DROP SCHEMA … CASCADE 删除模式及其所有对象。
SCHEMA_NOT_FOUND
找不到模式 <schemaName>。验证模式和目录的拼写和正确性。如果您没有使用目录限定名称，请验证 current_schema() 输出，或使用正确的目录限定名称。要容忍删除时的错误，请使用 DROP SCHEMA IF EXISTS。
SECOND_FUNCTION_ARGUMENT_NOT_INTEGER
<functionName> 函数的第二个参数必须是整数。
SEED_EXPRESSION_IS_UNFOLDABLE
SQLSTATE：未分配
表达式 <exprWithSeed> 的种子表达式 <seedExpr> 必须是可折叠的。
SORT_BY_WITHOUT_BUCKETING
SQLSTATE：未分配
sortBy 必须与 bucketBy 一起使用。
SPECIFY_BUCKETING_IS_NOT_ALLOWED
SQLSTATE：未分配
在创建时未指定表模式且将在运行时推断的情况下，无法指定分桶信息。
SPECIFY_PARTITION_IS_NOT_ALLOWED
SQLSTATE：未分配
未定义表模式时，不允许指定分区列。未提供表模式时，将推断模式和分区列。
SQL_CONF_NOT_FOUND
SQLSTATE：未分配
找不到 SQL 配置 <sqlConf>。请验证配置是否存在。
STAR_GROUP_BY_POS
使用 GROUP BY 序数位置时，星号 (*) 不允许出现在 select 列表中。
STATIC_PARTITION_COLUMN_IN_INSERT_COLUMN_LIST
SQLSTATE：未分配
静态分区列 <staticName> 也在列列表中指定。
STREAM_FAILED
SQLSTATE：未分配
查询 [id = <id>, runId = <runId>] 终止，出现异常：<message>
SUM_OF_LIMIT_AND_OFFSET_EXCEEDS_MAX_INT
SQLSTATE：未分配
LIMIT 子句和 OFFSET 子句的总和不能大于最大 32 位整数值 (2,147,483,647)，但发现 limit = <limit>, offset = <offset>。
TABLE_OR_VIEW_ALREADY_EXISTS
无法创建表或视图 <relationName>，因为它已存在。选择不同的名称，删除或替换现有对象，或添加 IF NOT EXISTS 子句以容忍预先存在的对象。
TABLE_OR_VIEW_NOT_FOUND
找不到表或视图 <relationName>。请检查架构和目录的拼写和正确性。如果您没有使用架构限定名称，请验证 current_schema() 的输出，或使用正确的架构和目录限定名称。要容忍删除时的错误，请使用 DROP VIEW IF EXISTS 或 DROP TABLE IF EXISTS。
TABLE_VALUED_FUNCTION_TOO_MANY_TABLE_ARGUMENTS
SQLSTATE：未分配
表值函数的表参数过多。它允许一个表参数，但得到：<num>。如果您想允许它，请将“spark.sql.allowMultipleTableArguments.enabled”设置为“true”。
TASK_WRITE_FAILED
SQLSTATE：未分配
将行写入 <path> 时任务失败。
TEMP_TABLE_OR_VIEW_ALREADY_EXISTS
无法创建临时视图 <relationName>，因为它已经存在。选择一个不同的名称，删除或替换现有的视图，或添加 IF NOT EXISTS 子句以容忍预先存在的视图。
TEMP_VIEW_NAME_TOO_MANY_NAME_PARTS
CREATE TEMPORARY VIEW 或相应的 Dataset API 仅接受单部分视图名称，但得到：<actualName>。
TOO_MANY_ARRAY_ELEMENTS
无法用大小为 <size> 的 <numElements> 个元素初始化数组。
UDTF_ALIAS_NUMBER_MISMATCH
SQLSTATE：未分配
AS 子句中提供的别名数量与 UDTF 输出的列数不匹配。预期 <aliasesSize> 个别名，但得到 <aliasesNames>。请确保提供的别名数量与 UDTF 输出的列数匹配。
UNABLE_TO_ACQUIRE_MEMORY
无法获取 <requestedBytes> 字节的内存，得到 <receivedBytes>。
UNABLE_TO_CONVERT_TO_PROTOBUF_MESSAGE_TYPE
SQLSTATE：未分配
无法将 SQL 类型 <toType> 转换为 Protobuf 类型 <protobufType>。
UNABLE_TO_INFER_SCHEMA
无法推断 <format> 的模式。必须手动指定。
UNBOUND_SQL_PARAMETER
找到未绑定的参数：<name>。请修复 args 并提供参数到 SQL 字面量的映射。
UNCLOSED_BRACKETED_COMMENT
找到未关闭的方括号注释。请在注释末尾追加 */。
UNEXPECTED_INPUT_TYPE
函数 <functionName> 的参数 <paramIndex> 需要 <requiredType> 类型，但 <inputSql> 的类型为 <inputType>。
UNEXPECTED_POSITIONAL_ARGUMENT
无法调用函数 <functionName>，因为它包含在分配给 <parameterName> 的命名参数之后的位置参数；请重新排列它们，使位置参数排在最前面，然后重试查询。
UNKNOWN_PROTOBUF_MESSAGE_TYPE
SQLSTATE：未分配
尝试将 <descriptorName> 视为 Message，但它是 <containingType>。
UNPIVOT_REQUIRES_ATTRIBUTES
UNPIVOT 要求所有给定的 <given> 表达式在没有给定 <empty> 表达式时都是列。这些不是列：[<expressions>]。
UNPIVOT_REQUIRES_VALUE_COLUMNS
UNPIVOT 需要指定至少一个值列，所有列都指定为 ID。
UNPIVOT_VALUE_DATA_TYPE_MISMATCH
Unpivot 值列必须共享一个最小公倍数类型，某些类型没有：[<types>]。
UNPIVOT_VALUE_SIZE_MISMATCH
所有 unpivot 值列必须与值列名称 (<names>) 的数量相同。
UNRECOGNIZED_PARAMETER_NAME
无法调用函数 <functionName>，因为函数调用包含对名为 <argumentName> 的参数的命名参数引用，但此函数不包含任何包含具有此名称的参数的签名。您是否指的是以下内容？[<proposal>]。
UNRECOGNIZED_SQL_TYPE
无法识别的 SQL 类型 - 名称：<typeName>，ID：<jdbcType>。
UNRESOLVABLE_TABLE_VALUED_FUNCTION
SQLSTATE：未分配
无法将 <name> 解析为表值函数。请确保 <name> 定义为表值函数，并且所有必需的参数都已正确提供。如果 <name> 未定义，请在使用它之前创建表值函数。有关定义表值函数的更多信息，请参阅 Apache Spark 文档。
UNRESOLVED_ALL_IN_GROUP_BY
无法根据 select 子句推断 GROUP BY ALL 的分组列。请明确指定分组列。
UNRESOLVED_COLUMN
无法解析名为 <objectName> 的列或函数参数。
有关更多详细信息，请参阅 UNRESOLVED_COLUMN
UNRESOLVED_FIELD
无法使用结构类型列 <columnPath> 解析名为 <fieldName> 的字段。
有关更多详细信息，请参阅 UNRESOLVED_FIELD
UNRESOLVED_MAP_KEY
无法将列 <objectName> 解析为映射键。如果键是字符串文字，请在周围添加单引号 ''。
有关更多详细信息，请参阅 UNRESOLVED_MAP_KEY
UNRESOLVED_ROUTINE
无法在搜索路径 <searchPath> 上解析函数 <routineName>。
UNRESOLVED_USING_COLUMN_FOR_JOIN
无法在连接的 <side> 侧解析 USING 列 <colName>。 <side> 侧列：[<suggestion>]。
UNSET_NONEXISTENT_PROPERTIES
SQLSTATE：未分配
尝试在表 <table> 中取消设置不存在的属性 [<properties>]。
UNSUPPORTED_ADD_FILE
SQLSTATE：未分配
不支持添加文件。
有关更多详细信息，请参阅 UNSUPPORTED_ADD_FILE
UNSUPPORTED_ARROWTYPE
不支持的箭头类型 <typeName>。
UNSUPPORTED_CHAR_OR_VARCHAR_AS_STRING
SQLSTATE：未分配
char/varchar 类型不能在表模式中使用。如果您希望 Spark 将它们视为与 Spark 3.0 及更早版本相同的字符串类型，请将“spark.sql.legacy.charVarcharAsString”设置为“true”。
UNSUPPORTED_DATASOURCE_FOR_DIRECT_QUERY
SQLSTATE：未分配
不支持对文件进行直接查询的数据源类型：<dataSourceType>
UNSUPPORTED_DATATYPE
不支持的数据类型 <typeName>。
UNSUPPORTED_DATA_TYPE_FOR_DATASOURCE
SQLSTATE：未分配
<format> 数据源不支持类型为 <columnType> 的列 <columnName>。
UNSUPPORTED_DEFAULT_VALUE
SQLSTATE：未分配
不支持 DEFAULT 列值。
有关更多详细信息，请参阅 UNSUPPORTED_DEFAULT_VALUE
UNSUPPORTED_DESERIALIZER
不支持反序列化器
有关更多详细信息，请参阅 UNSUPPORTED_DESERIALIZER
UNSUPPORTED_EXPRESSION_GENERATED_COLUMN
SQLSTATE：未分配
无法使用生成表达式 <expressionStr> 创建生成列 <fieldName>，因为 <reason>。
UNSUPPORTED_EXPR_FOR_OPERATOR
SQLSTATE：未分配
查询运算符包含一个或多个不支持的表达式。考虑重写它以避免在 WHERE 子句中使用窗口函数、聚合函数和生成器函数。无效表达式：[<invalidExprSqls>]
UNSUPPORTED_EXPR_FOR_WINDOW
表达式 <sqlExpr> 在窗口函数中不受支持。
UNSUPPORTED_FEATURE
不支持该功能
有关更多详细信息，请参阅 UNSUPPORTED_FEATURE
UNSUPPORTED_GENERATOR
不支持该生成器
有关更多详细信息，请参阅 UNSUPPORTED_GENERATOR
UNSUPPORTED_GROUPING_EXPRESSION
SQLSTATE：未分配
grouping()/grouping_id() 只能与 GroupingSets/Cube/Rollup 一起使用。
UNSUPPORTED_INSERT
SQLSTATE：未分配
无法插入目标。
有关更多详细信息，请参阅 UNSUPPORTED_INSERT
UNSUPPORTED_MERGE_CONDITION
SQLSTATE：未分配
MERGE 操作包含不支持的 <condName> 条件。
有关更多详细信息，请参阅 UNSUPPORTED_MERGE_CONDITION
UNSUPPORTED_OVERWRITE
SQLSTATE：未分配
无法覆盖也正在从中读取的目标。
有关更多详细信息，请参阅 UNSUPPORTED_OVERWRITE
UNSUPPORTED_SAVE_MODE
SQLSTATE：未分配
保存模式 <saveMode> 不支持
有关更多详细信息，请参阅 UNSUPPORTED_SAVE_MODE
UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY
不支持的子查询表达式
有关更多详细信息，请参阅 UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY
UNSUPPORTED_TYPED_LITERAL
不支持类型为 <unsupportedType> 的文字。支持的类型是 <supportedTypes>。
UNTYPED_SCALA_UDF
SQLSTATE：未分配
您正在使用无类型 Scala UDF，它没有输入类型信息。Spark 可能会盲目地将 null 传递给具有基本类型参数的 Scala 闭包，并且闭包将看到 Java 类型对 null 参数的默认值，例如 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。
VIEW_ALREADY_EXISTS
无法创建视图 <relationName>，因为它已经存在。选择一个不同的名称，删除或替换现有的对象，或添加 IF NOT EXISTS 子句以容忍预先存在的对象。
VIEW_NOT_FOUND
找不到视图 <relationName>。请检查模式和目录的拼写和正确性。如果您没有使用模式限定名称，请验证 current_schema() 的输出，或使用正确的模式和目录限定名称。要容忍删除操作中的错误，请使用 DROP VIEW IF EXISTS。
WINDOW_FUNCTION_AND_FRAME_MISMATCH
SQLSTATE：未分配
<funcName> 函数只能在具有单个偏移量的有序行级窗口框架中进行评估：<windowExpr>。
WINDOW_FUNCTION_WITHOUT_OVER_CLAUSE
SQLSTATE：未分配
窗口函数 <funcName> 需要 OVER 子句。
WRITE_STREAM_NOT_ALLOWED
SQLSTATE：未分配
只能在流式 Dataset/DataFrame 上调用 writeStream。
WRONG_COMMAND_FOR_OBJECT_TYPE
SQLSTATE：未分配
操作 <operation> 需要 <requiredType>。但 <objectName> 是 <foundType>。请使用 <alternative> 代替。
WRONG_NUM_ARGS
<functionName> 函数需要 <expectedNum> 个参数，但实际参数数量为 <actualNum>。
有关更多详细信息，请参阅 WRONG_NUM_ARGS