GET_TRANSMISSION_STATUS (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

Retourne l'état de la dernière transmission pour un côté d'une conversation.

Conventions de la syntaxe Transact-SQL

Syntaxe

GET_TRANSMISSION_STATUS ( conversation_handle )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

conversation_id
Description du descripteur de conversation pour la conversation. Ce paramètre est de type uniqueidentifier.

Types de retour

nchar

Notes

Retourne une chaîne décrivant l'état de la dernière tentative de transmission pour la conversation spécifiée. Retourne une chaîne vide en cas de réussite de la dernière tentative de transmission, si aucune tentative de transmission n’a encore été effectuée ou si conversation_handle n’existe pas.

Les informations retournées par cette fonction sont les mêmes que celles affichées dans la colonne last_transmission_error de la vue de gestion sys.transmission_queue. Il est toutefois possible d'utiliser cette fonction pour trouver l'état de transmission des conversations qui n'ont pas de messages dans la file d'attente de transmission.

Notes

GET_TRANSMISSION_STATUS ne fournit pas d'informations pour les messages qui n'ont pas de point de terminaison dans l'instance active. C'est-à-dire qu'aucune information n'est disponible pour les messages à transmettre.

Exemples

L'exemple suivant indique l'état de transmission pour la conversation dotée du descripteur de conversation 58ef1d2d-c405-42eb-a762-23ff320bddf0.

SELECT Status =  
    GET_TRANSMISSION_STATUS('58ef1d2d-c405-42eb-a762-23ff320bddf0') ;

Voici un exemple d'ensemble de résultats, modifié pour la longueur de ligne :

Status  
------------------------------- 
The Service Broker protocol transport is disabled or not configured.

Dans ce cas, SQL Server n'est pas configuré pour permettre à Service Broker de communiquer sur le réseau.

Voir aussi

sys.conversation_endpoints (Transact-SQL)
sys.transmission_queue (Transact-SQL)