Cette page explique comment modifier une entité à l'aide de la console Google Cloud.
Pour découvrir comment modifier une entité de manière automatisée, consultez la section Mettre à jour une entité.
Avant de commencer
Sur cette page, nous partons du principe que vous avez déjà créé une entité qui est stockée dans Firestore en mode Datastore. Vous pouvez créer une entité via l'API Datastore, comme décrit dans la section Premiers pas avec l'API Datastore ou via l'éditeur d'entité de la console Google Cloud, comme décrit dans le guide de démarrage rapide.
Sélectionnez une entité à modifier
Dans la console Google Cloud, accédez à la page Base de données.
Sélectionnez la base de données requise dans la liste des bases de données.
Dans le menu de navigation, cliquez sur Datastore Studio.
Recherchez l'entité que vous souhaitez modifier en spécifiant l'espace de noms, le genre et/ou les filtres pour les valeurs de propriété. Pour en savoir plus, consultez la section Exécuter une requête.
Cliquez sur le nom/ID d'une entité. Votre écran doit se présenter comme suit:
Modifier une propriété
Ouvrez la page Modifier l'entité d'une entité. Sous Properties (Propriétés), cliquez sur Edit (Modifier)
pour la propriété à modifier.Dans le volet Modifier la propriété, modifiez le nom, le type ou la valeur de la propriété. Vous pouvez également déterminer si la propriété est indexée ou non. Pour en savoir plus sur l'impact de l'inclusion ou de l'exclusion d'une propriété des index, consultez Propriétés exclues.
Cliquez sur OK. Le volet Edit Property (Modifier la propriété) se ferme, et le tableau des propriétés affiche désormais vos modifications. Les modifications ne sont validées dans la base de données qu'une fois que vous avez cliqué sur Enregistrer. Le tableau des propriétés met en évidence les modifications non validées par un point bleu à côté du nom de la propriété.
Apportez des modifications supplémentaires à d'autres propriétés. Une fois les modifications terminées, cliquez sur Enregistrer pour les valider dans la base de données.
La console valide vos modifications et vous redirige vers la page Datastore Studio.
Ajouter une propriété
- Ouvrez la page Modifier l'entité d'une entité. Cliquez sur Ajouter une propriété.
- Dans le volet Ajouter une propriété, spécifiez un nom pour la propriété.
- Sélectionnez le type de données pour la propriété.
- Spécifiez une valeur pour la propriété.
Déterminez si la propriété est indexée ou non. Pour en savoir plus sur l'impact de l'inclusion ou de l'exclusion d'une propriété des index, consultez la section Propriétés exclues.
Cliquez sur Ajouter. Le volet Ajouter une propriété se ferme et le tableau des propriétés affiche maintenant vos modifications. Les modifications ne sont validées dans la base de données qu'une fois que vous avez cliqué sur Enregistrer. Le tableau des propriétés met en évidence les modifications non validées par un point bleu à côté du nom de la propriété.
Apportez des modifications supplémentaires à d'autres propriétés. Une fois les modifications terminées, cliquez sur Enregistrer pour les valider dans la base de données.
La console valide vos modifications et vous redirige vers la page Datastore Studio.
Supprimer une propriété
Ouvrez la page Modifier l'entité d'une entité. Sous Properties (Propriétés), cliquez sur Delete (Supprimer)
pour la propriété que vous souhaitez supprimer.Le tableau des propriétés affiche maintenant vos modifications. Les modifications ne sont pas validées dans la base de données tant que vous n'avez pas cliqué sur Enregistrer. Le tableau des propriétés met en évidence les suppressions de propriétés non validées avec des noms et des valeurs de propriété barrés.
Vous pouvez annuler une suppression non validée en cliquant sur Restaurer dans la ligne de table de la propriété.
Apportez des modifications supplémentaires à d'autres propriétés. Une fois les modifications terminées, cliquez sur Enregistrer pour les valider dans la base de données.
Propriétés complexes
L'éditeur d'entité accepte les propriétés avec des types complexes tels que Array
et Embedded entity
.
Propriétés de tableau
Lorsque vous ajoutez ou modifiez la valeur d'une propriété Array
, indiquez une valeur au format JSON.
Si vous indiquez une valeur JSON non valide pour le champ Value (Valeur), vous recevrez un message d'erreur. Vous ne pourrez pas ajouter la propriété si le fichier JSON n'est pas valide.
Propriétés d'entités intégrées
Lorsque vous ajoutez ou modifiez la valeur d'une propriété Embedded entity
, indiquez une valeur au format JSON.
Si vous indiquez une valeur JSON non valide pour le champ Value (Valeur), vous recevrez un message d'erreur. Vous ne pourrez pas ajouter la propriété si le fichier JSON n'est pas valide.
Étapes suivantes
- Découvrez les bonnes pratiques relatives aux entités.