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

ScalarDB Cluster を通じて非トランザクションストレージ操作を実行する

注記

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

このガイドでは、ScalarDB Cluster を介して非トランザクションストレージ操作を実行する方法について説明します。

警告

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 の構成の包括的なリストについては、ScalarDB 構成を参照してください。

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

スタンドアロンモードで ScalarDB Cluster を設定するには、非トランザクションストレージ操作を実行するように ScalarDB Cluster を構成し、ライセンスキーを設定してから、ScalarDB Cluster を起動する必要があります。

非トランザクションストレージ操作を実行するように ScalarDB Cluster を構成する​

非トランザクションストレージ操作を実行するには、構成ファイル scalardb-cluster-node.properties で scalar.db.transaction_manager プロパティを single-crud-operation に設定する必要があります。

scalar.db.transaction_manager=single-crud-operation

ライセンスキーの設定​

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

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

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

注記

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

docker compose up -d scalardb-cluster-node

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

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

Java アプリケーションを作成する​

このセクションでは、ScalarDB Cluster Java Client SDK をプロジェクトに追加する方法と、Java を使用して非トランザクションストレージ操作を実行するようにプロジェクトを構成する方法について説明します。

ScalarDB Cluster Java Client SDK をビルドに追加する​

ScalarDB Cluster Java Client SDK は、Maven Central Repository で入手できます。Gradle または Maven を使用して、SDK をビルド依存関係としてアプリケーションに追加できます。

ビルドツールを選択し、手順に従って ScalarDB Cluster Java Client SDK のビルド依存関係をアプリケーションに追加します。

Gradle を使用して ScalarDB Cluster Java Client SDK のビルド依存関係を追加するには、アプリケーションの build.gradle に以下を追加します。

dependencies {
  implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}

ScalarDB Cluster Java SDK を構成する​

ScalarDB Cluster Java SDK の構成の詳細については、クライアント構成を参照してください。

Java API を使用する​

Java API の詳細については、ScalarDB Java API ガイドを参照してください。

注記

非トランザクションストレージ操作には、次の制限が適用されます:

詳細​