メインコンテンツまでスキップ
バージョン: 3.18

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

注記

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

このガイドでは、ScalarDB プロパティファイルを設定する方法と、ScalarDB Cluster SQL を使用して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 がサポートするデータベースの一覧については、データベースを参照してください。

リレーショナルデータベースを選択します。

Db2 をローカルで実行する

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

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

docker compose up -d db2

ScalarDB Cluster を設定する

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

# For Db2
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:db2://db2-1:50000/sample
scalar.db.username=db2inst1
scalar.db.password=db2inst1

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

スタンドアロンモードで 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 Cluster Data Loader は、ScalarDB Cluster でデータのインポートとエクスポートを行うユーティリティです。

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

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

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

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

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

注記

2フェーズコミットインターフェースでトランザクションを実行する方法に関するドキュメントは近日公開予定です。