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

ScalarDB Core の設定

注記

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

このページでは、ScalarDB Core で使用可能な設定について説明します。

ヒント

ScalarDB Cluster を使用している場合は、代わりに ScalarDB Cluster の設定を参照してください。

一般的な設定​

ScalarDB トランザクションマネージャーでは、次の一般的な設定が利用可能です。

transaction_manager​

  • フィールド: scalar.db.transaction_manager
  • 説明: ScalarDB のトランザクションマネージャー。Consensus Commit を使用するには consensus-commit を指定し、非トランザクションストレージ操作を実行する には single-crud-operation を指定します。single-crud-operation を使用する場合、scalar.db.consensus_commit プレフィックスの下の設定は無視されることに注意してください。
  • デフォルト値: consensus-commit

isolation_level​

  • フィールド: scalar.db.consensus_commit.isolation_level
  • 説明: Consensus Commit に使用される分離レベル。SNAPSHOT、SERIALIZABLE または READ_COMMITTED のいずれかを指定できます。
  • デフォルト値: SNAPSHOT

coordinator.namespace​

  • フィールド: scalar.db.consensus_commit.coordinator.namespace
  • 説明: Consensus Commit に使用される Coordinator テーブルの名前空間名。
  • デフォルト値: coordinator

パフォーマンス関連の設定​

Consensus Commit トランザクションマネージャーでは、次のパフォーマンス関連の設定が利用できます。

parallel_executor_count​

  • フィールド: scalar.db.consensus_commit.parallel_executor_count
  • 説明: 並列実行のためのエグゼキュータ (スレッド) の数。この数値は、ScalarDB Cluster ノード内または ScalarDB Core プロセス内のトランザクション全体のスレッド数の合計を示します。
  • デフォルト値: 128

parallel_preparation.enabled​

  • フィールド: scalar.db.consensus_commit.parallel_preparation.enabled
  • 説明: 準備フェーズが並行して実行されるかどうか。
  • デフォルト値: true

parallel_validation.enabled​

  • フィールド: scalar.db.consensus_commit.parallel_validation.enabled
  • 説明: 検証フェーズ (EXTRA_READ 内) が並列で実行されるかどうか。
  • デフォルト値: scalar.db.consensus_commit.parallel_commit.enabled の値

parallel_commit.enabled​

  • フィールド: scalar.db.consensus_commit.parallel_commit.enabled
  • 説明: コミットフェーズが並列で実行されるかどうか。
  • デフォルト値: true

parallel_rollback.enabled​

  • フィールド: scalar.db.consensus_commit.parallel_rollback.enabled
  • 説明: ロールバックフェーズが並列で実行されるかどうか。
  • デフォルト値: scalar.db.consensus_commit.parallel_commit.enabled の値

async_commit.enabled​

  • フィールド: scalar.db.consensus_commit.async_commit.enabled
  • 説明: コミットフェーズが非同期で実行されるかどうか。
  • デフォルト値: false

async_rollback.enabled​

  • フィールド: scalar.db.consensus_commit.async_rollback.enabled
  • 説明: ロールバックフェーズが非同期に実行されるかどうか。
  • デフォルト値: scalar.db.consensus_commit.async_commit.enabled の値

parallel_implicit_pre_read.enabled​

  • フィールド: scalar.db.consensus_commit.parallel_implicit_pre_read.enabled
  • 説明: 暗黙的な事前読み取りが並列で実行されるかどうか。
  • デフォルト値: true

one_phase_commit.enabled​

  • フィールド: scalar.db.consensus_commit.one_phase_commit.enabled
  • 説明: 1フェーズコミット最適化が有効かどうか。
  • デフォルト値: false

coordinator.write_omission_on_read_only.enabled​

  • フィールド: scalar.db.consensus_commit.coordinator.write_omission_on_read_only.enabled
  • 説明: 読み取り専用トランザクションに対して Coordinator テーブルへの書き込み省略最適化を有効にするかどうか。この最適化は、データを変更しない読み取り専用トランザクションに有効であり、Coordinator テーブルへの不要な書き込みを回避します。
  • デフォルト値: true

coordinator.group_commit.enabled​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.enabled
  • 説明: トランザクション状態のコミットがバッチモードで実行されるかどうか。この機能は、2フェーズコミットインターフェースでは使用できません。
  • デフォルト値: false

coordinator.group_commit.slot_capacity​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.slot_capacity
  • 説明: グループコミット機能のグループ内のスロットの最大数。値が大きいとグループコミットの効率は向上しますが、待ち時間が増加し、トランザクションの競合が発生する可能性も高くなります。[^1]
  • デフォルト値: 20

coordinator.group_commit.group_size_fix_timeout_millis​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.group_size_fix_timeout_millis
  • 説明: グループ内のスロットのサイズを固定するためのタイムアウト。値が大きいとグループコミットの効率が向上しますが、待ち時間が増加し、トランザクションの競合が発生する可能性も高くなります。[^1]
  • デフォルト値: 40

coordinator.group_commit.delayed_slot_move_timeout_millis​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.delayed_slot_move_timeout_millis
  • 説明: 遅延スロットをグループから別の分離グループに移動して、元のグループが遅延トランザクションの影響を受けないようにするためのタイムアウト。値が大きいとグループコミットの効率が向上しますが、待ち時間が増加し、トランザクションの競合が発生する可能性も高くなります。[^1]
  • デフォルト値: 1200

coordinator.group_commit.old_group_abort_timeout_millis​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.old_group_abort_timeout_millis
  • 説明: 進行中の古いグループをアボートするためのタイムアウト。値が小さいと、積極的なアボートによってリソースの消費量が減りますが、長時間実行されるトランザクションで不要なアボートが発生する可能性も高くなります。
  • デフォルト値: 60000

coordinator.group_commit.timeout_check_interval_millis​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.timeout_check_interval_millis
  • 説明: グループコミット関連のタイムアウトをチェックする間隔。
  • デフォルト値: 20

coordinator.group_commit.metrics_monitor_log_enabled​

  • フィールド: scalar.db.consensus_commit.coordinator.group_commit.metrics_monitor_log_enabled
  • 説明: グループコミットのメトリックが定期的にログに記録されるかどうか。
  • デフォルト値: false

ストレージ関連の設定​

ScalarDB には、複数のストレージ実装をサポートするストレージ (データベース) 抽象化レイヤーがあります。scalar.db.storage プロパティを使用してストレージ実装を指定できます。

注記

複数のストレージの使用の詳細については、マルチストレージ設定を参照してください。

データベースを選択して、各ストレージで使用可能な設定を確認します。

JDBC データベースでは次の設定を使用できます。

storage

  • フィールド: scalar.db.storage
  • 説明: jdbc を指定する必要があります。
  • デフォルト値: empty

contact_points

  • フィールド: scalar.db.contact_points
  • 説明: JDBC 接続 URL。
  • デフォルト値: empty

username

  • フィールド: scalar.db.username
  • 説明: データベースにアクセスするためのユーザー名。
  • デフォルト値: empty

password

  • フィールド: scalar.db.password
  • 説明: データベースにアクセスするためのパスワード。
  • デフォルト値: empty
注記

次のプロパティは削除され、設定されても無視されます。これらのプロパティがまだ設定に含まれている場合は、警告メッセージを避けるために削除してください。

  • scalar.db.jdbc.connection_pool.max_idle
  • scalar.db.jdbc.table_metadata.connection_pool.max_idle
  • scalar.db.jdbc.admin.connection_pool.max_idle
  • scalar.db.jdbc.prepared_statements_pool.enabled
  • scalar.db.jdbc.prepared_statements_pool.max_open

jdbc.connection_pool.min_idle

  • フィールド: scalar.db.jdbc.connection_pool.min_idle
  • 説明: コネクションプール内のアイドルコネクションの最小数。
  • デフォルト値: 20

jdbc.connection_pool.max_total

  • フィールド: scalar.db.jdbc.connection_pool.max_total
  • 説明: コネクションプール内のアイドルコネクションとアクティブコネクションの最大合計数。
  • デフォルト値: 200

jdbc.connection_pool.connection_timeout_millis

  • フィールド: scalar.db.jdbc.connection_pool.connection_timeout_millis
  • 説明: プールからコネクションを取得するまでの最大待機時間（ミリ秒単位）。
  • デフォルト値: 30000

jdbc.connection_pool.idle_timeout_millis

  • フィールド: scalar.db.jdbc.connection_pool.idle_timeout_millis
  • 説明: コネクションがプール内でアイドル状態のまま維持される最大時間（ミリ秒単位）。この設定は min_idle が max_total より小さい場合にのみ適用されます。0 の値はアイドルコネクションが削除されないことを意味します。
  • デフォルト値: 600000

jdbc.connection_pool.max_lifetime_millis

  • フィールド: scalar.db.jdbc.connection_pool.max_lifetime_millis
  • 説明: プール内のコネクションの最大生存時間（ミリ秒単位）。この生存時間を超えたコネクションは廃棄されます。この値は、データベースやインフラストラクチャによって課される任意のコネクションタイムアウトよりも数秒短く設定する必要があります。0 の値は最大生存時間がないことを意味します。
  • デフォルト値: 1800000

jdbc.connection_pool.keepalive_time_millis

  • フィールド: scalar.db.jdbc.connection_pool.keepalive_time_millis
  • 説明: プールがコネクションをアライブに保とうとする間隔（ミリ秒単位）。これはデータベースやネットワークインフラストラクチャによってタイムアウトされることを防ぐためです。この値は max_lifetime_millis より小さくなければなりません。0 の値はキープアライブを無効にします。
  • デフォルト値: 0

jdbc.isolation_level

  • フィールド: scalar.db.jdbc.isolation_level
  • 説明: JDBC の分離レベル。READ_COMMITTED、REPEATABLE_READ、または SERIALIZABLE を指定できます。
  • デフォルト値: 基盤データベース固有

jdbc.table_metadata.connection_pool.min_idle

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.min_idle
  • 説明: テーブルメタデータのコネクションプール内のアイドルコネクションの最小数。
  • デフォルト値: 5

jdbc.table_metadata.connection_pool.max_total

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.max_total
  • 説明: テーブルメタデータのコネクションプール内のアイドルコネクションとアクティブコネクションの最大合計数。
  • デフォルト値: 25

jdbc.table_metadata.connection_pool.connection_timeout_millis

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.connection_timeout_millis
  • 説明: jdbc.connection_pool.connection_timeout_millis と同じですが、テーブルメタデータコネクションプール用です。
  • デフォルト値: 30000

jdbc.table_metadata.connection_pool.idle_timeout_millis

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.idle_timeout_millis
  • 説明: jdbc.connection_pool.idle_timeout_millis と同じですが、テーブルメタデータコネクションプール用です。
  • デフォルト値: 600000

jdbc.table_metadata.connection_pool.max_lifetime_millis

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.max_lifetime_millis
  • 説明: jdbc.connection_pool.max_lifetime_millis と同じですが、テーブルメタデータコネクションプール用です。
  • デフォルト値: 1800000

jdbc.table_metadata.connection_pool.keepalive_time_millis

  • フィールド: scalar.db.jdbc.table_metadata.connection_pool.keepalive_time_millis
  • 説明: jdbc.connection_pool.keepalive_time_millis と同じですが、テーブルメタデータコネクションプール用です。
  • デフォルト値: 0

jdbc.admin.connection_pool.min_idle

  • フィールド: scalar.db.jdbc.admin.connection_pool.min_idle
  • 説明: 管理者のコネクションプール内のアイドルコネクションの最小数。
  • デフォルト値: 5

jdbc.admin.connection_pool.max_total

  • フィールド: scalar.db.jdbc.admin.connection_pool.max_total
  • 説明: 管理者のコネクションプール内のアイドルコネクションとアクティブコネクションの最大合計数。
  • デフォルト値: 25

jdbc.admin.connection_pool.connection_timeout_millis

  • フィールド: scalar.db.jdbc.admin.connection_pool.connection_timeout_millis
  • 説明: jdbc.connection_pool.connection_timeout_millis と同じですが、管理者コネクションプール用です。
  • デフォルト値: 30000

jdbc.admin.connection_pool.idle_timeout_millis

  • フィールド: scalar.db.jdbc.admin.connection_pool.idle_timeout_millis
  • 説明: jdbc.connection_pool.idle_timeout_millis と同じですが、管理者コネクションプール用です。
  • デフォルト値: 600000

jdbc.admin.connection_pool.max_lifetime_millis

  • フィールド: scalar.db.jdbc.admin.connection_pool.max_lifetime_millis
  • 説明: jdbc.connection_pool.max_lifetime_millis と同じですが、管理者コネクションプール用です。
  • デフォルト値: 1800000

jdbc.admin.connection_pool.keepalive_time_millis

  • フィールド: scalar.db.jdbc.admin.connection_pool.keepalive_time_millis
  • 説明: jdbc.connection_pool.keepalive_time_millis と同じですが、管理者コネクションプール用です。
  • デフォルト値: 0

jdbc.mysql.variable_key_column_size

  • フィールド: scalar.db.jdbc.mysql.variable_key_column_size
  • 説明: MySQL で主キーまたはセカンダリキーとして使用される場合の TEXT 列と BLOB 列の列サイズ。最小 64 バイト。
  • デフォルト値: 128

jdbc.oracle.variable_key_column_size

  • フィールド: scalar.db.jdbc.oracle.variable_key_column_size
  • 説明: Oracle で主キーまたはセカンダリキーとして使用される場合の TEXT 列と BLOB 列の列サイズ。最小 64 バイト。
  • デフォルト値: 128

jdbc.oracle.time_column.default_date_component

  • フィールド: scalar.db.jdbc.oracle.time_column.default_date_component
  • 説明: Oracle で TIME データを格納するために使用される日付コンポーネントの値。Oracle には日付コンポーネントなしで時間のみを格納するデータ型がないため、ScalarDB は比較と並べ替えを容易にするために、同じ日付コンポーネント値を持つ TIME データを保存します。
  • デフォルト値: 1970-01-01

jdbc.db2.variable_key_column_size

  • フィールド: scalar.db.jdbc.db2.variable_key_column_size
  • 説明: IBM Db2 で主キーまたはセカンダリキーとして使用される場合の TEXT 列と BLOB 列の列サイズ。最小 64 バイト。
  • デフォルト値: 128

jdbc.db2.time_column.default_date_component

  • フィールド: scalar.db.jdbc.db2.time_column.default_date_component
  • 説明: IBM Db2 で TIME データを格納するために使用される日付コンポーネントの値。ScalarDB の TIME 型データを格納するために IBM Db2 の TIMESTAMP 型が使用されるため (小数秒の精度を提供するため)、ScalarDB は比較と並べ替えを容易にするために、同じ日付コンポーネント値を持つ TIME データを保存します。
  • デフォルト値: 1970-01-01

jdbc.spanner.time_column.default_date_component

  • フィールド: scalar.db.jdbc.spanner.time_column.default_date_component
  • 説明: Spanner で TIME データを格納するために使用される日付コンポーネントの値。Spanner (PostgreSQL 構文) にはネイティブの TIME 型がないため、ScalarDB は比較と並べ替えを可能にするために、固定された日付コンポーネントを持つ Spanner TIMESTAMP WITH TIME ZONE データとして TIME データを保存します。
  • デフォルト値: 1970-01-01
注記

SQLite3

SQLite3 を JDBC データベースとして使用している場合は、scalar.db.contact_points を次のように設定する必要があります。

scalar.db.contact_points=jdbc:sqlite:<SQLITE_DB_FILE_PATH>?busy_timeout=10000&journal_mode=WAL

他の JDBC データベースとは異なり、SQLite3 doesn't fully support concurrent access。SQLITE_BUSY によって内部的に頻繁に発生するエラーを回避するには、busy_timeout パラメータを設定してください。また、journal_mode=WAL を設定して先行書き込みログ (WAL) を有効にすると、読み取りと書き込みを同時に実行でき、ロックの競合が軽減されます。SQLite3 は WAL モードでも書き込みをシリアライズするため、busy_timeout パラメータも引き続き設定しておいてください。

YugabyteDB

YugabyteDB を JDBC データベースとして使用している場合は、次のように scalar.db.contact_points で複数のエンドポイントを指定できます。

scalar.db.contact_points=jdbc:yugabytedb://127.0.0.1:5433\\,127.0.0.2:5433\\,127.0.0.3:5433/?load-balance=true

複数のエンドポイントはエスケープされたコンマで区切る必要があります。

YugabyteDB のスマートドライバーと負荷分散の詳細については、YugabyteDB smart drivers for YSQL を参照してください。

AlloyDB

Google Cloud 上の AlloyDB を JDBC データベースとして使用し、Java コネクタで接続したい場合は、次のように scalar.db.contact_points で追加のプロパティを追加する必要があります：

scalar.db.contact_points=jdbc:postgresql:///<DATABASE_NAME>?socketFactory=com.google.cloud.alloydb.SocketFactory&alloydbInstanceName=<INSTANCE_NAME>&alloydbIpType=PUBLIC

Spanner

Spanner への認証には、JSON 形式の Google Cloud サービスアカウントキーを使用する必要があります。scalar.db.password をサービスアカウントキーファイルの完全な内容として単一行 JSON で設定してください。scalar.db.username プロパティは Spanner では使用されません。ScalarDB は JVM システムプロパティ ENABLE_CREDENTIALS_PROVIDER=true も設定します。これは Spanner JDBC ドライバーが認証に必要とするものです。

例：

scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:cloudspanner:/projects/<PROJECT_ID>/instances/<INSTANCE_ID>/databases/<DATABASE_ID>
scalar.db.username=
scalar.db.password=<content-of-service-account-key.json>

Amazon Aurora

Amazon Aurora を JDBC データベースとして使用している場合、scalar.db.contact_points に jdbc:aws-wrapper: プレフィックスを追加することで、AWS Advanced JDBC Wrapper 経由で接続できます。このラッパーはクラスタートポロジーを検出し、DNS の伝播を待たずにフェイルオーバー後に新しいライターへ再接続します。ScalarDB はラッパーをバンドルしているため、JAR ファイルを追加する必要はありません。

Aurora PostgreSQL の場合、クラスターエンドポイントを次のように指定します。

scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:aws-wrapper:postgresql://<CLUSTER_ENDPOINT>:5432/<DATABASE_NAME>
scalar.db.username=<USERNAME>
scalar.db.password=<PASSWORD>

Aurora MySQL の場合、クラスターエンドポイントを次のように指定します。

scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:aws-wrapper:mysql://<CLUSTER_ENDPOINT>:3306/<DATABASE_NAME>
scalar.db.username=<USERNAME>
scalar.db.password=<PASSWORD>

ScalarDB は Aurora PostgreSQL と Aurora MySQL に対してのみこのプレフィックスをサポートしています。他のデータベースで使用した場合、ScalarDB は起動に失敗します。

ラッパーを設定するには、接続 URL のクエリ文字列にラッパーのパラメーターを追加します。以下に説明する Aurora MySQL のパラメーター以外、ScalarDB 自身はデフォルト値を設定しないため、ラッパー自身のデフォルト値が適用されます。たとえば、フェイルオーバーのタイムアウトを短縮するには次のようにします。

scalar.db.contact_points=jdbc:aws-wrapper:postgresql://<CLUSTER_ENDPOINT>:5432/<DATABASE_NAME>?failoverTimeoutMs=60000

Aurora MySQL の場合、ScalarDB は MariaDB Connector/J を介して MySQL に接続するため、permitMysqlScheme=true と wrapperTargetDriverDialect=mariadb-connector-j-3 を URL に自動的に追加します。これらのパラメーターを自分で設定した場合は、その値が使用されます。

commit() の実行中にフェイルオーバーが発生した場合、ScalarDB は UnknownTransactionStatusException をスローします。再試行する前に、トランザクションが適用されたかどうかを確認してください。CRUD 操作中のフェイルオーバーは CrudException をスローします。これは通常通り処理できます。詳細については、例外の処理方法を参照してください。

このサポートは以下の内容をカバーしていません。

  • IAM データベース認証と Secrets Manager の統合: これらに対応するラッパーのプラグインには、ScalarDB がバンドルしていない追加の JAR ファイルが必要です。
  • 読み取り/書き込みの分割: ScalarDB は読み取り操作をリーダーインスタンスにルーティングしません。
  • Aurora 以外の設定: ScalarDB はラッパーを通じて、Aurora 以外の RDS デプロイメントや、PostgreSQL と MySQL 以外のエンジンをサポートしていません。ScalarDB はエンドポイントが Aurora クラスターに属しているかどうかをチェックしないため、Aurora 以外の RDS デプロイメントはエラーなしで起動します。

マルチストレージ設定​

ScalarDB は複数のストレージ実装の同時使用をサポートしています。複数のストレージの使用の詳細については、マルチストレージトランザクションを参照してください。

storage​

  • フィールド: scalar.db.storage
  • 説明: multi-storage を指定する必要があります。

multi_storage.storages​

  • フィールド: scalar.db.multi_storage.storages
  • 説明: カンマ区切りのストレージ名 (例: cassandra,mysql)。これらのストレージ名は、名前空間をストレージにマップするために scalar.db.multi_storage.namespace_mapping プロパティで使用されます。
  • デフォルト値: empty

multi_storage.default_storage​

  • フィールド: scalar.db.multi_storage.default_storage
  • 説明: デフォルトのストレージ名。このストレージは、scalar.db.multi_storage.namespace_mapping プロパティでマッピングが定義されていない名前空間に使用されます。
  • デフォルト値: empty

multi_storage.namespace_mapping​

  • フィールド: scalar.db.multi_storage.namespace_mapping
  • 説明: 名前空間からストレージへのマッピング (例: user:my_cassandra,coordinator:my_mysql)。
  • デフォルト値: empty
ヒント

ストレージ名 (<STORAGE_NAME_FOR_NAMESPACE>) は、定義する必要がある任意の値です。マルチストレージ設定全体で一貫している限り、好きな名前を使用できます。

multi_storage.storages.<STORAGE_NAME_FOR_NAMESPACE>.<PROPERTY_NAME>​

特定のストレージを設定するには、scalar.db.multi_storage.storages.<STORAGE_NAME_FOR_NAMESPACE>.<PROPERTY_NAME> を使用します。ここで、<STORAGE_NAME_FOR_NAMESPACE> は scalar.db.multi_storage.storages プロパティで指定されたストレージ名の1つであり、<PROPERTY_NAME> は特定のストレージのプロパティ名です。

例えば、名前空間マッピングを scalar.db.multi_storage.namespace_mapping=user:my_cassandra,coordinator:my_mysql として定義した場合、my_cassandra と my_mysql がそれぞれ user と coordinator 名前空間のストレージ名になります:

  • scalar.db.multi_storage.storages.my_cassandra.contact_points を使用して Cassandra のコンタクトポイントを指定できます。
  • scalar.db.multi_storage.storages.my_mysql.jdbc.connection_pool.min_idle を使用して MySQL のコネクションプール設定の最小アイドル接続数を指定できます。

各ストレージで使用可能なプロパティの詳細については、ストレージ関連の設定を参照してください。

クロスパーティションスキャン設定​

以下で説明するようにクロスパーティションスキャンオプションを有効にすると、Scan 操作でパーティション全体のすべてのレコードを取得できます。さらに、cross_partition_scan.filtering と cross_partition_scan.ordering をそれぞれ有効にすることで、クロスパーティション Scan 操作で任意の条件と順序を指定できます。現在、順序付けオプション付きのクロスパーティションスキャンは、JDBC データベースでのみ使用できます。フィルタリングと順序付けを有効にするには、scalar.db.cross_partition_scan.enabled を true に設定する必要があります。

クロスパーティションスキャンの使用方法の詳細については、Scan 操作を参照してください。

警告

非 JDBC データベースの場合、SERIALIZABLE 分離レベルでクロスパーティションスキャンを有効にした場合でも、トランザクションは読み取りコミットスナップショット分離 (SNAPSHOT) で実行される可能性があります。これは、より低い分離レベルです。非 JDBC データベースを使用する場合は、トランザクションの一貫性が重要でない場合にのみ、クロスパーティションスキャンを使用してください。

cross_partition_scan.enabled​

  • フィールド: scalar.db.cross_partition_scan.enabled
  • 説明: パーティション間スキャンを有効にします。
  • デフォルト値: true

cross_partition_scan.filtering.enabled​

  • フィールド: scalar.db.cross_partition_scan.filtering.enabled
  • 説明: クロスパーティションスキャンでフィルタリングを有効にします。
  • デフォルト値: false

cross_partition_scan.ordering.enabled​

  • フィールド: scalar.db.cross_partition_scan.ordering.enabled
  • 説明: パーティション間スキャンでの順序付けを有効にします。
  • デフォルト値: false

スキャンフェッチサイズ​

ストレージのスキャン操作でフェッチサイズを次のプロパティで設定できます。

scan_fetch_size​

  • フィールド: scalar.db.scan_fetch_size
  • 説明: ストレージのスキャン操作時に一度に取得するレコード数を指定します。値を大きくすると、大きな結果セットの場合にストレージへのアクセスの往復回数が減りパフォーマンスが向上しますが、メモリ使用量も増加します。値を小さくするとメモリ使用量は減りますが、レイテンシが増加する場合があります。
  • デフォルト値: 10

その他の ScalarDB 設定​

ScalarDB で使用できる追加の設定は次のとおりです。

metadata.cache_expiration_time_secs​

  • フィールド: scalar.db.metadata.cache_expiration_time_secs
  • 説明: ScalarDB には、データベースへのリクエスト数を減らすためのメタデータキャッシュがあります。この設定では、キャッシュの有効期限を秒単位で指定します。-1を指定した場合は、キャッシュは期限切れになりません。
  • デフォルト値: 60

active_transaction_management.expiration_time_millis​

  • フィールド: scalar.db.active_transaction_management.expiration_time_millis
  • 説明: ScalarDB は進行中のトランザクションを管理しており、トランザクション ID を使用して再開できます。このプロセスは、リソースリークを防ぐために、長時間アイドル状態のトランザクションを期限切れにします。この設定は、このトランザクション管理機能の有効期限をミリ秒単位で指定します。トランザクションのアイドル時間は、そのトランザクションに対して操作が実行されるたびにリセットされるため、処理を継続しているトランザクションは期限切れになりません。トランザクションが期限切れになると、ScalarDB はそのトランザクションをロールバックし、resume() メソッドを使用してトランザクションを再開しようとすると TransactionNotFoundException がスローされます。
  • デフォルト値: -1 (有効期限なし)

active_transaction_management.max_active_transactions​

  • フィールド: scalar.db.active_transaction_management.max_active_transactions
  • 説明: ScalarDB が再開のために管理する進行中のトランザクションの最大数を指定します。進行中のトランザクション数がこの値を超えると、ScalarDB はアイドル状態または最も使用頻度が低いトランザクションを優先して、管理しているトランザクションの1つを回収します。ScalarDB は回収したトランザクションを、期限切れのトランザクションと同じ方法でロールバックします。この制限は、有効期限が無効になっている場合を含め、scalar.db.active_transaction_management.expiration_time_millis の設定に関係なく適用されます。この制限を無効にするには、0 または負の値を指定してください。
  • デフォルト値: 10000

consensus_commit.include_metadata.enabled​

  • フィールド: scalar.db.consensus_commit.include_metadata.enabled
  • 説明: Consensus Commit を使用している場合に、true に設定すると、Get および Scan 操作の結果にトランザクションメタデータが含まれます。特定のテーブルのトランザクションメタデータ列の詳細を表示するには、DistributedTransactionAdmin.getTableMetadata() メソッドを使用します。このメソッドは、トランザクションメタデータ列が追加されたテーブルメタデータを返します。この設定を使用すると、トランザクション関連の問題を調査するのに役立ちます。
  • デフォルト値: false

consensus_commit.index.eventually_consistent_read.enabled​

  • フィールド: scalar.db.consensus_commit.index.eventually_consistent_read.enabled
  • 説明: Consensus Commit を使用している場合に、true に設定すると、before-image インデックスチェックがスキップされ、インデックスベース読み取りは、インデックス列が同時に更新されているレコードを見逃す可能性があります。
  • デフォルト値: false
警告

これは後方互換性オプションであり、新しいワークロードには推奨されません。詳細については、インデックスベース読み取りの正確性を参照してください。

consensus_commit.coordinator.write_set_logging.enabled​

  • フィールド: scalar.db.consensus_commit.coordinator.write_set_logging.enabled
  • 説明: Consensus Commit を使用している場合に、true に設定すると、ScalarDB は各トランザクションの書き込みセットを Coordinator テーブルに記録します。書き込みセットは、トランザクションが書き込んだレコードを識別するもので、ScalarDB はこの情報を、トランザクションを事前にリカバリするなどの機能に使用します。この設定を有効にするには、Coordinator テーブルに追加の列が必要になり、ScalarDB が Coordinator テーブルに書き込み、格納するデータ量が増加します。
  • デフォルト値: false
警告

この設定を有効にする前に作成された Coordinator テーブルには、この設定に必要な追加の列がありません。既存の Coordinator テーブルに列を追加する方法の詳細については、Coordinator の書き込みセットのロギングを参照してください。

default_namespace_name​

  • フィールド: scalar.db.default_namespace_name
  • 説明: 指定された名前空間名は、名前空間を指定していない操作によって使用されます。
  • デフォルト値: empty

プレースホルダーの使用​

値にプレースホルダーを使用できます。プレースホルダーは環境変数 (${env:<ENVIRONMENT_VARIABLE_NAME>}) またはシステムプロパティ (${sys:<SYSTEM_PROPERTY_NAME>}) に置き換えられます。また、${sys:<SYSTEM_PROPERTY_NAME>:-<DEFAULT_VALUE>} のようにプレースホルダーにデフォルト値を指定することもできます。

以下は、プレースホルダーを使用する設定の例です。

scalar.db.username=${env:SCALAR_DB_USERNAME:-admin}
scalar.db.password=${env:SCALAR_DB_PASSWORD}

この設定例では、ScalarDB は環境変数からユーザー名とパスワードを読み取ります。環境変数 SCALAR_DB_USERNAME が存在しない場合、ScalarDB はデフォルト値 admin を使用します。

設定例 - アプリとデータベース​

この設定例では、アプリ (Consensus Commit を備えた ScalarDB ライブラリ) が、基盤となるストレージまたはデータベース (この場合は Cassandra) に直接接続します。

警告

この設定は開発目的のみに存在し、実稼働環境には適していません。これは、ScalarDB のトランザクション的に一貫性のあるバックアップを取得するために、アプリが Scalar Admin インターフェースを実装する必要があり、追加の設定が必要になるためです。

以下は、ScalarDB を介してアプリを基盤となるデータベースに接続するための設定の例です。

# Transaction manager implementation.
scalar.db.transaction_manager=consensus-commit

# Storage implementation.
scalar.db.storage=cassandra

# Comma-separated contact points.
scalar.db.contact_points=<CASSANDRA_HOST>

# Credential information to access the database.
scalar.db.username=<USERNAME>
scalar.db.password=<PASSWORD>
テクニカルサポートに問い合わせ
商用ライセンスをご契約のお客様のみご利用いただけます。
ドキュメントの問題を報告
このページについて何かお気づきの点がありましたら、こちらから報告いただけます。