transaction() — drizzle-orm Function Reference

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

Function typescript DrizzleORM SQLDialects calls 2 called by 1

Entity Profile

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

Dependency Diagram

graph TD
  6ebbfd4b_527b_e473_a19c_04511fe038fb["transaction()"]
  93a97685_0b41_f28c_b7e6_b3b5a206b7a0["SQLJsTransaction"]
  6ebbfd4b_527b_e473_a19c_04511fe038fb -->|defined in| 93a97685_0b41_f28c_b7e6_b3b5a206b7a0
  64c77bc2_2026_921b_fd5a_d62bfc217ad6["transaction()"]
  64c77bc2_2026_921b_fd5a_d62bfc217ad6 -->|calls| 6ebbfd4b_527b_e473_a19c_04511fe038fb
  a8b9aa76_08ef_960b_7cba_6f7e5c867df3["run()"]
  6ebbfd4b_527b_e473_a19c_04511fe038fb -->|calls| a8b9aa76_08ef_960b_7cba_6f7e5c867df3
  64c77bc2_2026_921b_fd5a_d62bfc217ad6["transaction()"]
  6ebbfd4b_527b_e473_a19c_04511fe038fb -->|calls| 64c77bc2_2026_921b_fd5a_d62bfc217ad6
  style 6ebbfd4b_527b_e473_a19c_04511fe038fb fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

drizzle-orm/src/sql-js/session.ts lines 74–86

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