ALTER QUEUE (Transact-SQL)

發行項
12/15/2008

變更佇列屬性。

語法

ALTER QUEUE <object> WITH
   [ STATUS = { ON | OFF } [ , ] ]
   [ RETENTION = { ON | OFF } [ , ] ]
   [ ACTIVATION (
       { [ STATUS = { ON | OFF } [ , ] ] 
         [ PROCEDURE_NAME = <procedure> [ , ] ]
         [ MAX_QUEUE_READERS = max_readers [ , ] ]
         [ EXECUTE AS { SELF | 'user_name'  | OWNER } ]
       |  DROP }
          ) ] 
[ ; ]

<object> ::=
{
    [ database_name. [ schema_name ] . | schema_name. ]
        queue_name
} 

<procedure> ::=
{
    [ database_name. [ schema_name ] . | schema_name. ]
        stored_procedure_name
}

引數

database_name(object)
這是要變更之佇列所在的資料庫名稱。若未提供 database_name，預設為目前的資料庫。

schema_name (object)
這是新佇列所屬的結構描述名稱。若未提供 schema_name，預設為目前使用者的預設結構描述。

queue_name
這是要變更的佇列名稱。

STATUS (Queue)
指定佇列是可以使用 (ON) 或無法使用 (OFF)。當佇列無法使用時，不能將訊息加入佇列或從佇列中移除。

RETENTION
指定佇列的保留設定。如果 RETENTION = ON，使用這個佇列的交談所傳送或接收的所有訊息都會保留在佇列中，直到交談結束為止。這個選項可讓您保留訊息來進行稽核，或在錯誤發生時用來執行補償交易。

附註：

設定 RETENTION = ON 會降低效能。只有在必須符合應用程式的服務等級合約時，才應該使用這項設定。

附註：
設定 RETENTION = ON 會降低效能。只有在必須符合應用程式的服務等級合約時，才應該使用這項設定。

ACTIVATION
指定為了處理到達這個佇列的訊息而啟動之預存程序的相關資訊。

STATUS (Activation)
指定佇列是否啟動預存程序。當 STATUS = ON 時，如果目前執行的程序數目低於 MAX_QUEUE_READERS，且訊息到達佇列的速度比預存程序接收訊息快，佇列便會啟動 PROCEDURE_NAME 所指定的預存程序。當 STATUS = OFF 時，佇列不會啟動預存程序。

PROCEDURE_NAME = <procedure>
指定在佇列包含要處理的訊息時，將啟動的預存程序名稱。這個值必須是 SQL Server 識別碼。如需有關啟動的詳細資訊，請參閱＜Understanding When Activation Occurs＞。

database_name (procedure)
這是包含預存程序的資料庫名稱。

schema_name (procedure)
這是擁有預存程序的結構描述名稱。

stored_procedure_name
這是預存程序的名稱。

MAX_QUEUE_READERS = max_readers
指定佇列同時啟動的啟動預存程序的最大執行個體數目。max_readers 的值必須是在 0 和 32767 之間的數字。

EXECUTE AS
指定用來執行啟動預存程序的 SQL Server 資料庫使用者帳戶。當佇列啟動預存程序時，SQL Server 必須能夠檢查這個使用者的權限。如果是 Windows 網域使用者，SQL Server 必須連接這個網域，且在程序啟動或啟動失敗時，必須能夠驗證指定使用者的權限。如果是 SQL Server 使用者，伺服器一律可以檢查權限。

SELF
指定以目前使用者的身分來執行預存程序。(執行此 ALTER QUEUE 陳述式的資料庫主體)。

'user_name'
這是指定用來執行預存程序的使用者名稱。user_name 必須是指定為 SQL Server 識別碼的有效 SQL Server 使用者。目前的使用者必須擁有指定的 user_name 之 IMPERSONATE 權限。

OWNER
指定以佇列擁有者的身分來執行預存程序。

DROP
刪除與佇列相關聯的所有啟動資訊。

備註

當含有指定的啟動預存程序之佇列包含訊息時，將啟動狀態 OFF 改成 ON 會立即啟動這個啟動預存程序。將啟動狀態 ON 改成 OFF 會使 Broker 停止啟動預存程序的執行個體，但並不會停止目前在執行中的預存程序之執行個體。

變更佇列來加入啟動預存程序，並不會變更佇列的啟動狀態。變更佇列的啟動預存程序，並不會影響目前在執行中的啟動預存程序的執行個體。

在啟動過程中，Service Broker 會檢查佇列的最大佇列讀取器數目。因此，變更佇列來增加最大佇列讀取器數目，可讓 Service Broker 立即啟動更多啟動預存程序的執行個體。變更佇列來減少最大佇列讀取器數目，並不會影響目前在執行中啟動預存程序的執行個體。不過，在啟動預存程序的執行個體數目低於設定的最大數目之前，Service Broker 並不會啟動新的預存程序執行個體。如需啟動處理序的詳細描述，請參閱＜Understanding When Activation Occurs＞。

當佇列無法使用時，Service Broker 會保存使用資料庫傳輸佇列中的佇列之服務的訊息。sys.transmission_queue 目錄檢視會提供傳輸佇列的檢視。

如果 RECEIVE 陳述式或 GET CONVERSATION GROUP 陳述式指定無法使用的佇列，陳述式會因 Transact-SQL 錯誤而失敗。

權限

變更佇列的權限，會預設給佇列的擁有者、db_ddladmin 或 db_owner 固定資料庫角色的成員，以及系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 使佇列無法使用

下列範例使 ExpenseQueue 佇列無法接收訊息。

ALTER QUEUE ExpenseQueue WITH STATUS = OFF ;

B. 變更啟動預存程序

下列範例會變更佇列啟動的預存程序。這個預存程序以執行 ALTER QUEUE 陳述式的使用者身分來執行。

ALTER QUEUE ExpenseQueue
    WITH ACTIVATION (
        PROCEDURE_NAME = new_stored_proc,
        EXECUTE AS SELF) ;

C. 變更佇列讀取器的數目

下列範例會將 Service Broker 為了這個佇列而啟動的最大預存程序執行個體數目設為 7。

ALTER QUEUE ExpenseQueue WITH ACTIVATION (MAX_QUEUE_READERS = 7) ;

D. 變更啟動預存程序和 EXECUTE AS 帳戶

下列範例會變更 Service Broker 啟動的預存程序。這個預存程序以 SecurityAccount 使用者的身分來執行。

ALTER QUEUE ExpenseQueue
    WITH ACTIVATION (
        PROCEDURE_NAME = AdventureWorks.dbo.new_stored_proc ,
        EXECUTE AS 'SecurityAccount') ;

E. 設定佇列來保留訊息

下列範例會設定佇列來保留訊息。佇列會保留使用這個佇列的服務所傳送和接收的所有訊息，直到包含訊息的交談結束為止。

ALTER QUEUE ExpenseQueue WITH RETENTION = ON ;

F. 從佇列中移除啟動

下列範例會從佇列中移除所有啟動資訊。

ALTER QUEUE ExpenseQueue WITH ACTIVATION (DROP) ;

請參閱

共用方式為