Se connecter à Spanner

Ce document explique comment créer un datastore qui se connecte aux données Spanner. 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 Spanner à 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 Spanner 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 à Spanner dans toutes les 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 les données auxquelles l'utilisateur a accès et de rechercher 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 à toutes les bases de données et tables 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 doré), créez un agent de données délimité dans Spanner et publiez-le dans Gemini Enterprise.

• Ingestion de données : copiez les données d'une table Spanner 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 Spanner. Ce mode entraîne 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 Spanner 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 de la règle d'administration est activée, assurez-vous que votre règle d'administration autorise le connecteur :

• Ajoutez spanner au paramètre allowedDataSources dans la discoveryengine.managed.allowedDataSources contrainte gérée (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.

En outre, configurez les autorisations IAM Spanner requises pour le mode 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 à Spanner à l'aide du mode de requête fédérée, accordez les rôles IAM suivants aux utilisateurs qui interrogent ou effectuent des actions via le connecteur dans le Google Cloud projet contenant votre base de données Spanner :

• Accès à la base de données:
  • Lecteur de bases de données Cloud Spanner (roles/spanner.databaseReader) pour les requêtes et outils en lecture seule.
  • Utilisateur de bases de données Cloud Spanner (roles/spanner.databaseUser) ou Administrateur de bases de données Cloud Spanner (roles/spanner.databaseAdmin) si les actions d'écriture ou LDD sont activées.
• Accès à l'outil MCP:
  • Utilisateur de l'outil MCP (roles/mcp.toolUser) dans le projet où réside la base de données Spanner pour appeler les outils MCP Spanner.

Ingestion de données

Pour ingérer des données à partir d'un source Google Cloud project différent du Google Cloud project contenant le datastore Gemini Enterprise que vous créez, accordez l'un des rôles IAM suivants sur le source Spanner project au [e-mail]_NUMBER compte de service (oùGoogle Cloud est le numéro de projet du project contenant le data store Gemini Enterprise) :

• Sans Data Boost: Lecteur de bases de données Cloud Spanner (roles/spanner.databaseReader)
• Avec Data Boost : Administrateur de bases de données Cloud Spanner (roles/spanner.databaseAdmin), ou un rôle personnalisé avec les autorisations de Lecteur de bases de données Cloud Spanner et spanner.databases.useDataBoost. Pour en savoir plus, consultez la page Présentation de Data Boost.

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

Créer un data store Spanner

Pour créer un data store qui connecte les données de Spanner à 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 "Spanner" dans le champ de recherche Sélectionner une source de données ou recherchez Spanner 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 Spanner 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 depuis votre table Spanner, spécifiez les informations suivantes :

      • ID du projet : le Google Cloud project contenant la table Spanner. Champ obligatoire.
      • ID d'instance : ID d'instance Spanner contenant les données que vous souhaitez importer. Champ obligatoire.
      • ID de la base de données : ID de la base de données Spanner contenant les données que vous souhaitez importer. Champ obligatoire.
      • ID de la table : ID de la table Spanner contenant les données que vous souhaitez importer. Champ obligatoire.

      Vous pouvez également sélectionner Activer Data Boost pour utiliser Spanner Data Boost et accélérer les requêtes. L'activation de Data Boost entraîne des coûts supplémentaires. Consultez les tarifs de Spanner Data Boost.

   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). Il servira 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 entraînent des coûts d'utilisation de Spanner 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 Spanner 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 à rechercher 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 Spanner dans Gemini Enterprise.