일괄 메시징은 커스텀 일괄 처리 설정으로 게시자 클라이언트를 만들고 이를 사용하여 일부 메시지를 게시합니다.
이 문서에서는 주제에 게시된 메시지에 일괄 메시징을 사용하는 방법을 설명합니다.
시작하기 전에
게시 워크플로를 구성하기 전에 다음 작업이 완료되어야 합니다.
- 주제 및 게시 워크플로 자세히 알아보기
- 주제 만들기
필요한 역할
주제에 메시지를 게시하는 데 필요한 권한을 얻으려면 관리자에게 주제에 대한 Pub/Sub 게시자(roles/pubsub.publisher
) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
주제 및 구독을 만들거나 업데이트하려면 추가 권한이 필요합니다.
일괄 메시징 사용
게시자의 메시지 일괄 처리 설정을 구성하는 방법은 다음 코드 샘플을 참조하세요.
C++
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C++ 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C++ API 참고 문서를 확인하세요.
C#
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참고 문서를 확인하세요.
Go
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참고 문서를 참조하세요.
자바
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 자바 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Java API 참고 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참고 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참고 문서를 참조하세요.
PHP
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 Pub/Sub PHP API 참고 문서를 참조하세요.
Python
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참고 문서를 참조하세요.
Ruby
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Ruby API 참고 문서를 참조하세요.
메시지 일괄 처리 사용 중지
클라이언트 라이브러리에서 일괄 처리를 해제하려면 max_messages
값을 1로 설정합니다.
메시지 일괄 처리 및 정렬된 전송
정렬된 전송을 사용할 경우 배치의 메시지를 확인하지 못하면 배치의 모든 메시지(확인되지 않은 메시지 이전에 전송된 메시지 포함)가 모두 다시 전송됩니다.
메시지 일괄 처리의 할당량 및 한도
메시지 일괄 처리를 구성하기 전에 게시 처리량 할당량 및 최대 배치 크기와 같은 요인의 영향을 고려하세요. 상위 수준의 클라이언트 라이브러리는 배치 요청이 지정된 한도 내에서 유지되도록 합니다.
- 실제 메시지 크기가 1,000바이트보다 작더라도 비용 측면에서 권장되는 최소 요청 크기는 1,000바이트입니다.
- Pub/Sub의 단일 배치 게시 요청은 크기 10MB 또는 메시지 수 1,000개로 제한됩니다.
자세한 내용은 Pub/Sub 할당량 및 한도를 참조하세요.
다음 단계
고급 게시 옵션을 구성하는 방법은 다음을 참조하세요.