END CONVERSATION (Transact-SQL)

Syntaxe

END CONVERSATION conversation_handle
   [   [ WITH ERROR = failure_code DESCRIPTION = 'failure_text' ]
     | [ WITH CLEANUP ]
    ]
[ ; ]

Arguments

• conversation_handle
  Handle de conversation pour la conversation à terminer.

• WITH ERROR = failure_code
  Code d'erreur. L'argument failure_code est de type int. Le code d'échec est un code défini par l'utilisateur qui est inclus dans le message d'erreur envoyé à l'autre côté de la conversation. Le code d'échec doit être supérieur à 0.

• DESCRIPTION = failure_text
  Message d'erreur. L'argument failure_text est de type nvarchar(3000). Le texte d'échec est un texte défini par l'utilisateur qui est inclus dans le message d'erreur envoyé à l'autre côté de la conversation.

• WITH CLEANUP
  Supprime tous les messages et les entrées d'affichage catalogue pour un côté d'une conversation qui ne peut pas se terminer normalement. L'autre côté de la conversation n'est pas notifié du nettoyage. MicrosoftSQL Server supprime le point de terminaison, tous les messages de la conversation dans la file d'attente de transmission, ainsi que tous les messages pour la conversation dans la file d'attente du service. Les administrateurs peuvent utiliser cette option pour supprimer des conversations qui ne peuvent pas se terminer normalement. Si, par exemple, le service distant a été supprimé définitivement, un administrateur peut utiliser WITH CLEANUP pour supprimer les conversations avec ce service. N'utilisez pas WITH CLEANUP dans le code d'une application Service Broker. Si END CONVERSATION WITH CLEANUP est exécuté avant que le point de terminaison de réception n'accuse réception d'un message, le point de terminaison d'envoi renverra le message. Cela peut éventuellement entraîner la réexécution du dialogue.

Notes

Mettre fin à une conversation verrouille le groupe de conversations auquel appartient le conversation_handle fourni. Lorsqu'une conversation se termine, Service Broker supprime tous les messages qui la concernent de la file d'attente du service.

Une fois qu'une conversation est terminée, aucune application ne peut plus envoyer ni recevoir des messages pour cette conversation. Les deux participants d'une conversation doivent appeler END CONVERSATION pour achever la conversation. Si Service Broker n'a pas reçu de message de fin de dialogue ou de message d'erreur de la part de l'autre participant de la conversation, Service Broker avertit l'autre participant que la conversation est terminée. Dans ce cas, bien que le handle de conversation ne soit plus valide, le point de terminaison de la conversation reste actif jusqu'à ce que l'instance qui héberge le service distant accuse réception du message.

Si Service Broker n'a pas encore traité le message de fin de dialogue ou d'erreur de la conversation, Service Broker avertit le côté distant que la conversation est terminée. Les messages que Service Broker envoie au service distant dépendent des options spécifiées :

• Si la conversation se termine sans erreurs et qu'elle est toujours active avec le service distant, Service Broker envoie un message de type https://schemas.microsoft.com/SQL/ServiceBroker/EndDialog au service distant. Service Broker ajoute ce message à la file d'attente de transmission en respectant l'ordre de la conversation. En d'autres termes, Service Broker envoie tous les messages de cette conversation qui se trouvent actuellement dans la file d'attente de transmission avant d'envoyer ce message.

• Si la conversation se termine avec une erreur et qu'elle est toujours active avec le service distant, Service Broker envoie un message de type https://schemas.microsoft.com/SQL/ServiceBroker/Error au service distant. Service Broker supprime, dans ce cas, tous les messages de cette conversation qui sont encore dans la file d'attente de transmission.

• La clause WITH CLEANUP permet à un administrateur de base de données de supprimer les conversations qui ne peuvent pas se terminer normalement. Cette option supprime tous les messages et les entrées d'affichage catalogue concernant la conversation. Notez, dans ce cas, que le côté distant de la conversation n'est pas averti de la fin de la conversation et risque de ne pas recevoir les messages qui ont été envoyés par une application mais qui n'ont pas encore été transmis sur le réseau. Évitez d'utiliser cette option, sauf si la conversation ne peut pas se terminer normalement.

Au terme d'une conversation, une instruction Transact-SQL SEND qui spécifie le descripteur de conversation provoque une erreur Transact-SQL. Si des messages liés à cette conversation sont envoyés par l'autre côté de la conversation, Service Broker les refuse.

Si une conversation se termine alors que le service distant possède toujours des messages non envoyés pour cette conversation, le service distant supprime ces messages. Cela n'est pas considéré comme une erreur et le service distant n'est pas averti de la suppression des messages.

Les codes d'échec spécifiés dans la clause WITH ERROR doivent être des nombres positifs. Les nombres négatifs sont réservés aux messages d'erreur de Service Broker. Pour plus d'informations sur les messages d'erreur Service Broker, consultez Messages système Service Broker.

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

Autorisations

Pour mettre fin à une conversation active, l'utilisateur actif doit en être le propriétaire, un membre du rôle serveur fixe sysadmin ou un membre du rôle de base de données fixe db_owner.

Un membre du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peut utiliser la clause WITH CLEANUP pour supprimer les métadonnées d'une conversation qui est déjà terminée.

Exemples

A. Fin d'une conversation

END CONVERSATION @dialog_handle ;

B. Fin d'une conversation avec une erreur

DECLARE @dialog_handle UNIQUEIDENTIFIER,
        @ErrorSave INT,
        @ErrorDesc NVARCHAR(100) ;
BEGIN TRANSACTION ;

<receive and process message>

SET @ErrorSave = @@ERROR ;

IF (@ErrorSave <> 0)
  BEGIN
      ROLLBACK TRANSACTION ;
      SET @ErrorDesc = N'An error has occurred.' ;
      END CONVERSATION @dialog_handle 
      WITH ERROR = @ErrorSave DESCRIPTION = @ErrorDesc ;
  END
ELSE

COMMIT TRANSACTION ;

C. Nettoyage d'une conversation qui ne peut pas se terminer normalement

END CONVERSATION @dialog_handle WITH CLEANUP ;

Voir aussi

Référence

Concepts