중복 검색

  • 아티클

애플리케이션이 메시지를 보낸 직후 치명적인 오류로 인해 실패하고 다시 시작된 애플리케이션 인스턴스가 이전 메시지 전송이 발생하지 않았다고 잘못 판단하면, 후속 보내기로 인해 동일한 메시지가 시스템에 두 번 표시됩니다.

또한 클라이언트 또는 네트워크 수준의 오류가 잠시 전에 발생하고, 보낸 메시지가 큐에 커밋되어, 승인이 클라이언트에 성공적으로 반환되지 않을 수도 있습니다. 이런 시나리오에서 클라이언트는 보내기 작업의 결과에 의문을 갖게 됩니다.

중복 검색은 보낸 사람이 동일한 메시지를 다시 보낼 수 있도록 하고 큐 또는 토픽에서 중복된 복사본을 삭제하여 이러한 상황에 대한 의문을 해소합니다.

참고 항목

Service Bus의 기본 계층에서는 중복 검색을 지원하지 않습니다. 표준 및 프리미엄 계층은 중복 검색을 지원합니다. 이러한 계층 간의 차이점은 Service Bus 가격 책정을 참조하세요.

작동 방식

중복 검색을 사용하면 지정된 기간 동안 큐 또는 토픽으로 전송된 모든 메시지의 애플리케이션 제어 MessageId를 추적하는 데 도움이 됩니다. 해당 기간 중에 기록된 MessageId로 새 메시지가 전송되면 해당 메시지는 수락된 것으로 보고되고(보내기 작업 성공), 새로 보낸 메시지는 즉시 무시되고 삭제됩니다. MessageId를 제외한 메시지의 다른 부분은 고려되지 않습니다.

식별자의 애플리케이션 제어는 통해 애플리케이션이 오류 발생시 예측 가능하게 재구성할 수 있는 비즈니스 프로세스 컨텍스트에 MessageId를 연결하도록 허용하기 때문에 필수적입니다.

애플리케이션 컨텍스트를 처리하는 과정에서 여러 메시지가 전송되는 비즈니스 프로세스의 경우 MessageId는 구매 주문 번호와 같은 애플리케이션 수준 컨텍스트 식별자와 메시지 제목을 결합한 것(예: 12345.2017/payment)이 될 수 있습니다.

MessageId는 항상 GUID일 수 있지만 식별자를 비즈니스 프로세스에 고정하면 예측 가능한 반복성을 얻을 수 있으며 이것은 중복 검색 기능을 효과적으로 활용하는 데 바람직합니다.

Important

  • 분할을 사용하는 경우 고유성 확인에 MessageId+PartitionKey가 사용됩니다. 세션을 사용하는 경우 분할 키와 세션 ID가 동일해야 합니다.
  • 분할을 사용하지 않는 경우(기본값) 고유성 확인에 MessageId만 사용됩니다.
  • SessionId, PartitionKey 및 MessageId에 대한 자세한 내용은 파티션 키 사용을 참조하세요.

참고 항목

예약된 메시지는 중복 검색에 포함됩니다. 따라서 예약된 메시지를 보낸 다음, 예약되지 않은 중복 메시지를 보내면 예약되지 않은 메시지가 삭제됩니다. 마찬가지로 예약되지 않은 메시지를 보낸 다음, 예약된 중복 메시지를 보내면 예약된 메시지가 삭제됩니다.

중복 검색 기간 크기

중복 검색을 사용하도록 설정하는 것 외에도 메시지 ID가 유지되는 동안 중복 검색 기록 기간의 크기를 구성할 수도 있습니다. 이 값은 큐 및 토픽의 경우 기본적으로 10분이며 최솟값은 20분, 최댓값은 7일입니다.

기록된 모든 메시지 ID는 새로 제출된 메시지 식별자와 일치해야 하기 때문에 중복 검색 사용과 기간의 크기는 큐(및 토픽) 처리량에 직접적인 영향을 줍니다.

기간을 작게 하면 유지하고 일치시켜야 할 메시지 ID 수가 줄어들기 때문에 처리량에 미치는 영향이 작아집니다. 중복 검색이 필요한 처리량이 많은 엔터티의 경우 기간을 가능한 작게 유지해야 합니다.

다음 단계

Azure Portal, PowerShell, CLI, Resource Manager 템플릿, .NET, Java, Python 및 JavaScript를 사용하여 중복 메시지 검색을 사용하도록 설정할 수 있습니다. 자세한 내용은 중복 메시지 검색 사용을 참조하세요.

클라이언트 코드가 이전과 동일한 MessageId를 사용하여 메시지를 다시 전송할 수 없는 시나리오에서는 안전하게 다시 처리할 수 있는 메시지를 디자인하는 것이 중요합니다. 멱동성(idempotence)에 관한 이 블로그 게시물에서는 이를 수행하는 방법에 대한 다양한 기술을 설명합니다.

선택한 언어로 샘플을 사용하여 Azure Service Bus 기능을 살펴봅니다.

이전 .NET 및 Java 클라이언트 라이브러리에 대한 샘플은 다음을 참조하세요.

2026년 9월 30일에 Azure SDK 지침을 따르지 않는 Azure Service Bus SDK 라이브러리 WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus 및 com.microsoft.azure.servicebus를 사용 중지합니다. 또한 SBMP 프로토콜에 대한 지원이 종료되므로 2026년 9월 30일 이후에는 더 이상 이 프로토콜을 사용할 수 없습니다. 해당 날짜 마이그레이션에 중요한 보안 업데이트와 개선된 기능을 제공하는 최신 Azure SDK 라이브러리로 마이그레이션합니다.

이전 라이브러리는 2026년 9월 30일 이후에도 계속 사용할 수 있지만 더 이상 Microsoft로부터 공식 지원 및 업데이트를 받을 수 없습니다. 자세한 내용은 사용 중지 공지 지원을 참조하세요.