ServiceStack OrmLite技术咨询：枚举查询性能异常排查及执行计划、调试SQL获取方法

嗨，我来帮你梳理下这个问题的排查思路和解决方案，一步步来：

一、先搞清楚枚举查询慢的核心原因 #

从你的测试结果来看，直接用枚举值查询慢，转成字符串就快，大概率是参数类型不匹配导致的隐式转换问题：
你数据库里的SomeColumn是varchar(255)类型，但OrmLite默认可能把枚举参数以int类型传递给SQL Server了。这时候SQL Server需要把表中每一行的varchar值都隐式转换成int来和参数比较，这种转换会让列上的索引失效，触发全表扫描，自然就慢得离谱了。而用ToString()查询时，参数和列类型都是字符串，能正常走索引，所以速度正常。

二、如何获取OrmLite实际执行的SQL及参数细节 #

你之前只看到@1、@2这类占位符，看不到参数类型和值，可以用这几种方法：

1. 启用DebugSql全局输出
   在你的应用启动代码里加上这句，控制台会打印所有执行的SQL语句和对应的参数详情：

OrmLiteConfig.DebugSql = true;

2. 手动生成SQL并查看参数
   针对单个查询，你可以先构建查询表达式，再打印SQL和参数：

var query = db.From<YourEntity>()
              .Where(q => q.SomeColumn == YourEnum.Value);

// 打印带占位符的SQL
query.PrintSql();

// 遍历查看每个参数的名称、值和类型
foreach (var param in query.Params)
{
    Console.WriteLine($"参数名: {param.ParameterName}, 值: {param.Value}, 类型: {param.DbType}");
}

3. 获取最后执行的SQL和参数
   执行完查询后，调用这个方法可以拿到刚执行的SQL和对应的参数数组：

var results = db.Select(q => q.SomeColumn == YourEnum.Value);
var (sql, parameters) = db.GetLastSqlAndParams();
// 打印出来查看
Console.WriteLine($"SQL: {sql}");
foreach (var p in parameters)
{
    Console.WriteLine($"参数: {p}");
}

三、怎么获取查询的执行计划 #

你之前用SET STATISTICS PROFILE ON没拿到结果，是因为OrmLite的Select方法只返回查询数据，不会返回统计信息。推荐两种方法：

1. 在SSMS里手动测试
   先用上面的方法拿到准确的SQL和参数类型，然后在SSMS里：

• 按Ctrl+M开启「包括实际执行计划」
• 执行带正确参数的SQL（注意参数类型要和OrmLite传递的一致，比如如果是int类型参数，就写WHERE SomeColumn = 1；如果是字符串就写WHERE SomeColumn = 'EnumValue'）
• 查看执行计划，就能清楚看到是不是因为隐式转换导致了全表扫描

2. 用OrmLite直接获取执行计划XML
   可以通过执行SET SHOWPLAN_XML ON来获取执行计划的XML内容：

var query = db.From<YourEntity>()
              .Where(q => q.SomeColumn == YourEnum.Value);
var sql = query.ToSql();

// 执行查询获取计划
var planXml = db.SqlList<string>($"SET SHOWPLAN_XML ON; {sql}; SET SHOWPLAN_XML OFF;", query.Params);
// 把XML内容复制出来，在SSMS里打开就能看到可视化的执行计划
foreach (var line in planXml)
{
    Console.WriteLine(line);
}

四、下一步的正确解决步骤 #

1. 确认参数类型问题
   用上面的方法查看参数的DbType，如果确实是Int32而不是String，那就坐实了我们的猜测。

2. 修正枚举的映射规则
   既然数据库列是varchar，就要让OrmLite把枚举以字符串类型来处理，有两种方式：

• 全局配置（所有枚举都按字符串映射）：

OrmLiteConfig.DialectProvider.StringConverter.UseEnumStringConverter = true;

• 单个属性配置（只针对这个列）：
  在你的实体类属性上加上转换标记：

[ConvertUsing(typeof(EnumStringConverter))]
public YourEnum SomeColumn { get; set; }

3. 验证修复效果
   配置完成后，再执行原来的枚举查询，应该就能达到和ToString()版本一样的速度了。

备注：内容来源于stack exchange，提问作者Lennart Berg