Configura Gemini in Databases

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per configurare Gemini in Databases, segui i passaggi descritti in questo documento:

1. Abilitare l'API Gemini per Google Cloud in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.

2. Concedere ruoli di Identity and Access Management (IAM) in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.

3. Attiva Gemini in Databases.

4. Abilitare l'API Recommender.

5. Attiva il suggerimento sull'indicizzazione (applicabile solo ad AlloyDB per PostgreSQL, Cloud SQL per PostgreSQL e Cloud SQL per MySQL).

Prima di iniziare

Per attivare Gemini in Databases, devi avere il roles/billing.admin Ruolo IAM (Identity and Access Management).

Abilita l'API Gemini for Google Cloud in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per attivare l'API Gemini per Google Cloud in un progetto Google Cloud.

Console

1. Per abilitare l'API Gemini for Google Cloud, vai alla pagina Gemini for Google Cloud.

   Vai a Gemini per Google Cloud

2. Nel selettore dei progetti, seleziona un progetto.

3. Fai clic su Attiva.

   La pagina si aggiorna e mostra lo stato Attivato. Gemini è ora disponibile nel progetto Google Cloud selezionato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

gcloud

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

   Activate Cloud Shell

2. Seleziona un progetto nel menu del selettore dei progetti.

3. Abilita l'API Gemini for Google Cloud per Gemini utilizzando il comando gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Se vuoi abilitare l'API Gemini per Google Cloud in un'altra progetto Google Cloud, aggiungi Parametro --project:

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

   Sostituisci PROJECT_ID con il tuo progetto Google Cloud ID.

   L'output è simile al seguente:

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

Gemini per Google Cloud è ora disponibile nel progetto Google Cloud a tutti gli utenti che dispongono del ruoli IAM richiesti.

Concedi ruoli IAM in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per concedere Gemini per l'utente Google Cloud i ruoli IAM consumer per l'utilizzo di servizi e Service Usage.

Console

1. Per concedere i ruoli IAM necessari per utilizzare Gemini, vai alla pagina IAM e amministrazione.

   Vai a IAM e amministrazione

2. Nella colonna Entità, trova un elemento principal per il quale hai vuoi concedere l'accesso a Gemini, quindi fai clic su Modifica entità nella riga corrispondente.

3. Nel riquadro Modifica accesso, fai clic su Aggiungi un altro ruolo.

4. In Seleziona un ruolo, seleziona Utente Gemini per Google Cloud.

5. Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer (Consumatore di Service Usage).

6. Fai clic su Salva.

gcloud

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

   Activate Cloud Shell

2. Seleziona un progetto nel menu del selettore dei progetti.

3. Concedi il ruolo di Utente Gemini per Google Cloud:

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

   Sostituisci PRINCIPAL con l'identificatore per l'entità. L'identificatore ha la forma user|group|serviceAccount:email o domain:domain, ad esempio user:[e-mail], group:[e-mail], serviceAccount:[e-mail] o domain:example.domain.com.

   L'output è un elenco di associazioni di criteri che include quanto segue:

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

4. Concedi il ruolo Consumer utilizzo dei servizi:

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

   L'output è un elenco di associazioni di criteri che include quanto segue:

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

Per ulteriori informazioni, consulta Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere le funzionalità di Gemini per Google Cloud Console Google Cloud all'interno del progetto specificato. Per ulteriori informazioni, vedi Panoramica di Gemini per Google Cloud.

Attiva Gemini in Databases

Importante: l'attivazione di Gemini in Databases può richiedere da 24 a 48 ore.

Per attivare Gemini in Databases in un progetto Google Cloud, esegui la i seguenti passaggi. In genere, questi passaggi vengono eseguiti da un amministratore o dal proprietario del progetto.

1. Nella console Google Cloud, vai alla pagina Gemini per Google Cloud.

   Gemini per Google Cloud

2. Fai clic su Gemini in Databases.

   Viene visualizzato il riquadro Esplora Gemini.

3. Fai clic su Richiedi Gemini in Databases.

   Viene visualizzata la pagina Amministrazione per Gemini.

4. Scegli l'account di fatturazione per il quale vuoi attivare Gemini in Databases e fai clic su Continua su Gemini in Databases .

   Viene visualizzata la pagina Gemini in Databases.

5. Fai clic su Esamina i termini e attiva.

   Viene visualizzata la pagina Attiva Gemini nel database.

6. Fai clic su Acquista per attivare Gemini in Databases.

Abilita l'API Recommender

Enable the Recommender API.

Enable the API

Se l'API Recommender non è elencata, significa che è già abilitata per del progetto.

Attivare i suggerimenti sull'indicizzazione

Puoi attivare Index Advisor per AlloyDB per PostgreSQL, Cloud SQL per MySQL 8.0 e Cloud SQL per PostgreSQL 12 e versioni successive.

AlloyDB per PostgreSQL

I passaggi seguenti spiegano come attivare l'Advisor per gli indici per AlloyDB per PostgreSQL.

1. Prima di attivare il suggerimento sull'indicizzazione, abilita gli insight avanzati sulle query nell'istanza.

2. Nella console Google Cloud, vai alla pagina Cluster.

   Vai a Cluster

3. Nell'elenco di cluster e istanze, fai clic su un'istanza.
4. Fai clic su Approfondimenti sulle query.
5. Scegli il database e l'utente.
6. Fai clic su Edit Settings (Modifica impostazioni).
7. Per attivare i suggerimenti per la creazione di indici nella pagina Query Insights di un cluster, seleziona Attiva i consigli.
8. Salva le modifiche.

Per saperne di più sull'utilizzo del consulente per gli indici in AlloyDB per PostgreSQL, consulta Utilizzare il consulente per gli indici con Query Insights.

Cloud SQL per MySQL

I passaggi seguenti spiegano come attivare l'Advisor per gli indici per Cloud SQL per MySQL. L'Advisor per gli indici per Cloud SQL per MySQL utilizza i dati dello schema di prestazioni di MySQL. Per impostazione predefinita, Cloud SQL abilita MySQL Performance Schema su tutti i database MySQL 8.0 con più di 15 GB di memoria.

1. Prima di abilitare il suggerimento sull'indicizzazione, abilita Query Insights per l'istanza.
2. Se hai già attivato lo schema delle prestazioni di MySQL sulle tue istanze Cloud SQL per MySQL, per attivare l'advisor per gli indici, esegui il seguente comando gcloud CLI:

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

Sostituisci INSTANCE_NAME con il nome della tua istanza.

3. Se non hai attivato lo schema delle prestazioni di MySQL sulle tue istanze Cloud SQL per MySQL, per attivare l'advisor per gli indici, esegui il seguente comando gcloud CLI:

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

Sostituisci INSTANCE_NAME con il nome dell'istanza.

Attenzione: impostazione del flag performance_schema su on riavvia automaticamente l'istanza.

Per ulteriori informazioni sulla configurazione dei flag, consulta Configurare i flag di database.

Cloud SQL per PostgreSQL

I passaggi che seguono descrivono come attivare l'Advisor per gli indici per Cloud SQL per PostgreSQL.

1. Prima di abilitare i suggerimenti sull'indicizzazione, abilita Query Insights sull'istanza.
2. Per attivare l'advisor per gli indici per le istanze Cloud SQL per PostgreSQL, esegui il seguente comando della CLI Google Cloud:

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

Sostituisci INSTANCE_NAME con il nome dell'istanza.

Per ulteriori informazioni sulla configurazione dei flag, consulta Configurare i flag di database.