Modifier une entité dans la console

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électionner une entité à modifier

  1. Dans la console Google Cloud, accédez à la page Base de données.

    Accéder à la page "Bases de données"

  2. Sélectionnez la base de données requise dans la liste des bases de données.

  3. Dans le menu de navigation, cliquez sur Datastore Studio.

  4. 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.

  5. Cliquez sur le nom/ID d'une entité. Votre écran devrait se présenter comme suit:

    Page de présentation de l'entité affichant des informations à son sujet.

Modifier une propriété

  1. Ouvrez la page Modifier l'entité d'une entité. Sous Properties (Propriétés), cliquez sur Edit (Modifier)  pour la propriété que vous souhaitez modifier.

  2. Dans le volet Edit property (Modifier la propriété), modifiez les paramètres Name (Nom), Type ou Value (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 la section Propriétés exclues.

    Cliquez sur le bouton "Modifier" pour modifier une propriété.

  3. Cliquez sur OK. Le volet Modifier la propriété se ferme, et le tableau des propriétés affiche désormais vos modifications. Les modifications ne sont pas appliquées à la base de données tant que vous n'avez pas 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é.

  4. Apportez des modifications supplémentaires à d'autres propriétés. Une fois vos modifications terminées, cliquez sur Enregistrer pour les appliquer à la base de données.

    La console valide vos modifications et vous redirige vers la page Datastore Studio.

Ajouter une propriété

  1. Ouvrez la page Modifier l'entité d'une entité. Cliquez sur Ajouter une propriété.
  2. Dans le volet Add a property (Ajouter une propriété), spécifiez un nom pour la propriété.
  3. Sélectionnez le type de données pour la propriété.
  4. Spécifiez une valeur pour la propriété.

  5. 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.

    Volet "Ajouter une propriété".

  6. Cliquez sur Ajouter. Le volet Ajouter une propriété se ferme, et le tableau des propriétés affiche désormais vos modifications. Les modifications ne sont pas appliquées à la base de données tant que vous n'avez pas 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é.

  7. Apportez des modifications supplémentaires à d'autres propriétés. Une fois vos modifications terminées, cliquez sur Enregistrer pour les appliquer à la base de données.

    La console valide vos modifications et vous redirige vers la page Datastore Studio.

Supprimer une propriété

  1. 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.

    Bouton de suppression dans le tableau des établissements.

  2. Le tableau des propriétés affiche désormais vos modifications. Les modifications ne sont pas appliquées à 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 la table de l'établissement.

  3. Apportez des modifications supplémentaires à d'autres propriétés. Une fois vos modifications terminées, cliquez sur Enregistrer pour les appliquer à 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.

Exemple de code JSON valide pour une propriété de tableau.

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.

Exemple de code JSON valide pour une propriété d'entité intégrée

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.

Étape suivante