【SQL Server】sp_executeSql

语法

sp_executesql [ @stmt = ] statement  
[   
  { , [ @params = ] N'@parameter_name data_type [ OUT | OUTPUT ][ ,...n ]' }   
     { , [ @param1 = ] 'value1' [ ,...n ] }  
]

参数

[ @stmt = ] statement
是包含 Transact-SQL 语句或批处理的 Unicode 字符串。 @stmt 必须是 Unicode 常量或 Unicode 变量。 不允许使用更复杂的 Unicode 表达式（例如使用 + 运算符连接两个字符串）。 不允许使用字符常量。 如果指定了 Unicode 常量，则必须使用 N作为前缀。例如，Unicode 常量 N “sp_who” 有效，但字符常量 “sp_who” 不是。 字符串的大小仅受可用数据库服务器内存限制。 在64位服务器上，字符串的大小限制为 2 GB，最大值为 **nvarchar (max) **。

@stmt 可以包含与变量名称格式相同的参数，例如： N’SELECT * FROM HumanResources.Employee WHERE EmployeeID = @IDParameter’
语句中包含的所有参数都必须在@param,@param1中定义

[ @params = ]
一个字符串，其中包含在执行语句中嵌入的所有参数的定义。字符串必须是 Unicode 常量或 Unicode 变量。 每个参数定义由参数名称和数据类型组成。n是表示附加参数定义的占位符。 必须在该语句中定义执行语句中指定的每个参数。如果 Transact-SQL执行语句中的语句或批处理不包含参数，则无需参数。该参数的默认值为 NULL。

[ @param1 = ]
参数字符串中定义的第一个参数的值。该值可以是 Unicode 常量，也可以是 Unicode 变量。对于执行语句中包含的每个参数，都必须提供一个参数值。如果 Transact-SQL 执行语句中的语句或批处理没有参数，则不需要这些值。

返回值

0-失败，非0-成功。

结果集

执行语句所返回的结果集。

示例

无参执行语句

DECLARE @executeSql nvarchar(max) = 'SELECT * FROM sysobjects WHERE id = OBJECT_ID(''Lane_EnPass_Recv'', ''U'')'

EXEC sp_executeSql @executeSql 

含参执行语句

DECLARE @tableName varchar(32) = 'Lane_EnPass_Recv'
DECLARE @executeSql nvarchar(max) = 'SELECT * FROM sysobjects WHERE id = OBJECT_ID(@tableName, ''U'')'

EXEC sp_executeSql @executeSql, N'@tableName varchar(32)', @tableName = @tableName

[ @param1 ]参数可以不用写在[ @param ]中定义的变量，直接使用外部变量，但要保证与内部定义的参数一一对应

含参执行语句输出变量值

DECLARE @id varchar(32)
DECLARE @tableName varchar(32) = 'Lane_EnPass_Recv'
DECLARE @executeSql nvarchar(max) = 'SELECT @id = id FROM sysobjects WHERE id = OBJECT_ID(@tableName, ''U'')'

EXEC sp_executeSql @executeSql, N'@id varchar(32) OUTPUT, @tableName varchar(32)', @id = @id OUTPUT, @tableName = @tableName

PRINT @id

[ OUT | OUTPUT ]
指示参数是输出参数。 text，ntext和image参数可用作输出参数，除非该过程是公共语言运行时 (CLR) 过程。 使用 OUTPUT 关键字的输出参数可以为游标占位符，CLR 过程除外。

相较于EXECUTE的有点

• 因为在 sp_executesql 字符串中，Transact-SQL 语句的实际文本在两次执行之间并未改变，所以查询优化器应该能将第二次执行中的 Transact-SQL 语句与第一次执行时生成的执行计划匹配。 因此，SQL Server 不必编译第二条语句。
• Transact-SQL 字符串只生成一次。
• 整数参数按其本身格式指定。 不需要转换为 Unicode。