ALTER QUEUE (Transact-SQL)

發行項
05/04/2023

變更佇列屬性。

語法

ALTER QUEUE <object>   
   queue_settings  
   | queue_action  
[ ; ]  
  
<object> : :=  
{ database_name.schema_name.queue_name | schema_name.queue_name | queue_name }
  
<queue_settings> : :=  
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 } )  
         ]   
  
<queue_action> : :=  
   REBUILD [ WITH <query_rebuild_options> ]  
   | REORGANIZE [ WITH (LOB_COMPACTION = { ON | OFF } ) ]  
   | MOVE TO { file_group | "default" }  
  
<procedure> : :=  
{ database_name.schema_name.stored_procedure_name | schema_name.stored_procedure_name | stored_procedure_name }
  
<queue_rebuild_options> : :=  
{  
   ( MAXDOP = max_degree_of_parallelism )  
}

引數

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 時，佇列不會啟用預存程序。

REBUILD [ WITH <queue_rebuild_options> ]
適用於：SQL Server 2016 (13.x) 和更新版本。

重建佇列內部資料表的所有索引。當您遇到因為高負載而產生的片段問題時，請使用此功能。 MAXDOP 是唯一支援的佇列重建選項。 REBUILD 一律是離線作業。

REORGANIZE [ WITH ( LOB_COMPACTION = { ON | OFF } ) ]
適用於：SQL Server 2016 (13.x) 和更新版本。

重新組織佇列內部資料表上的所有索引。
不同於使用者資料表上的 REORGANIZE，佇列上的 REORGANIZE 一律會以離線作業執行，因為佇列上會明確停用頁面層級鎖定。

提示

有關索引片段的一般指引是，當片段介於 5% 和 30% 之間時重新組織索引。當片段高於 30% 重建索引。不過，這些數字僅是作為您環境起點的一般指引。若要判斷索引片段的數量，請使用 sys.dm_db_index_physical_stats (Transact-SQL) - 如需範例，請參閱該文章中的範例 G。

MOVE TO { file_group | "default" }
適用於：SQL Server 2016 (13.x) 和更新版本。

將佇列內部資料表 (包含其索引) 移動至使用者指定的檔案群組。新的檔案群組不得為唯讀。

PROCEDURE_NAME = <procedure>
指定在佇列包含要處理的訊息時，將啟動的預存程序名稱。這個值必須是 SQL Server 識別碼。

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

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 = AdventureWorks2022.dbo.new_stored_proc ,  
        EXECUTE AS 'SecurityAccount') ;

E. 設定佇列來保留訊息

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

ALTER QUEUE ExpenseQueue WITH RETENTION = ON ;

F. 從佇列中移除啟用

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

ALTER QUEUE ExpenseQueue WITH ACTIVATION (DROP) ;

G. 重建佇列索引

適用於：SQL Server 2016 (13.x) 和更新版本。

下列範例會重建佇列索引

ALTER QUEUE ExpenseQueue REBUILD WITH (MAXDOP = 2)

H. 重新組織佇列索引

適用於：SQL Server 2016 (13.x) 和更新版本。

下列範例會重新組織佇列索引

ALTER QUEUE ExpenseQueue REORGANIZE

I.將佇列內部資料表移至另一個檔案群組

適用於：SQL Server 2016 (13.x) 和更新版本。

ALTER QUEUE ExpenseQueue MOVE TO [NewFilegroup]

另請參閱

CREATE QUEUE (Transact-SQL)
DROP QUEUE (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.dm_db_index_physical_stats (Transact-SQL)

共用方式為

ALTER QUEUE (Transact-SQL)

語法

引數

備註

權限

範例

A. 使佇列無法使用

B. 變更啟用預存程序

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

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

E. 設定佇列來保留訊息

F. 從佇列中移除啟用

G. 重建佇列索引

H. 重新組織佇列索引

I.將佇列內部資料表移至另一個檔案群組

另請參閱

意見反應

其他資源