Compartilhar via


GET_TRANSMISSION_STATUS (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Retorna o status da última transmissão para um lado de uma conversa.

Convenções de sintaxe de Transact-SQL

Sintaxe

GET_TRANSMISSION_STATUS ( conversation_handle )  

Argumentos

conversation_id
É o identificador de conversa para a conversa. Esse parâmetro é do tipo uniqueidentifier.

Tipos de retorno

nchar

Comentários

Retorna uma cadeia de caracteres que descreve o status da última tentativa de transmissão para a conversa especificada. Retorna uma cadeia de caracteres vazia se a última tentativa de transmissão tiver êxito, se nenhuma tentativa de transmissão for feita ou se conversation_handle não existir.

As informações retornadas por essa função são as mesmas exibidas na coluna last_transmission_error da exibição de gerenciamento sys.transmission_queue. Entretanto, essa função pode ser usada para localizar o status de transmissão para conversas que atualmente não tenham mensagens na fila de transmissão.

Observação

GET_TRANSMISSION_STATUS não fornece informações para mensagens que não tenham um ponto de extremidade de conversa na instância atual. Isto é, nenhuma informação está disponível para as mensagens a serem encaminhadas.

Exemplos

O exemplo a seguir relata o status de transmissão para a conversa com o identificador de conversa 58ef1d2d-c405-42eb-a762-23ff320bddf0.

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

Conjunto de resultados de exemplo, editado para comprimento de linha:

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

Nesse caso, o SQL Server não é configurado para permitir que o Agente de Serviço se comunique pela rede.

Consulte Também

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