CONTAINS只能用于WHERE或ON子句进行行级过滤，不能出现在SELECT、GROUP BY或HAVING中；正确做法是先用CONTAINS过滤再分组，或用CONTAINSTABLE获取RANK后JOIN分组。
不能直接在 GROUP BY 后对全文搜索结果做聚合统计——CONTAINS 是 WHERE 子句谓词，不返回标量值，也不能嵌套进 GROUP BY 或聚合函数里。想“分组后全文搜索”，本质是先过滤再分组，或先分组再用全文索引加速子集判断。
CONTAINS 无法出现在 SELECT 或 GROUP BY 中
常见错误是写成这样：
SELECT category, COUNT(*) FROM products GROUP BY category HAVING CONTAINS(description, 'wireless')
这会报错：Incorrect syntax near the keyword 'CONTAINS'。因为 CONTAINS 不是表达式，不能用于 HAVING 或 SELECT 列表。
真正能用的位置只有 WHERE（行级过滤）或 ON（JOIN 条件），且必须作用于已建全文索引的列。
-
CONTAINS返回布尔值，但不是 SQL Server 可识别的逻辑表达式上下文（比如不能赋给变量、不能参与CASE WHEN） - 它不支持标量上下文，所以
SELECT CONTAINS(...) FROM ...语法非法 - 即使列有全文索引，若查询中用了未索引列或计算列，
CONTAINS仍会静默失败或退化为表扫描
正确做法：先用 CONTAINS 过滤，再 GROUP BY
这是最常用、性能也最可控的方式：利用全文索引快速定位匹配行，再对结果分组。
例如统计“含 battery 或 rechargeable 的产品按类别分布”：
SELECT category, COUNT(*) AS cnt FROM products WHERE CONTAINS(description, 'battery OR rechargeable') GROUP BY category;
关键点：
- 全文索引必须已建在
description列上，否则查询会变慢甚至超时 - 如果
category列没索引，GROUP BY 可能触发排序；建议搭配非聚集索引CREATE INDEX IX_products_category ON products(category) INCLUDE(description)（但注意：INCLUDE列不能替代全文索引） - 避免在
CONTAINS外层再套LIKE或函数，比如WHERE CONTAINS(...) AND UPPER(name) LIKE '%BLUETOOTH%'—— 这会让全文优势失效
需要按匹配强度排序分组？用 CONTAINSTABLE 替代
当不只是“有没有匹配”，还要“匹配得多不多”，就得换 CONTAINSTABLE：它返回带 RANK 的临时结果集，可 JOIN 后再分组统计。
例如：查每个类别中 RANK > 50 的产品数量，并取最高 RANK：
SELECT p.category, COUNT(*) AS matched_count, MAX(ct.RANK) AS best_rank FROM products p INNER JOIN CONTAINSTABLE(products, description, 'noise cancellation') ct ON p.product_id = ct.[KEY] WHERE ct.RANK > 50 GROUP BY p.category;
注意：
-
CONTAINSTABLE必须显式 JOIN，[KEY]对应原表主键（不是自增 ID，是全文索引里注册的唯一键） -
RANK是相对值（0–1000），不同查询间不可比；不要用RANK = 1000做精确判断 - 若需限制返回行数，可在
CONTAINSTABLE第四个参数传top_n_by_rank，如CONTAINSTABLE(..., 50)只取前 50 名
别踩这些坑：语言、停用词与列选择
全文搜索行为高度依赖配置，容易因细节错配导致“明明有数据却搜不到”：
- 中文搜索必须指定
LANGUAGE 2052（简体中文 LCID），否则默认按英文分词，CONTAINS(content, '数据库')会失败 - 停用词（stoplist）默认启用，像“的”“和”“在”这类词会被忽略；检查当前停用词表：
SELECT * FROM sys.fulltext_stoplists -
CONTAINS不支持通配符前缀以外的模糊：写'data*'可以，但'*base'或'd?ta'都无效 - 若目标列是
xml或varbinary(max)，需确保全文索引已启用类型列（type column），否则CONTAINS返回空结果而不报错
最易被忽略的是：全文索引不会自动更新。INSERT/UPDATE 后，除非启用了自动填充（population），否则新数据不会立刻可搜——查不到时先确认 SELECT * FROM sys.dm_fts_index_population 里 status 是否为 4（idle）且 completion_type 正常。
