sp_executesql (Transact-SQL)
2014-03-16 21:57
375 查看
SQL Server 2005 联机丛书 | |
sp_executesql (Transact-SQL) | 发送反馈 |
请参阅 |
全部折叠全部展开 语言筛选器: 全部语言筛选器: 多语言语言筛选器: Visual Basic语言筛选器: C#语言筛选器: C++语言筛选器: J#语言筛选器: JScript |
系统存储过程 (Transact-SQL) > 数据库引擎存储过程 (Transact-SQL) > |
C#
C++
J#
JScript
执行可以多次重复使用或动态生成的 Transact-SQL 语句或批处理。Transact-SQL 语句或批处理可以包含嵌入参数。
Transact-SQL 语法约定
语法
sp_executesql [ @stmt = ] stmt [ {, [@params=] N'@parameter_name data_type [ [ OUT [ PUT ][,...n]' } {, [ @param1 = ] 'value1' [ ,...n ] } ] |
备注
在批处理、名称作用域和数据库上下文方面,sp_executesql 与 EXECUTE 的行为相同。sp_executesql stmt 参数中的 Transact-SQL 语句或批处理在执行 sp_executesql 语句时才编译。随后,将编译 stmt 中的内容,并将其作为执行计划运行。该执行计划独立于名为 sp_executesql 的批处理的执行计划。sp_executesql 批处理不能引用调用 sp_executesql 的批处理中声明的变量。sp_executesql 批处理中的本地游标或变量对调用sp_executesql 的批处理是不可见的。对数据库上下文所作的更改只在 sp_executesql 语句结束前有效。
如果只更改了语句中的参数值,则 sp_executesql 可用来代替存储过程多次执行 Transact-SQL 语句。因为 Transact-SQL 语句本身保持不变,仅参数值发生变化,所以 SQL Server 查询优化器可能重复使用首次执行时所生成的执行计划。
注意: |
---|
如果语句字符串中的对象名不是完全限定名,则该执行计划不会被重复使用。 |
复制代码 | |
---|---|
DECLARE @IntVariable int; DECLARE @SQLString nvarchar(500); DECLARE @ParmDefinition nvarchar(500); /* Build the SQL string one time.*/ SET @SQLString = N'SELECT * FROM AdventureWorks.HumanResources.Employee WHERE ManagerID = @ManagerID'; SET @ParmDefinition = N'@ManagerID tinyint'; /* Execute the string with the first parameter value. */ SET @IntVariable = 197; EXECUTE sp_executesql @SQLString, @ParmDefinition, @ManagerID = @IntVariable; /* Execute the same string with the second parameter value. */ SET @IntVariable = 109; EXECUTE sp_executesql @SQLString, @ParmDefinition, @ManagerID = @IntVariable; |
AdventureWorks.HumanResources.Employee表中检索名称,并将其返回在输出参数中。
复制代码 | |
---|---|
DECLARE @IntVariable int; DECLARE @SQLString nvarchar(500); DECLARE @ParmDefinition nvarchar(500); DECLARE @max_title varchar(30); SET @IntVariable = 197; SET @SQLString = N'SELECT @max_titleOUT = max(Title) FROM AdventureWorks.HumanResources.Employee WHERE ManagerID = @level'; SET @ParmDefinition = N'@level tinyint, @max_titleOUT varchar(30) OUTPUT'; EXECUTE sp_executesql @SQLString, @ParmDefinition, @level = @IntVariable, @max_titleOUT=@max_title OUTPUT; SELECT @max_title; |
因为在 sp_executesql 字符串中,Transact-SQL 语句的实际文本在两次执行之间并未改变,所以查询优化器应该能将第二次执行中的 Transact-SQL 语句与第一次执行时生成的执行计划匹配。因此,SQL Server 不必编译第二条语句。
Transact-SQL 字符串只生成一次。
整数参数按其本身格式指定。不需要转换为 Unicode。
参数
[ @stmt = ] stmt包含 Transact-SQL 语句或批处理的 Unicode 字符串。stmt 必须是可以隐式转换为 ntext 的 Unicode 常量或变量。不允许使用更复杂的 Unicode 表达式(例如使用 + 运算符连接两个字符串)。不允许使用字符常量。如果指定常量,则必须使用 N 作为前缀。例如,Unicode 常量 N'sp_who' 是有效的,但是字符常量 'sp_who' 则无效。字符串的大小仅受可用数据库服务器内存限制。
注意: |
---|
在 64 位服务器上,字符串大小受 nvarchar(max) 大小的限制。 |
注意: |
---|
stmt 可以包含与变量名形式相同的参数,例如: N'SELECT * FROM HumanResources.Employee WHERE EmployeeID = @IDParameter' |
[ @params = ] N'@parameter_name data_type [ ,... n ] '
包含 stmt 中嵌入的所有参数定义的字符串。该字符串必须是可隐式转换为 ntext 的 Unicode 常量或变量。每个参数定义由参数名称和数据类型组成。n 是表示附加参数定义的占位符。在 stmt 中指定的每个参数必须在 @params 中定义。如果 stmt 中的 Transact-SQL 语句或批处理不包含参数,则不需要 @params。该参数的默认值为 NULL。
[ @param1 = ] 'value1'
参数字符串中定义的第一个参数的值。该值可以是常量或变量。必须为 stmt 中包含的每个参数提供参数值。如果 stmt 中的 Transact-SQL 语句或批处理没有参数,则不需要这些值。
OUTPUT
指示该参数是输出参数。除非此过程是公共语言运行时 (CLR) 过程,否则 text、ntext 和 image 参数可用作 OUTPUT 参数。使用 OUTPUT 关键字的输出参数可以为游标占位符,CLR 过程除外。
n
附加参数值的占位符。这些值只能为常量或变量,不能是很复杂的表达式(例如函数)或使用运算符生成的表达式。
返回代码值
0(成功)或非零(失败)结果集
从生成 SQL 字符串的所有 SQL 语句返回结果集。权限
要求具有 public 角色的成员身份。示例
A. 执行简单的 SELECT 语句
以下示例将创建并执行一个简单的SELECT语句,其中包含名为
@level的嵌入参数。
复制代码 | |
---|---|
EXECUTE sp_executesql N'SELECT * FROM AdventureWorks.HumanResources.Employee WHERE ManagerID = @level', N'@level tinyint', @level = 109; |
B. 执行动态生成的字符串
以下示例显示使用 sp_executesql 执行动态生成的字符串。该示例中的存储过程用于向一组表中插入数据,这些表用于划分一年的销售数据。一年中的每个月均有一个表,格式如下:复制代码 | |
---|---|
CREATE TABLE May1998Sales (OrderID int PRIMARY KEY, CustomerID int NOT NULL, OrderDate datetime NULL CHECK (DATEPART(yy, OrderDate) = 1998), OrderMonth int CHECK (OrderMonth = 5), DeliveryDate datetime NULL, CHECK (DATEPART(mm, OrderDate) = OrderMonth) ) |
每个表的名称由月份名的前三个字母、年度的四位数字和常量
Sales组成。表名可以从订单日期动态生成。
复制代码 | |
---|---|
/* Get the first three characters of the month name. */ SUBSTRING( DATENAME(mm, @PrmOrderDate), 1, 3) + /* Concatenate the four-digit year; cast as character. */ CAST(DATEPART(yy, @PrmOrderDate) AS CHAR(4) ) + /* Concatenate the constant 'Sales'. */ 'Sales' |
INSERT语句,以便向正确的表中插入新订单。此示例使用订单日期生成应包含数据的表的名称,然后将此名称并入
INSERT语句中。
注意: |
---|
这是一个简单的 sp_executesql 示例。该示例不包含错误检查以及业务规则检查,如确保订单号在各个表之间不重复。 |
复制代码 | |
---|---|
CREATE PROCEDURE InsertSales @PrmOrderID INT, @PrmCustomerID INT, @PrmOrderDate DATETIME, @PrmDeliveryDate DATETIME AS DECLARE @InsertString NVARCHAR(500) DECLARE @OrderMonth INT -- Build the INSERT statement. SET @InsertString = 'INSERT INTO ' + /* Build the name of the table. */ SUBSTRING( DATENAME(mm, @PrmOrderDate), 1, 3) + CAST(DATEPART(yy, @PrmOrderDate) AS CHAR(4) ) + 'Sales' + /* Build a VALUES clause. */ ' VALUES (@InsOrderID, @InsCustID, @InsOrdDate,' + ' @InsOrdMonth, @InsDelDate)' /* Set the value to use for the order month because functions are not allowed in the sp_executesql parameter list. */ SET @OrderMonth = DATEPART(mm, @PrmOrderDate) EXEC sp_executesql @InsertString, N'@InsOrderID INT, @InsCustID INT, @InsOrdDate DATETIME, @InsOrdMonth INT, @InsDelDate DATETIME', @PrmOrderID, @PrmCustomerID, @PrmOrderDate, @OrderMonth, @PrmDeliveryDate GO |
请参阅
参考
EXECUTE (Transact-SQL)系统存储过程 (Transact-SQL)
其他资源
批处理运行时生成语句
帮助和信息
获取 SQL Server 2005 帮助文档反馈
Microsoft 非常重视您的反馈。若要对该主题分级并将对该主题的反馈发送到文档编写组,请单击一个分级,再单击“发送反馈”。要想获得有关支持方面的问题的协助,请参阅包含在该产品中的技术支持信息。
不好 | 1 | 2 | 3 | 4 | 5 | 出色 |
(C) 2005 Microsoft Corporation。保留所有权利。
相关文章推荐
- sp_executesql (Transact-SQL) from MSDN
- sp_executesql (Transact-SQL)
- Transact-SQL 参考 sp_executesql
- Transact-SQL 参考之sp_executesql
- 执行动态 sql 并为 输出参数赋值、sp_executesql 使用方法
- 关于sp_executesql与exec执行动态sql的区别--转载RascallySnake
- 官方示例:Sql语句输出参数sp_executesql
- 动态sql语句的执行(sp_executesql)
- 用sp_executesql执行设计期不确定的SQL语句
- 执行带嵌入参数的sql——sp_executesql
- 执行动态 sql 并为 输出参数赋值、sp_executesql 使用方法
- sp_update_job (Transact-SQL) 更改作业的属性
- 【SQL-码农】sp_spaceused (Transact-SQL)
- 执行带参数的SQL, sp_executesql
- SQL SP_EXECUTESQL
- 执行带嵌入参数的sql——sp_executesql
- 执行动态 sql 并为 输出参数赋值、sp_executesql 使用方法
- sqlserver中sp_executesql使用实例(获取动态sql输出结果)
- SQL Server sp_executesql介绍和使用
- sp_add_jobschedule (Transact-SQL) 创建作业计划