トランザクション

接続が提供する transaction メソッドで一連の操作をデータベーストランザクション内で実行します。例外が発生すると全体がロールバックされます。

Sutando 接続が提供する transaction メソッドを使用すると、一連の操作をデータベーストランザクション内で実行できます。トランザクションのクロージャ内で例外がスローされると、トランザクションは自動的にロールバックされ、例外は再スローされます。クロージャが正常に実行されると、トランザクションは自動的にコミットされます。transaction メソッドを使用している間は、手動でのロールバックやコミットを気にする必要はありません：

import { sutando } from 'sutando';

const db = sutando.connection();

await db.transaction(async (trx) => {
  await User.query().transacting(trx).create(/* ... */);
 
  await db.table('users').transacting(trx).insert(/* ... */);

  const user = new User;
  user.name = 'Sally';

  await user.save({
    client: trx,
  });
});

手動でトランザクションを使用する

手動でトランザクションを開始し、ロールバックとコミットを完全に制御したい場合は、sutando が提供する beginTransaction メソッドを使用できます：

import { sutando } from 'sutando';

const db = sutando.connection();
const trx = await db.beginTransaction();

rollback メソッドでトランザクションをロールバックできます：

await trx.rollback();

最後に、commit メソッドでトランザクションをコミットできます：

await trx.commit();

以下は完全な例です：

import { sutando } from 'sutando';

const db = sutando.connection();
const trx = await db.beginTransaction();

try {
  const user = new User;
  user.name = 'Sally';

  await user.save({
    client: trx,
  });

  await trx.commit();
} catch (e) {
  await trx.rollback();

  console.log(e.stack);
}