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é) [Aperçu]: connectez-vous aux données AlloyDB pour PostgreSQL sur place sans générer de coûts 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 tous les clusters, bases de données et tables auxquels 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 les données auxquelles l'utilisateur a accès et de consulter le contexte.

  Attention : Requêtes de base de données de haute précision : le mode de requête fédérée offre 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, une délimitation déterministe des tables et des requêtes validées (SQL de référence), créez un agent de données dé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 génère des coûts 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 discoveryengine.managed.allowedDataSources contrainte gérée (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.

Configurez également les autorisations IAM AlloyDB pour PostgreSQL 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é est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation 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 à l'aide du mode de requête fédérée, accordez les rôles IAM suivants dans le Google Cloud projet contenant 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 authentification de base de données IAM) pour les requêtes et 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 d'outil MCP (roles/mcp.toolUser) dans le Google Cloud projet où réside le cluster AlloyDB pour PostgreSQL pour appeler les outils MCP.

Ingestion de données

Pour ingérer des données à partir d'un Google Cloud projet source différent du Google Cloud projet contenant le datastore Gemini Enterprise que vous créez, accordez lerôle Administrateur Cloud AlloyDB (roles/alloydb.admin) sur le projet AlloyDB pour PostgreSQL source [e-mail] compte de service (où PROJECT_NUMBER correspond au numéro duGoogle Cloud projet contenant 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 Google Cloud console, accédez à la Gemini Enterprise page.

   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 propriétaires. 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é est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation 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 des informations sur les données que vous souhaitez importer. Sous Importer des données à partir de votre table AlloyDB pour PostgreSQL, spécifiez les informations suivantes :
      • ID du projet : le Google Cloud projet contenant la table AlloyDB pour PostgreSQL. Champ obligatoire.
      • ID de l'emplacement : l'ID de l'emplacement AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Champ obligatoire.
      • ID du cluster : l'ID du cluster AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Champ obligatoire.
      • ID de la base de données : l'ID de la base de données AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Champ obligatoire.
      • ID de la table : l'ID de la table AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Champ 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 dans laquelle stocker les métadonnées de votre data store. Vous ne pourrez plus modifier l'emplacement une fois le data store créé. 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 pourrez plus modifier le nom une fois le connecteur de données créé. La saisie d'un nom génère un identifiant unique pour votre connecteur de données. Vous pouvez également saisir un tag pour votre connecteur de données dans le champ Tag (facultatif) , qui sert d'identifiant stable pour le connecteur dans toutes les versions.
   • Règle Sensitive Data Protection : sélectionnez une règle Sensitive Data Protection 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 pouvez maintenant associer votre data store à une application Gemini Enterprise. En mode de requête fédérée, les requêtes génèrent des coûts d'utilisation 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 génère des coûts d'indexation AlloyDB pour PostgreSQL et Gemini Enterprise avant même que le data store ne soit associé à une application. Pour en savoir plus sur ces frais, consultez 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 à consulter le contexte organisationnel.

• Pour créer un agent délimité de haute précision avec des requêtes validées, consultez Publier un agent de données AlloyDB pour PostgreSQL dans Gemini Enterprise.