system-table-blocks

테이블 파티션의 블록 메타데이터를 조회합니다.

명령어 속성

항목	설명
명령어 유형	드라이버 쿼리
필요 권한	없음
라이선스 사용량	집계 안 함
병렬 실행	미지원
분산 실행	미지원

문법

system-table-blocks table=TABLE [day=DATE] [sk=HEX] [era=LONG]

옵션

table=TABLE: 블록 정보를 조회할 테이블 이름을 지정합니다. 필수 옵션입니다.
day=DATE: 블록 정보를 조회할 날짜를 yyyyMMdd 형식으로 지정합니다. 지정하지 않으면 모든 날짜를 조회합니다.
sk=HEX: 조회할 파티션 서브 키를 16진수로 지정합니다. 지정하지 않으면 모든 서브 키를 조회합니다.
era=LONG: 조회할 파티션 식별자를 지정합니다. 지정하지 않으면 모든 파티션을 조회합니다.

출력 필드

필드	타입	설명
table	문자열	테이블 이름
partition	문자열	테이블 파티션의 이름
block_id	32비트 정수	테이블 파티션의 블록 번호
ver	32비트 정수	데이터 블록의 파일 포맷 버전
min_time	날짜	블록 기준 첫 로그의 타임스탬프
max_time	날짜	블록 기준 마지막 로그의 타임스탬프
log_count	64비트 정수	블록 내 레코드 개수
original_size	64비트 정수	블록의 원본 크기 (단위: 바이트)
compressed_size	64비트 정수	블록의 압축 크기 (단위: 바이트)
reserved	불리언	블록의 예약 상태
sto_class	32비트 정수	스토리지 파티션의 생명 주기를 나타내는 정수 값. `0`~`9999`: Hot 티어, `10000`~`19999`: Warm 티어, `20000`~`29999`: Cold 티어
sto_path	문자열	테이블과 인덱스 파일이 저장되어 있는 위치
signature	바이너리	블록 서명 데이터
iv	바이너리	블록 암호화 초기화 벡터

오류 코드

파싱 오류

오류 코드	메시지	설명
95121	table 옵션이 필요합니다.	`table` 옵션을 지정하지 않은 경우
95122	테이블 이름이 올바르지 않습니다: [table]	`table` 옵션 값이 유효한 테이블 이름이 아닌 경우
95123	day 값이 올바르지 않습니다: [day]	`day` 옵션 값을 날짜로 파싱할 수 없는 경우
95124	sk 값이 올바르지 않습니다: [sk]	`sk` 옵션 값이 유효한 16진수가 아닌 경우
95125	era 값이 올바르지 않습니다: [era]	`era` 옵션 값이 유효한 정수가 아닌 경우

런타임 오류

해당 사항 없음

설명

system-table-blocks 명령어는 테이블 파티션의 블록 단위 메타데이터를 조회합니다. 각 블록의 레코드 개수, 원본 크기, 압축 크기, 타임스탬프 범위 등의 정보를 확인할 수 있습니다.

table 옵션은 필수이며, 조회할 테이블 이름을 지정해야 합니다. day, sk, era 옵션을 조합하여 특정 파티션의 블록만 조회할 수 있습니다.

사용 예

특정 테이블의 전체 블록 메타데이터 조회
```
system-table-blocks table=my_table
```

특정 날짜 파티션의 블록 조회

system-table-blocks table=my_table day=20260301

압축률 계산

system-table-blocks table=my_table
| eval ratio = double(compressed_size) / double(original_size) * 100
| fields partition, block_id, log_count, original_size, compressed_size, ratio

호환성

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