WAITFOR (Transact-SQL)

發行項
05/04/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體

封鎖批次、預存程序或交易的執行，直到經過指定的時間或時間間隔，或直到指定的陳述式修改或傳回至少一個資料列為止。

Syntax

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

注意

若要檢視 SQL Server 2014 （12.x）和舊版的 Transact-SQL 語法，請參閱舊版檔。

引數

DELAY
這是在繼續執行批次、預存程序或交易之前，必須經過的指定時段，最多 24 小時。

'time_to_pass'
這是要等待的時間週期。您可以使用 datetime 資料格式來指定 time_to_pass，或將它指定成區域變數。不能指定日期，因此不接受 datetime 值的日期部分。 time_to_pass會格式化為 hh:mm[[:ss].mss]。

TIME
此時執行批次、預存程序或交易時的指定時間。

'time_to_execute'
這是 WAITFOR 陳述式完成的時間。您可以使用 datetime 資料格式來指定 time_to_execute，也可以將它指定成區域變數。不能指定日期，因此不接受 datetime 值的日期部分。 time_to_execute 會格式化為 hh:mm[[:ss].mss]，且可以選擇性地包含日期 1900-01-01。

receive_statement
這是有效的 RECEIVE 陳述式。

重要

含 receive_statement 的 WAITFOR 只適用於 Service Broker 訊息。如需詳細資訊，請參閱 RECEIVE (Transact-SQL)。

get_conversation_group_statement
這是有效的 GET CONVERSATION GROUP 陳述式。

重要

含 get_conversation_group_statement 的 WAITFOR 只適用於 Service Broker 訊息。如需詳細資訊，請參閱 GET CONVERSATION GROUP (Transact-SQL)。

TIMEOUT timeout
指定等待訊息到達佇列的時段 (以毫秒為單位)。

重要

指定 TIMEOUT 的 WAITFOR 只適用於 Service Broker 訊息。如需詳細資訊，請參閱 RECEIVE (Transact-SQL) 和 GET CONVERSATION GROUP (Transact-SQL)。

備註

當執行 WAITFOR 陳述式時，交易在執行中，在相同交易之下，不能執行其他要求。

實際的時間延遲可能與 time_to_pass、time_to_execute 或 timeout 中所指定時間不同，且會隨著伺服器的活動層級而異。為 WAITFOR 陳述式執行緒進行排程後，時間計數器便會啟動。如果伺服器處於忙碌狀態，執行緒可能不會立即排程，因此時間延遲可能比指定的時間還長。

WAITFOR 不會變更查詢的語意。如果查詢無法傳回任何資料列，WAITFOR 會永久等待，如果指定了 TIMEOUT，就會等到 TIMEOUT 到期。

在 WAITFOR 陳述式上，不能開啟資料指標。

在 WAITFOR 陳述式上，不能定義檢視。

當查詢超出 query wait 選項時，不需要執行，就能夠完成 WAITFOR 陳述式引數。如需組態選項的詳細資訊，請參閱設定 query wait 伺服器組態選項。若要查看使用中和等待中的處理序，請使用 sp_who。

每個 WAITFOR 陳述式都有一個相關聯的執行緒。如果在相同伺服器上指定了許多 WAITFOR 陳述式，可以將許多執行緒繫結起來，以等待執行這些陳述式。 SQL Server 會監視 WAITFOR 陳述式執行緒的數目，如果伺服器感到執行緒資源用盡，其會從這些執行緒中隨機選取要結束的執行緒。

您可以在也保留了鎖定以防止 WAITFOR 陳述式所存取之資料列集遭到改變的交易內，搭配 WAITFOR 執行查詢來建立死結。 SQL Server 會識別這些狀況，並在此類死結有可能存在時，傳回空的結果集。

警告

包括 WAITFOR 將會減緩 SQL Server 處理序的完成，並在應用程式內產生逾時訊息。必要時，請在應用程式層級調整連接的逾時設定。

範例

A. 使用 WAITFOR TIME

下列範例會在下午 10:20 (22:20) 執行 msdb 資料庫中的預存程序 sp_update_job。

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

下列範例會在延遲兩小時之後執行預存程序。

BEGIN  
    WAITFOR DELAY '02:00';  
    EXECUTE sp_helpdb;  
END;  
GO

C. 搭配本機變數來使用 WAITFOR DELAY

下列範例顯示如何搭配 WAITFOR DELAY 選項來使用本機變數。這預存程序會等待一陣可變的時段，再將經歷的時、分、秒數資訊傳回給使用者。

IF OBJECT_ID('dbo.TimeDelay_hh_mm_ss','P') IS NOT NULL  
    DROP PROCEDURE dbo.TimeDelay_hh_mm_ss;  
GO  
CREATE PROCEDURE dbo.TimeDelay_hh_mm_ss   
    (  
    @DelayLength char(8)= '00:00:00'  
    )  
AS  
DECLARE @ReturnInfo VARCHAR(255)  
IF ISDATE('2000-01-01 ' + @DelayLength + '.000') = 0  
    BEGIN  
        SELECT @ReturnInfo = 'Invalid time ' + @DelayLength   
        + ',hh:mm:ss, submitted.';  
        -- This PRINT statement is for testing, not use in production.  
        PRINT @ReturnInfo   
        RETURN(1)  
    END  
BEGIN  
    WAITFOR DELAY @DelayLength  
    SELECT @ReturnInfo = 'A total time of ' + @DelayLength + ',   
        hh:mm:ss, has elapsed! Your time is up.'  
    -- This PRINT statement is for testing, not use in production.  
    PRINT @ReturnInfo;  
END;  
GO  
/* This statement executes the dbo.TimeDelay_hh_mm_ss procedure. */  
EXEC TimeDelay_hh_mm_ss '00:00:10';  
GO

以下為結果集。

A total time of 00:00:10, in hh:mm:ss, has elapsed. Your time is up.

另請參閱

流程控制語言 (Transact-SQL)
datetime (Transact-SQL)
sp_who (Transact-SQL)