Error classes in PySpark

This is a list of common, named error classes returned by PySpark which are defined at error_classes.py.

When writing PySpark errors, developers must use an error class from the list. If an appropriate error class is not available, add a new one into the list. For more information, please refer to Contributing Error and Exception.

Error class

Error message

ARGUMENT_REQUIRED

Argument <arg_name> is required when <condition>.

COLUMN_IN_LIST

<func_name> does not allow a Column in a list.

DISALLOWED_TYPE_FOR_CONTAINER

Argument <arg_name>`(`type: <arg_type>) should only contain a type in [<allowed_types>], got <return_type>

HIGHER_ORDER_FUNCTION_SHOULD_RETURN_COLUMN

Function <func_name> should return Column, got <return_type>.

NOT_BOOL

Argument <arg_name> should be a bool, got <arg_type>.

NOT_BOOL_OR_DICT_OR_FLOAT_OR_INT_OR_LIST_OR_STR_OR_TUPLE

Argument <arg_name> should be a bool, dict, float, int, str or tuple, got <arg_type>.

NOT_BOOL_OR_DICT_OR_FLOAT_OR_INT_OR_STR

Argument <arg_name> should be a bool, dict, float, int or str, got <arg_type>.

NOT_BOOL_OR_LIST

Argument <arg_name> should be a bool or list, got <arg_type>.

NOT_BOOL_OR_STR

Argument <arg_name> should be a bool or str, got <arg_type>.

NOT_COLUMN

Argument <arg_name> should be a Column, got <arg_type>.

NOT_COLUMN_OR_DATATYPE_OR_STR

Argument <arg_name> should be a Column, str or DataType, but got <arg_type>.

NOT_COLUMN_OR_FLOAT_OR_INT_OR_LIST_OR_STR

Argument <arg_name> should be a column, float, integer, list or string, got <arg_type>.

NOT_COLUMN_OR_INT

Argument <arg_name> should be a Column or int, got <arg_type>.

NOT_COLUMN_OR_INT_OR_STR

Argument <arg_name> should be a Column, int or str, got <arg_type>.

NOT_COLUMN_OR_STR

Argument <arg_name> should be a Column or str, got <arg_type>.

NOT_DATAFRAME

Argument <arg_name> should be a DataFrame, got <arg_type>.

NOT_DATATYPE_OR_STR

Argument <arg_name> should be a DataType or str, got <arg_type>.

NOT_DICT

Argument <arg_name> should be a dict, got <arg_type>.

NOT_EXPRESSION

Argument <arg_name> should be a Expression, got <arg_type>.

NOT_FLOAT_OR_INT

Argument <arg_name> should be a float or int, got <arg_type>.

NOT_FLOAT_OR_INT_OR_LIST_OR_STR

Argument <arg_name> should be a float, int, list or str, got <arg_type>.

NOT_INT

Argument <arg_name> should be an int, got <arg_type>.

NOT_ITERABLE

<objectName> is not iterable.

NOT_LIST_OR_STR_OR_TUPLE

Argument <arg_name> should be a list, str or tuple, got <arg_type>.

NOT_LIST_OR_TUPLE

Argument <arg_name> should be a list or tuple, got <arg_type>.

NOT_SAME_TYPE

Argument <arg_name1> and <arg_name2> should be the same type, got <arg_type1> and <arg_type2>.

NOT_STR

Argument <arg_name> should be a str, got <arg_type>.

NOT_WINDOWSPEC

Argument <arg_name> should be a WindowSpec, got <arg_type>.

UNSUPPORTED_NUMPY_ARRAY_SCALAR

The type of array scalar ‘<dtype>’ is not supported.

UNSUPPORTED_PARAM_TYPE_FOR_HIGHER_ORDER_FUNCTION

Function <func_name> should use only POSITIONAL or POSITIONAL OR KEYWORD arguments.

WRONG_NUM_ARGS_FOR_HIGHER_ORDER_FUNCTION

Function <func_name> should take between 1 and 3 arguments, but provided function takes <num_args>.

WRONG_NUM_COLUMNS

Function <func_name> should take at least <num_cols> columns.