adbc_driver_manager¶
底层 API¶
适用于 Python 的底层 ADBC 绑定。
根模块提供了与 Python 中的 C API 定义相当直接的 1:1 映射。对于更高级别的接口,请使用 adbc_driver_manager.dbapi。(这需要 PyArrow。)
常量和枚举¶
- class adbc_driver_manager.AdbcStatusCode(*values)¶
基类:
IntEnum指示错误类型的状态码。
- ALREADY_EXISTS = 4¶
- CANCELLED = 11¶
- INTEGRITY = 8¶
- INTERNAL = 9¶
- INVALID_ARGUMENT = 5¶
- INVALID_DATA = 7¶
- INVALID_STATE = 6¶
- IO = 10¶
- NOT_FOUND = 3¶
- NOT_IMPLEMENTED = 2¶
- OK = 0¶
- TIMEOUT = 12¶
- UNAUTHENTICATED = 13¶
- UNAUTHORIZED = 14¶
- UNKNOWN = 1¶
- class adbc_driver_manager.GetObjectsDepth(*values)¶
基类:
IntEnumadbc_get_objects 要获取多少数据。
- ALL = 0¶
- CATALOGS = 1¶
- COLUMNS = 0¶
- DB_SCHEMAS = 2¶
- TABLES = 3¶
- class adbc_driver_manager.ConnectionOptions(*values)¶
基类:
Enum在驱动程序之间标准化的连接选项。
并非所有驱动程序都支持所有选项。
- CURRENT_CATALOG = 'adbc.connection.catalog'¶
获取/设置当前目录。
- CURRENT_DB_SCHEMA = 'adbc.connection.db_schema'¶
获取/设置当前模式。
- ISOLATION_LEVEL = 'adbc.connection.transaction.isolation_level'¶
设置事务隔离级别。
- class adbc_driver_manager.DatabaseOptions(*values)¶
基类:
Enum在驱动程序之间标准化的数据库选项。
并非所有驱动程序都支持所有选项。
- PASSWORD = 'password'¶
设置用于用户名-密码认证的密码。
- URI = 'uri'¶
要连接的 URI。
- USERNAME = 'username'¶
设置用于用户名-密码认证的用户名。
- class adbc_driver_manager.StatementOptions(*values)¶
基类:
Enum在驱动程序之间标准化的语句选项。
并非所有驱动程序都支持所有选项。
- BIND_BY_NAME = 'adbc.statement.bind_by_name'¶
按名称而非位置绑定参数。
- INCREMENTAL = 'adbc.statement.exec.incremental'¶
在 ExecutePartitions 上启用增量执行。
- INGEST_MODE = 'adbc.ingest.mode'¶
对于批量摄取,是创建表还是追加到表。
- INGEST_TARGET_CATALOG = 'adbc.ingest.target_catalog'¶
对于批量摄取,用于创建/定位表的目录。此 API 仍处于试验阶段。
- INGEST_TARGET_DB_SCHEMA = 'adbc.ingest.target_db_schema'¶
对于批量摄取,用于创建/定位表的模式。此 API 仍处于试验阶段。
- INGEST_TARGET_TABLE = 'adbc.ingest.target_table'¶
对于批量摄取,要摄取到的表。
- INGEST_TEMPORARY = 'adbc.ingest.temporary'¶
对于批量摄取,使用临时表。此 API 仍处于试验阶段。
- PROGRESS = 'adbc.statement.exec.progress'¶
获取查询进度。
- adbc_driver_manager.INGEST_OPTION_MODE¶
批量摄取时,是追加到现有表还是创建新表。
- adbc_driver_manager.INGEST_OPTION_MODE_APPEND¶
批量摄取时追加到表。
- adbc_driver_manager.INGEST_OPTION_MODE_CREATE¶
批量摄取时创建新表。
- adbc_driver_manager.INGEST_OPTION_TARGET_TABLE¶
批量摄取时要创建/追加到的表。
类¶
- class adbc_driver_manager.AdbcConnection¶
基类:
_AdbcHandle活动数据库连接。
连接不是线程安全的,客户端应注意序列化对连接的访问。
- 参数:
- databaseAdbcDatabase
要连接的数据库。
- kwargsdict
要传递给底层数据库的字符串键值选项。
方法
cancel()尝试取消连接上任何正在进行的操作。
close()释放连接句柄。
commit()提交当前事务。
get_info([info_codes])获取数据库/驱动程序的元数据。
get_objects(depth[, catalog, db_schema, ...])获取数据库对象的层次结构视图。
get_option(key, *[, encoding, errors])获取字符串选项的值。
get_option_bytes(key)获取二进制选项的值。
get_option_float(key)获取浮点选项的值。
get_option_int(key)获取整数选项的值。
get_table_schema(catalog, db_schema, table_name)获取表的 Arrow 模式。
获取支持的表类型列表。
read_partition(partition)从 execute_partitions 获取单个分区。
rollback()回滚当前事务。
set_autocommit(enabled)切换是否启用自动提交。
set_options(**kwargs)设置任意键值选项。
- get_info(info_codes=None) ArrowArrayStreamHandle¶
获取数据库/驱动程序的元数据。
- get_objects(depth, catalog=None, db_schema=None, table_name=None, table_types=None, column_name=None) ArrowArrayStreamHandle¶
获取数据库对象的层次结构视图。
- get_option(key: str | bytes, *, encoding='utf-8', errors='strict') str¶
获取字符串选项的值。
- 参数:
- keystr 或 bytes
要获取的选项。
- encodingstr
选项值的编码。这几乎总是 UTF-8。
- errorsstr
解码选项值时如何处理错误(参见 bytes.decode)。
- get_table_schema(catalog, db_schema, table_name) ArrowSchemaHandle¶
获取表的 Arrow 模式。
- 返回:
- ArrowSchemaHandle
包含模式的 C 数据接口 ArrowSchema 结构体。
- get_table_types() ArrowArrayStreamHandle¶
获取支持的表类型列表。
- read_partition(partition) ArrowArrayStreamHandle¶
从 execute_partitions 获取单个分区。
- class adbc_driver_manager.AdbcDatabase¶
基类:
_AdbcHandle数据库实例。
- 参数:
- kwargsdict
要传递给底层数据库的字符串键值选项。必须至少包含“driver”以标识要加载的底层数据库驱动程序。
方法
close()释放数据库句柄。
get_option(key, *[, encoding, errors])获取字符串选项的值。
get_option_bytes(key)获取二进制选项的值。
get_option_float(key)获取浮点选项的值。
get_option_int(key)获取整数选项的值。
set_options(**kwargs)设置任意键值选项。
- get_option(key: str | bytes, *, encoding='utf-8', errors='strict') str¶
获取字符串选项的值。
- 参数:
- keystr 或 bytes
要获取的选项。
- encodingstr
选项值的编码。这几乎总是 UTF-8。
- errorsstr
解码选项值时如何处理错误(参见 bytes.decode)。
- class adbc_driver_manager.AdbcStatement¶
基类:
_AdbcHandle数据库语句。
语句不是线程安全的,客户端应注意序列化对连接的访问。
- 参数:
- connectionAdbcConnection
用于创建语句的连接。
方法
bind(data[, schema])将 ArrowArray 绑定到此语句。
bind_stream(stream)将 ArrowArrayStream 绑定到此语句。
cancel()尝试取消连接上任何正在进行的操作。
close()释放语句句柄。
执行查询并获取结果集的分区。
执行查询并获取结果集。
不执行查询即可获取结果集的模式。
执行不带结果集的查询。
get_option(key, *[, encoding, errors])获取字符串选项的值。
get_option_bytes(key)获取二进制选项的值。
get_option_float(key)获取浮点选项的值。
get_option_int(key)获取整数选项的值。
获取绑定参数的 Arrow 模式。
prepare()将此语句转换为预处理语句。
set_options(**kwargs)仅为此语句设置任意键值选项。
set_sql_query(query)设置要执行的 SQL 查询。
set_substrait_plan(plan)设置要执行的 Substrait 计划。
- bind(data, schema=None) None¶
将 ArrowArray 绑定到此语句。
- 参数:
- dataPyCapsule 或 int 或 ArrowArrayHandle
- schemaPyCapsule 或 int 或 ArrowSchemaHandle
- bind_stream(stream) None¶
将 ArrowArrayStream 绑定到此语句。
- 参数:
- streamPyCapsule 或 int 或 ArrowArrayStreamHandle
- execute_partitions() Tuple[List[bytes], ArrowSchemaHandle | None, int]¶
执行查询并获取结果集的分区。
并非所有驱动程序都支持此功能。
- 返回:
- 字节列表
分布式结果集的分区。
- ArrowSchemaHandle 或 None
结果集的模式。如果启用增量执行且服务器不返回模式,则可能为 None。
- int
如果已知,则为行数,否则为 -1。
- execute_query() Tuple[ArrowArrayStreamHandle, int]¶
执行查询并获取结果集。
- 返回:
- ArrowArrayStreamHandle
结果集。
- int
如果已知,则为行数,否则为 -1。
- execute_schema() ArrowSchemaHandle¶
不执行查询即可获取结果集的模式。
- 返回:
- ArrowSchemaHandle
结果集的模式。
- get_option(key: str | bytes, *, encoding='utf-8', errors='strict') str¶
获取字符串选项的值。
- 参数:
- keystr 或 bytes
要获取的选项。
- encodingstr
选项值的编码。这几乎总是 UTF-8。
- errorsstr
解码选项值时如何处理错误(参见 bytes.decode)。
- get_parameter_schema() ArrowSchemaHandle¶
获取绑定参数的 Arrow 模式。
此方法检索描述参数化语句中参数的数量、名称和类型的 Arrow 模式。模式的字段应按参数的序数位置排序;命名参数应只出现一次。
如果参数没有名称,或者无法确定名称,则模式中相应字段的名称将为空字符串。如果无法确定类型,则相应字段的类型将为 NA(NullType)。
应在
prepare()之后调用此方法。- 引发:
- NotSupportedError
如果无法确定模式。
- class adbc_driver_manager.ArrowArrayHandle¶
基类:
object已分配的 ArrowArray 的包装器。
此对象实现了 Arrow PyCapsule 接口。
方法
release()释放此数组,而无需导入它。
- address¶
ArrowArray 的地址。
- is_valid¶
检查有效性(对象具有非 NULL 释放指针)。
- release()¶
释放此数组,而无需导入它。
如果已释放(如果
not self.is_valid),则不执行任何操作。后置条件:
not self.is_valid。
- class adbc_driver_manager.ArrowArrayStreamHandle¶
基类:
object已分配的 ArrowArrayStream 的包装器。
此对象实现了 Arrow PyCapsule 接口。
方法
release()释放此流,而无需导入它。
- address¶
ArrowArrayStream 的地址。
- is_valid¶
检查有效性(对象具有非 NULL 释放指针)。
- release()¶
释放此流,而无需导入它。
如果已释放(如果
not self.is_valid),则不执行任何操作。后置条件:
not self.is_valid。
DBAPI 2.0 API¶
用于 ADBC Driver Manager 的 PEP 249 (DB-API 2.0) API 包装器。
PyArrow 要求¶
此模块需要 PyArrow 才能实现完整功能。如果未安装 PyArrow,则所有实际读取/写入数据的功能都将缺失。您仍然可以执行查询并将结果作为 PyCapsule 获取,但许多其他方法将引发错误。此外,DB-API 类型定义(BINARY、DATETIME 等)将存在,但无效。
资源管理¶
您必须 close() Connection 和 Cursor 对象,否则驱动程序资源可能会泄露。__del__ 已作为回退实现,但 Python 不保证此方法调用的时间。对于开发,当在 pytest 下运行或当环境变量 _ADBC_DRIVER_MANAGER_WARN_UNCLOSED_RESOURCE 设置为 1 时,__del__ 将引发 ResourceWarning。
常量和枚举¶
- adbc_driver_manager.dbapi.apilevel = '2.0'¶
DB-API API 级别 (2.0)。
- adbc_driver_manager.dbapi.paramstyle = 'qmark'¶
参数样式 (qmark)。这是硬编码的,但实际上取决于驱动程序。
- adbc_driver_manager.dbapi.threadsafety = 1¶
线程安全级别(连接可能无法共享)。
- adbc_driver_manager.dbapi.Date = <class 'datetime.date'>¶
日期值的类型。
- adbc_driver_manager.dbapi.Time = <class 'datetime.time'>¶
时间值的类型。
- adbc_driver_manager.dbapi.Timestamp(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]) = <class 'datetime.datetime'>¶
时间戳值的类型。
- adbc_driver_manager.dbapi.BINARY = frozenset({14, 35})¶
二进制列的类型。
- adbc_driver_manager.dbapi.DATETIME = frozenset({16, 17, 18, 19, 20})¶
日期时间列的类型。
- adbc_driver_manager.dbapi.NUMBER = frozenset({2, 3, 4, 5, 6, 7, 8, 9, 11, 12})¶
数字列的类型。
- adbc_driver_manager.dbapi.ROWID = frozenset({9})¶
“行 ID”列的类型。
- adbc_driver_manager.dbapi.STRING = frozenset({13, 34})¶
字符串列的类型。
函数¶
- adbc_driver_manager.dbapi.connect(*, driver: str | Path, entrypoint: str | None = None, db_kwargs: Dict[str, str | Path] | None = None, conn_kwargs: Dict[str, str] | None = None, autocommit=False) Connection¶
通过 ADBC 连接到数据库。
- 参数:
- driver
驱动程序名称。例如,“adbc_driver_sqlite”将尝试在 Linux 系统上加载 libadbc_driver_sqlite.so,在 MacOS 上加载 libadbc_driver_sqlite.dylib,在 Windows 上加载 adbc_driver_sqlite.dll。这也可以是要加载的库的路径。
- 入口点
驱动程序特定的入口点,如果与默认值不同。
- db_kwargs
要传递给驱动程序以初始化数据库的键值参数。
- conn_kwargs
要传递给驱动程序以初始化连接的键值参数。
- autocommit
是否启用自动提交。为了符合 DB-API,此功能默认禁用。如果无法禁用,将发出警告。
类¶
- class adbc_driver_manager.dbapi.Connection(db: AdbcDatabase | _SharedDatabase, conn: AdbcConnection, conn_kwargs: Dict[str, str] | None = None, *, autocommit=False, backend: DbapiBackend | None = None)¶
基类:
_CloseableDB-API 2.0 (PEP 249) 连接。
请勿直接创建此对象;请使用 connect()。
- 属性:
adbc_connection获取底层 ADBC 连接。
adbc_current_catalog当前目录的名称。
adbc_current_db_schema当前模式的名称。
adbc_database获取底层 ADBC 数据库。
方法
取消此连接上任何正在进行的操作。
创建共享相同底层数据库的新连接。
获取有关数据库和驱动程序的元数据。
adbc_get_objects(*[, depth, catalog_filter, ...])列出目录、模式、表等。
adbc_get_table_schema(table_name, *[, ...])按名称获取表的 Arrow 模式。
列出服务器知道的表类型。
close()关闭连接。
commit()显式提交。
cursor(*[, adbc_stmt_kwargs])创建用于查询数据库的新游标。
rollback()显式回滚。
- adbc_clone() Connection¶
创建共享相同底层数据库的新连接。
备注
这是一个扩展,不属于 DBAPI 标准。
- property adbc_connection: AdbcConnection¶
获取底层 ADBC 连接。
备注
这是一个扩展,不属于 DBAPI 标准。
- property adbc_database: AdbcDatabase¶
获取底层 ADBC 数据库。
备注
这是一个扩展,不属于 DBAPI 标准。
- adbc_get_objects(*, depth: Literal['all', 'catalogs', 'db_schemas', 'tables', 'columns'] = 'all', catalog_filter: str | None = None, db_schema_filter: str | None = None, table_name_filter: str | None = None, table_types_filter: List[str] | None = None, column_name_filter: str | None = None) RecordBatchReader¶
列出数据库中的目录、模式、表等。
- 参数:
- depth
要返回信息的对象。
- catalog_filter
对返回的目录名称进行可选筛选。
- db_schema_filter
对返回的数据库模式名称进行可选筛选。
- table_name_filter
对返回的表名称进行可选筛选。
- table_types_filter
返回的表类型的可选列表。
- column_name_filter
对返回的列名称进行可选筛选。
备注
这是一个扩展,不属于 DBAPI 标准。
- adbc_get_table_schema(table_name: str, *, catalog_filter: str | None = None, db_schema_filter: str | None = None) Schema¶
按名称获取表的 Arrow 模式。
- 参数:
- table_name
要获取其模式的表。
- catalog_filter
对表的目录名称进行可选筛选。
- db_schema_filter
对表的数据库模式名称进行可选筛选。
备注
这是一个扩展,不属于 DBAPI 标准。
- class adbc_driver_manager.dbapi.Cursor(conn: Connection, adbc_stmt_kwargs: Dict[str, Any] | None = None)¶
基类:
_Closeable一个 DB-API 2.0 (PEP 249) 游标。
请勿直接创建此对象;请使用 Connection.cursor()。
- 属性:
adbc_statement获取底层 ADBC 语句。
arraysize使用 fetchmany() 一次性获取的行数。
connection获取与此游标关联的连接。
description结果集的模式。
rowcount获取结果集的行数,如果未知则为 -1。
rownumber获取当前行号,如果不适用则为 None。
方法
取消此语句上任何正在进行的操作。
adbc_execute_partitions(operation[, parameters])执行查询并获取分布式结果集的分区。
adbc_execute_schema(operation[, parameters])获取查询结果集的模式,而不执行它。
adbc_ingest(table_name, data[, mode, ...])将 Arrow 数据摄入数据库表。
adbc_prepare(operation)准备查询而不执行它。
adbc_read_partition(partition)读取分布式结果集的一个分区。
callproc(procname, parameters)调用存储过程(不支持)。
close()关闭游标并释放资源。
execute(operation[, parameters])执行查询。
executemany(operation, seq_of_parameters)使用多个参数集执行查询。
executescript(operation)执行多条语句。
将结果作为实现 Arrow PyCapsule 接口的对象获取。
将结果的所有行作为 PyArrow 表获取。
fetch_df()将结果的所有行作为 Pandas DataFrame 获取。
将结果的所有行作为 Polars DataFrame 获取。
将结果作为 PyArrow RecordBatchReader 获取。
fetchall()获取结果的所有行。
将结果的所有行作为 PyArrow 表获取。
fetchmany([size])获取结果的部分行。
fetchone()获取结果的一行。
下一页()获取下一行,否则引发 StopIteration。
nextset()移动到下一个可用的结果集(不支持)。
setinputsizes(sizes)为参数预分配内存(无操作)。
setoutputsize(size[, column])为结果集预分配内存(无操作)。
- adbc_execute_partitions(operation, parameters=None) Tuple[List[bytes], Schema]¶
执行查询并获取分布式结果集的分区。
- 返回:
- partitions字节列表
分区描述符列表,可使用 read_partition 读取。
- schemapyarrow.Schema 或 None
结果集的模式。如果启用增量查询执行且服务器未返回模式,则可能为 None。
备注
这是一个扩展,不属于 DBAPI 标准。
- adbc_execute_schema(operation, parameters=None) Schema¶
获取查询结果集的模式,而不执行它。
- 返回:
- pyarrow.Schema
结果集的模式。
备注
这是一个扩展,不属于 DBAPI 标准。
- adbc_ingest(table_name: str, data: pyarrow.RecordBatch | pyarrow.Table | pyarrow.RecordBatchReader | CapsuleType, mode: Literal['append', 'create', 'replace', 'create_append'] = 'create', *, catalog_name: str | None = None, db_schema_name: str | None = None, temporary: bool = False) int¶
将 Arrow 数据摄入数据库表。
根据驱动程序的具体情况,这可以避免典型的 prepare-bind-insert 循环所产生的每行开销。
- 参数:
- table_name
要插入的表。
- 数据
要插入的 Arrow 数据。它可以是 pyarrow RecordBatch、Table 或 RecordBatchReader,或任何实现 Arrow PyCapsule 协议的 Arrow 兼容数据(即具有
__arrow_c_array__或__arrow_c_stream__方法)。- 模式
如何处理现有数据
“append”:附加到表(如果表不存在则报错)
“create”:创建表并插入(如果表存在则报错)
“create_append”:创建表(如果不存在)并插入
“replace”:删除现有表(如果有),然后与“create”相同
- catalog_name
如果给定,则为创建/查找表的目录。此 API 仍处于实验阶段。
- db_schema_name
如果给定,则为创建/查找表的模式。此 API 仍处于实验阶段。
- temporary
是否摄入到临时表。大多数驱动程序不支持同时设置此参数以及 catalog_name 和/或 db_schema_name。此 API 仍处于实验阶段。
- 返回:
- int
插入的行数,如果驱动程序无法提供此信息,则为 -1。
备注
这是一个扩展,不属于 DBAPI 标准。
- adbc_prepare(operation: bytes | str) Schema | None¶
准备查询而不执行它。
之后执行查询时,请使用相同的查询调用
execute()或executemany()。这将不会第二次准备查询。- 返回:
- pyarrow.Schema 或 None
绑定参数的模式,如果无法确定模式则为 None。
备注
这是一个扩展,不属于 DBAPI 标准。
- property adbc_statement: AdbcStatement¶
获取底层 ADBC 语句。
备注
这是一个扩展,不属于 DBAPI 标准。
- callproc(procname, parameters)¶
调用存储过程(不支持)。
- close()¶
关闭游标并释放资源。
- property connection: Connection¶
获取与此游标关联的连接。
这是一个可选的 DB-API 扩展。
- execute(operation: bytes | str, parameters=None) None¶
执行查询。
- 参数:
- operation字节或字符串
要执行的查询。将 SQL 查询作为字符串传递,将(序列化的)Substrait 计划作为字节传递。
- parameters
要绑定的参数。可以是 Python 序列(绑定一组参数)、Python 字典(按名称而不是位置绑定一组参数),或 Arrow 记录批、表或记录批读取器(提供多个参数,每个参数将依次绑定)。
通过提供 Arrow 数据按名称绑定时,请明确切换语句选项“adbc.statement.bind_by_name”。
请注意,不支持提供元组列表(DBAPI-2.0 中不推荐使用此用法模式;请改用 executemany())。
- executemany(operation: bytes | str, seq_of_parameters) None¶
使用多个参数集执行查询。
此方法不生成结果集。
- 参数:
- operation字节或字符串
要执行的查询。将 SQL 查询作为字符串传递,将(序列化的)Substrait 计划作为字节传递。
- seq_of_parameters
要绑定的参数。可以是 Python 序列列表,或 Arrow 记录批、表或记录批读取器。如果为 None,则查询将执行一次,否则将每行执行一次。(这意味着空序列等同于完全不执行查询。)
备注
允许参数为
None超出 DB-API 规范。
- fetch_arrow() ArrowArrayStreamHandle¶
将结果作为实现 Arrow PyCapsule 接口的对象获取。
此方法只能调用一次。它必须在任何其他检查数据的方法(例如 description、fetchone、fetch_arrow_table 等)之前调用。一旦调用此方法,其他检查数据的方法就不能再调用。
备注
这是一个扩展,不属于 DBAPI 标准。
- fetch_df() pandas.DataFrame¶
将结果的所有行作为 Pandas DataFrame 获取。
此方法实现了与 DuckDB 类似的 API。
备注
这是一个扩展,不属于 DBAPI 标准。
- fetch_polars() polars.DataFrame¶
将结果的所有行作为 Polars DataFrame 获取。
备注
这是一个扩展,不属于 DBAPI 标准。
- fetch_record_batch() RecordBatchReader¶
将结果作为 PyArrow RecordBatchReader 获取。
此方法实现了与 DuckDB 类似的 API:https://duckdb.net.cn/docs/guides/python/export_arrow.html#export-as-a-recordbatchreader
备注
这是一个扩展,不属于 DBAPI 标准。
- next()¶
获取下一行,否则引发 StopIteration。
- nextset()¶
移动到下一个可用的结果集(不支持)。
- setinputsizes(sizes)¶
为参数预分配内存(无操作)。
- setoutputsize(size, column=None)¶
为结果集预分配内存(无操作)。
内部¶
请勿直接使用这些。
基类:
_Closeable共享 AdbcDatabase 的持有者。
异常¶
- exception adbc_driver_manager.DatabaseError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
基类:
Error与数据库相关的错误。
- exception adbc_driver_manager.DataError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
-
与已处理数据相关的错误。
- exception adbc_driver_manager.Error(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
基类:
Exception符合 PEP 249 的基异常类。
- 属性:
- status_codeAdbcStatusCode
原始 ADBC 状态码。
- vendor_codeint, 可选
如果存在,则为供应商特定的状态码。
- sqlstatestr, 可选
如果存在,则为 SQLSTATE 代码。
- detailslist[tuple[str, bytes]], 可选
如果存在,则为其他错误详情。
- exception adbc_driver_manager.IntegrityError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
-
与关系完整性相关的错误。
- exception adbc_driver_manager.InterfaceError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
基类:
Error与数据库接口相关的错误。
- exception adbc_driver_manager.InternalError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
-
与数据库内部错误相关的错误。
- exception adbc_driver_manager.NotSupportedError(message, *, vendor_code=None, sqlstate=None, details=None)¶
-
不支持的操作或某些功能。
- exception adbc_driver_manager.OperationalError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
-
与数据库操作相关的错误,不受用户控制。
- exception adbc_driver_manager.ProgrammingError(message, *, status_code, vendor_code=None, sqlstate=None, details=None)¶
-
与用户错误相关的错误。
- exception adbc_driver_manager.Warning¶
基类:
UserWarning符合 PEP 249 的基本警告类。