AI_INDEXES 뷰
INFORMATION_SCHEMA.AI_INDEXES 뷰에는 데이터 세트에 있는 각 AI 색인에 대해 하나의 행이 포함되어 있습니다.
필수 권한
AI 색인 메타데이터를 보려면 색인이 있는 테이블에 대한 bigquery.tables.get 또는 bigquery.tables.list Identity and Access Management(IAM) 권한이 필요합니다. 다음과 같은 사전 정의된 IAM 역할에는 이러한 권한 중 하나 이상이 포함되어 있습니다.
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/bigquery.user
BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.
스키마
INFORMATION_SCHEMA.AI_INDEXES 뷰를 쿼리하면 쿼리 결과에는 데이터 세트의 각 AI 인덱스에 대한 행이 하나씩 포함됩니다.
INFORMATION_SCHEMA.AI_INDEXES 뷰에는 다음과 같은 스키마가 있습니다.
| 열 이름 | 데이터 유형 | 값 |
|---|---|---|
index_catalog |
STRING |
데이터 세트가 포함된 프로젝트의 이름입니다. |
index_schema |
STRING |
AI 색인이 포함된 데이터 세트 이름입니다. |
table_name |
STRING |
AI 색인이 생성되는 테이블의 이름입니다. |
index_name |
STRING |
AI 색인의 이름입니다. |
index_status |
RECORD |
AI 색인의 상태로, index_state(STRING) 및 message(STRING)를 포함합니다. |
creation_time |
TIMESTAMP |
AI 색인이 생성된 시간입니다. |
last_modification_time |
TIMESTAMP |
AI 색인 구성이 마지막으로 수정된 시간입니다. |
disable_time |
TIMESTAMP |
AI 색인이 사용 중지된 시간입니다. 색인이 사용 중지되지 않은 경우 NULL입니다. |
ddl |
STRING |
AI 색인을 만드는 데 사용되는 DDL 문입니다. |
coverage_percentage |
INTEGER |
AI 색인으로 색인이 생성된 테이블 행의 대략적인 비율입니다. |
unindexed_row_count |
INTEGER |
아직 AI 색인으로 색인이 생성되지 않은 테이블의 행 수입니다. |
total_logical_bytes |
INTEGER |
AI 색인에서 사용하는 청구 가능한 총 논리 바이트입니다. |
범위 및 구문
이 뷰에 대한 쿼리에는 데이터세트 한정자가 있어야 합니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.
| 뷰 이름 | 리소스 범위 | 리전 범위 |
|---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES |
데이터 세트 수준 | 데이터 세트 위치 |
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다.DATASET_ID: 데이터 세트의 ID입니다.
예
다음 쿼리는 my_project.my_dataset에 있는 모든 AI 색인의 적용 범위와 스토리지 크기를 보여줍니다.
SELECT table_name, index_name, creation_time, coverage_percentage, unindexed_row_count, total_logical_bytes FROM my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;
결과는 다음과 비슷합니다.
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| table_name | index_name | creation_time | coverage_percentage | unindexed_row_count | total_logical_bytes |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| products | products_ai_index | 2026-10-01 18:02:11 | 100 | 0 | 25344 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+