Se connecter à Cloud SQL

Ce document explique comment créer un datastore qui se connecte aux données Cloud SQL. Vous pouvez associer ce data store à une application Gemini Enterprise pour permettre aux agents d'analyser vos données.

Pour vous connecter aux données Cloud SQL à l'aide d'un datastore Gemini Enterprise, vous pouvez utiliser l'un des modes suivants :

• Requête fédérée (recommandé) [Preview]: connectez-vous aux données Cloud SQL sur place sans frais de sortie pour copier et déplacer les données. La requête fédérée envoie votre requête directement à Cloud SQL sur l'ensemble des instances, bases de données et tables auxquelles votre identité est autorisée à accéder par Identity and Access Management (IAM), ce qui est plus efficace pour les requêtes analytiques. Lorsque vous utilisez le mode de requête fédérée, Knowledge Catalog est automatiquement activé dans l'onglet Assistant de votre application Gemini Enterprise pour fournir à l'agent des outils permettant de rechercher des données auxquelles l'utilisateur a accès et de rechercher du contexte.

  Attention : Requêtes de base de données de haute précision : le mode de requête fédérée fournit un accès étendu à toutes les instances et bases de données accessibles par l'utilisateur, mais la précision des requêtes peut varier sur les schémas transactionnels complexes. Pour les charges de travail nécessitant une haute précision, une définition déterministe du champ d'application des tables et des requêtes vérifiées (Golden SQL), créez un agent de données limité dans Cloud SQL pour MySQL ou Cloud SQL pour PostgreSQL, puis publiez-le dans Gemini Enterprise.

• Ingestion de données : copiez les données d'une table Cloud SQL spécifique dans le data store Gemini Enterprise. Les données doivent être actualisées manuellement pour refléter les modifications apportées à la table Cloud SQL. Ce mode entraîne des frais de sortie pour le déplacement des données vers un nouvel emplacement, et les autorisations IAM existantes ne sont pas répliquées dans le datastore.

Avant de commencer

Pour créer un data store Cloud SQL dans Gemini Enterprise, vous devez disposer du rôle Administrateur Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou Administrateur Discovery Engine (roles/discoveryengine.admin). Pour en savoir plus, consultez Accorder des autorisations aux administrateurs.

Si votre projet est protégé par un périmètre VPC Service Controls ou si l'application des règles d'administration est activée, assurez-vous que votre règle d'administration autorise le connecteur :

• Ajoutez cloudsql au paramètre allowedDataSources dans la contrainte gérée discoveryengine.managed.allowedDataSources (Limiter les sources de données autorisées pour les connecteurs de données). Pour en savoir plus, consultez Présentation des contraintes de règles gérées et Configurer les sources de données autorisées.

En outre, remplissez les conditions préalables et configurez les autorisations IAM Cloud SQL requises pour le mode de connecteur que vous prévoyez d'utiliser :

Requête fédérée

Aperçu

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

Pour vous connecter à Cloud SQL en mode requête fédérée, remplissez les conditions préalables suivantes dans le projet Google Cloud qui contient votre instance Cloud SQL :

1. Activez l'API Data sur votre instance Cloud SQL :

   gcloud sql instances patch <var>INSTANCE_NAME</var> \
       --project=<var>PROJECT_ID</var> \
       --data-api-access=ALLOW_DATA_API
   

2. Accordez des autorisations IAM : accordez les rôles IAM suivants dans le projet Google Cloud contenant votre instance Cloud SQL aux utilisateurs qui interrogent ou effectuent des actions via le connecteur :

   • Accès aux instances et aux bases de données :
     • Lecteur Cloud SQL (roles/cloudsql.viewer) et Client Cloud SQL (roles/cloudsql.client) (ou Utilisateur d'instance Cloud SQL (roles/cloudsql.instanceUser) avec l'authentification IAM pour les bases de données) pour les requêtes et les outils en lecture seule.
     • Éditeur Cloud SQL (roles/cloudsql.editor) ou Administrateur Cloud SQL (roles/cloudsql.admin) si des actions d'écriture ou d'administration sont activées.
   • Accès aux outils MCP :
     • Utilisateur de l'outil MCP (roles/mcp.toolUser) dans le projet où se trouve l'instance Cloud SQL pour appeler les outils MCP.

Ingestion de données

Pour ingérer des données depuis Cloud SQL, configurez les autorisations IAM suivantes :

• Accès au bucket de préproduction : lors de l'ingestion de données à partir de Cloud SQL, les données sont d'abord transférées vers un bucket Cloud Storage. Attribuez le rôle Administrateur de l'espace de stockage (roles/storage.admin) sur le bucket Cloud Storage intermédiaire au compte de service de votre instance Cloud SQL (par exemple, p9876-abcd33f@gcp-sa-cloud-sql.).
• Accès Cloud SQL inter-projets : si vous importez des données à partir d'un projet Google Cloud source différent du projet Google Cloud contenant le data store Gemini Enterprise que vous créez, attribuez le rôle Lecteur Cloud SQL (roles/cloudsql.viewer) sur le projet Cloud SQL source au compte de service service-PROJECT_NUMBER@gcp-sa-discoveryengine. (où PROJECT_NUMBER est le numéro du projetGoogle Cloud contenant le data store Gemini Enterprise).

Attention : Si vous choisissez d'ingérer des données de Cloud SQL dans un data store Gemini Enterprise, les autorisations Cloud SQL ne sont pas importées avec les données. Après l'importation, tout utilisateur disposant d'autorisations Gemini Enterprise suffisantes peut afficher les données, même s'il n'est pas autorisé à les afficher dans Cloud SQL.

Créer un data store Cloud SQL

Pour créer un data store qui connecte les données de Cloud SQL à Gemini Enterprise, procédez comme suit :

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

   Gemini Enterprise

2. Accédez à la page Datastores.

3. Cliquez sur Créer un datastore.

4. Sur la page Source, choisissez une source de données pour votre datastore. Recherchez "Cloud SQL" dans le champ de recherche Sélectionner une source de données ou recherchez Cloud SQL dans la liste des sources de données first party. Sélectionnez Ajouter une source de données.

5. Sur la page Données, sélectionnez le mode de connecteur pour vous connecter à vos données. Sélectionnez l'un des onglets suivants pour obtenir des instructions supplémentaires en fonction du mode que vous avez choisi.

   Requête fédérée

   Aperçu

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

   1. Sélectionnez Requête fédérée (recommandé). Cliquez sur Continuer.
   2. Sur la page Actions, sélectionnez les actions Cloud SQL que vous souhaitez activer pour votre data store. Vous pourrez modifier ces paramètres ultérieurement. Cliquez sur Continuer.

   Ingestion de données

   1. Sélectionnez Ingestion de données.
   2. Spécifiez les détails des données que vous souhaitez importer. Sous Importer des données depuis votre table Cloud SQL, spécifiez les informations suivantes :
      • ID du projet : projet Google Cloud contenant la table Cloud SQL. Ce champ est obligatoire.
      • ID d'instance : ID de l'instance Cloud SQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • ID de la base de données : ID de la base de données Cloud SQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • ID de la table : ID de la table Cloud SQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • Saisissez l'emplacement du bucket Google Cloud Storage pour les données. Ce champ est obligatoire. (Facultatif) Sélectionnez Activer l'exportation sans serveur pour utiliser l'exportation sans serveur Cloud SQL. L'activation de l'exportation sans serveur entraîne des coûts supplémentaires. Consultez les tarifs de l'exportation sans serveur Cloud SQL.
   3. Cliquez sur Continuer.

6. Sur la page Configuration, configurez les paramètres de votre data store.

   • Emplacement de votre connecteur de données : choisissez une région où stocker les métadonnées de votre data store. Vous ne pouvez pas modifier l'emplacement après avoir créé le data store. Pour obtenir des informations importantes sur les emplacements multirégionaux, consultez Emplacements Gemini Enterprise.
   • Nom de votre connecteur de données : dans le champ Nom du connecteur de données, saisissez le nom de votre connecteur de données. Vous ne pouvez pas modifier le nom après la création du connecteur de données. Saisir un nom génère un identifiant unique pour votre connecteur de données. Si vous le souhaitez, dans le champ Tag (facultatif), saisissez un tag pour votre connecteur de données, qui servira d'identifiant stable pour le connecteur dans toutes les versions.
   • Règle de protection des données sensibles : sélectionnez une règle de protection des données sensibles pour votre data store. Le format doit être le suivant : projects/{project}/locations/{location}/contentPolicies/{policy}. Vous pourrez modifier ce paramètre ultérieurement.

7. Cliquez sur Créer.

Vous êtes maintenant prêt à associer votre data store à une application Gemini Enterprise. En mode de requête fédérée, les requêtes entraînent des coûts d'utilisation de Cloud SQL lorsque les utilisateurs exécutent des requêtes via l'application associée. En mode d'ingestion de données, l'importation de données entraîne des coûts d'indexation Cloud SQL, Cloud Storage et Gemini Enterprise avant même que le data store ne soit associé à une application. Pour en savoir plus sur ces frais, consultez la page Tarifs de Gemini Enterprise.

Étapes suivantes

• Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant les étapes décrites dans Créer une application Gemini Enterprise.

• Découvrez comment Knowledge Catalog fonctionne avec les connecteurs Data Cloud (activés automatiquement lorsque vous utilisez le mode de requête fédérée) pour aider l'agent à rechercher les données auxquelles l'utilisateur a accès et à rechercher le contexte organisationnel.

• Pour créer un agent ciblé de haute précision avec des requêtes validées, consultez Publier un agent de données Cloud SQL pour MySQL ou Agent de données Cloud SQL pour PostgreSQL sur Gemini Enterprise.