Menggunakan bantuan vektor

Halaman ini menjelaskan cara menggunakan bantuan vektor untuk men-deploy dan mengelola beban kerja vektor di instance Cloud SQL untuk PostgreSQL.

Untuk mempelajari lebih lanjut apa itu bantuan vektor dan cara kerjanya, lihat Ringkasan bantuan vektor.

Sebelum memulai

  • Pastikan instance Anda menggunakan versi pemeliharaan yang benar. Bantuan vektor memerlukan nomor versi pemeliharaan minimum PostgreSQL_$version.R20251004.01_07. Untuk mengetahui informasi selengkapnya tentang cara melakukan pemeliharaan mandiri, lihat Melakukan pemeliharaan mandiri performa.
  • Tetapkan flag database cloudsql.enable_vector_assist ke ON.

  • Aktifkan ekstensi bantuan vektor menggunakan perintah berikut di database yang ingin Anda gunakan:

    CREATE EXTENSION vector_assist CASCADE;

    Tindakan ini akan menghasilkan skema vector_assist, yang digunakan oleh bantuan vektor.

Menggunakan bantuan vektor untuk men-deploy workload vektor

Untuk menggunakan bantuan vektor dalam men-deploy dan mengelola workload vektor, Anda harus melakukan hal berikut:

Menentukan spesifikasi vektor

Menentukan spesifikasi vektor, atau spesifikasi vektor adalah langkah pertama dalam menggunakan bantuan vektor. Bergantung pada jenis workload vektor, kolom yang Anda gunakan untuk menentukan spesifikasi vektor mungkin berbeda.

Misalnya, jika Anda ingin mengaktifkan penelusuran semantik pada kolom tertentu dalam tabel, jalankan fungsi vector_assist.define_spec untuk menentukan spesifikasi vektor Anda:

SELECT vector_assist.define_spec(
  table_name => 'TABLE_NAME',
  vector_column_name => 'VECTOR_COLUMN_NAME',
  target_recall => TARGET_RECALL,
  tune_vector_index => TUNE_INDEX
);

Ganti parameter berikut:

  • TABLE_NAME: nama tabel yang ingin Anda gunakan dalam workload vektor.
  • VECTOR_COLUMN_NAME: kolom yang ingin Anda lakukan penelusuran semantik.
  • TARGET_RECALL: target perolehan yang Anda inginkan untuk dipenuhi oleh bantuan vektor.
  • TUNE_INDEX: boolean yang menentukan apakah bantuan vektor menyesuaikan indeks vektor dalam beban kerja Anda.

Untuk melihat daftar lengkap semua parameter yang tersedia untuk spesifikasi vektor, lihat Referensi bantuan vektor.

Setelah Anda menjalankan kueri untuk membuat spesifikasi vektor, bantuan vektor akan otomatis membuat langkah-langkah, yang disebut rekomendasi, yang harus Anda jalankan untuk men-deploy beban kerja vektor.

Melihat rekomendasi bantuan vektor

Untuk melihat rekomendasi yang dihasilkan oleh bantuan vektor menggunakan spesifikasi vektor Anda, jalankan fungsi vector_assist.get_recommendations:

SELECT vector_assist.get_recommendations(
  spec_id => 'SPEC_ID'
);

Ganti parameter berikut:

  • SPEC_ID: ID spesifikasi vektor yang ingin Anda lihat rekomendasinya.

Menampilkan tabel bernama vector_assist.RECOMMENDATIONS yang berisi semua rekomendasi. Setiap rekomendasi disimpan dalam tabel dengan spec_id terkait. Setiap rekomendasi umumnya berisi kueri SQL yang perlu Anda jalankan, penjelasan mendetail untuk rekomendasi, dan informasi relevan lainnya yang menjelaskan rekomendasi tersebut.

Menerapkan rekomendasi bantuan vektor

Anda dapat menerapkan rekomendasi yang dihasilkan satu per satu atau secara keseluruhan.

Untuk menerapkan rekomendasi tertentu, jalankan fungsi vector_assist.apply_recommendation:

SELECT vector_assist.apply_recommendation(
  recommendation_id => 'RECOMMENATION_ID',
);

Ganti parameter berikut:

  • RECOMMENDATION_ID: ID rekomendasi bantuan vektor yang ingin Anda terapkan dari tabel vector_assist.RECOMMENDATIONS.

Untuk menerapkan semua rekomendasi secara bersamaan, jalankan fungsi vector_assist.apply_spec dengan parameter spec_id atau table_name:

SELECT vector_assist.apply_spec(
  spec_id => 'SPEC_ID',
  table_name => 'TABLE_NAME'
);

Ganti parameter berikut:

  • SPEC_ID: ID spesifikasi vektor yang ingin Anda gunakan.
  • TABLE_NAME: nama tabel yang Anda gunakan untuk menentukan spesifikasi vektor.

Secara opsional, Anda juga dapat memasukkan parameter schema_name atau column_name.

Setelah Anda menerapkan rekomendasi yang dihasilkan oleh bantuan vektor, indeks vektor siap digunakan.

Membuat kueri penelusuran

Anda dapat menggunakan bantuan vektor untuk membantu Anda membuat kueri penelusuran yang dioptimalkan untuk workload vektor yang di-deploy menggunakan spesifikasi vektor workload dan indeks vektor yang dihasilkan. Untuk membuat kueri penelusuran yang dioptimalkan, jalankan fungsi vector_assist.generate_query:

SELECT vector_assist.generate_query(
  spec_id => 'SPEC_ID',
  table_name => 'TABLE_NAME',
  column_name => 'COLUMN_NAME',
  search_text => 'SEARCH_TEXT',
  top_k => 'TOP_K_NAME',
  target_recall => TARGET_RECALL,
  filter_expression => 'FILTER_EXPRESSION'
);

Ganti parameter berikut:

  • SPEC_ID: ID spesifikasi yang ingin Anda gunakan.
  • TABLE_NAME: nama tabel yang Anda gunakan untuk menentukan spesifikasi vektor.
  • COLUMN_NAME: nama kolom teks asli yang Anda tentukan dalam spesifikasi vektor.
  • SEARCH_TEXT: teks yang ingin Anda telusuri di kolom.
  • TOP_K: jumlah tetangga terdekat yang akan ditampilkan.
  • TARGET_RECALL: target perolehan yang Anda inginkan untuk dipenuhi oleh bantuan vektor.
  • FILTER_EXPRESSION: filter apa pun untuk kueri penelusuran, misalnya, memfilter berdasarkan kolom lain.

Untuk melihat daftar lengkap semua parameter yang tersedia untuk membuat kueri penelusuran, lihat Referensi bantuan vektor.

Output fungsi ini menampilkan teks yang berisi kueri SQL. Anda dapat menjalankan atau menyimpan kueri SQL ini sesuai kebutuhan.

Langkah berikutnya