Getting Started¶

A high level view and getting set up.

Overview | Installation Guide | Migration from 0.5

SQLAlchemy ORM¶

Here, the Object Relational Mapper is introduced and fully described. If you want to work with higher-level SQL which is constructed automatically for you, as well as automated persistence of Python objects, proceed first to the tutorial.

• Read this first: Object Relational Tutorial
• ORM Configuration: Mapper Configuration | Relationship Configuration | Inheritance Mapping | Advanced Collection Configuration
• Configuration Extensions: Declarative Extension | Association Proxy | Ordered List
• ORM Usage: Session Usage and Guidelines | Query API reference | Relationship Loading Techniques
• Extending the ORM: ORM Event Interfaces
• Other: Introduction to Examples | ORM Exceptions | Horizontal Sharding | SQLSoup

SQLAlchemy Core¶

The breadth of SQLAlchemy’s SQL rendering engine, DBAPI integration, transaction integration, and schema description services are documented here. In contrast to the ORM’s domain-centric mode of usage, the SQL Expression Language provides a schema-centric usage paradigm.

• Read this first: SQL Expression Language Tutorial
• All the Built In SQL: SQL Expression API
• Engines, Connections, Pools: Engine Configuration | Connections, Transactions | Connection Pooling
• Schema Definition: Tables and Columns | Database Introspection (Reflection) | Insert/Update Defaults | Constraints and Indexes | Using Data Definition Language (DDL)
• Datatypes: Overview | Generic Types | SQL Standard Types | Vendor Specific Types | Building Custom Types | API
• Extending the Core: Core Event Interfaces | Creating Custom SQL Constructs
• Other: Serializing Expressions | Core Exceptions

Dialect Documentation¶

The dialect is the system SQLAlchemy uses to communicate with various types of DBAPIs and databases. This section describes notes, options, and usage patterns regarding individual dialects.

Firebird | Informix | MaxDB | Microsoft Access | Microsoft SQL Server | MySQL | Oracle | PostgreSQL | SQLite | Sybase