SqlBinder调用GetSql()时表变量被擦除 如何声明使用表变量

问题原因 #

这个现象是SqlBinder的默认参数识别规则导致的：库默认会全局扫描SQL脚本中所有@开头的标识符，将其判定为待绑定的参数占位符，在调用.GetSql()执行参数替换逻辑时，未被加入参数集合的@LOCAL_TABLEVARIABLE会被误识别为未赋值参数直接擦除，最终就会出现只剩DECLARE TABLE的异常输出。

可用解决方法 #

• 转义表变量标识符
  SqlBinder兼容T-SQL原生的方括号标识符包裹规则，对于不需要作为参数处理的@开头变量，用方括号包裹后就不会被参数扫描逻辑识别。修改后的声明写法如下，该写法完全符合SQL Server语法规范，不会影响脚本正常执行：

  DECLARE [@LOCAL_TABLEVARIABLE] TABLE
  (
      ColumnName BIGINT
  );
  

• 关闭自动全局参数扫描
  如果不想修改原始SQL脚本，可以在构建查询时关闭当前SqlBinder实例的自动参数识别功能，仅手动注册需要绑定的业务参数。此时库不会全局扫描替换所有@开头的字符串，只会处理你手动添加的参数项，自然不会误擦除脚本内的表变量声明。

注意：表变量是SQL脚本上下文内的临时结构，不属于外部传入的SQL参数，不要将表变量名加入SqlBinder的参数绑定列表，否则依然会触发替换逻辑。

内容的提问来源于stack exchange，提问作者Alex Zaitsev