Controlled transaction /w savepoints
A controlled transaction allows you to commit and rollback manually, execute savepoint commands, and queries in general.
In this example we start a transaction, insert a person, create a savepoint, try inserting a toy and a pet, and if an error is thrown, we rollback to the savepoint. Eventually we release the savepoint, insert an audit record and commit the transaction. If an error is thrown, we catch it and rollback the transaction.
const trx = await db.startTransaction().execute()
try {
const jennifer = await trx
.insertInto('person')
.values({
first_name: 'Jennifer',
last_name: 'Aniston',
age: 40,
})
.returning('id')
.executeTakeFirstOrThrow()
const trxAfterJennifer = await trx.savepoint('after_jennifer').execute()
try {
const catto = await trxAfterJennifer
.insertInto('pet')
.values({
owner_id: jennifer.id,
name: 'Catto',
species: 'cat',
})
.returning('id')
.executeTakeFirstOrThrow()
await trxAfterJennifer
.insertInto('toy')
.values({ name: 'Bone', price: 1.99, pet_id: catto.id })
.execute()
} catch (error) {
await trxAfterJennifer.rollbackToSavepoint('after_jennifer').execute()
}
await trxAfterJennifer.releaseSavepoint('after_jennifer').execute()
await trx.insertInto('audit').values({ action: 'added Jennifer' }).execute()
await trx.commit().execute()
} catch (error) {
if (!trx.isRolledBack) {
await trx.rollback().execute()
}
}More examples
The API documentation is packed with examples. The API docs are hosted here, but you can access the same documentation by hovering over functions/methods/classes in your IDE. The examples are always just one hover away!
For example, check out these sections: