ScalarDB Cluster スタンドアロンモード
このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。
Kubernetes クラスターをセットアップし、Helm Chart を使用してその上に ScalarDB Cluster をデプロイする代わりに、ScalarDB Cluster をスタンドアロンモードで実行できます。これにより、開発プロセスとテストプロセスが簡素化されます。この主な使用例は、ローカルマシン上の Docker を介して ScalarDB Cluster をスタンドアロンモードで起動し、開発とテストに使用する場合です。
ScalarDB Cluster をスタンドアロンモードで実行するには、scalar.db.cluster.node.standalone_mode.enabled プロパティを true に設定する必要があります。
scalar.db.cluster.node.standalone_mode.enabled=true
Docker Compose で ScalarDB Cluster をスタンドアロンモードで実行
このセクションでは、Docker Compose で 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 Cluster 用にデータベースを設定してください。
ScalarDB がサポートするデータベースの一覧については、データベースを参照してください。
- リレーショナルデータベース
- NewSQL データベース
- NoSQL データベース
- オブジェクトストレージ
リレーショナルデータベースを選択します。
- Db2
- MariaDB
- MySQL
- Oracle Database
- PostgreSQL
- SQL Server
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
MariaDB をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で MariaDB を実行できます。
MariaDB を起動するには、次のコマンドを実行します。
docker compose up -d mariadb
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の MariaDB のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For MariaDB
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:mariadb://mariadb-1:3306
scalar.db.username=root
scalar.db.password=mariadb
MySQL をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で MySQL を実行できます。
MySQL を起動するには、次のコマンドを実行します。
docker compose up -d mysql
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。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
Oracle Database をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で Oracle Database を実行できます。
Oracle Database を起動するには、次のコマンドを実行します。
docker compose up -d oracle
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の Oracle データベースのプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For Oracle
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:oracle:thin:@//oracle-1:1521/FREEPDB1
scalar.db.username=SYSTEM
scalar.db.password=Oracle
PostgreSQL をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で PostgreSQL を実行できます。
PostgreSQL を起動するには、次のコマンドを実行します。
docker compose up -d postgres
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の PostgreSQL のプロパティのコメントを解除して、設定が次のようにな るようにしてください。
# For PostgreSQL
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:postgresql://postgres-1:5432/
scalar.db.username=postgres
scalar.db.password=postgres
SQL Server をローカルで実行す る
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で SQL Server を実行できます。
SQL Server を起動するには、次のコマンドを実行します。
docker compose up -d sqlserver
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の SQL Server のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For SQL Server
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:sqlserver://sqlserver-1:1433;encrypt=true;trustServerCertificate=true
scalar.db.username=sa
scalar.db.password=SqlServer22
NewSQL データベースを選択します。
- AlloyDB
- Spanner
- TiDB
- YugabyteDB
AlloyDB をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で AlloyDB Omni を実行できます。
AlloyDB Omni を起動するには、次のコマンドを実行します。
docker compose up -d alloydb
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の AlloyDB のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For AlloyDB
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:postgresql://alloydb-1:5432/
scalar.db.username=postgres
scalar.db.password=postgres
Spanner をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で Spanner Omni を実行できます。
Spanner Omni を起動するには、次のコマンドを実行します。
docker compose up -d spanner spanner-init
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイ ルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の Spanner のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For Spanner
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:cloudspanner://spanner-1:15000/databases/test-db;isExperimentalHost=true;usePlainText=true
scalar.db.username=
scalar.db.password=
TiDB をローカルで実行する
TiUP ツールを使用して TiDB をローカルで実行できます。インストール手順については、TiUP のインストールを参照してください。
TiDB を起動するには、次のコマンドを実行します。
tiup playground v8.5 --without-monitor
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の TiDB のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For TiDB
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:mysql://host.docker.internal:4000/
scalar.db.username=root
scalar.db.password=
YugabyteDB をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で YugabyteDB を実行できます。
YugabyteDB を起動するには、次のコマンドを実行します。
docker compose up -d yugabyte
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の YugabyteDB のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For Yugabyte
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:yugabytedb://yugabyte-1:5433/postgres
scalar.db.username=yugabyte
scalar.db.password=yugabyte
NoSQL データベースを選択します。
- Cassandra
- Cosmos DB for NoSQL
- DynamoDB
Cassandra をローカルで実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で Apache Cassandra を実行できます。
Apache Cassandra を起動するには、次のコマンドを実行します。
docker compose up -d cassandra
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の Cassandra のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For Cassandra
scalar.db.storage=cassandra
scalar.db.contact_points=cassandra-1
scalar.db.username=cassandra
scalar.db.password=cassandra
Azure Cosmos DB for NoSQL を使用するには、Azure アカウントが必要です。Azure アカウントをお持ちでない場合は、Azure Cosmos DB アカウントの作成をご覧ください。
Cosmos DB for NoSQL を設定する
公式ドキュメントのデフォルトの一貫性レベルの設定に従って、デフォルトの一貫性レベルを Strong に設定します。
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。以下の説明に従って scalar.db.contact_points と scalar.db.password の値を変更してください。
# For Cosmos DB
scalar.db.storage=cosmos
scalar.db.contact_points=<COSMOS_DB_FOR_NOSQL_URI>
scalar.db.password=<COSMOS_DB_FOR_NOSQL_KEY>
Azure Cosmos DB アカウントのプライマリキーまたはセカンダリキーを scalar.db.password の値として使用できます。
Amazon DynamoDB Local を実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で Amazon DynamoDB Local を実行できます。
Amazon DynamoDB Local を起動するには、次のコマンドを実行します。
docker compose up -d dynamodb
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の Amazon DynamoDB Local のプロパティのコメントを解除して、設定が次のようになるようにしてください。
# For DynamoDB Local
scalar.db.storage=dynamo
scalar.db.contact_points=sample
scalar.db.username=sample
scalar.db.password=sample
scalar.db.dynamo.endpoint_override=http://dynamodb-1:8000
- Blob Storage
- Cloud Storage
- S3
Azurite を実行する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で Blob Storage のローカルエミュレーターである Azurite を実行できます。 Blob Storage を起動するには、次のコマンドを実行します。docker compose up -d blobstorage
test-container という名前のコンテナーを作成します。docker compose up blobstorage-container-creator
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。scalardb-cluster-node.properties ファイル内の Blob Storage のプロパティのコメントを解除して、設定が次のようになるようにしてください。# For Blob Storage
scalar.db.storage=blob-storage
scalar.db.contact_points=http://blobstorage-1:10000/test/test-container
scalar.db.username=test
scalar.db.password=test
Google Cloud Storage を使用するには、Google Cloud アカウントが必要です。Google Cloud アカウントをお持ちでない場合は、Google Cloud を使ってみるをご覧ください。
Cloud Storage を設定する
Cloud Storage バケットを作成します。バケットの作成方法については、バケットを作成するを参照してください。認証にはサービスアカウントキーも必要です。詳細については、サービスアカウントキーを作成するを参照してください。
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。以下の説明に従って scalar.db.contact_points、scalar.db.username、および scalar.db.password の値を変更してください。
# For Cloud Storage
scalar.db.storage=cloud-storage
scalar.db.contact_points=<CLOUD_STORAGE_BUCKET_NAME>
scalar.db.username=<GCP_PROJECT_ID>
scalar.db.password=<GCP_SERVICE_ACCOUNT_KEY_JSON>
scalar.db.password には、Google Cloud サービスアカウントキーファイルの全内容を単一行の JSON 形式 で設定してください。Amazon S3 を使用するには、AWS アカウントが必要です。AWS アカウントをお持ちでない場合は、AWS アカウントを作成してください。
Amazon S3 を設定する
S3 バケットを作成します。バケットの作成方法については、バケットの作成を参照してください。認証にはアクセスキーも必要です。詳細については、アクセスキーの作成を参照してください。
ScalarDB Cluster を設定する
scalardb-samples/scalardb-cluster-standalone-mode ディレクトリの scalardb-cluster-node.properties ファイルには、データベース設定が含まれています。以下の説明に従って scalar.db.contact_points、scalar.db.username、および scalar.db.password の値を変更してください。
# For S3
scalar.db.storage=s3
scalar.db.contact_points=<REGION>/<S3_BUCKET_NAME>
scalar.db.username=<AWS_ACCESS_KEY>
scalar.db.password=<AWS_SECRET_ACCESS_KEY>
scalar.db.contact_points の形式は <REGION>/<S3_BUCKET_NAME> です (例: us-east-1/my-bucket)。ライセンスキーを設定する
設定ファイル scalardb-cluster-node.properties で、ScalarDB Cluster のライセンスキー (試用ライセンスまたは商用ライセンス) を設定します。詳細については、製品ライセンスキーの設定方法 を参照してください。
スタンドアロンモードで ScalarDB Cluster を起動する
スタンドアロンモードで ScalarDB Cluster を起動するには、次のコマンドを実行します。
ScalarDB Cluster のその他の設定を変更する場合は、以下のコマンドを実行する前に scalardb-cluster-node.properties ファイルを更新してください。
docker compose up -d scalardb-cluster-node
ScalarDB Cluster Java API のクライアント設定
indirect クライアントモードを使用して、スタンドアロンモードで ScalarDB Cluster に接続できます。ScalarDB Cluster Java API のクライアント設定の詳細については、Java API を使用した ScalarDB Cluster の開発者ガイド を参照してください。