Configurare Gemini in Databases

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

  1. Abilita l'API Gemini for Google Cloud in un progetto Google Cloud. In genere, questo passaggio viene eseguito da un amministratore.

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

  3. Attiva Gemini in Databases.

  4. Abilita l'API Recommender.

  5. Attiva l'Advisor per gli indici (applicabile solo ad AlloyDB per PostgreSQL, Cloud SQL per PostgreSQL e Cloud SQL per MySQL).

Prima di iniziare

Per attivare Gemini in Databases, devi disporre del ruolo IAM (Identity and Access Management) roles/billing.admin.

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. Nel menu del selettore dei progetti, seleziona un progetto.

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

    gcloud services enable cloudaicompanion.googleapis.com
    

    Se vuoi attivare l'API Gemini for Google Cloud in un altro progetto Google Cloud, aggiungi il parametro --project:

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

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

    L'output è simile al seguente:

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

Gemini for Google Cloud è ora disponibile nel progetto Google Cloud specificato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

Concedi ruoli IAM in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per concedere agli utenti i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer.

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 Principale, individua un'entità a cui vuoi concedere l'accesso a Gemini e 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 for Google Cloud.

  5. Fai clic su Aggiungi un altro ruolo e seleziona Consumatore di utilizzo del servizio.

  6. Fai clic su Salva.

gcloud

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

    Activate Cloud Shell

  2. Nel menu del selettore dei progetti, seleziona un progetto.

  3. Concedi il ruolo Utente di Gemini for 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:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com 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 Consumatore di utilizzo del servizio:

    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 alle funzionalità di Gemini for Google Cloud nella console Google Cloud all'interno del progetto specificato. Per ulteriori informazioni, consulta la panoramica di Gemini for Google Cloud.

Attivare Gemini in Databases

Per attivare Gemini in Databases in un progetto Google Cloud, svolgi 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 di Gemini.

  4. Scegli l'account di fatturazione per cui vuoi attivare Gemini in Databases e fai clic su Vai alla pagina 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 in Databases.

  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 il tuo progetto.

Attivare i suggerimenti sull'indicizzazione

Puoi attivare l'advisor per gli indici per le istanze AlloyDB per PostgreSQL, Cloud SQL per MySQL 8.0 e Cloud SQL per PostgreSQL 12 e versioni successive.

AlloyDB per PostgreSQL

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

  1. Prima di attivare il suggerimento sull'indicizzazione, abilita Query Insights avanzato 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, selezionare Attiva i suggerimenti.
  8. Salva le modifiche.

Per saperne di più sull'utilizzo del consulente per gli indici in AlloyDB per PostgreSQL, consulta Utilizzare i suggerimenti sull'indicizzazione 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 attiva lo schema delle prestazioni di MySQL su tutte le istanze MySQL 8.0 con più di 15 GB di memoria.

  1. Prima di attivare il consulente per gli indici, abilita Query Insights nell'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:
  3. gcloud sql instances patch INSTANCE_NAME \
        --database-flags=cloudsql_index_advisor=on

    Sostituisci INSTANCE_NAME con il nome dell'istanza.

  4. 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:
  5. gcloud sql instances patch INSTANCE_NAME \
       --database-flags=cloudsql_index_advisor=on,performance_schema=on

    Sostituisci INSTANCE_NAME con il nome dell'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 attivare il suggerimento 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 Google Cloud CLI:
  3. 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.