トランザクション

項目一覧

Overview

トランザクション API
Convenient API
Core API
トランザクションの例
詳細情報
API ドキュメント

Overview

このガイドでは、 Cドライバーを使用して トランザクション を実行する方法を学習できます。トランザクションを使用すると、トランザクション全体がコミットされた場合にのみ、データを変更する一連の操作を実行できます。トランザクション内のいずれかの操作が成功しない場合、ライブラリはトランザクションを停止し、変更が反映される前にすべてのデータ変更を破棄します。この特徴は アトミック性と 呼ばれます。

MongoDB では、トランザクションは論理セッション内で実行されます。セッションは、順番に実行されるよう関連付けられた読み取り操作または書き込み操作のグループです。セッションにより、一連の操作に対する因果整合性が有効になり、 ACID 準拠のトランザクション（不可分性、整合性、分離、耐久性の期待を満たすトランザクション）内で操作を実行できるようになります。 MongoDBは、トランザクション操作で予期せぬエラーが発生した場合でも、その操作に関わるデータの一貫性が保たれることを保証します。

Cドライバーを使用すると、 mongoc_client_tインスタンスから新しいセッションを作成できます。その後、結果の mongoc_client_session_tインスタンスを使用してトランザクションを実行できます。

警告

mongoc_client_session_t は、それを作成した mongoc_client_t（または関連付けられたmongoc_database_t または mongoc_collection_t）でのみ使用します。mongoc_client_session_t と、異なる mongoc_client_t を使用すると、操作エラーが発生します。

トランザクション API

このセクションでは、 Cドライバーが提供するトランザクション API について学習できます。トランザクションを開始する前に、mongoc_client_tインスタンスで mongoc_client_start_session() 関数を使用して mongoc_client_session_t を作成する必要があります。その後、次のいずれかの API を使用してトランザクションを実行できます。

Convenient API
Core API

Convenient API

Cドライバーは、トランザクションのライフサイクルを管理するためのConvenient Transaction APIを提供します。このAPIを実装するには、 関数を使用してトランザクション内でカスタムコールバックを実行します。mongoc_client_session_with_transaction() 関数は、次のタスクを実行します。mongoc_client_session_with_transaction()

トランザクションを開始する
操作の結果が次のような場合に、トランザクションを終了するか再試行することでエラーを処理します。 TransientTransactionError
トランザクションをコミットする

このガイドの「トランザクションの例」セクションでは、このAPIを使用してトランザクションを実行する方法を示します。

Core API

あるいは、mongoc_client_session_tインスタンスで次の関数を使用すると、トランザクションライフサイクルをより制御できます。

関数	説明
`mongoc_client_session_start_transaction()`	Starts a new transaction, configured with the given options, on this session. Returns `false` and sets the provided error if there are invalid arguments, such as a session with a transaction already in progress. To learn more about this function, see the startTransaction() page in the Server manual.
`mongoc_client_session_abort_transaction()`	Ends the active transaction for this session. Returns `false` and sets the provided error if there is no active transaction for the session or the transaction has been committed or ended. To learn more about this function, see the abortTransaction() page in the Server manual.
`mongoc_client_session_commit_transaction()`	Commits the active transaction for this session. Returns an error if there is no active transaction for the session or if the transaction was ended. To learn more about this function, see the commitTransaction() page in the Server manual.
`mongoc_client_session_destroy()`	Aborts any transactions in progress and ends this session. Frees all client resources associated with this session.

mongoc_client_session_tプロパティを取得し、可変セッションプロパティを変更する関数の詳細については、 APIドキュメントを参照してください。

トランザクションの例

この例では、金融トランザクションのためにsample_bankデータベースのコレクション内のデータを変更するコールバック関数を定義します。このコードは、次のアクションを実行します。

コールバック関数を定義します。この関数は、 mongoc_client_session_tインスタンスをパラメータとして受け取ります。
ターゲットコレクションにアクセスするためのmongoc_collection_tインスタンスを作成します。
アカウント間で転送されるアカウント番号と金額を指定します。
送金を反映するようにカスタマーの残高を更新します。
トランザクションの受信をタイムスタンプとともに記録します。
トランザクションが正常にコミットされた場合は、メッセージを出力します。

bool
transaction_callback (mongoc_client_session_t *session, void *ctx, bson_t **reply,
                      bson_error_t *error)
{
    BSON_UNUSED(ctx);
    BSON_UNUSED(reply);
    mongoc_client_t *client = mongoc_client_session_get_client (session);
    mongoc_collection_t *checking = mongoc_client_get_collection (client, "sample_bank", "checking");
    mongoc_collection_t *savings = mongoc_client_get_collection (client, "sample_bank", "savings");
    mongoc_collection_t *receipts = mongoc_client_get_collection (client, "sample_bank", "receipts");
    const char *account_id = "123456";
    int transfer_amount = 1000;
    bson_t *filter = BCON_NEW ("account_id", BCON_UTF8 (account_id));
    bson_t *update_decrement = BCON_NEW ("$inc", "{", "balance", BCON_INT32 (-transfer_amount), "}");
    bson_t *update_increment = BCON_NEW ("$inc", "{", "balance", BCON_INT32 (transfer_amount), "}");
    
    if (!mongoc_collection_update_one (checking, filter, update_decrement, NULL, NULL, &error)) {
        fprintf (stderr, "Failed to update checking account: %s\n", error.message);
        return false;
    }
    if (!mongoc_collection_update_one (savings, filter, update_increment, NULL, NULL, &error)) {
        fprintf (stderr, "Failed to update savings account: %s\n", error.message);
        return false;
    }
    bson_t *receipt = BCON_NEW ("account_id", BCON_UTF8 (account_id),
                                "amount", BCON_INT32 (transfer_amount),
                                "timestamp", BCON_DATE_TIME (bson_get_monotonic_time ()));
    
    if (!mongoc_collection_insert_one (receipts, receipt, NULL, NULL, &error)) {
        fprintf (stderr, "Failed to insert receipt: %s\n", error.message);
        return false;
    }
    mongoc_collection_destroy (checking);
    mongoc_collection_destroy (savings);
    mongoc_collection_destroy (receipts);
    bson_destroy (filter);
    bson_destroy (update_decrement);
    bson_destroy (update_increment);
    bson_destroy (receipt);
    printf ("Transaction successful!");
    return true;
}

次に、次のコードを実行してトランザクションを実行します。このコードは、次のアクションを完了します。

mongoc_client_start_session() 関数を使用してクライアントからセッションを作成します。
セッションとコールバックをパラメータとして渡して、トランザクションを管理するためにmongoc_client_session_with_transaction()関数を呼び出します。

mongoc_client_session_t *session = mongoc_client_start_session (client, NULL, NULL);
if (!session) {
    fprintf (stderr, "Failed to start session\n");
    mongoc_client_destroy (client);
    return EXIT_FAILURE;
}
bool result = 
    mongoc_client_session_with_transaction (session,
                                            (mongoc_client_session_with_transaction_cb_t) transaction_callback,
                                            NULL, NULL, NULL, &error);
if (!result) {
    fprintf (stderr, "Transaction error: %s\n", error.message);
}
mongoc_client_session_destroy (session);
mongoc_client_destroy (client);
mongoc_cleanup ();

Transaction successful!

詳細情報

このガイドで言及されている概念の詳細については、 MongoDB Serverマニュアルの次のページを参照してください。

ACID compliance の詳細については、「データベース管理システムの ACID プロパティとは」を参照してください。 MongoDB Webサイトの記事。

API ドキュメント

このガイドで説明した型や関数の詳細については、次のAPIドキュメントを参照してください。

戻る

一括書き込み操作

大きなファイルの保存