일관된 푸시와 롤백

일관된 푸시와 롤백 (Consistent Push and Rollback)

오프라인 세그먼트를 일관되게(consistently) 푸시하고 실패 시 롤백하는 방법을 안내해요.

출처: 문서

본문

개요 (Overview)

오프라인 배치 적재에서, 일부 세그먼트만 푸시되고 나머지는 실패하면 테이블이 불완전한 상태가 될 수 있어요. 일관된 푸시(consistent push)는 세그먼트 배치를 원자적으로(atomically) 반영해서, 푸시 도중 실패해도 테이블이 항상 완전한 상태(이전 또는 새 상태)를 유지하게 해요. 실패 시 자동으로 이전 상태로 롤백할 수 있어요.

배치 일관성 (Batch consistency)

오프라인 테이블의 배치 세그먼트 푸시는 테이블의 segmentPushType(APPEND 또는 REFRESH)과 분리 모드(sealed)에 따라 동작해요. 일관된 푸시는 푸시된 세그먼트 집합이 하나의 단위로 반영되도록 보장해요.

롤백 (Rollback)

푸시가 실패하면 이전 상태로 롤백해 쿼리가 부분적으로 갱신된 데이터를 보지 않도록 해요. 이는 오프라인 테이블의 일관성을 유지하고 잘못된 데이터가 서빙되는 것을 방지해요.

구성 (Configuration)

일관된 푸시는 테이블 구성의 segmentsConfig 관련 설정에서 활성화·제어할 수 있어요. 관련 구성에는 푸시 타입과 일관성 보장 방식이 포함돼요.

모범 사례 (Best practices)

  • 배치 재적재가 빈번하거나 전체 배치의 일관성이 중요한 오프라인 테이블에 사용하세요.
  • 푸시 실패 시 롤백 동작을 테스트해 데이터 무결성을 검증하세요.

더 알아보기 (Learn more)