VECTOR_INDEX_COLUMNS 뷰
이 기능에 대한 의견을 제공하거나 지원을 요청하려면 bq-vector-search@google.com으로 이메일을 보내 주세요.
INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
뷰에는 데이터 세트의 각 테이블에 대한 벡터 색인 생성 열마다 행이 하나씩 포함됩니다.
필수 권한
벡터 색인 메타데이터를 보려면 색인이 있는 테이블에 대한 bigquery.tables.get
또는 bigquery.tables.list
Identity and Access Management(IAM) 권한이 필요합니다. 다음과 같은 사전 정의된 IAM 역할에는 이러한 권한 중 하나 이상이 포함되어 있습니다.
roles/bigquery.admin
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.dataViewer
roles/bigquery.metadataViewer
roles/bigquery.user
BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.
스키마
INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
뷰를 쿼리하면 쿼리 결과에서 데이터 세트에 있는 각 테이블의 색인이 생성된 각 열마다 행이 하나씩 포함됩니다.
INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
뷰에는 다음과 같은 스키마가 있습니다.
열 이름 | 데이터 유형 | 값 |
---|---|---|
index_catalog |
STRING |
데이터 세트가 포함된 프로젝트의 이름입니다. |
index_schema |
STRING |
벡터 색인이 포함된 데이터 세트 이름입니다. |
table_name |
STRING |
벡터 색인이 생성되는 테이블 이름입니다. |
index_name |
STRING |
벡터 색인의 이름입니다. |
index_column_name |
STRING |
색인이 생성된 열의 이름입니다. |
index_field_path |
STRING |
확장되고 색인이 생성된 필드의 전체 경로이며, 열 이름으로 시작합니다. 필드는 마침표로 구분됩니다. |
범위 및 구문
이 뷰에 대한 쿼리에는 데이터 세트 한정자가 있어야 합니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.
뷰 이름 | 리소스 범위 | 리전 범위 |
---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS |
데이터 세트 수준 | 데이터 세트 위치 |
- (선택사항)
PROJECT_ID
: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다. DATASET_ID
: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.
예시
-- Returns metadata for vector indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;
예시
다음 쿼리는 벡터 색인이 있는 열에 대한 정보를 추출합니다.
SELECT table_name, index_name, index_column_name, index_field_path
FROM my_project.dataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;
결과는 다음과 비슷합니다.
+------------+------------+-------------------+------------------+ | table_name | index_name | index_column_name | index_field_path | +------------+------------+-------------------+------------------+ | table1 | indexa | a | a | | table2 | indexb | b | b | | table3 | indexc | c | c | +------------+------------+-------------------+------------------+