bts_index_fields() 函数

bts_index_fields() 函数用于返回 bts 索引中的已索引字段名列表。

语法

index_name: bts 索引的名称。

用途

bts_index_fields() 函数用于识别 bts 索引中的可搜索字段。除了索引名之外，可以选择包含索引存储空间路径与文件名、数据库名称，以及所有者名称，并以正斜杠 (/) 字符分隔。

如果不使用 Basic Text Search XML 索引参数，bts_index_fields() 函数将返回一个缺省字段 contents。如果使用 XML 索引参数，将在不同的字段中按标记名称或路径对 XML 数据建立索引。除非也启用 include_contents 参数，否则将不对 contents 字段建立索引。

如果使用 xmltags 参数指定标记，bts_index_fields() 函数将仅为已索引列中存在的标记返回字段名。但是，如果以后添加包含指定标记名称的行，输出中也将包含该标记的字段名。

bts_index_fields() 函数将按照字母顺序返回字段名。

示例

假定存在以下 XML 分段：

<boat>
 <skipper>Captain Jack</skipper>
 <boatname>Black Pearl</boatname>
</boat>

在不使用 XML 索引参数的情况下创建索引：

CREATE INDEX boats_bts ON boats(boat_data bts_lvarchar_ops) 
USING bts IN bts_sbspace;

bts_index_fields() 函数将返回缺省字段：contents

在使用 XML 索引参数的情况下创建索引：

CREATE INDEX boats_bts ON boats(xml_data bts_lvarchar_ops) 
USING bts(xmltags="(skipper,boatname,crew)") IN bts_sbspace;

bts_index_fields() 函数将返回以下字段名：

boatname 
skipper

将不返回标记 crew 的字段名，因为 XML 分段示例中不存在此标记。

在启用 all_xmltags 和 xmlpath_processing 参数的情况下创建索引：

CREATE INDEX boats_bts ON boats(xml_data bts_lvarchar_ops) 
USING bts(all_xmltags="yes",xmlpath_processing="yes") 
IN bts_sbspace;

bts_index_fields() 函数将返回包含完整路径的字段名：

/boat/boatname
/boat/skipper

在启用 include_contents 参数的情况下创建索引：

CREATE INDEX boats_bts ON boats(xml_data bts_lvarchar_ops) 
USING bts(all_xmltags="yes",include_contents="yes") 
IN bts_sbspace;

bts_index_fields() 函数将返回以下字段：

boatname
contents
skipper

有关 XML 索引参数的信息，请参阅 Basic Text Search XML 索引参数。