标签:des style blog http io os ar 使用 for
存储过程(stored procedure)有时也称为sproc。存储过程存储于数据库中而不是在单独的文件中,有输入参数、输出参数以及返回值等。
在数据库中,创建存储过程和创建其他对象的过程一样,除了它使用的AS关键字外。存储过程的基本语法如下:
CREATE PROCDUER|PROC <sproc name>
[<parameter name>[schema.]<data type>[VARYING][=<default value>][OUT [PUT]][,
[<parameter name>[schema.]<data type>[VARYING][=<default value>][OUT [PUT]][,
...]]
[WITH
RECOMPILE|ENCRYPTION|[EXECUTE AS {CALLER|SELF|OWNER|<‘user name‘>}]
[FOR REPLICATION]
AS
<code>|EXTERNAL NAME <assembly name>.<assembly class>
创建存储过程的代码如下:
USE Northwind
GO
CRREATE PROC spShippers
AS
SELECT * FROM Shippers
执行存储过程:
EXEC spShippers
当使用T-SQL编辑存储过程的时候,需要记住的是它完全取代了现存的存储过程。使用ALTER PROC和CREATE PROC的区别在于:
注意:
如果执行DROP,然后使用CREATE,这和使用ALTER PROC语句一样,几乎都能得到相同的效果,除了一个很重要的区别——如果使用DROP和CREATE,则需要完全重新建立权限,权限规定了可以使用以及不能使用存储过程的用户。
这个过程非常简单:
DROP PROC|PROCEDURE <sproc name>
声明参数需要以下2到4部分信息:
语法如下:
@parameter_name [AS] datatype[= default|NULL] [VARYING] [OUTPUT|OUT]
名称有一个简单的规则集合。首先,它必须以@开始。此外,命名规则除了不能有嵌套的空格外,它和SQL的命令规则是相同的。
数据类型可以使用SQL Server内置的或用户自定义的类型。
注意:
示例:
USE Northwind
GO
CREATE PROC spInsertShipper
@CompanyName NVARCHAR(40),
@Phone NVARCHAR(24)
AS
INSERT INTO Shippers
VALUES
(@CompanyName, @Phone)
可以使用这个新的存储过程来插入新的数据:
EXEC spInstertShipper ‘Speedy Shippers, Inc.‘, ‘(503)555-5566‘
因为并没有为任何参数提供默认值,所以需要提供两个参数。这意味着为了成功运行该存储工程,则必须提供两个参数。
1. 提供默认值
为了使参数是可选的,可以提供默认值。示例:
USE Northwind
GO
CREATE PROC spInsertShipperOptionalPhone
@CompanyName NVARCHAR(40),
@Phone NVARCHAR(24) = NULL
AS
INSERT INTO Shippers
VALUES (@CompanyName, @Phone)
重新发出命令,但是使用新的存储过程:
EXEC spInsertShipperOptionalPhone ‘Speedy Shippers, Inc‘
这次一切顺利,成功插入了新的纪录。
2. 创建输出参数
示例:
USE Northwind
GO
CREATE PROC spInsertOrder
@CustomerID NVARCHAR(5),
@EmployeeID INT,
@OrderDate DATETIME = NULL,
@RequiredDate DATETIME = NULL,
@ShippedDate DATETIME = NULL,
@ShipVia INT,
@Freight MONEY,
@ShipName NVARCHAR(40) = NULL,
@ShipAddress NVARCHAR(60) = NULL,
@ShipCity NVARCHAR(15) = NULL,
@ShipRegion NVARCHAR(15) = NULL,
@ShipPostalCode NVARCHAR(10) = NULL,
@ShipCountry NVARCHAR(15) = NULL,
@OrderID INT OUTPUT
AS
INSERT INTO Orders
VALUES
(
@CustomerID,
@EmployeeID,
@OrderDate,
@RequiredDate,
@ShippedDate,
@ShipVia,
@Freight,
@ShipName,
@ShipAddress,
@ShipCity,
@ShipRegion,
@ShipPostalCode,
@ShipCountry
)
SELECT @OrderID = @@IDENTITY
执行该存储过程的代码如下:
USE Northwind
GO
DECLARE @MyIdent INT
EXEC spInsertOrder
@CustomerID = ‘ALFKI‘,
@EmployeeID = 5,
@OrderDate = ‘5/1/1999‘
@ShipVia = 3,
@Freight = 5.00,
@OrderID = @MyIdenty OUTPUT
SELECT @MyIdent AS IdentityValue
SELECT OrderID, CustomerID, EmployeeID, OrderDate, ShipName
FROM Orders
WHERE OrderID = @MyIdent
需要注意以下几点:
T-SQL提供了大多数流控制语句的典型的选择,包括:
同样也有CASE语句,但是它没有像其他语言中预期的那种流控制级的能力。
IF...ELSE语句的实现方式和C是接近相同的。基本的语法如下:
IF <Boolean Expression>
<SQL statement> | BEGIN <code series> END
[ELSE
<SQL statement> | BEGIN <code series> END]
其中的表达式可以是取布尔值的任意表达式。
提示:
不恰当的使用NULL值是个常见的陷阱。例如经常会有如下错误出现:
IF @MyVar = NULL
在大多数系统上(遵循ANSI标准)这样的表达式永远都不会为真,并且为绕过所有的NULL值结束。想要判断一个值是否为空应该这样来写:
IF @MyVar IS NULL
不要忘记了NULL不等于任何值——甚至是NULL。不要使用"="而要使用"IS"。
DATEDIFF函数
DATEDIFF的语法如下:
DATEDIFF (<datepart>, <start date>, <end date>)
DATEDIFF可以比较日期型数据的任意部分,可以从年到毫秒。start date和end date参数是合法的日期表达式。datepart参数可以是下列的值:
datepart |
缩写 |
年 |
year, yy, yyyy |
季度 |
quarter,qq, q |
月 |
month, mm, m |
星期 |
week, dw, w |
日 |
day, dd, d |
时 |
hour, hh |
分 |
minute, mi, n |
秒 |
second, ss, s |
毫秒 |
millisecond, ms |
1. ELSE子句
注意:
结果返回值为NULL的表达式会被当作FALSE从而进入ELSE子句。也就是说,如果IF子句中的语句返回值为FALSE或者NULL,则执行ELSE子句中的语句。
2. 从DATETIME字段中截取时间
为了能截取日期信息,要么把日期分成多个部分,然后不带时间地进行重组,要么可以使用CONVERT函数,该函数能把它转换为不带时间的日期,并且也能把它转换回来。
CONVERT()原来是SQL Server中唯一一个用来在数据类型之间转换数据的方法。现在,CAST()复制了它的大部分功能,并且是兼容ANSI的。然而,CONVERT()还是有一些特殊的日期格式化处理的能力,这些是CAST所不具备的。
CONVERT的语法如下:
CONVERT (<target data type>, <expression to be converted>, <style>)
前两个参数简单明了,最后一个参数只应用于处理时期的时候,其目的是告诉SQL Server需要的日期格式。这些普通日期格式的示例包括1,这是美国mm/dd/yy格式的标准;以及12,这是ISO格式(yymmdd)。给任意的格式加上100会给日期模式加入整个世纪的时间(即年份用4位数表示,例如101样式为mm/dd/yyyy)。
例如,GETDATE函数类似于如下:
SELECT CONVERT(DATETIME, (CONVERT(VARCHAR, GETDATE(), 112))
这样会处理ANSI的日期格式并能再次转换回来。
3. 在存储过程中实现ELSE语句
USE Northwind
GO
ALTER PROC spInsertOrder
@CustomerID NVARCHAR(5),
@EmployeeID INT,
@OrderDate DATETIME = NULL,
@RequiredDate DATETIME = NULL,
@ShippedDate DATETIME = NULL,
@ShipVia INT,
@Freight MONEY,
@ShipName NVARCHAR(40) = NULL,
@ShipAddress NVARCHAR(60) = NULL,
@ShipCity NVARCHAR(15) = NULL,
@ShipRegion NVARCHAR(15) = NULL,
@ShipPostalCode NVARCHAR(10) = NULL,
@ShipCountry NVARCHAR(15) = NULL,
@OrderID INT OUTPUT
AS
DECLARE @InsertedOrderDate SMALLDATETIME
IF DATEDIFF(dd, @OrderDate, GETDATE()) > 7
SELECT @InsertedOrderDate = NULL
ELSE
SELECT @InsertedOrderDate =
CONVERT(DATETIME, CONVERT(VARCHAR, @OrderDate, 112))
INSERT INTO Orders
VALUES
(
@CustomerID,
@EmployeeID,
@OrderDate,
@RequiredDate,
@ShippedDate,
@ShipVia,
@Freight,
@ShipName,
@ShipAddress,
@ShipCity,
@ShipRegion,
@ShipPostalCode,
@ShipCountry
)
SELECT @OrderID = @@IDENTITY
4. 把代码分组为块
SQL Server提供了把代码分组为块的方法,可以认为这个块是属于一起的。这个块以BEGIN语句开始,然后直到END语句结束。块类似如下:
IF <expression>
BEGIN
Statement that executes if expression is TRUE
Additional statements
...
...
Still going with statements from TRUE expression
IF <expression>
BEGIN
Statement that executes if both outside and inside expression is true
Additional statements
...
...
Still statements from both TRUE expressions
END
Out of the condition from inner condition, but still part of first block
END
ELSE
BEGIN
Statement that executes if expression is FALSE
Additional statements
...
...
Still going with statements from FLASE expression
END
现在可以修改订单插入的存储过程如下:
USE Northwind
GO
ALTER PROC spInsertOrder
@CustomerID NVARCHAR(5),
@EmployeeID INT,
@OrderDate DATETIME = NULL,
@RequiredDate DATETIME = NULL,
@ShippedDate DATETIME = NULL,
@ShipVia INT,
@Freight MONEY,
@ShipName NVARCHAR(40) = NULL,
@ShipAddress NVARCHAR(60) = NULL,
@ShipCity NVARCHAR(15) = NULL,
@ShipRegion NVARCHAR(15) = NULL,
@ShipPostalCode NVARCHAR(10) = NULL,
@ShipCountry NVARCHAR(15) = NULL,
@OrderID INT OUTPUT
AS
DECLARE @InsertedOrderDate SMALLDATETIME
IF DATEDIFF(dd, @OrderDate, GETDATE()) > 7
BEGIN
SELECT @InsertedOrderDate = NULL
PRINT ‘Invalid Order Date‘
PRINT ‘Supplied Order Date was greater than 7 days old.‘
PRINT ‘The value has been reset to NULL‘
ELSE
BEGIN
SELECT @InsertedOrderDate =
CONVERT(DATETIME, CONVERT(VARCHAR, @OrderDate, 112))
PRINT ‘The time of Day in Order Date was truncated‘
END
INSERT INTO Orders
VALUES
(
@CustomerID,
@EmployeeID,
@OrderDate,
@RequiredDate,
@ShippedDate,
@ShipVia,
@Freight,
@ShipName,
@ShipAddress,
@ShipCity,
@ShipRegion,
@ShipPostalCode,
@ShipCountry
)
SELECT @OrderID = @@IDENTITY
CASE语句在某种程度上与一些编程语言中的一些不同语句是等价的。例如:
在T-SQL中使用CASE语句的一个很大的缺点是:在很多方面,它更像替换运算符而非流控制语句。编写CASE语句的方式不只一种——可以使用输入表达式或者布尔表达式。第一种方法是使用一个输入表达式来与每个WHEN子句中用到的值进行比较。SQL Server文档把这种方法称为简单CASE:
CASE <input expression>
WHEN <when expression> THEN <result expression>
[...n]
[ELSE <result expression>]
END
第二种方法将提供一个表达式,其中每个WHEN子句的值将为TRUE或者FALSE。相关文档把它称为搜索CASE:
CASE
WHEN <Boolean expression> THEN <result expression>
[...n]
[ELSE <result expression>]
END
可以使用CASE语句最好的方式是把它与SELECT语句放一起使用。
1. 简单CASE
简单CASE使用结果等于布尔值的表达式。示例:
USE Northwind
GO
SELECT TOP 10 OrderID, OrderID % 10 AS ‘Last Digit‘, Position =
CASE OrderID % 10
WHEN 1 THEN ‘First‘
WHEN 2 THEN ‘Second‘
WHEN 3 THEN ‘Third‘
WHEN 4 THEN ‘Fourth‘
ELSE ‘Something Else‘
END
FROM Orders
2. 搜索CASE
搜索CASE语句和简单CASE语句非常相同,它只有两个很细微的不同点:
示例:
USE Northwind
GO
SELECT TOP 10 OrderID % 10 AS "Last Digit", ProductID, "How Close?" =
CASE
WHEN (OrderID % 10) < 3 THEN ‘Ends with less than three‘
WHEN ProductID = 6 THEN ‘ProductID is 6‘
WHEN ABS(OrderID % 10 - ProductID) <= 1 THEN ‘Within 1‘
ELSE ‘More than one apart‘
END
FROM OrderDetails
WHERE ProductID < 10
ORDER BY OrderID DESC
注意SQL Server求值的工作方式:
示例:
USE Northwind
GO
CREATE PROC spMarkupTest
@MarkupAsPercent MONEY
AS
DECLARE @Multiplier MONEY
SELECT @Multiplier = @MarkupAsPerent / 100 + 1
SELECT TOP 10 ProductID, ProductName, UnitPrice,
UnitPrice * @Multiplier AS "Markuped Up Price",
"New Price" =
CASE
WHEN FLOOR(UnitPrice * @Multiplier + .24) >
FLOOR(UnitPrice * @Multiplier)
THEN FLOOR(UnitPrice * @Multiplier) + .95
WHEN FLOOR(UnitPrice * @Multiplier + .5) >
FLOOR(UnitPrice * @Multiplier)
THEN FLOOR(UnitPrice * @Multiplier) + .75
ELSE FLOOR(UnitPrice * @Multiplier) + .49
END
FROM Products
ORDER BY ProductID DESC
执行该存储过程:
EXEC spMarkupTest 10
语法如下:
WHILE <boolean expression>
<sql statement> |
[BEGIN
<statement block>
[BREAK]
<sql statement>|<statement block>
[CONTINUE[
END]
在WHILE语句中必须跟上BEGIN...END,其中包含整个语句块。
使用WAITFOR语句可以让SQL Server来做等待工作。它的语法也很简单:
WAITFOR DELAY <time>
WAITFOR TIME <time>
1. DELAY参数
DELAY参数指定等待的总时间。但是不能指定天数,而只能是小时、分钟和秒数。允许延时的最大值为24小时。示例:
WAITFOR DELAY ‘01:00‘
将会等待一个小时,之后再运行WAITFOR后面的代码。
2. TIME参数
TIME参数指定了需要等待的具体的时间。同样,不能指定日期作为参数,而只能是24小时内的时间。例如:
WAITFOR TIME ‘01:00‘
将会等到凌晨1点,之后再运行WAITFOR后面的代码。
简而言之,如果代码没有任何类型的异常,或者错误级别是10或者10以下的话,则会根据TRY块执行代码。但是,一旦代码出现的错误超过了10(11或者更高)的话,则会马上转移到CATCH块中来。
返回值指示了存储过程的成功或者失败,甚至是成功或失败的范围或属性。
事实上,不管是否提供返回值,程序都会收到一个返回值。SQL Server默认地会在完成存储过程时自动返回一个0值。
为了从存储过程向调用代码返回值,只需要使用RETURN语句:
RETURN [<integer value to return>]
注意:
返回值必须是整数。
RETURN语句是无条件地从存储过程中退出的。
示例:
USE Northwind
GO
CREATE PROC spTestReturns
AS
DECLARE @MyMessage VARCHAR(50)
DECLARE @MyOtherMessage VARCHAR(50)
SELECT @MyMessage = ‘Hi, it‘‘s that line before the RETURN‘
PRINT @MyMessage
RETURN
SELECT @MyOtherMessage = ‘Sorry, but we won‘‘t get this far‘
PRINT @MyOtherMessage
RETURN
为了能获取RETURN语句的值,需要在EXEC语句中把值赋给变量。
DECLARE @Return INT
EXEC @Return = spTestReturns
SELECT @Return
直接RETURN会默认返回0,需要返回其他整数可以直接写RETURN <integer>。
在SQL Server中可能会发生3种常见的错误类型:
以前的方式需要在代码中监视错误的条件,然后决定在检测到错误的时候(很可能是在发生实际错误过后)要做的处理。
1. 处理内联的错误
内联错误是指那些能在SQL Server中继续运行,但是因为某种原因而不能成功完成指定任务的错误。例如,违反外键约束的插入。SQL Server会拒绝执行该语句并输出错误信息,但不会终止代码运行。
例如:
USE Northwind
GO
INSERT INTO OrderDetails
(OrderID, ProductID, UnitPrice, Quantity, Discount)
VALUES
(999999, 11, 10.00, 0)
SQL Server会拒绝执行该插入,并输出错误信息:
Msg 547, Level 16, State 0, Line 2
The INSERT statement conflicted with the FOREIGN KEY constraint
"FK_Order_Details_Orders".The conflict occurred in database "Northwind", table
"Orders", column ‘OrderID‘.
The statement has been terminated.
注意上面的547错误——这是我们可以利用的错误。
2. 利用@@ERROR
@@ERROR包含了最后的T-SQL语句执行的错误号。如果该值为0,则表示没有发生错误。
说明:
每个新语句都会使@@ERROR复位。
示例:
USE Northwind
GO
DECLARE @Error INT
INSERT INTO OrderDetails
(OrderID, ProductID, UnitPrice, Quantity, Discount)
VALUES
(999999, 11, 10.00, 0)
SELECT @Error = @@ERROR
PRINT ‘‘
PRINT ‘The Value of @Error is ‘ + CONVERT(VARCHAR, @Error)
PRINT ‘The Value of @@ERROR is ‘ + CONVERT(VARCHAR, @@ERROR)
返回结果:
Msg 547, Level 16, State 0, Line 2
The INSERT statement conflicted with the FOREIGN KEY constraint
"FK_Order_Details_Orders".The conflict occurred in database "Northwind", table
"Orders", column ‘OrderID‘.
The statement has been terminated.
The Value of @Error is 547
The Vaule of @@ERROR is 0
3. 在存储过程中使用@@ERROR
USE Northwind
GO
ALTER PROC spInsertOrder
@CustomerID NVARCHAR(5),
@EmployeeID INT,
@OrderDate DATETIME = NULL,
@RequiredDate DATETIME = NULL,
@ShippedDate DATETIME = NULL,
@ShipVia INT,
@Freight MONEY,
@ShipName NVARCHAR(40) = NULL,
@ShipAddress NVARCHAR(60) = NULL,
@ShipCity NVARCHAR(15) = NULL,
@ShipRegion NVARCHAR(15) = NULL,
@ShipPostalCode NVARCHAR(10) = NULL,
@ShipCountry NVARCHAR(15) = NULL,
@OrderID INT OUTPUT
AS
DECLARE @InsertedOrderDate SMALLDATETIME
DECLARE @Error INT
IF DATEDIFF(dd, @OrderDate, GETDATE()) > 7
BEGIN
SELECT @InsertedOrderDate = NULL
PRINT ‘Invalid Order Date‘
PRINT ‘Supplied Order Date was greater than 7 days old.‘
PRINT ‘The value has been reset to NULL‘
ELSE
BEGIN
SELECT @InsertedOrderDate =
CONVERT(DATETIME, CONVERT(VARCHAR, @OrderDate, 112))
PRINT ‘The time of Day in Order Date was truncated‘
END
INSERT INTO Orders
VALUES
(
@CustomerID,
@EmployeeID,
@OrderDate,
@RequiredDate,
@ShippedDate,
@ShipVia,
@Freight,
@ShipName,
@ShipAddress,
@ShipCity,
@ShipRegion,
@ShipPostalCode,
@ShipCountry
)
SELECT @Error = @@ERROR
IF @Error != 0
BEGIN
IF @Error = 547
BEGIN
PRINT ‘Supplied data violates data integrity rules‘
PRINT ‘Check that the supplied customer number exists‘
PRINT ‘in the system and try again‘
END
ELSE
BEGIN
PRINT ‘An unknown error occurred. Contact your System
PRINT ‘Administrator. The error was number ‘ +
CONVERT(VARCHAR, @Error)
END
RETURN @Error
END
SELECT @OrderID = @@IDENTITY
调用:
USE Northwind
GO
DECLARE @MyIdent INT
DECLARE @MyDate SMALLDATETIME
DECLARE @Return INT
SELECT @MyDate = GETDATE()
EXEC @Return = spInsertDateValidatedOrder
@CustomerID = ‘ZXZXZ‘,
@EmployeeID = 5,
@OrderDate = @MyDate,
@ShipVia = 3,
@Freight = 5.00,
@OrderID = @MyIdent OUTPUT
IF @Return = 0
SELECT OrderID, CustomerID, EmployeeID, OrderDate, ShipName
FROM Orders
WHERE OrderID = @MyIdent
ELSE
PRINT ‘Value Returned was ‘ + CONVERT(VARCHAR, @Return)
SQL Server中的TRY/CATCH块与C系列语言类似,语法如下:
BEGIN TRY
{<sql statements>}
END TRY
BEGIN CATCH
{<sql statements>}
END CATCH
正如之前提到过,0~10的错误不会跳出TRY语句块,11~19之间的错误会立即跳出TRY语句块,进入CATCH语句块中。
再一次改写spInsertDateValidateOrder如下:
…
…
ELSE
BEGIN
SELECT @InsertedOrderDate =
CONVERT(datetime,(CONVERT(varchar,@OrderDate,112)))
PRINT ‘The Time of Day in Order Date was truncated‘
END
/* Establish our TRY/CATCH Block */
BEGIN TRY
/* Create the new record */
INSERT INTO Orders
VALUES
(
@CustomerID,
@EmployeeID,
@InsertedOrderDate,
@RequiredDate,
@ShippedDate,
@ShipVia,
@Freight,
@ShipName,
@ShipAddress,
@ShipCity,
@ShipRegion,
@ShipPostalCode,
@ShipCountry
)
END TRY
BEGIN CATCH
-- Uh oh, something went wrong, see if it‘s something
-- we know what to do with
DECLARE @ErrorNo int,
@Severity tinyint,
@State smallint,
@LineNo int,
@Message nvarchar(4000)
SELECT
@ErrorNo = ERROR_NUMBER(),
@Severity = ERROR_SEVERITY(),
@State = ERROR_STATE(),
@LineNo = ERROR_LINE (),
@Message = ERROR_MESSAGE()
IF @ErrorNo = 547
-- The problem is a constraint violation. Print out some informational
-- help to steer the user to the most likely problem.
BEGIN
PRINT ‘Supplied data violates data integrity rules‘
PRINT ‘Check that the supplied customer number exists‘
PRINT ‘in the system and try again‘
END
ELSE
-- Oops, it‘s something we haven‘t anticipated, tell them that we
-- don‘t know, print out the error.
BEGIN
PRINT ‘An unknown error occurred. Contact your System Administrator‘
PRINT ‘The error was number ‘ + CONVERT(varchar, @Error)
END
-- Regardless of the error, we‘re going to send it back to the calling
-- piece of code so it can be handled at that level if necessary.
RETURN @Error
END CATCH
/* Move the identity value from the newly inserted record into
our output variable */
SELECT @OrderID = @@IDENTITY
RETURN
应用在TRY/CATCH中的几个专用函数:
函数 |
返回类型 |
返回值 |
ERROR_NUMBER() |
INT |
在CATCH块中调用时,返回导致运行CATCH块的错误消息的错误号。 如果在CATCH块作用域以外调用,则返回NULL。 |
ERROR_SEVERITY() |
INT |
在CATCH块中调用时,返回导致CATCH块运行的错误消息的严重级别。 如果在CATCH块作用域以外调用,则返回NULL。 |
ERROR_STATE() |
INT |
当在CATCH块中调用时,返回导致CATCH块运行的错误消息的状态号。 如果在CATCH块作用域以外调用,则返回NULL。 |
ERROR_PROCEDUER() |
NVARCHAR(126) |
在CATCH块中调用时,返回出现错误的存储过程名称。 如果该错误未在存储过程或触发器中出现,则返回NULL。 如果在CATCH块作用域以外调用,则返回NULL。 |
ERROR_LINE() |
INT |
当在CATCH块中调用时:
如果在CATCH块作用域以外调用,则返回NULL。 |
ERROR_MESSAGE |
NVARCHAR(2048) |
在CATCH块中调用时,返回导致CATCH块运行的错误消息的完整文本。该文本包括为所有可替换参数提供的值,如长度、对象名或时间。 如果在CATCH块作用域以外调用,则返回NULL。 |
SQL Server允许客户端创建一个运行时错误,客户端可以使用它来调用错误处理程序并采取相应的动作。此处使用T-SQL中的RAISERROR命令来完成。它的语法如下:
RAISERROR (<message ID | message string>, <severity>, <state>
[, <argument> [, <...n>]])
[WITH OPTION [, ...n]]
1. 消息ID/消息字符串
消息ID或消息字符串决定了向客户端发送的消息。
使用消息ID会手动地激活指定的ID以及和该ID相关信息的错误,这个信息可以在master数据库中的sysmessages表中找到。
提示:
如果想要了解SQL Server中预先确定的消息,那么可以执行SELECT * FROM master.sysMessages。这会包含使用sp_addmessage存储过程或通过Enterprise Manager手动添加到系统的任何消息。
可以以特殊文本的形式提供消息字符串,而不是在sysmessages中创建更持久的消息:
RAISERROR (‘Hi there, I‘‘m an error‘, 1, 1)
会激活一个简单的错误信息:
Msg 50000, Level 1, State 50000
Hi there, I‘m an error
注意一下对齐的消息号是50000,即使我们并没有提供它。这是对任何特别错误的默认错误值。可以使用WITH SETERROR选项来重写它。
2. 严重性
严重性是基于该错误究竟有多差的指标。可是对于SQL Server,严重性代码的意义有些古怪。它们基本上可以从报告性的(严重性1~18)、到系统级的(19~25)甚至是灾难性的(20~25)。如果激活错误的严重性是19或更高的话(系统级的),那么也必须要指定WITH LOG选项。20以及更高级别会自动终止用户的连接。
1~9 |
纯报告性的,但是会在消息中返回一个特定的错误代码。无论在RAISERROR中设置何种状态,它总会以相同的错误号结束。 |
10 |
同样是报告性的,但是不会在客户端激活一个错误而且除了错误文本外,不会提供任何特定错误信息。 |
11~16 |
这些都会终止存储过程的执行并在客户端激活一个错误。根据这点,会根据任何设定的状态值去显示状态。 |
17 |
通常只有SQL Server会使用这个严重性。它基本上只是SQL Server用完了资源而且不能完成请求。 |
18、19 |
这些都是非常严重的错误,而且暗示系统管理员要注意其中根本的原因。对于19来说,需要使用WITH LOG选项,并且如果使用NT或者Win 2K家族的操作系统,则该事件会写入它们的事件日志中去。 |
20~25 |
本质上讲,它们是致命的错误,会终止连接。 |
3. 状态
状态是个特殊的值。它会认出相同的错误会在代码中多次出现。这个概念给予了发送位置标记的机会,这个位置正好是发生错误的地方。状态值可以在1到127之间。
4. 错误参数
一些预先确定的错误会接受参数。这通过改变错误特有的性质来使错误在本质上更加的动态化。也可以格式化错误信息来接收参数。
动态信息通过使用占位符来完成。所有的占位符以%开始,而且根据传递的信息类别对它们进行编码:
占位符类型指示符 |
类型值 |
D或i |
带符号整数 |
O |
无符号八进制数 |
P |
指针 |
S |
字符串 |
U |
无符号整数 |
X或x |
无符号十六进制数 |
另外,还可以使用一些额外的标记和宽度信息来作为任何这些占位符的前缀:
标记 |
作用 |
- |
左调整——只在确定宽度的时候起作用 |
+ |
如果符号是带符号的数据类型,则指示参数为正或为负 |
0 |
在数值类型值的左边填充0直到达到了在宽度选项中指定的宽度 |
# |
只用于八进制和十六进制。根据是八进制还是十六进制来使用适当的前缀(0或0x) |
空格 |
如果数值为正,则在该值的左边填入空格 |
宽度 |
设定想要为参数所保留的空间,指定"*"来自动地确定宽度 |
精度 |
设定输出的数值型数据的最大位数 |
长/短 |
当参数类型为整数、八进制或十六进制时,使用h(short)或l(long)来设定。 |
5. WITH OPTION选项
现有三个选项可供使用:
WITH LOG
这会告诉SQL Server在SQL Server错误日志和NT应用程序日志中记录错误。这个选项需要的严重性级别要在19或19以上。
WITH SETERROR
默认地,RAISERROR命令不会给@@ERROR设置所产生的错误值——而@@ERROR反映了实际RAISERROR命令是成功或失败的。SETERROR重写了这个值并且把@@ERROR的值设为等于自己错误ID的值。
WITH NOWAIT
立即向客户通知错误。
可以使用系统存储过程来向系统添加错误消息。这个存储过程称为sp_addmessage,语法如下:
sp_addmessage [@msgnum = ] <msg id>,
[@severity =] <severity>,
[@msgtest =] <‘msg‘>
[, [@lang =] <‘language‘>]
[, [@with_log =] [TRUE | FALSE]]
[, [@replace =] ‘replace‘]
除了@lang、@replace和@with_log有一点区别外,其他参数的含义与RAISERROR中是一样的。
1. @lang
这个参数指定了消息应用的语言。这里可以指定消息为任何语言的版本,只要在syslanguages中支持这些语言。
2. @with_log
它和RAISERROR中的原理一样。
3. @replace
如果是编辑现有的信息而非创建一个新消息的话,那么必须把@replace参数设置为"REPLACE"。如果不这样做,那么如果消息已经存在,则会得到一个错误。
4. 使用sp_addmessage
示例——添加自定义的消息来告诉告诉用户关于订购日期的问题:
sp_addmessage
@msgnum = 60000
@severity = 10
@msgtest = ‘%s is not a valid Order data. Order date must be within 7 days for current date.‘
5. 删除已有的自定义消息
要删除自定义消息,请使用:
sp_dropmessage <msg num>
原文转自:http://www.cnblogs.com/qwertWZ/archive/2013/04/22/3036829.html
标签:des style blog http io os ar 使用 for
原文地址:http://www.cnblogs.com/xm925/p/4043897.html