GET CONVERSATION GROUP(Transact-SQL)

아티클
12/15/2008

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

구문

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


<queue> ::=
{
    [ database_name . [ schema_name ] . | schema_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 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 권한을 가져야 합니다.

예

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

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

DECLARE @conversation_group_id UNIQUEIDENTIFIER ;

WAITFOR (
 GET CONVERSATION GROUP @conversation_group_id
     FROM ExpenseQueue
) ;

2. 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 ;

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

다음 예에서는 @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 ;

GET CONVERSATION GROUP(Transact-SQL)

구문

인수

주의

사용 권한

예

참고 항목

참조

관련 자료

도움말 및 정보

추가 리소스