Gérer Firestore avec la console

Gérer Firestore avec la console

Pour gérer Firestore, effectuez les actions suivantes dans la console Google Cloud:

• afficher, interroger, ajouter, modifier et supprimer des données ;
• Gérer les index.

Remarque :Pour gérer vos règles de sécurité, utilisez la console Firebase.

Afficher les données

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

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 Firestore Studio.

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  :

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 de Firestore affiche les documents ancêtres inexistants 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.

Filtrer les données

Vous pouvez filtrer les documents d'une collection en fonction de la valeur du champ et des conditions ==, !-, >, >=, <, <=, in, not-in, array-contains et array-contains-any. Par exemple, vous pouvez n'afficher que les documents dans lesquels la valeur du champ firstname est égale à Sam. Pour appliquer un filtre à une collection :

1. Cliquez sur le bouton de filtre à côté d'un ID de collection :

   

2. Dans le menu Ajouter des filtres, sélectionnez un champ de document, une condition de filtre et un ordre de tri.

   

3. Cliquez sur Appliquer.

Pour supprimer un filtre de collection, ouvrez le même menu et cliquez sur Supprimer le filtre.

Interroger les données

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

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 Firestore Studio.

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

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

   Sélectionnez Collection pour interroger une seule collection. Dans le champ de texte, saisissez le 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.

   La table affiche automatiquement les documents de la collection ou du groupe de collections spécifié.

6. 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 de suppression . Pour supprimer toutes les clauses de requête, cliquez sur Clear (Effacer).

   Remarque :Les requêtes doivent répondre aux exigences et aux limites de Firestore. Sinon, la requête échoue, et la page renvoie une erreur qui explique pourquoi la requête a échoué.

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

   

Conseil :Les requêtes que vous exécutez sont stockées dans l'historique de votre navigateur. Au cours de la session, vous pouvez avancer et reculer dans le navigateur pour accéder aux requêtes récentes. Vous pouvez ajouter aux favoris les requêtes auxquelles vous souhaitez accéder souvent ou les partager avec d'autres utilisateurs.

Exigences et limites concernant les requêtes

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

• Toutes les requêtes doivent être compatibles avec 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 pour créer l'index requis.

  

• Les clauses ORDER BY doivent correspondre aux champs des clauses WHERE 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 avec un autre champ avec autre chose qu'une égalité (==), ajoutez une clause ORDER BY pour ce champ.

  

• Les clauses de requête de plage (<, <=, >, >=) et non égales (!=, not-in) doivent toutes filtrer sur le même champ.

Pour connaître les autres limites, consultez la section Limites des requêtes.

Gérer les données

Dans Firestore, vous stockez des données dans des documents et organisez vos documents en collections. Avant de commencer à ajouter des données, apprenez-en plus sur le modèle de données Firestore.

Vous pouvez ajouter, modifier et supprimer des documents et des collections depuis la console Firebase. Pour gérer vos données à partir de la console GCP, accédez à la page Firestore Studio:

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 Firestore Studio.

Remarque :Les opérations de lecture, d'écriture et de suppression effectuées dans la console sont comptabilisées dans votre utilisation de Firestore.

Ajouter des données

1. Cliquez sur Démarrer la collection.
2. Saisissez un ID de collection. Saisissez un ID de document. Firestore génère un ID de document, mais vous pouvez le remplacer par un ID de document spécifique. 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 Commencer 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 :

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.

La suppression des champs d'un document ne supprime pas ses sous-collections. Bien que vide, le document existe toujours et peut apparaître dans les résultats de requête.

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 les règles de sécurité Firestore

Vous pouvez afficher vos règles de sécurité Firestore dans la console Google Cloud. Pour modifier ou supprimer votre ensemble de règles, activez Firebase et utilisez la CLI Firebase ou la console Firebase.

Activer Firebase

Pour modifier vos règles de sécurité Firestore, vous devez activer Firebase pour votre projet Google Cloud. Si Firebase n'est pas activé, vous pouvez l'activer à partir de la page Règles de sécurité :

La fonctionnalité des règles de sécurité Firestore est étroitement intégrée à l'authentification Firebase et aux SDK Firebase (plates-formes Web, Android, Apple). Pour en savoir plus sur Firebase et Firestore, consultez la page Premiers pas avec Firebase.

Afficher les règles de sécurité

Pour afficher vos règles de sécurité Firestore à partir de la console Google Cloud, accédez à la page Règles de sécurité:

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 Security Rules (Règles de sécurité).

Modifier les règles de sécurité

Pour modifier ou supprimer vos règles de sécurité Firestore, utilisez la CLI Firebase ou la console Firebase. Dans la console Firebase, accédez à l'onglet Règles de la section 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 de la section Firestore. En savoir plus sur la gestion des index