AI 색인 사용

AI.SEARCH 함수를 사용하여 데이터를 쿼리할 수 있으며, BigQuery는 열 선택, 색인 최적화, 지속적인 유지보수를 자동으로 처리합니다.

이 문서에서는 AI 색인을 만들고, 모니터링하고, 삭제하는 방법과 색인이 생성된 데이터를 쿼리하는 방법을 설명합니다.

역할 및 권한

AI 색인을 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

AI 색인 만들기

CREATE AI INDEX 데이터 정의 언어(DDL) 문을 사용하여 표준 BigQuery 테이블에 AI 색인을 만들 수 있습니다. 색인을 생성할 열을 지정하거나 BigQuery에서 AUTO COLUMNS 옵션을 사용하여 후보 열을 자동으로 선택하도록 할 수 있습니다.

AI 색인 생성 제한사항

AI 색인을 만들 때는 다음 제한사항이 적용됩니다.

  • 최상위 수준의 반복되지 않는 STRING 열만 지원됩니다. ARRAY<STRING>, STRUCT, JSON, ObjectRef, 중첩 필드, STRING 이외의 열, 의사 열은 지원되지 않습니다.
  • 단일 AI 색인에서 최대 50개의 열을 색인 생성할 수 있습니다.
  • AI 색인은 표준 BigQuery 테이블에서만 만들 수 있습니다. 뷰, 구체화된 뷰, 외부 테이블, BigLake 테이블, Apache Iceberg 테이블, 테이블 스냅샷은 지원되지 않습니다.
  • 리전 간 복제본이 있는 데이터 세트에서는 AI 색인을 만들 수 없습니다.
  • CREATE AI INDEX를 실행할 때 기본 테이블은 주문형 프로젝트의 경우 최대 1,000,000개의 행을 포함할 수 있으며, 테이블이 포함된 프로젝트에 BACKGROUND 예약 할당이 있는 경우 최대 100,000,000개의 행을 포함할 수 있습니다.
  • AUTO COLUMNS는 CREATE AI INDEX 문이 실행될 때 열을 선택합니다. 나중에 테이블에 열을 추가하면 자동으로 색인이 생성되지 않습니다. 새 열을 포함하려면 AI 색인을 삭제하고 다시 만듭니다.
  • 각 테이블은 최대 1개의 AI 색인을 지원합니다. AI 색인이 있는 테이블에는 벡터 색인이나 자동으로 생성된 임베딩 열이 있을 수 없습니다.

제한사항의 전체 목록은 AI 색인 제한사항을 참조하세요.

AUTO COLUMNS로 AI 색인 만들기

AUTO COLUMNS로 AI 색인을 만들면 BigQuery가 테이블 스키마를 자동으로 스캔하고 적합한 열을 최대 50개까지 선택합니다. AUTO COLUMNS로 AI 색인을 만들려면 CREATE AI INDEX DDL 문을 사용합니다.

  1. Google Cloud 콘솔에서 BigQuery Studio로 이동합니다.

    BigQuery Studio로 이동

  2. 쿼리 편집기에서 다음 SQL 문을 실행합니다.

    CREATE AI INDEX INDEX_NAME
    ON DATASET_NAME.TABLE_NAME(AUTO COLUMNS);

    다음을 바꿉니다.

    • INDEX_NAME: 만들려는 AI 색인의 이름입니다. 색인은 항상 기본 테이블과 동일한 프로젝트 및 데이터 세트에 생성되므로 색인 이름에 프로젝트 또는 데이터 세트를 지정할 필요가 없습니다. 색인 이름은 테이블의 모든 색인 중에서 고유해야 합니다.
    • DATASET_NAME: 테이블이 포함된 데이터 세트의 이름입니다.
    • TABLE_NAME: 색인을 생성할 표준 테이블의 이름입니다.

다음 예시에서는 mydataset.products에 AUTO COLUMNS를 사용하여 AI 색인을 만듭니다.

CREATE AI INDEX products_ai_index
ON mydataset.products(AUTO COLUMNS);

특정 열에 AI 색인 만들기

단일 열 또는 특정 열 하위 집합에 AI 색인을 만들 수 있습니다. 예를 들어 테이블에 사용 가능한 열이 50개 이상 있거나 불투명 ID, UUID, 해시, 원시 로그와 같이 민감하거나 노이즈가 많은 열을 제외하려는 경우입니다. 여러 열을 지정하는 경우 제목 또는 이름 열과 같이 가장 유용한 열을 열 목록의 처음에 배치합니다.

다음 예시에서는 mydataset.products의 name 및 description 열에만 AI 색인이 생성됩니다.

CREATE AI INDEX products_ai_index
ON mydataset.products(name, description);

다음 예시에서는 mydataset.products의 description 열에만 AI 색인이 생성됩니다.

CREATE AI INDEX products_ai_index
ON mydataset.products(description);

AI 색인으로 테이블 검색

AI.SEARCH 함수를 사용하여 AI 색인이 있는 테이블을 쿼리할 수 있습니다. 테이블에 AI 색인이 있는 경우 base_table 또는 base_table_query, query_value의 두 가지 인수만 필요합니다.

색인이 생성된 모든 열에서 검색

AI 색인이 적용되는 모든 열을 검색하려면 column_to_search 인수를 생략하고 기본 테이블과 쿼리 문자열을 전달합니다.

다음 예시에서는 AI 색인에 포함된 mydataset.products의 모든 열을 검색합니다.

SELECT
  base.id,
  base.name,
  base.description,
  distance
FROM
  AI.SEARCH(
    TABLE mydataset.products,
    'shoes that keep your feet dry in the rain',
    top_k => 5)
ORDER BY distance;

AI 색인 상태 모니터링

다음 INFORMATION_SCHEMA 뷰를 쿼리하여 AI 색인의 상태, 범위, 색인 생성된 열을 모니터링할 수 있습니다.

  • INFORMATION_SCHEMA.AI_INDEXES: 데이터 세트의 각 AI 색인에 대한 메타데이터를 포함합니다.
  • INFORMATION_SCHEMA.AI_INDEX_COLUMNS: 데이터 세트의 각 AI 색인에서 다루는 열을 나열하여 AUTO COLUMNS를 사용할 때 선택된 열을 확인할 수 있습니다.
  • INFORMATION_SCHEMA.JOBS: AI 색인을 만들고 유지하는 데 사용되는 백그라운드 작업을 포함하여 백그라운드 작업에 대한 정보가 포함됩니다.

AI 색인 예시

다음 쿼리는 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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+

AI 색인 열 예시

다음 쿼리는 my_project.my_dataset의 AI 색인에 대해 색인이 생성된 열을 나열합니다.

SELECT
  table_name,
  index_name,
  index_column_name
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;

결과는 다음과 비슷합니다.

+------------+-------------------+-------------------+
| table_name | index_name        | index_column_name |
+------------+-------------------+-------------------+
| products   | products_ai_index | name              |
| products   | products_ai_index | description       |
| products   | products_ai_index | category          |
| products   | products_ai_index | review            |
+------------+-------------------+-------------------+

백그라운드 작업 비용 추적 예시

테이블의 백그라운드 AI 색인 데이터 처리 작업에 대한 total_slot_ms 및 total_bytes_billed 값을 추적하려면 job_id 프리픽스가 gc_인 작업에 대해 INFORMATION_SCHEMA.JOBS 뷰를 쿼리합니다.

SELECT
  job_id,
  creation_time,
  reservation_id,
  total_slot_ms,
  total_bytes_processed,
  total_bytes_billed
FROM
  `region-REGION`.INFORMATION_SCHEMA.JOBS j
WHERE
  EXISTS (
    SELECT 1
    FROM UNNEST(j.referenced_tables) t
    WHERE
      j.project_id = 'PROJECT_ID'
      AND t.dataset_id = 'DATASET_ID'
      AND t.table_id = 'TABLE'
  )
  AND STARTS_WITH(job_id, 'gc_')
ORDER BY
  j.creation_time DESC;

다음을 바꿉니다.

  • REGION: 테이블이 포함된 데이터 세트 리전입니다(예: us).
  • PROJECT_ID: 테이블이 포함된 프로젝트의 ID입니다.
  • DATASET_ID: 테이블이 포함된 데이터 세트의 이름입니다.
  • TABLE: AI 색인이 포함된 테이블의 이름입니다.

AI 색인 삭제

색인이 생성된 테이블을 삭제하면 AI 색인도 삭제됩니다. 테이블을 삭제하지 않고 AI 색인을 삭제하려면 DROP AI INDEX DDL 문을 사용합니다.

DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;

다음을 바꿉니다.

  • INDEX_NAME: 삭제할 AI 색인의 이름입니다.
  • DATASET_NAME: 테이블이 포함된 데이터 세트의 이름입니다.
  • TABLE_NAME: AI 색인이 포함된 테이블의 이름입니다.

다음 단계