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_consumption64비트 정수인덱스 저장 공간 크기 (바이트). verbose=t로 지정한 경우에만 반환합니다.
build_past_index불리언인덱스 생성 시 과거 데이터도 함께 색인 여부

오류 코드

파싱 오류
오류 코드메시지설명
95101invalid-verbose-optionverbose 옵션 값이 올바르지 않은 경우
95102invalid-table-pattern테이블 패턴이 올바르지 않은 경우
런타임 오류

해당 사항 없음

설명

system-indices 명령어는 테이블별 인덱스의 설정 정보를 조회합니다. 인덱스 이름, 블룸 필터 사용 여부, 토크나이저 설정, 색인 날짜 범위 등을 확인할 수 있습니다.

base_path 필드는 클러스터 관리자 권한이 있는 세션에서만 반환됩니다. storage_consumption 필드는 verbose=t 옵션을 지정한 경우에만 반환되며, 인덱스 디렉터리 내 모든 파일 크기의 합계입니다.

테이블 패턴에는 이름의 시작이나 끝에 와일드카드(*)를 사용할 수 있습니다.

사용 예

  1. 전체 테이블의 인덱스 메타데이터 조회

    system-indices
    
  2. 특정 테이블의 인덱스 조회

    system-indices SONAR_EVENTS
    
  3. 스토리지 사용량 포함 조회

    system-indices verbose=t
    | eval size_mb = round(storage_consumption / 1048576, 2)
    | fields table, index, size_mb, indexed_days
    | sort -size_mb
    
  4. 블룸 필터를 사용하는 인덱스 조회

    system-indices
    | search use_bloom_filter == true
    | fields table, index, tokenizer_name, indexed_days
    

호환성

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