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ée) [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). Cette méthode est plus efficace pour les requêtes analytiques. Lorsque vous utilisez le mode requête fédérée, Knowledge Catalog est automatiquement activé dans l'onglet Assistant de votre application Gemini Enterprise. L'agent dispose ainsi d'outils pour rechercher les données auxquelles l'utilisateur a accès et pour trouver 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 grande précision, une portée de table déterministe et des requêtes validées (SQL de référence), créez un agent de données à portée limitée 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 vers 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 data store.

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 de l'organisation 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 (Restreindre 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.

De plus, 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, accordez 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 authentification IAM pour base de données) pour les requêtes et outils en lecture seule.
  • Administrateur AlloyDB (roles/alloydb.admin) si les actions d'écriture ou de gestion de cluster (comme 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 :
  • L'autorisation Utilisateur de l'outil MCP (roles/mcp.toolUser) dans le projet Google Cloud où réside le cluster AlloyDB pour PostgreSQL permet d'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 contenant le datastore Gemini Enterprise que vous créez, accordez le rôle Administrateur Cloud AlloyDB (roles/alloydb.admin) sur le projet AlloyDB pour PostgreSQL source au compte de [e-mail] (où PROJECT_NUMBER correspond au numéro du projetGoogle Cloud contenant le data store Gemini Enterprise).

Attention : Si vous choisissez d'ingérer des données depuis 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 des autorisations Gemini Enterprise suffisantes peut afficher les données, même s'il n'est pas autorisé à les consulter dans AlloyDB pour PostgreSQL.

Créer un data store AlloyDB pour PostgreSQL

Pour créer un data store qui associe 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 data store. Recherchez "AlloyDB pour PostgreSQL" dans le champ de recherche Sélectionner une source de données ou trouvez 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 savoir comment 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 tableau 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 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 AlloyDB pour PostgreSQL contenant les données que vous souhaitez importer. Ce champ est obligatoire.
      • ID de table : ID de 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 pour stocker les métadonnées de votre data store. Vous ne pouvez pas 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 le modifier une fois le connecteur de données créé. Lorsque vous saisissez un nom, un ID unique est généré pour votre connecteur de données. Si vous le souhaitez, dans le champ Tag (facultatif), saisissez un tag pour votre connecteur de données. Il 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 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 ingestion de données, l'importation de données entraîne des coûts d'indexation AlloyDB pour PostgreSQL et Gemini Enterprise, même avant 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 (automatiquement activés 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 à portée définie et de haute précision avec des requêtes validées, consultez Publier un agent de données AlloyDB pour PostgreSQL dans Gemini Enterprise.