Menginstal AlloyDB Omni dengan AlloyDB AI

Pilih versi dokumentasi:

Halaman ini menunjukkan cara menginstal AlloyDB Omni dan mengintegrasikan AlloyDB AI di dalamnya.

AlloyDB AI adalah rangkaian fitur yang disertakan dengan AlloyDB Omni yang memungkinkan Anda membangun aplikasi AI generatif perusahaan. Untuk mengetahui informasi selengkapnya tentang fungsi ML AlloyDB, lihat Membangun aplikasi AI generatif.

AlloyDB Omni dengan AlloyDB AI memungkinkan Anda membuat kueri model ML jarak jauh untuk menggunakan prediksi online dan embedding teks yang dihasilkan dari model ML. AlloyDB Omni dengan AlloyDB AI juga dapat memproses embedding vektor dari konten lain seperti gambar, misalnya, jika Anda menggunakan antarmuka google_ml.predict_row dan melakukan terjemahan sendiri dalam kueri.

Berdasarkan tempat Anda ingin menginstal AlloyDB Omni dengan AlloyDB AI, pilih salah satu opsi berikut:

Mengonfigurasi instance AlloyDB Omni untuk membuat kueri model jarak jauh

Untuk mengonfigurasi AlloyDB Omni agar dapat membuat kueri model jarak jauh model, ikuti langkah-langkah berikut:

  1. Buat akun layanan dengan Google Cloud.

  2. Buat kunci akun layanan, dalam format JSON, lalu download.

  3. Simpan kunci di lokasi permanen pada sistem file Anda. Kunci akan berada di lokasi ini selama masa aktif server AlloyDB Omni Anda.

    Catat lokasinya di sistem file Anda; Anda akan memerlukannya untuk langkah berikutnya.

  4. Tambahkan izin Identity and Access Management (IAM) Vertex AI ke project dan akun layanan yang sesuai.

       gcloud projects add-iam-policy-binding PROJECT_ID \
       --member="serviceAccount:SERVICE_ACCOUNT_ID" \
       --role="roles/aiplatform.user"

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda. Google Cloud

    • SERVICE_ACCOUNT_ID: ID akun layanan yang Anda buat pada langkah sebelumnya. Hal ini mencakup akhiran lengkap @PROJECT_ID.iam.gserviceaccount.com—misalnya, my-service@my-project.iam.gserviceaccount.com.

Menginstal AlloyDB Omni dengan AlloyDB AI

Untuk menginstal AlloyDB Omni dan mengintegrasikan AlloyDB AI, ikuti langkah-langkah berikut:

  1. Pastikan Anda telah menyelesaikan semua langkah yang tercantum di Mengonfigurasi AlloyDB Omni untuk membuat kueri model berbasis cloud.

  2. Buat salinan lokal file konfigurasi AlloyDB Omni default:

       docker run -i --rm google/alloydbomni:15.5.4 cat /usr/share/postgresql/postgresql.conf.sample > my-postgres.conf

  3. Edit salinan file konfigurasi untuk menambahkan direktif untuk integrasi AlloyDB AI:

       echo "omni_enable_ml_agent_process = 'on'" >> my-postgres.conf
   echo "omni_google_cloud_private_key_file_path = '/etc/postgresql/private-key.json'" >> my-postgres.conf

  4. Sesuaikan izin sistem file kunci dan file konfigurasi:

       sudo chmod +r my-postgres.conf
   sudo chmod +r KEY_PATH

    Ganti KEY_PATH dengan jalur ke file kunci pribadi akun layanan di sistem file host Anda. Ini adalah kunci yang Anda buat dan download sebelumnya dalam prosedur ini.

  5. Instal kunci dan file konfigurasi yang dipasang ke container:

       docker run --name CONTAINER_NAME -e POSTGRES_PASSWORD=NEW_PASSWORD -p HOST_PORT:5432 -v "$PWD/my-postgres.conf":/etc/postgresql/postgresql.conf -v "FULL_KEY_PATH":/etc/postgresql/private-key.json -d google/alloydbomni:15.5.4 -c 'config_file=/etc/postgresql/postgresql.conf'

    Ganti kode berikut:

    • CONTAINER_NAME: nama yang akan ditetapkan ke container metode penginstalan AlloyDB Omni baru yang disederhanakan ini di registry container mesin host Anda—misalnya, my-omni-1.

    • NEW_PASSWORD: sandi yang ditetapkan ke pengguna postgres container baru setelah pembuatannya.

    • HOST_PORT: port TCP di mesin host tempat container harus memublikasikan port 5432-nya sendiri. Untuk menggunakan port default PostgreSQL di mesin host juga, tentukan 5432.

    • FULL_KEY_PATH: jalur sistem file lengkap ke file kunci pribadi akun layanan di sistem host Anda.

Memverifikasi penginstalan AlloyDB Omni dengan AlloyDB AI

Untuk memverifikasi bahwa penginstalan Anda berhasil dan menggunakan prediksi model, masukkan hal berikut:

   CREATE EXTENSION google_ml_integration CASCADE;

   SELECT array_dims(embedding( 'textembedding-gecko@001', 'AlloyDB AI')::real[]);
   array_dims

Outputnya akan terlihat mirip seperti berikut:

    [1:768]
    (1 row)

Dalam kueri sebelumnya, panggilan embedding() menghasilkan embedding untuk teks input AlloyDB AI. array_dims menampilkan dimensi array yang ditampilkan oleh embedding(). Karena model textembedding-gecko yang telah terdaftar sebelumnya menampilkan output dengan 768 dimensi, outputnya adalah [768].

Langkah berikutnya