DBMS_QOPATCHDBMS_QOPATCHパッケージでは、インストールしたデータベース・パッチを確認するためのインタフェースが提供されます。この章では、次の項目について説明します。概要セキュリティ・モデル使用上の注意エラー・メッセージ概要DBMS_QOPATCHパッケージでは、インストールしたデータベース・パッチを確認するためのPLSQL/SQLインタフェースが提供されます。-XMLコマンドの一部として使用可能なすべてのパッチ情報が提供されます。このパッケージは、パッチとメタ情報を提供するために、OUIパッチ・インベントリにリアルタイムでアクセスします。セキュリティ・モデルDBMS_QOPATCHパッケージはSYSスキーマの一部として作成され、SYSはこれらのサブプログラムを実行できる唯一のユーザーです。使用上の注意このパッケージは、データベースがOPENの場合のみ動作します。Clusters(RAC)環境では、サブプログラムで他のRACノードからデータのフェッチが必要な場合に、他のノードにジョブを作成することでデータを取得します。この場合に、他のRACノードからデータをフェッチするには、JOB_QUEUE_PROCESSESがパッケージに対して>0である必要があります。ジョブの実行に遅延が生じた場合は、パッケージによってORA-20008エラーが返されます。エラー・メッセージ次の表に、DBMS_QOPATCHパッケージで発生する例外を示します。DBMS_QOPATCHエラー・メッセージエラー・コード説明ORA-20001最新のXMLインベントリが表にロードされていません。ORA-20002ディクショナリの作成に失敗しました。ORA-20003ノード上でのジョブの構成に失敗しました。ORA-20004ノードが非アクティブのためジョブの構成に失敗しました。ORA-20005指定のノードとインスタンス名を使用してジョブが構成されていません。ORA-20006構成されたRACのアクティブなインスタンスとOpatchジョブの数が同じではありません。ORA-20007ノードまたはインスタンスが非アクティブのためジョブの構成に失敗しました。ジョブの実行時間が120秒を超えています。ORA-20009ジョブの実行に失敗しました。ORA-20010ノードが非アクティブでジョブが実行できません。ORA-20011ジョブ名がNULLでインベントリがロードできません。ORA-20012JOB_QUEUE_PROCESSESが0に設定されていてインベントリがロードできません。ORA-20013DBMS_QOPATCHは、主に、インストールされていない領域で動作しました。ORA-20014データベースがオープンしていません。ORA-20015データベースが読取り専用でオープンしました。DBMS_QOPATCHパッケージのサブプログラムサブプログラム説明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_LSINVENTORYOpatchインベントリ全体をXMLインスタンス文書として戻します。GET_OPATCH_OLAYSファンクション特定のパッチのオーバーレイ・パッチをXML要素として作成します。GET_OPATCH_PREQSファンクション特定のパッチの前提条件パッチをXML要素として作成します。XMLインベントリ表示のスタイルシートを戻します。GET_PENDING_ACTIVITYファンクションバイナリ・インベントリを問い合せることで、単一インスタンス上で適用されたSQLパッチに関連する情報を戻します。GET_SQLPATCH_STATUSプロシージャ完全なパッチ・レベルの情報を作成するために、SQLパッチ・レジストリから問い合せることでSQLパッチの状態を表示します。IS_PATCH_INSTALLEDファンクションXMLインベントリを問い合せることで、インストール済のパッチの情報(パッチID、適用日、SQLパッチ情報など)をXMLノードとして作成します。PATCH_CONFLICT_DETECTIONファンクション既存のパッチと競合する場合は、特定のファイルの競合するパッチを戻します。Clusters(RAC)環境でその固有のインベントリの詳細を取得します。GET_OPATCH_BUGSファンクションこのファンクションでは、パッチ番号が指定されている場合にパッチ内のバグ・リストを提供します。パッチ番号が指定されていない場合は、指定されたXML形式ですべてのバグがリストされます。GET_OPATCH_BUGSファンクションのパラメータパラメータ説明patchnumパッチ番号GET_OPATCH_COUNTファンクションこのファンクションは、インストール済のパッチの合計数をXML形式で作成します。GET_OPATCH_COUNTファンクションのパラメータパラメータ説明patchnumパッチ番号GET_OPATCH_DATAファンクションこのファンクションは、パッチの最上位レベルのパッチ情報(パッチID、パッチの作成時間など)をXML要素で作成します。GET_OPATCH_DATAファンクションのパラメータパラメータ説明patchnumパッチ番号GET_OPATCH_FILESファンクションこのファンクションは、特定のパッチ番号で変更されたファイルのリストをXML形式で作成します。GET_OPATCH_FILESファンクションのパラメータパラメータ説明patchnumパッチ番号GET_OPATCH_INSTALL_INFOファンクションこのファンクションは、パッチやインベントリの場所など、ORACLE_HOMEの詳細を含むXML要素を戻します。XMLTYPE;GET_OPATCH_LISTファンクションこのファンクションは、XMLインベントリからXML要素としてインストール済のパッチのリストを作成します。XMLTYPE;GET_OPATCH_LSINVENTORYこのファンクションは、Opatchインベントリ全体をXMLインスタンス文書として戻します。XMLTYPE;GET_OPATCH_OLAYSファンクションこのファンクションは、特定のパッチのオーバーレイ・パッチをXML要素として作成します。GET_OPATCH_OLAYSファンクションのパラメータパラメータ説明patchnumパッチ番号GET_OPATCH_PREQSファンクションこのファンクションは、特定のパッチの前提条件パッチをXML要素として作成します。XMLインベントリ表示のスタイルシートを戻します。このサブプログラムの戻り値のタイプを使用することでXMLTRANSFORMの実行が可能となり、その変換された結果の表示はOpatchテキストの出力と同じになります。XMLTYPE;GET_PENDING_ACTIVITYファンクションこのファンクションでは、バイナリ・インベントリを問い合せることで、単一インスタンス上で適用されたSQLパッチに関連する情報が戻されます。Clusters(RAC)システムである場合は、SQLパッチが適用されないノード名がリストされます。XMLTYPE;GET_SQLPATCH_STATUSプロシージャこのファンクションは、完全なパッチ・レベルの情報を作成するために、SQLパッチ・レジストリから問い合せることでSQLパッチの状態を表示します。パッチ番号が指定されている場合は、特定のSQLパッチに固有の情報が表示され、指定されていない場合はすべてのSQLパッチの情報が表示されます。GET_SQLPATCH_STATUSプロシージャのパラメータパラメータ説明patchnumパッチ番号IS_PATCH_INSTALLEDファンクションこのファンクションは、XMLインベントリを問い合せることで、インストール済のパッチの情報(パッチID、適用日、SQLパッチ情報など)をXMLノードとして作成します。IS_PATCH_INSTALLEDファンクションのパラメータパラメータ説明patchnumパッチ番号PATCH_CONFLICT_DETECTIONファンクションこのファンクションは、既存のパッチと競合した場合に、特定のファイルの競合するパッチを戻します。PATCH_CONFLICT_DETECTIONファンクションのパラメータパラメータ説明fileNameファイル名。Clusters(RAC)環境でその固有のインベントリの詳細を取得します。PATCH_CONFLICT_DETECTIONファンクションのパラメータパラメータ説明node_nameノードの名前です。inst_nameインスタンスの名前です。