Gérer Cloud Firestore avec la console Firebase

Vous pouvez effectuer les actions suivantes sur Cloud Firestore lorsque vous utilisez la console Firebase:

• Afficher, ajouter, modifier et supprimer des données.
• Créez et mettez à jour Cloud Firestore Security Rules.
• Gérer les index.
• Surveiller l'utilisation

Afficher les données

Vous pouvez afficher toutes vos données Cloud Firestore dans la console Firebase. Dans l'onglet Cloud Firestore Données, cliquez sur un document ou une collection pour ouvrir les données imbriquées dans cet élément.

Ouvrir un chemin spécifique

Pour ouvrir un document ou une collection à un chemin spécifique, utilisez le bouton Modifier le chemin d'accès  :

Filtrer les documents d'une collection

Pour filtrer les documents listés dans une collection, utilisez le bouton Filtrer la liste .

Documents ancêtres inexistants

Un document peut exister même si un ou plusieurs de ses ancêtres n'existent pas. Par exemple, le document au chemin /mycoll/mydoc/mysubcoll/mysubdoc peut exister même si le document ancêtre /mycoll/mydoc n'existe pas. La visionneuse de données Cloud Firestore affiche le document ancêtre inexistant comme suit:

• Dans la liste des documents d'une collection, les ID de documents des documents ancêtres inexistants sont en italique.
• Dans le panneau d'information d'un document ancêtre inexistant, la visionneuse de données indique que le document n'existe pas.

Avertissement : Même si des ancêtres inexistants apparaissent dans la console, ils n'apparaissent pas dans les requêtes ni dans les instantanés. Vous devez créer le document pour l'inclure dans les résultats de la requête.

Interroger les données

Vous pouvez interroger des documents dans l'onglet Générateur de requêtes de la page Cloud Firestore "Données".

1. Accéder à la page Cloud Firestore "Données"

2. Cliquez sur l'onglet Générateur de requêtes.

3. Sélectionnez un champ d'application de la requête.

   Sélectionnez Collection pour interroger une seule collection. Dans le champ de texte, saisissez un chemin d'accès à une collection.

   Sélectionnez Groupe de collections pour interroger toutes les collections ayant le même ID. Dans le champ Groupe de collections, saisissez un ID de groupe de collections.

   Le tableau affiche automatiquement les documents de la collection ou du groupe de collections spécifiés.

4. Cliquez sur Ajouter à la requête pour filtrer l'ensemble de documents renvoyés. Par défaut, le générateur de requêtes ajoute une clause WHERE. Vous pouvez modifier cette clause à l'aide des menus déroulants et des champs de texte, ou passer à l'une des autres clauses disponibles. Pour continuer à créer des requêtes plus complexes, cliquez sur Ajouter à la requête.

   Pour supprimer une clause de requête, cliquez sur le bouton de suppression . Pour supprimer toutes les clauses de requête, cliquez sur Effacer.

   Remarque :Les requêtes doivent respecter les conditions requises et les limites de Cloud Firestore. Sinon, la requête échoue et la page renvoie une erreur qui décrit pourquoi la requête a échoué.

5. Cliquez sur Exécuter pour récupérer les résultats de votre base de données.

Exigences et limites concernant les requêtes

Lorsque vous utilisez le générateur de requêtes, tenez compte des exigences et des limites suivantes pour les requêtes.

• Toutes les requêtes doivent être prises en charge par un ou plusieurs index. Si la base de données ne trouve pas d'index compatible avec la requête, elle renvoie une erreur contenant un lien permettant de créer l'index requis.

• Les clauses ORDER BY doivent correspondre aux champs des clauses WHERE et être dans le même ordre. Par défaut, les résultats sont triés par ID de document. Si vous filtrez par un autre champ que l'égalité (==), ajoutez une clause ORDER BY pour ce champ.

• Les clauses de requête de plage (<, <=, > et >=) et d'opérateurs "not equal" (!= et not-in) doivent toutes filtrer sur le même champ.

Pour en savoir plus, consultez la section Limites des requêtes.

Gérer les données

Dans Cloud Firestore, vous stockez des données dans des documents et organisez vos documents en collections. Avant de commencer à ajouter des données, découvrez le modèle de données Cloud Firestore.

Vous pouvez ajouter, modifier et supprimer des documents et des collections depuis la console Firebase. Pour gérer vos données, ouvrez l'onglet Données dans la section Cloud Firestore:

Remarque: Les opérations de lecture, d'écriture et de suppression effectuées dans la console comptent dans votre utilisation de Cloud Firestore. Certaines activités de la console, comme l'affichage d'un document contenant plusieurs champs, peuvent générer plusieurs opérations.

Ajouter des données

1. Cliquez sur Ajouter une collection, puis saisissez le nom de votre collection et cliquez sur Suivant.
2. Saisissez un ID de document spécifique ou cliquez sur ID automatique, puis ajoutez des champs pour les données de votre document.
3. Cliquez sur Enregistrer. Votre nouvelle collection et votre nouveau document s'affichent dans la visionneuse de données.
4. Pour ajouter d'autres documents à la collection, cliquez sur Ajouter un document.

Modifier des données

1. Cliquez sur une collection pour afficher ses documents, puis sur un document pour afficher ses champs et ses sous-collections.
2. Cliquez sur un champ pour modifier sa valeur. Pour ajouter des champs ou des sous-collections au document sélectionné, cliquez sur Ajouter un champ ou sur Ajouter une collection.

Supprimer des données

Pour supprimer une collection :

1. Sélectionnez la collection que vous souhaitez supprimer.
2. Cliquez sur l'icône de menu située en haut de la colonne des documents, puis sur Supprimer la collection.

Pour supprimer un document ou tous ses champs :

1. Sélectionnez le document que vous souhaitez supprimer.
2. Cliquez sur l'icône de menu située en haut de la colonne des détails du document. Sélectionnez Supprimer le document ou Supprimer les champs du document.

La suppression d'un document entraîne la suppression de toutes les données imbriquées dans ce document, y compris dans les sous-collections. Toutefois, la suppression des champs d'un document ne supprime pas ses sous-collections.

Pour supprimer un champ spécifique d'un document :

1. Sélectionnez le document pour afficher ses champs.
2. Cliquez sur l'icône de suppression, à côté du champ que vous souhaitez supprimer.

Gérer Cloud Firestore Security Rules

Pour ajouter, modifier et supprimer des Cloud Firestore Security Rules dans la console Firebase, accédez à l'onglet Règles de la section Cloud Firestore. En savoir plus sur la configuration et la personnalisation des règles

Gérer les index

Pour créer des index pour vos requêtes et gérer les index existants à partir de la console Firebase, accédez à l'onglet Index dans la section Cloud Firestore. En savoir plus sur la gestion des index

Surveiller l'utilisation

Pour surveiller votre utilisation de Cloud Firestore, ouvrez l'onglet Cloud Firestore Utilisation dans la console Firebase. Utilisez le tableau de bord pour évaluer votre utilisation sur différentes périodes.