Menggunakan bantuan vektor

Halaman ini menjelaskan cara menggunakan bantuan vektor untuk men-deploy dan mengelola workload 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 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 membuat skema vector_assist, yang digunakan oleh bantuan vektor.

Menggunakan bantuan vektor untuk men-deploy workload vektor

Untuk menggunakan bantuan vektor guna 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 vector_assist.define_spec fungsi untuk menentukan spesifikasi vektor:

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 gunakan untuk melakukan penelusuran semantik.
  • TARGET_RECALL: target recall yang Anda inginkan untuk dipenuhi oleh bantuan vektor.
  • TUNE_INDEX: boolean yang menentukan apakah bantuan vektor menyetel indeks vektor dalam workload 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 workload vektor.

Melihat rekomendasi bantuan vektor

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

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

Ganti parameter berikut:

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

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.

Menerapkan rekomendasi bantuan vektor

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

Untuk menerapkan rekomendasi tertentu, jalankan vector_assist.apply_recommendation fungsi:

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 dibuat oleh bantuan vektor, indeks vektor siap digunakan.

Membuat kueri penelusuran

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

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 recall 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