| Oracle® Database PL/SQLパッケージおよびタイプ・リファレンス 12c リリース1 (12.1) B71281-05 |
|
 前 |
 次 |
DBMS_MONITORは、PL/SQLを使用して統計情報収集とSQLトレースを制御するためのパッケージです。
この章では、次の項目について説明します。
表99-1 DBMS_MONITORパッケージのサブプログラム
| サブプログラム | 説明 |
|---|---|
|
|
指定されたクライアント識別子に対して以前に有効にされた統計情報収集を無効にします。 |
|
|
指定されたクライアント識別子に対する統計情報収集を有効にします。 |
|
|
指定されたクライアント識別子に対して以前に有効にされたトレースをデータベース全体で無効にします。 |
|
|
指定されたクライアント識別子に対するトレースをデータベース全体で有効にします。 |
|
|
データベース全体または特定のインスタンスに対するSQLトレースを無効にします。 |
|
|
データベース全体または特定のインスタンスに対するSQLトレースを有効にします。 |
|
SERV_MOD_ACT_STAT_DISABLEプロシージャ |
サービス名、 |
|
SERV_MOD_ACT_STAT_ENABLEプロシージャ |
サービス名、 |
|
SERV_MOD_ACT_TRACE_DISABLEプロシージャ |
サービス名、 |
|
SERV_MOD_ACT_TRACE_ENABLEプロシージャ |
|
|
|
指定されたデータベース・セッション識別子(SID)に対して以前に有効にされたトレースをローカル・インスタンス上で無効にします。 |
|
|
指定されたデータベース・セッション識別子(SID)に対するトレースをローカル・インスタンス上で有効にします。 |
このプロシージャは、CLIENT_ID_STAT_ENABLEプロシージャによって有効にされたすべてのインスタンスに対する統計情報収集を無効にして、収集済の統計情報をV$CLIENT_STATSビューから削除します。
このプロシージャは、指定されたクライアント識別子に対する統計情報収集を有効にします。統計情報の収集はデータベース全体に対して実行され、インスタンスの起動や再起動を行っても中断されません。つまり、同じデータベースのすべてのインスタンス(再起動されたインスタンスを含む)に関する統計情報が収集されます。統計情報は、V$CLIENT_STATSビューを使用して参照できます。
このプロシージャは、指定されたクライアント識別子に対するトレースをデータベース全体で有効にします。
構文
DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE( client_id IN VARCHAR2, waits IN BOOLEAN DEFAULT TRUE, binds IN BOOLEAN DEFAULT FALSE, plan_stat IN VARCHAR2 DEFAULT NULL);
このプロシージャは、データベース全体または特定のインスタンスに対するSQLトレースを有効にします。
このプロシージャは、統計情報収集を無効にして、収集済の統計情報をV$SERV_MOD_ACT_STATSビューから削除します。統計情報収集の無効化はデータベース全体に適用されます。つまり、同じデータベースのインスタンス(統計情報収集の有効化によってアクティブになったdblinksを含む)に関する統計情報の収集が停止します。
構文
DBMS_MONITOR.SERV_MOD_ACT_STAT_DISABLE( service_name IN VARCHAR2, module_name IN VARCHAR2, action_name IN VARCHAR2 DEFAULT ALL_ACTIONS);
パラメータ
表99-8 SERV_MOD_ACT_STAT_DISABLEプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
統計情報収集が無効にされるサービスの名前。 |
|
|
|
|
|
|
このプロシージャは、サービス名、MODULEおよびACTIONの指定された組合せに対する統計情報収集を有効にします。このプロシージャをコールすると、同じデータベースのすべてのインスタンス上で、サービス名、MODULE名およびACTION名の階層的な組合せに対する統計情報収集が有効になります。統計情報は、V$SERV_MOD_ACT_STATSビューを使用して参照できます。
構文
DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE( service_name IN VARCHAR2, module_name IN VARCHAR2, action_name IN VARCHAR2 DEFAULT ALL_ACTIONS);
パラメータ
表99-9 SERV_MOD_ACT_STAT_ENABLEプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
統計情報収集が有効にされるサービスの名前。 |
|
|
|
|
|
|
使用上の注意
モジュール名/アクション名にはNULLと区別できない空文字列を指定できるため、サービス名/モジュール名/アクション名の特定の組合せに対して統計収集を有効にする指定が若干複雑になります。そのため、次のような表記規則を採用しています。
次に示す特別な定数(実際のアクション名としては使用されないような名前)が定義されています。
ALL_ACTIONS constant VARCHAR2 := '###ALL_ACTIONS';
ALL_ACTIONSを使用してアクションを指定すると、特定のモジュール名を持つすべてのアクションに対して統計情報収集が有効になります。一方、NULL(または空文字列)を指定すると、名前が空文字列であるアクションに対して統計情報収集が有効になります。
統計情報の収集に関して、モジュールまたはアクションを変更すると、セッションで実行される次のユーザー・コールがこの変更の影響を受けます。たとえば、モジュールがセッション内で'module 1'に設定されており、そのセッションのユーザー・コールで'module 2'にリセットされた場合、このモジュールは、ユーザー・コールの間'module 1'のままとなります。モジュールは、このセッションの次のユーザー・コールで'module 2'に変更されます。
例
サービス名とMODULEの指定された組合せに対する統計情報収集を有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE( 'APPS1','PAYROLL');
サービス名とMODULEおよびACTIONの指定された組合せに対する統計情報収集を有効にするには、次のコマンドを実行します。
EXECUTE
DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE('APPS1','GLEDGER','DEBIT_ENTRY');
これら2つのコマンドを両方とも実行すると、次のような統計情報が収集されます。
APPS1サービスに関する統計情報(両方のコマンドでサービス名が指定されているため)
PAYROLLモジュール内のすべてのアクションに関する統計情報
GLEDGERモジュール内のDEBIT_ENTRYアクションに関する統計情報
このプロシージャは、サービス名、MODULEおよびACTION名の指定された組合せに対して有効にされたすべてのインスタンスに対するトレースを全体で無効にします。
構文
DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE( service_name IN VARCHAR2, module_name IN VARCHAR2, action_name IN VARCHAR2 DEFAULT ALL_ACTIONS, instance_name IN VARCHAR2 DEFAULT NULL);
例
APPS1という名前のサービスに対するトレースを有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1',
DBMS_MONITOR.ALL_MODULES, DBMS_MONITOR.ALL_ACTIONS,TRUE,
FALSE,NULL);
前のステップで指定したトレースを無効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE('APPS1');
サービスおよびMODULE (すべてのACTION)の指定された組合せに対するトレースを有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1','PAYROLL',
DBMS_MONITOR.ALL_ACTIONS,TRUE,FALSE,NULL);
前のステップで指定したトレースを無効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE('APPS1','PAYROLL');
このプロシージャでは、instance_nameが指定されていないかぎり、サービス名、MODULEおよびACTIONの指定された組合せに対するSQLトレースを全体で有効にします。
構文
DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE( service_name IN VARCHAR2, module_name IN VARCHAR2 DEFAULT ANY_MODULE, action_name IN VARCHAR2 DEFAULT ANY_ACTION, waits IN BOOLEAN DEFAULT TRUE, binds IN BOOLEAN DEFAULT FALSE, instance_name IN VARCHAR2 DEFAULT NULL, plan_stat IN VARCHAR2 DEFAULT NULL);
パラメータ
表99-11 SERV_MOD_ACT_TRACE_ENABLEプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
SQLトレースが有効にされるサービス名。 |
|
|
SQLトレースが有効にされる |
|
|
SQLトレースが有効にされる |
|
|
|
|
|
|
|
|
このパラメータにインスタンス名を指定すると、指定された名前を持つインスタンス( |
|
|
行ソース統計をダンプする頻度。値は' |
使用上の注意
このプロシージャは、サービス、MODULEおよびACTION名の指定された組合せに対するトレースを有効にします。指定は完全に階層的であり、「サービス名」、「サービス名とMODULE」、「サービス名、MODULE、およびACTION名」を指定する必要があります。修飾子を省略すると、ワイルドカードを使用した場合と同様に動作するため、ACTIONを省略すると、すべてのACTIONを指定した場合と同じになります。ALL_ACTIONS定数も同じ目的に使用できます。
このトレースは、アプリケーションのMODULEまたは特定のACTIONに対するサービス・レベルが低い場合に効果的です。
デフォルトでは、データベース全体に対してトレースが実行されます。instance_nameパラメータを使用すると、トレースの対象を名前が付けられている既知のインスタンス(たとえば、低いサービス・レベルを示すことが判明しているインスタンスなど)に限定できます。
トレース情報は複数のトレース・ファイルに書き込まれるため、trcsessツールを使用してトレース情報を単一のファイルにまとめる必要があります。
module_nameパラメータにNULLを指定すると、MODULE属性が設定されないセッションに関する統計情報が収集されるようになります。
例
APPS1という名前のサービスに対するトレースを有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1',
DBMS_MONITOR.ALL_MODULES, DBMS_MONITOR.ALL_ACTIONS,TRUE,
FALSE,NULL);
サービスおよびMODULE (すべてのACTION)の指定された組合せに対するトレースを有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1','PAYROLL',
DBMS_MONITOR.ALL_ACTIONS,TRUE,FALSE,NULL);
このプロシージャは、指定されたデータベース・セッションに対するトレースをローカル・インスタンス上で無効にします。
構文
DBMS_MONITOR.SESSION_TRACE_DISABLE( session_id IN BINARY_INTEGER DEFAULT NULL, serial_num IN BINARY_INTEGER DEFAULT NULL);
このプロシージャは、指定されたデータベース・セッションIDに対するSQLトレースをローカル・インスタンス上で有効にします。
構文
DBMS_MONITOR.SESSION_TRACE_ENABLE(
session_id IN BINARY_INTEGER DEFAULT NULL,
serial_num IN BINARY_INTEGER DEFAULT NULL,
waits IN BOOLEAN DEFAULT TRUE,
binds IN BOOLEAN DEFAULT FALSE,
plan_stat IN VARCHAR2 DEFAULT NULL);
パラメータ
表99-13 SESSION_TRACE_ENABLEプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
SQLトレースが有効にされるクライアント識別子。省略する(または |
|
|
現行のデータベース・セッションのシリアル番号。省略する(または |
|
|
|
|
|
|
|
|
行ソース統計をダンプする頻度。値は' |
使用上の注意
このプロシージャは、指定されたデータベース・セッションに対するトレースを有効にし、クライアント/サーバー・アプリケーションでも使用できます。データベース・セッションは複数のインスタンスに及ばないため、トレースはコール元が接続されているインスタンス上のみで有効になります。このトレースはローカル・インスタンス上のみで実行されます。
serial_numがNULLで、session_idが指定されている場合は、セッションのシリアル番号に関係なく、指定されたsession_idを持つセッションがトレースされます。session_idとserial_numが両方ともNULLの場合は、現行ユーザーのセッションがトレースされます。session_idにNULLを指定し、serial_numにNULL以外を指定することはできません。また、NULL値はデフォルトであり、省略できます。
例
指定したクライアントのセッション識別子を持つクライアント・セッションに対するトレースを有効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(7,4634, TRUE, FALSE);
前のステップで指定したトレースを無効にするには、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SESSION_TRACE_DISABLE(7,4634);
次のいずれかのコマンドを実行します。
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(5);
または
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(5, NULL);
セッションID 5でセッションがトレースされます。同時に、次のいずれかのコマンドを実行します。
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE();
または
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(NULL, NULL);
現行のユーザー・セッションがトレースされます。また、次のコマンドを実行します。
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(NULL, NULL, TRUE, TRUE);
待機情報とバインド情報を収集しながら現行のユーザー・セッションがトレースされます。また、同じトレースを、キーワード構文を使用して次のようにも実行できます。
EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(binds=>TRUE);
