資料持久性 (Data Persistence)

The modules described in this chapter support storing Python data in a persistent form on disk. The pickle and marshal modules can turn many Python data types into a stream of bytes and then recreate the objects from the bytes. The various DBM-related modules support a family of hash-based file formats that store a mapping of strings to other strings.

本章節所描述的模組列表為：

• pickle --- Python 物件序列化
  • 和其他 Python 模組的關係
    • 和 marshal 的比較
    • 和 json 的比較
  • 資料串流格式
  • 模組介面
    • HIGHEST_PROTOCOL
    • DEFAULT_PROTOCOL
    • dump()
    • dumps()
    • load()
    • loads()
    • PickleError
    • PicklingError
    • UnpicklingError
    • Pickler
      • dump()
      • persistent_id()
      • dispatch_table
      • reducer_override()
      • fast
    • Unpickler
      • load()
      • persistent_load()
      • find_class()
    • PickleBuffer
      • raw()
      • release()
  • 哪些物件能或不能被封裝、拆封？
  • Pickling 類別實例
    • __getnewargs_ex__()
    • __getnewargs__()
    • __getstate__()
    • __setstate__()
    • __reduce__()
    • __reduce_ex__()
    • 外部物件持久化
    • 調度表
    • 處裡紀錄大量狀態的物件
  • 針對型別、函數或特定物件定製縮減函數
  • 帶外（Out-of-band）資料緩衝區
    • 供給者 API
    • 消費者 API
    • 範例
  • 限制全域物件
  • 效能
  • 範例
• copyreg --- 註冊 pickle 支援函式
  • constructor()
  • pickle()
  • 範例
• shelve --- Python object persistence
  • open()
  • sync()
  • close()
  • Restrictions
    • Shelf
    • BsdDbShelf
    • DbfilenameShelf
  • 範例
• marshal --- 内部 Python 物件序列化
  • dump()
  • load()
  • dumps()
  • loads()
  • version
• dbm --- Unix "databases" 的介面
  • error
  • whichdb()
  • open()
  • dbm.sqlite3 --- SQLite backend for dbm
    • open()
  • dbm.gnu --- GNU 資料庫管理器
    • error
    • open()
      • open_flags
      • firstkey()
      • nextkey()
      • reorganize()
      • sync()
      • close()
      • clear()
  • dbm.ndbm --- 新資料庫管理器
    • error
    • library
    • open()
      • close()
      • clear()
  • dbm.dumb --- 可攜式 DBM 實作
    • error
    • open()
      • sync()
      • close()
• sqlite3 --- SQLite 資料庫的 DB-API 2.0 介面
  • 教學
  • Reference
    • Module functions
      • connect()
      • complete_statement()
      • enable_callback_tracebacks()
      • register_adapter()
      • register_converter()
    • Module constants
      • LEGACY_TRANSACTION_CONTROL
      • PARSE_COLNAMES
      • PARSE_DECLTYPES
      • SQLITE_OK
      • SQLITE_DENY
      • SQLITE_IGNORE
      • apilevel
      • paramstyle
      • sqlite_version
      • sqlite_version_info
      • threadsafety
      • SQLITE_DBCONFIG_DEFENSIVE
      • SQLITE_DBCONFIG_DQS_DDL
      • SQLITE_DBCONFIG_DQS_DML
      • SQLITE_DBCONFIG_ENABLE_FKEY
      • SQLITE_DBCONFIG_ENABLE_FTS3_TOKENIZER
      • SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION
      • SQLITE_DBCONFIG_ENABLE_QPSG
      • SQLITE_DBCONFIG_ENABLE_TRIGGER
      • SQLITE_DBCONFIG_ENABLE_VIEW
      • SQLITE_DBCONFIG_LEGACY_ALTER_TABLE
      • SQLITE_DBCONFIG_LEGACY_FILE_FORMAT
      • SQLITE_DBCONFIG_NO_CKPT_ON_CLOSE
      • SQLITE_DBCONFIG_RESET_DATABASE
      • SQLITE_DBCONFIG_TRIGGER_EQP
      • SQLITE_DBCONFIG_TRUSTED_SCHEMA
      • SQLITE_DBCONFIG_WRITABLE_SCHEMA
    • Connection 物件
      • Connection
        • cursor()
        • blobopen()
        • commit()
        • rollback()
        • close()
        • execute()
        • executemany()
        • executescript()
        • create_function()
        • create_aggregate()
        • create_window_function()
        • create_collation()
        • interrupt()
        • set_authorizer()
        • set_progress_handler()
        • set_trace_callback()
        • enable_load_extension()
        • load_extension()
        • iterdump()
        • backup()
        • getlimit()
        • setlimit()
        • getconfig()
        • setconfig()
        • serialize()
        • deserialize()
        • autocommit
        • in_transaction
        • isolation_level
        • row_factory
        • text_factory
        • total_changes
    • Cursor 物件
      • Cursor
        • execute()
        • executemany()
        • executescript()
        • fetchone()
        • fetchmany()
        • fetchall()
        • close()
        • setinputsizes()
        • setoutputsize()
        • arraysize
        • connection
        • description
        • lastrowid
        • rowcount
        • row_factory
    • Row 物件
      • Row
        • keys()
    • Blob 物件
      • Blob
        • close()
        • read()
        • write()
        • tell()
        • seek()
    • PrepareProtocol 物件
      • PrepareProtocol
    • 例外
      • Warning
      • Error
        • sqlite_errorcode
        • sqlite_errorname
      • InterfaceError
      • DatabaseError
      • DataError
      • OperationalError
      • IntegrityError
      • InternalError
      • ProgrammingError
      • NotSupportedError
    • SQLite and Python types
    • Default adapters and converters (deprecated)
    • 命令列介面
  • How-to guides
    • How to use placeholders to bind values in SQL queries
    • How to adapt custom Python types to SQLite values
      • How to write adaptable objects
      • How to register adapter callables
    • How to convert SQLite values to custom Python types
    • Adapter and converter recipes
    • How to use connection shortcut methods
    • How to use the connection context manager
    • How to work with SQLite URIs
    • How to create and use row factories
    • How to handle non-UTF-8 text encodings
  • 解釋
    • Transaction control
      • Transaction control via the autocommit attribute
      • Transaction control via the isolation_level attribute