GET_TRANSMISSION_STATUS (Transact-SQL)

Articolo
06/02/2023

Si applica a:SQL Server Istanza gestita di SQL di Azure

Restituisce lo stato dell'ultima trasmissione per un lato di una conversazione.

Sintassi

GET_TRANSMISSION_STATUS ( conversation_handle )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

conversation_id
Handle della conversazione. Questo parametro è di tipo uniqueidentifier.

Tipi restituiti

nchar

Osservazioni:

Restituisce una stringa che descrive lo stato dell'ultimo tentativo di trasmissione per la conversazione specificata. Restituisce una stringa vuota se l'ultimo tentativo di trasmissione ha avuto esito positivo, se non è ancora stato effettuato alcun tentativo di trasmissione oppure se conversation_handle non esiste.

Le informazioni restituite da questa funzione corrispondono alle stesse informazioni visualizzate nella colonna last_transmission_error della vista di gestione sys.transmission_queue. Tuttavia, questa funzione può essere utilizzata per ricercare lo stato di trasmissione delle conversazioni che non includono messaggi nella coda di trasmissione.

Nota

GET_TRANSMISSION_STATUS non restituisce informazioni per i messaggi che non dispongono di un endpoint di conversazione nell'istanza corrente, ovvero non sono disponibili informazioni per i messaggi da inoltrare.

Esempi

Nell'esempio seguente viene visualizzato lo stato di trasmissione della conversazione con handle di conversazione 58ef1d2d-c405-42eb-a762-23ff320bddf0.

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

Quello che segue è un set di risultati di esempio, modificato per adattarlo alla lunghezza di riga.

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

In questo caso SQL Server non è configurato in modo da consentire le comunicazioni di Service Broker nella rete.

Vedi anche

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