SHOW INDEX

설명

이 문은 테이블의 인덱스 정보를 표시하는 데 사용됩니다. 내부 테이블에서는 역색인과 ann 인덱스만 지원합니다.

Lance Filesystem Catalog의 테이블에 대해 이 문을 실행하면 Lance 데이터셋에 기록된 논리 스칼라 및 벡터 인덱스가 표시되며, Table, Key_name, Seq_in_index, Column_name, Index_type, Properties 열에만 값이 표시됩니다. Lance REST Catalog는 지원하지 않습니다. 자세한 내용은 Lance 인덱스 확인을 참조하세요.

Iceberg 및 Paimon과 같은 다른 외부 Catalog의 테이블에 대해 이 문을 실행하면 빈 결과가 반환됩니다. 이러한 형식은 시스템 테이블을 통해 테이블 메타데이터를 제공합니다. Iceberg 시스템 테이블 및 Paimon 시스템 테이블을 참조하세요. Paimon 인덱스 파일은 table_indexes 시스템 테이블을 통해 확인할 수 있습니다.

구문

SHOW INDEX [ ES ] FROM [ <db_name>. ] <table_name> [ FROM <db_name> ];

대체 구문

SHOW KEY[ S ] FROM [ <db_name>. ] <table_name> [ FROM <db_name> ];

필수 매개변수

1. <table_name>: 인덱스가 속한 테이블의 이름입니다.

선택적 매개변수

1. <db_name>: 데이터베이스 이름으로, 선택 사항입니다. 지정하지 않으면 기본적으로 현재 데이터베이스를 사용합니다.

반환 값

열 이름	유형	설명
Table	string	인덱스가 있는 테이블의 이름입니다.
Non_unique	int	인덱스의 고유 여부를 나타냅니다. - 0: 고유 인덱스 - 1: 고유하지 않은 인덱스
Key_name	string	인덱스의 이름입니다.
Seq_in_index	int	인덱스에서 열의 위치입니다. 여러 열이 복합 인덱스를 구성할 때 인덱스 내 열의 순서를 나타냅니다.
Column_name	string	인덱스가 생성된 열의 이름입니다.
Collation	string	인덱스 열의 정렬 순서입니다. - A: 오름차순 - D: 내림차순.
Cardinality	int	인덱스에 있는 고유 값의 수입니다. 이 값은 쿼리 효율을 추정하는 데 사용되며, 값이 클수록 인덱스의 선택도와 쿼리 효율이 높아집니다.
Sub_part	int	인덱스에서 사용하는 접두사 길이입니다. 인덱스 열이 문자열 유형인 경우 Sub_part는 인덱스의 처음 몇 문자에 해당하는 길이를 나타냅니다.
Packed	string	인덱스의 압축 여부입니다.
Null	string	NULL 값의 허용 여부입니다. - YES: NULL 값 허용 - NO: NULL 값 허용 안 함
Index_type	string	인덱스 유형입니다. - BTREE: B+ tree 인덱스(MySQL의 기본 유형) - HASH: 해시 인덱스 - RTREE: R-tree 인덱스 - INVERTED: 역색인(예: 전문 인덱스)
Comment	string	인덱스에 대한 주석이나 설명으로, 일반적으로 사용자 지정 비고입니다.
Properties	string	인덱스의 추가 속성입니다.

접근 제어 요구 사항

이 SQL 명령을 실행하는 사용자는 최소한 다음 권한을 보유해야 합니다.

권한	객체	비고
SHOW_PRIV	데이터베이스

예제

• 지정한 table_name의 인덱스 표시

   SHOW INDEX FROM example_db.table_name;

• Lance Catalog 테이블의 논리 인덱스 표시

   SHOW INDEX FROM lance_catalog.default.items;