錯誤狀況
這是 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.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 join。
有關更多詳細資料，請參閱 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：未指派
無法在串流 Dataset/DataFrame 上呼叫方法 <methodName>。
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：未指派
只有驅動程式可以呼叫資料集轉換和動作，而不能在其他資料集轉換中呼叫；例如，dataset1.map(x => dataset2.values.count() * x) 無效，因為無法在 dataset1.map 轉換中執行 values 轉換和 count 動作。如需更多資訊，請參閱 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>。請確保提供的值符合定義間隔的有效格式。您可以參考文件取得正確格式。如果問題仍然存在，請再次確認輸入值不為 Null 或空值，然後再試一次。
無法解析 JSON 欄位
無法解析 JSON 令牌類型 <jsonType> 的欄位名稱 <fieldName> 和值 <fieldValue> 為目標 Spark 資料類型 <dataType>。
無法解析 Protobuf 描述符
SQLSTATE：未指派
將描述符位元組解析為 Protobuf FileDescriptorSet 時發生錯誤。
無法解析時間戳記
<message>。如有需要，請將 <ansiConfig> 設為「false」以略過此錯誤。
無法讀取檔案頁尾
SQLSTATE：未指派
無法讀取檔案的頁尾：<file>。請確定檔案格式為 ORC 或 Parquet。如果不是，請將其轉換為有效的格式。如果檔案格式有效，請檢查檔案是否已損毀。如果是，您可以選擇忽略或修復損毀。
無法辨識 Hive 類型
無法辨識 Hive 類型字串：<fieldType>，欄位：<fieldName>。Spark SQL 無法辨識該欄位指定的資料類型。請檢查指定欄位的資料類型，並確定它是有效的 Spark SQL 資料類型。請參閱 Spark SQL 文件，以取得有效資料類型及其格式清單。如果資料類型正確，請確定您使用的是受支援的 Spark SQL 版本。
無法跨架構重新命名
不允許跨架構重新命名 <type>。
無法解析星號展開
SQLSTATE：未指派
無法解析 <targetString>.*，輸入欄位為 <columns>。請檢查指定的表格或結構是否存在，且輸入欄位中可以存取。
無法復原路徑的權限
SQLSTATE：未指派
無法將已建立路徑 <path> 的權限設回 <permission>。
無法更新欄位
SQLSTATE：未指派
無法更新 <table> 欄位 <fieldName> 類型
如需更多詳細資訊，請參閱 無法更新欄位
無法向上轉換資料類型
SQLSTATE：未指派
無法將 <expression> 從 <sourceType> 向上轉換為 <targetType>。 <details>
轉換輸入無效
類型為 <sourceType> 的值 <expression> 無法轉換為 <targetType>，因為它格式錯誤。請根據語法修正值，或變更其目標類型。使用 try_cast 容許格式錯誤的輸入，並回傳 NULL。如有需要，請將 <ansiConfig> 設為「false」以略過此錯誤。
轉換溢位
無法將類型 <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：未指派
不允許建立永久檢視 <name>，而不明確指定表達式 <attr> 的別名。
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.dev.org.tw/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 Struct 中有重複的欄位名稱，已取得 <fieldNames>。
重複的映射鍵
找到重複的映射鍵 <key>，請檢查輸入資料。如果您要移除重複的鍵，您可以將 <mapKeyDedupPolicy> 設定為「LAST_WIN」，以便最後插入的鍵優先。
重複的指標名稱
SQLSTATE：未指派
指標名稱不唯一：<metricName>。相同名稱不能用於具有不同結果的指標。但是，允許多個具有相同結果和名稱的指標實例（例如自聯結）。
重複的子句
SQLSTATE：未指派
找到重複的子句：<clauseName>。請移除其中一個。
重複的鍵
找到重複的鍵 <keyColumn>。
重複的常式參數指定
呼叫函式 <functionName> 無效，因為它包含對同一個參數名稱 <parameterName> 的多個引數指定。
如需更多詳細資訊，請參閱 DUPLICATE_ROUTINE_PARAMETER_ASSIGNMENT
空的 JSON 欄位值
無法解析資料類型 <dataType> 的空字串。
未找到編碼器
SQLSTATE：未指派
找不到類型 <typeName> 的編碼器轉換為 Spark SQL 內部表示。請考慮將輸入類型變更為「<docroot>/sql-ref-datatypes.html」中支援的類型之一。
事件時間不在時間戳記類型上
SQLSTATE：未指派
事件時間 <eventName> 具有無效類型 <eventType>，但預期為「TIMESTAMP」。
超過長度限制
SQLSTATE：未指派
超過 char/varchar 類型的長度限制：<limit>。
表達式類型不可排序
SQLSTATE：未指派
欄位表達式 <expr> 無法排序，因為其類型 <exprType> 不可排序。
執行 UDF 失敗
無法執行使用者定義函式（<functionName>：(<signature>) => <result>）。
函式呼叫失敗
準備函式 <funcName> 以供呼叫時失敗。請仔細檢查函式的引數。
解析結構類型失敗
解析結構失敗：<raw>。
重新命名路徑失敗
無法將 <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>: <objectName> 執行 <statement> 作業。
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
分組 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> 不在選取清單中 (有效範圍為 [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。請從 classpath 中移除不相容的函式庫或升級它。錯誤：<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，可能會得到不同的結果
如需更多詳細資訊，請參閱 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：未指派
無效的 bucket 檔案：<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> 有預設值 <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
欄位名稱應為非 null 字串文字，但為 <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 metastore 中無效字元 <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> 只能包含字串作為 MAP 的金鑰類型。
INVALID_LAMBDA_FUNCTION_CALL
SQLSTATE：未指派
無效的 lambda 函式呼叫。
如需更多詳細資訊，請參閱 INVALID_LAMBDA_FUNCTION_CALL
INVALID_LATERAL_JOIN_TYPE
不允許使用 LATERAL 關聯的 <joinType> JOIN，因為外部子查詢無法與其加入合作夥伴相關聯。移除 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
<functionName> 中參數 <parameter> 的值無效
更多詳細資訊，請參閱 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>。如有必要，請將 <ansiConfig> 設定為「false」以略過此錯誤。
INVALID_USAGE_OF_STAR_OR_REGEX
在 <prettyName> 中無效使用 <elem>。
INVALID_VIEW_TEXT
SQLSTATE：未指派
由於檢視文字無效：<viewText>，因此無法顯示檢視 <viewName>。這可能是因為未經授權修改檢視或查詢語法不正確所造成。請檢查您的查詢語法，並驗證檢視是否未被竄改。
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>，預期為「布林」。
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 結果，請嘗試將選項「模式」設定為「PERMISSIVE」。
MALFORMED_RECORD_IN_PARSING
在記錄剖析中偵測到格式錯誤的記錄：<badRecord>。剖析模式：<failFastMode>。若要將格式錯誤的記錄處理為 null 結果，請嘗試將選項「模式」設定為「PERMISSIVE」。
如需更多詳細資訊，請參閱 MALFORMED_RECORD_IN_PARSING
MERGE_CARDINALITY_VIOLATION
MERGE 陳述式的 ON 搜尋條件與目標表格中的單一列相符，但與來源表格中的多列相符。這可能會導致目標列使用更新或刪除作業操作多次，而且不允許這樣做。
MISSING_AGGREGATION
非彙總運算式 <expression> 根據未參與 GROUP BY 子句的欄位。將欄位或運算式新增到 GROUP BY，彙總運算式，或使用 <expressionAnyValue>，如果您不介意傳回群組中哪個值。
MISSING_ATTRIBUTES
SQLSTATE：未指派
在運算子 <operator> 中，屬性 <missingAttributes> 已解決，但 <input> 中遺失。
更多詳細資訊，請參閱 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：未指派
視窗函數在串流資料框架/資料集的 <windowFunc>（作為欄位 <columnName>）中不受支援。結構化串流僅支援使用 WINDOW 函數進行時間視窗聚合。（視窗規格：<windowSpec>）
NOT_ALLOWED_IN_FROM
SQLSTATE：未指派
在 FROM 子句中不允許
有關更多詳細資訊，請參閱 NOT_ALLOWED_IN_FROM
NOT_A_CONSTANT_STRING
用於常式或子句 <name> 的表達式 <expr> 必須是不為 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> 的預設值，因為它不允許為 NULL 且沒有預設值。
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> 允許為 NULL，但要求它不能為 NULL。
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> 不在選取清單中（有效範圍為 [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> 已存在。請將模式設為「覆寫」以覆寫現有的路徑。
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：未指派
在 <protobufSchema> 中的 Protobuf 架構中搜尋 <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
每個 <operation> 執行階段最多只能使用一次 <clause> 子句。
找不到必要參數
無法呼叫函式 <functionName>，因為需要名稱為 <parameterName> 的參數，但函式呼叫未提供值。請更新函式呼叫以提供引數值（在索引 <index> 處或依名稱提供），然後再重試查詢。
需要單一區段名稱空間
<sessionCatalog> 需要單一區段名稱空間，但取得 <namespace>。
常式已存在
無法建立函式 <routineName>，因為它已存在。請選擇不同的名稱，移除或取代現有函式，或加入 IF NOT EXISTS 子句以容忍預先存在的函式。
找不到常式
找不到函式 <routineName>。請驗證架構和目錄的拼寫和正確性。如果您未使用架構和目錄限定名稱，請驗證 current_schema() 輸出，或使用正確的架構和目錄限定名稱。若要容忍移除錯誤，請使用 DROP FUNCTION IF EXISTS。
找不到規則 ID
找不到規則名稱 “<ruleName>” 的 ID。如果您要新增新規則，請修改 RuleIdCollection.scala。
純量子查詢在 GROUP BY 或聚合函式中
SQLSTATE：未指派
相關純量子查詢 ‘<sqlExpr>’ 不存在於 GROUP BY 中，也不存在於聚合函式中。請使用序數位置將它加入 GROUP BY，或將它包覆在 first()（或 first_value）中，如果您不介意取得哪個值。
純量子查詢列數過多
作為表達式使用的子查詢傳回多於一列。
架構已存在
無法建立架構 <schemaName>，因為它已存在。請選擇不同的名稱，移除現有架構，或加入 IF NOT EXISTS 子句以容忍預先存在的架構。
架構不為空
無法移除架構 <schemaName>，因為它包含物件。請使用 DROP SCHEMA … CASCADE 移除架構及其所有物件。
找不到架構
找不到架構 <schemaName>。請驗證架構和目錄的拼寫和正確性。如果您未使用目錄限定名稱，請驗證 current_schema() 輸出，或使用正確的目錄限定名稱。若要容忍移除錯誤，請使用 DROP SCHEMA IF EXISTS。
第二個函式引數不是整數
<functionName> 函式的第二個引數必須是整數。
種子表達式無法展開
SQLSTATE：未指派
表達式 <exprWithSeed> 的種子表達式 <seedExpr> 必須可展開。
未分組排序
SQLSTATE：未指派
sortBy 必須與 bucketBy 搭配使用。
不允許指定分組
SQLSTATE：未指派
如果建立時未指定表格架構，且會在執行時推斷，則無法指定分組資訊。
不允許指定分割
SQLSTATE：未指派
如果未定義表格架構，則不允許指定分割欄位。如果未提供表格架構，則會推斷架構和分割欄位。
找不到 SQL 設定
SQLSTATE：未指派
找不到 SQL 設定 <sqlConf>。請驗證設定是否存在。
星號依序分組
當依序位置進行 GROUP BY 時，選取清單中不允許使用星號 (*)。
插入欄位清單中的靜態分割欄位
SQLSTATE：未指派
靜態分割欄位 <staticName> 也指定在欄位清單中。
串流失敗
SQLSTATE：未指派
查詢 [id = <id>，runId = <runId>] 以例外狀況終止：<message>
限制和偏移的總和超過最大整數
SQLSTATE：未指派
LIMIT 子句和 OFFSET 子句的總和不得大於最大 32 位元整數值 (2,147,483,647)，但發現限制 = <limit>，偏移 = <offset>。
表格或檢視已存在
無法建立表格或檢視 <relationName>，因為它已存在。請選擇不同的名稱、刪除或取代現有物件，或加入 IF NOT EXISTS 子句以容忍已存在的物件。
找不到表格或檢視
找不到表格或檢視 <relationName>。驗證架構和目錄的拼寫和正確性。如果您沒有使用架構限定名稱，請驗證 current_schema() 輸出，或使用正確的架構和目錄限定名稱。若要容忍刪除錯誤，請使用 DROP VIEW IF EXISTS 或 DROP TABLE IF EXISTS。
表格值函數的表格引數太多
SQLSTATE：未指派
表格值函數的表格引數太多。它允許一個表格引數，但取得：<num>。如果您要允許它，請將 “spark.sql.allowMultipleTableArguments.enabled” 設定為 “true”
任務寫入失敗
SQLSTATE：未指派
執行任務時寫入列至 <路徑> 時失敗。
TEMP_TABLE_OR_VIEW_ALREADY_EXISTS
無法建立暫時檢視 <關係名稱>，因為它已存在。請選擇其他名稱，刪除或取代現有檢視，或新增 IF NOT EXISTS 子句以容許已存在的檢視。
TEMP_VIEW_NAME_TOO_MANY_NAME_PARTS
CREATE TEMPORARY VIEW 或對應的資料集 API 僅接受單一部分檢視名稱，但取得：<實際名稱>。
TOO_MANY_ARRAY_ELEMENTS
無法使用大小為 <大小> 的 <元素數量> 個元素初始化陣列。
UDTF_ALIAS_NUMBER_MISMATCH
SQLSTATE：未指派
AS 子句中提供的別名數量與 UDTF 輸出的欄位數量不符。預期 <別名大小> 個別名，但取得 <別名名稱>。請確定提供的別名數量與 UDTF 輸出的欄位數量相符。
UNABLE_TO_ACQUIRE_MEMORY
無法取得 <請求位元組> 位元組的記憶體，取得 <已接收位元組>。
UNABLE_TO_CONVERT_TO_PROTOBUF_MESSAGE_TYPE
SQLSTATE：未指派
無法將 SQL 類型 <toType> 轉換為 Protobuf 類型 <protobufType>。
UNABLE_TO_INFER_SCHEMA
無法推斷 <格式> 的結構。必須手動指定。
UNBOUND_SQL_PARAMETER
找到未繫結的參數：<名稱>。請修正 args 並提供參數對應 SQL 文字的對應。
UNCLOSED_BRACKETED_COMMENT
找到未關閉的括號註解。請在註解結尾加上 */。
UNEXPECTED_INPUT_TYPE
函數 <函數名稱> 的參數 <參數索引> 需要 <所需類型> 類型，但 <輸入 SQL> 的類型為 <輸入類型>。
UNEXPECTED_POSITIONAL_ARGUMENT
無法呼叫函數 <函數名稱>，因為它包含指定給 <參數名稱> 的命名參數之後的位置參數；請重新排列它們，讓位置參數先出現，然後再重試查詢。
UNKNOWN_PROTOBUF_MESSAGE_TYPE
SQLSTATE：未指派
嘗試將 <描述名稱> 視為訊息，但它是 <包含類型>。
UNPIVOT_REQUIRES_ATTRIBUTES
當沒有提供 <empty> 表達式時，UNPIVOT 需要所有提供的 <given> 表達式為欄位。這些不是欄位：[<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
無法根據選取子句推斷 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
不支援的 arrow 類型 <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：未指派
不支援預設欄位值。
如需更多詳細資訊，請參閱 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 閉包，而閉包將看到 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。
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