コンテンツにスキップ
Machbase DBMS マニュアル
16. リファレンス
16.1 SQLリファレンス
16.1.1 SQL構文リファレンス
SYSTEM/SESSION/ALTER SYSTEM

SYSTEM/SESSION/ALTER SYSTEM

ALTER SYSTEMはサーバー全体のリソースを管理する構文です。ALTER SESSIONは現在のセッションだけに適用するパラメーターを設定します。

権限: ALTER SYSTEMはSYSアカウント、またはGRANT ALTER ON DATABASE database_name TO user_name;で権限を付与されたユーザーのみ実行できます。

ALTER SYSTEM

コマンド一覧

コマンド説明
KILL SESSION n指定セッションを強制終了
CANCEL SESSION nセッションを維持し、実行中のクエリだけをキャンセル
CHECKPOINTメモリバッファーを直ちにディスクへ同期
FREEZE全DMLを一時停止（バックアップ準備用）
UNFREEZEFREEZEで停止したDMLを再開
FLUSH AGERAgerスレッドを直ちに実行して期限切れデータを整理
FLUSH SYS_STATクエリオプティマイザー用のシステム統計を更新
FLUSH PVO_CACHEPVO Statementキャッシュを初期化
FLUSH PAGE_CACHEOSページキャッシュを強制解放
FLUSH TAG_CACHETAGテーブルのメタデータキャッシュを初期化
INSTALL LICENSEデフォルトパスのライセンスファイルをインストール
INSTALL LICENSE = 'path'指定パスのライセンスファイルをインストール
CHECK DISK_USAGELOGテーブルのディスク使用量を再計算
SET property = valueシステムプロパティの動的変更

KILL SESSION / CANCEL SESSION 

alter_system_kill_session_stmt   ::= 'ALTER SYSTEM KILL SESSION'   session_id
alter_system_cancel_session_stmt ::= 'ALTER SYSTEM CANCEL SESSION' session_id
-- 現在のセッション一覧を確認
SELECT id, user_id, client_type FROM v$session;

-- セッションを強制終了（切断、トランザクションをロールバック）
ALTER SYSTEM KILL SESSION 12;

-- 実行中のクエリだけをキャンセル（接続を維持）
ALTER SYSTEM CANCEL SESSION 6;
  • KILL SESSION: SYSユーザーのみ実行可能。対象セッションを即座に終了します。
  • CANCEL SESSION: 同じユーザーまたはSYSのみ実行可能。セッションを維持し、現在実行中のSQLだけを中止します。

CHECKPOINT 

alter_system_checkpoint_stmt ::= 'ALTER SYSTEM CHECKPOINT'

メモリにバッファーされたデータを直ちにディスクへ同期します。

ALTER SYSTEM CHECKPOINT;

FREEZE / UNFREEZE 

alter_system_freeze_stmt   ::= 'ALTER SYSTEM FREEZE'
alter_system_unfreeze_stmt ::= 'ALTER SYSTEM UNFREEZE'

バックアップ準備など整合性が必要な場合、すべてのDMLを一時停止します。

ALTER SYSTEM FREEZE;
-- (バックアップまたは点検を実行)
ALTER SYSTEM UNFREEZE;

FLUSH 

alter_system_flush_stmt ::=
    'ALTER SYSTEM FLUSH'
    ( 'AGER'
    | 'SYS_STAT'
    | 'PVO_CACHE'
    | 'PAGE_CACHE'
    | 'TAG_CACHE' )
-- Agerを即時実行（期限切れデータを整理）
ALTER SYSTEM FLUSH AGER;

-- クエリオプティマイザーの統計を更新
ALTER SYSTEM FLUSH SYS_STAT;

-- PVO Statementキャッシュを初期化
ALTER SYSTEM FLUSH PVO_CACHE;

-- OSページキャッシュを強制解放
ALTER SYSTEM FLUSH PAGE_CACHE;

-- TAGメタデータキャッシュを初期化
ALTER SYSTEM FLUSH TAG_CACHE;

INSTALL LICENSE 

-- デフォルトパス ($MACHBASE_HOME/conf/license.dat)
alter_system_install_license_stmt ::= 'ALTER SYSTEM INSTALL LICENSE'

-- 指定パス
alter_system_install_license_path_stmt ::= 'ALTER SYSTEM INSTALL LICENSE' '=' "'" path "'"
-- デフォルトパスからインストール
ALTER SYSTEM INSTALL LICENSE;

-- 指定パスからインストール
ALTER SYSTEM INSTALL LICENSE = '/tmp/new_license.dat';

CHECK DISK_USAGE 

alter_system_check_disk_stmt ::= 'ALTER SYSTEM CHECK DISK_USAGE'

V$STORAGEのDC_TABLE_FILE_SIZE値をファイルシステムから再計算します。プロセス障害や停電後に使用量が不正確な場合に使用します。

ALTER SYSTEM CHECK DISK_USAGE;

SET (システムプロパティの動的変更) 

alter_system_set_stmt ::=
    'ALTER SYSTEM SET' property_name '=' value_expr

value_expr ::=
    value
  | property_name '|'  number   -- ビットOR（フラグ追加）
  | property_name '&' '~' number -- ビットAND NOT（フラグ削除）

変更できるプロパティ一覧:

プロパティ説明
QUERY_PARALLEL_FACTORクエリの並列処理スレッド数
DEFAULT_DATE_FORMATデフォルトの日付形式（例: 'YYYY-MM-DD HH24:MI:SS'）
TRACE_LOG_LEVELトレースログレベル（ビットフラグ）
DISK_COLUMNAR_PAGE_CACHE_MAX_SIZEディスク列指向ページキャッシュの最大サイズ
MAX_SESSION_COUNT最大セッション数
SESSION_IDLE_TIMEOUT_SECセッションのアイドルタイムアウト（秒）
PROCESS_MAX_SIZEプロセスの最大メモリサイズ
TAG_CACHE_MAX_MEMORY_SIZETAGキャッシュの最大メモリサイズ
PVO_CACHE_ENABLEPVOキャッシュの有効化（0/1）
PVO_CACHE_MAX_MEMORY_SIZEPVOキャッシュの最大メモリサイズ
-- 値を直接設定
ALTER SYSTEM SET TRACE_LOG_LEVEL = 3;
ALTER SYSTEM SET DEFAULT_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';
-- 変更前の現在値を確認
SELECT NAME, VALUE, MIN, MAX
  FROM V$PROPERTY
 WHERE NAME = 'MAX_SESSION_COUNT';

-- ビットフラグの追加（OR）
ALTER SYSTEM SET TRACE_LOG_LEVEL = TRACE_LOG_LEVEL | 0x00000004;

-- ビットフラグの削除（AND NOT）
ALTER SYSTEM SET TRACE_LOG_LEVEL = TRACE_LOG_LEVEL & ~0x00000001;

-- 16進数で設定
ALTER SYSTEM SET TRACE_LOG_LEVEL = 0x00000003;

ALTER SESSION

セッション単位のパラメーターを変更します。

alter_session_stmt ::=
    'ALTER SESSION SET' session_property_name '=' value

SET SQL_LOGGING 

ALTER SESSION SET SQL_LOGGING = flag
-- flag: ビットORの組み合わせ
-- 0x1: 解析・検証・最適化段階のログ
-- 0x2: DDL実行結果のログ
ALTER SESSION SET SQL_LOGGING = 3;  -- 解析ログ + DDLログ
ALTER SESSION SET SQL_LOGGING = 0;  -- ログ記録を無効化

SET DEFAULT_DATE_FORMAT 

ALTER SESSION SET DEFAULT_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';
ALTER SESSION SET DEFAULT_DATE_FORMAT = 'YYYYMMDD';

SET SHOW_HIDDEN_COLS

SELECT *で隠し列（_arrival_time）も表示するか設定します。

ALTER SESSION SET SHOW_HIDDEN_COLS = 1;  -- 隠し列を表示
ALTER SESSION SET SHOW_HIDDEN_COLS = 0;  -- 隠し列を非表示（デフォルト）

SET FEEDBACK_APPEND_ERROR

Append APIのエラーメッセージをクライアントへ送信するか設定します。

ALTER SESSION SET FEEDBACK_APPEND_ERROR = 1;  -- エラーメッセージを送信（サーバーのデフォルト）
ALTER SESSION SET FEEDBACK_APPEND_ERROR = 0;  -- エラーメッセージを送信しない

SET MAX_QPX_MEM

単一SQLのGROUP BY、DISTINCT、ORDER BYで使用できる最大メモリ（バイト）です。

ALTER SESSION SET MAX_QPX_MEM = 1073741824;  -- 1GB

SET DDL_LOCK_TIMEOUT

Standard Editionで競合するDDLロックの待機時間を秒単位で指定します。デフォルトは0、範囲は0~1000000です。 0の場合は待機せず、直ちにERR-02031: Resource busy (<object>)を返します。

ALTER SESSION SET DDL_LOCK_TIMEOUT = 10;  -- 最大10秒待機

実行中のDDLの待機時間は変わらず、新しい値は次のDDLから適用します。セッションごとの現在値は V$SESSION.DDL_LOCK_TIMEOUTで確認します。

SELECT id, user_name, ddl_lock_timeout
  FROM v$session
 WHERE closed = 0
 ORDER BY id;

競合範囲とエラー処理はDDLの同時実行とロックを参照してください。

SET SESSION_IDLE_TIMEOUT_SEC

アイドル状態のセッションで接続を維持する最大時間（秒）です。

ALTER SESSION SET SESSION_IDLE_TIMEOUT_SEC = 300;  -- 5分

SET QUERY_TIMEOUT

クエリ実行の最大待機時間（秒）です。超過するとクエリを自動中止します。

ALTER SESSION SET QUERY_TIMEOUT = 60;  -- 60秒

関連ビュー

ビュー説明
v$session現在の接続セッション一覧とセッション別パラメーター
v$storageディスク使用量情報（DC_TABLE_FILE_SIZEなど）
v$license_infoインストール済みライセンス情報
v$propertyシステムプロパティと現在値
-- セッション一覧を参照
SELECT id, user_id, client_type, login_time FROM v$session;

-- システムプロパティを確認
SELECT name, value FROM v$property WHERE name = 'TRACE_LOG_LEVEL';

関連ドキュメント

最終更新日
USER/AUTHDATABASE