Configurer Gemini dans les bases de données

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. Accorder 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. Activez Gemini dans les bases de données.

  4. Activez l'API Recommender.

  5. Activez 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 pour 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, sélectionnez un projet.

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état Enabled (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 du projet, sélectionnez 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 un autre 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 le projet Google Cloud spécifié pour tous les utilisateurs disposant des rôles IAM requis.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit la procédure à suivre pour attribuer aux utilisateurs les rôles IAM Gemini pour les utilisateurs Google Cloud et les consommateurs de Service Usage.

Console

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

    Accéder à IAM et administration

  2. Dans la colonne Compte principal, recherchez un compte principal auquel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifier 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 Utilisateur de Gemini pour Google Cloud.

  5. Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur 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 de 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:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com 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

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 Obtenir Gemini dans les bases de données.

    La page Administration de Gemini s'affiche.

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

La procédure suivante explique comment activer le conseiller d'index pour AlloyDB for 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. Pour activer les recommandations de création d'index sur la page Insights sur les requêtes 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 instances MySQL 8.0 disposant de 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 le schéma de performances MySQL est déjà activé sur vos instances Cloud SQL pour MySQL, exécutez la commande gcloud CLI suivante pour activer le conseiller d'index:
  3. gcloud sql instances patch INSTANCE_NAME \
        --database-flags=cloudsql_index_advisor=on

    Remplacez INSTANCE_NAME par le nom de votre instance.

  4. 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:
  5. 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 la section Configurer des options de base de données.

Cloud SQL pour PostgreSQL

La procédure suivante explique 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:
  3. 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 la section Configurer des options de base de données.