コンテンツにスキップ
Machbase DBMS 8.5 マニュアル
設定
プロパティ

プロパティ

サーバーの設定を、$MACHBASE_HOME/conf/machbase.conf にキーと値の組として保存します。 起動時に読み込まれ、稼働中に使用されます。性能調整で変更する場合は、各項目の意味を理解して慎重に設定してください。

目次

CPU_AFFINITY_BEGIN_ID

使用する CPU の開始番号です。CPU の使用範囲を制御します。

値
最小値0
最大値2 ^ 32 - 1
既定値0

CPU_AFFINITY_COUNT

使用する CPU 数です。0 はすべての CPU を使用します。

値
最小値0
最大値2 ^ 32 - 1
既定値0

CPU_COUNT

システムの CPU 数を指定し、スレッド数の決定に使用します。0 は実際の全 CPU を使用します。

値
最小値0（実装 CPU 数を自動検出）
最大値2 ^ 32 - 1
既定値1

CPU_PARALLEL

CPU あたりのスレッド数です。値が 2、CPU 数が 2 なら、合計 4 並列になります。大きすぎるとメモリを多く消費します。

値
最小値1
最大値2 ^ 32 - 1
既定値1

DBS_PATH

基本データの保存先です。既定は ?/dbs、つまり $MACHBASE_HOME/dbs です。

値
既定値?/dbs

DEFAULT_LSM_MAX_LEVEL

LSM の既定レベルです。CREATE INDEX で MAX_LEVEL を省略すると適用します。

値
最小値0
最大値3
既定値2

DISK_BUFFER_COUNT

ディスク I/O バッファーの数です。

値
最小値1
最大値2^32 - 1
既定値16

DISK_COLUMNAR_INDEX_CHECKPOINT_INTERVAL_SEC

インデックスのチェックポイント間隔です。長すぎると構築時にエラーが発生する場合があります。

値
最小値1 (sec)
最大値2^32 -1 (sec)
既定値120 (sec)

DISK_COLUMNAR_INDEX_FDCACHE_COUNT

開いておくインデックスパーティションのファイルディスクリプター数です。

値
最小値0
最大値2 ^ 32 - 1
既定値0

DISK_COLUMNAR_INDEX_SHUTDOWN_BUILD_FINISH

停止時にインデックス情報をディスクへ反映するかを指定します。1 はすべて反映してから終了するため、待ち時間が長くなる場合があります。

値
最小値0 (false)
最大値1 (True)
既定値0 (False)

DISK_COLUMNAR_PAGE_CACHE_MAX_SIZE

ページキャッシュの最大サイズです。

値
最小値0
最大値2^64 - 1
既定値32 * 1024 * 1024

DISK_COLUMNAR_TABLE_CHECKPOINT_INTERVAL_SEC

テーブルデータのチェックポイント間隔です。長すぎると再起動時の復旧が長くなり、短すぎると I/O が増えて性能が低下します。

値
最小値1 (sec)
最大値2 ^ 32 - 1 (sec)
既定値120 (sec)

DISK_COLUMNAR_TABLE_COLUMN_FDCACHE_COUNT

テーブルの列データ用に開くファイルディスクリプターの最大数です。

値
最小値0
最大値2 ^ 32 - 1
既定値0

DISK_COLUMNAR_TABLE_COLUMN_MINMAX_CACHE_SIZE

_ARRIVAL_TIME の既定の MINMAX キャッシュサイズです。

値
最小値0
最大値2 ^ 64 - 1
既定値100 *1024 * 1024

DISK_COLUMNAR_TABLE_COLUMN_PART_FLUSH_MODE

列パーティションが満杯の場合だけフラッシュするかを指定します。

値
最小値0
最大値1
既定値0

DISK_COLUMNAR_TABLE_COLUMN_PART_IO_INTERVAL_MIN_SEC

パーティションファイルをディスクへ反映する間隔です。設定したパーティション数を超える入力がある場合は、間隔に関係なく反映します。

値
最小値0 (sec)
最大値2^32-1 (sec)
既定値3 (sec)

DISK_COLUMNAR_TABLE_TIME_INVERSION_MODE

1 は _ARRIVAL_TIME が小さくなる入力も許可します。0 は、既存の最大時刻より前の値をエラーにします。

値
最小値0 (False)
最大値1 (True)
既定値1 (True)

DISK_COLUMNAR_TABLESPACE_DWFILE_EXT_SIZE

起動時の復旧に使用する二重書き込みファイルの、1 回の拡張サイズです。

値
最小値1024 * 1024
最大値2^32 - 1
既定値1024 * 1024

DISK_COLUMNAR_TABLESPACE_DWFILE_INT_SIZE

二重書き込みファイルの作成時に確保する領域です。

値
最小値1024 * 1024
最大値2^32 - 1
既定値2 * 1024 * 1024

DISK_COLUMNAR_TABLESPACE_MEMORY_EXT_SIZE

列パーティション用に確保するメモリブロックのサイズです。

値
最小値1024 * 1024
最大値2^64 - 1
既定値2 * 1024 * 1024

DISK_COLUMNAR_TABLESPACE_MEMORY_MAX_SIZE

Log テーブルの最大メモリ量です。上限を超える場合、使用量が下がるまで確保を待ちます。物理メモリの 50～80% を推奨します。

値
最小値256 * 1024 * 1024
最大値2^64 - 1
既定値8 * 1024 * 1024 * 1024

DISK_COLUMNAR_TABLESPACE_MEMORY_MIN_SIZE

起動時に事前確保するメモリです。実行中の確保による性能低下を防ぎます。入力バッファー専用なので、メモリに余裕がある場合だけ使用してください。

表 24．値の範囲

値
最小値1024 * 1024
最大値2^64 - 1
既定値100 * 1024 * 1024

DISK_COLUMNAR_TABLESPACE_MEMORY_SLOWDOWN_HIGH_LIMIT_PCT

Log の入力時にメモリ使用量が指定値を超えると、入力速度を制限します。

DISK_COLUMNAR_TABLESPACE_MEMORY_MAX_SIZE * (DISK_COLUMNAR_TABLESPACE_MEMORY_SLOWDOWN_HIGH_LIMIT_PCT / 100)
値
最小値0
最大値100
既定値80

DISK_COLUMNAR_TABLESPACE_MEMORY_SLOWDOWN_MSEC

列データファイル用のメモリ使用量が基準を超えた場合、レコード入力ごとの待ち時間を指定します。

値
最小値0 (msec)
最大値2^32 - 1 (msec)
既定値1 (msec)

DISK_IO_THREAD_COUNT

ディスクへ書き込む I/O スレッド数です。

値
最小値1
最大値2^32 - 1
既定値3

DISK_TABLESPACE_DIRECT_IO_FSYNC

Direct I/O では、データファイルの fsync を省略（0）すると I/O 性能を改善できます。 ただし、停電などの障害時のデータ保護が必要な場合は fsync を有効にしてください。通常時に損失がなくても、障害時には同期が必要です。

値
最小値0
最大値1
既定値0

DISK_TABLESPACE_DIRECT_IO_READ

読み取りに Direct I/O を使用するかを指定します。

値
最小値0
最大値1
既定値0

DISK_TABLESPACE_DIRECT_IO_WRITE

書き込みに Direct I/O を使用するかを指定します。ZFS など未対応のファイルシステムでは 0 にしてください。

値
最小値0
最大値1
既定値1

DISK_TABLESPACE_SYNCHRONOUS

ディスクテーブルスペースの同期ポリシーです。

値モード説明
0OFF同期しない
1NORMAL二重書き込みファイルへの書き込み時とバックアップ時に同期
2FULLNORMAL に加え、ファイルクローズ時と end-RID 調整時に同期
3EXTRAFULL に加え、書き込みごとに同期
値
最小値0
最大値3
既定値1

DUMP_APPEND_ERROR

1 にすると APPEND API のエラーを $MACHBASE_HOME/trc/machbase.trc に記録します。 入力性能が大きく低下するため、テスト用途に限定することを推奨します。

アプリケーションで確認するには SQLAppendSetErrorCallback を使用します。

値
最小値0
最大値1
既定値0

DUMP_TRACE_INFO

DBMS の状態を machbase.trc に定期記録する間隔です。 0 は記録しません。

値
最小値0 (sec)
最大値2^32 - 1 (sec)
既定値300 (sec)

DURATION_BEGIN

DURATION を省略した SELECT の検索範囲について、新しい側の基準時刻を現在から何秒さかのぼるか指定します。 60 なら新しい側の時刻は現在の 60 秒前です。

DURATION_BEGIN と DURATION_GAP が両方とも 0 の場合、既定の時間範囲を適用せず、全データを対象にします。

値
最小値0
最大値2^32 - 1
既定値0

DURATION_GAP

DURATION を省略した SELECT で、新しい側の基準時刻から過去にさかのぼる検索期間（秒）を指定します。

  • DURATION_BEGIN が 0、DURATION_GAP が 60 なら、現在の 60 秒前から現在までが対象です。
  • 両方が 60 なら、現在の 120 秒前から 60 秒前までが対象です。

両方が 0 の場合は全データを対象にします。時間範囲を設定する場合は、DURATION_GAP に正の値を指定してください。

値
最小値0
最大値2^31 - 1
既定値0

ENABLE_CASE_SENSITIVE_PASSWORD

パスワードの大文字と小文字を区別するかを指定します。

  • 0：区別しない。作成、変更、認証時に大文字へ変換。
  • 1：区別する。
値
最小値0
最大値1
既定値0

FEEDBACK_APPEND_ERROR

APPEND エラーをクライアントへ送信するかを指定します。0 は送信なし、1 はエラー情報を送信します。

値
最小値0
最大値1
既定値1

GEN_CALLSTACK_FOR_ABORT_ERROR

異常終了後にコールスタックを記録するかを指定します。

値
最小値0
最大値1
既定値0

GEN_CORE_FILE

異常終了後にコアファイルを記録するかを指定します。

値
最小値0
最大値1
既定値1

GRANT_REMOTE_ACCESS

リモート接続を許可するかを指定します。0 は拒否します。

値
最小値0 (False)
最大値1 (True)
既定値1 (True)

BIND_IP_ADDRESS

INET/HTTP のバインド IP です。ネイティブ INET は GRANT_REMOTE_ACCESS=1 の場合だけこの値を使用し、0 の場合はループバックにバインドします。HTTP は常に BIND_IP_ADDRESS を使用するため、HTTP もローカルに限定する場合は 127.0.0.1 を指定してください。0.0.0.0 はすべてのインターフェースを意味します。

項目値
既定値0.0.0.0
値
既定値0.0.0.0

HTTP_AUTH

REST API の Basic 認証を有効にするかを指定します。

値
最小値0
最大値1
既定値0

HTTP_ENABLE

REST API サービスを有効にするかを指定します。

値
最小値0
最大値1
既定値1

HTTP_MAX_MEM

Web セッションごとの最大メモリ量です。

値
最小値1 * 1024 * 1024
最大値2^64 - 1
既定値536870912 (512MB)

HTTP_PORT_NO

REST API のポートです。

値
最小値1024
最大値65535
既定値5657

HTTP_THREAD_COUNT

Web サーバーのスレッド数です。

値
最小値0
最大値1024
既定値2

INDEX_BUILD_MAX_ROW_COUNT_PER_THREAD

未索引のレコード数がこの値を超えると、構築スレッドがインデックスの追加を開始します。

値
最小値1
最大値2^32 - 1
既定値100000

INDEX_BUILD_THREAD_COUNT

インデックス構築スレッド数です。0 は構築しません。

値
最小値0
最大値2^32 - 1
既定値3

INDEX_FLUSH_MAX_REQUEST_COUNT_PER_INDEX

インデックスごとの最大フラッシュ要求数です。

値
最小値1
最大値2^32 - 1
既定値3

INDEX_LEVEL_PARTITION_AGER_THREAD_COUNT

LSM 構築後に不要なファイルを削除するスレッド数です。

値
最小値1
最大値1024
既定値1

INDEX_LEVEL_PARTITION_BUILD_MEMORY_HIGH_LIMIT_PCT

LSM 構築の最大メモリ使用率です。Machbase の最大メモリ量を基準にします。上限を超えると、LSM のパーティションマージを停止します。

値
最小値0
最大値100
既定値70

INDEX_LEVEL_PARTITION_BUILD_THREAD_COUNT

LSM 構築でマージを実行するスレッド数です。

値
最小値1
最大値1024
既定値3

LIN_HASH_BIT_SIZE

内部の線形ハッシュの初期バケットビット幅です。型は UINT32。変更によりハッシュ処理の内部スキャン順が変わるため、ORDER BY のないクエリーは以前と異なる順になる場合があります。

値
最小値1
最大値31
既定値7

確認SQL 

SELECT name, value, type, min_value, max_value
  FROM v$property
 WHERE name = 'LIN_HASH_BIT_SIZE';

LOOKUP_APPEND_UPDATE_ON_DUPKEY

Lookup への APPEND で主キーが重複した場合の動作です。

  • 0：失敗。
  • 1：該当主キーの行を更新。
値
最小値0
最大値1
既定値0

MAX_QPX_MEM

クエリープロセッサーが GROUP BY、DISTINCT、ORDER BY に使用する最大メモリ量です。 1 クエリーが超過すると取り消し、クライアントへエラーを返して machbase.trc に記録します。

値
最小値1024 * 1024
最大値2^64 - 1
既定値1024 * 1024 * 1024

MAX_SESSION_COUNT

最大同時セッション数です。上限を超える新規接続は拒否します。

値
最小値64
最大値2^64 - 1
既定値4096

MAX_STMT_COUNT_PER_SESSION

セッションあたりの最大ステートメント数です。超過すると作成に失敗します。

値
最小値512
最大値2^32 - 1
既定値1024

SESSION_IDLE_TIMEOUT_SEC

アイドル時間の上限（秒）です。超えると切断します。0 は無効です。

値
最小値0 (sec)
最大値2^64 - 1 (sec)
既定値0 (sec)

SESSION_QUERY_TIMEOUT_SEC

クエリー時間の上限（秒）です。超えると取り消します。0 は無効です。

値
最小値0 (sec)
最大値2^64 - 1 (sec)
既定値0 (sec)

MEMORY_ROW_TEMP_TABLE_PAGESIZE

Volatile/Lookup 用の一時テーブルスペースのページサイズです。レコードを格納するため、最大レコードサイズより大きくします。 1 ページに N 行を格納する場合は、最大レコードサイズ × N を指定します。

値
最小値8 * 1024
最大値2^32 - 1
既定値32 * 1024

PID_PATH

サーバープロセスの PID ファイルの保存先です。既定値 ?/conf は $MACHBASE_HOME/conf を表します。

値
既定値?/conf
PID_PATH の値PID ファイルの保存先
未指定$MACHBASE_HOME/conf/machbase.pid
?/test$MACHBASE_HOME/test/machbase.pid
/tmp/tmp/machbase.pid

PORT_NO

クライアントとの TCP/IP 通信ポートです。既定値は 5656 です。

値
最小値1024
最大値65535
既定値5656

PROCESS_MAX_SIZE

サーバープロセス machbased の最大メモリ量です。超過時は、使用量を抑えるために次のように動作します。

  • 入力を停止、またはエラーにする。
  • インデックス構築速度を下げる。

性能が大きく低下するため、過剰使用の原因を調査して解消してください。

値
最小値32 * 1024 * 1024
最大値2^64 - 1
既定値8 * 1024 * 1024 * 1024

PVO_CACHE_ENABLE

グローバル PVO ステートメントキャッシュの有効/無効です。Standard 専用です。

値
最小値0 (無効)
最大値1 (有効)
既定値1

PVO_CACHE_SHARD_COUNT

PVO キャッシュのシャード数です。起動時のみ適用し、変更には再起動が必要です。

値
最小値1
最大値256
既定値16

PVO_CACHE_MAX_MEMORY_SIZE

PVO キャッシュ全体のメモリ上限（バイト）です。シャードに均等に分配されます。動的変更できます。

値
最小値32768
最大値2^64 - 1
既定値268435456

PVO_CACHE_MAX_PLANS_PER_SQL

SQL ごとにキャッシュするプラン（ハンドル）の最大数です。動的変更できます。

値
最小値1
最大値512
既定値512

PVO_CACHE_MAX_SQL_ENTRIES

PVO キャッシュの SQL エントリー上限です。0 は無制限。シャードに分配され、動的変更できます。

値
最小値0
最大値2^64 - 1
既定値0

QUERY_PARALLEL_FACTOR

並列クエリーの実行スレッド数です。 Standard の既定値は 0、Cluster は 4 です。

値
最小値0
最大値100
既定値0

ROLLUP_FETCH_COUNT_LIMIT

ロールアップスレッドが 1 回で取得するデータ量を制限します。

0 は無制限です。

値
最小値0
最大値2^32 - 1
既定値3000000

RS_CACHE_APPROXIMATE_RESULT_ENABLE

結果キャッシュの近似モードです。1 は推測値を使用して高速ですが、不正確な場合があります。0 は正確な値を取得します。

値
最小値0 (false)
最大値1 (True)
既定値0 (False)

RS_CACHE_ENABLE

結果キャッシュを使用するかを指定します。

値
最小値0 (false)
最大値1 (True)
既定値1 (True)

RS_CACHE_MAX_MEMORY_PER_QUERY

1 つのクエリー結果に使うキャッシュメモリの上限です。超える結果は保存しません。

値
最小値1024
最大値2^64 - 1
既定値16 * 1024 * 1024

RS_CACHE_MAX_MEMORY_SIZE

結果キャッシュ全体の最大メモリ量です。

値
最小値32 * 1024
最大値2^64 - 1
既定値512 * 1024 * 1024

RS_CACHE_MAX_RECORD_PER_QUERY

キャッシュする結果の最大行数です。超える結果は保存しません。

値
最小値1
最大値2^64 - 1
既定値10000

RS_CACHE_TIME_BOUND_MSEC

短時間で実行できるクエリーは、キャッシュしない方がメモリを節約できます。 キャッシュ対象外にする実行時間のしきい値です。0 は全結果を対象にします。

値
最小値0 (msec)
最大値2^64 - 1 (msec)
既定値1000 (msec)

SHOW_HIDDEN_COLS

既定値 0 では SELECT * に _ARRIVAL_TIME を表示しません。1 は表示します。

値
最小値0
最大値1
既定値0

TABLE_SCAN_DIRECTION

テーブルのスキャン方向です。-1、0、1 を指定し、既定値は 0 です。

  • -1：逆方向。
  • 0：Tag は順方向、Log は逆方向。
  • 1：順方向。
値
最小値-1
最大値1
既定値0

TAG_CACHE_ENABLE

ビット OR のフラグで TAG キャッシュを有効にします。

  • 0：無効
  • 1：TAG マップ
  • 2：行データ
  • 4：データファイル
  • 8：外部 VARCHAR ファイル
  • 16：削除ベクトル
値
最小値0
最大値31
既定値31

TAG_CACHE_MAX_MEMORY_SIZE

TAG キャッシュプールごとの最大メモリ量（バイト）です。予約する合計は TAG_CACHE_MAX_MEMORY_SIZE × TAG_CACHE_POOL_COUNT です。

値
最小値32 * 1024
最大値2^64 - 1
既定値512 * 1024 * 1024

TAG_CACHE_POOL_COUNT

TAG キャッシュプール数です。

値
最小値1
最大値128
既定値1

TAG_MEMORY_INDEX_TYPE

TAG のメモリインデックス型です。

  • 0：RBTree
  • 1：BTree
値
最小値0
最大値1
既定値1

TAG_MEMORY_INDEX_PANOUT

TAG メモリインデックスの B ツリーの次数（分岐数）です。TAG_MEMORY_INDEX_TYPE=1 の場合に有効です。

値
最小値127
最大値65536
既定値255

TAGDATA_AUTO_META_INSERT

5.5 では TAGDATA_AUTO_NAME_INSERT という名前で、 0 と 1 のみをサポートしました。5.7 以前の既定値は 1 です。

TAGDATA の APPEND/INSERT でタグ名が未登録の場合の処理です。

  • 0：入力失敗。
  • 1：タグ名を登録。追加メタデータ列はすべて NULL。
  • 2：タグ名と追加メタデータ値を登録。
    • APPEND でのみ有効。INSERT は追加メタデータを入力できないため、1 と同じ動作。
    • APPEND 引数にはメタデータ値も含める必要があります。
値
最小値0
最大値2
既定値2

TAG_TABLE_META_MAX_SIZE

TAGDATA 作成時のメタデータ領域の最大メモリ量です。

値
最小値1024*1024
最大値2^32-1
既定値524288000

TAG_PARTITION_COUNT

Tag を構成する Key Value テーブル数です。

値
最小値1
最大値1024
既定値4

TAG_DATA_PART_SIZE

Tag のパーティションサイズです。

値
最小値1048576 (1MB)
最大値1073741824 (1GB)
既定値16777216 (16MB)

TRACE_LOGFILE_COUNT

TRACE_LOGFILE_PATH に生成するログの最大数です。超えると最も古いログを削除し、ディスクを節約します。

削除した古いファイル名を、新しいログに再利用します。

値
最小値1
最大値2^32 - 1
既定値1000

TRACE_LOGFILE_PATH

machbase.trc、machadmin.trc、machsql.trc の保存先です。 起動、終了、稼働中の内部情報を記録します。既定の ?/trc は $MACHBASE_HOME/trc です。

値
既定値?/trc
TRACE_LOGFILE_PATHtrc ディレクトリ
未指定$MACHBASE_HOME/trc/
?/test$MACHBASE_HOME/test/
/tmp/tmp/

TRACE_LOGFILE_SIZE

ログファイルの最大サイズです。超える場合は、新しいファイルを作成します。

値
最小値1024 * 1024
最大値2^32-1
既定値10 * 1024 * 1024

TRACE_LOG_LEVEL

トレースログの詳細レベルです。値が大きいほど詳細を記録します。

値
最小値0
最大値2^32 - 1
既定値277

UNIX_PATH

Unix ドメインソケット名です。

値
既定値machbase-unix

VOLATILE_TABLESPACE_MEMORY_MAX_SIZE

すべての Volatile/Lookup テーブルが使用する合計メモリ量です。

値
最小値0
最大値2^64-1
既定値2 * 1024 * 1024 * 1024
最終更新日
タイムゾーンプロパティ（Cluster）