GET_TRANSMISSION_STATUS (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Gibt den Status der letzten Übermittlung für eine Seite einer Konversation zurück.

Transact-SQL-Syntaxkonventionen

Syntax

GET_TRANSMISSION_STATUS ( conversation_handle )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

conversation_id
Bezeichnet das Konversationshandle für die Konversation. Der Parameter weist den Typ uniqueidentifier auf.

Rückgabetypen

nchar

Hinweise

Gibt eine Zeichenfolge zurück, die eine Beschreibung des Status des letzten Übermittlungsversuchs für eine angegebene Konversation enthält. Gibt eine leere Zeichenfolge zurück, wenn der letzte Übermittlungsversuch erfolgreich war, falls noch kein Übermittlungsversuch ausgeführt wurde oder falls conversation_handle nicht vorhanden ist.

Die von dieser Funktion zurückgegebenen Informationen sind mit den in der last_transmission_error-Spalte der Verwaltungssicht sys.transmission_queue angezeigten Informationen identisch. Diese Funktion kann jedoch zum Suchen nach dem Übermittlungsstatus von Konversationen verwendet werden, für die zurzeit keine Meldungen in der Übermittlungswarteschlange vorhanden sind.

Hinweis

GET_TRANSMISSION_STATUS stellt nur Informationen zu Meldungen bereit, für die ein Konversationsendpunkt in der aktuellen Instanz vorhanden ist. Zu Meldungen, die weitergeleitet werden müssen, sind demnach keine Informationen verfügbar.

Beispiele

Im folgenden Beispiel wird der Übermittlungsstatus für die Konversation mit dem Konversationshandle 58ef1d2d-c405-42eb-a762-23ff320bddf0 gemeldet.

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

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:

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

In diesem Fall ist SQL Server so konfiguriert, dass Service Broker nicht über das Netzwerk kommunizieren darf.

Weitere Informationen

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