FREETEXTTABLE (Transact-SQL)
是一个函数,用于在 Transact-SQL SELECT 语句的 FROM 子句中对包含基于字符的数据类型的全文索引列执行 SQL Server 全文搜索。 此函数为符合下述条件的列返回行数为零或包含一行或多行的表:这些列包含的值符合指定的freetext_string 中文本的含义,但不一定具有完全相同的文本语言。 FREETEXTTABLE 被视为一个常规表名来引用。
FREETEXTTABLE 用来搜索的匹配项的种类与 FREETEXT (Transact-SQL)相同。
使用 FREETEXTTABLE 的查询返回每一行的相关性排名值 (RANK) 和全文键 (KEY)。
注意 |
---|
有关 SQL Server 支持的全文搜索形式的信息,请参阅使用全文搜索查询。 |
语法
FREETEXTTABLE (table , { column_name | (column_list) | * }
, 'freetext_string'
[ , LANGUAGE language_term ]
[ , top_n_by_rank ] )
参数
table
表的名称,该表已标记为全文查询。 table 或 view 可以是由一个部分、两个部分或三个部分组成的数据库对象名称。 查询视图时,仅能涉及一个全文索引的基表。table 不能指定服务器名,也不能在针对链接服务器执行的查询中使用。
column_name
FROM 子句中指定表的一个或多个全文索引列的名称。 这些列可为 char、varchar、nchar、nvarchar、text、ntext、image、xml、varbinary 或 varbinary(max) 类型。column_list
指示可以指定多个列(以逗号分隔)。 column_list 必须用括号括起来。 除非指定 language_term,否则 column_list 中所有列的语言必须相同。*
指定所有注册全文搜索的列均应用于搜索给定的 freetext_string。 除非指定 language_term,否则表中的所有全文索引列必须使用相同的语言。freetext_string
要在 column_name 中搜索的文本。 可以输入任何文本,包括单词、短语或句子。 只要在全文索引中找到任何术语或术语格式,就会生成匹配项。与 AND 作为关键字的 CONTAINS 搜索条件不同,当单词“and”在 freetext_string 中使用时,它被视为一个干扰词或非索引字,因此将被丢弃。
不允许使用 WEIGHT、FORMSOF、通配符、NEAR 和其他语法。 系统将通过同义词库对 freetext_string 进行断字处理、词干分析,然后执行同义词库查询。
LANGUAGE language_term
特定的语言,查询时,其资源将用于断字、词干分析、同义词库查询以及非索引字删除。 此参数是可选的,可以将其指定为与语言区域设置标识符 (LCID) 对应的字符串、整数或十六进制值。 如果指定了 language_term,则它表示的语言将应用于搜索条件的所有元素。 如果未指定值,则使用该列的全文语言。如果将不同语言的文档一起作为二进制大型对象 (BLOB) 存储在单个列中,则指定文档的区域设置标识符 (LCID) 将决定对其内容编制索引时使用哪种语言。 在对这种列进行查询时,指定 LANGUAGE language_term 可增大找到有效匹配项的可能性。
如果指定为字符串,language_term 将对应于 sys.syslanguages (Transact-SQL) 兼容性视图中的 alias 列值。 字符串必须用单引号引起来,如 'language_term'。 如果指定为整数,则 language_term 就是标识该语言的实际 LCID。 如果指定为十六进制值,则 language_term 将以 0x 开头,后面跟有 LCID 的十六进制值。 十六进制值不能超过八位(包括前导零在内)。
如果该值是双字节字符集 (DBCS) 格式,则 Microsoft SQL Server 会将其转换为 Unicode 格式。
如果指定的语言无效,或者未安装对应于该语言的资源,SQL Server 将返回错误。 若要使用非特定语言资源,请将 0x0 指定为 language_term。
top_n_by_rank
指定仅以降序方式返回排名最高的前 n 个匹配项。 仅当指定了整数值 n 时适用。 如果 top_n_by_rank 与其他参数组合使用,则查询返回的行数可能会少于实际与所有谓词都匹配的行数。 使用 top_n_by_rank,您可以通过仅调取最密切相关的命中项来提高查询性能。
注释
全文谓词和函数作用于 FROM 谓词所示的单个表。 若要对多个表进行搜索,请在 FROM 子句中使用联接表,以搜索由两个或更多个表的乘积构成的结果集。
FREETEXTTABLE 使用与 FREETEXT 谓词相同的搜索条件。
和 CONTAINSTABLE 一样,返回的表包含名为 KEY 和 RANK 的列,可以在查询中引用这些列以获取相应的行并使用行排名值。
权限
只有对指定表或表中所引用的列具有适当的 SELECT 权限的用户才能调用 FREETEXTTABLE。
示例
A.在 INNER JOIN 中使用 FREETEXT
以下示例返回所有与 sweet、candy、bread、dry 或 meat 相关的类别名称和类别说明。
USE AdventureWorks2012
GO
SELECT FT_TBL.Description
,KEY_TBL.RANK
FROM Production.ProductDescription AS FT_TBL
INNER JOIN FREETEXTTABLE(Production.ProductDescription,
Description,
'high level of performance') AS KEY_TBL
ON FT_TBL.ProductDescriptionID = KEY_TBL.[KEY]
ORDER BY RANK DESC
GO
B.指定语言和排名最高的匹配项
以下示例与上例相同,只是说明了 LANGUAGE language_term 和 top_n_by_rank 参数的用法。
USE AdventureWorks2012
GO
SELECT FT_TBL.Description
,KEY_TBL.RANK
FROM Production.ProductDescription AS FT_TBL
INNER JOIN FREETEXTTABLE(Production.ProductDescription,
Description,
'high level of performance',
LANGUAGE N'English', 2) AS KEY_TBL
ON FT_TBL.ProductDescriptionID = KEY_TBL.[KEY]
ORDER BY RANK DESC
GO
注意 |
---|
使用 top_n_by_rank 参数并不需要 LANGUAGE language_term 参数。 |
请参阅
任务
创建全文搜索查询 (Visual Database Tools)
参考
CREATE FULLTEXT CATALOG (Transact-SQL)
CREATE FULLTEXT INDEX (Transact-SQL)