system-indices
각 테이블에 생성된 인덱스의 메타데이터를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 없음 (테이블 읽기 권한 필요) |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
system-indices [verbose={t|f}] [TABLE_PATTERN]
옵션
verbose={t|f}- 스토리지 사용량(
storage_consumption) 정보를 추가로 조회합니다. (기본값:f)
t: 스토리지 사용량 정보를 포함하여 조회합니다.f: 스토리지 사용량 정보를 조회하지 않습니다.
TABLE_PATTERN- 조회할 테이블 패턴. 쉼표(
,)로 구분하여 여러 패턴을 지정할 수 있습니다. 지정하지 않으면 사용자에게 읽기 권한이 부여된 모든 테이블을 조회합니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| table | 문자열 | 테이블 이름 |
| index | 문자열 | 인덱스 이름 |
| use_bloom_filter | 불리언 | 블룸 필터 사용 여부. true이면 사용, false이면 미사용 |
| base_path | 문자열 | 인덱스 저장 경로 (절대 경로). 클러스터 관리자 권한이 있는 경우에만 반환합니다. |
| tokenizer_name | 문자열 | 인덱스 토큰 추출에 사용하는 토크나이저 이름 |
| tokenizer_configs | 객체 | 토크나이저 설정값 (예: 쿼리 문자열) |
| min_index_day | 문자열 | 인덱스가 가리키는 가장 이른 날짜 (yyyy-MM-dd 형식). 설정하지 않은 경우 null |
| max_index_day | 문자열 | 인덱스가 가리키는 가장 늦은 날짜 (yyyy-MM-dd 형식). 설정하지 않은 경우 null |
| indexed_days | 문자열 | 실제 인덱스 파티션이 존재하는 날짜 범위 (yyyy-MM-dd ~ yyyy-MM-dd 형식). 없으면 N/A |
| storage_consumption | 64비트 정수 | 인덱스 저장 공간 크기 (바이트). verbose=t로 지정한 경우에만 반환합니다. |
| build_past_index | 불리언 | 인덱스 생성 시 과거 데이터도 함께 색인 여부 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95101 | invalid-verbose-option | verbose 옵션 값이 올바르지 않은 경우 |
| 95102 | invalid-table-pattern | 테이블 패턴이 올바르지 않은 경우 |
런타임 오류
해당 사항 없음
설명
system-indices 명령어는 테이블별 인덱스의 설정 정보를 조회합니다. 인덱스 이름, 블룸 필터 사용 여부, 토크나이저 설정, 색인 날짜 범위 등을 확인할 수 있습니다.
base_path 필드는 클러스터 관리자 권한이 있는 세션에서만 반환됩니다. storage_consumption 필드는 verbose=t 옵션을 지정한 경우에만 반환되며, 인덱스 디렉터리 내 모든 파일 크기의 합계입니다.
테이블 패턴에는 이름의 시작이나 끝에 와일드카드(*)를 사용할 수 있습니다.
사용 예
-
전체 테이블의 인덱스 메타데이터 조회
system-indices -
특정 테이블의 인덱스 조회
system-indices SONAR_EVENTS -
스토리지 사용량 포함 조회
system-indices verbose=t | eval size_mb = round(storage_consumption / 1048576, 2) | fields table, index, size_mb, indexed_days | sort -size_mb -
블룸 필터를 사용하는 인덱스 조회
system-indices | search use_bloom_filter == true | fields table, index, tokenizer_name, indexed_days
호환성
system-indices 명령어는 소나 4.0 이전 버전부터 제공되었습니다.