본문으로 건너뛰기
최종 수정: 에

버전 안내

버전 번호란 무엇인가요?​

Apache Doris는 세 부분으로 구성된 버전 번호(X.Y.Z)를 사용하며, 각 자리는 서로 다른 릴리스 유형을 나타냅니다.

버전 번호 위치이름설명
X메이저 버전주요 기능 릴리스 또는 아키텍처 업그레이드, 약 1년 주기
Y마이너 버전중요한 기능 추가 및 성능 개선, 약 분기별 주기
Z패치 버전버그 수정 및 성능 개선, 2-4주 주기

예시: 버전 2.1.0은 메이저 버전 2, 마이너 버전 1, 패치 버전 0을 나타냅니다.

업그레이드 전에 반드시 알아야 할 사항​

버전 번호 위치에 따른 호환성 차이​

버전 유형메타데이터 / 데이터 형식 변경호환성 안내
메이저 버전 (X)변경될 수 있음순방향 호환성은 제공하지만 역방향 호환성은 보장하지 않음
마이너 버전 (Y)변경 없음새 기능을 사용하지 않는 한 순방향 및 역방향 호환성을 모두 보장함
패치 버전 (Z)변경 없음순방향 및 역방향 호환성을 완전히 보장하므로 자유롭게 업그레이드 또는 다운그레이드 가능
중요

메이저 버전을 업그레이드할 때는 이전 버전으로의 다운그레이드가 보장되지 않습니다. 업그레이드 전에 데이터를 백업하세요.

업그레이드 전 확인 사항​

  • 대상 버전이 메이저, 마이너, 패치 릴리스 중 어디에 해당하는지 확인하세요
  • 중요한 데이터와 메타데이터를 백업하세요
  • 테스트 환경에서 업그레이드 절차를 검증하세요
  • 버전 호환성 안내가 있다면 검토하세요

버전 선택 방법​

Apache Doris는 두 가지 최신 버전 브랜치를 유지 관리합니다.

버전 유형사용 사례설명
LatestPOC, 성능 테스트, 새 기능 체험최신 기능이 포함되어 있으며 불안정할 수 있음
Stable프로덕션 환경버그 수정이 지속적으로 반영되며 안정성이 높음

선택 가이드:

  • 프로덕션 환경: Stable 선택
  • 기능 탐색 및 테스트: Latest 선택

CPU 모델 및 바이너리 선택​

Doris는 CPU 명령어 세트에 따라 세 가지 바이너리 버전을 제공합니다.

버전지원 CPU설명
x64 (avx2)avx2 명령어 세트를 지원하는 x86_64 CPU최고의 성능
x64 (no avx2)avx2를 지원하지 않는 x86_64 CPU호환성 우선
ARM64ARM 아키텍처 CPUApple M-series, Kunpeng 등

CPU의 avx2 지원 여부 확인 방법​

cat /proc/cpuinfo | grep avx2

명령어 실행 결과가 출력되면 해당 CPU는 avx2 명령어 세트를 지원하므로, 더 나은 성능을 위해 x64 (avx2) 빌드를 선택할 수 있습니다.

버전 간 업그레이드 규칙​

아래 매트릭스에는 버전 간 업그레이드 시 고려해야 할 사항이 정리되어 있습니다. 이 테이블의 내용은 지속적으로 업데이트됩니다.

버전 업그레이드 호환성 매트릭스​

TODO

현재 버전 → 대상 버전3.0.x3.1.x4.0.x4.1.x
3.0.x-
3.1.x-
4.0.x-
4.1.x-
참고
  • "-"는 업그레이드가 필요하지 않음(현재 버전)을 나타냅니다
  • 빈 셀은 업그레이드 안내가 아직 추가되지 않았음을 나타냅니다
  • 업그레이드 전에 반드시 대상 버전의 업그레이드 문서를 읽으세요

자주 묻는 질문​

질문: 2.0에서 3.1로 업그레이드할 수 있나요?​

네. 다만 메이저 버전 업그레이드에는 데이터 형식 변경이 수반될 수 있습니다. 업그레이드 전에 다음을 준비하세요.

  1. 데이터를 백업하세요
  2. 테스트 환경에서 검증하세요
  3. 롤백 계획을 준비하세요

질문: 패치 버전은 언제든지 업그레이드할 수 있나요?​

네. 패치 버전(예: 2.1.0에서 2.1.1로 업그레이드)은 순방향 및 역방향 호환성이 모두 보장되므로 언제든지 업그레이드하거나 다운그레이드할 수 있습니다.

질문: 현재 Doris 버전은 어떻게 확인하나요?​

SELECT VERSION();를 실행하여 현재 버전을 쿼리하세요.

질문: Latest 및 Stable 버전은 어디에서 다운로드할 수 있나요?​

Apache Doris 다운로드 페이지에서 모든 버전의 다운로드 링크를 확인할 수 있습니다.

  • [TODO] - 클러스터 업그레이드 상세 절차
  • [TODO] - 데이터 백업 방법
Report issue