Cloud SQL 데이터 정의 언어 (DDL)

이 페이지에서는 MySQL 데이터 정의 언어 (DDL) 문에 대한 Cloud SQL 확장 프로그램의 구문을 정의합니다.

VECTOR 문

이 섹션에는 VECTOR 문이 나와 있습니다.

CREATE VECTOR INDEX

벡터 색인을 만듭니다.

CREATE VECTOR INDEX index_name
[opt_index_type]
ON table_name (column_name)
[index_options]

where opt_index_type is:
 | USING SCANN

where index_option is :
 USING SCANN
 | [QUANTIZER=SQ8]
 | [NUM_LEAVES=int_value]
 | DISTANCE_MEASURE=L2_SQUARED|DOT_PRODUCT|COSINE

매개변수

  • USING SCANN: 필수 항목입니다. 벡터 색인을 만들 때 사용할 색인 유형입니다. 이 알고리즘은 ScaNN 색인을 만듭니다. 유일하게 지원되는 값은 SCANN입니다. 이 매개변수는 수정할 수 없습니다.
  • QUANTIZER: 선택사항입니다. 이 매개변수는 고차원 벡터를 압축된 표현에 매핑합니다. 유일하게 지원되는 값은 SQ8입니다. 이 매개변수는 수정할 수 없습니다.
  • NUM_LEAVES: 선택사항입니다. 빌드할 파티션 (리프) 수를 지정합니다. ANN 검색 및 데이터 세트에 대해 잘 알고 있는 경우에만 이 설정을 기본 설정에서 변경하세요. 지정된 숫자는 기본 테이블의 임베딩 수보다 클 수 없습니다.
  • DISTANCE_MEASURE: 필수 항목입니다. 두 벡터의 유사성을 계산하는 수학적 공식입니다. 이 매개변수에서 approx_distance 검색 옵션의 거리와 동일한 거리 측정 방식을 설정해야 합니다. 지원되는 측면은 다음과 같습니다.
    • L2_SQUARED
    • COSINE
    • DOT_PRODUCT

예시

다음 예는 table_name 테이블에 벡터 색인을 만드는 방법을 보여줍니다.

CREATE
  VECTOR INDEX index1
ON table_name(vector_column_name)
USING SCANN QUANTIZER = SQ8 DISTANCE_MEASURE = l2_squared;

ALTER TABLE

기존 테이블에 벡터 색인을 추가합니다. 벡터 검색에는 색인 옵션으로 SCANN이 필요하며 정규화 유형은 SQ8여야 합니다.

ALTER TABLE table_name
  ADD VECTOR INDEX index_name(key_part)[index_option];

WHERE key_part is:{ _col_name_[(_length_)] | (_expr_) }
WHERE
  index_option
  is:USING
    SCANN
    | [QUANTIZER = SQ8]
    | [NUM_LEAVES = int_value]
    | DISTANCE_MEASURE
  = L2_SQUARED | DOT_PRODUCT | COSINE

매개변수

  • USING SCANN: 필수 항목입니다. 벡터 색인을 만들 때 사용할 색인 유형입니다. 이 알고리즘은 ScaNN 색인을 만듭니다. 유일하게 지원되는 값은 SCANN입니다. 이 매개변수는 수정할 수 없습니다.
  • QUANTIZER: 선택사항입니다. 이 매개변수는 고차원 벡터를 압축된 표현에 매핑합니다. 유일하게 지원되는 값은 SQ8입니다. 이 매개변수는 수정할 수 없습니다.
  • NUM_LEAVES: 선택사항입니다. 빌드할 파티션 (리프) 수를 지정합니다. ANN 검색 및 데이터 세트에 대해 잘 알고 있는 경우에만 이 설정을 기본 설정에서 변경하세요. 지정된 숫자는 기본 테이블의 임베딩 수보다 클 수 없습니다.
  • DISTANCE_MEASURE: 필수 항목입니다. 두 벡터의 유사성을 계산하는 수학적 공식입니다. 이 매개변수에서 approx_distance 검색 옵션의 거리와 동일한 거리 측정 방식을 설정해야 합니다. 지원되는 측면은 다음과 같습니다.
    • L2_SQUARED
    • COSINE
    • DOT_PRODUCT

예시

다음 예는 t1 테이블에 벡터 색인을 추가하는 방법을 보여줍니다.

ALTER TABLE t1 ADD VECTOR INDEX index1(j)
USING SCANN QUANTIZER = SQ8 DISTANCE_MEASURE = l2_squared;

다음 단계