157 DBMS_XMLINDEX

DBMS_XMLINDEXパッケージでは、非同期の索引付けを実装するインタフェースが提供されています。

DBMS_XMLINDEXの使用方法

概要

概要

非同期索引のメンテナンス

基本のXMLIndexは、すべてのDML操作でメンテナンスされます。ただし、計算のコストを考慮すると、多くの場合、失効した結果には十分な可用性があります。そのような場合、データベースのロードが少ないときなど、適切なときまで索引の更新を延期することが得策です。このようにして、非同期索引メンテナンスのメカニズムが提供されています。

DBMS_XMLINDEXサブプログラムの要約

次の表に、このパッケージのすべてのサブプログラムをアルファベット順に示します。

表157-1 DBMS_XMLINDEXパッケージのサブプログラム

サブプログラム	説明
CREATEDATEINDEXプロシージャ	`XMLIndex`の記憶表である`PATH` `TABLE`の`VALUE`列に、日付値の2次索引を作成します。
CREATENUMBERINDEXプロシージャ	`XMLIndex`の記憶表である`PATH` `TABLE`の`VALUE`列に、数値の2次索引を作成します。
SYNCINDEXプロシージャ	索引を手動で同期化します。

CREATEDATEINDEXプロシージャ

このプロシージャは、XMLIndexの記憶表であるPATH TABLEのVALUE列に、日付値の2次索引を作成します。プロシージャの2番目の形式を使用すると、date_index_clauseを空の文字列に設定できます。

構文

DBMS_XMLINDEX.CREATEDATEINDEX  (
   xml_index_schema   IN   VARCHAR2,
   xml_index_name     IN   VARCHAR2,
   date_index_name    IN   VARCHAR2,
   xmltypename        IN   VARCHAR2,
   date_index_clause  IN   VARCHAR2);

DBMS_XMLINDEX.CREATEDATEINDEX  (
   xml_index_schema   IN   VARCHAR2
   xml_index_name     IN   VARCHAR2,
   date_index_name    IN   VARCHAR2,
   xmltypename        IN   VARCHAR2);

パラメータ

表157-2 CREATEDATEINDEXプロシージャのパラメータ

パラメータ	説明
`xml_index_schema`	`XMLIndex`の所有者の名前。
`xml_index_name`	`XMLIndex`の名前。
`date_index_name`	`xml_index_schema`が所有する`xml_index_name`という名前の`XMLIndex`の`PATH` `TABLE`の`VALUE`列に、日付値に対して作成される2次索引の名前。
`xmltypename`	パス表の`VALUE`列内の値が変換される型。指定可能な値は次の文字列です。`DATETIME`、`TIME`、`DATE`、`GDAY`、`GMONTH`、`GYEAR`、`GYEARMONTH`、`GMONTHDAY`
`date_index_clause`	作成時に日付索引に適用するSTORAGE句。日付索引を作成するために`CREATE` `INDEX`文に追加される文字列引数です。

CREATENUMBERINDEXプロシージャ

このプロシージャは、XMLIndexの記憶表であるPATH TABLEのVALUE列に、数値の2次索引を作成します。

構文

DBMS_XMLINDEX.CREATENUMBERINDEX (
   xml_index_schema   IN   VARCHAR2,
   xml_index_name     IN   VARCHAR2,
   num_index_name     IN   VARCHAR2,
   num_index_clause   IN   VARCHAR2,
   xmltypename        IN   VARCHAR2);

パラメータ

表157-3 CREATENUMBERINDEXプロシージャのパラメータ

パラメータ	説明
`xml_index_schema`	`XMLIndex`の所有者の名前。
`xml_index_name`	`XMLIndex`の名前。
`num_index_name`	`xml_index_schema`が所有する`xml_index_name`という名前の`XMLIndex`の`PATH` `TABLE`の`VALUE`列に、数値に対して作成される2次索引の名前。
`num_index_clause`	作成時に数値索引に適用するSTORAGE句。数値索引を作成するために`CREATE` `INDEX`文に追加される文字列引数です。
`xmltypename`	パス表の`VALUE`列内の値が変換される型。指定可能な値は次の文字列です。`FLOAT`、`DOUBLE`、`DECIMAL`、`INTEGER`、`NONPOSITIVEINTEGER`、`NEGATIVEINTEGER`、`LONG`、`INT`、`SHORT`、`BYTE`、`NONNEGATIVEINTEGER`、`UNSIGNEDLONG`、`UNSIGNEDINT`、`UNSIGNEDSHORT`、`UNSIGNEDBYTE`、`POSITIVEINTEGER`

SYNCINDEXプロシージャ

このプロシージャは、非同期にメンテナンスされたXMLIndexを同期化します。このプロシージャは、保留中の表に記録されるXMLIndex変更に適用され、ベースXMLTYPE列を含むパス表を最新にします。

構文

DBMS_XMLINDEX.SYNCINDEX (
   xml_index_schema      IN VARCHAR2,
   xml_index_name        IN VARCHAR2);

パラメータ

表157-4 SYNCINDEXプロシージャのパラメータ

パラメータ	説明
`xml_index_schema`	XMLIndexの所有者の名前。
`xml_schema_name`	XMLIndexの名前。

例

EXEC DBMS_XMLINDEX.SYNCINDEX('USER1', 'SS_TAB_XMLI');