Connection
Connection 类提供了以下方法来管理数据库连接、事务和游标:
close
close()
关闭此连接;连接对象将失效。
startTransaction
startTransaction(type, priority)
在此连接上启动一个数据库事务。
commit
commit()
在此连接上提交一个打开的事务。
rollback
rollback()
回滚当前事务中对数据库所做的更改。
createBackup
createBackup(filename, label, type, compression_level, cipher)
在指定文件中创建增量备份记录。
restoreBackup
restoreBackup(filename, label, cipher)
从指定文件中的增量备份还原数据库,还原到指定的标签为止。
deleteAll
deleteAll(clsDesc)
删除类 clsDesc(类描述,可以是字符串形式,也可以是从字典对象中获取的类类型)的所有对象。例如,以下两个调用是等效的:
>>>conn.deleteAll(‘myclass’)
>>>conn.deleteAll(dict.classes[‘myclass’])
new
new(clsName)
使用类 clsName 的模式定义在数据库中创建新对象。
waitEvent
waitEvent(eventId)
开始等待由参数 eventId 指定的异步事件(通常这是从单独的事件处理线程中调用的)
releaseAllEvents
releaseAllEvents()
释放所有事件并停止事件处理线程。
remove
remove(obj)
从数据库中移除对象 obj。对象参数 obj 必须取自在此连接上执行的 Cursor 操作 find() 或 search() 中的一个。
cursor
在此连接上创建一个用于检索数据的游标。
getStats
getStats()
获取数据库统计信息;它会返回一个字典,其中包含以下数据库信息的键:
TotalPages
FreePages
PageSize
对于持久性数据库,它还包含带有磁盘文件统计信息的字典键:
DataFileSize
LogFileSize
UsedDatabaseSize
getClassStats
getClassStats(cls)
从数据库获取类 cls 的统计信息;它返回一个包含以下键的字典:
ObjectsNum
VersionsNum
CorePages
BlobPages
CoreSpace
getIndexStats
getIndexStats(idx)
从数据库获取索引 idx 的统计信息;它返回一个包含以下键的字典:
ClassCode
Type
Label
KeysNum
PagesNum
AvgChainLength – for hash indexes only
MaxChainLength - for hash indexes only
LevelsNum – for tree indexes only
DuplicatesNum - for tree indexes only
DiskPagesNum
getDiskCacheInfo
getDiskCacheInfo()
获取磁盘缓存统计信息;它会返回一个包含以下键的字典:
connection_cache_hits
cache_hits
cache_misses
allocated_pages
used_pages
pinned_pages
modified_pages
dirty_pages
copied_pages
write_delayed_pages
subsequent_reads
saveSnapshot
saveSnapshot(path, saveMetadata=True, saveCRC=True)
将数据库快照映像保存到由路径参数指定的磁盘文件中。
db
只读属性,用于指定此连接所打开的数据库。
engine
一个只读属性,用于指定此连接的 SQL 引擎。