DBMS_XDB_CONFIG
パッケージは、Oracle XML DBとそのリポジトリを構成するインタフェースを提供します。
関連項目: 『Oracle XML DB開発者ガイド』 |
この章では、次の項目について説明します。
概要
セキュリティ・モデル
定数
PL/SQLパッケージDBMS_XDB_CONFIG
は、DBAがシステムを構成するためのPL/SQL向けOracle XML DBリソースのアプリケーション・プログラム・インタフェース(API)です。このAPIは、PL/SQLを使用して、Oracle XML DBリポジトリ・リソースにアクセスして管理するためのファンクションとプロシージャを提供します。また、リソースのセキュリティおよびOracle XML DBの構成の管理方法も説明します。
Oracle XML DBリポジトリはXMLでモデル化されており、すべてのデータに対するデータベース・ファイル・システムを提供します。リポジトリは、XMLTypeのデータベース・オブジェクトにパス名(またはURL)をマップし、これらのオブジェクトの管理機能を提供します。
PL/SQLパッケージDBMS_XDB_CONFIGは、次のすべての管理に使用できるAPIです。
Oracle XML DBリソース
Oracle XML DBセキュリティは、アクセス制御リスト(ACL)に基づいています。ACLは、どのリソースへのアクセス権をどのプリンシパル(ユーザーまたはロール)が持つかを決定するアクセス制御エントリ(ACE)のリストです。
Oracle XML DBの構成
DBMS_XDB_CONFIG
パッケージは、XDB
が所有しているため、SYS
またはXDB
で作成される必要があります。EXECUTE
権限は、PUBLIC
に付与されます。このパッケージ内のサブプログラムは、現行のユーザーの権限を使用して実行されます。
表183-2 DBMS_XDB_CONFIGパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
有効期限に対するURLパターンのマッピングを |
|
XDB構成にMIMEマッピングを追加します。 |
|
XDB構成にスキーマ位置マッピングを追加します。 |
|
XDB構成にサーブレットを追加します。 |
|
XDB構成にサーブレット・マッピングを追加します。 |
|
XDB構成内の指定したサーブレットにセキュリティ・ロール |
|
次のXML拡張子を |
|
セッションの構成情報を |
|
セッションの最新の構成情報をデータベースに反映します。 |
|
構成情報を更新し、変更をコミットします。 |
|
有効期限に対するURLパターンのすべてのマッピングを |
|
指定した拡張子のMIMEマッピングをXDB構成から削除します。 |
|
指定したスキーマURLのスキーマ位置マッピングをXDB構成から削除します。 |
|
サーブレットをXDB構成から削除します。 |
|
指定したサーブレット名のサーブレット・マッピングをXDB構成から削除します。 |
|
XDB構成内のサーブレットから指定したロールを削除します。 |
|
指定したXML拡張子をXDB構成から削除します。 |
ENABLEDIGESTAUTHENTICATIONプロシージャ |
Digest認証を有効にします。 |
|
現在のFTPポートの値を取得します。 |
|
現在のHTTPポートの値を取得します。 |
|
レルム名を取得します。 |
|
現在のHTTPSポートの値を取得します。 |
|
XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを取得します。 |
|
FTPポートを新しい値に設定します。 |
|
HTTPポートに新しい値を設定します。 |
|
レルムに新しい値を設定します。 |
|
HTTPSポートに新しい値を設定します。 |
|
XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを設定します。 |
|
XML DB HTTPサーバーのすべてのリスナーのエンド・ポイントを、ローカルホスト・インタフェースでのみリスニングするか( |
|
同じ統合データベース内の他のプラガブル・データベースで使用されるポート番号を取得します。 |
このプロシージャは、有効期限に対するURLパターンのマッピングをXDB$CONFIG
に追加します。これによって、パターンに一致するURLのExpireヘッダーを制御します。
このプロシージャは、XDB構成に次のMIMEマッピングを追加します。
<mime-mapping> <extension>extension</extension> <mime-type>mimetype</mime-type> </mime-mapping>
このプロシージャは、XDB構成に次のスキーマ位置マッピングを追加します。
<schemaLocation-mapping> <namespace>namespace</namespace> <element>element</element> <schemaURL>schemaURL</schemaURL> </schemaLocation-mapping>
このプロシージャは、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_CONFIG.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);
パラメータ
表183-6 ADDSERVLETプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
サーブレット名。 |
|
C、Java、PL/SQLのいずれかを指定する必要があります。 |
|
表示名。 |
|
アイコン。 |
|
説明 |
|
このサーブレットに対応する |
|
このサーブレットに対応する |
|
このサーブレットに対応する |
|
スキーマ |
このプロシージャは、XDB構成に次のサーブレット・マッピングを追加します。
<servlet-mapping> <servlet-pattern>pattern</servlet-pattern> <servlet-name>name</servlet-name></servlet-mapping>
このプロシージャは、XDB構成内の指定したサーブレットに次のセキュリティ・ロールREF
を追加します。
<security-role-ref> <role-name>rolename</role-name> <role-link>rolelink</role-link> <description>descript</description> </security-role-ref>
このプロシージャは、<xml-extensions>
で、XDB構成に次のXML拡張子を追加します。
<extension>extension</extension>
このプロシージャは、Digest認証を有効にします。DigestがXML DB HTTPサーバーで使用される最初の認証メカニズムとしてリストされます。
このプロシージャは、XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを取得します。このプロシージャでは、HTTPとHTTP2の両方のエンド・ポイントのパラメータを取得できます。
このプロシージャは、XML DB HTTPサーバーに対応するリスナーのエンド・ポイントのパラメータを設定します。このプロシージャでは、HTTPとHTTP2の両方のエンド・ポイントを設定できます。
構文
DBMS_XDB_CONFIG.SETLISTENERENDPOINT ( endpoint IN NUMBER, host IN VARCHAR2, port IN NUMBER, protocol IN NUMBER);
パラメータ
表183-23 SETLISTENERENDPOINTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
設定するエンド・ポイント。この値は、 |
|
リスナーのエンド・ポイントがリスニングするインタフェース。この値は、' |
|
リスナーのエンド・ポイントがリスニングするポート。 |
|
リスナーのエンド・ポイントが受け入れる転送プロトコル。この値は、 |