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 les règles de sécurité Cloud Firestore.
- 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 Données Cloud Firestore, 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 sur un chemin spécifique, utilisez le bouton Modifier le chemin
:Filtrer les documents dans une collection
Pour filtrer les documents répertoriés dans une collection, utilisez le bouton Filtrer la liste
.Documents d'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 des documents ancêtres inexistants sont en italique .
- Dans le panneau d'information d'un document ancêtre inexistant, le visualiseur de données souligne que le document n'existe pas.
Données de requête
Vous pouvez rechercher des documents dans l'onglet Générateur de requêtes de la page Données Cloud Firestore.
Cliquez sur l'onglet Générateur de requêtes .
Sélectionnez une étendue de requête .
Sélectionnez Collection pour interroger une seule collection. Dans le champ de texte, entrez un chemin d'accès à une collection.
Sélectionnez Groupe de collections pour interroger toutes les collections avec le même ID. Dans le champ Groupe de collecte , saisissez un ID de groupe de collecte.
Le tableau affichera automatiquement les documents de la collection ou du groupe de collections spécifié.
Cliquez sur Ajouter à la requête pour filtrer l'ensemble de documents renvoyé. Par défaut, le générateur de requêtes ajoute une clause
WHERE
. Vous pouvez modifier cette clause à l'aide des listes déroulantes 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 son bouton Supprimer
. Pour supprimer toutes les clauses de requête, cliquez sur Effacer .Cliquez sur Exécuter pour récupérer les résultats de votre base de données.
Exigences et limites des requêtes
Lorsque vous utilisez le Générateur de requêtes, gardez à l'esprit les exigences et limitations 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 pour prendre en charge la requête, elle renverra une erreur contenant un lien pour créer l'index requis.
Les clauses
ORDER BY
doivent correspondre aux champs des clausesWHERE
et être présentées dans le même ordre. Par défaut, les résultats sont classés par ID de document. Si vous filtrez sur un autre champ avec autre chose qu'une égalité (==
), ajoutez une clauseORDER BY
pour ce champ.Les clauses de requête Range (
<
,<=
,>
,>=
) et non égales (!=
,not-in
) doivent toutes filtrer sur le même champ.
Pour connaître des limitations supplémentaires, consultez Limitations 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-en davantage sur 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 :
Ajouter des données
- Cliquez sur Ajouter une collection , puis entrez le nom de votre collection et cliquez sur Suivant .
- Saisissez un ID de document spécifique ou cliquez sur ID automatique , puis ajoutez des champs pour les données de votre document.
- Cliquez sur Enregistrer . Votre nouvelle collection et votre nouveau document apparaissent dans la visionneuse de données.
- Pour ajouter d'autres documents à la collection, cliquez sur Ajouter un document .
Modifier les données
- Cliquez sur une collection pour afficher ses documents, puis cliquez sur un document pour afficher ses champs et sous-collections.
- 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 Ajouter une collection .
Suprimmer les données
Pour supprimer une collection :
- Sélectionnez la collection que vous souhaitez supprimer.
- Cliquez sur l'icône de menu en haut de la colonne des documents, puis cliquez sur Supprimer la collection .
Pour supprimer un document ou tous ses champs :
- Sélectionnez le document que vous souhaitez supprimer.
- Cliquez sur l'icône de menu 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 supprime toutes les données imbriquées dans ce document, y compris les sous-collections. Cependant, la suppression des champs d'un document ne supprime pas ses sous-collections.
Pour supprimer un champ spécifique dans un document :
- Sélectionnez le document pour afficher ses champs.
- Cliquez sur l'icône de suppression à côté du champ que vous souhaitez supprimer.
Gérer les règles de sécurité Cloud Firestore
Pour ajouter, modifier et supprimer des règles de sécurité Cloud Firestore de la console Firebase, accédez à l' onglet Règles dans la section Cloud Firestore . En savoir plus sur la configuration et la personnalisation des règles .
Gérer les index
Pour créer de nouveaux index pour vos requêtes et gérer les index existants depuis 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 Utilisation de Cloud Firestore dans la console Firebase. Utilisez le tableau de bord pour évaluer votre utilisation sur différentes périodes.