JSCODE Logo
프로그래밍 과외블로그후기멘토진
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호
학원 명칭 : 제이에스코드(JSCODE)원격학원학원설립ㆍ운영 등록번호 : 제6063호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2025 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침
← 블로그 목록으로 돌아가기

특정 토픽의 파티션 수 조회하기 / 설정하기 / 변경하기

JSCODE 박재성
JSCODE 박재성
2025-12-06
author
JSCODE 박재성
category
Kafka
createdAt
Dec 6, 2025
series
실전에서 바로 써먹는 Kafka 입문
slug
view-set-change-partition-count
type
post
updatedAt
Dec 6, 2025 05:39 AM

✅ 특정 토픽의 파티션 수 조회하기

토픽에 설정된 파티션 수를 조회하려면 이전에 배웠던 특정 토픽의 세부 정보 조회를 할 때 사용하는 명령어를 입력하면 된다.
# 특정 토픽 세부 정보 조회 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic email.send
notion image
  • PartitionCount : 토픽이 가지고 있는 파티션의 총 개수
    • → 별도의 옵션을 주지 않고 토픽을 생성하면 기본적으로 파티션은 1개만 생성된다.
  • Partition : 파티션 번호 (0번 부터 시작)
 
 

✅ 토픽 생성할 때 파티션 수 설정하기

  1. 토픽 생성하기 (+ 파티션 수 설정하기)
    1. # 문법 $ bin/kafka-topics.sh \ --bootstrap-server <kafka 주소> \ --create \ --topic <토픽명> \ --partitions <파티션 수> # 예제 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --create \ --topic test.topic \ --partitions 3
       
  1. 잘 생성됐는 지 확인하기
    1. $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic test.topic
      notion image
      파티션 수가 3개로 잘 설정된 걸 확인할 수 있다.
       
      그림으로 표현하면 다음과 같다.
      notion image
 
 

✅ 기존 토픽의 파티션 수 늘리기

  1. 기존 토픽의 파티션 수 늘리기
    1. # 문법 $ bin/kafka-topics.sh \ --bootstrap-server <kafka 주소> \ --alter \ --topic <토픽명> \ --partitions <변경할 최종 파티션 수> # 예제 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --alter \ --topic test.topic \ --partitions 5
 
  1. 잘 생성됐는 지 확인하기
    1. $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic test.topic
      notion image
      파티션 수가 5개로 잘 변경된 걸 확인할 수 있다.
       
 

✅ 기존 토픽의 파티션 수 줄이기

파티션 수를 3개에서 5개로 늘린 걸, 다시 3개로 줄여보자.
$ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --alter \ --topic test.topic \ --partitions 3
notion image
기존 토픽의 파티션 수를 줄이려고 했더니 에러가 발생했다.
 
Kafka에서는 파티션 수를 늘릴 수는 있지만 줄일 수는 없게 만들어놨다. 파티션을 줄이는 과정에서 내부적으로 문제(데이터 손실, 성능 저하 등)가 많이 발생하기 때문이다. 그래서 파티션을 줄이고 싶다면 새로운 토픽을 생성해서 파티션 수를 다시 설정해야 한다. 그리고 기존 토픽을 새로운 토픽으로 마이그레이션 시켜야 한다. 파티션 수를 줄이기 위해 기존 토픽에서 새로운 토픽으로 마이그레이션 시키는 과정이 귀찮기 때문에, 처음 파티션 수를 설정할 때 신중하게 설정하는 걸 권장하는 편이다.
author
JSCODE 박재성
category
Kafka
createdAt
Dec 6, 2025
series
실전에서 바로 써먹는 Kafka 입문
slug
type
series-footer
updatedAt
Dec 6, 2025 05:39 AM
📎
이 글은 실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편) 강의의 수업 자료 중 일부입니다.