ALTER BROKER PRIORITY (Transact-SQL)

[アーティクル]
05/30/2023

適用対象: SQL Server Azure SQL Managed Instance

Service Broker メッセージ交換の優先度のプロパティを変更します。

構文

  
ALTER BROKER PRIORITY ConversationPriorityName  
FOR CONVERSATION  
{ SET ( [ CONTRACT_NAME = {ContractName | ANY } ]  
        [ [ , ] LOCAL_SERVICE_NAME = {LocalServiceName | ANY } ]  
        [ [ , ] REMOTE_SERVICE_NAME = {'RemoteServiceName' | ANY } ]  
        [ [ , ] PRIORITY_LEVEL = { PriorityValue | DEFAULT } ]  
              )  
}  
[;]

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

ConversationPriorityName
変更するメッセージ交換の優先度の名前を指定します。名前は、現在のデータベース内のメッセージ交換の優先度を参照する必要があります。

SET
指定したメッセージ交換の優先度をメッセージ交換に適用するかどうかを決定するための条件を指定します。 SET は必須であり、これには次の条件のうち、少なくとも 1 つを指定する必要があります: CONTRACT_NAME、LOCAL_SERVICE_NAME、REMOTE_SERVICE_NAME、または PRIORITY_LEVEL。

CONTRACT_NAME = {ContractName | ANY}
メッセージ交換の優先度をメッセージ交換に適用するかどうかを決定するための条件として使用するコントラクトの名前を指定します。 ContractName はデータベースエンジン識別子であり、現在のデータベース内のコントラクトの名前を指定する必要があります。

ContractName
メッセージ交換の優先度を適用できるのは、メッセージ交換を開始した BEGIN DIALOG ステートメントで ON CONTRACT ContractName が指定されたメッセージ交換だけであることを指定します。

ANY
使用するコントラクトに関係なく、メッセージ交換の優先度をどのメッセージ交換にも適用できることを指定します。

CONTRACT_NAME を指定しない場合、メッセージ交換の優先度のコントラクトプロパティは変更されません。

LOCAL_SERVICE_NAME = {LocalServiceName | ANY}
メッセージ交換の優先度をメッセージ交換のエンドポイントに適用するかどうかを決定するための条件として使用するサービスの名前を指定します。

LocalServiceName はデータベースエンジン識別子であり、現在のデータベース内のサービスの名前を指定する必要があります。

LocalServiceName
メッセージ交換の優先度を次のメッセージ交換のエンドポイントに適用できることを指定します。

発信側サービス名が LocalServiceName に一致する任意の発信側メッセージ交換のエンドポイント。
発信先サービス名が LocalServiceName に一致する任意の発信先メッセージ交換のエンドポイント。

ANY

エンドポイントで使用されるローカルサービスの名前に関係なく、メッセージ交換の優先度をどのメッセージ交換のエンドポイントにも適用できることを指定します。

LOCAL_SERVICE_NAME を指定しない場合、メッセージ交換の優先度のローカルサービスプロパティは変更されません。

REMOTE_SERVICE_NAME = {'RemoteServiceName' | ANY}
メッセージ交換の優先度をメッセージ交換のエンドポイントに適用するかどうかを決定するための条件として使用するサービスの名前を指定します。

RemoteServiceName は nvarchar(256) 型のリテラルです。 Service Broker は RemoteServiceName 文字列をバイト単位で照合します。この比較では、大文字と小文字が区別され、現在の照合順序は考慮されません。発信先サービスは、データベースエンジンの現在のインスタンス内にあっても、データベースエンジンのリモートインスタンス内にあってもかまいません。

'RemoteServiceName'
メッセージ交換の優先度を次のメッセージ交換のエンドポイントに割り当てることを指定します。

関連付けられている発信先サービス名が RemoteServiceName に一致する任意の発信側メッセージ交換のエンドポイント。
関連付けられている発信側サービス名が RemoteServiceName に一致する任意の発信先メッセージ交換のエンドポイント。

ANY
エンドポイントに関連付けられているリモートサービスの名前に関係なく、メッセージ交換の優先度をどのメッセージ交換のエンドポイントにも適用することを指定します。

REMOTE_SERVICE_NAME を指定しない場合、メッセージ交換の優先度のリモートサービスプロパティは変更されません。

PRIORITY_LEVEL = { PriorityValue | DEFAULT }
メッセージ交換の優先度で指定されているコントラクトおよびサービスを使用する任意のメッセージ交換のエンドポイントに割り当てる優先度レベルを指定します。 PriorityValue には、1 (最も低い優先度) ～ 10 (最も高い優先度) の整数リテラルを指定する必要があります。

PRIORITY_LEVEL を指定しない場合、メッセージ交換の優先度の優先度レベルプロパティは変更されません。

解説

ALTER BROKER PRIORITY で変更されるプロパティは、既存のメッセージ交換には適用されません。既存のメッセージ交換は、開始されたときに割り当てられた優先度のままです。

詳細については、「CREATE BROKER PRIORITY (Transact-SQL)」を参照してください。

アクセス許可

メッセージ交換の優先度を作成する権限は、既定では db_ddladmin 固定データベースロールまたは db_owner 固定データベースロールのメンバーと sysadmin 固定サーバーロールのメンバーに与えられています。データベースに対する ALTER 権限が必要です。

例

A. 既存のメッセージ交換の優先度レベルのみ変更する

優先度レベルを変更しますが、コントラクト、ローカルサービス、またはリモートサービスの各プロパティは変更しません。

ALTER BROKER PRIORITY SimpleContractDefaultPriority  
    FOR CONVERSATION  
    SET (PRIORITY_LEVEL = 3);

B. 既存のメッセージ交換の優先度のプロパティをすべて変更する

優先度レベル、コントラクト、ローカルサービス、リモートサービスの各プロパティを変更します。

ALTER BROKER PRIORITY SimpleContractPriority  
    FOR CONVERSATION  
    SET (CONTRACT_NAME = SimpleContractB,  
         LOCAL_SERVICE_NAME = TargetServiceB,  
         REMOTE_SERVICE_NAME = N'InitiatorServiceB',  
         PRIORITY_LEVEL = 8);

参照

CREATE BROKER PRIORITY (Transact-SQL)
DROP BROKER PRIORITY (Transact-SQL)
sys.conversation_priorities (Transact-SQL)

ALTER BROKER PRIORITY (Transact-SQL)

構文

引数

解説

アクセス許可

例

A. 既存のメッセージ交換の優先度レベルのみ変更する

B. 既存のメッセージ交換の優先度のプロパティをすべて変更する

参照

フィードバック

フィードバック

その他のリソース