Menyiapkan Gemini di Database

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk menyiapkan Gemini di Database, lakukan langkah-langkah dalam dokumen ini:

1. Aktifkan Gemini for Google Cloud API di project Google Cloud. Administrator biasanya melakukan langkah ini.

2. Memberikan peran Identity and Access Management (IAM) di project Google Cloud. Administrator biasanya melakukan langkah ini.

3. Aktifkan Gemini di Database.

4. Aktifkan Recommender API.

5. Mengaktifkan penasihat indeks (hanya berlaku untuk AlloyDB untuk PostgreSQL, Cloud SQL untuk PostgreSQL, dan Cloud SQL untuk MySQL).

Sebelum memulai

Untuk mengaktifkan Gemini di Database, Anda harus memiliki peran Identity and Access Management (IAM) roles/billing.admin.

Mengaktifkan Gemini untuk Google Cloud API di project Google Cloud

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk mengaktifkan Gemini untuk Google Cloud API di project Google Cloud.

Konsol

1. Untuk mengaktifkan Gemini untuk Google Cloud API, buka halaman Gemini untuk Google Cloud.

   Buka Gemini untuk Google Cloud

2. Di pemilih project, pilih project.

3. Klik Aktifkan.

   Halaman akan diperbarui dan menampilkan status Diaktifkan. Gemini kini tersedia di project Google Cloud yang dipilih untuk semua pengguna yang memiliki peran IAM yang diperlukan.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Di menu pemilih project, pilih project.

3. Aktifkan Gemini untuk Google Cloud API untuk Gemini menggunakan perintah gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Jika Anda ingin mengaktifkan Gemini untuk Google Cloud API di project Google Cloud yang berbeda, tambahkan parameter --project:

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   Ganti PROJECT_ID dengan ID project Google Cloud Anda.

   Outputnya mirip dengan hal berikut ini:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

Gemini untuk Google Cloud kini tersedia di project Google Cloud yang ditentukan untuk semua pengguna yang memiliki peran IAM yang diperlukan.

Memberikan peran IAM dalam project Google Cloud

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk memberikan peran IAM Gemini untuk Pengguna Google Cloud dan Konsumen Penggunaan Layanan kepada pengguna.

Konsol

1. Untuk memberikan peran IAM yang diperlukan untuk menggunakan Gemini, buka halaman IAM & Admin.

   Buka IAM & Admin

2. Di kolom Principal, temukan principal yang ingin Anda berikan akses ke Gemini, lalu klik Edit principal di baris tersebut.

3. Di panel Edit akses, klik Tambahkan peran lain.

4. Di Pilih peran, pilih Pengguna Gemini untuk Google Cloud.

5. Klik Tambahkan peran lain, lalu pilih Service Usage Consumer.

6. Klik Simpan.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Di menu pemilih project, pilih project.

3. Berikan peran Pengguna Gemini untuk Google Cloud:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   Ganti PRINCIPAL dengan ID untuk prinsipal. ID memiliki bentuk user|group|serviceAccount:email atau domain:domain—misalnya, user:[e-mail], group:[e-mail], serviceAccount:[e-mail], atau domain:example.domain.com.

   Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. Berikan peran Konsumen Penggunaan Layanan:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

Untuk mengetahui informasi selengkapnya, lihat Memberikan satu peran dan gcloud projects add-iam-policy-binding.

Semua pengguna yang telah diberi peran ini dapat mengakses fitur Gemini untuk Google Cloud di konsol Google Cloud dalam project yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat ringkasan Gemini untuk Google Cloud.

Mengaktifkan Gemini di Database

Penting: Diperlukan waktu antara 24 dan 48 jam untuk mengaktifkan Gemini di Database.

Untuk mengaktifkan Gemini di Database dalam project Google Cloud, lakukan langkah-langkah berikut. Administrator atau pemilik project biasanya melakukan langkah-langkah ini.

1. Di konsol Google Cloud, buka halaman Gemini untuk Google Cloud.

   Gemini untuk Google Cloud

2. Klik Gemini in Databases.

   Panel Explore Gemini akan ditampilkan.

3. Klik Get Gemini in Databases.

   Halaman Admin for Gemini akan ditampilkan.

4. Pilih akun penagihan yang ingin Anda gunakan untuk mengaktifkan Gemini di Database, lalu klik Lanjutkan ke halaman Gemini di Database.

   Halaman Gemini in Databases akan ditampilkan.

5. Klik Tinjau persyaratan dan aktifkan.

   Halaman Turn on Gemini in Databases akan ditampilkan.

6. Klik Beli untuk mengaktifkan Gemini di Database.

Mengaktifkan Recommender API

Enable the Recommender API.

Enable the API

Jika Recommender API tidak tercantum, berarti API tersebut sudah diaktifkan untuk project Anda.

Mengaktifkan penasihat indeks

Anda dapat mengaktifkan penasihat indeks untuk instance AlloyDB untuk PostgreSQL, Cloud SQL untuk MySQL 8.0, dan Cloud SQL untuk PostgreSQL 12 dan yang lebih baru.

AlloyDB untuk PostgreSQL

Langkah-langkah berikut menjelaskan cara mengaktifkan penasihat indeks untuk AlloyDB untuk PostgreSQL.

1. Sebelum mengaktifkan penasihat indeks, aktifkan Query Insight yang ditingkatkan di instance.

2. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

3. Dari daftar cluster dan instance, klik instance.
4. Klik Query Insight.
5. Pilih database dan pengguna.
6. Klik Edit Settings.
7. Untuk mengaktifkan rekomendasi pembuatan indeks di halaman Query Insight cluster, pilih Aktifkan rekomendasi.
8. Simpan perubahan Anda.

Untuk informasi selengkapnya tentang cara menggunakan penasihat indeks di AlloyDB untuk PostgreSQL, lihat Menggunakan penasihat indeks dengan insight kueri.

Cloud SQL untuk MySQL

Langkah-langkah berikut menjelaskan cara mengaktifkan penasihat indeks untuk Cloud SQL untuk MySQL. Penasihat indeks untuk Cloud SQL untuk MySQL menggunakan data dari MySQL Performance Schema. Secara default, Cloud SQL mengaktifkan MySQL Performance Schema di semua instance MySQL 8.0 yang memiliki memori lebih dari 15 GB.

1. Sebelum mengaktifkan penasihat indeks, aktifkan Insight Kueri di instance.
2. Jika Anda sudah mengaktifkan Skema Performa MySQL di instance Cloud SQL untuk MySQL, jalankan perintah gcloud CLI berikut untuk mengaktifkan penasihat indeks:

gcloud sql instances patch INSTANCE_NAME \
    --database-flags=cloudsql_index_advisor=on

Ganti INSTANCE_NAME dengan nama instance Anda.

3. Jika Anda belum mengaktifkan Skema Performa MySQL di instance Cloud SQL untuk MySQL, jalankan perintah gcloud CLI berikut untuk mengaktifkan penasihat indeks:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql_index_advisor=on,performance_schema=on

Ganti INSTANCE_NAME dengan nama instance Anda.

Perhatian: Menetapkan flag performance_schema ke on akan otomatis memulai ulang instance Anda.

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

Cloud SQL untuk PostgreSQL

Langkah-langkah berikut menjelaskan cara mengaktifkan penasihat indeks untuk Cloud SQL untuk PostgreSQL.

1. Sebelum mengaktifkan penasihat indeks, aktifkan Query Insight di instance.
2. Untuk mengaktifkan penasihat indeks untuk instance Cloud SQL untuk PostgreSQL, jalankan perintah Google Cloud CLI berikut:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_index_advisor=on
    

Ganti INSTANCE_NAME dengan nama instance Anda.

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