DB2 Version 10.1 for Linux, UNIX, and Windows

SNAPSWITCHES 管理ビューおよび SNAP_GET_SWITCHES 表関数 - データベース・スナップショットのスイッチ状態情報の検索

SNAPSWITCHES 管理ビューおよび SNAP_GET_SWITCHES 表関数は、データベース・スナップショットのスイッチ状態に関する情報を戻します。

管理ビューまたは表関数のどちらを使用しているかによって、以下のいずれかのセクションを参照してください。

SNAPSWITCHES 管理ビュー
SNAP_GET_SWITCHES 表関数

SNAPSWITCHES 管理ビュー

このビューは、GET DBM MONITOR SWITCHES CLP コマンドと同等のデータを提供します。

スキーマは SYSIBMADM です。

戻される可能性のある情報の完全なリストは、表 1 を参照してください。

許可

このビューを使用するには、以下のいずれかの許可が必要です。

SNAPSWITCHES 管理ビューに対する SELECT 特権
SNAPSWITCHES 管理ビューに対する CONTROL 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

この表関数を使用するには、以下のいずれかが必要です。

SNAP_GET_SWITCHES 表関数に対する EXECUTE 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

さらに、スナップショット・モニター・データにアクセスするには、以下のいずれかの権限も必要です。

SYSMON
SYSCTRL
SYSMAINT
SYSADM

デフォルトの PUBLIC 特権

制限のないデータベースでは、このビューが自動的に作成されると、SELECT 特権が PUBLIC に付与されます。

例

すべてのデータベース・メンバーにおける DBM モニターのスイッチ状態情報を検索します。

SELECT UOW_SW_STATE, STATEMENT_SW_STATE, TABLE_SW_STATE, BUFFPOOL_SW_STATE, 
   LOCK_SW_STATE, SORT_SW_STATE, TIMESTAMP_SW_STATE, 
   DBPARTITIONNUM FROM SYSIBMADM.SNAPSWITCHES

以下はこの照会の出力例です。

UOW_SW_STATE STATEMENT_SW_STATE TABLE_SW_STATE BUFFPOOL_SW_STATE ...
------------ ------------------ -------------- ----------------- ...
           0                  0              0                 0 ...
           0                  0              0                 0 ...
           0                  0              0                 0 ...
                                                                 ...
  3 record selected.

この照会からの出力 (続き)。

... LOCK_SW_STATE SORT_SW_STATE TIMESTAMP_SW_STATE DBPARTITIONNUM
... ------------- ------------- ------------------ --------------
...             1             0                  1              0
...             1             0                  1              1
...             1             0                  1              2

SNAP_GET_SWITCHES 表関数

SNAP_GET_SWITCHES 表関数は SNAPSWITCHES 管理ビューと同じ情報を戻しますが、特定のデータベース・メンバー、すべてのデータベース・メンバーの集約、またはすべてのデータベース・メンバーを対象とした情報を検索することができます。

この表関数は、GET DBM MONITOR SWITCHES CLP コマンドと同等のデータを提供します。

戻される可能性のある情報の完全なリストは、表 1 を参照してください。

構文


>>-SNAP_GET_SWITCHES--(--+--------+--)-------------------------><
                         '-member-'

スキーマは SYSPROC です。

表関数パラメーター

member: 有効なデータベース・メンバー番号を指定する、タイプ INTEGER のオプションの入力引数。現在のデータベース・メンバーの場合は -1、すべてアクティブなデータベース・メンバーの集合の場合は -2 を指定します。この入力オプションを使用しない場合、データはすべてのアクティブなデータベース・メンバーから戻されます。アクティブなデータベース・メンバーとは、アプリケーションによるデータベースへの接続およびデータベースの使用が可能なメンバーのことです。

member を NULL に設定すると、SNAP_WRITE_FILE プロシージャーにより作成されるファイルからのデータの読み取りが試行されます。このファイルはいつでも作成される可能性があるため、データは現行のものであるとは限らないことに注意してください。対応するスナップショット API 要求タイプを持つファイルが存在しない場合、SNAP_GET_SWITCHES 表関数は、現在接続中のデータベースおよびデータベース・メンバー番号のスナップショットを取得します。

許可

以下のいずれかの権限が必要です。

SNAP_GET_SWITCHES 表関数に対する EXECUTE 特権
DATAACCESS 権限

さらに、スナップショット・モニター・データにアクセスするには、以下のいずれかの権限も必要です。

SYSMON
SYSCTRL
SYSMAINT
SYSADM

デフォルトの PUBLIC 特権

制限のないデータベースでは、この関数が自動的に作成されると、EXECUTE 特権が PUBLIC に付与されます。

例

現行データベース・メンバーにおける DBM モニターのスイッチ状態情報を検索します。

SELECT UOW_SW_STATE, STATEMENT_SW_STATE, TABLE_SW_STATE, 
   BUFFPOOL_SW_STATE,LOCK_SW_STATE, SORT_SW_STATE, TIMESTAMP_SW_STATE 
   FROM TABLE(SNAP_GET_SWITCHES(-1)) AS T

以下はこの照会の出力例です。

UOW_SW_STATE STATEMENT_SW_STATE TABLE_SW_STATE...
------------ ------------------ --------------...
           1                  1              1...
                                              ...
1 record(s) selected.                         ...

この照会からの出力 (続き)。

... BUFFPOOL_SW_STATE LOCK_SW_STATE SORT_SW_STATE TIMESTAMP_SW_STATE  
... ----------------- ------------- ------------- ------------------  
...                 1             1             0                  1

戻される情報

表 1. SNAPSWITCHES 管理ビューおよび SNAP_GET_SWITCHES 表関数によって戻される情報
列名	データ・タイプ	説明
SNAPSHOT_TIMESTAMP	TIMESTAMP	スナップショットがとられた日時。
UOW_SW_STATE	SMALLINT	作業単位モニター記録スイッチの状態 (`0` または `1`)。
UOW_SW_TIME	TIMESTAMP	作業単位モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
STATEMENT_SW_STATE	SMALLINT	SQL ステートメント・モニター記録スイッチの状態 (`0` または `1`)。
STATEMENT_SW_TIME	TIMESTAMP	SQL ステートメント・モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
TABLE_SW_STATE	SMALLINT	表アクティビティー・モニター記録スイッチの状態 (`0` または `1`)。
TABLE_SW_TIME	TIMESTAMP	表アクティビティー・モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
BUFFPOOL_SW_STATE	SMALLINT	バッファー・プール・アクティビティー・モニター記録スイッチの状態 (`0` または `1`)。
BUFFPOOL_SW_TIME	TIMESTAMP	バッファー・プール・アクティビティー・モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
LOCK_SW_STATE	SMALLINT	ロック・モニター記録スイッチの状態 (`0` または `1`)。
LOCK_SW_TIME	TIMESTAMP	ロック・モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
SORT_SW_STATE	SMALLINT	ソート・モニター記録スイッチの状態 (`0` または `1`)。
SORT_SW_TIME	TIMESTAMP	ソート・モニター記録スイッチがオンの場合、このスイッチがオンになった日時。
TIMESTAMP_SW_STATE	SMALLINT	タイム・スタンプのモニター記録スイッチの状態 (`0` または `1`)。
TIMESTAMP_SW_TIME	TIMESTAMP	タイム・スタンプのモニター記録スイッチがオンの場合、このスイッチがオンになった日付と時刻。
DBPARTITIONNUM	SMALLINT	dbpartitionnum - データベース・パーティション番号モニター・エレメント
MEMBER	SMALLINT	member - データベース・メンバー・モニター・エレメント