186 DBMS_XDB
DBMS_XDB
パッケージ・サブプログラムおよび定数の使用は、Oracle Database 12cでは推奨されていません。すべての機能は下位互換性のために引き続きサポートされますが、それぞれで提供されている代替プロシージャを使用することをお薦めします。
ノート:
詳細は、「推奨されないサブプログラム」および「定数」を参照してください。
DBMS_XDB
パッケージは次の機能をサポートしています。
-
リソース・ビューを補完するリソース管理サブプログラム
-
アクセス制御リスト(ACL)ベースのセキュリティ・メカニズム
-
構成セッション管理
-
XDBユーザー名の作成
この章のトピックは、次のとおりです:
186.1 DBMS_XDBの概要
DBMS_XDB
には広範な管理機能が用意されていますが、DBMS_XDB
パッケージ・サブプログラムおよび定数の使用は、Oracle Database 12cでは推奨されていません。すべての機能は下位互換性のために引き続きサポートされますが、それぞれで提供されている代替プロシージャを使用することをお薦めします。
DBMS_XDB
パッケージは次の機能をサポートしています。
-
リソース管理機能は、 LINKプロシージャ、EXISTSRESOURCEファンクション、LOCKRESOURCEファンクション、GETLOCKTOKENプロシージャ、UNLOCKRESOURCEファンクション、CREATERESOURCEファンクション、RENAMERESOURCEプロシージャ、DELETERESOURCEプロシージャ、GETRESOIDファンクション、CREATEOIDPATHファンクション、およびCREATEFOLDERファンクションの各サブプログラムを提供して、リソース・ビューを補完しています。
-
アクセス制御リスト(ACL)ベースのセキュリティ・メカニズムは、データベースによって保存された階層内ACLまたはデータベース外から保存されたインメモリーACLで使用できます。これらのメソッドの一部は、Oracleリソースおよび任意のデータベース・オブジェクトの両方に使用できます。Oracleリソースには、CHECKPRIVILEGESファンクション、GETACLDOCUMENTファンクションおよびCHANGEPRIVILEGESファンクションを使用します。ACLCHECKPRIVILEGESファンクションは、階層内にオブジェクトを格納せずに、OracleのACLベースのセキュリティ・メカニズムへのアクセスを提供します。
-
構成セッション管理は、CFG_REFRESHプロシージャ、CFG_GETファンクションおよびCFG_UPDATEプロシージャのメソッドでサポートされています。
-
XDBユーザー名はXDBインストール時に作成されます。このユーザーは一連のデフォルトの表およびパッケージを所有します。GETXDB_TABLESPACEファンクションおよび
DBMS_XDB_ADMIN.MOVEXDB_TABLESPACE
プロシージャは、指定した表領域にスキーマを移動でき、デフォルトのSYSAUX
表領域の導入をサポートしています。
186.2 DBMS_XDBの推奨されないサブプログラム
DBMS_XDB
パッケージのすべてのサブプログラムはOracle Database 12cでは推奨されておらず、表に示すDBMS_XDB_CONFIG
パッケージまたはDBMS_XDB_REPOS
パッケージのいずれかで同名の代替サブプログラムに置換されています。
ノート:
新しいアプリケーションでは、推奨されないサブプログラムは使用しないことをお薦めします。推奨されない機能は、下位互換性を維持する目的のみでサポートされており、今後のバージョンでは終了する場合があります。
表186-1 DBMS_XDBの推奨されないサブプログラムとその代替
DBMS_XDB (非推奨) | DBMS_XDB_CONFIG | DBMS_XDB_REPOS |
---|---|---|
186.3 DBMS_XDBのセキュリティ・モデル
DBMS_XDB
パッケージは、XDB
が所有しているため、SYS
またはXDB
によって作成される必要があります。EXECUTE
権限は、PUBLIC
に付与されます。このパッケージ内のサブプログラムは、現行のユーザーの権限を使用して実行されます。XDB構成で動作するサブプログラムは、現行のユーザーがSYS
またはXDB
である場合、または現行のユーザーがXDBADMIN
ロールまたはDBA
ロールを持つ場合にのみ成功します。
186.4 DBMS_XDBの定数
次の表に示すすべての定数は、Oracleリリース12cでは非推奨です。
これらは、DBMS_XDB_CONFIGパッケージまたはDBMS_XDB_REPOSパッケージに再配置されます。ケースごとの転送の詳細は、再配置済の列に記載されています。
定数は、新規アプリケーションのDBMS_XDB
コンテキストで使用しないことをお薦めします。推奨されない機能は、下位互換性を維持する目的のみでサポートされており、今後のバージョンでは終了する場合があります。
表186-2 DBMS_XDBの定数
定数 | タイプ | 値 | 説明 | 再配置済 |
---|---|---|---|---|
|
|
1 |
リソースを削除します。リソースに子がある場合失敗します。 |
|
|
|
2 |
リソースと子がある場合それを削除します。 |
|
|
|
3 |
含まれるオブジェクトが無効な場合でも、リソースを削除します。 |
|
|
|
4 |
含まれるオブジェクトが無効な場合でも、リソースと子がある場合それを削除します。 |
|
|
|
1 |
メタデータ表内の対応する行を削除します。 |
|
|
|
2 |
メタデータ表内の行を削除しません。 |
|
|
|
(60*60) |
ロックが期限切れになるまでのデフォルト時間(秒)。 |
|
|
|
1 |
作成するリンクのタイプ(デフォルト)。 |
|
|
|
2 |
作成するリンクのタイプ。 |
|
|
|
3 |
作成するリンクのタイプ。 |
|
|
|
1 |
アクセスが拒否された場合、次のカスタム認可が試行されます。 |
|
|
|
2 |
アクセスが拒否された場合、Basic認証が使用されます。 |
|
|
|
1 |
最初のHTTPポートのリスナーの定義 |
|
|
|
2 |
2番目のHTTPポートのリスナーの定義 |
|
|
|
1 |
HTTPプロトコルのリスナーの定義 |
|
|
|
2 |
HTTPSプロトコルのリスナーの定義 |
|
186.5 DBMS_XDBサブプログラムの要約
この表は、DBMS_XDB
サブプログラムを示し、簡単に説明しています。
表186-3 DBMS_XDBパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
指定のACLドキュメントで指定されている現行ユーザーに付与されたアクセス権限をチェックします。このアクセス権限は、所有者が'owner'パラメータで指定されているリソースに対するものです。 |
|
有効期限に対するURLパターンのマッピングを |
|
XDB構成にMIMEマッピングを追加します。 |
|
XDB構成にスキーマ位置マッピングを追加します。 |
|
XDB構成にサーブレットを追加します。 |
|
XDB構成にサーブレット・マッピングを追加します。 |
|
XDB構成内の指定したサーブレットにセキュリティ・ロール |
|
XDB構成にXML拡張子を追加します。 |
|
ユーザー定義のメタデータを |
|
セッションの構成情報を取得します。 |
|
セッションの最新の構成情報をデータベースに反映します。 |
|
構成情報を更新します。 |
|
リソースの所有者を指定した所有者に変更します。 |
|
指定したACEを、指定したリソースのACLに追加します。 |
|
指定したリソースに対して現行ユーザーに付与されているアクセス権限をチェックします。 |
|
階層内に新規フォルダ・リソースを作成します。 |
|
オブジェクトIDに基づいたリソースの仮想パスを作成します。 |
|
新規リソースを作成します。 |
|
有効期限に対するURLパターンのすべてのマッピングを |
|
XDB構成からMIMEマッピングを削除します。 |
|
階層からリソースを削除します。 |
|
リソースからメタデータを削除します(スキーマ・ベースまたは非スキーマ・ベースのメタデータに使用できます)。 |
|
指定したスキーマURLのスキーマ位置マッピングをXDB構成から削除します。 |
|
XDB構成からサーブレットを削除します。 |
|
指定したサーブレット名のサーブレット・マッピングをXDB構成から削除します。 |
|
XDB構成内のサーブレットから指定したロールを削除します。 |
|
指定したXML拡張子をXDB構成から削除します。 |
|
Digest認証を有効にします |
|
リソースの絶対パスに基づいて、リソースが階層であるかどうかを判別します。 |
|
パス名を指定して、リソースを保護するACLドキュメントを取得します。 |
|
BLOBとして戻されたリソースの内容を取り出します。 |
|
CLOBとして戻されたリソースの内容を取り出します。 |
|
文字列として戻されたリソースの内容を取り出します。 |
|
|
|
|
|
現在のFTPポートの値を取得します。 |
|
現在のHTTPポートの値を取得します。 |
|
渡されたヘッダーの値を取得します。 |
|
XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを取得します。 |
|
リソースへのパスを指定して、現行ユーザーのリソースのロック・トークンを戻します。 |
|
指定したリソース上の現在のユーザーに付与された権限をすべて取得します。 |
|
リソースの絶対パスからオブジェクトIDを戻します。 |
|
XDB(ユーザー)の現行の表領域を戻します。 |
|
リソースにBLOBコンテンツがある場合は |
|
リソースに文字コンテンツがある場合は |
|
リソースにXMLコンテンツがある場合は |
|
リソースにXMLコンテンツへの |
|
リソースがフォルダまたはコンテナの場合は、 |
|
既存のリソースへのリンクを作成します。 |
|
リソースへのパスを指定して、リソースに対するWebDAVスタイルのロックを取得します。 |
|
指定したリソース内のドキュメント・リンクを処理します。 |
|
リソースからすべてのユーザー・メタデータを削除します。 |
|
XDBリソースの名前を変更します。 |
|
指定したリソースにACLを設定します。 |
|
FTPポートを新しい値に設定します。 |
|
HTTPポートに新しい値を設定します。 |
|
XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを設定します。 |
|
XML DB HTTPサーバーのすべてのリスナーのエンド・ポイントを、ローカルホスト・インタフェースでのみリスニングするか、ローカルホスト・インタフェースと非ローカルホスト・インタフェースの両方でリスニングするかのどちらかに制限します。 |
|
パスを親のパスと子のパスに分割します。 |
|
リソースの変更時刻を現在の時刻に変更します。 |
|
ロック・トークンおよびリソース・パスを指定して、リソースのロックを解除します。 |
|
リソースのメタデータを更新します。 |
186.5.1 ACLCHECKPRIVILEGESファンクション
このファンクションは、リソースのOWNER
による指定したACLドキュメントによって、現在のユーザーに付与されたアクセス権限をチェックします。すべての権限が付与されている場合は、正の整数を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(ACLCHECKPRIVILEGESファンクション)を使用してください。
構文
DBMS_XDB.ACLCHECKPRIVILEGES( acl_path IN VARCHAR2, owner IN VARCHAR2, privs IN xmltype) RETURN PLS_INTEGER;
パラメータ
表186-4 ACLCHECKPRIVILEGESファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ACLドキュメントの階層内の絶対パス。 |
|
リソースの所有者名。疑似ユーザー「DAV:owner」は、ACL権限の解決時にこのユーザーに置き換えられます。 |
|
privilege要素の |
186.5.2 ADDHTTPEXPIREMAPPINGプロシージャ
このプロシージャは、有効期限に対するURLパターンのマッピングをxdb$config
に追加します。これによって、パターンに一致するURLのExpireヘッダーを制御します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDHTTPEXPIREMAPPINGプロシージャ)を使用してください。
構文
DBMS_XDB.ADDHTTPEXPIREMAPPING ( pattern IN VARCHAR2, expire IN VARCHAR2);
パラメータ
表186-5 ADDHTTPEXPIREMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
URLパターン(ワイルドカードとして*のみ使用可能)。 |
|
Apacheの base [plus] (num type)* -- base: now | modification -- type: year|years|month|months|week|weeks|day|days| minute|minutess|second|seconds |
例
DBMS_XDB.ADDHTTPEXPIREMAPPING ('/public/test1/*', 'now plus 4 weeks'); DBMS_XDB.ADDHTTPEXPIREMAPPING ( '/public/test2/*', 'modification plus 1 day 30 seconds');
186.5.3 ADDMIMEMAPPINGプロシージャ
このプロシージャは、XDB構成に次のMIMEマッピングを追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDMIMEMAPPINGプロシージャ)を使用してください。
<mime-mapping> <extension>extension</extension> <mime-type>mimetype</mime-type> </mime-mapping>
構文
DBMS_XDB.ADDMIMEMAPPING( extension IN VARCHAR2, mimetype IN VARCHAR2);
パラメータ
表186-6 ADDMIMEMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
MIMEタイプが追加される拡張子。 |
|
MIMEタイプ |
186.5.4 ADDSCHEMALOCMAPPINGプロシージャ
このプロシージャは、XDB構成に次のスキーマ位置マッピングを追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDMIMEMAPPINGプロシージャ)を使用してください。
<schemaLocation-mapping> <namespace>namespace</namespace> <element>element</element> <schemaURL>schemaURL</schemaURL> </schemaLocation-mapping>
構文
DBMS_XDB.ADDSCHEMALOCMAPPING( namespace IN VARCHAR2, element IN VARCHAR2, schemaURL IN VARCHAR2);
パラメータ
表186-7 ADDSCHEMALOCMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ネームスペース |
|
要素 |
|
スキーマURL |
186.5.5 ADDSERVLETプロシージャ
このプロシージャは、XDB構成にサーブレットを追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDSERVLETプロシージャ)を使用してください。
XDB構成に次のサーブレットを追加します。
<servlet> <servlet-name>name</servlet-name> <servlet-language>language</servlet-language> <display-name>dispname</display-name> <description>descript</description> <servlet-class>class</servlet-class> <servlet-schema>schema</servlet-schema> </servlet>
構文
DBMS_XDB.ADDSERVLET( name IN VARCHAR2, language IN VARCHAR2, dispname IN VARCHAR2, icon IN VARCHAR2 := NULL, descript IN VARCHAR2 := NULL, class IN VARCHAR2 := NULL, jspfile IN VARCHAR2 := NULL, plsql IN VARCHAR2 := NULL, schema IN VARCHAR2 := NULL);
パラメータ
表186-8 ADDSERVLETプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名 |
|
C、Java、PL/SQLのいずれかを指定する必要があります。 |
|
表示名 |
|
アイコン |
|
説明 |
|
このサーブレットに対応する |
|
このパラメータはサポートされていません。このパラメータには常に |
|
このサーブレットに対応する |
|
スキーマを使用して、 値を指定しない場合、デフォルトのリゾルバ仕様を使用してスキーマが検索されます。 |
186.5.6 ADDSERVLETMAPPINGプロシージャ
このプロシージャは、XDB構成にサーブレット・マッピングを追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDSERVLETMAPPINGプロシージャ)を使用してください。
次のサーブレット・マッピングを追加します。
<servlet-mapping> <servlet-pattern>pattern</servlet-pattern> <servlet-name>name</servlet-name></servlet-mapping>
構文
DBMS_XDB.ADDSERVLETMAPPING( pattern IN VARCHAR2, name IN VARCHAR2);
パラメータ
表186-9 ADDSERVLETMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレットのパターン |
|
サーブレット名 |
186.5.7 ADDSERVLETSECROLEプロシージャ
このプロシージャは、XDB構成内の指定したサーブレットにセキュリティ・ロールREF
を追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDSERVLETSECROLEプロシージャ)を使用してください。
次に示すようなセキュリティ・ロールを追加します。
<security-role-ref> <role-name>rolename</role-name> <role-link>rolelink</role-link> <description>descript</description> </security-role-ref>
構文
DBMS_XDB.ADDSERVLETSECROLE( servname IN VARCHAR2, rolename IN VARCHAR2, rolelink IN VARCHAR2, descript IN VARCHAR2 := NULL);
パラメータ
表186-10 ADDSERVLETSECROLEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名 |
|
ロール名 |
|
ロール・リンク |
|
説明 |
186.5.8 ADDXMLEXTENSIONプロシージャ
このプロシージャは、XDB構成の<xml-extensions>
の下にXML拡張子を追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ADDXMLEXTENSIONプロシージャ)を使用してください。
次のXML拡張子を追加します。
<extension>extension</extension>
構文
DBMS_XDB.ADDXMLEXTENSION( extension IN VARCHAR2);
パラメータ
表186-11 ADDXMLEXTENSIONプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
追加するXML拡張子。 |
186.5.9 APPENDRESOURCEMETADATAプロシージャ
このプロシージャは、ユーザー定義のメタデータをXMLTYPE
へのREF
またはXMLTYPE
として使用し、目的のリソースに追加します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(APPENDRESOURCEMETADATAプロシージャ)を使用してください。
構文
DBMS_XDB.APPENDRESOURCEMETADATA ( abspath IN VARCHAR2, metadata IN XMLTYPE); DBMS_XDB.APPENDRESOURCEMETADATA ( abspath IN VARCHAR2, metadata IN REF SYS.XMLTYPE);
パラメータ
表186-12 APPENDRESOURCEMETADATAプロシージャ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
|
メタデータには、スキーマ・ベースまたは非スキーマ・ベースのメタデータを使用できます。スキーマ・ベースのメタデータは、独自の表に格納されます。 |
使用上のノート
-
REF
が渡された場合、プロシージャは、REF
をリソースに、メタデータは別の表に格納します。この場合は、メタデータ表のRESID
列に移入する必要があります。渡されるREF
は一意である必要があることに注意してください。つまり、リソース・メタデータに同じ値を持つREF
が存在していると、プロパティの一意性に違反するため、同じにしないでください。ユーザが、すでに存在するREF
を追加しようとすると、エラーが発生します。 -
XMLTYPEが渡された場合、データを解析してスキーマ・ベースかどうかを判断し、その結果に応じてデータを格納します。
186.5.10 CFG_GETファンクション
このファンクションは、セッションの構成情報をXMLType
インスタンスとして取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(CFG_GETファンクション)を使用してください。
構文
DBMS_XDB.CFG_GET RETURN SYS.XMLType;
186.5.11 CFG_REFRESHプロシージャ
このプロシージャは、セッションの最新の構成情報を反映します。リリース12cでは、このプロシージャの使用は推奨されていません。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(CFG_REFRESHプロシージャ)を使用してください。
構文
DBMS_XDB.CFG_REFRESH;
186.5.12 CFG_UPDATEプロシージャ
このプロシージャは、構成情報を更新して、変更をコミットします。リリース12cでは、このプロシージャの使用は推奨されていません。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(CFG_UPDATEプロシージャ)を使用してください。
構文
DBMS_XDB.CFG_UPDATE( xdbconfig IN SYS.XMLTYPE);
パラメータ
表186-13 CFG_UPDATEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
新規の構成データ。 |
186.5.13 CHANGEOWNERプロシージャ
このプロシージャは、リソースの所有者を指定した所有者に変更します。リリース12cでは、このプロシージャの使用は推奨されていません。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CHANGEOWNERプロシージャ)を使用してください。
構文
DBMS_XDB.CHANGEOWNER( abspath IN VARCHAR2, owner IN VARCHAR2, recurse IN BOOLEAN := FALSE);
パラメータ
表186-14 CHANGEOWNERプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
|
リソースの新しい所有者。 |
|
|
186.5.14 CHANGEPRIVILEGESファンクション
このファンクションは、指定したACEを指定したリソースのACLに追加します。リリース12cでは、このプロシージャの使用は推奨されていません。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CHANGEPRIVILEGESファンクション)を使用してください。
構文
DBMS_XDB.CHANGEPRIVILEGES( res_path IN VARCHAR2, ace IN xmltype) RETURN PLS_INTEGER;
パラメータ
表186-15 CHANGEPRIVILEGESファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
権限を変更する必要があるリソースのパス名。 |
|
|
戻り値
ACLが正常に変更された場合は、正の整数。
使用上のノート
同じprincipalおよび同じ操作(grant
/deny
)を持つACEがACLに存在しない場合、新規のACEがACLの最後に追加されます。
186.5.15 CHECKPRIVILEGESファンクション
このファンクションは、指定したリソースに対して現行ユーザーに付与されているアクセス権限をチェックします。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CHECKPRIVILEGESファンクション)を使用してください。
構文
DBMS_XDB.CHECKPRIVILEGES( res_path IN VARCHAR2, privs IN xmltype) RETURN PLS_INTEGER;
パラメータ
表186-16 CHECKPRIVILEGESファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの階層内の絶対パス。 |
|
privilege要素の |
戻り値
要求された権限がすべて付与されている場合は、正の整数。
186.5.16 CREATEFOLDERファンクション
この非推奨となったファンクションは、階層内に新規フォルダ・リソースを作成します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CREATEFOLDERファンクション)を使用してください。
構文
DBMS_XDB.CREATEFOLDER( path IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-17 CREATEFOLDERファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
新規フォルダのパス名。 |
戻り値
操作が成功した場合はTRUE
。そうでない場合はFALSE
。
使用上のノート
指定したパス名の親フォルダは、階層内にすでに存在している必要があります。たとえば、pathパラメータに'/folder1/folder2'
を指定する場合は、'/folder1'
がすでに存在している必要があります。
186.5.17 CREATEOIDPATHファンクション
この非推奨となったファンクションは、オブジェクトIDに基づいたリソースの仮想パスを作成します。
ノート:
リリース12cでは、このファンクションの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CREATEOIDPATHファンクション)を使用してください。
構文
DBMS_XDB.CREATEOIDPATH( oid IN RAW) RETURN VARCHAR2;
パラメータ
表186-18 CREATEOIDPATHファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースのオブジェクトID。 |
186.5.18 CREATERESOURCEファンクション
この非推奨となったファンクションは、新規リソースを作成します。オーバーロード・オプションの記述は各バージョンの構文の前に配置します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(CREATERESOURCEファンクション)を使用してください。
構文
既存のXMLType
行にREF
を指定し、その行を指す内容を持つリソースを作成します。この行は、別のリソース内に事前に存在させることはできません。
DBMS_XDB.CREATERESOURCE( abspath IN VARCHAR2, datarow IN REF SYS.XMLTYPE, createfolders IN BOOLEAN := FALSE) RETURN BOOLEAN;
内容として指定したBLOB
を使用して、リソースを作成し、ソースBLOB
の文字セットを指定します。
DBMS_XDB.CREATERESOURCE( abspath IN VARCHAR2, data IN BLOB, csid IN NUMBER :=0, createfolders IN BOOLEAN := FALSE) RETURN BOOLEAN;
内容として指定したBFILE
を使用して、リソースを作成し、ソースBFILE
の文字セットを指定します。
DBMS_XDB.CREATERESOURCE ( abspath IN VARCHAR2, data IN BFILE, csid IN NUMBER :=0, createfolders IN BOOLEAN := FALSE) RETURN BOOLEAN;
指定したCLOB
を内容として使用し、リソースを作成します。
DBMS_XDB.CREATERESOURCE ( abspath IN VARCHAR2, data IN CLOB, createfolders IN BOOLEAN := FALSE) RETURN BOOLEAN;
文字列を指定すると、その文字列を内容として持つ新規リソースを階層に挿入します。
DBMS_XDB.CREATERESOURCE ( abspath IN VARCHAR2, data IN VARCHAR2, schemaurl IN VARCHAR2 := NULL, elem IN VARCHAR2 := NULL) RETURN BOOLEAN;
XMLTYPE
およびスキーマURLを指定すると、XMLTYPE
を内容として持つ新規リソースを階層に挿入します。
DBMS_XDB.CREATERESOURCE ( abspath IN VARCHAR2, data IN SYS.XMLTYPE, schemaurl IN VARCHAR2 := NULL, elem IN VARCHAR2 := NULL) RETURN BOOLEAN;
パラメータ
表186-19 CREATERESOURCEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
作成するリソースの絶対パス。パス名の親フォルダは、階層内にすでに存在している必要があります。たとえば、 |
|
新規リソースの内容が含まれている文字列バッファ。データは解析され、スキーマに基づいたXML文書が含まれているかどうかがチェックされ、含まれている場合、内容はスキーマのデフォルト表にスキーマに基づいたものとして格納されます。含まれていない場合は、バイナリ・データとして保存されます。 |
|
内容として使用する |
|
ドキュメントの文字セットID。有効なOracle IDである必要があり、無効な場合、エラーが戻されます。 CSIDを指定しない場合またはCSIDに0(ゼロ)を指定した場合、ドキュメントの文字セットIDは次のように判断されます。
|
|
|
|
XMLデータの場合、データが準拠するスキーマURL(デフォルトは |
|
要素名(デフォルトは |
戻り値
操作が成功した場合はTRUE
。そうでない場合はFALSE
。
186.5.19 DELETEHTTPEXPIREMAPPINGプロシージャ
この推奨されないプロシージャは、有効期限に対するURLパターンのすべてのマッピングをxdb$config
から削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETEHTTPEXPIREMAPPINGプロシージャ)を使用してください。
構文
DBMS_XDB.DELETEHTTPEXPIREMAPPING( pattern IN VARCHAR2);
パラメータ
表186-20 DELETEHTTPEXPIREMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
URLパターン(ワイルドカードとして*のみ使用可能)。 |
186.5.20 DELETEMIMEMAPPINGプロシージャ
この推奨されないプロシージャは、指定した拡張子のMIMEマッピングをXDB構成から削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(CFG_GETファンクション)を使用してください。
構文
DBMS_XDB.DELETEMIMEMAPPING( extension IN VARCHAR2);
パラメータ
表186-21 DELETEMIMEMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
MIMEタイプを削除する拡張子。 |
186.5.21 DELETERESOURCEプロシージャ
この推奨されないプロシージャは、階層からリソースを削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(DELETERESOURCEプロシージャ)を使用してください。
構文
DBMS_XDB.DELETERESOURCE( path IN VARCHAR2, delete_option IN PLS_INTEGER);
パラメータ
表186-22 DELETERESOURCEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
削除するリソースのパス名。 |
|
表186-2で定義されたリソースの削除方法を制御するオプション:
|
186.5.22 DELETERESOURCEMETADATAプロシージャ
この推奨されないプロシージャは、絶対パスでリソースを使用し、REFで識別されるスキーマ・ベースのメタデータ、またはネームスペースと名前の組合せで識別されるメタデータ(スキーマ・ベースまたは非スキーマ・ベースのメタデータ)を削除します。また、メタデータの削除方法を指定する追加のパラメータ(オプション)も使用できます。このパラメータは、削除する必要のあるスキーマ・ベースのリソース・メタデータにのみ関連しています。非スキーマ・ベースのメタデータの場合、このパラメータは無視されます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(DELETERESOURCEMETADATAプロシージャ)を使用してください。
構文
次の構文は、スキーマ・ベースのメタデータにのみ使用できます。
DBMS_XDB.DELETERESOURCEMETADATA ( abspath IN VARCHAR2, metadata IN REF SYS.XMLTYPE, delete_option IN pls_integer := dbms_xdb.DELETE_RESOURCE_METADATA_CASCADE);
次の構文は、スキーマ・ベースまたは非スキーマ・ベースのメタデータに使用できます。
DBMS_XDB.DELETERESOURCEMETADATA ( abspath IN VARCHAR2, metadatans IN VARCHAR2, metadataname IN VARCHAR2, delete_option IN pls_integer := dbms_xdb.DELETE_RESOURCE_METADATA_CASCADE);
パラメータ
表186-23 DELETERESOURCEMETADATAプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
|
削除する(スキーマ・ベースの)メタデータの一部への |
|
削除するメタデータの断片のネームスペース。 |
|
削除するメタデータの断片のローカル名。 |
|
スキーマ・ベースのメタデータにのみ適用できます。このパラメータは次のいずれかになります。
|
186.5.23 DELETESCHEMALOCMAPPINGプロシージャ
この推奨されないプロシージャは、指定したスキーマURLのスキーマ位置マッピングをXDB構成から削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETESCHEMALOCMAPPINGプロシージャ)を使用してください。
構文
DBMS_XDB.DELETESCHEMALOCMAPPING( schemaURL IN VARCHAR2);
パラメータ
表186-24 DELETESCHEMALOCMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
スキーマURL |
186.5.24 DELETESERVLETプロシージャ
この推奨されないプロシージャは、XDB構成からサーブレットを削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETESERVLETプロシージャ)を使用してください。
構文
DBMS_XDB.DELETESERVLET( name IN VARCHAR2);
パラメータ
表186-25 DELETESERVLETプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名 |
186.5.25 DELETESERVLETMAPPINGプロシージャ
この推奨されないプロシージャは、指定したサーブレット名のサーブレット・マッピングをXDB構成から削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETESERVLETMAPPINGプロシージャ)を使用してください。
構文
DBMS_XDB.DELETESERVLETMAPPING( name IN VARCHAR2);
パラメータ
表186-26 DELETESERVLETMAPPINGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名 |
186.5.26 DELETESERVLETSECROLEプロシージャ
この推奨されないプロシージャは、XDB構成内のサーブレットから指定したロールを削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETESERVLETSECROLEプロシージャ)を使用してください。
構文
DBMS_XDB.DELETESERVLETSECROLE( servname IN VARCHAR2, rolename IN VARCHAR2);
パラメータ
表186-27 DELETESERVLETSECROLEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名 |
|
削除するロールの名前。 |
186.5.27 DELETEXMLEXTENSIONプロシージャ
この推奨されないプロシージャは、指定したXML拡張子をXDB構成から削除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(DELETEXMLEXTENSIONプロシージャ)を使用してください。
構文
DBMS_XDB.DELETEXMLEXTENSION( extension IN VARCHAR2);
パラメータ
表186-28 DELETEXMLEXTENSIONプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
削除するXML拡張子。 |
186.5.28 ENABLEDIGESTAUTHENTICATIONプロシージャ
この推奨されないプロシージャはDigest認証を有効にします。DigestがXML DB HTTPサーバーで使用される最初の認証メカニズムとしてリストされます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(ENABLEDIGESTAUTHENTICATIONプロシージャ)を使用してください。
構文
DBMS_XDB.ENABLEDIGESTAUTHENTICATION;
186.5.29 EXISTSRESOURCEファンクション
この推奨されないファンクションは、リソースが階層内にあるかどうかを示します。絶対パスを表す文字列によってリソースを照合します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(EXISTSRESOURCEファンクション)を使用してください。
構文
DBMS_XDB.EXISTSRESOURCE( abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-29 EXISTSRESOURCEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ACLドキュメントが必要なリソースのパス名。 |
戻り値
リソースが見つかった場合はTRUE
。
186.5.30 GETACLDOCUMENTファンクション
この推奨されないファンクションは、パス名を指定して、リソースを保護するACLドキュメントを取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETACLDOCUMENTファンクション)を使用してください。
構文
DBMS_XDB.GETACLDOCUMENT( abspath IN VARCHAR2) RETURN sys.xmltype;
パラメータ
表186-30 GETACLDOCUMENTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ACLドキュメントが必要なリソースのパス名。 |
戻り値
ACLドキュメントのXMLType
。
186.5.31 GETCONTENTBLOBファンクション
この推奨されないファンクションは、BLOB
として戻されたリソースの内容を取り出します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETCONTENTBLOBファンクション)を使用してください。
構文
DBMS_XDB.GETCONTENTBLOB( abspath IN VARCHAR2, csid OUT PLS_INTEGER, locksrc IN BOOLEAN := FALSE) RETURN BLOB;
パラメータ
表186-31 GETCONTENTBLOBファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
|
|
locksrc |
BLOBとしてのリソースの内容。 |
戻り値
BLOBとしてのリソースの内容。
186.5.32 GETCONTENTCLOBファンクション
この推奨されないファンクションは、CLOB
として戻されたリソースの内容を取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETCONTENTCLOBファンクション)を使用してください。
構文
DBMS_XDB.GETCONTENTCLOB( abspath IN VARCHAR2, RETURN CLOB;
パラメータ
表186-32 GETCONTENTCLOBファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
CLOBとしてのリソースの内容。
186.5.33 GETCONTENTVARCHAR2ファンクション
この推奨されないファンクションは、文字列として戻されたリソースの内容を取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETCONTENTVARCHAR2ファンクション)を使用してください。
構文
DBMS_XDB.GETCONTENTVARCHAR2( abspath IN VARCHAR2, RETURN BLOB;
パラメータ
表186-33 GETCONTENTVARCHAR2ファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
文字列としてのリソースの内容。
186.5.34 GETCONTENTXMLREFファンクション
この推奨されないファンクションは、XMLTYPE
へのREF
として戻されたリソースの内容を取り出します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETCONTENTXMLREFファンクション)を使用してください。
構文
DBMS_XDB.GETCONTENTXMLREF( abspath IN VARCHAR2, RETURN SYS.XMLTYPE;
パラメータ
表186-34 GETCONTENTXMLREFファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
XMLTYPE
へのREF
としてのリソースの内容。
186.5.35 GETCONTENTXMLTYPEファンクション
この推奨されないファンクションは、XMLTYPE
として戻されたリソースの内容を取り出します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETCONTENTXMLTYPEファンクション)を使用してください。
構文
DBMS_XDB.GETCONTENTXMLTYPE( abspath IN VARCHAR2, RETURN SYS.XMLTYPE;
パラメータ
表186-35 GETCONTENTXMLTYPEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
XMLTYPEとしてのリソースの内容。
186.5.36 GETFTPPORTファンクション
この推奨されないプロシージャは、現在のFTPポートの値を取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(GETFTPPORTファンクション)を使用してください。
構文
DBMS_XDB.GETFTPPORT RETURN NUMBER;
186.5.37 GETHTTPPORTファンクション
このプロシージャは、現在のHTTPポートの値を取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(GETHTTPPORTファンクション)を使用してください。
構文
DBMS_XDB.GETHTTPPORT RETURN NUMBER;
186.5.38 GETHTTPREQUESTHEADERファンクション
この推奨されないファンクションは、XDBによるHTTPリクエストの処理中にコールされた場合、渡されたヘッダーの値を戻します。これは、カスタム認証を実装するルーチンによって使用されます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。
構文
DBMS_XDB.GETHTTPREQUESTHEADER( header_name IN VARCHAR2) RETURN VARCHAR2;
パラメータ
表186-36 GETHTTPREQUESTHEADERファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
渡されたヘッダー |
戻り値
ヘッダーがリクエストに含まれていない場合、またはセキュリティ上の理由でAUTHENTICATION
を実行する場合は、NULL
を戻します。
186.5.39 GETLISTENERENDPOINTプロシージャ
この推奨されないプロシージャは、XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを取得します。このプロシージャでは、HTTPとHTTP2の両方のエンド・ポイントのパラメータを取得できます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(GETLISTENERENDPOINTプロシージャ)を使用してください。
構文
DBMS_XDB.GETLISTENERENDPOINT ( endpoint IN NUMBER, host OUT VARCHAR2, port OUT NUMBER, protocol OUT NUMBER);
パラメータ
表186-37 GETLISTENERENDPOINTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
取得するエンド・ポイント。この値は、 |
|
リスナーのエンド・ポイントがリスニングするインタフェース。 |
|
リスナーのエンド・ポイントがリスニングするポート。 |
|
リスナーのエンド・ポイントによって受け入れられた転送プロトコル。 |
186.5.40 GETLOCKTOKENプロシージャ
この推奨されないファンクションは、リソースへのパスを指定されると、リソースへのパスを指定して、現行ユーザーのリソースのロック・トークンを戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETLOCKTOKENプロシージャ)を使用してください。
構文
DBMS_XDB.GETLOCKTOKEN( path IN VARCHAR2, locktoken OUT VARCHAR2);
パラメータ
表186-38 GETLOCKTOKENプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースへのパス名。 |
|
ログインしたユーザーのリソースに対するロック・トークン。 |
使用上のノート
ユーザーには、リソースに対するREADPROPERTIES
権限が必要です。
186.5.41 GETPRIVILEGESファンクション
この推奨されないファンクションは、指定したリソースに対して現行ユーザーに付与されている権限をすべて取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETPRIVILEGESファンクション)を使用してください。
構文
DBMS_XDB.GETPRIVILEGES( res_path IN VARCHAR2) RETURN sys.xmltype;
パラメータ
表186-39 GETPRIVILEGESファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの階層内の絶対パス。 |
戻り値
<privilege>
要素のXMLType
インスタンス。これには、このリソースに対して現行のユーザーに付与されたすべてのリーフ権限のリストが含まれています。
186.5.42 GETRESOIDファンクション
この推奨されないプロシージャは、リソースの絶対パスからオブジェクトIDを戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETRESOIDファンクション)を使用してください。
構文
DBMS_XDB.GETRESOID( abspath IN VARCHAR2) RETURN RAW;
パラメータ
表186-40 GETRESOIDファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースが存在しない場合はNULL
。
186.5.43 GETXDB_TABLESPACEファンクション
この推奨されないファンクションは、XDB (ユーザー)の現行の表領域を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(GETXDB_TABLESPACEファンクション)を使用してください。
構文
DBMS_XDB.GETXDB_TABLESPACE RETURN VARCHAR2;
186.5.44 HASBLOBCONTENTファンクション
この推奨されないファンクションは、リソースにBLOBコンテンツがある場合はTRUE
を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(HASBLOBCONTENTファンクション)を使用してください。
構文
DBMS_XDB.HASBLOBCONTENT abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-41 HASBLOBCONTENTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースにBOBコンテンツがある場合はTRUE
。
186.5.45 HASCHARCONTENTファンクション
この推奨されないファンクションは、リソースに文字コンテンツがある場合はTRUE
を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(HASCHARCONTENTファンクション)を使用してください。
構文
DBMS_XDB.HASCHARCONTENT abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-42 HASCHARCONTENTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースに文字コンテンツがある場合はTRUE
。
186.5.46 HASXMLCONTENTファンクション
この推奨されないファンクションは、リソースにXMLコンテンツがある場合はTRUE
を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(HASXMLCONTENTファンクション)を使用してください。
構文
DBMS_XDB.HASXMLCONTENT abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-43 HASXMLCONTENTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースにXMLコンテンツがある場合はTRUE
。
186.5.47 HASXMLREFERENCEファンクション
この推奨されないファンクションは、リソースにXMLコンテンツに対するREF
がある場合はTRUE
を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(HASXMLREFERENCEファンクション)を使用してください。
構文
DBMS_XDB.HASXMLREFERENCE abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-44 HASXMLREFERENCEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースにXMLコンテンツへのREF
がある場合はTRUE
。
186.5.48 ISFOLDERファンクション
この推奨されないファンクションは、リソースがフォルダまたはコンテナの場合はTRUE
を戻します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(ISFOLDERファンクション)を使用してください。
構文
DBMS_XDB.ISFOLDER abspath IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-45 DBMS_XDB.ISFOLDERファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
戻り値
リソースがフォルダまたはコンテナの場合はTRUE
。
186.5.49 LINKプロシージャ
この推奨されないプロシージャは、指定したフォルダから指定したリソースへのリンクを作成します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(LINKプロシージャ)を使用してください。
構文
DBMS_XDB.LINK( srcpath IN VARCHAR2, linkfolder IN VARCHAR2, linkname IN VARCHAR2);
DBMS_XDB.LINK( srcpath IN VARCHAR2, linkfolder IN VARCHAR2, linkname IN VARCHAR2, linktype IN PLS_INTEGER := DBMS_XDB.LINK_TYPE_HARD);
パラメータ
表186-46 LINKプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リンクを作成するリソースのパス名。 |
|
新規リンクを格納するフォルダ。 |
|
新規リンクの名前。 |
|
作成するリンクのタイプ。
|
186.5.50 LOCKRESOURCEファンクション
この推奨されないファンクションは、リソースへのパスを指定されると、リソースに対するWebDAVスタイルのロックを取得します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(LOCKRESOURCEファンクション)を使用してください。
構文
DBMS_XDB.LOCKRESOURCE( path IN VARCHAR2, depthzero IN BOOLEAN, shared IN boolean) RETURN BOOLEAN;
パラメータ
表186-47 LOCKRESOURCEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ロックするリソースのパス名。 |
|
現在サポートされていません。 |
|
|
戻り値
成功した場合はTRUE
。
使用上のノート
ユーザーには、リソースに対するUPDATE
権限が必要です。
186.5.51 PROCESSLINKSプロシージャ
この推奨されないプロシージャは、指定したリソース内のドキュメント・リンクを処理します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(PROCESSLINKSプロシージャ)を使用してください。
構文
DBMS_XDB.PURGERESOURCEMETADATA( abspath IN VARCHAR2, recurse IN BOOLEAN := FALSE);
パラメータ
表186-48 PROCESSLINKSプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。パスがフォルダの場合は、 |
|
|
186.5.52 PURGERESOURCEMETADATAプロシージャ
この推奨されないプロシージャは、リソースからすべてのユーザー・メタデータを削除します。スキーマ・ベースのメタデータはカスケード・モードで削除され、対応するメタデータ表から行が削除されます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(PURGERESOURCEMETADATAプロシージャ)を使用してください。
構文
DBMS_XDB.PURGERESOURCEMETADATA( abspath IN VARCHAR2);
パラメータ
表186-49 PURGERESOURCEMETADATAプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
186.5.53 RENAMERESOURCEプロシージャ
この推奨されないプロシージャは、XDBリソースの名前を変更します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(RENAMERESOURCEプロシージャ)を使用してください。
構文
DBMS_XDB.RENAMERESOURCE( srcpath IN VARCHAR2, destfolder IN CARCHAR2, newname IN VARCHAR2);
パラメータ
表186-50 RENAMERESOURCEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ソース・リソース宛先フォルダの階層内の絶対パス。 |
|
宛先フォルダの階層内の絶対パス。 |
|
宛先フォルダ内の子の名前。 |
186.5.54 SETACLプロシージャ
この推奨されないプロシージャは、指定のリソースに対するACLを、パスで指定したACLに設定します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(SETACLプロシージャ)を使用してください。
構文
DBMS_XDB.SETACL( res_path IN VARCHAR2, acl_path IN VARCHAR2);
パラメータ
表186-51 SETACLプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの階層内の絶対パス。 |
|
ACLの階層内の絶対パス。 |
使用上のノート
ユーザーには、リソースに対する<write-acl>
権限が必要です。
186.5.55 SETFTPPORTプロシージャ
この推奨されないプロシージャは、FTPポートを新しい値に設定します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(SETFTPPORTプロシージャ)を使用してください。
構文
DBMS_XDB.SETFTPPORT( new_port IN NUMBER);
パラメータ
表186-52 SETFTPPORTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
FTPポートが設定される値。 |
186.5.56 SETHTTPPORTプロシージャ
この推奨されないプロシージャは、HTTPポートを新しい値に設定します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(SETHTTPPORTプロシージャ)を使用してください。
構文
DBMS_XDB.SETHTTPPORT( new_port IN NUMBER);
パラメータ
表186-53 SETHTTPPORTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
HTTPポートが設定される値。 |
186.5.57 SETLISTENERENDPOINTプロシージャ
この推奨されないプロシージャは、XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを設定します。このプロシージャでは、HTTPとHTTP2の両方のエンド・ポイントを設定できます。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(SETLISTENERENDPOINTプロシージャ)を使用してください。
構文
DBMS_XDB.SETLISTENERENDPOINT ( endpoint IN NUMBER, host IN VARCHAR2, port IN NUMBER, protocol IN NUMBER);
パラメータ
表186-54 SETLISTENERENDPOINTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
設定するエンド・ポイント。この値は、 |
|
リスナーのエンド・ポイントがリスニングするインタフェース。この値は、' |
|
リスナーのエンド・ポイントがリスニングするポート。 |
|
リスナーのエンド・ポイントが受け入れる転送プロトコル。この値は、 |
186.5.58 SETLISTENERLOCALACCESSプロシージャ
この推奨されないプロシージャは、XML DB HTTPサーバーのすべてのリスナーのエンド・ポイントを、ローカルホスト・インタフェースでのみリスニングするか(l_access
の設定がTRUE
の場合)、またはローカルホスト・インタフェースと非ローカルホスト・インタフェースの両方でリスニングするか(l_access
の設定がFALSE
の場合)のどちらかに制限します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_CONFIG パッケージの同じ名前のサブプログラム(SETLISTENERLOCALACCESSプロシージャ)を使用してください。
構文
DBMS_XDB.SETLISTENERLOCALACCESS ( l_access BOOLEAN);
パラメータ
表186-55 SETLISTENERLOCALACCESSプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
|
186.5.59 SPLITPATHプロシージャ
この推奨されないプロシージャは、パスを親のパスと子のパスに分割します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(SPLITPATHプロシージャ)を使用してください。
構文
DBMS_XDB.SPLITPATH( abspath IN VARCHAR2, parentpath OUT VARCHAR2, childpath OUT VARCHAR2);
パラメータ
表186-56 SPLITPATHプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
分割する絶対パス。 |
|
親のパス。 |
|
子のパス。 |
186.5.60 TOUCHRESOURCEプロシージャ
この推奨されないプロシージャは、リソースの変更時間を現在の時間に変更します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(TOUCHRESOURCEプロシージャ)を使用してください。
構文
DBMS_XDB.TOUCHRESOURCE abspath IN VARCHAR2);
パラメータ
表186-57 DBMS_XDB.TOUCHRESOURCEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
186.5.61 UNLOCKRESOURCEファンクション
この推奨されないファンクションは、ロック・トークンとリソースへのパスを指定して、リソースのロックを解除します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(UNLOCKRESOURCEファンクション)を使用してください。
構文
DBMS_XDB.UNLOCKRESOURCE( path IN VARCHAR2, deltoken IN VARCHAR2) RETURN BOOLEAN;
パラメータ
表186-58 UNLOCKRESOURCEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
リソースへのパス名。 |
|
削除するロック・トークン。 |
戻り値
操作が成功した場合はTRUE
。
使用上のノート
ユーザーには、リソースに対するUPDATE
権限が必要です。
186.5.62 UPDATERESOURCEMETADATAプロシージャ
この推奨されないプロシージャは、リソースのメタデータを更新します。
ノート:
リリース12cでは、このプロシージャの使用は推奨されていません。この機能のかわりに、 DBMS_XDB_REPOS パッケージの同じ名前のサブプログラム(UPDATERESOURCEMETADATAプロシージャ)を使用してください。
このプロシージャは、絶対パスで識別されるリソースおよび、そのREF
で識別されて置き換えられる、そのリソース内のメタデータを使用します。メタデータの一部をユーザー定義のメタデータ(XMLTYPE
へのREF
またはXMLTYPE
のいずれかの形式)に置き換えます。
構文
次の構文は、スキーマ・ベースのメタデータの更新にのみ使用できます。新しいメタデータは、スキーマ・ベースである必要があります。
DBMS_XDB.UPDATERESOURCEMETADATA( abspath IN VARCHAR2, oldmetadata IN REF SYS.XMLTYPE, newmetadata IN REF SYS.XMLTYPE)
次の構文は、スキーマ・ベースのメタデータの更新にのみ使用できます。新しいメタデータは、スキーマ・ベースまたは非スキーマ・ベースである必要があります。
DBMS_XDB.UPDATERESOURCEMETADATA( abspath IN VARCHAR2, oldmetadata IN REF SYS.XMLTYPE, newmetadata IN XMLTYPE);
次の構文は、スキーマ・ベースおよび非スキーマ・ベースの両方のメタデータに使用できます。
DBMS_XDB.UPDATERESOURCEMETADATA( abspath IN VARCHAR2, oldns IN VARCHAR2, oldname IN VARCHAR, newmetadata IN XMLTYPE);
次の構文は、スキーマ・ベースおよび非スキーマ・ベースの両方のメタデータに使用できます。新しいメタデータは、スキーマ・ベースである必要があります。
DBMS_XDB.UPDATERESOURCEMETADATA( abspath IN VARCHAR2, oldns IN VARCHAR2, oldname IN VARCHAR, newmetadata IN REF SYS.XMLTYPE);
パラメータ
表186-59 UPDATERESOURCEMETADATAプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
リソースの絶対パス。 |
|
古いメタデータへの |
|
新しい置換メタデータへの |
|
古いメタデータを識別するネームスペース。 |
|
古いメタデータを識別するローカル名。 |
使用上のノート
REF
の場合、このプロシージャは、REF
をリソースに、メタデータは別の表に格納します。REF
の一意性が維持されます。XMLTYPE
が渡された場合、データを解析してスキーマ・ベースかどうかを判断し、その結果に応じてデータを格納します。