Using the Session

The orm.mapper() function and declarative extensionsare the primary configurational interface for the ORM. Once mappings areconfigured, the primary usage interface for persistence operations is theSession.

• Session Basics
  • What does the Session do ?
  • Getting a Session
  • Session Frequently Asked Questions
  • Basics of Using a Session
• State Management
  • Quickie Intro to Object States
  • Session Attributes
  • Session Referencing Behavior
  • Merging
  • Expunging
  • Refreshing / Expiring
• Cascades
  • save-update
  • delete
  • delete-orphan
  • merge
  • refresh-expire
  • expunge
  • Controlling Cascade on Backrefs
• Transactions and Connection Management
  • Managing Transactions
  • Joining a Session into an External Transaction (such as for test suites)
• Additional Persistence Techniques
  • Embedding SQL Insert/Update Expressions into a Flush
  • Using SQL Expressions with Sessions
  • Forcing NULL on a column with a default
  • Fetching Server-Generated Defaults
  • Partitioning Strategies (e.g. multiple database backends per Session)
  • Bulk Operations
• Contextual/Thread-local Sessions
  • Implicit Method Access
  • Thread-Local Scope
  • Using Thread-Local Scope with Web Applications
  • Using Custom Created Scopes
  • Contextual Session API
• Tracking Object and Session Changes with Events
  • Persistence Events
  • Object Lifecycle Events
  • Transaction Events
  • Attribute Change Events
• Session API
  • Session and sessionmaker()
  • Session Utilities
  • Attribute and State Management Utilities