メインコンテンツまでスキップ
バージョン: 3.16
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 がサポートするデータベースの一覧については、データベースを参照してください。

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

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 の設定の包括的なリストについては、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 には、実装固有のデータモデルとスキーマにマップされる独自のデータモデルとスキーマがあります。

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

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

注記

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

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

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.16.4'
}

ScalarDB Cluster Java SDK を設定する​

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

Java API を使用する​

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

注記

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

詳細​

テクニカルサポートに問い合わせ
商用ライセンスをご契約のお客様のみご利用いただけます。
ドキュメントの問題を報告
このページについて何かお気づきの点がありましたら、こちらから報告いただけます。