注：

如果你的专栏， BFILE索引所有者必须有读取权限上使用的BFILEs的所有目录.

DIRECT_DATASTORE CLOB 示例

下面的示例创建一个表，用来存储文本数据的 CLOB 列。然后填充两行文本数据索引所使用的系统定义的偏好CTXSYS.DEFAULT_DATASTORE.

create table mytable(id number primary key, docs clob); 

insert into mytable values(111555,'this text will be indexed');

insert into mytable values(111556,'this is a direct_datastore example');

commit;

create index myindex on mytable(docs)

  indextype is ctxsys.context

  parameters ('DATASTORE CTXSYS.DEFAULT_DATASTORE');

表 2-2 MULTI_COLUMN_DATASTORE 属性

索引和 DML

要索引，必须创建要在CREATE INDEX语句中指定的虚拟列。除非在列属性指定它的名称，此列内容不是虚拟文档的一部分。

该指数被同步仅当更新虚拟列。您可以创建触发器传播更改，如果需要的话。

MULTI_COLUMN_DATASTORE 示例

下面的示例创建称为 my_multi与三个文本列多列数据存储首选项：

begin

ctx_ddl.create_preference('my_multi', 'MULTI_COLUMN_DATASTORE');

ctx_ddl.set_attribute('my_multi', 'columns', 'column1, column2, column3');

end;

MULTI_COLUMN_DATASTORE 筛选器示例

下面的示例创建多列数据存储首选项，并表示bar列是要筛选与 AUTO_FILTER。

ctx_ddl.create_preference('MY_MULTI','MULTI_COLUMN_DATASTORE');

ctx_ddl.set_attribute('MY_MULTI', 'COLUMNS','foo,bar');

ctx_ddl.set_attribute('MY_MULTI','FILTER','N,Y');

多列数据存储区读取foo和 bar列，筛选器bar的内容然后组成复合文档：

<FOO>

foo contents

</FOO>

<BAR>

bar filtered contents (probably originally HTML)

</BAR>

不需要指定 N，并不需要为每一列的标志。Y 只需要指定，请用逗号来表示它们适用于哪些列。举个例子：

ctx_ddl.create_preference('MY_MULTI','MULTI_COLUMN_DATASTORE');

ctx_ddl.set_attribute('MY_MULTI', 'COLUMNS','foo,bar,zoo,jar');

ctx_ddl.set_attribute('MY_MULTI','FILTER',',,Y');

这个过滤器只列zoo.

标记行为

索引，过程中，系统将创建为每个行的虚拟文档。虚拟文档被由串联的上市顺序自动添加的列名称标签的列中的内容。举个例子：

create table mc(id number primary key, name varchar2(10), address varchar2(80));

insert into mc values(1, 'John Smith', '123 Main Street');

exec ctx_ddl.create_preference('mymds', 'MULTI_COLUMN_DATASTORE');

exec ctx_ddl.set_attibute('mymds', 'columns', 'name, address');

这就产生了以下虚拟文本索引：

<NAME>

John Smith

</NAME>

<ADDRESS>

123 Main Street

</ADDRESS>

该系统索引标记，忽略自己的标记之间的文本。

作为部分的索引列

索引作为部分这些标记，您可以选择创建字段部分与BASIC_SECTION_GROUP.

当你使用表达式或函数时，该标记被由表达式前 30 个字符除非使用了一个列别名。

例如，如果您的表达式是作为如下：

exec ctx_ddl.set_attibute('mymds', 'columns', '4 + 17');

然后它产生以下虚拟文本：

<4 + 17>

21

</4 + 17>

如果您的表达式，如下所示：

exec ctx_ddl.set_attibute('mymds', 'columns', '4 + 17 col1');

然后它产生以下虚拟文本：

<col1>

21

<col1>

标记是以大写形式，除非列名或列别名以小写，而双引号包围。举个例子：

exec ctx_ddl.set_attibute('mymds', 'COLUMNS', 'foo');

产生以下虚拟文本：

<FOO>

content of foo

</FOO>

为小写字母的标记，使用以下方法：

exec ctx_ddl.set_attibute('mymds', 'COLUMNS', 'foo "foo"');

此表达式将生成：

<foo>

content of foo

</foo>

表 2-3 DETAIL_DATASTORE 属性

同步主/详细信息索引

详细信息表的更改不会触发重新索引索引进行同步时。只更改主表触发器中的索引列重新索引同步索引时。

您可以在将更改传播到主表行中的索引的列的详细信息表上创建触发器。

示例主/详细信息表

此示例阐释了主页和详细的表如何彼此相关。

begin

ctx_ddl.create_preference('my_detail_pref', 'DETAIL_DATASTORE');

ctx_ddl.set_attribute('my_detail_pref', 'binary', 'true');

ctx_ddl.set_attribute('my_detail_pref', 'detail_table', 'my_detail');

ctx_ddl.set_attribute('my_detail_pref', 'detail_key', 'article_id');

ctx_ddl.set_attribute('my_detail_pref', 'detail_lineno', 'seq');

ctx_ddl.set_attribute('my_detail_pref', 'detail_text', 'text');

end;

CREATE INDEX myindex on my_master(body) indextype is ctxsys.context

parameters('datastore my_detail_pref');

注：

与某些类型的远程挂载的文件系统， FILE_DATASTORE可能无法工作。

表 2-4 FILE_DATASTORE 属性

路径属性限制

路径属性具有下列局限性：

• 如果您指定一个路径属性，您只能在索引列中使用一个简单的文件名。你不能将路径属性结合路径作为文件名的一部分。如果在多个文件夹或目录中存在这些文件，你必须离开路径属性的设置，并在索引列中包含文件的完整名称，路径。

• 在 Windows 系统上，文件必须位于本地驱动器上。他们不能在远程驱动器上，是否远程驱动器映射为本地驱动器盘符。

FILE_DATASTORE 示例

本示例创建称为COMMON_DIR具有/mydocs路径文件数据存储首选项:

begin

 ctx_ddl.create_preference('COMMON_DIR','FILE_DATASTORE');

 ctx_ddl.set_attribute('COMMON_DIR','PATH','/mydocs');

end;

当您使用填充表mytable时，您只需要插入文件名。路径属性告诉系统哪里看在索引操作期间。

create table mytable(id number primary key, docs varchar2(2000));

insert into mytable values(111555,'first.txt');

insert into mytable values(111556,'second.txt');

commit;

创建索引，如下所示：

create index myindex on mytable(docs)

  indextype is ctxsys.context

  parameters ('datastore COMMON_DIR'); 

URL 语法

您在文本字段中存储的 url 语法是，如下所示 （用方括号表示可选参数）：

[URL:]<access_scheme>://<host_name>[:<port_number>]/[<url_path>]

您指定的access_scheme字符串可以是ftp、 http或文件。举个例子：

http://mymachine.us.oracle.com/home.html

由于这种语法是部分符合 RFC 1738 规范，以下限制适用于 URL 语法：

• 该 URL 必须包含仅可打印的 ASCII 字符。非打印 ASCII 字符和多字节字符必须使用进行转义 %xx表示法，其中xx是特殊字符的十六进制表示形式。

  注：

  在 URL 中的login:password@语法是仅支持 ftp 访问方案。

URL_DATASTORE 属性

URL_DATASTORE具有下列属性：

超时

指定以秒为单位，如连接或读取网络操作在超时并返回到应用程序的超时错误之前等待时间的长度。超时的有效范围是 15 到 3600，默认值为 30。

注：

由于超时处于网络操作水平，总超时可能长于指定超时的时间.

maxthreads

指定可以同时运行的线程的最大数目。Maxthreads的有效范围是 1 到 1024年，默认值为 8。

urlsize

指定最大长度以字节为单位，URL 数据存储区支持的 Url 存储在数据库中。如果 URL 超过最大长度，则返回错误。Urlsize的有效范围是 32 到 65535，默认值为 256。

注：

指定为 maxurls 和urlsize的产品值不能超过 5,000,000。

换句话说，内存缓冲区的最大大小 （maxurls * urlsize) 为该 URL 是大约 5 兆字节。

maxurls

指定内部的缓冲区可保存为 HTML 文档 （行） 从文本表中检索到的行的最大数目。Maxurls的有效范围是 32 到 65535，默认值为 256。

注：

指定为maxurls和urlsize的产品值不能超过 5,000,000。

换句话说，内存缓冲区的最大大小 （maxurls * urlsize) 为该 URL 是大约 5 兆字节。

从不

指定用作安装了 Oracle 文本的计算机的 HTTP 代理 （网关） 的主机的完全限定的名称。您可以选择指定端口号，用冒号的形式hostname:port.

如果这台机器是在需要通过代理服务器访问位于防火墙外部的 Web 文件的身份验证的 intranet，则必须设置此属性。

ftp_proxy

指定用作安装了 Oracle 文本的计算机的 FTP 代理 （网关） 的主机的完全限定名称。您可以选择指定一个端口号，用冒号的形式hostname:port.

如果这台机器是在需要通过代理服务器访问位于防火墙外部的 Web 文件的身份验证的 intranet，必须设置此属性。

no_proxy

在 intranet 中指定的域 （达十六，单独用逗号） 存在于大多数，如果不是全部，机器的字符串。当其中一个域中的主机名称遇到时，没有请求发送到ftp_proxy和从不为指定的计算机。相反，直接由主机标识在 URL 中，处理了该请求。

例如，如果为no_proxy输入字符串us.oracle.com， uk.oracle.com ，则包含这些域中的主机名的机器的任何 URL 请求不会处理由您的代理服务器。

URL_DATASTORE 示例

本示例创建称为URL_PREF的从不，no_proxy 和超时属性设置URL_DATASTORE偏好。对于未设置的属性，则使用缺省值。

begin

 ctx_ddl.create_preference('URL_PREF','URL_DATASTORE');

 ctx_ddl.set_attribute('URL_PREF','HTTP_PROXY','www-proxy.us.oracle.com');

 ctx_ddl.set_attribute('URL_PREF','NO_PROXY','us.oracle.com');

 ctx_ddl.set_attribute('URL_PREF','Timeout','300');

end;

创建表并将值插入到它：

create table urls(id number primary key, docs varchar2(2000));

insert into urls values(111555,'http://context.us.oracle.com');

insert into urls values(111556,'http://www.sun.com');

commit;

若要创建索引，请指定 URL_PREF 作为数据存储区：

create index datastores_text on urls ( docs )

  indextype is ctxsys.context

  parameters ( 'Datastore URL_PREF' );

表 2-6 USER_DATASTORE 属性

约束

以下限制适用于程序:

• 程序可以由任何用户，但用户必须具有正确执行程序的数据库权限

• 程序必须是可执行的索引所有者

• 程序必须不发出像COMMIT的 DDL 或交易控制语句

索引之后编辑程序

如果您更改或编辑存储的过程，在此基础上的索引不会向外通知，您必须手动重新创建此类的索引。因此，如果该存储过程使用的其它列，这些列的值更改，不会重新生成索引的行。仅当索引的列更改时重新编制索引行。

先前

指定程序的第二个参数的数据类型。您可以使用CLOB， BLOB， CLOB_LOC， BLOB_LOC或VARCHAR2.

CLOB 例 USER_DATASTORE

作者、 标题和文本字段分开，如articles表定义如下所示的表，请考虑：

create table articles(

    id       number,

    author   varchar2(80),

    title    varchar2(120),

    text     clob );

作者和标题的字段是要索引的文档文本的一部分。假定用户appowner写道合成一个文件从文本、 作者和标题字段的用户数据存储接口的存储的过程：

create procedure myproc(rid in rowid, tlob in out clob nocopy) is

  begin

      for c1 in (select author, title, text from articles

                  where rowid = rid)

      loop

dbms_lob.writeappend(tlob, length(c1.title), c1.title);

   dbms_lob.writeappend(tlob, length(c1.author), c1.author);

   dbms_lob.writeappend(tlob, length(c1.text), c1.text);

end loop;

    end; 

此过程接受 rowid 和临时的CLOB定位器，并串联成临时CLOB的这篇文章的所有列。For 循环执行只有一次。

用户appowner创建首选项，如下所示：

begin

ctx_ddl.create_preference('myud', 'user_datastore');

ctx_ddl.set_attribute('myud', 'procedure', 'myproc');

ctx_ddl.set_attribute('myud', 'output_type', 'CLOB');

end;

当appowner在articles(text)使用这种偏好上创建索引时，索引操作看到作者和标题文档文本中。

USER_DATASTORE 与 BLOB_LOC 的示例

下面的过程可能会用OUTPUT_TYPE BLOB_LOC:

procedure myds(rid in rowid, dataout in out nocopy blob)

is

  l_dtype varchar2(10);

  l_pk    number;

begin

  select dtype, pk into l_dtype, l_pk from mytable where rowid = rid;

  if (l_dtype = 'MOVIE') then

    select movie_data into dataout from movietab where fk = l_pk;

  elsif (l_dtype = 'SOUND') then

    select sound_data into dataout from soundtab where fk = l_pk;

  end if;

end;

用户appowner创建首选项，如下所示：

begin

ctx_ddl.create_preference('myud', 'user_datastore');

ctx_ddl.set_attribute('myud', 'procedure', 'myproc');

ctx_ddl.set_attribute('myud', 'output_type', 'blob_loc');

end;

表 2-7 NESTED_DATASTORE 属性

NESTED_DATASTORE 示例

本节演示使用索引的文档存储为嵌套表中的行的NESTED_DATASTORE类型的示例。

create type nt_rec as object (

  lno number, -- line number

  ltxt varchar2(80) -- text of line

);

create type nt_tab as table of nt_rec;

create table mytab (

   id number primary key, -- primary key

   dummy char(1), -- dummy column for indexing

   doc nt_tab -- nested table

)

nested table doc store as myntab;

insert into mytab values (1, null, nt_tab());

insert into table(select doc from mytab where id=1) values (1, 'the dog');

insert into table(select doc from mytab where id=1) values (2, 'sat on mat ');

commit;

begin

-- create nested datastore pref

ctx_ddl.create_preference('ntds','nested_datastore'); 

-- nest tab column in main table

ctx_ddl.set_attribute('ntds','nested_column', 'doc'); 

-- nested table type

ctx_ddl.set_attribute('ntds','nested_type', 'scott.nt_tab');

-- lineno column in nested table

ctx_ddl.set_attribute('ntds','nested_lineno','lno');

--text column in nested table

ctx_ddl.set_attribute('ntds','nested_text', 'ltxt');

end;

create index myidx on mytab(dummy) -- index dummy column, not nest table

indextype is ctxsys.context parameters ('datastore ntds');

select * from mytab where contains(dummy, 'dog and mat')>0;

-- returns document 1, since it has dog in line 1 and mat in line 2.

表 2-9 CHARSET_FILTER 属性

请参见：

有关受支持的全球化支持字符集的详细信息oracle 数据库全球化支持指南设置。

UTF 16 大-和小端字节序检测

如果你的字符集是 UTF-16，则可以指定 UTF16AUTO 自动检测大或小字节数据。甲骨文文字这样通过检查文档行的第一次的两个字节。

如果前两个字节是 0xFE，0xFF，文档公认的小端字节序，减去那些两个字节的文档的其余部分通过索引。

如果前两个字节 0xFF，0xFE，文档公认的大端字节序，减去那些两个字节的文档的其余部分通过索引。

如果前两个字节是什么，该文档被假定为大端字节序和整篇文档，包括前两个字节代代相传的索引。

索引混合字符设置列

混合的字符设置的列是一种存储不同字符集的文档。例如，文本表可能以 utf8 表示，将某些文档存储在 WE8ISO8859P1 和其他人。

要索引的表中不同字符集的文档，必须与字符设置列创建你的基表。在本专栏中，可以指定文档字符集在每行的基础上。要编制索引的文档，Oracle 文本转换数据库字符集的文档。

字符集与CHARSET_FILTER的改建工程。当字符集列中为NULL或不承认时，Oracle 文本假定源字符集是charset属性中指定。

create table hdocs (

     id number primary key,

     fmt varchar2(10),

     cset varchar2(20),

     text varchar2(80)

);

begin

cxt_ddl.create.preference('cs_filter', 'CHARSET_FILTER');

ctx_ddl.set_attribute('cs_filter', 'charset', 'UTF8');end

insert into hdocs values(1, 'text', 'WE8ISO8859P1', '/docs/iso.txt');

insert into hdocs values (2, 'text', 'UTF8', '/docs/utf8.txt');

commit;

create index hdocsx on hdocs(text) indextype is ctxsys.context

  parameters ('datastore ctxsys.file_datastore

  filter cs_filter

  format column fmt

  charset column cset');

请参见：

AUTO_FILTER和学会更多关于如何设置您的环境使用此筛选器支持的格式的列表，请参阅附录 B，"Oracle 文本支持文档格式".

注：

AUTO_FILTER替换INSO_FILTER，其中已弃用。虽然已尽一切努力确保最大的向后兼容性之间两个筛选器，以便使用INSO_FILTER应用程序将继续工作而无需修改，可能会出现一些差异。用户因此应该在他们新的程序中使用AUTO_FILTER和在可能的情况下，替换实例的INSO_FILTER，和任何优惠制度或常数，使在旧的应用程序中使用它。

表 2-10 AUTO_FILTER 属性

索引格式文件

若要包含格式化的文件，例如 Microsoft Word 文本栏编制索引，请使用AUTO_FILTER。此筛选器将自动检测文档格式。您可以使用 CTXSYS。AUTO_FILTER的系统定义的偏好在参数子句中，如下所示：

create index hdocsx on hdocs(text) indextype is ctxsys.context

  parameters ('datastore ctxsys.file_datastore

  filter ctxsys.auto_filter');

显式地绕过纯文本或 HTML 混合的格式列中

混合格式列是包含多个文档的格式，如一列包含 Microsoft Word、 PDF、 纯文本和 HTML 文档的文本列。

AUTO_FILTER可以索引列混合格式，自动绕过纯文本、 HTML 和 XML 文档。然而，如果您不想依赖于内置旁路机制，您可以显式您行标记为文本并导致AUTO_FILTER来忽略行并且不处理任何方式中的文档。

基表中的格式列使您能够指定的文本列中所包含的文档的类型。您可以指定以下文件类型：TEXT、BINARY和IGNORE。在索引，期间AUTO_FILTER忽略键入的TEXT，假定字符集列未指定任何文件。（带有TEXT格式列类型的文档和一个与IGNORE类型之间的区别是TEXT文档编制索引，但而 IGNORE文档根本未编制索引，该筛选器将忽略。使用IGNORE忽略文件，例如图像文件或在一种语言，你不想要索引的文档。IGNORE可以使用与任何筛选器类型。

若要设置AUTO_FILTER旁路机制，必须在您的基表创建格式列。

举个例子：

create table hdocs (

     id number primary key,

     fmt varchar2(10),

     text varchar2(80)

);

你假设你索引大多是 Word 文档，指定BINARY格式列筛选 Word 文档中。或者，为了AUTO_FILTER忽略 HTML 文档，请在格式列中指定TEXT。

例如，下面的语句将两个文档添加到文字的表格，将一种格式指派为BINARY和其他TEXT:

insert into hdocs values(1, 'binary', '/docs/myword.doc');

insert in hdocs values (2, 'text', '/docs/index.html');

commit;

若要创建索引，使用CREATEINDEX并在参数字符串中指定的格式列名称：

create index hdocsx on hdocs(text) indextype is ctxsys.context

  parameters ('datastore ctxsys.file_datastore

  filter ctxsys.auto_filter

  format column fmt');

如果您不指定TEXT或BINARY格式列，则使用BINARY。

字符集转换与 AUTO_FILTER

AUTO_FILTER将文档转换为数据库字符集时文件格式列设置为TEXT。在这种情况下， AUTO_FILTER看字符集列来确定文档字符集。

如果字符集列的值不是甲骨文文字字符集名称，该文档被通过没有任何字符集转换。

如果你做指定的字符集列，不指定格式列AUTO_FILTER作品喜欢CHARSET_FILTER，只是在这种情况下有没有日本字符集自动检测。

HTML 文档编制索引

如果您的文档集完全是 HTML，Oracle 建议您在您的筛选器首选项中使用 NULL_FILTER 。

例如，要索引 HTML 文档集，可以如下指定为NULL_FILTER和HTML_SECTION_GROUP的系统定义的首选项：

create index myindex on docs(htmlfile) indextype is ctxsys.context

  parameters('filter ctxsys.null_filter

  section group ctxsys.html_section_group');

表 2-11 MAIL_FILTER 属性

筛选器的行为

此筛选器执行以下操作为每个文档：

• 读取和删除页眉字段

• 解码的消息正文，如果需要，根据内容传输编码字段

• 采取行动取决于内容类型字段值和邮件筛选器配置文件中指定的用户指定的行为。（请参阅"关于邮件筛选器的配置文件"）。可能采取的行动是：

  • 生产输出文本 （INCLUDE） 体内。如果在包括部分在内容类型标头字段遇到没有字符集，则 Oracle 默认为您在特性中指定的值将列设置在基表中。你的名字你填充的字符设置的列在创建索引命令的参数字符串。

  • AUTO_FILTER正文内容 （AUTO_FILTER指令）。

  • 从输出文本 （IGNORE删除正文内容)

• 如果未指定行为的配置文件中的类型，默认值如下：

  • 文本 / *： 产生输出文本的身体

  • 应用程序 / *： AUTO_FILTER正文内容

  • 图像 / *、 音频 / *、 视频 / *、 模型 / *： 忽略

• 将分析多部分邮件，邮件过滤器应用以递归方式对每个部分。每个部分追加到输出。

• 所有文本制作将字符集转换为数据库字符集中，如果需要的话。

关于邮件筛选器配置文件

MAIL_FILTER筛选器使用的邮件筛选器的配置文件，其中包含指令指定一个邮件文档的筛选方式。邮件筛选器的配置文件是一个可编辑的文本文件。在这里可以为每个内容类型来重写默认行为。配置文件还包含 IANA Oracle 全球化支持字符设置的名称映射。

文件的位置必须在ORACLE_HOME/ctx/config。新的系统参数中存储要使用的文件的名称 MAIL_FILTER_CONFIG_FILE。在安装，这是设置为 drmailfl.txt，具有有用的默认值的内容。

Oracle 建议您创建您自己的邮件筛选器配置文件以避免覆盖新的版本或修补程序集的安装。邮件筛选器配置文件应该在数据库字符集设置。

[behavior]

application/zip     IGNORE

application/msword  AUTO_FILTER

model               IGNORE

[charsets]

US-ASCII     US7ASCI

ISO-8859-1   WE8ISO8859P1

Mail_Filter 示例

假设我们有一个具有以下形式，其他带有不同主题行的电子邮件与我们的电子邮件相连的电子邮件：

To:  somebody@someplace

Subject:  mainheader

Content-Type:  multipart/mixed

. . .

Content-Type: text/plain

X-Ref:  some_value

Subject:  subheader 1

. . .

Content-Type:  text/plain

X-Control:  blah blah blah

Subject:  subheader 2

. . .

我们设置INDEX_FIELDS是"主体"，最初， PART_FIELD_STYLE到IGNORE.

CTX_DDL.CREATE_PREFERENCE('my_mail_filt', 'mail_filter');

CTX_DDL_SET_ATTRIBUTE(my_mail_filt', 'INDEX_FILES', 'subject');

CTX_DDL.SET ATTRIBUTE ('my_mail_filt', 'PART_FIELD_STYLE', 'ignore');

现在时创建该索引，将会索引此文件，如下所示：

<SUBJECT>mainheader</SUBJECT>

如果PART_FIELD_STYLE相反设置为TAG，这成为：

<SUBJECT>mainheader</SUBJECT>

<SUBJECT>subheader1</SUBJECT>

<SUBJECT>subheader2</SUBJECT>

如果将PART_FIELD_STYLE设置为FIELD相反，这是的结果：

<SUBJECT>mainheader<SUBJECT>

SUBJECT:subheader1

SUBJECT:subheader2

最后，如果PART_FIELD_STYLE相反设置为TEXT，然后结果是：

<SUBJECT>mainheader</SUBJECT>

subheader1

subheader2

表 2-12 USER_FILTER 属性

用户筛选器示例

下面的示例将用作用户筛选器的 Perl 脚本。此脚本将转换为大写的第一个参数中指定的输入的文字文件，并将输出写入到第二个参数中指定的位置：

#!/usr/local/bin/perl

open(IN, $ARGV[0]);

open(OUT, ">".$ARGV[1]);

while (<IN>)

{

  tr/a-z/A-Z/;

  print OUT;

}

close (IN);

close (OUT);

假设这个文件命名为upcase.pl，请创建筛选器首选项如下：

begin

  ctx_ddl.create_preference

    (

      preference_name => 'USER_FILTER_PREF',

      object_name     => 'USER_FILTER'

    );

  ctx_ddl.set_attribute

    ('USER_FILTER_PREF','COMMAND','upcase.pl');

end; 

在 SQL 中创建索引 * 加上，如下所示：

create index user_filter_idx on user_filter ( docs )

  indextype is ctxsys.context

  parameters ('FILTER USER_FILTER_PREF');

表 2-13 PROCEDURE_FILTER 属性

参数顺序

ROWID_PARAMETER、 FORMAT_PARAMETER、 CHARSET_PARAMETER是完全独立的。该命令是 rowid，格式，然后字符集，但筛选过程传递只有所需的最小参数。

例如，假定INPUT_TYPE是BLOB ， OUTPUT_TYPE是CLOB。如果您筛选过程需要所有的参数，必须为程序签名：

(id IN ROWID, format IN VARCHAR2, charset IN VARCHAR2, input IN BLOB, output IN

OUT NOCOPY CLOB)

如果您的程序需要只有ROWID，然后程序签名必须是：

(id IN ROWID,input IN BLOB, ouput IN OUT NOCOPY CLOB)

程序筛选器执行要求

若要创建使用PROCEDURE_FILTER偏好指数，索引所有者必须有执行权限的程序。

错误处理

筛选过程可以提高通过正常的 PL/SQL raise_application_error 设施所需的任何错误。这些错误传播到CTX_USER_INDEX_ERRORS视图或报告给用户，具体取决于如何调用筛选器。

程序筛选器首选项示例

考虑筛选过程CTXSYS.NORMALIZE您定义具有下列签名：

PROCEDURE NORMALIZE(id IN ROWID, charset IN VARCHAR2, input IN CLOB,

output IN OUT NOCOPY VARCHAR2);

若要使用此过程为您的筛选器，设置您的筛选器首选项，如下所示：

begin

ctx_ddl.create_preference('myfilt', 'procedure_filter');

ctx_ddl.set_attribute('myfilt', 'procedure', 'normalize');

ctx_ddl.set_attribute('myfilt', 'input_type', 'clob');

ctx_ddl.set_attribute('myfilt', 'output_type', 'varchar2');

ctx_ddl.set_attribute('myfilt', 'rowid_parameter', 'TRUE');

ctx_ddl.set_attribute('myfilt', 'charset_parameter', 'TRUE');

end;

注：

在查询时查询术语也执行词法分析器并对标记索引 （例如，删除字符和基地字母转换） 之前的任何处理。这将确保查询条件相匹配的文本索引中的标记形式。

表 2-15 BASIC_LEXER 属性

阻止用户词典

Oracle 文本附带产生用于ENGLISH和DERIVATIONAL所产生的字典 （$ORACLE_HOME/ctx/data/enlx/dren.dct） 的系统。您可以创建您自己的语言，以自定义如何分解单词的用户词典。这些字典是表 2-16所示.

词干的用户词典比那些表 2-16中列出的语言不受支持.

用户词典的格式如下所示：

input term <tab> output term

分解单词的个别部分必须用 # 字符分隔。以下的示例条目是为德语单词火车总站:

Hauptbahnhof<tab>Haupt#Bahnhof

Hauptbahnhofes<tab>Haupt#Bahnhof

Hauptbahnhof<tab>Haupt#Bahnhof

Hauptbahnhoefe<tab>Haupt#Bahnhof

index_themes

是指定索引主题信息用英文或法文。这使得 ABOUT查询更精确。Index_themes和index_text的属性不可能都是号

如果您使用BASIC_LEXER ，并指定index_themes没有值，此属性默认为NO.

可以将此参数设置为 TRUE，任何为包括 CTXCAT 的索引类型。若要与 CATSEARCH 发出关于查询，请将查询模板使用上下文语法。

注：

index_themes需要安装的知识库文章。知识库文章可能或不可能安装 Oracle 文本。在知识的基础上的详细信息，请参阅Oracle 文本应用程序开发人员指南.

prove_themes

指定YES以证明主题。主题证明试图在文档中查找相关的主题。当发现有没有相关的主题时，父主题被消除从文档。

虽然主题证明是可以接受的大型文档，几句简短的文字说明很少证明父主题，从而导致贫穷召回性能与ABOUT查询。

证明结果在较高的精度和减少 （减少返回的行） 召回ABOUT查询的主题。为较高的查全率ABOUT查询中可能不是那么精确，您可以禁用主题证明。YES.

prove_themes属性支持CONTEXT和CTXRULE的索引。

theme_language

指定的知识库用于主题代当index_themes设置为YES。当index_themes是NO的时将此参数设置有没有任何的影响。

您可以指定任何全球化支持的语言或AUTO。您必须为您指定的语言的知识库文章。此版本提供一个知识库中只有英文和法文。在其他语言中，您可以创建您自己的知识库。

请参见：

在章 14、"Oracle 文本可执行文件" "添加特定于语言的知识库文章".

默认值是AUTO，它指示系统重新设置此参数的语言环境。

index_stems

指定的词干分析器用于干索引。你可以选择之一

• 没有一个

• 英语

• 派生词缀

• 荷兰语

• 法语

• 德语

• 意大利语

• 西班牙语

令牌被阻挡在索引时除了正常形式单一基窗体。索引茎允许更好的查询性能，对于干 ($) 的查询，如$computed.

index_text

对索引词信息指定YES。Index_themes和index_text的属性都不能NO.

缺省设置为NO.

alternate_spelling

GERMAN、DANISH，或指定SWEDISH，使不同的拼写这些语言之一。启用备用拼写使您能够查询中任何其他形式的单词。

替换拼写默认是关闭的 ；然而，在 Oracle 提供admin/defaults（德语， drdefdk.sql为丹麦语和瑞典语drdefs.sql drdefd.sql ) 的特定于语言的脚本，替换拼写被打开的。如果安装过程中使用这些脚本，然后替换拼写是上。然而，您可以指定NONE ，没有备用的拼写。Oracle 的文本使用替换拼写公约有关详细信息，请参阅替换拼写.

new_german_spelling

指定是否使用BASIC_LEXER的查询返回两个传统和改革 （新） 拼写的德语单词。如果将new_german_spelling设置为是，然后创建索引传统和新形式的单词。如果它设置为否，然后 word 将索引仅作为它在查询中的规定。默认值是号

请参见：

"新的德语拼写"

BASIC_LEXER 示例

下面的示例设置 printjoin 字符和禁用索引与BASIC_LEXER的主题:

begin

ctx_ddl.create_preference('mylex', 'BASIC_LEXER');

ctx_ddl.set_attribute('mylex', 'printjoins', '_-');

ctx_ddl.set_attribute ( 'mylex', 'index_themes', 'NO');

ctx_ddl.set_attribute ( 'mylex', 'index_text', 'YES');

end;

若要创建索引，没有主题标引与 printjoins 字符设置所述，请发出以下语句：

create index myindex on mytable ( docs )

  indextype is ctxsys.context

  parameters ( 'LEXER mylex' );

多语言 Stoplists

当您使用MULTI_LEXER时，您还可以为索引使用多语言的非索引字表。

MULTI_LEXER 示例

创建多语言表语言列与主键、 文本列中，如下所示：

create table globaldoc (

   doc_id number primary key,

   lang varchar2(3),

   text clob

);

假设表保存大多是英文资料，与偶尔的德语或日语文档。若要处理这三种语言，您必须创建三子词法分析器、 一个用于英语、 德语和日语：

ctx_ddl.create_preference('english_lexer','basic_lexer');

ctx_ddl.set_attribute('english_lexer','index_themes','yes');

ctx_ddl.set_attribute('english_lexer','theme_language','english');

ctx_ddl.create_preference('german_lexer','basic_lexer');

ctx_ddl.set_attribute('german_lexer','composite','german');

ctx_ddl.set_attribute('german_lexer','mixed_case','yes');

ctx_ddl.set_attribute('german_lexer','alternate_spelling','german');

ctx_ddl.create_preference('japanese_lexer','japanese_vgram_lexer');

创建多 lexer 首选项：

ctx_ddl.create_preference('global_lexer', 'multi_lexer');

由于存储的文件大多是英语，使英语的词法分析器使用 CTX_DDL 的默认设置。ADD_SUB_LEXER:

ctx_ddl.add_sub_lexer('global_lexer','default','english_lexer');

现在，他们各自的语言与 CTX_DDL 中添加德语和日语的词法分析器。ADD_SUB_LEXER程序。此外假定语言列表示在标准的 ISO 639-2 的语言代码，所以添加那些作为替换值。

ctx_ddl.add_sub_lexer('global_lexer','german','german_lexer','ger');

ctx_ddl.add_sub_lexer('global_lexer','japanese','japanese_lexer','jpn');

现在，创建索引globalx，指定多 lexer 偏好和语言列参数子句中，如下所示：

create index globalx on globaldoc(text) indextype is ctxsys.context

parameters ('lexer global_lexer language column lang');

查询多语言表

在查询时，多词法分析器检查的语言设置，并使用该语言的子词法分析器偏好来解析查询。如果不设置语言，则使用默认的词法分析器。

否则为查询是解析，像往常一样运行。索引包含令牌从多国语言，所以这样的查询可以返回文档中几种语言。若要限制您为给定语言的查询，请使用语言栏上的结构化的子句。

CHINESE_VGRAM_LEXER 属性

CHINESE_VGRAM_LEXER具有以下属性：

字符集

您可以使用此词法分析器如果您数据库的字符集是以下内容之一：

• AL32UTF8

• ZHS16CGB231280

• ZHS16GBK

• ZHS32GB18030

• ZHT32EUC

• ZHT16BIG5

• ZHT32TRIS

• ZHT16MSWIN950

• ZHT16HKSCS

• UTF8

CHINESE_LEXER 属性

CHINESE_LEXER具有以下属性：

自定义汉语词汇

你可以修改现有词典 （词典） 采用中国的词法分析器，或创建您自己的汉语词汇，使用ctxlc命令。

JAPANESE_VGRAM_LEXER 属性

此词法分析器具有下列属性：

JAPANESE_VGRAM_LEXER 字符集

您可以使用此词法分析器如果您数据库的字符集是以下内容之一：

• JA16SJIS

• JA16EUC

• UTF8

• AL32UTF8

• JA16EUCTILDE

• JA16EUCYEN

• JA16SJISTILDE

• JA16SJISYEN

自定义日本词汇

你可以修改现有词典 （词典） 采用日本的词法分析器，或创建您自己的日本词汇，使用ctxlc命令。

JAPANESE_LEXER 属性

此词法分析器具有下列属性：

日本的 LEXER 字符集

JAPANESE_LEXER支持以下字符集：

• JA16SJIS

• JA16EUC

• UTF8

• AL32UTF8

• JA16EUCTILDE

• JA16EUCYEN

• JA16SJISTILDE

• JA16SJISYEN

日本的词法分析器的示例

JAPANESE_LEXER指定用于创建文本索引时， JAPANESE_LEXER将其一个句子解析成单词。

例如，以下复词 （自然语言研究所)

图 nihongo1.gif 的描述

被索引作为三个标记：

图 nihongo2.gif 的描述

为了解决一个句子成单词，引用的内部字典。当不能在内部字典中找到单词时，Oracle 文本将使用JAPANESE_VGRAM_LEXER来解决它。

提供的字典

KOREAN_MORPH_LEXER使用四个字典：

使用的 KSC 5601 或 MSWIN949 的字符集应该编写语法，用户定义的和 stopword 字典。您可以修改这些词典使用已定义的规则。不能修改系统词典。

可以将未注册的单词添加到用户定义的词典文件。用于指定新单词的规则是在文件中。

受支持的字符集

您可以使用KOREAN_MORPH_LEXER ，如果您数据库的字符集是以下内容之一：

• KO16KSC5601

• KO16MSWIN949

• UTF8

• AL32UTF8

KOREAN_MORPH_LEXER使混合大小写的搜索。

Unicode 支持

KOREAN_MORPH_LEXER支持：

• 在 Unicode 中定义的非 KSC5601 韩文字符的单词

• 补充字符

韩国的一些文件可能有非 KSC5601 个字符。KOREAN_MORPH_LEXER可以认识到所有可能的 11,172 韩国 （朝鲜） 字符，此类文件还使用 UTF8 或 AL32UTF8 字符集解释。

使用您的数据库的 AL32UTF8 字符集来提取代理项字符。默认情况下， KOREAN_MORPH_LEXER提取所有系列的代理项字符在文档中为每个数据系列的一个标记。

KOREAN_MORPH_LEXER 属性

当您使用KOREAN_MORPH_LEXER时，您可以指定以下属性：

限制

句子和段落章节不支持KOREAN_MORPH_LEXER.

KOREAN_MORPH_LEXER 示例： 将复合属性设置

你可以使用复合属性来控制如何复合名词被编入索引。

begin

ctx_ddl.create_preference('my_lexer','KOREAN_MORPH_LEXER');

ctx_ddl.set_attribute('my_lexer','COMPOSITE','NGRAM');

end

create index koreanx on korean(text) indextype is ctxsys.context

parameters ('lexer my_lexer');

begin

ctx_ddl.create_preference('my_lexer','KOREAN_MORPH_LEXER');

ctx_ddl.set_attribute('my_lexer','COMPOSITE','COMPONENT_WORD');

end

create index koreanx on korean(text) indextype is ctxsys.context

parameters ('lexer my_lexer');

表 2-23 USER_LEXER 为用户定义的例程

限制

与USER_LEXER不支持以下功能:

• CTX_DOC.GIST和CTX_DOC.THEMES

• CTX_QUERY.HFEEDBACK

• ABOUT查询运算符

• CTXRULE为索引类型

• VGRAM索引算法

USER_LEXER 属性

USER_LEXER 具有下列属性：

INDEX_PROCEDURE

此回调存储过程是 Oracle 文本称为标记文档或停用词在非索引字表对象中找到所需。

INPUT_TYPE

两个不同的接口支持的用户定义的词法分析器索引过程。一个接口使文档或停止词和编码为 XML 作为 VARCHAR2 数据类型传递，而其他接口使用 CLOB 数据类型对应的标记。此属性指示由 INDEX_PROCEDURE 属性所指定的存储过程实现的接口。

QUERY_PROCEDURE

此回调存储过程是 Oracle 文本称为标记词s 在查询中的所需。以空格分隔的一组字符 （不包括的查询运算符） 在查询中将标识 Oracle 文本作为一个词.

作为 XML 编码的标记

由存储过程返回的标记的顺序必须表示为 XML 1.0 文档。XML 文档必须是有效给出了在以下各节中的 XML 架构。

• 没有位置、 用户定义的索引程序的 XML 架构

• 用户定义的索引过程与位置的 XML 架构

• 用户定义的词法分析器查询程序的 XML 架构

没有位置、 用户定义的索引程序的 XML 架构

本节介绍了额外的约束条件的用户定义的词法分析器索引过程，当第三个参数为 FALSE 返回的 XML 文档。返回的 XML 文档必须是有效下面的 XML 架构：

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <xsd:element name="tokens">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:choice minOccurs="0" maxOccurs="unbounded">

          <xsd:element name="eos" type="EmptyTokenType"/>

          <xsd:element name="eop" type="EmptyTokenType"/>

          <xsd:element name="num" type="xsd:token"/>

          <xsd:group ref="IndexCompositeGroup"/>

        </xsd:choice>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

  <!--

  Enforce constraint that compMem element must be preceeded by word element

  or compMem element for indexing

  -->

  <xsd:group name="IndexCompositeGroup">

    <xsd:sequence>

      <xsd:element name="word" type="xsd:token"/>

      <xsd:element name="compMem" type="xsd:token" minOccurs="0"

maxOccurs="unbounded"/>

    </xsd:sequence>

  </xsd:group>

  <!-- EmptyTokenType defines an empty element without attributes -->

  <xsd:complexType name="EmptyTokenType"/>

</xsd:schema>

这里是一些此 XML 架构的限制：

• 根元素是令牌。这是强制性的。它不具有属性。

• 根元素可以有零个或更多子元素。子元素可以是以下之一： eos、 eop、 num，单词和 compMem。其中每一个表示特定类型的令牌。

• CompMem 元素的前面必须由 word 元素或 compMem 元素。

• Eos 和 eop 元素没有属性，并且必须是空的元素。

• Num，单词和 compMem 的元素有没有属性。Oracle 文本将正常化这些元素的内容，如下所示： 空格字符转换成空格字符、 折叠到单个空格字符的相邻的空格字符、 移除前导空格和尾随空格，执行实体引用替换和截断为 64 个字节。

表 2-28描述前面的 XML 架构中定义的元素名称。

<tokens>

  <word> VOM </word>

  <word> NORDHAUPTBAHNHOF </word>

  <compMem>NORD</compMem>

  <compMem>HAUPT </compMem>

  <compMem>BAHNHOF </compMem>

  <compMem>HAUPTBAHNHOF </compMem>

  <word> UND </word>

  <word> AUS </word>

  <word> DER </word>

  <word> INNENSTADT </word>

  <word> ZUM </word>

  <word> MESSEGELÄNDE </word>

  <eos/>

</tokens>

<tokens>

  <word> ORACLE10G</word>

  <word> RELEASE </word>

  <num> 1 </num>

</tokens>

<tokens>

  <word> WHERE </word>

  <word> salary&lt;2500.00 </word>

  <word> AND </word>

  <word> job </word>

  <word> F&amp;B </word>

  <word> Manager </word>

</tokens>

用户定义的索引过程与位置的 XML 架构

本节介绍了额外的限制强加给由用户定义的词法分析器索引过程，第三个参数为 TRUE 时返回的 XML 文档。返回的 XML 文档必须符合下面的 XML 架构的有效：

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <xsd:element name="tokens">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:choice minOccurs="0" maxOccurs="unbounded">

          <xsd:element name="eos" type="EmptyTokenType"/>

          <xsd:element name="eop" type="EmptyTokenType"/>

          <xsd:element name="num" type="DocServiceTokenType"/>

          <xsd:group ref="DocServiceCompositeGroup"/>

        </xsd:choice>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

  <!--

  Enforce constraint that compMem element must be preceeded by word element

  or compMem element for document service

  -->

  <xsd:group name="DocServiceCompositeGroup">

    <xsd:sequence>

      <xsd:element name="word" type="DocServiceTokenType"/>

      <xsd:element name="compMem" type="DocServiceTokenType" minOccurs="0"

           maxOccurs="unbounded"/>

    </xsd:sequence>

  </xsd:group>

  <!-- EmptyTokenType defines an empty element without attributes -->

  <xsd:complexType name="EmptyTokenType"/>

  <!--

  DocServiceTokenType defines an element with content and mandatory attributes

  -->

  <xsd:complexType name="DocServiceTokenType">

    <xsd:simpleContent>

      <xsd:extension base="xsd:token">

        <xsd:attribute name="off" type="OffsetType" use="required"/>

        <xsd:attribute name="len" type="xsd:unsignedShort" use="required"/>

      </xsd:extension>

    </xsd:simpleContent>

  </xsd:complexType>

  <xsd:simpleType name="OffsetType">

    <xsd:restriction base="xsd:unsignedInt">

      <xsd:maxInclusive value="2147483647"/>

    </xsd:restriction>

  </xsd:simpleType>

</xsd:schema>

一些此 XML 架构的限制如下：

• 根元素是令牌。这是强制性的。它不具有属性。

• 根元素可以有零个或更多子元素。子元素可以是以下之一： eos、 eop、 num，单词和 compMem。其中每一个表示特定类型的令牌。

• CompMem 元素的前面必须由 word 元素或 compMem 元素。

• Eos 和 eop 元素没有属性，并且必须是空的元素。

• Num，单词和 compMem 的元素有两个强制性属性：off和长度。Oracle 文本将正常化这些元素的内容，如下所示： 空格字符转换成空格字符、 折叠到单个空格字符的相邻的空格字符、 移除前导空格和尾随空格，执行实体引用替换和截断为 64 个字节。

• off属性值必须是介于 0 到 2147483647 包容性之间的整数。

• len属性值必须是整数 0 和 65535 之间的包容性。

表 2-28描述前面的 XML 架构中定义的元素类型。

表 2-29描述前面的 XML 架构中定义的属性。

off属性值和len属性值的总和必须小于或等于被标记文档中的字符总数。这是为了确保文件偏移量和被引用的字符在文档边界内。

<tokens>

  <word off="0" len="4"> USE </word>

  <word off="5" len="7"> DEF </word>

  <word off="13" len="5"> LEX </word>

  <eos/>

</tokens>

用户定义的词法分析器查询程序的 XML 架构

本节介绍了额外的限制强加给用户定义的词法分析器查询过程所返回的 XML 文档。返回的 XML 文档必须是有效下面的 XML 架构：

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <xsd:element name="tokens">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:choice minOccurs="0" maxOccurs="unbounded">

          <xsd:element name="num" type="QueryTokenType"/>

          <xsd:group ref="QueryCompositeGroup"/>

        </xsd:choice>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

<!--

Enforce constraint that compMem element must be preceeded by word element

or compMem element for query

-->

  <xsd:group name="QueryCompositeGroup">

    <xsd:sequence>

      <xsd:element name="word" type="QueryTokenType"/>

      <xsd:element name="compMem" type="QueryTokenType" minOccurs="0"

                                              maxOccurs="unbounded"/>

    </xsd:sequence>

  </xsd:group>

  <!--

  QueryTokenType defines an element with content and with an optional attribute

  -->

  <xsd:complexType name="QueryTokenType">

    <xsd:simpleContent>

      <xsd:extension base="xsd:token">

        <xsd:attribute name="wildcard" type="WildcardType" use="optional"/>

      </xsd:extension>

    </xsd:simpleContent>

  </xsd:complexType>

  <xsd:simpleType name="WildcardType">

    <xsd:restriction base="WildcardBaseType">

      <xsd:minLength value="1"/>

      <xsd:maxLength value="64"/>

    </xsd:restriction>

  </xsd:simpleType>

  <xsd:simpleType name="WildcardBaseType">

    <xsd:list>

      <xsd:simpleType>

        <xsd:restriction base="xsd:unsignedShort">

          <xsd:maxInclusive value="378"/>

        </xsd:restriction>

      </xsd:simpleType>

    </xsd:list>

  </xsd:simpleType>

</xsd:schema>

这里是一些此 XML 架构的限制：

• root元素是令牌。这是强制性的。它不具有属性。

• root元素可以有零个或更多子元素。子元素可以是以下之一： num和word。其中每一个表示特定类型的令牌。

• compMem元素的前面必须由word元素或compMem元素。

  compMem的目的是，使USER_LEXER查询返回多个窗体为单个查询。例如，如果用户定义的词法分析器索引词银行为BANK(FINANCIAL)和BANK(RIVER)，查询过程可以返回作为一个word和一个compMem元素作为第二第一学期：

  <tokens>
  
    <word>BANK(RIVER)</word>
  
    <compMem>BANK(FINANCIAL)</compMem>
  
  </tokens>
  

  请参阅表 2-30，更多关于 compMem元的"用户定义词法分析器查询程序 XML 架构属性" 。

• Num 和 word 元素有一个单一的可选属性： 通配符。Oracle 文本将正常化这些元素的内容，如下所示： 空格字符转换成空格字符、 折叠到单个空格字符的相邻的空格字符、 移除前导空格和尾随空格，执行实体引用替换和截断为 64 个字节。

• 通配符属性值是白色空间分隔的整数列表。整数的最小数目是 1，整数的最大数目是 64。整数值必须介于 0 和 378 包容性。Intriguers 在列表中的可以按任何顺序。

表 2-28描述前面的 XML 架构中定义的元素类型。

表 2-30介绍了前面的 XML 架构中定义的属性。

<tokens>

  <word> PSEUDO </word>

  <word wildcard="1 7"> %MORPH% </word>

</tokens>

Query word: <%>

Tokens:

<tokens>

  <word wildcard="5"> &lt;%&gt; </word>

</tokens>

WORLD_LEXER 属性

WORLD_VGRAM_LEXER具有以下属性：

WORLD_LEXER 示例

下面是一个示例创建索引使用WORLD_LEXER的.

exec ctx_ddl.create_preference('MYLEXER', 'world_lexer');

create index doc_idx on doc(data)

  indextype is CONTEXT

  parameters ('lexer MYLEXER

               stoplist CTXSYS.EMPTY_STOPLIST');

请参见：

有关干和模糊算子的详细信息，请参阅第 3 章，"Oracle 文本包含查询运算符".

表 2-32 BASIC_WORDLIST 属性

使模糊匹配和词干

以下示例启用词干和模糊匹配为英语。STEM_FUZZY_PREF的偏好将扩产的数目设置为允许的最大。此首选项也指示系统创建的子字符串的索引，以提高双截断搜索的性能。

begin

  ctx_ddl.create_preference('STEM_FUZZY_PREF', 'BASIC_WORDLIST');

  ctx_ddl.set_attribute('STEM_FUZZY_PREF','FUZZY_MATCH','ENGLISH');

  ctx_ddl.set_attribute('STEM_FUZZY_PREF','FUZZY_SCORE','0');

  ctx_ddl.set_attribute('STEM_FUZZY_PREF','FUZZY_NUMRESULTS','5000');

  ctx_ddl.set_attribute('STEM_FUZZY_PREF','SUBSTRING_INDEX','TRUE');

  ctx_ddl.set_attribute('STEM_FUZZY_PREF','STEMMER','ENGLISH');

end; 

若要在 SQL 中创建索引，请发出以下语句：

create index fuzzy_stem_subst_idx on mytable ( docs )

  indextype is ctxsys.context parameters ('Wordlist STEM_FUZZY_PREF');

使字符串的子字符串和前缀索引

下面的示例设置词库首选前缀和字符串的子字符串的索引。为前缀索引，它指定标记前缀 3 到 4 个字符长之间创建 Oracle 的文本：

begin

ctx_ddl.create_preference('mywordlist', 'BASIC_WORDLIST');

ctx_ddl.set_attribute('mywordlist','PREFIX_INDEX','TRUE');

ctx_ddl.set_attribute('mywordlist','PREFIX_MIN_LENGTH',3);

ctx_ddl.set_attribute('mywordlist','PREFIX_MAX_LENGTH', 4);

ctx_ddl.set_attribute('mywordlist','SUBSTRING_INDEX', 'YES');

end

设置通配符扩展限制

使用 wildcard_maxterms 属性来设置最大允许条件中的通配符扩展。

--- create a sample table

drop table quick ;

create table quick

  (

    quick_id number primary key,

    text      varchar(80)

  ); 

--- insert a row with 10 expansions for 'tire%'

insert into quick ( quick_id, text )

  values ( 1, 'tire tirea tireb tirec tired tiree tiref tireg tireh tirei tirej');

commit;

--- create an index using wildcard_maxterms=100

begin

    Ctx_Ddl.Create_Preference('wildcard_pref', 'BASIC_WORDLIST');

    ctx_ddl.set_attribute('wildcard_pref', 'wildcard_maxterms', 100) ;

end;

/

create index wildcard_idx on quick(text)

    indextype is ctxsys.context

    parameters ('Wordlist wildcard_pref') ;

--- query on 'tire%' - should work fine

select quick_id from quick

  where contains ( text, 'tire%' ) > 0;

--- now re-create the index with wildcard_maxterms=5

drop index wildcard_idx ;

begin

    Ctx_Ddl.Drop_Preference('wildcard_pref');

    Ctx_Ddl.Create_Preference('wildcard_pref', 'BASIC_WORDLIST');

    ctx_ddl.set_attribute('wildcard_pref', 'wildcard_maxterms', 5) ;

end;

/

create index wildcard_idx on quick(text)

    indextype is ctxsys.context

    parameters ('Wordlist wildcard_pref') ;

--- query on 'tire%' gives "wildcard query expansion resulted in too many terms"

select quick_id from quick

  where contains ( text, 'tire%' ) > 0;

请参见：

有关如何指定CREATETABLE和CREATEINDEX的语句的详细信息，请参阅Oracle 数据库 SQL 引用。

表 2-34 BASIC_STORAGE 属性

存储默认行为

默认情况下，不设置BASIC_STORAGE属性。在这种情况下，在索引所有者默认表空间中创建文本索引表。请考虑以下声明用户IUSER，没有BASIC_STORAGE属性设置：

create index IOWNER.idx on TOWNER.tab(b) indextype is ctxsys.context;

在此示例中，在IOWNER's默认表空间中创建文本索引。

存储示例

下面的示例指定索引表是在 1k 初始范围 foo的表空间中创建：

begin

ctx_ddl.create_preference('mystore', 'BASIC_STORAGE');

ctx_ddl.set_attribute('mystore', 'I_TABLE_CLAUSE',

                        'tablespace foo storage (initial 1K)');

ctx_ddl.set_attribute('mystore', 'K_TABLE_CLAUSE',

                        'tablespace foo storage (initial 1K)');

ctx_ddl.set_attribute('mystore', 'R_TABLE_CLAUSE',

                        'tablespace users storage (initial 1K) lob

                         (data) store as (disable storage in row cache)');

ctx_ddl.set_attribute('mystore', 'N_TABLE_CLAUSE',

                        'tablespace foo storage (initial 1K)');

ctx_ddl.set_attribute('mystore', 'I_INDEX_CLAUSE',

                        'tablespace foo storage (initial 1K) compress 2');

ctx_ddl.set_attribute('mystore', 'P_TABLE_CLAUSE',

                        'tablespace foo storage (initial 1K)');

end;

在 HTML 文档中创建分区组

下面的语句创建使用 HTML 组类型调用htmgroup的节组。

begin

ctx_ddl.create_section_group('htmgroup', 'HTML_SECTION_GROUP');

end;

您可以选择添加节到此组在 CTX_DDL包中，如CTX_DDL.ADD_SPECIAL_SECTION或 CTX_DDL.ADD_ZONE_SECTION。要索引您的文档，可以如发出一份声明：

create index myindex on docs(htmlfile) indextype is ctxsys.context

parameters('filter ctxsys.null_filter section group htmgroup');

创建的 XML 文档中的节组

下面的语句创建称为xmlgroup与XML_SECTION_GROUP组类型的节组。

begin

ctx_ddl.create_section_group('xmlgroup', 'XML_SECTION_GROUP');

end;

您可以选择添加节到此组在 CTX_DDL包中，如CTX_DDL.ADD_ATTR_SECTION或CTX_DDL.ADD_STOP_SECTION。要索引您的文档，可以如发出一份声明：

create index myindex on docs(htmlfile) indextype is ctxsys.context

parameters('filter ctxsys.null_filter section group xmlgroup');

自动切片的 XML 文档中

下面的语句创建称为auto与AUTO_SECTION_GROUP组类型的节组。此分区组自动创建的部分，从 XML 文档中的标记。

begin

ctx_ddl.create_section_group('auto', 'AUTO_SECTION_GROUP');

end;

CREATE INDEX myindex on docs(htmlfile) INDEXTYPE IS ctxsys.context

PARAMETERS('filter ctxsys.null_filter section group auto');

表 2-36 RULE_CLASSIFIER 属性

表 2-37 SVM_CLASSIFIER 属性

表 2-38 KMEAN_CLUSTERING 属性

动态添加的字

您可以向默认值或自定义的非索引字表具有ALTER INDEX中动态地添加字。当您动态地添加 stopword 时，你需要不重新编制索引，因为这个词立即成为 stopword，从索引中删除。

CTXSYS。DEFAULT_DATASTORE

此首选项将使用DIRECT_DATASTORE类型。您可以使用此首选项为文本列中的文本存储在列中直接创建索引。

CTXSYS。FILE_DATASTORE

此首选项将使用FILE_DATASTORE类型。

CTXSYS。URL_DATASTORE

此首选项将使用URL_DATASTORE类型。

CTXSYS。NULL_FILTER

此首选项将使用NULL_FILTER类型。

CTXSYS。AUTO_FILTER

此首选项将使用AUTO_FILTER类型。

CTXSYS。DEFAULT_LEXER

默认的 lexer 取决于在安装时所使用的语言。以下各节描述了CTXSYS.DEFAULT_LEXER为每种语言。

CTXSYS。BASIC_LEXER

这种偏好使用BASIC_LEXER.

CTXSYS。NULL_SECTION_GROUP

此首选项将使用NULL_SECTION_GROUP类型。

CTXSYS。HTML_SECTION_GROUP

此首选项将使用HTML_SECTION_GROUP类型。

CTXSYS。AUTO_SECTION_GROUP

此首选项将使用AUTO_SECTION_GROUP类型。

CTXSYS。PATH_SECTION_GROUP

此首选项将使用PATH_SECTION_GROUP类型。

CTXSYS。DEFAULT_STOPLIST

此非索引字表首选项默认为您的数据库语言的非索引字表。

CTXSYS。EMPTY_STOPLIST

此非索引字表已无话。

CTXSYS。DEFAULT_STORAGE

此存储首选项使用BASIC_STORAGE类型。

CTXSYS。DEFAULT_WORDLIST

此首选项为您的数据库语言使用语言的词干分析器。如果你的语言不列在表 2-32，此首选项默认为 NULL 的词干分析器和泛型的模糊匹配属性。

表 2-39 一般系统参数

上下文索引参数

当您创建一个上下文索引时不指定首选项参数子句中创建索引时使用以下默认参数。每个默认参数命名系统定义的偏好，以用于数据存储、 过滤、 词法分析，等等。

CTXCAT 索引参数

与创建索引创建一个 CTXCAT 索引和参数字符串中未指定任何参数时，就会使用下面的默认参数。CTXCAT 索引支持仅索引集、 词法分析器、 存储、 非索引字表和单词表参数。每个默认参数命名系统定义的首选项。

CTXRULE 索引参数

当你创建CTXRULE索引CREATEINDEX并在参数字符串中未指定任何参数，就会使用以下的默认参数。CTXRULE索引支持的 lexer、 存储、 非索引字表和单词表参数。每个默认参数命名系统定义的首选项。

Viewing Default Values

You can view system defaults by querying the CTX_PARAMETERS view. For example, to see all parameters and values, you can issue:

SQL> SELECT par_name, par_value from ctx_parameters;

Changing Default Values

You can change a default value using the CTX_ADM.SET_PARAMETER procedure to name another custom or system-defined preference to use as default.