waitfor 函数

在达到指定时间或时间间隔之前,或者指定语句至少修改或返回一行之前,阻止执行批处理、存储过程或事务。

主题链接图标 Transact-SQL 语法约定

语法

 
WAITFOR 
{
    DELAY 'time_to_pass' 
  | TIME 'time_to_execute' 
  | ( receive_statement ) [ , TIMEOUT timeout ]
}

备注

执行 WAITFOR 语句时,事务正在运行,并且其他请求不能在同一事务下运行。

WAITFOR 不更改查询的语义。如果查询不能返回任何行,WAITFOR 将一直等待,或等到满足 TIMEOUT 条件(如果已指定)。

不能对 WAITFOR 语句打开游标。

不能对 WAITFOR 语句定义视图。

如果查询超出了 query wait 选项的值,则 WAITFOR 语句参数不运行即可完成。有关该配置选项的详细信息,请参阅 query wait 选项。若要查看活动进程和正在等待的进程,请使用 sp_who。

每个 WAITFOR 语句都有与其关联的线程。如果对同一服务器指定了多个 WAITFOR 语句,可将等待这些语句运行的多个线程关联起来。SQL Server 将监视与 WAITFOR 语句关联的线程数,并在服务器开始遇到线程不足的问题时,随机选择其中部分线程以退出。

在保留禁止更改 WAITFOR 语句所试图访问的行集的锁的事务中,可通过运行包含 WAITFOR 语句的查询来创建死锁。如果可能存在上述死锁,则 SQL Server 会标识相应情况并返回空结果集。

参数

DELAY

可以继续执行批处理、存储过程或事务之前必须经过的指定时段,最长可为 24 小时。

'time_to_pass'

等待的时段。可以使用 datetime 数据可接受的格式之一指定 time_to_pass,也可以将其指定为局部变量。不能指定日期;因此,不允许指定 datetime 值的日期部分。

TIME

指定的运行批处理、存储过程或事务的时间。

'time_to_execute'

WAITFOR 语句完成的时间。可以使用 datetime 数据可接受的格式之一指定 time_to_execute,也可以将其指定为局部变量。不能指定日期;因此,不允许指定 datetime 值的日期部分。

receive_statement

有效的 RECEIVE 语句。

重要事项:
包含 receive_statement 的 WAITFOR 仅适用于 Service Broker 消息。有关详细信息,请参阅 RECEIVE (Transact-SQL)

 

 

TIMEOUT timeout

指定消息到达队列前等待的时间(以毫秒为单位)。

重要事项:
指定包含 TIMEOUT 的 WAITFOR 仅适用于 Service Broker 消息。有关详细信息,请参阅 RECEIVE (Transact-SQL)GET CONVERSATION GROUP (Transact-SQL)

 

 

示例

A. 使用 WAITFOR TIME

以下示例在晚上 10:20 (22:20) 执行存储过程 sp_update_job

 复制代码
USE msdb;
EXECUTE sp_add_job @job_name = 'TestJob';
BEGIN
    WAITFOR TIME '22:20';
    EXECUTE sp_update_job @job_name = 'TestJob',
        @new_name = 'UpdatedJob';
END;
GO

B. 使用 WAITFOR DELAY

以下示例在 2 小时的延迟后执行存储过程。

 复制代码
BEGIN
    WAITFOR DELAY '02:00';
    EXECUTE sp_helpdb;
END;
GO

C. 对 WAITFOR DELAY 使用局部变量

以下示例显示如何对 WAITFOR DELAY 选项使用局部变量。将创建一个存储过程,该过程将等待可变的时间段,然后将经过的小时、分钟和秒数信息返回给用户。

 复制代码
USE AdventureWorks;
GO
IF OBJECT_ID('dbo.time_delay','P') IS NOT NULL
    DROP PROCEDURE dbo.time_delay;
GO
CREATE PROCEDURE time_delay @DELAYLENGTH char(9)
AS
DECLARE @RETURNINFO varchar(255)
BEGIN
    WAITFOR DELAY @DELAYLENGTH
    SELECT @RETURNINFO = 'A total time of ' + 
        SUBSTRING(@DELAYLENGTH, 1, 2) +
        ' hours, ' +
        SUBSTRING(@DELAYLENGTH, 4, 2) + 
        ' minutes, and ' +
        SUBSTRING(@DELAYLENGTH, 7, 2) + 
        ' seconds ' +
        'has elapsed! Your time is up.';
    PRINT @RETURNINFO;
END;
GO
-- This next statement executes the time_delay procedure.
EXEC time_delay '00:00:10'
GO

下面是结果集: 

 复制代码
A total time of 00 hours, 00 minutes, and 10 seconds has elapsed. Your time is up.

请参阅

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值