system-tables
시스템에 등록된 테이블 목록과 설정 정보를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 없음 |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
system-tables [verbose=BOOL] [TABLE_PATTERN]
옵션
verbose=BOOL- 디스크 사용량 등 테이블의 상세 정보를 함께 조회합니다 (기본값:
f).t지정 시min_day,max_day,disk_usage필드가 추가로 반환됩니다.
대상
TABLE_PATTERN- 조회할 테이블의 이름 패턴. 여러 패턴을 지정할 때는 쉼표(
,)로 구분합니다. 이름의 시작이나 끝에 와일드카드(*)를 사용할 수 있습니다. 지정하지 않으면 모든 테이블을 조회합니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| table | 문자열 | 테이블 이름 |
| metadata | 맵 | 테이블의 메타데이터 |
| primary_configs | 맵 | 주 스토리지 설정 정보 |
| replica_configs | 맵 | 백업 스토리지 설정 정보 |
| lock_owner | 맵 | 락 소유자 (관리자 전용) |
| lock_purpose | 배열 | 락을 건 목적 (관리자 전용) |
| lock_reentcnt | 32비트 정수 | 락 재진입 횟수 (관리자 전용) |
| retention_policy | 문자열 | 테이블 데이터 보관 주기 (단위: 일). 보관 주기가 설정되지 않으면 null을 반환합니다. |
| data_path | 문자열 | 테이블 데이터 파일 경로 (관리자 전용) |
| is_locked | 불리언 | 테이블 잠금 여부. true(잠김) 또는 false(잠기지 않음) (관리자 전용) |
| privileges | 배열 | 사용자 계정별 테이블 접근 권한 (관리자 전용) |
| security_groups | 배열 | 보안 그룹별 테이블 접근 권한 (관리자 전용) |
verbose=t 지정 시 추가로 반환되는 필드:
| 필드 | 타입 | 설명 |
|---|---|---|
| min_day | 날짜 | 가장 오래된 파티션의 날짜 |
| max_day | 날짜 | 가장 최근 파티션의 날짜 |
| disk_usage | 64비트 정수 | 디스크 사용량 (단위: 바이트) |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95081 | 잘못된 verbose 옵션 값입니다: [value] | verbose 옵션에 올바르지 않은 불리언 값을 지정한 경우 |
| 95082 | 잘못된 테이블 패턴입니다: [table_pattern] | 테이블 패턴 형식이 올바르지 않은 경우 |
런타임 오류
해당 사항 없음
설명
system-tables 명령어는 시스템에 등록된 테이블 목록과 각 테이블의 설정 정보를 조회합니다.
관리자 권한이 없는 사용자는 읽기 권한이 부여된 테이블만 조회할 수 있으며, lock_owner, lock_purpose, lock_reentcnt, data_path, is_locked, privileges, security_groups 필드는 반환되지 않습니다.
관리자 권한이 있는 사용자는 모든 테이블을 조회할 수 있으며, 락 상태, 데이터 경로, 접근 권한 정보가 추가로 반환됩니다.
verbose 옵션을 t로 지정하면 각 테이블의 디스크 사용량과 파티션 날짜 범위를 추가로 조회합니다.
사용 예
-
전체 테이블 목록 조회
system-tables -
특정 패턴의 테이블 조회
system-tables sys_* -
상세 정보 포함 조회
system-tables verbose=t -
여러 테이블 패턴 지정
system-tables sys_*,iis_* -
디스크 사용량 기준 정렬
system-tables verbose=t | sort -disk_usage
호환성
system-tables 명령어는 소나 4.0 이전 버전부터 제공되었습니다.