Configurer Gemini dans les bases de données

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour configurer Gemini dans les bases de données, procédez comme suit :

1. Activez l'API Gemini pour Google Cloud dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.

2. 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.

3. Activer Gemini dans les bases de données

4. Activez l'API Recommender.

5. 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

1. Pour activer l'API Gemini pour Google Cloud, accédez à la page Gemini pour Google Cloud.

   Accéder à Gemini pour Google Cloud

2. Dans le sélecteur de projet, choisissez un projet.

3. 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

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

   Activate Cloud Shell

2. Dans le menu de sélection de projet, choisissez un projet.

3. 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

1. Pour accorder les rôles IAM requis pour utiliser Gemini, accédez à la section IAM et Administration.

   Accéder à IAM et administration

2. 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.

3. Dans le volet Modifier les accès, cliquez sur Ajouter un autre rôle.

4. Dans Sélectionner un rôle, sélectionnez Gemini pour utilisateur Google Cloud.

5. Cliquez sur Ajouter un autre rôle et sélectionnez Consommateur de Service Usage.

6. Cliquez sur Enregistrer.

gcloud

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

   Activate Cloud Shell

2. Dans le menu de sélection du projet, sélectionnez un projet.

3. 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 forme user|group|serviceAccount:email ou domain:domain (par exemple, user:[e-mail], group:[e-mail], serviceAccount:[e-mail] ou domain: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
   

4. 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

Important :L'activation de Gemini dans les bases de données peut prendre entre 24 et 48 heures.

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.

1. Dans la console Google Cloud, accédez à la page Gemini pour Google Cloud.

   Gemini pour Google Cloud

2. Cliquez sur Gemini dans les bases de données.

   Le volet Explorer Gemini s'affiche.

3. Cliquez sur Get Gemini in Databases (Obtenir Gemini dans les bases de données).

   La page Administration de Gemini s'affiche.

4. 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.

5. Cliquez sur Examiner les conditions et activer.

   La page Activer Gemini dans les bases de données s'affiche.

6. Cliquez sur Acheter pour activer Gemini dans les bases de données.

Activez l'API Recommender

Enable the Recommender API.

Enable the 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

1. Avant d'activer le conseiller d'index, activez les insights sur les requêtes améliorés sur l'instance.

2. Dans la console Google Cloud, accédez à la page Clusters.

   accéder aux clusters

3. Dans la liste des clusters et des instances, cliquez sur une instance.
4. Cliquez sur Insights sur les requêtes.
5. Choisissez la base de données et l'utilisateur.
6. Cliquez sur Edit settings (Modifier les paramètres).
7. Activer les recommandations de création d'index dans l'outil Query Insights d'un cluster sélectionnez Activer les recommandations.
8. 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.

1. Avant d'activer le conseiller d'index, activez Insights sur les requêtes sur l'instance.
2. 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:

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

Remplacez INSTANCE_NAME par le nom de votre instance.

3. 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,performance_schema=on

Remplacez INSTANCE_NAME par le nom de votre instance.

Attention: Définir l'option performance_schema sur on redémarre automatiquement 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

1. Avant d'activer le conseiller d'index, activez Insights sur les requêtes sur l'instance.
2. 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.