ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

RustにおけるSQLxとDieselを使用した堅牢なトランザクション管理

7月 19, 2025
# Misc

James Reed

Infrastructure Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "RustにおけるSQLxとDieselを使用した堅牢なトランザクション管理"

はじめに

データ駆動型アプリケーションの世界では、データの整合性と一貫性を確保することが最優先事項です。一方の口座から資金が引き落とされたにもかかわらず、予期せぬエラーによりもう一方の口座への入金が失敗するという金融取引を想像してみてください。このようなシナリオを処理するための堅牢なメカニズムがないと、システム全体の信頼性は崩壊します。データベーストランザクションが登場するのはまさにこのためです。トランザクションは「すべてか無か」の保証を提供し、一連の操作がすべて成功してコミットされるか、いずれかが失敗した場合はすべて初期状態にロールバックされることを保証します。Rustエコシステムでは、sqlxとdieselは、トランザクション管理を優れたサポートで提供する、人気があり強力な2つのORM/クエリビルダーです。この記事では、これらのツールを活用して安全なトランザクション処理とエラーロールバックを行い、Rustアプリケーションがデータベースと安全かつ確実にやり取りできるようにする方法を掘り下げます。

トランザクションの基礎を理解する

sqlxとdieselの具体例に入る前に、データベーストランザクションに関連するいくつかのコアコンセプトを定義しましょう。

  • トランザクション: 1つ以上の操作を含む、単一の論理的な作業単位。これらの操作は、単一の不可分なシーケンスとして扱われます。
  • ACID特性: 有効なトランザクションを保証するプロパティのセット。
    • 原子性: トランザクション内のすべての操作は、成功して完了するか、完全に失敗します。部分的な完了はありません。
    • 一貫性: トランザクションは、データベースをある有効な状態から別の有効な状態に移行させます。
    • 分離性: 並行トランザクションは互いに干渉しません。各トランザクションは、独立して実行されているように見えます。
    • 永続性: トランザクションがコミットされると、その変更は永続化され、システム障害後も存続します。
  • コミット: トランザクション中に行われた変更をデータベースに永続的に保存するプロセス。
  • ロールバック: トランザクション中に行われたすべての変更を元に戻し、トランザクション開始前の状態にデータベースを復元するプロセス。
  • セーブポイント: トランザクション内で、部分的なロールバックを可能にするマーカー。トランザクション全体を元に戻すことなく、特定のセーブポイントにロールバックできます。sqlxとdieselはセーブポイントを扱うことができますが、主な焦点は、シンプルさと一般的なユースケースのためにトランザクションスコープ全体にあります。

これらの概念は、信頼性の高いデータベースインタラクションのバックボーンを形成し、sqlxとdieselの両方がRustでそれらを実装するエレガントな方法を提供します。

SQLxによる安全なトランザクション管理

sqlxは、コード生成なしで型安全なクエリを提供することを目指す、非同期の純粋Rust SQLクレートです。そのトランザクション管理は非常に簡単で、Rustの非同期性の性質とうまく統合されています。

原理と実装

sqlxは、データベース接続でbegin()メソッドを提供してトランザクションを開始します。このメソッドはTransactionオブジェクトを返し、これはDropを実装しています。重要なのは、Transactionオブジェクトが明示的にコミットされずにスコープを外れた場合、dropが呼び出されたときに自動的にロールバックされることです。トランザクションのためのこの「RAIIライク」な動作は、強力な安全機能です。

例で示しましょう。

use sqlx::{PgPool, Error, Postgres};

async fn transfer_funds_sqlx(pool: &PgPool, from_account_id: i32, to_account_id: i32, amount: f64) -> Result<(), Error> {
    let mut tx = pool.begin().await?;

    // 送金元口座から引き落とす
    let rows_affected = sqlx::query!(
        "UPDATE accounts SET balance = balance - $1 WHERE id = $2 AND balance >= $1",
        amount,
        from_account_id
    )
    .execute(&mut tx)
    .await?;
    .rows_affected();

    if rows_affected == 0 {
        // 更新された行がない場合、口座が存在しないか、資金が不足しています。
        // `tx` がコミットなしでスコープを外れるため、トランザクションはロールバックされます。
        return Err(Error::RowNotFound); // より具体的なエラーの方が良いかもしれません
    }

    // 受金口座に入金する
    sqlx::query!(
        "UPDATE accounts SET balance = balance + $1 WHERE id = $2",
        amount,
        to_account_id
    )
    .execute(&mut tx)
    .await?;

    // 両方の操作が成功した場合、トランザクションをコミットする
    tx.commit().await?;
    Ok(())
}

// 使用例（デモンストレーションのために簡略化）
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let database_url = "postgres://user:password@localhost/my_database";
    let pool = PgPool::connect(&database_url).await?;

    // accounts テーブルが存在し、いくつかのデータがあると仮定します
    // INSERT INTO accounts (id, balance) VALUES (1, 100.00), (2, 50.00);

    match transfer_funds_sqlx(&pool, 1, 2, 25.00).await {
        Ok(_) => println!("Funds transferred successfully!"),
        Err(e) => println!("Failed to transfer funds: {:?}", e),
    }

    match transfer_funds_sqlx(&pool, 1, 2, 200.00).await { // 資金不足で失敗するはずです
        Ok(_) => println!("Funds transferred successfully!"),
        Err(e) => println!("Failed to transfer funds: {:?}", e),
    }

    Ok(())
}

このsqlxの例では:

  1. pool.begin().await?は新しいトランザクションを開始します。tx変数はトランザクションハンドルを保持します。
  2. データベース操作は&mut txを使用して実行され、これらがこのトランザクションの一部であることを保証します。
  3. エラー（?演算子）が発生した場合、関数は早期に返されます。tx.commit().await?に到達しないため、tx変数はスコープを外れ、そのdrop実装がトリガーされます。drop実装は自動的にデータベース接続でROLLBACKを呼び出し、原子性を保証します。
  4. すべての操作が成功した場合、tx.commit().await?が呼び出され、変更が永続化されます。

このパターンは、Rustの型システムと所有権を活用して、誤った未コミットトランザクションを防ぐため、非常に安全で慣用的です。

アプリケーションシナリオ

このsqlxトランザクションパターンは、原子性を必要とするあらゆるシナリオに最適です。

  • 資金移動: 示されているように、資金が完全に移動するか、まったく移動しないことを保証します。
  • 注文処理: 注文の作成、在庫の更新、確認メールの送信をすべて1つの単位として行います。
  • 関連データを持つユーザーの作成: ユーザーレコードとデフォルトのプロファイル設定を作成します。

Dieselによる安全なトランザクション管理

dieselは、Rust向けの強力で安全、かつ拡張性の高いORM/クエリビルダーです。データベースとの対話に、より宣言的な方法を提供し、そのトランザクション管理も同様に堅牢です。

原理と実装

dieselは、その接続タイプ（例：PostgreSQLのPgConnection）にtransactionメソッドを提供します。このメソッドはクロージャ（FnOnce(&mut Self) -> Result<T, E>）を取り、トランザクション操作をカプセル化します。クロージャがOk(T)を返した場合、トランザクションはコミットされます。Err(E)を返した場合、トランザクションはロールバックされます。この関数型アプローチは非常に表現力豊かで、関心の分離を維持するのに役立ちます。

料金移動の例をdiesel用に適応させてみましょう。

use diesel::prelude::*;
use diesel::pg::PgConnection;
use diesel::result::Error as DieselError; // 曖昧さを避けるためにエイリアス

// Diesel CLIによって生成された`schema.rs`があると仮定します
// table! {
//     accounts (id) {
//         id -> Int4,
//         balance -> Float8,
//     }
// }
// use crate::schema::accounts; // これがスコープ内にあることを確認してください

// デモンストレーションのために、簡単な`Account`構造体を定義しましょう
#[derive(Queryable, Selectable, Debug)]
#[diesel(table_name = accounts)]
pub struct Account {
    pub id: i32,
    pub balance: f64,
}

fn transfer_funds_diesel(conn: &mut PgConnection, from_account_id: i32, to_account_id: i32, amount: f64) -> Result<(), DieselError> {
    conn.transaction::<(), DieselError, _>(|conn| {
        use accounts::dsl::*;

        // 送金元口座から引き落とす
        let updated_rows = diesel::update(accounts.filter(id.eq(from_account_id).and(balance.ge(amount))))
            .set(balance.eq(balance - amount))
            .execute(conn)?;

        if updated_rows == 0 {
            // sqlxのRowNotFoundに似ていますが、Dieselのエラータイプは異なります。
            // ここでカスタムエラーまたは特定のDieselエラーを返すことができます。
            // 簡単にするために、一般的なものを使いましょう。ただし、カスタム`NotEnoughFunds`エラーの方が良いでしょう。
            return Err(DieselError::NotFound);
        }

        // 受金口座に入金する
        diesel::update(accounts.filter(id.eq(to_account_id)))
            .set(balance.eq(balance + amount))
            .execute(conn)?;

        Ok(())
    })
}

// 使用例（デモンストレーションのために簡略化）
fn main() -> Result<(), Box<dyn std::error::Error>> {
    let database_url = "postgres://user:password@localhost/my_database";
    let mut conn = PgConnection::establish(&database_url)?;

    // accounts テーブルが存在し、いくつかのデータがあると仮定します
    // INSERT INTO accounts (id, balance) VALUES (1, 100.00), (2, 50.00);

    match transfer_funds_diesel(&mut conn, 1, 2, 25.00) {
        Ok(_) => println!("Funds transferred successfully!"),
        Err(e) => println!("Failed to transfer funds: {:?}", e),
    }

    match transfer_funds_diesel(&mut conn, 1, 2, 200.00) { // 資金不足で失敗するはずです
        Ok(_) => println!("Funds transferred successfully!"),
        Err(e) => println!("Failed to transfer funds: {:?}", e),
    }

    Ok(())
}

このdieselの例では:

  1. conn.transaction::<(), DieselError, _>(|conn| { ... })は新しいトランザクションスコープを作成します。
  2. クロージャ内のすべてのデータベース操作は、それに渡されたconnで操作され、トランザクションの一部であることを保証します。
  3. クロージャ内のいずれかの操作がErr(E)を返した場合（例：?演算子または明示的なreturn Err(...)による）、transactionメソッドはエラーをキャッチし、ROLLBACKを実行します。
  4. クロージャが正常に完了し、Ok(())を返した場合、transactionメソッドはCOMMITを実行します。

この設計は、トランザクションロジックとコミット/ロールバックメカニクスを明確に分離し、コードをクリーンで堅牢に保ちます。

アプリケーションシナリオ

sqlxのトランザクション機能と同様に、dieselのトランザクション機能は以下に不可欠です。

  • 複雑なビジネスロジック: 原子的に扱われる必要がある複数のデータベース書き込みを含むあらゆる操作。
  • データ移行スクリプト: エラーが発生した場合、データ変換が完全に適用されるか、完全に元に戻されることを保証します。
  • 重要なデータを処理するAPIエンドポイント: 機密情報の更新が整合性ルールに準拠していることを保証します。

結論

sqlxとdieselは、Rustでデータベーストランザクションとエラーロールバックを管理するための、優れた safesで慣用的な方法を提供します。sqlxは、エラー発生時の暗黙的なロールバックのためにTransactionオブジェクトのDrop実装を使用してRustのRAII原則を活用しますが、dieselはクロージャの戻り値に基づいてコミット/ロールバックを処理するtransactionメソッドによる関数型アプローチを提供します。これらの機能を注意深く活用することにより、開発者は、予期しない障害に直面しても、データの整合性を確保し、非常に信頼性が高く耐障害性の高いアプリケーションを構築できます。安全なトランザクション管理は、単なるベストプラクティスではありません。それは、信頼できるデータシステムのための基本的な要件です。

Share this article

HackerNews

More Posts from Leapcell

cover

reqwestとserdeで堅牢で型安全なRust APIクライアントを構築する

cover

Crafting Maintainable Rust Web Apps with Layered DDD

Popular Posts