プロパティ（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_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_RETRY_COUNT
  • 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

特定ノードとの接続で、Accept してからハンドシェイクメッセージを受信するまでの上限時間です。

時間内に受信できない場合、接続は失敗します。

既定値は 5 秒です。

CLUSTER_LINK_BUFFER_SIZE

送受信バッファーのサイズです。

不足する場合、送信時にバッファーが空くまで再試行します。

CLUSTER_LINK_CHECK_INTERVAL

特定ノードに接続したソケットを監視するタイムアウトスレッドの確認間隔です。

タイムアウトスレッドは RECEIVE_TIMEOUT と SESSION_TIMEOUT を確認します。

短いほど頻繁に確認しますが、タイムアウトの判定は各タイムアウト値に従います。

既定値は 1 秒です。

CLUSTER_LINK_CONNECT_RETRY_TIMEOUT

特定ノードとの接続に失敗した後、再接続を繰り返す上限時間です。

この時間内に再接続できなければ、完全に切断されたと判断します。

既定値は 1 分です。

CLUSTER_LINK_CONNECT_TIMEOUT

特定ノードへの接続を試みるときの待ち時間です。

時間内に接続できなければ、CLUSTER_LINK_CONNECT_RETRY_TIMEOUT に達するまで再接続を試みます。

既定値は 5 秒です。

CLUSTER_LINK_ERROR_ADD_ORIGIN_HOST

クラスタ内の通信で発生したエラーメッセージに、エラーが発生したホスト名を追加するかを指定します。

詳細なエラーメッセージを表示するには 1 にします。

既定値は 1 で、ホスト名を表示します。

CLUSTER_LINK_HANDSHAKE_TIMEOUT

特定ノードとクラスタソケットで接続した状態で、ハンドシェイクメッセージを受信するまでの上限時間です。

接続直後の 2 つのノードは、接続状態を確認するために小さなハンドシェイクメッセージを交換します。

Accept した側のノードが先にハンドシェイクメッセージを送信し、その応答を待つ時間をここで指定します。

既定値は 5 秒です。

CLUSTER_LINK_HOST

特定ノードとクラスタソケットで接続するための、自ノードのホスト名です。

CLUSTER_LINK_LONG_TERM_CALLBACK_INTERVAL

クラスタソケットで受信したメッセージを処理する Receive Callback の実行時間がこの値を超えると、Long-Term Callback と判定します。

受信スレッド数には限りがあるため、Receive Callback が長時間メッセージを処理し続けないようにします。

この時間を過ぎても処理中の場合は Long-Term Callback と判定し、トレースログに記録します。

既定値は 1 秒です。

CLUSTER_LINK_LONG_WAIT_INTERVAL

クラスタソケットでメッセージが届くまでの時間がこの値を超えると、Long-Wait Message と判定します。

受信開始から完了までが長い場合は、ネットワーク環境の問題が考えられます。

この時間を過ぎても受信メッセージが届かない場合は Long-Wait Message と判定し、トレースログに記録します。

既定値は 1 秒です。

CLUSTER_LINK_MAX_LISTEN

特定ノードとの接続時に使用する、ソケットの Accept キューの最大数です。

CLUSTER_LINK_MAX_POLL

特定ノードとの通信時に、1 回の poll で取得できるイベントの最大数です。

CLUSTER_LINK_PORT_NO

特定ノードとクラスタソケットで接続するための、自ノードのポート番号です。

CLUSTER_LINK_RECEIVE_TIMEOUT

タイムアウトスレッドが、最終受信以降に接続が切れたと判断するまでの時間です。

クラスタノード間の接続は受信が完了すると終了するため、リンクリストに残る接続は受信を継続している必要があります。

この時間が経っても最終受信時刻が更新されなければ、タイムアウトスレッドはトレースログに記録してソケットを閉じます。

CLUSTER_LINK_REQUEST_TIMEOUT

クラスタソケットで要求メッセージを送信してから、その応答を受信するまでの上限時間です。

特定のメッセージについて、要求後に応答が送信されるまで待つ時間を指定します。

時間内に応答メッセージが届かなければ、トレースログに記録してソケットを閉じます。

既定値は 60 秒です。メッセージの種類や受信側の処理が事前に分からないため、長めに設定しています。

CLUSTER_LINK_SEND_RETRY_COUNT

• 5.6 以降で使用できます。

送信バッファーが空くまで送信を再試行する回数です。

再試行のたびに 1 ms 待機します。この回数を超えて再試行することになると、接続を切断します。

既定値は 5000 回です（各回の待機時間だけで計約 5000 ms）。

CLUSTER_LINK_SEND_TIMEOUT

クラスタソケットでメッセージを送信するときのタイムアウトです。

送信時にこのタイムアウトを適用します。

時間内に送信が完了しなければ、トレースログに記録します。

CLUSTER_LINK_SESSION_TIMEOUT

タイムアウトスレッドが、特定セッションの最終受信以降に接続が切れたと判断するまでの時間です。

クラスタ接続は、すべてのメッセージのセッションを内部で管理します。このプロパティは、セッションを突然整理できなくなった場合に必要です。

この時間が経ってもセッションの最終受信時刻が更新されなければ、タイムアウトスレッドはトレースログに記録してセッションを閉じます。

既定値は 1 時間です。

CLUSTER_LINK_THREAD_COUNT

特定ノードとの通信時に、受信したメッセージを処理するスレッド数です。

クラスタの規模が大きくなったり処理する演算が増えたりして、受信スレッドに余裕がない場合に増やせます。

CLUSTER_QUERY_STAT_LOG_ENABLE

実行したクエリーの統計情報をトレースログに出力します。

CLUSTER_REPLICATION_BLOCK_SIZE

Cluster Edition でノード追加によるレプリケーションを行うときに、1 回で送信するデータサイズです。

Replication Active となる Warehouse（送信側の Warehouse）に直接設定する必要があります。

既定値は 640KB です。

CLUSTER_WAREHOUSE_DIRECT_DML_ENABLE

Cluster Edition で、Warehouse に直接接続して DML を実行できるようにします。

• 1：実行できます。
• 0：実行できません。エラーを返します。

Warehouse で直接 DML を実行すると Broker 経由より性能面で有利ですが、同じグループに DML が伝播しません。 そのため、データ不一致からの緊急復旧や、グループ内のデータ不一致を許容できる場合に限り使用してください。

対象の Warehouse に直接設定する必要があります。

既定値は 0 です。

COORDINATOR_DBS_PATH

Coordinator のデータファイルを作成するディレクトリを指定します。

既定値は ?/dbs で、? は環境変数 $MACHBASE_COORDINATOR_HOME に置換されます。 つまり $MACHBASE_COORDINATOR_HOME/dbs ディレクトリを意味します。

Coordinator に設定します。他のノードには効果がありません。

COORDINATOR_DDL_REQUEST_TIMEOUT

Coordinator がノードに DDL の実行を要求してから待つ上限時間です。

この値は、Coordinator が各ノードに DDL の実行を要求してから待つ時間を意味します。

COORDINATOR_DDL_TIMEOUT

Broker が Coordinator に DDL の実行を要求してから待つ上限時間です。

この値は、Broker がクラスタ全体に対する DDL の実行を Coordinator に要求してから待つ時間を意味します。

COORDINATOR_DECISION_DELAY

Coordinator が状態変更を要求してから、実際に反映されるまでの上限時間です。

この時間内に状態が実際に変わらなければ、クラスタの状態を無効にします。

Warehouse Active の状態が変わっておらず、接続されたスタンバイがある場合は、フェイルオーバーを開始します。

COORDINATOR_DECISION_INTERVAL

Coordinator が状態変更を判断する頻度を決める時間です。

COORDINATOR_HOST_RESOURCE_ENABLE

Coordinator がクラスタノードのホストリソースを収集するかを指定します。

COORDINATOR_HOST_RESOURCE_COLLECT_INTERVAL

クラスタノードがホストリソースを収集する間隔です。

COORDINATOR_HOST_RESOURCE_INTERVAL

Coordinator とノードがホストリソース情報を交換する間隔です。

COORDINATOR_HOST_RESOURCE_REQUEST_TIMEOUT

Coordinator がノードにホストリソース情報を要求してから待つ時間です。

COORDINATOR_NODE_REQUEST_TIMEOUT

Coordinator がノードにコマンドの実行を要求してから待つ上限時間です。

Add/Remove-node、Add/Remove-Package などのノードコマンドの実行を含むため、短すぎるとコマンドの処理が完了しない場合があります。

COORDINATOR_NODE_TIMEOUT

Coordinator がノードの障害と判断するまでの待ち時間です。

COORDINATOR_STARTUP_DELAY

Coordinator の起動直後から、判定スレッド（Decision Thread）を開始するまでの猶予時間です。

クラスタ全体の起動に時間がかかる場合は、この値を大きくして Coordinator によるノード制御の開始を遅らせることができます。

全体の起動が終わる前に判定スレッドが動作すると、Coordinator が誤判定する可能性が高くなります。

COORDINATOR_STATUS_NODE_INTERVAL

Coordinator がノードと状態照会メッセージを交換する間隔です。

COORDINATOR_STATUS_NODE_REQUEST_TIMEOUT

Coordinator がノードに状態照会を要求してから待つ時間です。

この時間内に応答がなければ、Coordinator は該当ノードの状態を更新せずに続行します。

ネットワークの状態が悪く、状態を必ず更新する必要がある場合は、値を増やすことを検討できます。

ただし、応答がない場合は、増やした分だけ Coordinator が必ず待つことになります。

COORDINATOR_DISK_FULL_UPPER_BOUND_RATIO

クラスタを構成する一部のサーバーでディスク使用率がこの値を超えると、そのホストが属する Warehouse グループを DISKFULL 状態にします。

DISKFULL 状態のグループでは入力が制限され、検索と削除だけが可能です。

0 の場合、この機能は無効です。

COORDINATOR_DISK_FULL_LOWER_BOUND_RATIO

DISKFULL 状態で動作しているサーバーのディスク使用率がこの値未満になると、そのグループを通常状態へ戻します。

0 の場合、この機能は無効です。

DEPLOYER_DBS_PATH

Deployer のデータファイルを作成するディレクトリを指定します。

既定値は ?/dbs で、? は環境変数 $MACHBASE_DEPLOYER_HOME に置換されます。 つまり $MACHBASE_DEPLOYER_HOME/dbs ディレクトリを意味します。

Deployer に設定します。他のノードには効果がありません。

EXECUTION_STAGE_MEMORY_MAX

Cluster Edition で SELECT クエリーを実行する Stage スレッドが使用するメモリの最大量です。

Stage ごとの上限なので、Stage 数が増える複雑な SELECT クエリーでは、必要なメモリが増える場合があります。 上限を超える Stage があると、その Stage は取り消され、クエリーもエラーとともに取り消されます。

対象の Warehouse に直接設定する必要があります。

既定値は 1GB です。

HTTP_ADMIN_PORT

MWA または machcoordinatoradmin からの要求を受け付けるポート番号です。

HTTP_CONNECT_TIMEOUT

machcoordinatoradmin との接続時に使用するタイムアウトです。

HTTP_RECEIVE_TIMEOUT

machcoordinatoradmin との通信で、受信時に使用するタイムアウトです。

HTTP_SEND_TIMEOUT

machcoordinatoradmin との通信で、送信時に使用するタイムアウトです。

INSERT_BULK_DATA_MAX_SIZE

Append または INSERT-SELECT の実行時に使用する入力データブロックの最大サイズです。

INSERT_RECORD_COUNT_PER_NODE

入力時に、入力先の Warehouse グループを切り替えるまでのデータ入力件数です。

LOOKUPNODE_COMMAND_RETRY_MAX_COUNT

Lookup ノードへのコマンドや接続が失敗した場合の再試行回数です。

STAGE_RESULT_BLOCK_SIZE

1 つの Stage で作成するブロックの最大サイズです。