- Error Conditions
- AMBIGUOUS_COLUMN_OR_FIELD
- AMBIGUOUS_LATERAL_COLUMN_ALIAS
- AMBIGUOUS_REFERENCE
- AMBIGUOUS_REFERENCE_TO_FIELDS
- ARITHMETIC_OVERFLOW
- CANNOT_CAST_DATATYPE
- CANNOT_CONSTRUCT_PROTOBUF_DESCRIPTOR
- CANNOT_CONVERT_PROTOBUF_FIELD_TYPE_TO_SQL_TYPE
- CANNOT_CONVERT_PROTOBUF_MESSAGE_TYPE_TO_SQL_TYPE
- CANNOT_CONVERT_SQL_TYPE_TO_PROTOBUF_ENUM_TYPE
- CANNOT_CONVERT_SQL_TYPE_TO_PROTOBUF_FIELD_TYPE
- CANNOT_DECODE_URL
- CANNOT_LOAD_FUNCTION_CLASS
- CANNOT_LOAD_PROTOBUF_CLASS
- CANNOT_MERGE_INCOMPATIBLE_DATA_TYPE
- CANNOT_MODIFY_CONFIG
- CANNOT_PARSE_DECIMAL
- CANNOT_PARSE_JSON_FIELD
- CANNOT_PARSE_PROTOBUF_DESCRIPTOR
- CANNOT_PARSE_TIMESTAMP
- CANNOT_READ_FILE_FOOTER
- CANNOT_RECOGNIZE_HIVE_TYPE
- CANNOT_RESTORE_PERMISSIONS_FOR_PATH
- CANNOT_UP_CAST_DATATYPE
- CAST_INVALID_INPUT
- CAST_OVERFLOW
- CAST_OVERFLOW_IN_TABLE_INSERT
- COLUMN_ALREADY_EXISTS
- COLUMN_NOT_FOUND
- COMPARATOR_RETURNS_NULL
- CONCURRENT_QUERY
- CONNECT
- CONVERSION_INVALID_INPUT
- CREATE_TABLE_COLUMN_OPTION_DUPLICATE
- DATATYPE_MISMATCH
- DATATYPE_MISSING_SIZE
- DATA_SOURCE_NOT_FOUND
- DATETIME_OVERFLOW
- DECIMAL_PRECISION_EXCEEDS_MAX_PRECISION
- DEFAULT_DATABASE_NOT_EXISTS
- DIVIDE_BY_ZERO
- DUPLICATED_MAP_KEY
- DUPLICATE_KEY
- EMPTY_JSON_FIELD_VALUE
- ENCODER_NOT_FOUND
- FAILED_EXECUTE_UDF
- FAILED_FUNCTION_CALL
- FAILED_RENAME_PATH
- FIELD_NOT_FOUND
- FORBIDDEN_OPERATION
- GENERATED_COLUMN_WITH_DEFAULT_VALUE
- GRAPHITE_SINK_INVALID_PROTOCOL
- GRAPHITE_SINK_PROPERTY_MISSING
- GROUPING_COLUMN_MISMATCH
- GROUPING_ID_COLUMN_MISMATCH
- GROUPING_SIZE_LIMIT_EXCEEDED
- GROUP_BY_AGGREGATE
- GROUP_BY_POS_AGGREGATE
- GROUP_BY_POS_OUT_OF_RANGE
- IDENTIFIER_TOO_MANY_NAME_PARTS
- INCOMPARABLE_PIVOT_COLUMN
- INCOMPATIBLE_COLUMN_TYPE
- INCOMPATIBLE_DATASOURCE_REGISTER
- INCOMPATIBLE_JOIN_TYPES
- INCOMPATIBLE_VIEW_SCHEMA_CHANGE
- INCOMPLETE_TYPE_DEFINITION
- INCONSISTENT_BEHAVIOR_CROSS_VERSION
- INCORRECT_END_OFFSET
- INCORRECT_RAMP_UP_RATE
- INDEX_ALREADY_EXISTS
- INDEX_NOT_FOUND
- INTERNAL_ERROR
- INTERVAL_ARITHMETIC_OVERFLOW
- INTERVAL_DIVIDED_BY_ZERO
- INVALID_ARRAY_INDEX
- INVALID_ARRAY_INDEX_IN_ELEMENT_AT
- INVALID_BUCKET_FILE
- INVALID_BYTE_STRING
- INVALID_COLUMN_NAME_AS_PATH
- INVALID_COLUMN_OR_FIELD_DATA_TYPE
- INVALID_EMPTY_LOCATION
- INVALID_EXTRACT_BASE_FIELD_TYPE
- INVALID_EXTRACT_FIELD
- INVALID_EXTRACT_FIELD_TYPE
- INVALID_FIELD_NAME
- INVALID_FORMAT
- INVALID_FRACTION_OF_SECOND
- INVALID_IDENTIFIER
- INVALID_INDEX_OF_ZERO
- INVALID_JSON_ROOT_FIELD
- INVALID_JSON_SCHEMA_MAP_TYPE
- INVALID_LATERAL_JOIN_TYPE
- INVALID_OPTIONS
- INVALID_PANDAS_UDF_PLACEMENT
- INVALID_PARAMETER_VALUE
- INVALID_PROPERTY_KEY
- INVALID_PROPERTY_VALUE
- INVALID_SCHEMA
- INVALID_SET_SYNTAX
- INVALID_SQL_ARG
- INVALID_SQL_SYNTAX
- INVALID_SUBQUERY_EXPRESSION
- INVALID_TEMP_OBJ_REFERENCE
- INVALID_TYPED_LITERAL
- INVALID_WHERE_CONDITION
- LOCATION_ALREADY_EXISTS
- MALFORMED_CSV_RECORD
- MALFORMED_PROTOBUF_MESSAGE
- MALFORMED_RECORD_IN_PARSING
- MISSING_AGGREGATION
- MISSING_GROUP_BY
- MULTI_UDF_INTERFACE_ERROR
- NESTED_AGGREGATE_FUNCTION
- NON_LAST_MATCHED_CLAUSE_OMIT_CONDITION
- NON_LAST_NOT_MATCHED_BY_SOURCE_CLAUSE_OMIT_CONDITION
- NON_LAST_NOT_MATCHED_BY_TARGET_CLAUSE_OMIT_CONDITION
- NON_LITERAL_PIVOT_VALUES
- NON_PARTITION_COLUMN
- NOT_A_PARTITIONED_TABLE
- NOT_NULL_CONSTRAINT_VIOLATION
- NO_HANDLER_FOR_UDAF
- NO_SQL_TYPE_IN_PROTOBUF_SCHEMA
- NO_UDF_INTERFACE
- NULLABLE_COLUMN_OR_FIELD
- NULLABLE_ROW_ID_ATTRIBUTES
- NULL_MAP_KEY
- NUMERIC_OUT_OF_SUPPORTED_RANGE
- NUMERIC_VALUE_OUT_OF_RANGE
- NUM_COLUMNS_MISMATCH
- ORDER_BY_POS_OUT_OF_RANGE
- PARSE_EMPTY_STATEMENT
- PARSE_SYNTAX_ERROR
- PARTITIONS_ALREADY_EXIST
- PARTITIONS_NOT_FOUND
- PATH_ALREADY_EXISTS
- PATH_NOT_FOUND
- PIVOT_VALUE_DATA_TYPE_MISMATCH
- PLAN_VALIDATION_FAILED_RULE_EXECUTOR
- PLAN_VALIDATION_FAILED_RULE_IN_BATCH
- PROTOBUF_DEPENDENCY_NOT_FOUND
- PROTOBUF_DESCRIPTOR_FILE_NOT_FOUND
- PROTOBUF_FIELD_MISSING
- PROTOBUF_FIELD_MISSING_IN_SQL_SCHEMA
- PROTOBUF_FIELD_TYPE_MISMATCH
- PROTOBUF_MESSAGE_NOT_FOUND
- PROTOBUF_TYPE_NOT_SUPPORT
- RECURSIVE_PROTOBUF_SCHEMA
- RENAME_SRC_PATH_NOT_FOUND
- REPEATED_CLAUSE
- REQUIRES_SINGLE_PART_NAMESPACE
- ROUTINE_ALREADY_EXISTS
- ROUTINE_NOT_FOUND
- SCALAR_SUBQUERY_TOO_MANY_ROWS
- SCHEMA_ALREADY_EXISTS
- SCHEMA_NOT_EMPTY
- SCHEMA_NOT_FOUND
- SECOND_FUNCTION_ARGUMENT_NOT_INTEGER
- SORT_BY_WITHOUT_BUCKETING
- STAR_GROUP_BY_POS
- STATIC_PARTITION_COLUMN_IN_INSERT_COLUMN_LIST
- STREAM_FAILED
- TABLE_OR_VIEW_ALREADY_EXISTS
- TABLE_OR_VIEW_NOT_FOUND
- TASK_WRITE_FAILED
- TEMP_TABLE_OR_VIEW_ALREADY_EXISTS
- TEMP_VIEW_NAME_TOO_MANY_NAME_PARTS
- TOO_MANY_ARRAY_ELEMENTS
- UNABLE_TO_ACQUIRE_MEMORY
- UNABLE_TO_CONVERT_TO_PROTOBUF_MESSAGE_TYPE
- UNABLE_TO_INFER_SCHEMA
- UNBOUND_SQL_PARAMETER
- UNCLOSED_BRACKETED_COMMENT
- UNEXPECTED_INPUT_TYPE
- UNKNOWN_PROTOBUF_MESSAGE_TYPE
- UNPIVOT_REQUIRES_ATTRIBUTES
- UNPIVOT_REQUIRES_VALUE_COLUMNS
- UNPIVOT_VALUE_DATA_TYPE_MISMATCH
- UNPIVOT_VALUE_SIZE_MISMATCH
- UNRECOGNIZED_SQL_TYPE
- UNRESOLVED_ALL_IN_GROUP_BY
- UNRESOLVED_COLUMN
- UNRESOLVED_FIELD
- UNRESOLVED_MAP_KEY
- UNRESOLVED_ROUTINE
- UNRESOLVED_USING_COLUMN_FOR_JOIN
- UNSUPPORTED_ARROWTYPE
- UNSUPPORTED_DATASOURCE_FOR_DIRECT_QUERY
- UNSUPPORTED_DATATYPE
- UNSUPPORTED_DESERIALIZER
- UNSUPPORTED_EXPRESSION_GENERATED_COLUMN
- UNSUPPORTED_EXPR_FOR_OPERATOR
- UNSUPPORTED_EXPR_FOR_WINDOW
- UNSUPPORTED_FEATURE
- UNSUPPORTED_GENERATOR
- UNSUPPORTED_GROUPING_EXPRESSION
- UNSUPPORTED_SAVE_MODE
- UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY
- UNSUPPORTED_TYPED_LITERAL
- UNTYPED_SCALA_UDF
- VIEW_ALREADY_EXISTS
- VIEW_NOT_FOUND
- WRITE_STREAM_NOT_ALLOWED
- WRONG_COMMAND_FOR_OBJECT_TYPE
- WRONG_NUM_ARGS
Error Conditions
This is a list of common, named error conditions returned by Spark SQL.
Also see SQLSTATE Codes.
AMBIGUOUS_COLUMN_OR_FIELD
Column or field <name>
is ambiguous and has <n>
matches.
AMBIGUOUS_LATERAL_COLUMN_ALIAS
Lateral column alias <name>
is ambiguous and has <n>
matches.
AMBIGUOUS_REFERENCE
Reference <name>
is ambiguous, could be: <referenceNames>
.
AMBIGUOUS_REFERENCE_TO_FIELDS
Ambiguous reference to the field <field>
. It appears <count>
times in the schema.
ARITHMETIC_OVERFLOW
<message>
.<alternative>
If necessary set <config>
to “false” to bypass this error.
CANNOT_CAST_DATATYPE
Cannot cast <sourceType>
to <targetType>
.
CANNOT_CONSTRUCT_PROTOBUF_DESCRIPTOR
SQLSTATE: none assigned
Error constructing FileDescriptor for <descFilePath>
.
CANNOT_CONVERT_PROTOBUF_FIELD_TYPE_TO_SQL_TYPE
SQLSTATE: none assigned
Cannot convert Protobuf <protobufColumn>
to SQL <sqlColumn>
because schema is incompatible (protobufType = <protobufType>
, sqlType = <sqlType>
).
CANNOT_CONVERT_PROTOBUF_MESSAGE_TYPE_TO_SQL_TYPE
SQLSTATE: none assigned
Unable to convert <protobufType>
of Protobuf to SQL type <toType>
.
CANNOT_CONVERT_SQL_TYPE_TO_PROTOBUF_ENUM_TYPE
SQLSTATE: none assigned
Cannot convert SQL <sqlColumn>
to Protobuf <protobufColumn>
because <data>
cannot be written since it’s not defined in ENUM <enumString>
.
CANNOT_CONVERT_SQL_TYPE_TO_PROTOBUF_FIELD_TYPE
SQLSTATE: none assigned
Cannot convert SQL <sqlColumn>
to Protobuf <protobufColumn>
because schema is incompatible (protobufType = <protobufType>
, sqlType = <sqlType>
).
CANNOT_DECODE_URL
Cannot decode url : <url>
.
CANNOT_LOAD_FUNCTION_CLASS
SQLSTATE: none assigned
Cannot load class <className>
when registering the function <functionName>
, please make sure it is on the classpath.
CANNOT_LOAD_PROTOBUF_CLASS
SQLSTATE: none assigned
Could not load Protobuf class with name <protobufClassName>
. <explanation>
.
CANNOT_MERGE_INCOMPATIBLE_DATA_TYPE
Failed to merge incompatible data types <left>
and <right>
.
CANNOT_MODIFY_CONFIG
Cannot modify the value of the Spark config: <key>
.
See also ‘<docroot>
/sql-migration-guide.html#ddl-statements’.
CANNOT_PARSE_DECIMAL
Cannot parse decimal.
CANNOT_PARSE_JSON_FIELD
Cannot parse the field name <fieldName>
and the value <fieldValue>
of the JSON token type <jsonType>
to target Spark data type <dataType>
.
CANNOT_PARSE_PROTOBUF_DESCRIPTOR
SQLSTATE: none assigned
Error parsing file <descFilePath>
descriptor byte[] into Descriptor object.
CANNOT_PARSE_TIMESTAMP
<message>
. If necessary set <ansiConfig>
to “false” to bypass this error.
CANNOT_READ_FILE_FOOTER
SQLSTATE: none assigned
Could not read footer for file: <file>
.
CANNOT_RECOGNIZE_HIVE_TYPE
Cannot recognize hive type string: <fieldType>
, column: <fieldName>
.
CANNOT_RESTORE_PERMISSIONS_FOR_PATH
SQLSTATE: none assigned
Failed to set permissions on created path <path>
back to <permission>
.
CANNOT_UP_CAST_DATATYPE
SQLSTATE: none assigned
Cannot up cast <expression>
from <sourceType>
to <targetType>
.
<details>
CAST_INVALID_INPUT
The value <expression>
of the type <sourceType>
cannot be cast to <targetType>
because it is malformed. Correct the value as per the syntax, or change its target type. Use try_cast
to tolerate malformed input and return NULL instead. If necessary set <ansiConfig>
to “false” to bypass this error.
CAST_OVERFLOW
The value <value>
of the type <sourceType>
cannot be cast to <targetType>
due to an overflow. Use try_cast
to tolerate overflow and return NULL instead. If necessary set <ansiConfig>
to “false” to bypass this error.
CAST_OVERFLOW_IN_TABLE_INSERT
Fail to insert a value of <sourceType>
type into the <targetType>
type column <columnName>
due to an overflow. Use try_cast
on the input value to tolerate overflow and return NULL instead.
COLUMN_ALREADY_EXISTS
The column <columnName>
already exists. Consider to choose another name or rename the existing column.
COLUMN_NOT_FOUND
The column <colName>
cannot be found. Verify the spelling and correctness of the column name according to the SQL config <caseSensitiveConfig>
.
COMPARATOR_RETURNS_NULL
SQLSTATE: none assigned
The comparator has returned a NULL for a comparison between <firstValue>
and <secondValue>
. It should return a positive integer for “greater than”, 0 for “equal” and a negative integer for “less than”. To revert to deprecated behavior where NULL is treated as 0 (equal), you must set “spark.sql.legacy.allowNullComparisonResultInArraySort” to “true”.
CONCURRENT_QUERY
SQLSTATE: none assigned
Another instance of this query was just started by a concurrent session.
CONNECT
SQLSTATE: none assigned
Generic Spark Connect error.
For more details see CONNECT
CONVERSION_INVALID_INPUT
The value <str>
(<fmt>
) cannot be converted to <targetType>
because it is malformed. Correct the value as per the syntax, or change its format. Use <suggestion>
to tolerate malformed input and return NULL instead.
CREATE_TABLE_COLUMN_OPTION_DUPLICATE
CREATE TABLE column <columnName>
specifies option “<optionName>
” more than once, which is invalid.
DATATYPE_MISMATCH
Cannot resolve <sqlExpr>
due to data type mismatch:
For more details see DATATYPE_MISMATCH
DATATYPE_MISSING_SIZE
DataType <type>
requires a length parameter, for example <type>
(10). Please specify the length.
DATA_SOURCE_NOT_FOUND
Failed to find the data source: <provider>
. Please find packages at https://spark.apache.org/third-party-projects.html
.
DATETIME_OVERFLOW
Datetime operation overflow: <operation>
.
DECIMAL_PRECISION_EXCEEDS_MAX_PRECISION
Decimal precision <precision>
exceeds max precision <maxPrecision>
.
DEFAULT_DATABASE_NOT_EXISTS
Default database <defaultDatabase>
does not exist, please create it first or change default database to <defaultDatabase>
.
DIVIDE_BY_ZERO
Division by zero. Use try_divide
to tolerate divisor being 0 and return NULL instead. If necessary set <config>
to “false” to bypass this error.
DUPLICATED_MAP_KEY
Duplicate map key <key>
was found, please check the input data. If you want to remove the duplicated keys, you can set <mapKeyDedupPolicy>
to “LAST_WIN” so that the key inserted at last takes precedence.
DUPLICATE_KEY
Found duplicate keys <keyColumn>
.
EMPTY_JSON_FIELD_VALUE
Failed to parse an empty string for data type <dataType>
.
ENCODER_NOT_FOUND
SQLSTATE: none assigned
Not found an encoder of the type <typeName>
to Spark SQL internal representation. Consider to change the input type to one of supported at ‘<docroot>
/sql-ref-datatypes.html’.
FAILED_EXECUTE_UDF
Failed to execute user defined function (<functionName>
: (<signature>
) => <result>
).
FAILED_FUNCTION_CALL
Failed preparing of the function <funcName>
for call. Please, double check function’s arguments.
FAILED_RENAME_PATH
Failed to rename <sourcePath>
to <targetPath>
as destination already exists.
FIELD_NOT_FOUND
No such struct field <fieldName>
in <fields>
.
FORBIDDEN_OPERATION
The operation <statement>
is not allowed on the <objectType>
: <objectName>
.
GENERATED_COLUMN_WITH_DEFAULT_VALUE
SQLSTATE: none assigned
A column cannot have both a default value and a generation expression but column <colName>
has default value: (<defaultValue>
) and generation expression: (<genExpr>
).
GRAPHITE_SINK_INVALID_PROTOCOL
SQLSTATE: none assigned
Invalid Graphite protocol: <protocol>
.
GRAPHITE_SINK_PROPERTY_MISSING
SQLSTATE: none assigned
Graphite sink requires ‘<property>
’ property.
GROUPING_COLUMN_MISMATCH
Column of grouping (<grouping>
) can’t be found in grouping columns <groupingColumns>
.
GROUPING_ID_COLUMN_MISMATCH
Columns of grouping_id (<groupingIdColumn>
) does not match grouping columns (<groupByColumns>
).
GROUPING_SIZE_LIMIT_EXCEEDED
Grouping sets size cannot be greater than <maxSize>
.
GROUP_BY_AGGREGATE
Aggregate functions are not allowed in GROUP BY, but found <sqlExpr>
.
GROUP_BY_POS_AGGREGATE
GROUP BY <index>
refers to an expression <aggExpr>
that contains an aggregate function. Aggregate functions are not allowed in GROUP BY.
GROUP_BY_POS_OUT_OF_RANGE
GROUP BY position <index>
is not in select list (valid range is [1, <size>
]).
IDENTIFIER_TOO_MANY_NAME_PARTS
<identifier>
is not a valid identifier as it has more than 2 name parts.
INCOMPARABLE_PIVOT_COLUMN
Invalid pivot column <columnName>
. Pivot columns must be comparable.
INCOMPATIBLE_COLUMN_TYPE
<operator>
can only be performed on tables with compatible column types. The <columnOrdinalNumber>
column of the <tableOrdinalNumber>
table is type which is not compatible with at the same column of the first table.``.
INCOMPATIBLE_DATASOURCE_REGISTER
SQLSTATE: none assigned
Detected an incompatible DataSourceRegister. Please remove the incompatible library from classpath or upgrade it. Error: <message>
INCOMPATIBLE_JOIN_TYPES
The join types and are incompatible.
INCOMPATIBLE_VIEW_SCHEMA_CHANGE
SQLSTATE: none assigned
The SQL query of view <viewName>
has an incompatible schema change and column <colName>
cannot be resolved. Expected <expectedNum>
columns named <colName>
but got <actualCols>
.
Please try to re-create the view by running: <suggestion>
.
INCOMPLETE_TYPE_DEFINITION
Incomplete complex type:
For more details see INCOMPLETE_TYPE_DEFINITION
INCONSISTENT_BEHAVIOR_CROSS_VERSION
You may get a different result due to the upgrading to
For more details see INCONSISTENT_BEHAVIOR_CROSS_VERSION
INCORRECT_END_OFFSET
Max offset with <rowsPerSecond>
rowsPerSecond is <maxSeconds>
, but it’s <endSeconds>
now.
INCORRECT_RAMP_UP_RATE
Max offset with <rowsPerSecond>
rowsPerSecond is <maxSeconds>
, but ‘rampUpTimeSeconds’ is <rampUpTimeSeconds>
.
INDEX_ALREADY_EXISTS
Cannot create the index <indexName>
on table <tableName>
because it already exists.
INDEX_NOT_FOUND
Cannot find the index <indexName>
on table <tableName>
.
INTERNAL_ERROR
<message>
INTERVAL_ARITHMETIC_OVERFLOW
<message>
.<alternative>
INTERVAL_DIVIDED_BY_ZERO
Division by zero. Use try_divide
to tolerate divisor being 0 and return NULL instead.
INVALID_ARRAY_INDEX
The index <indexValue>
is out of bounds. The array has <arraySize>
elements. Use the SQL function get()
to tolerate accessing element at invalid index and return NULL instead. If necessary set <ansiConfig>
to “false” to bypass this error.
INVALID_ARRAY_INDEX_IN_ELEMENT_AT
The index <indexValue>
is out of bounds. The array has <arraySize>
elements. Use try_element_at
to tolerate accessing element at invalid index and return NULL instead. If necessary set <ansiConfig>
to “false” to bypass this error.
INVALID_BUCKET_FILE
SQLSTATE: none assigned
Invalid bucket file: <path>
.
INVALID_BYTE_STRING
SQLSTATE: none assigned
The expected format is ByteString, but was <unsupported>
(<class>
).
INVALID_COLUMN_NAME_AS_PATH
The datasource <datasource>
cannot save the column <columnName>
because its name contains some characters that are not allowed in file paths. Please, use an alias to rename it.
INVALID_COLUMN_OR_FIELD_DATA_TYPE
Column or field <name>
is of type <type>
while it’s required to be <expectedType>
.
INVALID_EMPTY_LOCATION
The location name cannot be empty string, but <location>
was given.
INVALID_EXTRACT_BASE_FIELD_TYPE
Can’t extract a value from <base>
. Need a complex type [STRUCT, ARRAY, MAP] but got <other>
.
INVALID_EXTRACT_FIELD
Cannot extract <field>
from <expr>
.
INVALID_EXTRACT_FIELD_TYPE
Field name should be a non-null string literal, but it’s <extraction>
.
INVALID_FIELD_NAME
Field name <fieldName>
is invalid: <path>
is not a struct.
INVALID_FORMAT
The format is invalid: <format>
.
For more details see INVALID_FORMAT
INVALID_FRACTION_OF_SECOND
The fraction of sec must be zero. Valid range is [0, 60]. If necessary set <ansiConfig>
to “false” to bypass this error.
INVALID_IDENTIFIER
The identifier <ident>
is invalid. Please, consider quoting it with back-quotes as <ident>
.
INVALID_INDEX_OF_ZERO
The index 0 is invalid. An index shall be either < 0 or > 0 (the first element has index 1).
INVALID_JSON_ROOT_FIELD
Cannot convert JSON root field to target Spark type.
INVALID_JSON_SCHEMA_MAP_TYPE
Input schema <jsonSchema>
can only contain STRING as a key type for a MAP.
INVALID_LATERAL_JOIN_TYPE
The <joinType>
JOIN with LATERAL correlation is not allowed because an OUTER subquery cannot correlate to its join partner. Remove the LATERAL correlation or use an INNER JOIN, or LEFT OUTER JOIN instead.
INVALID_OPTIONS
Invalid options:
For more details see INVALID_OPTIONS
INVALID_PANDAS_UDF_PLACEMENT
The group aggregate pandas UDF <functionList>
cannot be invoked together with as other, non-pandas aggregate functions.
INVALID_PARAMETER_VALUE
The value of parameter(s) <parameter>
in <functionName>
is invalid:
For more details see INVALID_PARAMETER_VALUE
INVALID_PROPERTY_KEY
<key>
is an invalid property key, please use quotes, e.g. SET <key>
\=<value>
.
INVALID_PROPERTY_VALUE
<value>
is an invalid property value, please use quotes, e.g. SET <key>
\=<value>
INVALID_SCHEMA
The input schema <inputSchema>
is not a valid schema string.
For more details see INVALID_SCHEMA
INVALID_SET_SYNTAX
Expected format is ‘SET’, ‘SET key’, or ‘SET key=value’. If you want to include special characters in key, or include semicolon in value, please use backquotes, e.g., SET key
\=value
.
INVALID_SQL_ARG
SQLSTATE: none assigned
The argument <name>
of sql()
is invalid. Consider to replace it by a SQL literal.
INVALID_SQL_SYNTAX
Invalid SQL syntax: <inputString>
.
INVALID_SUBQUERY_EXPRESSION
Invalid subquery:
For more details see INVALID_SUBQUERY_EXPRESSION
INVALID_TEMP_OBJ_REFERENCE
SQLSTATE: none assigned
Cannot create the persistent object <objName>
of the type <obj>
because it references to the temporary object <tempObjName>
of the type <tempObj>
. Please make the temporary object <tempObjName>
persistent, or make the persistent object <objName>
temporary.
INVALID_TYPED_LITERAL
The value of the typed literal <valueType>
is invalid: <value>
.
INVALID_WHERE_CONDITION
The WHERE condition <condition>
contains invalid expressions: <expressionList>
.
Rewrite the query to avoid window functions, aggregate functions, and generator functions in the WHERE clause.
LOCATION_ALREADY_EXISTS
Cannot name the managed table as <identifier>
, as its associated location <location>
already exists. Please pick a different table name, or remove the existing location first.
MALFORMED_CSV_RECORD
SQLSTATE: none assigned
Malformed CSV record: <badRecord>
MALFORMED_PROTOBUF_MESSAGE
SQLSTATE: none assigned
Malformed Protobuf messages are detected in message deserialization. Parse Mode: <failFastMode>
. To process malformed protobuf message as null result, try setting the option ‘mode’ as ‘PERMISSIVE’.
MALFORMED_RECORD_IN_PARSING
SQLSTATE: none assigned
Malformed records are detected in record parsing: <badRecord>
.
Parse Mode: <failFastMode>
. To process malformed records as null result, try setting the option ‘mode’ as ‘PERMISSIVE’.
MISSING_AGGREGATION
The non-aggregating expression <expression>
is based on columns which are not participating in the GROUP BY clause.
Add the columns or the expression to the GROUP BY, aggregate the expression, or use <expressionAnyValue>
if you do not care which of the values within a group is returned.
MISSING_GROUP_BY
The query does not include a GROUP BY clause. Add GROUP BY or turn it into the window functions using OVER clauses.
MULTI_UDF_INTERFACE_ERROR
SQLSTATE: none assigned
Not allowed to implement multiple UDF interfaces, UDF class <className>
.
NESTED_AGGREGATE_FUNCTION
It is not allowed to use an aggregate function in the argument of another aggregate function. Please use the inner aggregate function in a sub-query.
NON_LAST_MATCHED_CLAUSE_OMIT_CONDITION
When there are more than one MATCHED clauses in a MERGE statement, only the last MATCHED clause can omit the condition.
NON_LAST_NOT_MATCHED_BY_SOURCE_CLAUSE_OMIT_CONDITION
When there are more than one NOT MATCHED BY SOURCE clauses in a MERGE statement, only the last NOT MATCHED BY SOURCE clause can omit the condition.
NON_LAST_NOT_MATCHED_BY_TARGET_CLAUSE_OMIT_CONDITION
When there are more than one NOT MATCHED [BY TARGET] clauses in a MERGE statement, only the last NOT MATCHED [BY TARGET] clause can omit the condition.
NON_LITERAL_PIVOT_VALUES
Literal expressions required for pivot values, found <expression>
.
NON_PARTITION_COLUMN
PARTITION clause cannot contain the non-partition column: <columnName>
.
NOT_A_PARTITIONED_TABLE
SQLSTATE: none assigned
Operation <operation>
is not allowed for <tableIdentWithDB>
because it is not a partitioned table.
NOT_NULL_CONSTRAINT_VIOLATION
Assigning a NULL is not allowed here.
For more details see NOT_NULL_CONSTRAINT_VIOLATION
NO_HANDLER_FOR_UDAF
SQLSTATE: none assigned
No handler for UDAF ‘<functionName>
’. Use sparkSession.udf.register(…) instead.
NO_SQL_TYPE_IN_PROTOBUF_SCHEMA
SQLSTATE: none assigned
Cannot find <catalystFieldPath>
in Protobuf schema.
NO_UDF_INTERFACE
SQLSTATE: none assigned
UDF class <className>
doesn’t implement any UDF interface.
NULLABLE_COLUMN_OR_FIELD
Column or field <name>
is nullable while it’s required to be non-nullable.
NULLABLE_ROW_ID_ATTRIBUTES
Row ID attributes cannot be nullable: <nullableRowIdAttrs>
.
NULL_MAP_KEY
Cannot use null as map key.
NUMERIC_OUT_OF_SUPPORTED_RANGE
The value <value>
cannot be interpreted as a numeric since it has more than 38 digits.
NUMERIC_VALUE_OUT_OF_RANGE
<value>
cannot be represented as Decimal(<precision>
, <scale>
). If necessary set <config>
to “false” to bypass this error, and return NULL instead.
NUM_COLUMNS_MISMATCH
<operator>
can only be performed on inputs with the same number of columns, but the first input has <firstNumColumns>
columns and the <invalidOrdinalNum>
input has <invalidNumColumns>
columns.
ORDER_BY_POS_OUT_OF_RANGE
ORDER BY position <index>
is not in select list (valid range is [1, <size>
]).
PARSE_EMPTY_STATEMENT
Syntax error, unexpected empty statement.
PARSE_SYNTAX_ERROR
Syntax error at or near <error>``<hint>
.
PARTITIONS_ALREADY_EXIST
Cannot ADD or RENAME TO partition(s) <partitionList>
in table <tableName>
because they already exist.
Choose a different name, drop the existing partition, or add the IF NOT EXISTS clause to tolerate a pre-existing partition.
PARTITIONS_NOT_FOUND
The partition(s) <partitionList>
cannot be found in table <tableName>
.
Verify the partition specification and table name.
To tolerate the error on drop use ALTER TABLE … DROP IF EXISTS PARTITION.
PATH_ALREADY_EXISTS
Path <outputPath>
already exists. Set mode as “overwrite” to overwrite the existing path.
PATH_NOT_FOUND
Path does not exist: <path>
.
PIVOT_VALUE_DATA_TYPE_MISMATCH
Invalid pivot value ‘<value>
’: value data type <valueType>
does not match pivot column data type <pivotType>
.
PLAN_VALIDATION_FAILED_RULE_EXECUTOR
SQLSTATE: none assigned
The input plan of <ruleExecutor>
is invalid: <reason>
PLAN_VALIDATION_FAILED_RULE_IN_BATCH
SQLSTATE: none assigned
Rule <rule>
in batch <batch>
generated an invalid plan: <reason>
PROTOBUF_DEPENDENCY_NOT_FOUND
SQLSTATE: none assigned
Could not find dependency: <dependencyName>
.
PROTOBUF_DESCRIPTOR_FILE_NOT_FOUND
SQLSTATE: none assigned
Error reading Protobuf descriptor file at path: <filePath>
.
PROTOBUF_FIELD_MISSING
SQLSTATE: none assigned
Searching for <field>
in Protobuf schema at <protobufSchema>
gave <matchSize>
matches. Candidates: <matches>
.
PROTOBUF_FIELD_MISSING_IN_SQL_SCHEMA
SQLSTATE: none assigned
Found <field>
in Protobuf schema but there is no match in the SQL schema.
PROTOBUF_FIELD_TYPE_MISMATCH
SQLSTATE: none assigned
Type mismatch encountered for field: <field>
.
PROTOBUF_MESSAGE_NOT_FOUND
SQLSTATE: none assigned
Unable to locate Message <messageName>
in Descriptor.
PROTOBUF_TYPE_NOT_SUPPORT
SQLSTATE: none assigned
Protobuf type not yet supported: <protobufType>
.
RECURSIVE_PROTOBUF_SCHEMA
SQLSTATE: none assigned
Found recursive reference in Protobuf schema, which can not be processed by Spark by default: <fieldDescriptor>
. try setting the option recursive.fields.max.depth
0 to 10. Going beyond 10 levels of recursion is not allowed.
RENAME_SRC_PATH_NOT_FOUND
Failed to rename as <sourcePath>
was not found.
REPEATED_CLAUSE
The <clause>
clause may be used at most once per <operation>
operation.
REQUIRES_SINGLE_PART_NAMESPACE
<sessionCatalog>
requires a single-part namespace, but got <namespace>
.
ROUTINE_ALREADY_EXISTS
Cannot create the function <routineName>
because it already exists.
Choose a different name, drop or replace the existing function, or add the IF NOT EXISTS clause to tolerate a pre-existing function.
ROUTINE_NOT_FOUND
The function <routineName>
cannot be found. Verify the spelling and correctness of the schema and catalog.
If you did not qualify the name with a schema and catalog, verify the current_schema() output, or qualify the name with the correct schema and catalog.
To tolerate the error on drop use DROP FUNCTION IF EXISTS.
SCALAR_SUBQUERY_TOO_MANY_ROWS
More than one row returned by a subquery used as an expression.
SCHEMA_ALREADY_EXISTS
Cannot create schema <schemaName>
because it already exists.
Choose a different name, drop the existing schema, or add the IF NOT EXISTS clause to tolerate pre-existing schema.
SCHEMA_NOT_EMPTY
Cannot drop a schema <schemaName>
because it contains objects.
Use DROP SCHEMA … CASCADE to drop the schema and all its objects.
SCHEMA_NOT_FOUND
The schema <schemaName>
cannot be found. Verify the spelling and correctness of the schema and catalog.
If you did not qualify the name with a catalog, verify the current_schema() output, or qualify the name with the correct catalog.
To tolerate the error on drop use DROP SCHEMA IF EXISTS.
SECOND_FUNCTION_ARGUMENT_NOT_INTEGER
The second argument of <functionName>
function needs to be an integer.
SORT_BY_WITHOUT_BUCKETING
SQLSTATE: none assigned
sortBy must be used together with bucketBy.
STAR_GROUP_BY_POS
Star (*) is not allowed in a select list when GROUP BY an ordinal position is used.
STATIC_PARTITION_COLUMN_IN_INSERT_COLUMN_LIST
SQLSTATE: none assigned
Static partition column <staticName>
is also specified in the column list.
STREAM_FAILED
SQLSTATE: none assigned
Query [id = <id>
, runId = <runId>
] terminated with exception: <message>
TABLE_OR_VIEW_ALREADY_EXISTS
Cannot create table or view <relationName>
because it already exists.
Choose a different name, drop or replace the existing object, or add the IF NOT EXISTS clause to tolerate pre-existing objects.
TABLE_OR_VIEW_NOT_FOUND
The table or view <relationName>
cannot be found. Verify the spelling and correctness of the schema and catalog.
If you did not qualify the name with a schema, verify the current_schema() output, or qualify the name with the correct schema and catalog.
To tolerate the error on drop use DROP VIEW IF EXISTS or DROP TABLE IF EXISTS.
TASK_WRITE_FAILED
SQLSTATE: none assigned
Task failed while writing rows to <path>
.
TEMP_TABLE_OR_VIEW_ALREADY_EXISTS
Cannot create the temporary view <relationName>
because it already exists.
Choose a different name, drop or replace the existing view, or add the IF NOT EXISTS clause to tolerate pre-existing views.
TEMP_VIEW_NAME_TOO_MANY_NAME_PARTS
CREATE TEMPORARY VIEW or the corresponding Dataset APIs only accept single-part view names, but got: <actualName>
.
TOO_MANY_ARRAY_ELEMENTS
Cannot initialize array with <numElements>
elements of size <size>
.
UNABLE_TO_ACQUIRE_MEMORY
Unable to acquire <requestedBytes>
bytes of memory, got <receivedBytes>
.
UNABLE_TO_CONVERT_TO_PROTOBUF_MESSAGE_TYPE
SQLSTATE: none assigned
Unable to convert SQL type <toType>
to Protobuf type <protobufType>
.
UNABLE_TO_INFER_SCHEMA
Unable to infer schema for <format>
. It must be specified manually.
UNBOUND_SQL_PARAMETER
Found the unbound parameter: <name>
. Please, fix args
and provide a mapping of the parameter to a SQL literal.
UNCLOSED_BRACKETED_COMMENT
Found an unclosed bracketed comment. Please, append */ at the end of the comment.
UNEXPECTED_INPUT_TYPE
Parameter <paramIndex>
of function <functionName>
requires the <requiredType>
type, however <inputSql>
has the type <inputType>
.
UNKNOWN_PROTOBUF_MESSAGE_TYPE
SQLSTATE: none assigned
Attempting to treat <descriptorName>
as a Message, but it was <containingType>
.
UNPIVOT_REQUIRES_ATTRIBUTES
UNPIVOT requires all given <given>
expressions to be columns when no <empty>
expressions are given. These are not columns: [<expressions>
].
UNPIVOT_REQUIRES_VALUE_COLUMNS
At least one value column needs to be specified for UNPIVOT, all columns specified as ids.
UNPIVOT_VALUE_DATA_TYPE_MISMATCH
Unpivot value columns must share a least common type, some types do not: [<types>
].
UNPIVOT_VALUE_SIZE_MISMATCH
All unpivot value columns must have the same size as there are value column names (<names>
).
UNRECOGNIZED_SQL_TYPE
Unrecognized SQL type <typeName>
.
UNRESOLVED_ALL_IN_GROUP_BY
Cannot infer grouping columns for GROUP BY ALL based on the select clause. Please explicitly specify the grouping columns.
UNRESOLVED_COLUMN
A column or function parameter with name <objectName>
cannot be resolved.
For more details see UNRESOLVED_COLUMN
UNRESOLVED_FIELD
A field with name <fieldName>
cannot be resolved with the struct-type column <columnPath>
.
For more details see UNRESOLVED_FIELD
UNRESOLVED_MAP_KEY
Cannot resolve column <objectName>
as a map key. If the key is a string literal, add the single quotes ‘’ around it.
For more details see UNRESOLVED_MAP_KEY
UNRESOLVED_ROUTINE
Cannot resolve function <routineName>
on search path <searchPath>
.
UNRESOLVED_USING_COLUMN_FOR_JOIN
USING column <colName>
cannot be resolved on the <side>
side of the join. The <side>
-side columns: [<suggestion>
].
UNSUPPORTED_ARROWTYPE
Unsupported arrow type <typeName>
.
UNSUPPORTED_DATASOURCE_FOR_DIRECT_QUERY
SQLSTATE: none assigned
Unsupported data source type for direct query on files: <dataSourceType>
UNSUPPORTED_DATATYPE
Unsupported data type <typeName>
.
UNSUPPORTED_DESERIALIZER
The deserializer is not supported:
For more details see UNSUPPORTED_DESERIALIZER
UNSUPPORTED_EXPRESSION_GENERATED_COLUMN
SQLSTATE: none assigned
Cannot create generated column <fieldName>
with generation expression <expressionStr>
because <reason>
.
UNSUPPORTED_EXPR_FOR_OPERATOR
SQLSTATE: none assigned
A query operator contains one or more unsupported expressions. Consider to rewrite it to avoid window functions, aggregate functions, and generator functions in the WHERE clause.
Invalid expressions: [<invalidExprSqls>
]
UNSUPPORTED_EXPR_FOR_WINDOW
Expression <sqlExpr>
not supported within a window function.
UNSUPPORTED_FEATURE
The feature is not supported:
For more details see UNSUPPORTED_FEATURE
UNSUPPORTED_GENERATOR
The generator is not supported:
For more details see UNSUPPORTED_GENERATOR
UNSUPPORTED_GROUPING_EXPRESSION
SQLSTATE: none assigned
grouping()/grouping_id() can only be used with GroupingSets/Cube/Rollup.
UNSUPPORTED_SAVE_MODE
SQLSTATE: none assigned
The save mode <saveMode>
is not supported for:
For more details see UNSUPPORTED_SAVE_MODE
UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY
Unsupported subquery expression:
For more details see UNSUPPORTED_SUBQUERY_EXPRESSION_CATEGORY
UNSUPPORTED_TYPED_LITERAL
Literals of the type <unsupportedType>
are not supported. Supported types are <supportedTypes>
.
UNTYPED_SCALA_UDF
SQLSTATE: none assigned
You’re using untyped Scala UDF, which does not have the input type information. Spark may blindly pass null to the Scala closure with primitive-type argument, and the closure will see the default value of the Java type for the null argument, e.g. udf((x: Int) => x, IntegerType)
, the result is 0 for null input. To get rid of this error, you could:
use typed Scala UDF APIs(without return type parameter), e.g.
udf((x: Int) => x)
.use Java UDF APIs, e.g.
udf(new UDF1[String, Integer] { override def call(s: String): Integer = s.length() }, IntegerType)
, if input types are all non primitive.set “spark.sql.legacy.allowUntypedScalaUDF” to “true” and use this API with caution.
VIEW_ALREADY_EXISTS
Cannot create view <relationName>
because it already exists.
Choose a different name, drop or replace the existing object, or add the IF NOT EXISTS clause to tolerate pre-existing objects.
VIEW_NOT_FOUND
The view <relationName>
cannot be found. Verify the spelling and correctness of the schema and catalog.
If you did not qualify the name with a schema, verify the current_schema() output, or qualify the name with the correct schema and catalog.
To tolerate the error on drop use DROP VIEW IF EXISTS.
WRITE_STREAM_NOT_ALLOWED
SQLSTATE: none assigned
writeStream
can be called only on streaming Dataset/DataFrame.
WRONG_COMMAND_FOR_OBJECT_TYPE
SQLSTATE: none assigned
The operation <operation>
requires a <requiredType>
. But <objectName>
is a <foundType>
. Use <alternative>
instead.
WRONG_NUM_ARGS
The <functionName>
requires <expectedNum>
parameters but the actual number is <actualNum>
.
For more details see WRONG_NUM_ARGS