END CONVERSATION (Transact-SQL)

Encerra um lado de uma conversa existente.

Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

• conversation_handle
  É o identificador de conversa para que a conversa termine.

• WITH ERROR =failure_code
  É o código de erro. failure_code é do tipo int. O código de falha é um código definido pelo usuário que é incluído na mensagem de erro enviada ao outro lado da conversa. O código de falha deve ser maior que 0.

• DESCRIPTION =failure_text
  É a mensagem de erro. failure_text é do tipo nvarchar(3000). O texto da falha é um texto definido pelo usuário que é incluído na mensagem de erro enviada ao outro lado da conversa.

• WITH CLEANUP
  Remove todas as mensagens e entradas da exibição do catálogo para um lado de uma conversa que não pode ser concluída normalmente. O outro lado da conversa não é notificado da limpeza. O Microsoft SQL Server remove o ponto de extremidade da conversa, todas as mensagens da conversa na fila de transmissão e todas as mensagens da conversa na fila de serviço. Os administradores podem usar essa opção para remover conversas que não podem ser concluídas normalmente. Por exemplo, se o serviço remoto tiver sido removido permanentemente, um administrador poderá usar WITH CLEANUP para remover conversas para esse serviço. Não use WITH CLEANUP no código de um aplicativo Service Broker. Se END CONVERSATION WITH CLEANUP for executado antes de o ponto de extremidade de recepção confirmar o recebimento de uma mensagem, o ponto de extremidade de envio enviará a mensagem novamente. Isto poderá executar novamente o diálogo.

Comentários

O encerramento de uma conversa bloqueia o grupo de conversa ao qual o conversation_handle fornecido pertence. Quando uma conversa é encerrada, o Service Broker remove todas as mensagens para ela da fila de serviço.

Após o término de uma conversa, um aplicativo não pode mais enviar ou receber mensagens para essa conversa. Ambos os participantes em uma conversa devem chamar END CONVERSATION para concluir a conversa. Se o Service Broker não tiver recebido uma mensagem de término do diálogo ou uma mensagem de erro do outro participante, o Service Broker notificará o outro participante de que a conversa terminou. Neste caso, embora o identificador da conversa não seja mais válido, o ponto de extremidade de conversa permanece ativo até a instância que hospeda o serviço remoto confirmar a mensagem.

Se o Service Broker ainda não tiver processado uma mensagem de término do diálogo ou de erro para a conversa, o Service Broker notificará o lado remoto de que a conversa terminou. As mensagens que o Service Broker envia ao serviço remoto dependem das opções especificadas:

• Se a conversa terminar sem erros e a conversa com o serviço remoto ainda estiver ativa, o Service Broker enviará uma mensagem do tipo https://schemas.microsoft.com/SQL/ServiceBroker/EndDialog ao serviço remoto. O Service Broker acionará essa mensagem à fila de transmissão na ordem da conversa. O Service Broker envia todas as mensagens dessa conversa que estão atualmente na fila de transmissão antes de enviar esta mensagem.

• Se a conversa terminar com um erro e a conversa com o serviço remoto ainda estiver ativa, o Service Broker enviará uma mensagem do tipo https://schemas.microsoft.com/SQL/ServiceBroker/Error ao serviço remoto. Service Broker remove qualquer outra mensagem desta conversa atualmente na fila de transmissão.

• A cláusula WITH CLEANUP permite que um administrador de banco de dados remova conversas que não são concluídas normalmente. Essa opção remove todas as mensagens e entradas da exibição do catálogo para a conversa. Observe que, neste caso, o lado remoto da conversa não recebe nenhuma indicação de que a conversa terminou, e talvez não receba mensagens que tenham sido enviadas por um aplicativo e ainda não transmitidas pela rede. Evite essa opção a menos que a conversa não possa ser concluída normalmente.

Quando uma conversa termina, uma instrução SEND Transact-SQL que especifica o identificador de conversa gera um erro Transact-SQL. Se as mensagens para esta conversa chegarem do outro lado da conversa, o Service Broker as descartará

Se uma conversa terminar enquanto o serviço remoto ainda não tiver enviado mensagens para ela, o serviço remoto descartará as mensagens não enviadas. Isso não é considerado um erro, e o serviço remoto não recebe nenhuma notificação de que mensagens foram descartadas.

Os códigos de falha especificados na cláusula WITH ERROR devem ser números positivos. Os números negativos são reservados para mensagens de erro do Service Broker.

END CONVERSATION não é válida em uma função definida pelo usuário.

Permissões

Para terminar uma conversa ativa, o usuário atual deve ser o proprietário da conversa, um membro da função de servidor fixa sysadmin ou um membro da função de banco de dados fixa db_owner.

Um membro da função de servidor fixa sysadmin ou um membro da função de banco de dados fixa db_owner poderá usar WITH CLEANUP para remover os metadados de uma conversa que já foi concluída.

Exemplos

A.Terminando uma conversa

O exemplo a seguir encerra o diálogo especificado por @dialog\_handle.

END CONVERSATION @dialog_handle ;

B.Terminando uma conversa com um erro

O exemplo a seguir encerrará o diálogo especificado por @dialog\_handle com um erro se a instrução de processamento informar um erro. Observe que esta é uma abordagem simplista de tratamento de erros, e pode não ser apropriada para alguns aplicativos.

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.Limpando uma conversa que não pode ser concluída normalmente

O exemplo a seguir encerra o diálogo especificado por @dialog\_handle. O SQL Server remove imediatamente todas as mensagens da fila de serviço e da fila de transmissão, sem notificar o serviço remoto. Como o término de um diálogo com a limpeza não notifica o serviço remoto, você deve usar isso apenas nos casos em que o serviço remoto não está disponível para receber uma mensagem EndDialog ou Error.

END CONVERSATION @dialog_handle WITH CLEANUP ;

Consulte também

Referência

BEGIN CONVERSATION TIMER (Transact-SQL)

BEGIN DIALOG CONVERSATION (Transact-SQL)

sys.conversation_endpoints (Transact-SQL)