Time Travel

Iceberg 테이블의 스냅샷을 활용한 타임 트래블 API입니다. 과거 시점의 데이터를 조회하고 스냅샷 이력을 관리합니다.

엔드포인트

GET /api/v1/time-travel/snapshots

설명: 테이블의 스냅샷 목록을 반환합니다.

쿼리 파라미터:

파라미터	타입	필수	설명
table	string	Y	테이블 이름 (catalog.schema.table)

응답:

{
  "snapshots": [
    {"snapshot_id": 123456, "committed_at": "2026-04-01T00:00:00Z", "operation": "append"}
  ]
}

POST /api/v1/time-travel/query

설명: 특정 스냅샷 시점의 데이터를 조회합니다.

요청 본문:

필드	타입	필수	설명
table	string	Y	테이블 이름 (catalog.schema.table)
snapshot_id	int	N	스냅샷 ID
timestamp	string	N	조회 시점 (ISO 8601)

인증

JWT Bearer 토큰이 필요합니다.

참고

• Iceberg 테이블만 타임 트래블을 지원합니다.
• snapshot_id 또는 timestamp 중 하나를 지정해야 합니다.

에러 코드

코드	설명
400	잘못된 테이블 이름 또는 스냅샷 파라미터
404	스냅샷을 찾을 수 없음
500	Trino 타임 트래블 쿼리 실패