プロパティ(Cluster)
共通プロパティとは別に、Cluster Edition 専用の項目を説明します。
目次
- 目次
- CLUSTER_LINK_ACCEPT_TIMEOUT
- CLUSTER_LINK_BUFFER_SIZE
- CLUSTER_LINK_CHECK_INTERVAL
- CLUSTER_LINK_CONNECT_RETRY_TIMEOUT
- CLUSTER_LINK_CONNECT_TIMEOUT
- CLUSTER_LINK_ERROR_ADD_ORIGIN_HOST
- CLUSTER_LINK_HANDSHAKE_TIMEOUT
- CLUSTER_LINK_SEND_RETRY_COUNT
- CLUSTER_LINK_HOST
- CLUSTER_LINK_LONG_TERM_CALLBACK_INTERVAL
- CLUSTER_LINK_LONG_WAIT_INTERVAL
- CLUSTER_LINK_MAX_LISTEN
- CLUSTER_LINK_MAX_POLL
- CLUSTER_LINK_PORT_NO
- CLUSTER_LINK_RECEIVE_TIMEOUT
- CLUSTER_LINK_REQUEST_TIMEOUT
- CLUSTER_LINK_SEND_TIMEOUT
- CLUSTER_LINK_SESSION_TIMEOUT
- CLUSTER_LINK_THREAD_COUNT
- CLUSTER_QUERY_STAT_LOG_ENABLE
- CLUSTER_REPLICATION_BLOCK_SIZE
- CLUSTER_WAREHOUSE_DIRECT_DML_ENABLE
- COORDINATOR_DBS_PATH
- COORDINATOR_DDL_REQUEST_TIMEOUT
- COORDINATOR_DDL_TIMEOUT
- COORDINATOR_DECISION_DELAY
- COORDINATOR_DECISION_INTERVAL
- COORDINATOR_HOST_RESOURCE_ENABLE
- COORDINATOR_HOST_RESOURCE_COLLECT_INTERVAL
- COORDINATOR_HOST_RESOURCE_INTERVAL
- COORDINATOR_HOST_RESOURCE_REQUEST_TIMEOUT
- COORDINATOR_NODE_REQUEST_TIMEOUT
- COORDINATOR_NODE_TIMEOUT
- COORDINATOR_STARTUP_DELAY
- COORDINATOR_STATUS_NODE_INTERVAL
- COORDINATOR_STATUS_NODE_REQUEST_TIMEOUT
- COORDINATOR_DISK_FULL_UPPER_BOUND_RATIO
- COORDINATOR_DISK_FULL_LOWER_BOUND_RATIO
- DEPLOYER_DBS_PATH
- EXECUTION_STAGE_MEMORY_MAX
- HTTP_ADMIN_PORT
- HTTP_CONNECT_TIMEOUT
- HTTP_RECEIVE_TIMEOUT
- HTTP_SEND_TIMEOUT
- INSERT_BULK_DATA_MAX_SIZE
- INSERT_RECORD_COUNT_PER_NODE
- LOOKUPNODE_COMMAND_RETRY_MAX_COUNT
- STAGE_RESULT_BLOCK_SIZE
CLUSTER_LINK_ACCEPT_TIMEOUT
特定ノードへの接続を受け付けてから、ハンドシェイクメッセージを受信するまでの上限時間です。
時間内に受信できない場合、接続は失敗します。
既定値は 5 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 5000000 |
CLUSTER_LINK_BUFFER_SIZE
送受信要求用バッファーのサイズです。
不足する場合、送信時にバッファーが空くまで再試行します。
| (byte) | 値 |
|---|---|
| 最小値 | 1024768 |
| 最大値 | 2^32 - 1 |
| 既定値 | 33554432 (32M) |
CLUSTER_LINK_CHECK_INTERVAL
ノードに接続したソケットを監視するタイムアウトスレッドの確認間隔です。
RECEIVE_TIMEOUT と SESSION_TIMEOUT を確認します。
短いほど頻繁に確認しますが、タイムアウト判定は各設定値に従います。
既定値は 1 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 1000000 |
CLUSTER_LINK_CONNECT_RETRY_TIMEOUT
接続失敗後に再接続を試みる期間です。
この時間内に接続できなければ、完全な切断と判断します。
既定値は 1 分です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 60000000 |
CLUSTER_LINK_CONNECT_TIMEOUT
ノードへの接続試行の待ち時間です。
接続できなければ、CLUSTER_LINK_CONNECT_RETRY_TIMEOUT に達するまで再試行します。
既定値は 5 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 5000000 |
CLUSTER_LINK_ERROR_ADD_ORIGIN_HOST
クラスタ間通信のエラーに、発生元ホスト名を追加するかを指定します。
詳細を表示するには 1 にします。
既定値は 1 で、ホスト名を表示します。
| (boolean) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 1 |
| 既定値 | 1 |
CLUSTER_LINK_HANDSHAKE_TIMEOUT
クラスタソケットの接続後に、ハンドシェイク応答を待つ時間です。
接続直後の 2 ノードは、小さなメッセージを交換して状態を確認します。
受け付け側が先に送信し、その応答を待つ時間を指定します。
既定値は 5 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 5000000 |
CLUSTER_LINK_SEND_RETRY_COUNT
- 5.6 以降で使用できます。 送信バッファーが空くまでの再試行回数です。
1 回ごとに 1 ms 待機します。上限を超えると切断します。
既定値は 5000 回(各回の待機時間だけで計約 5000 ms)です。
| (count) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^32 - 1 |
| 既定値 | 5000 |
CLUSTER_LINK_HOST
他のノードとクラスタソケットで接続するための、自ノードのホスト名です。
| (string) | 値 |
|---|---|
| 既定値 | localhost |
CLUSTER_LINK_LONG_TERM_CALLBACK_INTERVAL
受信メッセージを処理するコールバックが、この時間を超えると長時間コールバックと判定します。
受信スレッド数に限りがあるため、長時間占有しないようにします。
処理が指定時間を超えると、トレースログに記録します。
既定値は 1 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 1000000 |
CLUSTER_LINK_LONG_WAIT_INTERVAL
メッセージの受信にかかる時間がこの値を超えると、長時間待機と判定します。
受信開始から完了までが長い場合、ネットワークの問題が考えられます。
指定時間を超えると、トレースログに記録します。
既定値は 1 秒です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 1000000 |
CLUSTER_LINK_MAX_LISTEN
ソケットの接続受け付けキューの最大数です。
| (count) | 値 |
|---|---|
| 最小値 | 1 |
| 最大値 | 2^31-1 |
| 既定値 | 512 |
CLUSTER_LINK_MAX_POLL
1 回の poll で取得するイベントの最大数です。
| (count) | 値 |
|---|---|
| 最小値 | 1 |
| 最大値 | 2^31-1 |
| 既定値 | 4096 |
CLUSTER_LINK_PORT_NO
クラスタソケットで他のノードと接続するための、自ノードのポートです。
| (port) | 値 |
|---|---|
| 最小値 | 1024 |
| 最大値 | 65535 |
| 既定値 | 3868 |
CLUSTER_LINK_RECEIVE_TIMEOUT
最終受信から、切断と判断するまでの時間です。
クラスタノード間の受信完了時に接続を終了するため、リンクリストに残る接続は受信を継続している必要があります。
指定時間が経っても最終受信時刻が更新されなければ、ログを記録してソケットを閉じます。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 30000000 |
CLUSTER_LINK_REQUEST_TIMEOUT
要求送信から応答受信までの上限時間です。
メッセージの要求後に、応答を待つ時間を指定します。
時間内に応答がなければ、ログを記録してソケットを閉じます。
要求や処理の種類によって時間が変わるため、既定では 60 秒の余裕を持たせています。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 60000000 |
CLUSTER_LINK_SEND_TIMEOUT
クラスタソケットでのメッセージ送信のタイムアウトです。
送信時に適用します。
時間内に完了しなければ、トレースログに記録します。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 30000000 |
CLUSTER_LINK_SESSION_TIMEOUT
セッションの最終受信から、切断と判断するまでの時間です。
クラスタ接続は各メッセージのセッションを内部管理します。セッションが不定な状態になった場合の対処に使用します。
指定時間内に受信時刻が更新されなければ、ログを記録してセッションを閉じます。
既定値は 1 時間です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64-1 |
| 既定値 | 3600000000 |
CLUSTER_LINK_THREAD_COUNT
受信メッセージを処理するスレッド数です。
クラスタや処理量の拡大に応じて増やせます。
| (count) | 値 |
|---|---|
| 最小値 | 1 |
| 最大値 | 4096 |
| 既定値 | 16 |
CLUSTER_QUERY_STAT_LOG_ENABLE
実行したクエリーの統計をトレースログに出力します。
| (boolean) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 1 |
| 既定値 | 0 |
CLUSTER_REPLICATION_BLOCK_SIZE
ノード追加時のレプリケーションで、1 回に送信するデータサイズです。
送信元となるアクティブ Warehouse に直接設定します。
既定値は 640 KB です。
| (size) | 値 |
|---|---|
| 最小値 | 64 * 1024 |
| 最大値 | 100 * 1024 * 1024 |
| 既定値 | 640 * 1024 (655360) |
CLUSTER_WAREHOUSE_DIRECT_DML_ENABLE
Warehouse に直接接続して DML を実行することを許可します。
- 1:実行可能。
- 0:実行不可。エラーを返します。
Broker 経由より高速ですが、同じグループの他ノードに DML が伝播しません。
データ不一致の緊急復旧など、不整合を考慮できる場合に限り使用してください。
対象 Warehouse に直接設定します。
既定値は 0 です。
| (boolean) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 1 |
| 既定値 | 0 |
COORDINATOR_DBS_PATH
Coordinator のデータファイルの保存先です。
既定値は ?/dbs で、? は $MACHBASE_COORDINATOR_HOME に置換されます。
つまり $MACHBASE_COORDINATOR_HOME/dbs です。
Coordinator に設定します。他のノードには効果がありません。
| (path) | 値 |
|---|---|
| 既定値 | ?/dbs |
COORDINATOR_DDL_REQUEST_TIMEOUT
Coordinator がノードに DDL を要求してから待つ上限時間です。
各ノードへの要求単位に適用します。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 300000000 |
COORDINATOR_DDL_TIMEOUT
Broker が Coordinator に DDL を要求してから待つ上限時間です。
クラスタ全体に対する DDL の完了待ちに適用します。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 300000000 |
COORDINATOR_DECISION_DELAY
Coordinator が状態変更を要求してから、反映されるまでの上限時間です。
時間内に変わらなければ、クラスタを無効な状態にします。
アクティブ Warehouse の状態が変わらず、接続されたスタンバイがある場合はフェイルオーバーを開始します。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1000000 |
COORDINATOR_DECISION_INTERVAL
Coordinator が状態変更を判断する間隔です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1000000 |
COORDINATOR_HOST_RESOURCE_ENABLE
Coordinator が各ノードのホストリソース情報を収集するかを指定します。
| (boolean) | 値 |
|---|---|
| 最小値 | 0 (false) |
| 最大値 | 1 (true) |
| 既定値 | 0 (false) |
COORDINATOR_HOST_RESOURCE_COLLECT_INTERVAL
各ノードがホストリソースを収集する間隔です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1000000 |
COORDINATOR_HOST_RESOURCE_INTERVAL
Coordinator と各ノードがリソース情報を交換する間隔です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1000000 |
COORDINATOR_HOST_RESOURCE_REQUEST_TIMEOUT
リソース情報を要求してから待つ上限時間です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 10000000 |
COORDINATOR_NODE_REQUEST_TIMEOUT
ノードへコマンド実行を要求してから待つ上限時間です。
ノードやパッケージの追加、削除にはノード上の処理があるため、短すぎると完了前にタイムアウトする場合があります。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 600000000 |
COORDINATOR_NODE_TIMEOUT
ノードの障害と判断するまでの待ち時間です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 30000000 |
COORDINATOR_STARTUP_DELAY
Coordinator 起動後に、判定スレッドを開始するまでの猶予時間です。
クラスタ全体の起動に時間がかかる場合は、大きくしてノード制御の開始を遅らせます。
全体の起動前に判定を始めると、誤判定の可能性が高くなります。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 3000000 |
COORDINATOR_STATUS_NODE_INTERVAL
ノードの状態照会メッセージを交換する間隔です。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1000000 |
COORDINATOR_STATUS_NODE_REQUEST_TIMEOUT
状態を要求してから応答を待つ時間です。
応答がなければ、該当ノードの状態を更新せずに続行します。
ネットワークが遅い場合は、値を増やすことを検討できます。
ただし、無応答の場合も、その分だけ待ち時間が長くなります。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 15000000 |
COORDINATOR_DISK_FULL_UPPER_BOUND_RATIO
クラスタ内サーバーのディスク使用率がこの値を超えると、その Warehouse グループを DISKFULL にします。
DISKFULL では入力を制限し、検索と削除だけが可能です。
0 で無効になります。
| (percent) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 99 |
| 既定値 | 0 |
COORDINATOR_DISK_FULL_LOWER_BOUND_RATIO
DISKFULL のサーバーの使用率がこの値未満になると、グループを通常状態へ戻します。
0 で無効になります。
| (percent) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 99 |
| 既定値 | 0 |
DEPLOYER_DBS_PATH
Deployer のデータファイルの保存先です。
既定値は ?/dbs で、? は $MACHBASE_DEPLOYER_HOME に置換されます。
つまり $MACHBASE_DEPLOYER_HOME/dbs です。
Deployer に設定します。他のノードには効果がありません。
| (path) | 値 |
|---|---|
| 既定値 | ?/dbs |
EXECUTION_STAGE_MEMORY_MAX
SELECT を処理する Stage スレッドごとの最大メモリ量です。
Stage ごとの上限なので、複雑な検索で Stage が増えると、全体のメモリ量も増えます。
いずれかの Stage が上限を超えると、Stage とクエリーを取り消してエラーにします。
対象 Warehouse に直接設定します。
既定値は 1GB です。
| (size) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 1024 *1024 * 1024 |
HTTP_ADMIN_PORT
MWA または machcoordinatoradmin の要求を受けるポートです。
| (port) | 値 |
|---|---|
| 最小値 | 1024 |
| 最大値 | 65535 |
| 既定値 | 5779 |
HTTP_CONNECT_TIMEOUT
machcoordinatoradmin との接続時のタイムアウトです。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 30000000 |
HTTP_RECEIVE_TIMEOUT
machcoordinatoradmin との受信時のタイムアウトです。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 3600000000 |
HTTP_SEND_TIMEOUT
machcoordinatoradmin との送信時のタイムアウトです。
| (usec) | 値 |
|---|---|
| 最小値 | 0 |
| 最大値 | 2^64 - 1 |
| 既定値 | 60000000 |
INSERT_BULK_DATA_MAX_SIZE
APPEND または INSERT-SELECT の入力ブロックの最大サイズです。
| (size) | 値 |
|---|---|
| 最小値 | 1024 |
| 最大値 | 10 * 1024 * 1024 |
| 既定値 | 1024 * 1024 |
INSERT_RECORD_COUNT_PER_NODE
入力先 Warehouse グループを切り替えるまでのレコード数です。
| (count) | 値 |
|---|---|
| 最小値 | 1 |
| 最大値 | 2^32 - 1 |
| 既定値 | 1000 |
LOOKUPNODE_COMMAND_RETRY_MAX_COUNT
Lookup への接続やコマンドが失敗した場合の最大再試行回数です。
| (count) | 値 |
|---|---|
| 最小値 | 1 |
| 最大値 | 3600 |
| 既定値 | 30 |
STAGE_RESULT_BLOCK_SIZE
1 Stage で作成するブロックの最大サイズです。
| (size) | 値 |
|---|---|
| 最小値 | 1024 |
| 最大値 | 2^32 - 1 |
| 既定値 | 1024 * 1024 |