MOVE CONVERSATION (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Managed Instance

Déplace une conversation vers un groupe de conversations différent.

Syntaxe

MOVE CONVERSATION conversation_handle  
   TO conversation_group_id  
[ ; ]

Arguments

conversation_handle
Variable ou constante contenant le descripteur de conversation à déplacer. conversation_handle doit être de type uniqueidentifier.

TO conversation_group_id
Variable ou constante contenant l'identificateur du groupe de conversations destinataire. conversation_group_id doit être de type uniqueidentifier.

Remarques

L’instruction MOVE CONVERSATION déplace la conversation spécifiée par conversation_handle vers le groupe de conversations identifié par conversation_group_id. Les dialogues ne peuvent être redirigés qu'entre des groupes de conversation associés à la même file d'attente.

Important

Si l’instruction MOVE CONVERSATION n’est pas la première d’un lot ou d’une procédure stockée, l’instruction qui précède doit se terminer par un point-virgule (;), qui constitue le terminateur d’instruction de Transact-SQL.

L’instruction MOVE CONVERSATION verrouille le groupe de conversations associé à conversation_handle et celui spécifié par conversation_group_id jusqu’à la validation ou la restauration de la transaction contenant cette instruction.

MOVE CONVERSATION n'est pas valide dans une fonction définie par l'utilisateur.

Autorisations

Pour déplacer une conversation, l'utilisateur actif doit être soit propriétaire de la conversation et du groupe de conversations, soit un membre du rôle serveur fixe sysadmin, soit un membre du rôle de base de données fixe db_owner.

Exemples

L'exemple suivant déplace une conversation vers un groupe de conversations différent.

DECLARE @conversation_handle UNIQUEIDENTIFIER,  
        @conversation_group_id UNIQUEIDENTIFIER ;  
  
SET @conversation_handle =  
    <retrieve conversation handle from database> ;  
SET @conversation_group_id =  
    <retrieve conversation group ID from database> ;  
  
MOVE CONVERSATION @conversation_handle TO @conversation_group_id ;

Voir aussi

BEGIN DIALOG CONVERSATION (Transact-SQL)
GET CONVERSATION GROUP (Transact-SQL)
END CONVERSATION (Transact-SQL)
sys.conversation_groups (Transact-SQL)
sys.conversation_endpoints (Transact-SQL)

Partager via