DBMS_QOPATCH

127 DBMS_QOPATCH

DBMS_QOPATCHパッケージでは、インストールしたデータベース・パッチを確認するためのインタフェースが提供されます。

この章のトピックは、次のとおりです:

127.1 DBMS_QOPATCHの概要

DBMS_QOPATCHパッケージでは、インストールしたデータベース・パッチを確認するためのPLSQL/SQLインタフェースが提供されます。このインタフェースでは、OPATCH LSINVENTORY -XMLコマンドの一部として使用可能なすべてのパッチ情報が提供されます。このパッケージは、パッチとメタ情報を提供するために、OUIパッチ・インベントリにリアルタイムでアクセスします。

127.2 DBMS_QOPATCHのセキュリティ・モデル

DBMS_QOPATCHパッケージはSYSスキーマの一部として作成され、SYSはこれらのサブプログラムを実行できる唯一のユーザーです。

127.3 DBMS_QOPATCHの操作上のノート

DBMS_QOPATCHには、次の操作上のノートが適用されます。

このパッケージは、データベースがOPENの場合のみ動作します。
Oracle Real Application Clusters(RAC)環境では、サブプログラムで他のRACノードからデータのフェッチが必要な場合に、他のノードにジョブを作成することでデータを取得します。この場合に、他のRACノードからデータをフェッチするには、JOB_QUEUE_PROCESSESがパッケージに対して>0である必要があります。
ジョブの実行に遅延が生じた場合は、パッケージによってORA-20008エラーが返されます。

127.4 DBMS_QOPATCHの例外

次の表に、DBMS_QOPATCHパッケージで発生する例外を示します。

表127-1 DBMS_QOPATCHエラー・メッセージ

エラー・コード	説明
`ORA-20001`	最新のXMLインベントリが表にロードされていません。
`ORA-20002`	ディレクトリの作成に失敗しました。
`ORA-20003`	ノード上でのジョブの構成に失敗しました。
`ORA-20004`	ノードが非アクティブのためジョブの構成に失敗しました。
`ORA-20005`	指定のノードとインスタンス名を使用してジョブが構成されていません。
`ORA-20006`	構成されたRACのアクティブなインスタンスとOpatchジョブの数が同じではありません。
`ORA-20007`	ノードまたはインスタンスが非アクティブのためジョブの構成に失敗しました。
`ORA-20008`	タイムアウト - ジョブの実行時間が120秒を超えています。
`ORA-20009`	ジョブの実行に失敗しました。
`ORA-20010`	ノードが非アクティブでジョブが実行できません。
`ORA-20011`	ジョブ名が`NULL`でインベントリがロードできません。
`ORA-20012`	`JOB_QUEUE_PROCESSES`が0に設定されていてインベントリがロードできません。
`ORA-20013`	`DBMS_QOPATCH`は、主に、インストールされていない領域で動作しました。
`ORA-20014`	データベースがオープンしていません。
`ORA-20015`	データベースが読取り専用でオープンしました。

127.5 DBMS_QOPATCHサブプログラムの要約

この表では、DBMS_QOPATCHパッケージのサブプログラムをリストし、簡単に説明します。

表127-2 DBMS_QOPATCHパッケージのサブプログラム

サブプログラム	説明
CHECK_PATCH_INSTALLEDファンクション	パッチがインストールされているかどうかを確認します。
GET_OPATCH_BUGSファンクション	パッチ番号が指定されている場合にXML形式でパッチのバグ・リストを作成します。パッチが指定されていない場合は、すべてのパッチにインストール済のすべてのバグがXML形式でリストされます。
GET_OPATCH_COUNTファンクション	インストール済のパッチの合計数をXML形式で作成します。
GET_OPATCH_DATAファンクション	パッチの最上位レベルのパッチ情報(パッチID、パッチの作成時間など)をXML要素で作成します。
GET_OPATCH_FILESファンクション	特定のパッチ番号で変更されたファイルのリストをXML形式で作成します。
GET_OPATCH_INSTALL_INFOファンクション	パッチやインベントリの場所など、`ORACLE_HOME`の詳細を含むXML要素を戻します。
GET_OPATCH_LISTファンクション	XMLインベントリからXML要素としてインストール済のパッチのリストを作成します。
GET_OPATCH_LSINVENTORY	Opatchインベントリ全体をXMLインスタンス文書として戻します。
GET_OPATCH_OLAYSファンクション	特定のパッチのオーバーレイ・パッチをXML要素として作成します。
GET_OPATCH_PREQSファンクション	特定のパッチの前提条件パッチをXML要素として作成します。
GET_OPATCH_XSLT	Opatch XMLインベントリ表示のスタイルシートを戻します。
GET_PATCH_DETAILSファンクション	`opatch lsinventory`から詳細なパッチ情報を表示します。
GET_SQLPATCH_STATUSプロシージャ	完全なパッチ・レベルの情報を作成するために、SQLパッチ・レジストリから問い合せることでSQLパッチの状態を表示します。
IS_PATCH_INSTALLEDファンクション	XMLインベントリを問い合せることで、インストール済のパッチの情報(パッチID、適用日、SQLパッチ情報など)をXMLノードとして作成します。
OPATCH_COMPARE_CURRENTファンクション	現在のデータベースをバグのリストと比較します。
OPATCH_COMPARE_NODESファンクション	現在接続されているノードのインスタンスを含む特定のRACノードと、現在のノードを比較します。戻り値は、データがリフレッシュされたかどうかを示します。
SET_CURRENT_OPINSTプロシージャ	ノード名とインスタンスを設定して、Oracle Real Application Clusters(RAC)環境でその固有のインベントリの詳細を取得します。

127.5.1 CHECK_PATCH_INSTALLEDファンクション

パッチがインストールされているかどうかを確認します。

構文

DBMS_QOPATCH.CHECK_PATCH_INSTALLED (
   bugs     IN QOPATCH_LIST);
 RETURN VARCHAR2;

パラメータ

表127-3 CHECK_PATCH_INSTALLEDパラメータ

パラメータ	説明
`bugs`	チェックするパッチのリスト。

127.5.2 GET_OPATCH_BUGSファンクション

このファンクションでは、パッチ番号が指定されている場合にパッチ内のバグ・リストを提供します。パッチ番号が指定されていない場合は、指定されたXML形式ですべてのバグがリストされます。

構文

DBMS_QOPATCH.GET_OPATCH_BUGS (
   patchnum IN VARCHAR2 DEFAULT NULL);
 RETURN XMLTYPE;

パラメータ

表127-4 GET_OPATCH_BUGSファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.3 GET_OPATCH_COUNTファンクション

このファンクションは、インストール済のパッチの合計数をXML形式で作成します。

構文

DBMS_QOPATCH.GET_OPATCH_COUNT (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-5 GET_OPATCH_COUNTファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.4 GET_OPATCH_DATAファンクション

このファンクションは、パッチの最上位レベルのパッチ情報(パッチID、パッチの作成時間など)をXML要素で作成します。

構文

DBMS_QOPATCH.GET_OPATCH_DATA (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-6 GET_OPATCH_DATAファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.5 GET_OPATCH_FILESファンクション

このファンクションは、特定のパッチ番号で変更されたファイルのリストをXML形式で作成します。

構文

DBMS_QOPATCH.GET_OPATCH_FILES (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-7 GET_OPATCH_FILESファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.6 GET_OPATCH_INSTALL_INFOファンクション

このファンクションは、パッチやインベントリの場所など、ORACLE_HOMEの詳細を含むXML要素を戻します。

構文

DBMS_QOPATCH.GET_OPATCH_INSTALL_INFO
 RETURNS XMLTYPE;

127.5.7 GET_OPATCH_LISTファンクション

このファンクションは、XMLインベントリからXML要素としてインストール済のパッチのリストを作成します。

構文

DBMS_QOPATCH.GET_OPATCH_LIST
 RETURN XMLTYPE;

127.5.8 GET_OPATCH_LSINVENTORY

このファンクションは、Opatchインベントリ全体をXMLインスタンス文書として戻します。

構文

DBMS_QOPATCH.GET_OPATCH_LSINVENTORY
 RETURN XMLTYPE;

127.5.9 GET_OPATCH_OLAYSファンクション

このファンクションは、特定のパッチのオーバーレイ・パッチをXML要素として作成します。

構文

DBMS_QOPATCH.GET_OPATCH_OLAYS (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-8 GET_OPATCH_OLAYSファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.10 GET_OPATCH_PREQSファンクション

このファンクションは、特定のパッチの前提条件パッチをXML要素として作成します。

構文

DBMS_QOPATCH.GET_OPATCH_PREQS (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-9 GET_OPATCH_PREQSファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.11 GET_OPATCH_XSLT

このファンクションは、Opatch XMLインベントリ表示のスタイルシートを戻します。このサブプログラムの戻り値のタイプを使用することでXMLTRANSFORMの実行が可能となり、その変換された結果の表示はOpatchテキストの出力と同じになります。

構文

DBMS_QOPATCH.GET_OPATCH_XSLT
 RETURN XMLTYPE;

127.5.12 GET_PATCH_DETAILSファンクション

opatch lsinventoryから詳細なパッチ情報を表示します。

構文

DBMS_QOPATCH.GET_PATCH_DETAILS (
   patch    IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-10 GET_PATCH_DETAILSファンクションのパラメータ

パラメータ	説明
`patch`	パッチ番号。

127.5.13 GET_SQLPATCH_STATUSプロシージャ

このファンクションは、完全なパッチ・レベルの情報を作成するために、SQLパッチ・レジストリから問い合せることでSQLパッチの状態を表示します。パッチ番号が指定されている場合は、特定のSQLパッチに固有の情報が表示され、指定されていない場合はすべてのSQLパッチの情報が表示されます。

構文

DBMS_QOPATCH.GET_SQLPATCH_STATUS (
   patchnum IN VARCHAR2 DEFAULT NULL);

パラメータ

表127-11 GET_SQLPATCH_STATUSプロシージャのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.14 IS_PATCH_INSTALLEDファンクション

このファンクションは、XMLインベントリを問い合せることで、インストール済のパッチの情報(パッチID、適用日、SQLパッチ情報など)をXMLノードとして作成します。

構文

DBMS_QOPATCH.IS_PATCH_INSTALLED (
   patchnum IN VARCHAR2);
 RETURN XMLTYPE;

パラメータ

表127-12 IS_PATCH_INSTALLEDファンクションのパラメータ

パラメータ	説明
`patchnum`	パッチ番号

127.5.15 OPATCH_COMPARE_CURRENTファンクション

現在のデータベースをバグのリストと比較します。

構文

DBMS_QOPATCH.OPATCH_COMPARE_CURRENT Function (
   bugs     IN QOPATCH_LIST);
 RETURN VARCHAR2;

パラメータ

表127-13 OPATCH_COMPARE_CURRENTファンクションのパラメータ

パラメータ	説明
`bugs`	現在のデータベースと比較するバグのリスト。

127.5.16 OPATCH_COMPARE_NODESファンクション

現在接続されているノードのインスタンスを含む特定のRACノードと、現在のノードを比較します。戻り値は、データがリフレッシュされたかどうかを示します。

構文

DBMS_QOPATCH.OPATCH_COMPARE_NODES (
   node     IN VARCHAR2 DEFAULT NULL,
   inst     IN VARCHAR2 DEFAULT NULL);
 RETURN VARCHAR2;

パラメータ

表127-14 OPATCH_COMPARE_NODESファンクションのパラメータ

パラメータ	説明
`node`	ノード名
`inst`	インスタンス名

127.5.17 SET_CURRENT_OPINSTプロシージャ

このプロシージャは、ノード名とインスタンスを設定して、Oracle Real Application Clusters(RAC)環境でその固有のインベントリの詳細を取得します。

構文

DBMS_QOPATCH.SET_CURRENT_OPINST (
   node_name    IN VARCHAR2 DEFAULT NULL,
   inst_name    IN VARCHAR2 DEFAULT NULL);

パラメータ

表127-15 SET_CURRENT_OPINSTプロシージャのパラメータ

パラメータ	説明
`node_name`	ノードの名前
`inst_name`	インスタンスの名前