pg8000.errors — pg8000 errors
pg8000 uses the standard DBAPI 2.0 exception tree as “generic” exceptions.
Generally, more specific exception types will be raised; these specific
exception types will be derived from the generic exceptions.
Generic Exception Classes
-
exception pg8000.errors.Warning(exceptions.StandardError)
- Generic exception raised for important database warnings like data
truncations. This exception is not currently used by pg8000.
-
exception pg8000.errors.Error(exceptions.StandardError)
- Generic exception that is the base exception of all other error exceptions.
-
exception pg8000.errors.InterfaceError(Error)
- Generic exception raised for errors that are related to the database
interface rather than the database itself. For example, if the interface
attempts to use an SSL connection but the server refuses, an InterfaceError
will be raised.
-
exception pg8000.errors.DatabaseError(Error)
- Generic exception raised for errors that are related to the database. This
exception is currently never raised by pg8000.
-
exception pg8000.errors.InternalError(DatabaseError)
- Generic exception raised when the database encounters an internal error.
This is currently only raised when unexpected state occurs in the pg8000
interface itself, and is typically the result of a interface bug.
-
exception pg8000.errors.OperationalError(DatabaseError)
- Generic exception raised for errors that are related to the database’s
operation and not necessarily under the control of the programmer. This
exception is currently never raised by pg8000.
-
exception pg8000.errors.ProgrammingError(DatabaseError)
- Generic exception raised for programming errors. For example, this
exception is raised if more parameter fields are in a query string than
there are available parameters.
-
exception pg8000.errors.IntegrityError(DatabaseError)
- Generic exception raised when the relational integrity of the database is
affected. This exception is not currently raised by pg8000.
-
exception pg8000.errors.DataError(DatabaseError)
- Generic exception raised for errors that are due to problems with the
processed data. This exception is not currently raised by pg8000.
-
exception pg8000.errors.NotSupportedError(DatabaseError)
- Generic exception raised in case a method or database API was used which is
not supported by the database.
Specific Exception Classes
-
exception pg8000.errors.ConnectionClosedError(InterfaceError)
- Raised when an attempt to use a connection fails due to the connection
being closed.
-
exception pg8000.errors.CursorClosedError(InterfaceError)
- Raised when an attempt to use a cursor fails due to the cursor
being closed.
-
exception pg8000.errors.ArrayDataParseError(InternalError)
- An exception that is raised when an internal error occurs trying to decode
binary array data received from the server. This shouldn’t occur unless
changes to the binary wire format for arrays occur between PostgreSQL
releases.
-
exception pg8000.errors.ArrayContentNotSupportedError(NotSupportedError)
- Raised when attempting to transmit an array where the base type is not
supported for binary data transfer by the interface.
-
exception pg8000.errors.ArrayContentNotHomogenousError(ProgrammingError)
- Raised when attempting to transmit an array that doesn’t contain only a
single type of object.
-
exception pg8000.errors.ArrayContentEmptyError(ProgrammingError)
- Raised when attempting to transmit an empty array. The type oid of an
empty array cannot be determined, and so sending them is not permitted.
-
exception pg8000.errors.ArrayDimensionsNotConsistentError(ProgrammingError)
- Raised when attempting to transmit an array that has inconsistent
multi-dimension sizes.
-
exception pg8000.errors.CopyQueryOrTableRequiredError(ProgrammingError)
Raised when copy_to() or
copy_from() are called without specifying
the table or query keyword parameters.
New in version 1.07.
-
exception pg8000.errors.CopyQueryWithoutStreamError(ProgrammingError)
Raised when execute() is used to execute
a COPY ... query, rather than
copy_to() or
copy_from().
New in version 1.07.
-
exception pg8000.errors.QueryParameterIndexError(ProgrammingError)
Raised when parameters in queries can’t be matched with provided parameter
values.
New in version 1.07.
-
exception pg8000.errors.QueryParameterParseError(ProgrammingError)
A parsing error occurred while trying to parse parameters in a query.
New in version 1.07.