Mengaktifkan dan menonaktifkan penelusuran vektor

MySQL   |  PostgreSQL   |  SQL Server

Catatan: Untuk menggunakan versi ketersediaan umum (GA) penelusuran vektor MySQL, versi pemeliharaan instance Anda harus versi MYSQL_8_0_36.R20241208.01_00 atau yang lebih baru. Untuk mengetahui informasi tentang cara mengupgrade instance Anda ke versi yang lebih baru yang mendukung embedding vektor GA, lihat Melakukan pemeliharaan mandiri.

Untuk mengetahui informasi tentang sintaksis dan perilaku embedding vektor untuk versi Pratinjau fitur ini, lihat Menggunakan embedding vektor (Pratinjau).

Jika Anda sudah menggunakan versi GA penelusuran vektor di Cloud SQL untuk MySQL 8.0 atau 8.4 dan ingin mengupgrade ke Cloud SQL untuk MySQL 9.7, tinjau perbedaan dalam dukungan vektor MySQL di Cloud SQL untuk MySQL 9.7 sebelum Anda melakukan upgrade versi utama ke Cloud SQL untuk MySQL 9.7.

Bagian ini menjelaskan cara mengonfigurasi instance Cloud SQL untuk mendukung penyimpanan, pengindeksan, dan kueri embedding vektor.

Instance Cloud SQL edisi Enterprise dan Cloud SQL edisi Enterprise Plus mendukung embedding vektor. Semua versi MySQL 8.0.36+ didukung.

Sebelum memulai

Pastikan Anda memiliki peran Admin Cloud SQL dan Compute Viewer di akun pengguna.

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Mengaktifkan fungsi penelusuran vektor menggunakan flag database

Untuk mengaktifkan dukungan penyimpanan embedding vektor di database Anda di Cloud SQL untuk MySQL 8.4 dan yang lebih lama, aktifkan flag database MySQL cloudsql_vector.

Jika Anda menggunakan Cloud SQL untuk MySQL 9.7 atau yang lebih baru, aktifkan flag database MySQL cloudsql_vector untuk menambahkan dukungan dalam membuat indeks vektor dan untuk melakukan penelusuran ANN

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

Ganti kode berikut:

• INSTANCE_NAME: nama instance tempat Anda ingin mengaktifkan fungsi penelusuran vektor.

• FLAGS: konfigurasi flag MySQL berikut di instance Anda:

  • cloudsql_vector: setel flag ini ke on untuk mengaktifkan fungsi penelusuran vektor Cloud SQL. Flag ini nonaktif secara default. Saat Anda mengonfigurasi flag, perintah Anda akan terlihat mirip dengan berikut ini:

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

    Flag cloudsql_vector bersifat statis. Setelah Anda memperbarui instance dengan flag (dengan mengaktifkan atau menonaktifkannya), instance Anda akan otomatis dimulai ulang agar perubahan konfigurasi diterapkan.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi flag database untuk MySQL, lihat Mengonfigurasi flag database.

Menonaktifkan embedding vektor

Sebelum menonaktifkan embedding vektor di instance Anda, Anda harus secara eksplisit menghapus semua indeks vektor di instance tersebut. Untuk mempelajari cara menemukan daftar indeks vektor di instance, lihat Memantau indeks vektor.

Menonaktifkan dukungan embedding vektor akan mencegah Anda membuat kolom embedding vektor baru jika Anda menggunakan MySQL 8.4 atau yang lebih lama. Jika Anda menggunakan MySQL 9.7 atau yang lebih baru, Anda tidak dapat membuat indeks vektor. Tindakan ini juga mencegah Anda menggunakan fungsi approx_distance untuk penelusuran vektor. Untuk menonaktifkan dukungan embedding vektor, setel flag cloudsql_vector ke off. Setelah Anda mengonfigurasi flag statis ini, instance akan otomatis dimulai ulang agar perubahan konfigurasi diterapkan.

Untuk menonaktifkan dukungan embedding vektor, setel flag cloudsql_vector ke off.

Contoh:

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

Ganti INSTANCE_NAME dengan nama instance tempat Anda menonaktifkan dukungan embedding vektor.

Langkah berikutnya

• Baca ringkasan tentang penelusuran vektor di Cloud SQL.
• Pelajari cara membuat embedding vektor.
• Pelajari cara membuat indeks vektor.
• Pelajari cara melakukan penelusuran pada embedding vektor.