transaction() — drizzle-orm Function Reference

Architecture documentation for the transaction() function in session.ts from the drizzle-orm codebase.

Function typescript DrizzleORM DatabaseDrivers calls 2 called by 1

Entity Profile

DrizzleORM→ DatabaseDrivers→ transaction() — drizzle-orm Function Reference

Dependency Diagram

graph TD
  5baf95e7_94fb_2adf_e658_9c8532475fac["transaction()"]
  c646ed52_d040_651a_1fc6_0990a7170ce7["PgliteTransaction"]
  5baf95e7_94fb_2adf_e658_9c8532475fac -->|defined in| c646ed52_d040_651a_1fc6_0990a7170ce7
  0e9c97ab_57ab_b7e6_f4d2_54ec6e07e617["transaction()"]
  0e9c97ab_57ab_b7e6_f4d2_54ec6e07e617 -->|calls| 5baf95e7_94fb_2adf_e658_9c8532475fac
  ca3aa3d1_6d7c_d183_8476_5322d34cdde5["execute()"]
  5baf95e7_94fb_2adf_e658_9c8532475fac -->|calls| ca3aa3d1_6d7c_d183_8476_5322d34cdde5
  0e9c97ab_57ab_b7e6_f4d2_54ec6e07e617["transaction()"]
  5baf95e7_94fb_2adf_e658_9c8532475fac -->|calls| 0e9c97ab_57ab_b7e6_f4d2_54ec6e07e617
  style 5baf95e7_94fb_2adf_e658_9c8532475fac fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

drizzle-orm/src/pglite/session.ts lines 203–220

	override async transaction<T>(transaction: (tx: PgliteTransaction<TFullSchema, TSchema>) => Promise<T>): Promise<T> {
		const savepointName = `sp${this.nestedIndex + 1}`;
		const tx = new PgliteTransaction<TFullSchema, TSchema>(
			this.dialect,
			this.session,
			this.schema,
			this.nestedIndex + 1,
		);
		await tx.execute(sql.raw(`savepoint ${savepointName}`));
		try {
			const result = await transaction(tx);
			await tx.execute(sql.raw(`release savepoint ${savepointName}`));
			return result;
		} catch (err) {
			await tx.execute(sql.raw(`rollback to savepoint ${savepointName}`));
			throw err;
		}
	}