DBMS_WORKLOAD_REPOSITORYDBMS_WORKLOAD_REPOSITORYパッケージを使用して、ワークロード・リポジトリを管理し、スナップショットやベースラインの管理などの操作を実行できます。Databaseパフォーマンス・チューニング・ガイド』を参照してください。この章では、次の項目について説明します。例データ構造オブジェクト・タイプ表タイプDBMS_WORKLOAD_REPOSITORYサブプログラムの要約DBMS_WORKLOAD_REPOSITORYの使用方法この項では、DBMS_WORKLOAD_REPOSITORYパッケージの使用に関連する項目について説明します。5390と5391、およびデフォルト・オプションを指定し、DBMS_WORKLOAD_REPOSITORYパッケージを使用してAWRテキスト・レポートを生成する方法を示します。;この例のように、DBMS_WORKLOAD_REPOSITORYパッケージ・ファンクションを直接コールすることもできますが、パッケージ・ファンクション用に提供された、対応するSQLスクリプト(この場合はawrrpt.sql)を使用することをお薦めします。このスクリプトを使用すると、必要な情報の入力を求められます。データ構造DBMS_WORKLOAD_REPOSITORYパッケージは、オブジェクト・タイプおよび関連する表タイプを定義します。オブジェクト・タイプAWR_BASELINE_METRIC_TYPEオブジェクト・タイプ表タイプAWR_BASELINE_METRIC_TYPE_TABLE表タイプAWRRPT_INSTANCE_LIST_TYPE表タイプAWR_BASELINE_METRIC_TYPEオブジェクト・タイプこのタイプは、ベースラインに対応するメトリックの値を示します。RUNTIME_INFOのフィールドフィールド説明baseline_nameベースラインの名前dbidスナップショットのデータベースIDinstance_numberスナップショットのインスタンス番号beg_timeその間隔の開始時間end_timeその間隔の終了時間metric_idメトリックIDmetric_nameメトリック名metric_unit測定の単位num_interval確認された間隔の数interval_size間隔の長さ(100分の1秒単位)averageその期間の平均minimum確認された最小値maximum確認された最大値AWR_BASELINE_METRIC_TYPE_TABLE表タイプこのタイプは、SELECT_BASELINE_METRICファンクションで使用されます。awr_baseline_metric_type;AWRRPT_INSTANCE_LIST_TYPE表タイプこの表タイプは、カンマ区切りリストのかわりに使用できます。RAC)のASHスポット・レポートをHTML形式で表示します。RAC)のASHスポット・レポートをテキスト形式で表示します。ASH_REPORT_HTMLファンクションASHレポートをHTMLで表示します。ASH_REPORT_TEXTファンクションASHレポートをテキストで表示します。Diff-DiffレポートをHTMLで表示します。Diff-Diffレポートをテキストで表示します。AWR_GLOBAL_DIFF_REPORT_HTMLファンクショングローバルAWR期間の比較レポートをHTMLで表示します。AWR_GLOBAL_DIFF_REPORT_TEXTファンクショングローバルAWR期間の比較レポートをテキストで表示します。AWR_GLOBAL_REPORT_HTMLファンクショングローバルAWRレポートをHTMLで表示します。AWR_GLOBAL_REPORT_TEXTファンクショングローバルAWRレポートをテキストで表示します。AWR_REPORT_HTMLファンクションAWRレポートをHTMLで表示します。AWR_REPORT_TEXTファンクションAWRレポートをテキストで表示します。AWR_SET_REPORT_THRESHOLDSプロシージャレポートの行数などの指定されたレポートのしきい値を構成します。SQLレポートをHTML形式で表示します。SQLレポートをテキスト形式で表示します。CREATE_BASELINEファンクションおよびプロシージャ単一のベースラインを作成します。CREATE_BASELINE_TEMPLATEプロシージャベースライン・テンプレートを作成します。CREATE_SNAPSHOTファンクションおよびプロシージャマニュアル・スナップショットを即時に作成します。DROP_BASELINEプロシージャ以前に定義したベースラインを削除します。DROP_BASELINE_TEMPLATEプロシージャ不要になったベースライン・テンプレートを削除します。DROP_SNAPSHOT_RANGEプロシージャスナップショットの範囲を削除します。MODIFY_SNAPSHOT_SETTINGSプロシージャスナップショット設定を変更します。MODIFY_BASELINE_WINDOW_SIZEプロシージャデフォルトの変動ウィンドウ・ベースラインのウィンドウ・サイズを変更します。PURGE_SQL_DETAILSプロシージャSQL詳細をパージします。具体的には、WRH$_SQLSTATに対応する行(DBID、SQL_ID)がないWRH$_SQLTEXTおよびWRH$_SQL_PLANの行です。RENAME_BASELINEプロシージャベースラインの名前を変更します。SELECT_BASELINE_METRICファンクションベースラインに対応するメトリックの値を示します。UPDATE_OBJECT_INFOプロシージャローカル・データベースのオブジェクトを表すWRH$_SEG_STAT_OBJ表の行を更新します。SQLである必要はなくなります。スナップショット・タイムにカーソル・キャッシュでこのSQLが検出された場合、取得が発生します。このSQLの色を解除するには、REMOVE_COLORED_SQLプロシージャをコールします。(デフォルトはローカルDBID)。RAC)のASHスポット・レポートをHTML形式で表示します。ASH_GLOBAL_REPORT_HTMLのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンスのリスト('1,2,3'など)またはNULL(データベースのすべてのインスタンスについてレポートします)。l_btime開始時間。l_etime終了時間。l_optionsレポート・レベル(現在は使用されていません)。l_slot_widthレポートの「トップ・アクティビティ」セクションで使用するスロットの幅(秒)を指定します。この引数はオプションで、これを指定しない場合、l_btimeとl_etimeの間の間隔は、10スロット以下に適切に分けられます。l_sidセッションID(「使用上の注意」を参照)。ID(「使用上の注意」を参照)。l_wait_class待機クラス名(「使用上の注意」を参照)。l_service_hashサービス名のハッシュ(「使用上の注意」を参照)。l_moduleモジュール名(「使用上の注意」を参照)。l_actionアクション名(「使用上の注意」を参照)。l_client_idエンドツーエンドのバックトレースのクライアントID(「使用上の注意」を参照)。l_plsql_entryPL/SQLエントリ・ポイント(「使用上の注意」を参照)。l_data_srcレポートはディスク上のデータからのみ成り立っているため、無視されます。l_containerレポート・アクティビティを制限する対象のコンテナの名前。(デフォルト)以外の有効な値は、V$CONTAINERSに含まれるコンテナ名から得られます。動作は次のとおりです。ルート・コンテナに接続されている場合、レポートはすべてのコンテナを対象とします。PDBに接続されている場合、レポートはそのPDBのみを対象とします。ルート・コンテナに接続されている場合、レポートは指定されたコンテナからのアクティビティを対象とします。PDBに接続されている場合、レポートは接続されたPDBに関するl_containerにNULL値を指定した場合と同じです。PDBへの接続時に別のPDBからの情報を要求すると、空のレポートが作成されます。出力はVARCHAR2(1500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるashrpti.sqlスクリプトを使用することをお薦めします。指定されていないオプションの引数は、レポート対象(SQL文、セッション、特定のサービス名/モジュール名の組合せなど)を指定するASHレポートを生成するために使用します。これらの引数は、レポートの生成に使用されるASH行を制限するために指定します。'abcdefghij123'など)に関するASHレポートを生成するには、次のように、そのsql_id値をl_sql_id引数に渡します。'abcdefghij123'これらのオプションの引数はいずれの組合せでも渡すことができ、また、これらのすべてのレポート対象を満たすASHの行のみが使用されます。複数のレポート対象が指定されている場合は、条件ロジックのANDを使用してこれらの対象を連結します。"PROCESS"に関するASHレポートを生成するには、次の条件を使用します。'PROCESS'VARCHAR2タイプのすべての引数で、有効なSQLワイルドカードを使用できます。引数名コメントワイルドカードを使用できるかどうかl_sidセッションID(V$SESSION.SIDなど)。ID(V$SQL.SQL_IDなど)。はいl_wait_class待機クラス名(V$EVENT_NAME.WAIT_CLASSなど)。はいl_service_hashサービス名のハッシュ(V$ACTIVE_SERVICES.NAME_HASHなど)。いいえl_moduleモジュール名(V$SESSION.MODULEなど)。はいl_actionアクション名(V$SESSION.ACTIONなど)。はいl_client_idエンドツーエンドのバックトレースのクライアントID(V$SESSION.CLIENT_IDENTIFIERなど)。はいl_data_srcl_data_srcは数値データ・タイプであるため、ワイルドカードは使用できません。RAC)のASHスポット・レポートをテキスト形式で表示します。ASH_GLOBAL_REPORT_TEXTのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンスのリスト('1,2,3'など)またはNULL(データベースのすべてのインスタンスについてレポートします)。l_btime開始時間。l_etime終了時間。l_optionsレポート・レベル(現在は使用されていません)。l_slot_widthレポートの「トップ・アクティビティ」セクションで使用するスロットの幅(秒)を指定します。この引数はオプションで、これを指定しない場合、l_btimeとl_etimeの間の間隔は、10スロット以下に適切に分けられます。l_sidセッションID(「使用上の注意」を参照)。ID(「使用上の注意」を参照)。l_wait_class待機クラス名(「使用上の注意」を参照)。l_service_hashサービス名のハッシュ(「使用上の注意」を参照)。l_moduleモジュール名(「使用上の注意」を参照)。l_actionアクション名(「使用上の注意」を参照)。l_client_idエンドツーエンドのバックトレースのクライアントID(「使用上の注意」を参照)。l_plsql_entryPL/SQLエントリ・ポイント(「使用上の注意」を参照)。l_data_srcレポートはディスク上のデータからのみ成り立っているため、無視されます。l_containerレポート・アクティビティを制限する対象のコンテナの名前。(デフォルト)以外の有効な値は、V$CONTAINERSに含まれるコンテナ名から得られます。動作は次のとおりです。ルート・コンテナに接続されている場合、レポートはすべてのコンテナを対象とします。PDBに接続されている場合、レポートはそのPDBのみを対象とします。ルート・コンテナに接続されている場合、レポートは指定されたコンテナからのアクティビティを対象とします。PDBに接続されている場合、レポートは接続されたPDBに関するl_containerにNULL値を指定した場合と同じです。PDBへの接続時に別のPDBからの情報を要求すると、空のレポートが作成されます。出力はVARCHAR2(320)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるashrpti.sqlスクリプトを使用することをお薦めします。指定されていないオプションの引数は、レポート対象(SQL文、セッション、特定のサービス名/モジュール名の組合せなど)を指定するASHレポートを生成するために使用します。これらの引数は、レポートの生成に使用されるASH行を制限するために指定します。'など)に関するASHレポートを生成するには、次のように、そのSQL_ID値をl_sql_id引数に渡します。引数名コメントワイルドカードを使用できるかどうかl_sidセッションID(V$SESSION.SIDなど)。ID(V$SQL.SQL_IDなど)。はいl_wait_class待機クラス名(V$EVENT_NAME.WAIT_CLASSなど)。はいl_service_hashサービス名のハッシュ(V$ACTIVE_SERVICES.NAME_HASHなど)。いいえl_moduleモジュール名(V$SESSION.MODULEなど)。はいl_actionアクション名(V$SESSION.ACTIONなど)。はいl_client_idエンドツーエンドのバックトレースのクライアントID(V$SESSION.CLIENT_IDENTIFIERなど)。はいl_plsql_entryPL/SQLエントリ・ポイント("SYS.DBMS_LOB.*"など)。はいl_data_srcl_data_srcは数値データ・タイプであるため、ワイルドカードは使用できません。いいえこれらのオプションの引数はいずれの組合せでも渡すことができ、また、これらのすべてのレポート対象を満たすASHの行のみが使用されます。複数のレポート対象が指定されている場合は、条件ロジックのANDを使用してこれらの対象を連結します。"PROCESS"に関するASHレポートを生成するには、次の条件を使用します。'PROCESS'VARCHAR2タイプのすべての引数で、有効なSQLワイルドカードを使用できます。ASH_REPORT_HTMLファンクションこのテーブル・ファンクションは、ASHスポット・レポートをHTMLで表示します。ASH_REPORT_HTMLのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンス番号。l_btime開始時間。l_etime終了時間。l_optionsレポート・レベル(現在は使用されていません)。l_slot_widthレポートの「トップ・アクティビティ」セクションで使用するスロットの幅(秒)を指定します。この引数はオプションで、これを指定しない場合、l_btimeとl_etimeの間の間隔は、10スロット以下に適切に分けられます。l_sidセッションID(「使用上の注意」を参照)。ID(「使用上の注意」を参照)。l_wait_class待機クラス名(「使用上の注意」を参照)。l_service_hashサービス名のハッシュ(「使用上の注意」を参照)。l_moduleモジュール名(「使用上の注意」を参照)。l_actionアクション名(「使用上の注意」を参照)。l_client_idエンドツーエンドのバックトレースのクライアントID(「使用上の注意」を参照)。l_plsql_entryPL/SQLエントリ・ポイント(「使用上の注意」を参照)。l_data_srcデータ・ソースの指定に使用可能(「使用上の注意」を参照)。これがデフォルト値です。開始時間パラメータと終了時間パラメータを使用して、適切なデータ・ソース(メモリー、ディスクまたはその両方)からサンプルを取得します。l_containerレポート・アクティビティを制限する対象のコンテナの名前。(デフォルト)以外の有効な値は、V$CONTAINERSに含まれるコンテナ名から得られます。動作は次のとおりです。ルート・コンテナに接続されている場合、レポートはすべてのコンテナを対象とします。PDBに接続されている場合、レポートはそのPDBのみを対象とします。ルート・コンテナに接続されている場合、レポートは指定されたコンテナからのアクティビティを対象とします。PDBに接続されている場合、レポートは接続されたPDBに関するl_containerにNULL値を指定した場合と同じです。PDBへの接続時に別のPDBからの情報を要求すると、空のレポートが作成されます。出力はVARCHAR2(500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるashrpti.sqlスクリプトを使用することをお薦めします。デフォルトでは、レポートは開始時間パラメータと終了時間パラメータ(l_btimeとl_etime)を使用して、その時間範囲にあるすべての列をメモリー、ディスクまたはその両方から検索します。l_data_srcを使用すると、それらのデータ・ソースのいずれかを明示的に指定できます。l_btimeとl_timeの間にあるメモリー内のすべての列に関するASHレポートを生成するには、次の条件を使用します。1同様に、ディスク上のみにあるサンプルに関するレポートを生成するには、次の条件を使用します。2指定されていないオプションの引数は、レポート対象(SQL文、セッション、特定のサービス名/モジュール名の組合せなど)を指定するASHレポートを生成するために使用します。これらの引数は、レポートの生成に使用されるASH行を制限するために指定します。'abcdefghij123'など)に関するASHレポートを生成するには、次のように、そのsql_id値をl_sql_id引数に渡します。'abcdefghij123'これらのオプションの引数はいずれの組合せでも渡すことができ、また、これらのすべてのレポート対象を満たすASHの行のみが使用されます。複数のレポート対象が指定されている場合は、条件ロジックのANDを使用してこれらの対象を連結します。"PROCESS"に関するASHレポートを生成するには、次の条件を使用します。'PROCESS'VARCHAR2タイプのすべての引数で、有効なSQLワイルドカードを使用できます。引数名コメントワイルドカードを使用できるかどうかl_sidセッションID(V$SESSION.SIDなど)。ID(V$SQL.SQL_IDなど)。はいl_wait_class待機クラス名(V$EVENT_NAME.WAIT_CLASSなど)。はいl_service_hashサービス名のハッシュ(V$ACTIVE_SERVICES.NAME_HASHなど)。いいえl_moduleモジュール名(V$SESSION.MODULEなど)。はいl_actionアクション名(V$SESSION.ACTIONなど)。はいl_client_idエンドツーエンドのバックトレースのクライアントID(V$SESSION.CLIENT_IDENTIFIERなど)。はいASH_REPORT_TEXTファンクションこのテーブル・ファンクションは、ASHスポット・レポートをテキストで表示します。ASH_REPORT_TEXTのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンス番号。l_btime開始時間。l_etime終了時間。l_optionsレポート・レベル(現在は使用されていません)。l_slot_widthレポートの「トップ・アクティビティ」セクションで使用するスロットの幅(秒)を指定します。この引数はオプションで、これを指定しない場合、l_btimeとl_etimeの間の間隔は、10スロット以下に適切に分けられます。l_sidセッションID(「使用上の注意」を参照)。ID(「使用上の注意」を参照)。l_wait_class待機クラス名(「使用上の注意」を参照)。l_service_hashサービス名のハッシュ(「使用上の注意」を参照)。l_moduleモジュール名(「使用上の注意」を参照)。l_actionアクション名(「使用上の注意」を参照)。l_client_idエンドツーエンドのバックトレースのクライアントID(「使用上の注意」を参照)。l_plsql_entryPL/SQLエントリ・ポイント(「使用上の注意」を参照)。l_data_srcデータ・ソースの指定に使用可能(「使用上の注意」を参照)。これがデフォルト値です。開始時間パラメータと終了時間パラメータを使用して、適切なデータ・ソース(メモリー、ディスクまたはその両方)からサンプルを取得します。l_containerレポート・アクティビティを制限する対象のコンテナの名前。(デフォルト)以外の有効な値は、V$CONTAINERSに含まれるコンテナ名から得られます。動作は次のとおりです。ルート・コンテナに接続されている場合、レポートはすべてのコンテナを対象とします。PDBに接続されている場合、レポートはそのPDBのみを対象とします。ルート・コンテナに接続されている場合、レポートは指定されたコンテナからのアクティビティを対象とします。PDBに接続されている場合、レポートは接続されたPDBに関するl_containerにNULL値を指定した場合と同じです。PDBへの接続時に別のPDBからの情報を要求すると、空のレポートが作成されます。出力はVARCHAR2(80)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるashrpti.sqlスクリプトを使用することをお薦めします。デフォルトでは、レポートは開始時間パラメータと終了時間パラメータ(l_btimeとl_etime)を使用して、その時間範囲にあるすべての列をメモリー、ディスクまたはその両方から検索します。l_data_srcを使用すると、それらのデータ・ソースのいずれかを明示的に指定できます。l_btimeとl_timeの間にあるメモリー内のすべての列に関するASHレポートを生成するには、次の条件を使用します。1同様に、ディスク上のみにあるサンプルに関するレポートを生成するには、次の条件を使用します。2指定されていないオプションの引数は、レポート対象(SQL文、セッション、特定のサービス名/モジュール名の組合せなど)を指定するASHレポートを生成するために使用します。これらの引数は、レポートの生成に使用されるASH行を制限するために指定します。'abcdefghij123'など)に関するASHレポートを生成するには、次のように、そのSQL_ID値をl_sql_id引数に渡します。引数名コメントワイルドカードを使用できるかどうかl_sidセッションID(V$SESSION.SIDなど)。ID(V$SQL.SQL_IDなど)。はいl_wait_class待機クラス名(V$EVENT_NAME.WAIT_CLASSなど)。はいl_service_hashサービス名のハッシュ(V$ACTIVE_SERVICES.NAME_HASHなど)。いいえl_moduleモジュール名(V$SESSION.MODULEなど)。はいl_actionアクション名(V$SESSION.ACTIONなど)。はいl_client_idエンドツーエンドのバックトレースのクライアントID(V$SESSION.CLIENT_IDENTIFIERなど)。はいl_plsql_entryPL/SQLエントリ・ポイント("SYS.DBMS_LOB.*"など)。はいl_data_srcl_data_srcは数値データ・タイプであるため、ワイルドカードは使用できません。いいえこれらのオプションの引数はいずれの組合せでも渡すことができ、また、これらのすべてのレポート対象を満たすASHの行のみが使用されます。複数のレポート対象が指定されている場合は、条件ロジックのANDを使用してこれらの対象を連結します。"PROCESS"に関するASHレポートを生成するには、次の条件を使用します。'PROCESS'VARCHAR2タイプのすべての引数で、有効なSQLワイルドカードを使用できます。AWR_DIFF_REPORT_HTMLファンクションこのテーブル・ファンクションは、AWR期間の比較レポートをHTMLで表示します。AWR_DIFF_REPORT_HTMLのパラメータパラメータ説明dbid11番目のデータベース識別子。inst_num11番目のインスタンス番号。bid11番目の開始スナップショットID。eid11番目の終了スナップショットID。dbid22番目のデータベース識別子。inst_num22番目のインスタンス番号。bid22番目の開始スナップショットID。eid22番目の終了スナップショットID。出力はVARCHAR2(500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrddrpt.sqlスクリプトを使用することをお薦めします。AWR_DIFF_REPORT_TEXTファンクションこのテーブル・ファンクションは、AWR期間の比較レポートをテキストで表示します。AWR_DIFF_REPORT_TEXTのパラメータパラメータ説明dbid11番目のデータベース識別子。inst_num11番目のインスタンス番号。bid11番目の開始スナップショットID。eid11番目の終了スナップショットID。dbid22番目のデータベース識別子。inst_num22番目のインスタンス番号。bid22番目の開始スナップショットID。eid22番目の終了スナップショットID。出力はVARCHAR2(500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrddrpt.sqlスクリプトを使用することをお薦めします。AWR_GLOBAL_DIFF_REPORT_HTMLファンクションこのテーブル・ファンクションは、グローバルAWR期間の比較レポートをHTML形式で表示します。最初のオーバーロードでは、inst_num1およびinst_num2に対してインスタンス番号のカンマ区切りリストが受け入れられます。(ゼロ)は使用できず、また、1023文字以内という制限があります。AWR_GLOBAL_DIFF_REPORT_HTMLファンクションのパラメータパラメータ説明dbid11番目のデータベース識別子。inst_num1インスタンス番号の1番目のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。bid11番目の開始スナップショットID。eid11番目の終了スナップショットID。dbid22番目のデータベース識別子。inst_num2レポートに含まれるインスタンス番号の2番目のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。bid22番目の開始スナップショットID。eid22番目の終了スナップショットID。出力はVARCHAR2(1500)の1列です。AWR_GLOBAL_DIFF_REPORT_TEXTファンクションこのテーブル・ファンクションは、グローバルAWR期間の比較レポートをテキスト形式で表示します。最初のオーバーロードでは、inst_num1およびinst_num2に対してインスタンス番号のカンマ区切りリストが受け入れられます。(ゼロ)は使用できず、また、1023文字以内という制限があります。AWR_GLOBAL_DIFF_REPORT_TEXTファンクションのパラメータパラメータ説明dbid11番目のデータベース識別子。inst_num1インスタンス番号の1番目のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。bid11番目の開始スナップショットID。eid11番目の終了スナップショットID。dbid22番目のデータベース識別子。inst_num2レポートに含まれるインスタンス番号の2番目のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。bid22番目の開始スナップショットID。eid22番目の終了スナップショットID。出力はVARCHAR2(320)の1列です。AWR_GLOBAL_REPORT_HTMLファンクションこのテーブル・ファンクションは、グローバルAWRレポートをHTMLで表示します。最初のオーバーロードでは、インスタンス番号のカンマ区切りリストが受け入れられます。(ゼロ)は使用できず、また、1023文字以内という制限があります。AWR_GLOBAL_REPORT_HTMLファンクションのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numレポートに含まれるインスタンス番号のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポート・レベル(現在は使用されていません)。出力はVARCHAR2(1500)の1列です。AWR_GLOBAL_REPORT_TEXTファンクションこのテーブル・ファンクションは、グローバルAWRレポートをテキストで表示します。最初のオーバーロードでは、インスタンス番号のカンマ区切りリストが受け入れられます。(ゼロ)は使用できず、また、1023文字以内という制限があります。AWR_GLOBAL_REPORT_TEXTファンクションのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numレポートに含まれるインスタンス番号のリスト。NULLに設定した場合、開始スナップショットと終了スナップショットが使用可能となり、スナップショット間で再起動されていないすべてのインスタンスがレポートに含まれます。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポートの出力を制御するために指定するフラグ。現在は使用されていません。出力はVARCHAR2(320)の1列です。AWR_REPORT_HTMLファンクションこのテーブル・ファンクションは、AWRレポートをHTMLで表示します。AWR_REPORT_HTMLのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンス番号。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポートの出力を制御するために指定するフラグ。現在、Oracleでは次の1つの値をサポートしています。レポートのADDM固有部分を表示します。これらのセクションには、バッファ・プール・アドバイス、共有プール・アドバイス、およびPGAターゲット・アドバイスが含まれます。出力はVARCHAR2(1500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrrpt.sqlスクリプトを使用することをお薦めします。AWR_REPORT_TEXTファンクションこのテーブル・ファンクションは、AWRレポートをテキストで表示します。AWR_REPORT_TEXTのパラメータパラメータ説明l_dbidデータベース識別子。l_insT_numインスタンス番号。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポートの出力を制御するために指定するフラグ。現在、Oracleでは次の1つの値をサポートしています。レポートのADDM固有部分を表示します。これらのセクションには、バッファ・プール・アドバイス、共有プール・アドバイス、およびPGAターゲット・アドバイスが含まれます。出力はVARCHAR2(80)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrrpt.sqlスクリプトを使用することをお薦めします。AWR_SET_REPORT_THRESHOLDSプロシージャこのプロシージャは、レポートの行数などの指定されたレポートのしきい値を構成します。AWR_SET_REPORT_THRESHOLDSプロシージャのパラメータパラメータ説明top_n_events組み込まれる最も重大な待機イベント数top_n_files組み込まれる最もアクティブなファイル数top_n_segments組み込まれる最もアクティブなセグメント数top_n_services組み込まれる最もアクティブなサービス数top_n_sql組み込まれる最も重大なSQL文の数top_n_sql_maxSQL文のアクティビティがtop_sql_pctで指定されたものより大きい場合に組み込まれるSQL文の数。top_sql_pcttop_n_sqlとtop_n_sql_maxの間のSQL文の重要度しきい値。shmem_threshold共有メモリーの低しきい値。versions_threshold計画バージョン・カウントの低しきい値。各設定の影響は、生成されるレポートのタイプおよび基礎となるAWRデータによって異なります。各レポート・タイプに対してすべての設定が意味を持つわけではありません。無効な設定(負の数など)は無視されます。設定は、AWR_SET_REPORT_THRESHOLDSプロシージャを実行するセッションのコンテキストでのみ有効です。デフォルトと比較して上位12個のセグメントを示すレポートを取得するには、次のようにプロシージャを起動できます。SQLレポートをHTML形式で表示します。AWR_SQL_REPORT_HTMLのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンス番号。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポートの出力を制御するために指定するフラグ。現在は使用されていません。出力はVARCHAR2(500)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrsqrpt.sqlスクリプトを使用することをお薦めします。SQLレポートをテキスト形式で表示します。AWR_SQL_REPORT_TEXTのパラメータパラメータ説明l_dbidデータベース識別子。l_inst_numインスタンス番号。l_bid開始スナップショットID。l_eid終了スナップショットID。l_optionsレポートの出力を制御するために指定するフラグ。現在は使用されていません。出力はVARCHAR2(120)の1列です。使用上の注意このファンクションを直接コールすることもできますが、ユーザーに必要な情報の入力を求めるawrsqrpt.sqlスクリプトを使用することをお薦めします。CREATE_BASELINEファンクションおよびプロシージャこのファンクションおよびプロシージャは、ベースラインを作成します。CREATE_BASELINEファンクションおよびプロシージャのパラメータパラメータ説明start_snap_idベースラインの開始スナップショット順序番号。end_snap_idベースラインの終了スナップショット順序番号。start_timeベースラインの開始時間。end_timeベースラインの終了時間。baseline_nameベースラインの名前。dbidベースラインのデータベースID。NULLの場合は、ローカル・データベースのデータベースIDになります。デフォルトはNULLです。expirationベースラインの有効期限日数。NULLの場合、有効期限は無期限になり、ベースラインは削除されません。デフォルトはNULLです。例外システム内にすでにこのベースライン名が存在する場合は、エラーが戻されます。このインタフェースに指定するスナップショットの範囲は、データベース内の既存の2つのスナップショットである必要があります。入力したスナップショットがシステムに存在しない場合は、エラーが戻されます。次の例では、ローカル・データベースのスナップショット105から107までのベースライン('oltp_peakload_bl'という名前で)を作成します。BASELINE操作後にDBA_HIST_BASELINEビューを問い合せると、ワークロード・リポジトリに新しく作成したベースラインが表示されます。CREATE_BASELINE_TEMPLATEプロシージャこのプロシージャでは、将来の期間でどのようにベースラインを作成するかを示すテンプレートを指定します。将来の単一の期間に基づいてベースラインを生成するためのテンプレートを指定します。NULL);繰返し期間に基づいてベースラインを作成および削除するためのテンプレートは、次のように指定します。CREATE_BASELINE_TEMPLATEプロシージャのパラメータパラメータ説明start_time作成するベースラインの開始時間。end_time作成するベースラインの終了時間。baseline_name作成するベースラインの名前。template_nameテンプレートの名前。expirationベースラインの有効期限日数。NULLの場合、有効期限は無期限になり、ベースラインは削除されません。デフォルトはNULLです。dbidベースラインのデータベースID。NULLの場合は、ローカル・データベースのデータベースIDになります。デフォルトはNULLです。day_of_weekベースラインを繰り返す曜日。SUNDAY、MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAYのいずれかの値を指定します。hour_in_dayベースラインを開始する日中の時間を指定する0から23の値。duration日中の時間後にベースラインを継続させる期間(時間数)。baseline_name_prefixベースライン接頭辞の名前。ベースライン作成時には、このベースライン名が接頭辞となり、日付情報が追加されます。CREATE_SNAPSHOTファンクションおよびプロシージャこのファンクションおよびプロシージャは、スナップショットを作成します。ファンクションの場合、スナップショットIDが戻されます。CREATE_SNAPSHOTのパラメータパラメータ説明flush_levelスナップショットが'TYPICAL'または'ALL'の場合のフラッシュ・レベル。例この例では、TYPICALレベルでマニュアル・スナップショットを作成します。DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT();CREATE_SNAPSHOT操作後にDBA_HIST_SNAPSHOTビューを問い合せると、ワークロード・リポジトリにもう1つスナップショットIDが追加されているのが確認できます。DROP_BASELINEプロシージャこのプロシージャは、以前に定義したベースラインを削除します。DROP_BASELINEのパラメータパラメータ説明baseline_nameシステムから削除するベースラインの名前。cascadeTRUEに設定すると、ベースラインに関連付けられたスナップショットの組合せも削除されます。それ以外の場合、ベースラインのみが削除されます。dbidベースラインのデータベースID。NULLの場合は、ローカル・データベースのデータベースIDになります。デフォルトはNULLです。例この例では、元のスナップショットを削除せずに、ベースライン'oltp_peakload_bl'を削除します。'oltp_peakload_bl');DROP_BASELINE操作後にDBA_HIST_BASELINEビューを問い合せると、指定したベースライン定義が削除されているのが確認できます。DBA_HIST_SNAPSHOTビューを問い合せて、元のスナップショットが変更されていないことを確認できます。DROP_BASELINE_TEMPLATEプロシージャこのプロシージャは、不要になったテンプレートを削除します。DROP_BASELINE_TEMPLATEプロシージャのパラメータパラメータ説明template_name削除するテンプレートの名前。dbidベースラインのデータベースID。NULLの場合は、ローカル・データベースのデータベースIDになります。デフォルトはNULLです。DROP_SNAPSHOT_RANGEプロシージャこのプロシージャは、一定の範囲のスナップショットを削除します。DROP_SNAPSHOT_RANGEプロシージャのパラメータパラメータ説明low_snap_id削除するスナップショットの最低のスナップショットID。high_snap_id削除するスナップショットの最高のスナップショットID。dbidデータベースID(デフォルトはローカルDBID)。例この例では、ローカル・データベースのスナップショットID102から105までのスナップショットの範囲を削除します。Snapshot操作後にdba_hist_snapshotビューを問い合せると、ワークロード・リポジトリからスナップショット102から105が削除されているのが確認できます。MODIFY_SNAPSHOT_SETTINGSプロシージャこのプロシージャは、スナップショット生成の3つの側面を制御します。INTERVAL設定は、スナップショットが自動的に取得される間隔に影響を与えます。RETENTION設定は、ワークロード・リポジトリにスナップショットが保持される期間に影響を与えます。Top基準ごとに取得されるSQLの数。SQLコレクションは、自動および手動によるスナップショットの両方に対して、ユーザー指定の数を使用します。2つのオーバーロードがあります。最初のオーバーロードはtopnsql引数のNUMBERを使用し、2番目のオーバーロードはVARCHAR2を使用します。これらの違いについては、パラメータの説明を参照してください。MODIFY_SNAPSHOT_SETTINGSプロシージャのパラメータパラメータ説明retention新しい保存期間(分単位)。値は、MIN_RETENTION(1日)からMAX_RETENTION(100年)の範囲で指定する必要があります。ZEROを指定した場合、スナップショットは永久に保持されます。システム定義の大きい値が保存期間設定として使用されます。NULLを指定した場合、古い保存期間の値が維持されます。保存期間設定は、SYSTEM_MOVING_WINDOWベースラインのウィンドウ・サイズ以上にする必要があります。保存期間をウィンドウ・サイズ以下にする必要がある場合は、MODIFY_BASELINE_WINDOW_SIZEプロシージャを使用してウィンドウ・サイズを調整できます。intervalスナップショット間の新しい間隔設定(分単位)。値はMIN_INTERVAL(10分)からMAX_INTERVAL(1年)の範囲で指定する必要があります。ZEROを指定した場合、自動および手動によるスナップショットは無効になります。システム定義の大きい値が保存期間設定として使用されます。NULLを指定した場合、現在の値が維持されます。