system-table-partitions

테이블에 저장된 레코드 개수를 파티션별로 조회합니다.

system-table-partitions [duration=INT{mon|w|d|h|m|s}] [from=DATE] [to=DATE] [diskonly=BOOL] [era=LONG] [TABLE_PATTERN]

duration=INT{mon|w|d|h|m|s}

현재 시각으로부터 일정 시간 범위 이내의 파티션만 조회합니다. mon(월), w(주), d(일), h(시), m(분), s(초) 단위를 사용합니다. 예: 10s는 쿼리 실행 시각을 기준으로 최근 10초를 의미합니다.

from=DATE

조회 범위의 시작 일자. yyyyMMdd 형식으로 입력합니다. 시작 일자를 포함하여 조회합니다. 지정하지 않으면 전체 기간에 대해 조회합니다.

to=DATE

조회 범위의 끝 일자. yyyyMMdd 형식으로 입력합니다. 지정한 일자도 조회 범위에 포함합니다. 지정하지 않으면 전체 기간에 대해 조회합니다.

diskonly=BOOL

조회 대상을 지정합니다. (기본값: f)

era=LONG

파티션 식별자를 지정합니다. 지정하면 해당 식별자의 파티션만 조회합니다. 지정하지 않으면 모든 파티션을 조회합니다.

TABLE_PATTERN

조회할 테이블의 이름 패턴. 여러 테이블을 지정할 때는 쉼표(,)로 구분합니다. 이름의 시작이나 끝에 와일드카드(*)를 사용할 수 있습니다. 지정하지 않으면 읽기 권한이 있는 모든 테이블을 조회합니다.

필드	타입	설명
_time	날짜	파티션 일자
sk	문자열	파티션 서브 키 (16진수). 더 이상 사용하지 않습니다.
era	64비트 정수	파티션 식별자
table	문자열	테이블 이름
count	64비트 정수	파티션 내 레코드 개수
sto_class	32비트 정수	스토리지 파티션의 생명 주기를 나타내는 정수 값. 0~9999: Hot 티어, 10000~19999: Warm 티어, 20000~29999: Cold 티어
sto_path	문자열	스토리지 경로 또는 URI

오류 코드	메시지	설명
95030	from 값이 유효하지 않습니다.	`from` 옵션 값을 날짜로 파싱할 수 없는 경우
95031	to 값이 유효하지 않습니다.	`to` 옵션 값을 날짜로 파싱할 수 없는 경우
95032	from 값이 유효하지 않습니다.	`to` 값이 `from` 값보다 이전인 경우
95150	잘못된 파티션 식별자 형식입니다: [era]. 10진법 정수를 사용하세요.	`era` 옵션 값이 유효한 정수가 아닌 경우

해당 사항 없음

system-table-partitions 명령어는 테이블에 저장된 레코드 개수를 파티션별로 조회합니다. 각 파티션의 날짜, 테이블 이름, 레코드 건수, 스토리지 클래스, 스토리지 경로 정보를 반환합니다.

기본적으로 메모리에 버퍼링된 데이터 건수도 포함하여 조회합니다. diskonly=t 옵션을 지정하면 디스크에 기록된 건수만 조회합니다.

관리자 권한이 없는 사용자는 읽기 권한이 부여된 테이블만 조회할 수 있습니다.

최근 7일 이내의 파티션만 조회

system-table-partitions duration=7d sys_cpu_logs

날짜 범위를 지정하여 조회

system-table-partitions from=20260301 to=20260317 sys_cpu_logs

디스크에 기록된 건수만 조회

system-table-partitions diskonly=t sys_cpu_logs

테이블별 전체 레코드 건수 합산

system-table-partitions | stats sum(count) as total_count by table

system-table-partitions 명령어는 소나 4.0 이전 버전부터 제공되었습니다.