ALTER BROKER PRIORITY (Transact-SQL)

Platí na:SQL ServerAzureSQL Managed Instance

Mění to vlastnosti priority konverzace se Service Brokerem.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

Priorita konverzace
Specifikuje název priority konverzace, která má být změněna. Název musí odkazovat na prioritu konverzace v aktuální databázi.

SET
Specifikuje kritéria pro určení, zda se priorita konverzace vztahuje na konverzaci. SET je povinné a musí obsahovat alespoň jedno kritérium: CONTRACT_NAME, LOCAL_SERVICE_NAME, REMOTE_SERVICE_NAME nebo PRIORITY_LEVEL.

CONTRACT_NAME = {JménosmlouvyJakoukoliv | }
Specifikuje název smlouvy, která má být použita jako kritérium pro určení, zda se priorita konverzace vztahuje na konverzaci. ContractName je identifikátor Database Engine a musí uvádět název smlouvy v aktuální databázi.

ContractName
Specifikuje, že priorita konverzace může být aplikována pouze na konverzace, kde příkaz BEGIN DIALOG, který konverzaci zahájil, byl uveden NA CONTRACTContractName.

Libovolný
Specifikuje, že priorita konverzace může být aplikována na jakoukoli konverzaci, bez ohledu na to, kterou smlouvu používá.

Pokud CONTRACT_NAME není specifikováno, vlastnost smlouvy o prioritě konverzace se nemění.

LOCAL_SERVICE_NAME = {LocalServiceName | ANY}
Specifikuje název služby, která má být použita jako kritérium pro určení, zda se priorita konverzace vztahuje na konverzační endpoint.

LocalServiceName je identifikátor Database Engine a musí specifikovat název služby v aktuální databázi.

LocalServiceName
Specifikuje, že priorita konverzace může být aplikována na následující:

  • Jakýkoli koncový bod konverzace iniciátora, jehož název služby iniciátora odpovídá LocalServiceName.

  • Jakýkoli cílový konverzační endpoint, jehož cílové jméno služby odpovídá LocalServiceName.

Libovolný

  • Specifikuje, že priorita konverzace může být aplikována na jakýkoli konverzační endpoint, bez ohledu na název lokální služby používané tímto koncovým bodem.

Pokud LOCAL_SERVICE_NAME není specifikováno, vlastnost priority konverzace se nemění jako lokální služba.

REMOTE_SERVICE_NAME = {'RemoteServiceName' | NĚJAKÉ}
Specifikuje název služby, která má být použita jako kritérium pro určení, zda se priorita konverzace vztahuje na konverzační endpoint.

RemoteServiceName je doslovný typ nvarchar(256). Service Broker používá porovnání bajtů po bajtech, aby odpovídal řetězci RemoteServiceName . Srovnání je citlivé na velikost a písmeno a nezohledňuje aktuální kolaci. Cílová služba může být v aktuální instanci Database Engine, nebo v vzdálené instanci Database Engine.

'RemoteServiceName'
Specifikuje, že priorita konverzace má být přiřazena následujícím:

  • Každý koncový bod iniciátorové konverzace, jehož cílové jméno služby odpovídá RemoteServiceName.

  • Každý cílový konverzační endpoint, jehož přidružené iniciátorské jméno služby odpovídá RemoteServiceName.

Libovolný
Specifikuje, že priorita konverzace se vztahuje na jakýkoli konverzační endpoint, bez ohledu na název vzdálené služby s tímto koncovým bodem.

Pokud REMOTE_SERVICE_NAME není specifikováno, vlastnost priority konverzace vzdálené služby se nemění.

PRIORITY_LEVEL = { PriorityValue | DEFAULT }
Specifikuje úroveň priority pro přiřazení jakéhokoli konverzačního endpointu, který používá kontrakty a služby uvedené v prioritě konverzace. PriorityValue musí být celočíselný literál od 1 (s nejnižší prioritou) do 10 (nejvyšší priorita).

Pokud PRIORITY_LEVEL není specifikováno, vlastnost priority konverzace na úrovni priority se nemění.

Remarks

Žádné vlastnosti, které by byly změněny , ALTER BROKER PRIORITY nejsou aplikovány na existující konverzace. Stávající konverzace pokračují s prioritou, která byla přidělena při jejich zahájení.

Další informace najdete v tématu CREATE BROKER PRIORITY (Transact-SQL).

Permissions

Oprávnění pro vytvoření priority konverzace je výchozí pro členy db_ddladmin nebo db_owner pevných databázových rolí a pro roli pevného správce systému . Vyžaduje oprávnění ALTER pro databázi.

Examples

A. Změna pouze úrovně priority existující konverzace.

Mění to úroveň priority, ale nemění smlouvu, místní službu ani vlastnosti vzdálené služby.

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

B. Změna všech vlastností existující priority konverzace.

Mění to prioritní úroveň, smluvu, místní službu a vlastnosti vzdálené služby.

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

Viz také

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

  • Last updated on