GET CONVERSATION GROUP(Transact-SQL)

아티클
05/30/2023

적용 대상: SQL Server Azure SQL Managed Instance

다음에 받을 메시지에 대한 대화 그룹 식별자를 반환하고 해당 메시지를 포함하는 대화에 대한 대화 그룹을 잠급니다. 대화 그룹 식별자는 메시지 자체를 받기 전에 대화 상태 정보를 검색하는 데 사용할 수 있습니다.

구문

[ WAITFOR ( ]  
   GET CONVERSATION GROUP @conversation_group_id  
      FROM <queue>  
[ ) ] [ , TIMEOUT timeout ]  
[ ; ]  
  
<queue> ::=  
{ database_name.schema_name.queue_name | schema_name.queue_name | queue_name }

인수

WAITFOR
현재 메시지가 없으면 메시지가 큐에 도착할 때까지 GET CONVERSATION GROUP 문이 대기하도록 지정합니다.

@conversation_group_id
GET CONVERSATION GROUP 문에서 반환한 대화 그룹 ID를 저장하는 데 사용되는 변수입니다. 변수는 uniqueidentifier 형식이어야 합니다. 사용할 수 있는 대화 그룹이 없으면 변수가 NULL로 설정됩니다.

FROM
대화 그룹을 가져올 큐를 지정합니다.

database_name
대화 그룹을 가져올 큐를 포함하는 데이터베이스의 이름입니다. database_name을 제공하지 않으면 기본값은 현재 데이터베이스입니다.

schema_name
대화 그룹을 가져올 큐를 소유하는 스키마의 이름입니다. schema_name을 제공하지 않으면 기본값은 현재 사용자의 기본 스키마입니다.

queue_name
대화 그룹을 가져올 큐의 이름입니다.

TIMEOUT 제한 시간
메시지가 큐에 도착할 때까지 Service Broker에서 대기하는 시간(밀리초)을 지정합니다. 이 절은 WAITFOR 절에서만 사용할 수 있습니다. WAITFOR를 사용하는 문이 이 절을 포함하지 않거나 timeout이 -1이면 대기 시간에 제한이 없습니다. 제한 시간이 만료되면 GET CONVERSATION GROUP이 @conversation_group_id 변수를 NULL로 설정합니다.

설명

중요

GET CONVERSATION GROUP 문이 일괄 처리 또는 저장 프로시저에서 첫 번째 문이 아닌 경우 이전 문은 Transact-SQL 문 종결자인 세미콜론(;)으로 종결되어야 합니다.

GET CONVERSATION GROUP 문에 지정된 큐를 사용할 수 없으면 Transact-SQL 오류가 발생하여 문이 실패합니다.

이 문은 아래 조건이 모두 충족되는 경우 다음 대화 그룹을 반환합니다.

대화 그룹을 성공적으로 잠글 수 있습니다.
큐에 대화 그룹이 사용할 수 있는 메시지가 있습니다.
대화 그룹이 앞서 나열한 조건을 충족하는 모든 대화 그룹 중에서 가장 높은 우선 순위를 가집니다. 대화 그룹의 우선 순위 수준이 그룹 멤버인 모든 대화에 할당된 우선 순위 중에서 가장 높으며 큐에 메시지가 있습니다.

같은 트랜잭션 내에서 GET CONVERSATION GROUP을 연속 호출하면 둘 이상의 대화 그룹이 잠길 수 있습니다. 사용 가능한 대화 그룹이 없으면 대화 그룹 식별자로 NULL이 반환됩니다.

WAITFOR 절을 지정하면 문은 지정된 제한 시간 동안 대기하거나 대화 그룹을 사용할 수 있을 때까지 대기합니다. 문이 대기하는 동안 큐가 삭제되면 즉시 오류가 반환됩니다.

GET CONVERSATION GROUP은 사용자 정의 함수에 유효하지 않습니다.

사용 권한

큐에서 대화 그룹 식별자를 가져오려면 현재 사용자가 큐에 대한 RECEIVE 권한을 가져야 합니다.

예제

A. 무한 대기하여 대화 그룹 가져오기

다음 예에서는 @conversation_group_id를 ExpenseQueue에 있는 사용 가능한 다음 메시지의 대화 그룹 식별자로 설정합니다. 명령은 메시지를 사용할 수 있게 될 때까지 대기합니다.

DECLARE @conversation_group_id UNIQUEIDENTIFIER ;  
  
WAITFOR (  
 GET CONVERSATION GROUP @conversation_group_id  
     FROM ExpenseQueue  
) ;

B. 1분간 대기하여 대화 그룹 가져오기

다음 예에서는 @conversation_group_id를 ExpenseQueue에 있는 사용 가능한 다음 메시지의 대화 그룹 식별자로 설정합니다. 1분 이내에 사용 가능한 메시지가 없으면 GET CONVERSATION GROUP이 @conversation_group_id 값을 그대로 반환합니다.

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

C. 즉시 실행하여 대화 그룹 가져오기

다음 예에서는 @conversation_group_id를 ExpenseQueue에 있는 사용 가능한 다음 메시지의 대화 그룹 식별자로 설정합니다. 사용 가능한 메시지가 없으면 GET CONVERSATION GROUP은 @conversation_group_id를 변경하지 않은 채 즉시 반환합니다.

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

참고 항목

BEGIN DIALOG CONVERSATION(Transact-SQL)
MOVE CONVERSATION(Transact-SQL)

다음을 통해 공유