Per configurare Gemini in Databases, segui i passaggi descritti in questo documento:
Abilita l'API Gemini for Google Cloud in un progetto Google Cloud. In genere, questo passaggio viene eseguito da un amministratore.
Concedere ruoli di Identity and Access Management (IAM) in un progetto Google Cloud. In genere, questo passaggio viene eseguito da un amministratore.
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
Per abilitare l'API Gemini for Google Cloud, vai alla pagina Gemini for Google Cloud.
Nel selettore dei progetti, seleziona un progetto.
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
-
In the Google Cloud console, activate Cloud Shell.
Nel menu del selettore dei progetti, seleziona un progetto.
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
Per concedere i ruoli IAM necessari per utilizzare Gemini, vai alla pagina IAM e amministrazione.
Nella colonna Principale, individua un'entità a cui vuoi concedere l'accesso a Gemini e fai clic su Modifica entità nella riga corrispondente.
Nel riquadro Modifica accesso, fai clic su
Aggiungi un altro ruolo.In Seleziona un ruolo, seleziona Utente Gemini for Google Cloud.
Fai clic su Aggiungi un altro ruolo e seleziona Consumatore di utilizzo del servizio.
Fai clic su Salva.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Nel menu del selettore dei progetti, seleziona un progetto.
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 formauser|group|serviceAccount:email
odomain:domain
, ad esempiouser:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
odomain:example.domain.com
.L'output è un elenco di associazioni di criteri che include quanto segue:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
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.
Nella console Google Cloud, vai alla pagina Gemini per Google Cloud.
Fai clic su Gemini in Databases.
Viene visualizzato il riquadro Esplora Gemini.
Fai clic su Richiedi Gemini in Databases.
Viene visualizzata la pagina Amministrazione di Gemini.
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.
Fai clic su Esamina i termini e attiva.
Viene visualizzata la pagina Attiva Gemini in Databases.
Fai clic su Acquista per attivare Gemini in Databases.
Abilita l'API Recommender
Enable the Recommender 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.
- Prima di attivare il suggerimento sull'indicizzazione, abilita Query Insights avanzato nell'istanza.
Nella console Google Cloud, vai alla pagina Cluster.
- Nell'elenco di cluster e istanze, fai clic su un'istanza.
- Fai clic su Approfondimenti sulle query.
- Scegli il database e l'utente.
- Fai clic su Edit Settings (Modifica impostazioni).
- Per attivare i suggerimenti per la creazione di indici nella pagina Query Insights di un cluster, selezionare Attiva i suggerimenti.
- 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.
- Prima di attivare il consulente per gli indici, abilita Query Insights nell'istanza.
- 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:
- 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
Sostituisci INSTANCE_NAME con il nome dell'istanza.
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.
- Prima di attivare il suggerimento sull'indicizzazione, abilita Query Insights sull'istanza.
- Per attivare l'advisor per gli indici per le istanze Cloud SQL per PostgreSQL, esegui il seguente comando Google Cloud CLI:
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.