DBMS_RESCONFIG
パッケージは、リソース構成リストを操作して、リソースのリスナー情報を取得するインタフェースを提供します。
関連項目: リソース構成の詳細は、『Oracle XML DB開発者ガイド』を参照してください。 |
この章では、次の項目について説明します。
DBMS_RESCONFIG
パッケージには、個々のリソースのリソース構成リストおよびリポジトリを管理するためのファンクションおよびプロシージャが含まれています。
次の表に、このパッケージのサブプログラムをアルファベット順に示します。
表104-1 DBMS_RESCONFIGパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
リポジトリの構成リストの特定の場所に、絶対パスで指定されたリソース構成を挿入します。 |
|
ターゲット・リソースの構成リストの特定の場所に、絶対パスで指定されたリソース構成を挿入します。 |
|
rcpathで指定されたリソース構成がターゲット・リソースの構成リストに含まれていない場合は、このリソース構成を追加します。 |
DELETEREPOSITORYRESCONFIGプロシージャ |
リポジトリの構成リストの特定の場所にある構成を削除します。 |
|
ターゲット・リソースの構成リストの特定の場所にある構成を削除します。 |
|
特定のリソースに適用できるリスナーのリストを戻します。 |
|
リポジトリの構成リストの特定の場所にリソース構成を戻します。 |
GETREPOSITORYRESCONFIGPATHSファンクション |
リポジトリに対して定義されたリソース構成パスのリストを戻します。 |
|
ターゲット・リソースの構成リストの特定の場所にリソース構成を戻します。 |
|
ターゲット・リソースの構成リストで定義されたリソース構成パスのリストを戻します。 |
このプロシージャは、リポジトリの構成リストの特定の場所に、絶対パスで指定されたリソース構成を挿入します。現在その位置にある要素(ある場合)および後続の要素を右に移動します。
構文
DBMS_RESCONFIG.ADDREPOSITORYRESCONFIG( rcpath IN VARCHAR2, pos IN PLS_INTEGER := NULL);
パラメータ
表104-2 ADDREPOSITORYRESCONFIGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
挿入されるリソース構成の絶対パス。 |
|
新しい構成が挿入される索引。このパラメータが指定されていない場合は、リストの最後に新しい構成が追加されます。索引が範囲外( |
使用上の注意
rcpath
で参照されるドキュメントがXDBResConfig
.xsd
スキーマに基づいていない場合は、例外が発生します。
ユーザーには、挿入されるリソース構成に対するXDBADMIN
ロールおよびREAD
権限が必要です。このロールおよび権限がない場合は、エラーが戻されます。
このプロシージャは、ターゲット・リソースの構成リストの特定の場所に、絶対パスで指定されたリソース構成を挿入します。現在その位置にある要素(ある場合)および後続の要素を右に移動します。
構文
DBMS_RESCONFIG.ADDRESCONFIG( respath IN VARCHAR2, rcpath IN VARCHAR2, pos IN PLS_INTEGER := NULL);
パラメータ
表104-3 ADDRESCONFIGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ターゲット・リソースの絶対パス。 |
|
挿入されるリソース構成の絶対パス。rcpathがターゲットの構成リストにすでに存在している場合は、例外が発生します。 |
|
新しい構成が挿入される索引。このパラメータが指定されていない場合は、リストの最後に新しい構成が追加されます。索引が範囲外( |
使用上の注意
rcpath
で参照されるドキュメントがXDBResConfig
.xsd
スキーマに基づいていない場合は、例外が発生します。
ユーザーには、ターゲット・リソースに対するWRITE
-CONFIG
権限、および挿入されるリソース構成に対する読取り権限が必要です。この権限がない場合は、エラーが戻されます。
このプロシージャは、rcpathで指定されたリソース構成がターゲット・リソースの構成リストに含まれていない場合に、このリソース構成を追加します。
構文
DBMS_RESCONFIG.ADDRESCONFIG( respath IN VARCHAR2, rcpath IN VARCHAR2, appendOption IN PLS_INTEGER);
パラメータ
表104-4 ADDRESCONFIGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
respath |
ターゲット・リソースの絶対パス。 |
|
ターゲットの構成リストの最後に追加されるリソース構成の絶対パス。 |
|
|
使用上の注意
rcpath
で参照されるドキュメントがXDBResConfig
.xsdスキーマに基づいていない場合は、例外が発生します。
ユーザーには、影響を受けるすべてのリソースに対するWRITE
-CONFIG
権限、および挿入されるリソース構成に対する読取り権限が必要です。この権限がない場合は、エラーが戻されます。
このプロシージャは、リポジトリの構成リストの特定の場所にある構成を削除します。後続の要素を左に移動します。
構文
DBMS_RESCONFIG.DELETEREPOSITORYRESCONFIG( pos IN PLS_INTEGER);
パラメータ
表104-5 DELETEREPOSITORYRESCONFIGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
削除される構成の索引。索引が範囲外( |
使用上の注意
ユーザーには、この操作を行うためのXDBADMIN
ロールが必要です。
この文は、DDL文と同様に処理されます。つまり、この文の前後で暗黙的にコミットされます。
このプロシージャは、ターゲット・リソースの構成リストの特定の場所にある構成を削除します。後続の要素を左に移動します。ユーザーは、再帰的な削除に対するオーバーロードを使用できます。
構文
DBMS_RESCONFIG.DELETERESCONFIG( respath IN VARCHAR2, pos IN PLS_INTEGER);
DBMS_RESCONFIG.DELETERESCONFIG( respath IN VARCHAR2, rcpath IN VARCHAR2, deleteOption IN PLS_INTEGER);
パラメータ
表104-6 DELETERESCONFIGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ターゲット・リソースの絶対パス。 |
|
削除される構成の索引。索引が範囲外( |
|
リストに存在する場合に削除されるリソース構成の絶対パス。 |
|
|
使用上の注意
ユーザーには、この操作を行うためにターゲット・リソースに対するWRITE-CONFIG
権限が必要です。
このファンクションは、特定のリソースに適用できるリスナーのリストを戻します。
このファンクションによって戻される値は、XDBResconfig
.xsd
スキーマの<event-listeners>
要素を含むXML文書です。この文書には、リポジトリ・レベルのリスナーなど、ターゲット・リソースに適用できるすべてのリスナーが含まれています。ユーザーは、戻されるXML文書から、EXTRACT
演算子を使用して固有のイベントに対して定義されたリスナーを取得できます。
構文
DBMS_RESCONFIG.GETLISTENERS( path IN VARCHAR2) RETURN XMLTYPE;
パラメータ
使用上の注意
ユーザーには、リポジトリおよびターゲット・リソースによって参照されるすべてのリソース構成に対するアクセス権限が必要です。この権限がない場合は、エラーが戻されます。
このファンクションは、リポジトリの構成リストの指定された場所にリソース構成を戻します。
構文
DBMS_RESCONFIG.GETREPOSITORYRESCONFIG( pos IN PLS_INTEGER) RETURN XMLTYPE;
パラメータ
表104-8 GETREPOSITORYRESCONFIGファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
戻される要素の索引。 索引が範囲外( |
使用上の注意
ユーザーには、要求されたリソース構成に対する読取り権限が必要です。この権限がない場合は、エラーが戻されます。
このファンクションは、リポジトリに対して定義されたリソース構成パスのリストを戻します。
構文
DBMS_RESCONFIG.GETREPOSITORYRESCONFIGPATHS RETURN XDB$STRING_LIST_T;
使用上の注意
ユーザーは、参照されているすべてのリソース構成にアクセスできる必要があります。アクセスできない場合は、エラーが戻されます。
このファンクションは、ターゲット・リソースの構成リストの特定の場所にリソース構成を戻します。
構文
DBMS_RESCONFIG.GETRESCONFIG( respath IN VARCHAR2, pos IN PLS_INTEGER) RETURN XMLTYPE;
パラメータ
表104-9 GETRESCONFIGファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ターゲット・リソースの絶対パス。 |
|
戻される要素の索引。索引が範囲外( |
使用上の注意
ユーザーには、要求されたリソース構成に対する読取り権限が必要です。この権限がない場合は、エラーが戻されます。
このファンクションは、ターゲット・リソースの構成リストで定義されたリソース構成パスのリストを戻します。
構文
DBMS_RESCONFIG.GETRESCONFIGPATHS( respath IN VARCHAR2) RETURN XDB$STRING_LIST_T;
パラメータ
使用上の注意
ユーザーは、参照されているすべてのリソース構成にアクセスできる必要があります。アクセスできない場合は、エラーが戻されます。