MSK Serverless 클러스터에 대한 구성 속성

Amazon MSK는 서버리스 클러스터에 대한 브로커 구성 속성을 설정합니다. 이러한 브로커 구성 속성 설정은 변경할 수 없지만 그러나 다음 주제 수준의 구성 속성을 설정하거나 수정할 수 있습니다. 다른 모든 주제 수준의 구성 속성은 구성할 수 없습니다.

구성 속성	Default	편집 가능	최대 허용 값
cleanup.policy	삭제	예, 그러나 주제를 생성할 때만 가능합니다.
compression.type	생산자	예
max.message.bytes	1048588	예	8388608(8MiB)
message.timestamp.difference.max.ms	long.max	예
message.timestamp.type	CreateTime	예
retention.bytes	250GiB	예	무제한, 무제한 보존을 위해 -1로 설정
retention.ms	7일	예	무제한, 무제한 보존을 위해 -1로 설정

이러한 주제 수준의 구성 속성을 설정하거나 수정하기 위해 Apache Kafka 명령줄 도구를 사용할 수 있습니다. 자세한 내용과 설정 방법은 공식 Apache Kafka 설명서의 3.2 주제 수준 구성을 참조하세요.

참고

MSK Serverless의 토픽에 대한 segment.bytes 구성은 수정할 수 없습니다. 그러나 Kafka Streams 애플리케이션은 MSK Serverless에서 허용하는 것과 다른 segment.bytes 구성 값으로 내부 토픽 생성을 시도할 수 있습니다. MSK Serverless로 Kafka Streams를 구성하는 방법에 대한 자세한 내용은 MSK Express 브로커 및 MSK Serverless를 통해 Kafka Streams 사용 섹션을 참조하세요.

Amazon MSK Serverless에서 Apache Kafka 명령줄 도구를 사용하는 경우 Amazon MSK Serverless 시작하기 설명서의 클라이언트 머신에 Apache Kafka 클라이언트 도구를 설정하려면 섹션에서 1~4단계를 완료했는지 확인합니다. 또한 명령에 --command-config client.properties 파라미터를 포함해야 합니다.

예를 들어 다음 명령을 사용하여 retention.bytes 주제의 구성 속성을 수정하여 무제한 보존을 설정할 수 있습니다.

<path-to-your-kafka-client-installation>/bin/kafka-configs.sh —bootstrap-server <bootstrap_server_string> —command-config client.properties --entity-type topics --entity-name <topic_name> --alter --add-config retention.bytes=-1

이 예제에서는 <bootstrap server string>을 Amazon MSK Serverless 클러스터의 부트스트랩 서버 엔드포인트로 바꾸고, <topic_name>을 수정하려는 주제 이름으로 바꿉니다.

--command-config client.properties 파라미터는 Kafka 명령줄 도구에서 적절한 구성 설정을 사용하여 Amazon MSK Serverless 클러스터와 통신하도록 합니다.