GET CONVERSATION GROUP (Transact-SQL)

Retorna o identificador de grupo de conversação para a próxima mensagem a ser recebida e bloqueia o grupo para a conversação que contém a mensagem. O identificador de grupo de conversação pode ser usado para recuperar informações de estado da conversação antes de recuperar a própria mensagem.

Convenções de sintaxe Transact-SQL

Sintaxe

[ WAITFOR ( ]
   GET CONVERSATION GROUP @conversation_group_id
      FROM <queue>
[ ) ] [ , TIMEOUT timeout ]
[ ; ]


<queue> ::=
{
    [ database_name . [ schema_name ] . | schema_name . ] queue_name
}

Argumentos

• WAITFOR
  Especifica que a instrução GET CONVERSATION GROUP aguarde a chegada de uma mensagem na fila se nenhuma mensagem estiver presente.

• @conversation\_group\_id
  É uma variável usada para armazenar a ID de grupo de conversação retornada pela instrução GET CONVERSATION GROUP. A variável deve ser do tipo uniqueidentifier. Se não houver grupos de conversação disponíveis, a variável será definida como NULL.

• FROM
  Especifica a fila na qual o grupo de conversação deve ser obtido.

• database_name
  É o nome do banco de dados que contém a fila na qual o grupo de conversação deve ser obtido. Quando nenhum database_name é fornecido, o padrão é o banco de dados atual.

• schema_name
  É o nome do esquema proprietário da fila na qual o grupo de conversação deve ser obtido. Quando nenhum schema_name é fornecido, o padrão é o nome de esquema padrão do usuário atual.

• queue_name
  É o nome da fila na qual o grupo de conversação deve ser obtido.

• TIMEOUT timeout
  Especifica o intervalo de tempo, em milissegundos, que o Agente de Serviços aguarda a chegada de uma mensagem na fila. Essa cláusula só pode ser usada com a cláusula WAITFOR. Se a instrução que usa WAITFOR não incluir essa cláusula ou timeout for -1, o período de espera será ilimitado. Se o intervalo expirar, GET CONVERSATION GROUP definirá a variável @conversation\_group\_id como NULL.

Comentários

Importante
Se a instrução GET CONVERSATION GROUP não for a primeira instrução de um lote ou procedimento armazenado, a instrução anterior deverá ser encerrada com um ponto-e-vírgula (;), o terminador de instrução Transact-SQL.

Se a fila especificada na instrução GET CONVERSATION GROUP não estiver disponível, a instrução falhará com um erro Transact-SQL.

Essa instrução retorna o próximo grupo de conversação onde as seguintes afirmações são verdadeiras:

• O grupo de conversação pode ser bloqueado com êxito.

• O grupo de conversação possui mensagens disponível na fila.

• O grupo de conversação tem o nível de prioridade mais alto de todos os grupos de conversação que atendem aos critérios listados anteriormente. O nível de prioridade de um grupo de conversação é o mais alto atribuído a qualquer conversação que seja um membro do grupo e possua mensagens na fila.

As chamadas sucessivas a GET CONVERSATION GROUP na mesma transação podem bloquear mais de um grupo de conversação. Se nenhum grupo de conversação estiver disponível, a instrução retornará NULL como o identificador de grupo de conversação.

Quando a cláusula WAITFOR é especificada, a instrução aguarda o tempo limite especificado ou até um grupo de conversação estar disponível. Se a fila for descartada enquanto a instrução estiver aguardando, a instrução retornará um erro imediatamente.

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

Permissões

Para obter um identificador de grupo de conversação em uma fila, o usuário atual deve ter a permissão RECEIVE na fila.

Exemplos

A. Obtendo um grupo de conversação, aguardando indefinidamente

O exemplo a seguir define @conversation\_group\_id como o identificador de grupo de conversação para a próxima mensagem disponível em ExpenseQueue. O comando aguarda até uma mensagem ficar disponível.

DECLARE @conversation_group_id UNIQUEIDENTIFIER ;

WAITFOR (
 GET CONVERSATION GROUP @conversation_group_id
     FROM ExpenseQueue
) ;

B. Obtendo um grupo de conversação, aguardando um minuto

O exemplo a seguir define @conversation\_group\_id como o identificador de grupo de conversação para a próxima mensagem disponível em ExpenseQueue. Se nenhuma mensagem ficar disponível dentro de um minuto, GET CONVERSATION GROUP retornará sem alterar o valor de @conversation\_group\_id.

DECLARE @conversation_group_id UNIQUEIDENTIFIER

WAITFOR (
    GET CONVERSATION GROUP @conversation_group_id 
    FROM ExpenseQueue ),
TIMEOUT 60000 ;

C. Obtendo um grupo de conversação, retornando imediatamente

O exemplo a seguir define @conversation\_group\_id como o identificador de grupo de conversação para a próxima mensagem disponível em ExpenseQueue. Se nenhuma mensagem estiver disponível, GET CONVERSATION GROUP retornará imediatamente sem alterar @conversation\_group\_id.

DECLARE @conversation_group_id UNIQUEIDENTIFIER ;

GET CONVERSATION GROUP @conversation_group_id
FROM AdventureWorks.dbo.ExpenseQueue ;

Consulte também

Referência

BEGIN DIALOG CONVERSATION (Transact-SQL)

MOVE CONVERSATION (Transact-SQL)

Conceitos

Bloqueios de grupo de conversação