ALTER BROKER PRIORITY (Transact-SQL)ALTER BROKER PRIORITY (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Eigenschaften einer Service BrokerService Broker-Konversationspriorität.Changes the properties of a Service BrokerService Broker conversation priority.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


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 } ]  
              )  
}  
[;]  

ArgumenteArguments

ConversationPriorityNameConversationPriorityName
Gibt den Namen der zu ändernden Konversationspriorität an.Specifies the name of the conversation priority to be changed. Der Name muss auf eine Konversationspriorität in der aktuellen Datenbank verweisen.The name must refer to a conversation priority in the current database.

SETSET
Gibt die Kriterien an, anhand derer bestimmt wird, ob die Konversationspriorität für eine Konversation übernommen wird.Specifies the criteria for determining if the conversation priority applies to a conversation. SET ist erforderlich und muss mindestens ein Kriterium enthalten: CONTRACT_NAME, LOCAL_SERVICE_NAME, REMOTE_SERVICE_NAME oder PRIORITY_LEVEL.SET is required and must contain at least one criterion: CONTRACT_NAME, LOCAL_SERVICE_NAME, REMOTE_SERVICE_NAME, or PRIORITY_LEVEL.

CONTRACT_NAME = {ContractName | ANY}CONTRACT_NAME = {ContractName | ANY}
Gibt den Namen eines Vertrags an, der als Kriterium für die Festlegung verwendet wird, ob die Konversationspriorität für eine Konversation gelten soll.Specifies the name of a contract to be used as a criterion for determining if the conversation priority applies to a conversation. ContractName ist ein DatenbankmodulDatabase Engine-Bezeichner und muss den Namen eines Vertrags in der aktuellen Datenbank angeben.ContractName is a DatenbankmodulDatabase Engine identifier, and must specify the name of a contract in the current database.

ContractNameContractName
Gibt an, dass die Konversationspriorität nur für Konversationen übernommen werden kann, bei denen die BEGIN DIALOG-Anweisung, mit der die Konversation gestartet wurde, auf ON CONTRACT ContractName festgelegt ist.Specifies that the conversation priority can be applied only to conversations where the BEGIN DIALOG statement that started the conversation specified ON CONTRACT ContractName.

ANYANY
Gibt an, dass die Konversationspriorität für jede Konversation unabhängig vom verwendeten Vertrag übernommen werden kann.Specifies that the conversation priority can be applied to any conversation, regardless of which contract it uses.

Wenn CONTRACT_NAME nicht angegeben ist, wird die Eigenschaft für den Vertrag der Konversationspriorität nicht geändert.If CONTRACT_NAME is not specified, the contract property of the conversation priority is not changed.

LOCAL_SERVICE_NAME = {LocalServiceName | ANY}LOCAL_SERVICE_NAME = {LocalServiceName | ANY}
Gibt den Namen eines Diensts an, der als Kriterium verwendet werden kann, um zu bestimmen, ob die Konversationspriorität für einen Konversationsendpunkt übernommen wird.Specifies the name of a service to be used as a criterion to determine if the conversation priority applies to a conversation endpoint.

LocalServiceName ist ein DatenbankmodulDatabase Engine-Bezeichner, der den Namen eines Diensts in der aktuellen Datenbank angeben muss.LocalServiceName is a DatenbankmodulDatabase Engine identifier and must specify the name of a service in the current database.

LocalServiceNameLocalServiceName
Gibt an, dass die Konversationspriorität für Folgendes übernommen werden kann:Specifies that the conversation priority can be applied to the following:

  • Jeder Konversationsendpunkt für den Initiator, dessen Initiatordienstname LocalServiceName entspricht.Any initiator conversation endpoint whose initiator service name matches LocalServiceName.

  • Jeder Konversationsendpunkt für das Ziel, dessen Zieldienstname LocalServiceName entspricht.Any target conversation endpoint whose target service name matches LocalServiceName.

    ANYANY

    • Gibt an, dass die Konversationspriorität unabhängig vom Namen des vom Endpunkt verwendeten lokalen Diensts für jeden Konversationsendpunkt übernommen werden kann.Specifies that the conversation priority can be applied to any conversation endpoint, regardless of the name of the local service used by the endpoint.

    Wenn LOCAL_SERVICE_NAME nicht angegeben ist, wird die Eigenschaft für den lokalen Dienst der Konversationspriorität nicht geändert.If LOCAL_SERVICE_NAME is not specified, the local service property of the conversation priority is not changed.

    REMOTE_SERVICE_NAME = {'RemoteServiceName' | ANY}REMOTE_SERVICE_NAME = {'RemoteServiceName' | ANY}
    Gibt den Namen eines Diensts an, der als Kriterium verwendet werden kann, um zu bestimmen, ob die Konversationspriorität für einen Konversationsendpunkt übernommen wird.Specifies the name of a service to be used as a criterion to determine if the conversation priority applies to a conversation endpoint.

    RemoteServiceName ist ein Literal vom Typ nvarchar(256).RemoteServiceName is a literal of type nvarchar(256). Service BrokerService Broker verwendet einen bitweisen Vergleich für den Abgleich der RemoteServiceName-Zeichenfolge. uses a byte-by-byte comparison to match the RemoteServiceName string. Bei dem Vergleich wird die Groß-/Kleinschreibung beachtet, die aktuelle Sortierung hingegen wird nicht berücksichtigt.The comparison is case-sensitive and does not consider the current collation. Der Zieldienst kann in der aktuellen Instanz von DatenbankmodulDatabase Engine oder in einer Remoteinstanz von DatenbankmodulDatabase Engine vorhanden sein.The target service can be in the current instance of the DatenbankmodulDatabase Engine, or a remote instance of the DatenbankmodulDatabase Engine.

    'RemoteServiceName''RemoteServiceName'
    Gibt an, dass die Konversationspriorität Folgendem zugewiesen werden kann:Specifies the conversation priority be assigned to the following:

  • Jeder Konversationsendpunkt für den Initiator, dessen zugeordneter Zieldienstname RemoteServiceName entspricht.Any initiator conversation endpoint whose associated target service name matches RemoteServiceName.

  • Jeder Konversationsendpunkt für das Ziel, dessen zugeordneter Initiatordienstname RemoteServiceName entspricht.Any target conversation endpoint whose associated initiator service name matches RemoteServiceName.

    ANYANY
    Gibt an, dass die Konversationspriorität unabhängig vom Namen des dem Endpunkt zugeordneten Remotediensts für jeden Konversationsendpunkt übernommen wird.Specifies that the conversation priority applies to any conversation endpoint, regardless of the name of the remote service associated with the endpoint.

    Wenn REMOTE_SERVICE_NAME nicht angegeben ist, wird die Eigenschaft für den Remotedienst der Konversationspriorität nicht geändert.If REMOTE_SERVICE_NAME is not specified, the remote service property of the conversation priority is not changed.

    PRIORITY_LEVEL = { PriorityValue | DEFAULT }PRIORITY_LEVEL = { PriorityValue | DEFAULT }
    Gibt die Prioritätsebene an, die jedem Konversationsendpunkt zugeordnet werden soll, der die Verträge und Dienste verwendet, die für die Konversationspriorität angegeben werden.Specifies the priority level to assign any conversation endpoint that use the contracts and services that are specified in the conversation priority. PriorityValue muss ein ganzahliges Literal zwischen 1 (niedrigste Priorität) und 10 (höchste Priorität) sein.PriorityValue must be an integer literal from 1 (lowest priority) to 10 (highest priority).

    Wenn PRIORITY_LEVEL nicht angegeben ist, wird die Eigenschaft für die Prioritätsebene der Konversationspriorität nicht geändert.If PRIORITY_LEVEL is not specified, the priority level property of the conversation priority is not changed.

RemarksRemarks

Keine Eigenschaften, die von ALTER BROKER PRIORITY geändert werden, werden für vorhandene Konversationen übernommen.No properties that are changed by ALTER BROKER PRIORITY are applied to existing conversations. Die vorhandenen Konversationen werden mit der Priorität fortgesetzt, die beim Starten der Konversationen zugewiesen wurde.The existing conversations continue with the priority that was assigned when they were started.

Weitere Informationen finden Sie unter CREATE BROKER PRIORITY (Transact-SQL).For more information, see CREATE BROKER PRIORITY (Transact-SQL).

BerechtigungenPermissions

Die Berechtigung zum Erstellen einer Konversationspriorität erhalten standardmäßig die Mitglieder der festen Datenbankrolle db_ddladmin oder db_owner und die feste Serverrolle sysadmin.Permission for creating a conversation priority defaults to members of the db_ddladmin or db_owner fixed database roles, and to the sysadmin fixed server role. Erfordert die ALTER-Berechtigung für die Datenbank.Requires ALTER permission on the database.

BeispieleExamples

A.A. Ändern der Prioritätsstufe einer vorhandenen Konversationspriorität.Changing only the priority level of an existing conversation priority.

Ändert die Prioritätsebene, nicht hingegen die Eigenschaften für den Vertrag, lokalen Dienst oder Remotedienst.Changes the priority level, but does not change the contract, local service, or remote service properties.

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

B.B. Ändern aller Eigenschaften einer vorhandenen Konversationspriorität.Changing all of the properties of an existing conversation priority.

Ändert die Eigenschaften für Prioritätsebene, Vertrag, lokalen Dienst und Remotedienst.Changes the priority level, contract, local service, and remote service properties.

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

Weitere Informationen finden Sie unterSee Also

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