인스턴스에서 벡터 임베딩 사용 설정 및 중지

이 섹션에서는 벡터 임베딩의 스토리지, 색인 생성, 쿼리를 지원하도록 Cloud SQL 인스턴스를 구성하는 방법을 설명합니다.

Cloud SQL Enterprise 버전과 Cloud SQL Enterprise Plus 버전 모두 벡터 임베딩을 지원합니다. MySQL 8.0.36 이상 버전의 모든 버전이 지원됩니다.

시작하기 전에

사용자 계정에 Cloud SQL 관리자 및 Compute 뷰어 역할이 있는지 확인합니다.

자세한 내용은 역할 및 권한을 참조하세요.

벡터 임베딩에 데이터베이스 플래그 사용 설정

벡터 임베딩 지원을 사용 설정하려면 MySQL 데이터베이스 플래그를 사용 설정해야 합니다.

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

다음을 바꿉니다.

  • INSTANCE_NAME: 벡터 임베딩 지원을 사용 설정하려는 인스턴스의 이름입니다.

  • FLAGS: 인스턴스에서 다음 MySQL 플래그를 구성합니다.

    • cloudsql_vector: 벡터 임베딩 저장소 및 벡터 유사성 검색 지원을 사용 설정하려면 이 플래그를 on로 설정합니다. 이 플래그는 기본적으로 사용 중지되어 있습니다. 플래그를 구성하면 명령어가 다음과 유사합니다.

      gcloud sql instances patch my-instance \
--database-flags=cloudsql_vector=on

      cloudsql_vector 플래그는 정적입니다. 플래그를 사용하여 인스턴스를 업데이트 (사용 설정 또는 사용 중지)하면 구성 변경사항이 적용되도록 인스턴스가 자동으로 다시 시작됩니다.

MySQL에 대해 데이터베이스 플래그를 구성하는 방법은 데이터베이스 플래그 구성을 참조하세요.

벡터 임베딩 사용 중지

인스턴스에서 벡터 임베딩을 사용 중지하기 전에 인스턴스의 모든 벡터 색인을 명시적으로 삭제해야 합니다. 인스턴스에서 벡터 색인 목록을 찾는 방법을 알아보려면 벡터 색인 모니터링을 참고하세요.

벡터 임베딩 지원을 사용 중지하면 새 벡터 임베딩 열과 벡터 색인을 만들 수 없습니다. 또한 벡터 검색에 approx_distance 함수를 사용할 수 없습니다. 벡터 임베딩 지원을 중지하려면 cloudsql_vector 플래그를 off로 설정합니다. 이 정적 플래그를 구성한 다음에는 구성 변경사항이 적용되도록 인스턴스가 자동으로 다시 시작됩니다.

벡터 임베딩 지원을 사용 중지하려면 cloudsql_vector 플래그를 off로 설정합니다.

예를 들면 다음과 같습니다.

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

INSTANCE_NAME을 벡터 임베딩 지원을 중지하려는 인스턴스 이름으로 바꿉니다.

다음 단계