Se connecter à AlloyDB pour PostgreSQL

Ce document explique comment créer un datastore qui se connecte aux données AlloyDB pour PostgreSQL. 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 AlloyDB pour PostgreSQL à l'aide d'un data store Gemini Enterprise, vous pouvez utiliser l'un des modes suivants :

• Requête fédérée (recommandé) [Preview]: connectez-vous aux données AlloyDB pour PostgreSQL sur place sans frais de sortie pour la copie et le déplacement des données. La requête fédérée envoie votre requête directement à AlloyDB pour PostgreSQL sur l'ensemble des clusters, bases de données et tables auxquels votre identité dispose d'une autorisation d'accès 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 à tous les clusters 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, un champ d'application de table déterministe et des requêtes vérifiées (Golden SQL), créez un agent de données limité dans AlloyDB pour PostgreSQL et publiez-le dans Gemini Enterprise.

• Ingestion de données : copiez les données d'une table AlloyDB pour PostgreSQL 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 AlloyDB pour PostgreSQL. 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 AlloyDB pour PostgreSQL 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 alloydb 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, configurez les autorisations IAM AlloyDB pour PostgreSQL requises pour le mode 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 à AlloyDB pour PostgreSQL en mode requête fédérée, attribuez les rôles IAM suivants dans le projet Google Cloud qui contient votre cluster AlloyDB pour PostgreSQL aux utilisateurs qui interrogent ou effectuent des actions via le connecteur :

• Accès au cluster et à la base de données :
  • Lecteur Cloud AlloyDB (roles/alloydb.viewer) et Client Cloud AlloyDB (roles/alloydb.client) (ou Utilisateur de base de données Cloud AlloyDB (roles/alloydb.databaseUser) avec l'authentification IAM pour base de données) pour les requêtes et les outils en lecture seule.
  • Administrateur Cloud AlloyDB (roles/alloydb.admin) si les actions d'écriture ou de gestion de cluster (telles que la création de clusters, d'instances ou de sauvegardes, ou l'exécution d'écritures SQL) sont activées.
• Accès aux outils MCP :
  • Autorisation Utilisateur de l'outil MCP (roles/mcp.toolUser) dans le projet Google Cloud où se trouve le cluster AlloyDB pour PostgreSQL pour appeler les outils MCP.

Ingestion de données

Pour ingérer des données à partir d'un projet source Google Cloud différent du projet Google Cloud qui contient le datastore Gemini Enterprise que vous créez, attribuez le rôle Administrateur Cloud AlloyDB (roles/alloydb.admin) sur le projet AlloyDB pour PostgreSQL source au compte de service [e-mail] (où PROJECT_NUMBER est le numéro du projetGoogle Cloud qui contient le data store Gemini Enterprise).

Attention : Si vous choisissez d'ingérer des données d'AlloyDB pour PostgreSQL dans un data store Gemini Enterprise, les autorisations AlloyDB pour PostgreSQL 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 AlloyDB pour PostgreSQL.

Créer un data store AlloyDB pour PostgreSQL

Pour créer un data store qui connecte les données d'AlloyDB pour PostgreSQL à 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 "AlloyDB pour PostgreSQL" dans le champ de recherche Sélectionner une source de données ou recherchez AlloyDB pour PostgreSQL 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 AlloyDB pour PostgreSQL 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 AlloyDB pour PostgreSQL, spécifiez les informations suivantes :
      • ID du projet : projet Google Cloud contenant la table AlloyDB pour PostgreSQL. Ce champ est obligatoire.
      • ID de zone géographique : ID de zone géographique AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • ID du cluster : ID du cluster AlloyDB pour PostgreSQL qui contient 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 AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • ID de la table : ID de la table AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
   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 datastore à une application Gemini Enterprise. En mode de requête fédérée, les requêtes entraînent des coûts d'utilisation d'AlloyDB pour PostgreSQL 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 AlloyDB pour PostgreSQL et Gemini Enterprise avant même que le datastore 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 AlloyDB pour PostgreSQL sur Gemini Enterprise.