Vous pouvez mettre à jour les données structurées du schéma et les données non structurées avec des métadonnées compatibles avec un schéma.
Vous pouvez mettre à jour le schéma dans la console Google Cloud ou à l'aide de la méthode d'API schemas.patch.
Pour mettre à jour le schéma, vous pouvez ajouter des champs, modifier les annotations "indexable", "searchable" et "retrievable" d'un champ, ou marquer un champ comme propriété de clé, par exemple title, uri et description.
Mettre à jour votre schéma
Vous pouvez mettre à jour votre schéma dans la console Google Cloud ou à l'aide de l'API.
Console
Pour mettre à jour un schéma dans la console Google Cloud , procédez comme suit :
Consultez la section Exigences et limites pour vérifier que la mise à jour de votre schéma est valide.
Si vous mettez à jour des annotations de champ (en définissant des champs comme indexables, récupérables, utilisables comme attributs dynamiques, consultables ou complétables), consultez Configurer les paramètres de champ pour connaître les limites et les exigences de chaque type d'annotation.
Vérifiez que vous avez terminé l'ingestion des données. Sinon, il est possible que le schéma ne soit pas encore disponible pour modification.
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Dans la colonne Nom, cliquez sur le data store contenant le schéma que vous souhaitez mettre à jour.
Cliquez sur l'onglet Schéma pour afficher le schéma de vos données.
Cet onglet peut être vide si c'est la première fois que vous modifiez les champs.
Cliquez sur le bouton Modifier.
Mettez à jour votre schéma :
Mapper les propriétés de clé : dans la colonne Propriétés de clé de votre schéma, sélectionnez une propriété de clé à laquelle mapper un champ. Par exemple, si un champ appelé
detailscontient toujours la description d'un document, mappez ce champ à la propriété de clé Description.Mettre à jour le nombre de dimensions (avancé) : vous pouvez modifier ce paramètre si vous utilisez des embeddings vectoriels personnalisés avec Gemini Enterprise. Consultez Utiliser des embeddings personnalisés dans la documentation Agent Search.
Mettre à jour les annotations de champ : pour mettre à jour les annotations d'un champ, sélectionnez ou désélectionnez le paramètre d'annotation d'un champ. Les annotations disponibles sont Récupérable, Indexable, Ajout d'attributs dynamique, Inclus dans l'index de recherche et Complétable. Certains paramètres de champ sont limités. Consultez Configurer les paramètres des champs pour obtenir une description et les exigences de chaque type d'annotation.
Ajouter un champ : l'ajout de champs à votre schéma avant d'importer de nouveaux documents contenant ces champs peut réduire le temps nécessaire à Gemini Enterprise pour réindexer vos données après l'importation.
Cliquez sur Ajouter des champs pour développer cette section.
Cliquez sur add_box Ajouter un nœud et spécifiez les paramètres du nouveau champ.
Pour indiquer un tableau, définissez Tableau sur Oui. Par exemple, pour ajouter un tableau de chaînes, définissez type sur
stringet Array surYes.
Cliquez sur Enregistrer pour appliquer les modifications apportées au schéma.
La modification du schéma déclenche la réindexation. Pour les datastores volumineux, la réindexation peut prendre plusieurs heures.
REST
Pour utiliser l'API afin de mettre à jour votre schéma, procédez comme suit :
Consultez les sections Exigences et limites et Exemples de limites (REST uniquement) pour vérifier que vos modifications de schéma sont valides.
Pour mettre à jour le schéma des datastores contenant des données non structurées avec des métadonnées, passez à l'étape 5 pour appeler la méthode
schema.patch.Si vous mettez à jour des annotations de champ (en définissant des champs comme indexables, récupérables, utilisables comme attributs dynamiques ou consultables), consultez Configurer les paramètres de champ pour connaître les limites et les exigences de chaque type d'annotation.
Si vous modifiez un schéma détecté automatiquement, assurez-vous d'avoir terminé l'ingestion des données. Sinon, il est possible que le schéma ne soit pas encore disponible pour modification.
Recherchez l'ID de votre data store. Si vous disposez déjà de l'ID de votre data store, passez à l'étape suivante.
Dans la console Google Cloud , accédez à la page Gemini Enterprise et cliquez sur Datastores dans le menu de navigation.
Cliquez sur le nom de votre datastore.
Sur la page Données de votre datastore, obtenez l'ID du datastore.
Utilisez la méthode d'API schemas.patch pour fournir votre nouveau schéma JSON en tant qu'objet JSON.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/schemas/default_schema" \ -d '{ "structSchema": JSON_SCHEMA_OBJECT }'Remplacez les éléments suivants :
PROJECT_ID: par l'ID du projet.DATA_STORE_ID: ID du data store.JSON_SCHEMA_OBJECT: votre nouveau schéma JSON en tant qu'objet JSON. Exemple :{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } }, "uri": { "type": "string", "keyPropertyMapping": "uri" } } }
Facultatif : examinez le schéma en suivant la procédure Afficher une définition de schéma.
C#
Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Gemini Enterprise à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Gemini Enterprise en langage C#.
Pour vous authentifier auprès de Gemini Enterprise, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Gemini Enterprise à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Gemini Enterprise en langage Go.
Pour vous authentifier auprès de Gemini Enterprise, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Gemini Enterprise à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Gemini Enterprise en langage Java.
Pour vous authentifier auprès de Gemini Enterprise, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Gemini Enterprise à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Gemini Enterprise en langage Python.
Pour vous authentifier auprès de Gemini Enterprise, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Gemini Enterprise à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Gemini Enterprise en langage Ruby.
Pour vous authentifier auprès de Gemini Enterprise, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Conditions requises et limites
Lorsque vous mettez à jour un schéma, assurez-vous que le nouveau schéma est rétrocompatible avec le schéma que vous mettez à jour. Pour mettre à jour un schéma avec un nouveau schéma qui n'est pas rétrocompatible, vous devez supprimer tous les documents du data store, supprimer le schéma et en créer un autre.
La mise à jour d'un schéma déclenche la réindexation de tous les documents. La réindexation d'un data store volumineux peut prendre des heures, voire des jours.
Les mises à jour de schéma ne sont pas compatibles avec les éléments suivants :
- Modifier le type d'un champ. Une mise à jour de schéma ne permet pas de modifier le type d'un champ, à une exception près : un champ de type
integerpeut être remplacé parnumber. Toute autre modification, telle queintegeràstring, un champ unique à un tableau ou une profondeur d'imbrication différente pour un tableau existant, échoue avec l'erreurSchema update cannot alter the field type. Field type mismatch for field "FIELD_NAME". - Supprimer un champ Une fois défini, un champ ne peut pas être supprimé. Vous pouvez continuer à ajouter des champs, mais vous ne pouvez pas en supprimer. Une requête qui omet un champ existant échoue avec l'erreur
Schema update doesn't support removing fields. Fields "FIELD_NAME" cannot be removed. - Modifier d'autres mappages de propriétés clés Vous pouvez ajouter ou supprimer les mappages de propriétés de clé
title,description,uri,create_timeetupdate_time. Vous ne pouvez pas déplacer un mappage de propriété de clé d'un champ à un autre, ni ajouter un autre mappage de propriété de clé à un schéma tant que le data store contient des documents.
Exemples de limites (REST uniquement)
Cette section présente des exemples de types de mises à jour de schéma valides et non valides. Ces exemples utilisent l'exemple de schéma JSON suivant :
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": "string",
"keyPropertyMapping": "description"
},
"categories": {
"type": "array",
"items": {
"type": "string",
"keyPropertyMapping": "category"
}
}
}
}
Exemples de mises à jour acceptées
Les mises à jour suivantes de l'exemple de schéma sont acceptées.
Ajouter un champ Dans cet exemple, le champ
properties.uria été ajouté au schéma.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { // Added field. This is supported. "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }Ajout ou suppression d'annotations de propriété de clé pour
title,descriptionouuri. Dans cet exemple,keyPropertyMappinga été ajouté au champtitle.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" // Added "keyPropertyMapping". This is supported. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }
Exemples de mises à jour de schéma non valides
Les mises à jour suivantes de l'exemple de schéma ne sont pas acceptées.
Modifier le type d'un champ. Dans cet exemple, le type du champ
titleest passé de "chaîne" à "nombre". Cette fonctionnalité n'est pas disponible.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "number" // Changed from string. Not allowed. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }Supprimer un champ Dans cet exemple, le champ
titlea été supprimé. Cette fonctionnalité n'est pas disponible.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { // "title" is removed. Not allowed. "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }