✅ 一、SQL Server 全文索引完整创建指南（可执行方案）
SQL Server 的全文索引功能并非默认启用，许多开发环境甚至未安装相关组件。在正式创建之前，务必确认环境是否已就绪——这个基础步骤看似简单，却常常成为后续操作失败的根源。
1.1 环境前置检查（必须通过）
全文索引属于可选组件，默认情况下并未安装，多数开发环境也常被遗漏。 请在 SSMS 中执行以下命令进行验证：
-- 检查1：全文搜索组件是否已安装
SELECT SERVERPROPERTY('IsFullTextInstalled') AS IsFullTextInstalled;
- 返回值 = 1：环境就绪，可继续后续操作
- 返回值 = 0：需联系 DBA 安装全文组件（通过 SQL Server 安装介质修复，添加“全文和语义提取搜索”功能）
若返回 0，后续所有操作将无法生效，切勿强行继续。
1.2 为当前数据库启用全文索引功能
EXEC sp_fulltext_database 'enable';
说明：该命令并非所有 SQL Server 版本都必需，但执行后无副作用。若系统提示“已启用”，直接忽略即可
1.3 创建全文目录（存储容器）
CREATE FULLTEXT CATALOG FT_Catalog_LogRequest WITH ACCENT_SENSITIVITY = OFF;
ACCENT_SENSITIVITY = OFF：匹配时忽略重音符号，对中文检索无影响，建议启用此选项- 若仅需一个默认目录，可改为：
CREATE FULLTEXT CATALOG FT_Catalog_LogRequest AS DEFAULT;
1.4 在目标表上创建全文索引（核心操作步骤）
CREATE FULLTEXT INDEX ON dbo.LogRequests(
ParamJson -- 你要高速检索的大字段
LANGUAGE 2052, -- 2052 = 简体中文。必须指定！否则中文分词失效
ApiMethod, -- （可选）其他需要全文检索的字段
SysCode -- （可选）
)
KEY INDEX PK_LogRequests -- 表的主键名，必须单列、唯一、非空
ON FT_Catalog_LogRequest -- 全文目录名，使用上一步创建的
WITH (
CHANGE_TRACKING AUTO, -- 自动跟踪数据变更（推荐）
-- 或：CHANGE_TRACKING MANUAL, 手动更新；
STOPLIST = SYSTEM -- 使用系统停用词表
);
关于 LANGUAGE 2052 的重要性，需要特别强调：
若未指定 LANGUAGE 2052，SQL Server 将默认采用英语分词器进行解析。英文分词器依据空格切分词汇，像“托盘条码”这类中文词组会被视为一个整体，导致搜索“托盘”时无法匹配——全文索引因此形同虚设，这是实践中极易踩中的陷阱之一
1.5 首次填充索引数据（立即生效）
ALTER FULLTEXT INDEX ON dbo.LogRequests START FULL POPULATION;
- 数据量较大时，该操作会消耗较多 I/O 资源，建议安排在业务低峰时段执行。
- 填充期间，现有数据的全文检索功能暂时不可用，但表的增、删、改、查操作不受任何影响。
✅ 二、全文索引创建后的验证与查询实践
2.1 验证全文索引是否创建成功
-- 查看该表上的全文索引
SELECT * FROM sys.fulltext_indexes WHERE object_id = OBJECT_ID('dbo.LogRequests');
-- 查看全文目录下的所有索引
SELECT * FROM sys.fulltext_catalogs;
2.2 正确使用全文检索查询（告别 LIKE 模糊匹配）
错误用法（全表扫描）：
SELECT * FROM LogRequests WHERE ParamJson LIKE '%托盘条码123%';
正确用法（秒级响应）：
-- 精确匹配关键词 SELECT Id, ApiMethod, RequestTime FROM LogRequests WHERE CONTAINS(ParamJson, '托盘条码123'); -- 多个关键词（AND关系） SELECT Id, ApiMethod, RequestTime FROM LogRequests WHERE CONTAINS(ParamJson, '托盘 AND 条码'); -- 短语匹配（完全包含） SELECT Id, ApiMethod, RequestTime FROM LogRequests WHERE CONTAINS(ParamJson, '"托盘条码123"'); -- 同时检索多个字段 SELECT Id, ApiMethod, RequestTime FROM LogRequests WHERE CONTAINS((ParamJson, ApiMethod), '托盘');
请牢记，全文索引一旦建立完成，LIKE '%关键词%' 的模糊查询方式就该正式退役了。使用 CONTAINS 不仅能够实现秒级响应，还支持 AND、OR、短语匹配等灵活检索方式，这才是真正意义上的高效全文检索。
