メインコンテンツまでスキップ
バージョン: 3.16
Features and pricing

ScalarDB Cluster を介してトランザクションを実行する

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

このガイドでは、ScalarDB プロパティファイルを設定し、ScalarDB Cluster を使用して1フェーズまたは2フェーズのコミットインターフェイスを介してトランザクションを実行するためのスキーマを作成する方法について説明します。

警告

ScalarDB Cluster のライセンスキー (試用ライセンスまたは商用ライセンス) が必要です。ライセンスキーをお持ちでない場合は、お問い合わせください。

準備​

このガイドでは、ScalarDB サンプルリポジトリのサンプルを使用して、データベースと ScalarDB Cluster をスタンドアロンモードでセットアップします。

注記

スタンドアロンモードの ScalarDB Cluster は、主に開発とテストを目的としています。

ScalarDB サンプルリポジトリのクローンを作成する​

ターミナル を開き、次のコマンドを実行して ScalarDB サンプルリポジトリのクローンを作成します。

git clone https://github.com/scalar-labs/scalardb-samples

次に、次のコマンドを実行して、必要なファイルが含まれているディレクトリに移動します。

cd scalardb-samples/scalardb-cluster-standalone-mode

データベースをセットアップする​

データベースを選択し、指示に従って ScalarDB Cluster 用に設定します。

ScalarDB がサポートするデータベースの一覧については、データベースを参照してください。

MySQL をローカルで実行する

scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yaml ファイルを使用して、Docker Compose で MySQL を実行できます。

MySQL を起動するには、次のコマンドを実行します。

docker compose up -d mysql

ScalarDB Cluster を設定する

scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、ScalarDB Cluster のデータベース設定が含まれています。scalardb-cluster-node.properties ファイル内の MySQL のプロパティのコメントを解除して、設定が次のようになるようにしてください。

# For MySQL
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:mysql://mysql-1:3306/
scalar.db.username=root
scalar.db.password=mysql

ScalarDB Cluster の設定の包括的なリストについては、ScalarDB Cluster の設定 を参照してください。

スタンドアロンモードで ScalarDB Cluster を設定する​

スタンドアロンモードで ScalarDB Cluster を設定するには、ライセンスキーを設定してから ScalarDB Cluster を起動する必要があります。

ライセンスキーの設定​

プロパティファイルで ScalarDB Cluster のライセンスキー (試用ライセンスまたは商用ライセンス) を設定します。詳細については、製品ライセンスキーの設定方法を参照してください。

スタンドアロンモードで ScalarDB Cluster を起動​

スタンドアロンモードで ScalarDB Cluster を起動するには、次のコマンドを実行します。

注記

ScalarDB Cluster のその他の設定を変更する場合は、以下のコマンドを実行する前に scalardb-cluster-node.properties ファイルを更新してください。

docker compose up -d scalardb-cluster-node

スキーマを作成またはインポートする​

ScalarDB には、実装固有のデータモデルとスキーマにマップされる独自のデータモデルとスキーマがあります。

必要に応じて初期データをロードする​

ScalarDB Data Loader は、ScalarDB でデータのインポートとエクスポートを行うユーティリティです。

注記

Data Loader は現在 ScalarDB Core 上に構築されているため、バックエンドデータベースとの間でのみ直接データのインポートとエクスポートを行うことができます。そのため、ScalarDB Cluster を通じてデータのインポートとエクスポートを行うことはできません。

  • データベースにデータをインポートする必要がありますか? データのインポートを参照してください。
  • データベースからデータをエクスポートする必要がありますか? データのエクスポートを参照してください。

トランザクションを実行する​

1フェーズまたは2フェーズのコミットインターフェースを使用してトランザクションを実行できます。トランザクションを実行する方法を選択してください。

注記

モノリシックなアプリケーションを構築する場合は、1フェーズコミットインターフェースを使用してください。一方、マイクロサービスアプリケーションを構築する場合は、マイクロサービスにおける ScalarDB Cluster のデプロイパターンを読んで、どちらを使用するかを決定してください。

1フェーズコミットインターフェース

1フェーズコミットインターフェイスを使用してトランザクションを実行する方法の詳細については、ScalarDB Java API ガイドを参照してください。

注記

1フェーズコミットインターフェースを使用してトランザクションを実行するには、次のサンプルチュートリアルを参照してください。

2フェーズコミットインターフェース

2フェーズコミットインターフェイスを使用してトランザクションを実行する方法の詳細については、2フェーズコミットインターフェイスを使用したトランザクションを参照してください。

注記

2フェーズコミットインターフェースを使用してトランザクションを実行するには、次のサンプルチュートリアルを参照してください。

詳細

ScalarDB Cluster を使用してトランザクションを実行する方法の詳細については、以下を参照してください。