Pour configurer Gemini dans les bases de données, procédez comme suit :
Activez l'API Gemini pour Google Cloud dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.
Accordez des rôles Identity and Access Management (IAM) dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.
Activer le conseiller d'index (applicable uniquement à AlloyDB pour PostgreSQL, Cloud SQL pour PostgreSQL et Cloud SQL pour MySQL).
Avant de commencer
Pour activer Gemini dans les bases de données, vous devez disposer du rôle IAM (Identity and Access Management) roles/billing.admin
.
Activer l'API Gemini pour Google Cloud dans un projet Google Cloud
Cette section décrit les étapes requises pour activer l'API Gemini for Google Cloud dans un projet Google Cloud.
Console
Pour activer l'API Gemini pour Google Cloud, accédez à la page Gemini pour Google Cloud.
Dans le sélecteur de projet, choisissez un projet.
Cliquez sur Activer.
La page est mise à jour et affiche l'état Activé. Gemini est désormais disponible dans le projet Google Cloud sélectionné pour tous les utilisateurs disposant des rôles IAM requis.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Dans le menu de sélection de projet, choisissez un projet.
Activez l'API Gemini pour Google Cloud pour Gemini à l'aide de la commande
gcloud services enable
:gcloud services enable cloudaicompanion.googleapis.com
Si vous souhaitez activer l'API Gemini pour Google Cloud dans une autre dans votre projet Google Cloud, ajoutez le Paramètre
--project
:gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
Remplacez
PROJECT_ID
par l'ID de votre projet Google Cloud.Le résultat ressemble à ce qui suit :
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
Gemini pour Google Cloud est désormais disponible dans les Google Cloud à tous les utilisateurs disposant du rôles IAM requis.
Attribuer des rôles IAM dans un projet Google Cloud
Cette section décrit la procédure à suivre pour accorder à l'utilisateur Gemini pour Google Cloud et les rôles IAM Consommateur Service Usage aux utilisateurs.
Console
Pour accorder les rôles IAM requis pour utiliser Gemini, accédez à la section IAM et Administration.
Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifiez le compte principal sur cette ligne.
Dans le volet Modifier les accès, cliquez sur
Ajouter un autre rôle.Dans Sélectionner un rôle, sélectionnez Gemini pour utilisateur Google Cloud.
Cliquez sur Ajouter un autre rôle et sélectionnez Consommateur de Service Usage.
Cliquez sur Enregistrer.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Dans le menu de sélection du projet, sélectionnez un projet.
Attribuez le rôle Utilisateur Gemini pour Google Cloud:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
Remplacez
PRINCIPAL
par l'identifiant du compte principal. L'identifiant se présente sous la formeuser|group|serviceAccount:email
oudomain:domain
(par exemple,user:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
oudomain:example.domain.com
.Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
Attribuez le rôle Consommateur Service Usage :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :
- members: - user:PRINCIPAL role: roles/serviceusage.serviceUsageConsumer
Pour plus d'informations, consultez les sections Attribuer un seul rôle et gcloud projects add-iam-policy-binding
.
Tous les utilisateurs auxquels ces rôles ont été attribués peuvent accéder aux fonctionnalités Gemini pour Google Cloud dans la console Google Cloud du projet spécifié. Pour en savoir plus, consultez la présentation de Gemini pour Google Cloud.
Activer Gemini dans les bases de données
Pour activer Gemini dans Databases dans un projet Google Cloud, procédez comme suit. Un administrateur ou un propriétaire de projet effectue généralement ces étapes.
Dans la console Google Cloud, accédez à la page Gemini pour Google Cloud.
Cliquez sur Gemini dans les bases de données.
Le volet Explorer Gemini s'affiche.
Cliquez sur Get Gemini in Databases (Obtenir Gemini dans les bases de données).
La page Administration de Gemini s'affiche.
Sélectionnez le compte de facturation pour lequel vous souhaitez activer Gemini dans Databases, puis cliquez sur Accéder à la page Gemini dans Databases.
La page Gemini dans les bases de données s'affiche.
Cliquez sur Examiner les conditions et activer.
La page Activer Gemini dans les bases de données s'affiche.
Cliquez sur Acheter pour activer Gemini dans les bases de données.
Activez l'API Recommender
Enable the Recommender API.
Si l'API Recommender n'est pas listée, cela signifie qu'elle est déjà activée pour votre projet.
Activer le conseiller d'index
Vous pouvez activer le conseiller d'index pour AlloyDB pour PostgreSQL, les instances Cloud SQL pour MySQL 8.0 et les instances Cloud SQL pour PostgreSQL 12 et versions ultérieures.
AlloyDB pour PostgreSQL
Les étapes suivantes décrivent comment activer le conseiller d'index pour AlloyDB pour PostgreSQL
- Avant d'activer le conseiller d'index, activez les insights sur les requêtes améliorés sur l'instance.
Dans la console Google Cloud, accédez à la page Clusters.
- Dans la liste des clusters et des instances, cliquez sur une instance.
- Cliquez sur Insights sur les requêtes.
- Choisissez la base de données et l'utilisateur.
- Cliquez sur Edit settings (Modifier les paramètres).
- Activer les recommandations de création d'index dans l'outil Query Insights d'un cluster sélectionnez Activer les recommandations.
- Enregistrez les modifications.
Pour en savoir plus sur l'utilisation du conseiller d'index dans AlloyDB pour PostgreSQL, consultez Utiliser le conseiller d'index avec les insights sur les requêtes.
Cloud SQL pour MySQL
La procédure décrite ci-dessous explique comment activer le conseiller d'index pour Cloud SQL pour MySQL. Le conseiller d'index pour Cloud SQL pour MySQL utilise les données du schéma de performances MySQL. Par défaut, Cloud SQL active le schéma de performances MySQL sur toutes les versions MySQL 8.0 avec plus de 15 Go de mémoire.
- Avant d'activer le conseiller d'index, activez Insights sur les requêtes sur l'instance.
- Si MySQL Performance Schema est déjà activé sur votre Cloud SQL pour MySQL, puis pour activer le conseiller d'index, exécutez la commande gcloud CLI suivante:
- Si le schéma de performances MySQL n'est pas activé sur vos instances Cloud SQL pour MySQL, exécutez la commande gcloud CLI suivante pour activer le conseiller d'index :
gcloud sql instances patch INSTANCE_NAME \ --database-flags=cloudsql_index_advisor=on
Remplacez INSTANCE_NAME par le nom de votre instance.
gcloud sql instances patch INSTANCE_NAME \ --database-flags=cloudsql_index_advisor=on,performance_schema=on
Remplacez INSTANCE_NAME par le nom de votre instance.
Pour en savoir plus sur la configuration des options, consultez Configurez des options de base de données.
Cloud SQL pour PostgreSQL
Les étapes suivantes décrivent comment activer le conseiller d'index pour Cloud SQL pour PostgreSQL
- Avant d'activer le conseiller d'index, activez Insights sur les requêtes sur l'instance.
- Pour activer le conseiller d'index pour les instances Cloud SQL pour PostgreSQL, exécutez la commande Google Cloud CLI suivante :
gcloud sql instances patch INSTANCE_NAME \ --database-flags=cloudsql.enable_index_advisor=on
Remplacez INSTANCE_NAME par le nom de votre instance.
Pour en savoir plus sur la configuration des options, consultez Configurez des options de base de données.