ALTER QUEUE (Transact-SQL)

發行項
06/18/2013

變更佇列屬性。

語法

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 }
          ) [ , ]]
         [ POISON_MESSAGE_HANDLING (
          STATUS = { ON | OFF } )
         ] 
  [ ; ]

<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 會降低效能。只有在必須符合應用程式的服務等級合約時，才應該使用這項設定。
ACTIVATION
指定為了處理到達這個佇列的訊息而啟動之預存程序的相關資訊。
STATUS (Activation)
指定佇列是否啟用預存程序。當 STATUS = ON 時，如果目前執行的程序數目低於 MAX_QUEUE_READERS，且訊息到達佇列的速度比預存程序接收訊息快，佇列便會啟動 PROCEDURE_NAME 所指定的預存程序。當 STATUS = OFF 時，佇列不會啟用預存程序。
PROCEDURE_NAME = <procedure>
指定在佇列包含要處理的訊息時，將啟動的預存程序名稱。這個值必須是 SQL Server 識別碼。
database_name (程序)
這是包含預存程序的資料庫名稱。
schema_name (procedure)
這是擁有預存程序的結構描述名稱。
stored_procedure_name
這是預存程序的名稱。
MAX_QUEUE_READERS =max_reader
指定佇列同時啟動的啟用預存程序的最大執行個體數目。 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
刪除與佇列相關聯的所有啟用資訊。
POISON_MESSAGE_HANDLING
指定是否啟用有害訊息處理。預設值是 ON。

有害訊息處理設定為 OFF 的佇列將不會在五個連續的交易復原後停用。這可讓應用程式定義自訂有害訊息處理系統。

備註

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

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

在啟用過程中，Service Broker 會檢查佇列的最大佇列讀取器數目。因此，變更佇列來增加最大佇列讀取器數目，可讓 Service Broker 立即啟用更多啟用預存程序的執行個體。變更佇列來減少最大佇列讀取器數目，並不會影響目前在執行中啟用預存程序的執行個體。不過，在啟用預存程序的執行個體數目低於設定的最大數目之前，Service Broker 並不會啟動新的預存程序執行個體。

當佇列無法使用時，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 = AdventureWorks2012.dbo.new_stored_proc ,
        EXECUTE AS 'SecurityAccount') ;

E.設定佇列來保留訊息

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

ALTER QUEUE ExpenseQueue WITH RETENTION = ON ;

F.從佇列中移除啟用

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

ALTER QUEUE ExpenseQueue WITH ACTIVATION (DROP) ;

請參閱

參考

CREATE QUEUE (Transact-SQL)

DROP QUEUE (Transact-SQL)

EVENTDATA (Transact-SQL)

共用方式為