Gestisci Cloud Firestore con la console Firebase

Quando utilizzi la Console Firebase, puoi eseguire le seguenti azioni su Cloud Firestore:

• Visualizzare, aggiungere, modificare ed eliminare i dati.
• Crea e aggiorna Cloud Firestore Security Rules.
• Gestire gli indici.
• Monitoraggio dell'utilizzo.

Visualizza dati

Puoi visualizzare tutti i dati di Cloud Firestore nella Console Firebase. Dalla scheda Cloud Firestore Dati, fai clic su un documento o una raccolta per aprire i dati nidificati all'interno dell'elemento.

Aprire un percorso specifico

Per aprire un documento o una raccolta in un percorso specifico, utilizza il pulsante Modifica percorso :

Filtrare i documenti in una raccolta

Per filtrare i documenti elencati in una raccolta, utilizza il pulsante Filtra elenco .

Documenti predecessori inesistenti

Un documento può esistere anche se uno o più dei suoi documenti precedenti non esistono. Ad esempio, il documento nel percorso/mycoll/mydoc/mysubcoll/mysubdoc può esistere anche se il documento antecessore/mycoll/mydoc non esiste. Il visualizzatore di dati Cloud Firestore mostra il documento principale non esistente come segue:

• Nell'elenco dei documenti di una raccolta, gli ID dei documenti predecessori non esistenti sono in corsivo.
• Nel riquadro delle informazioni di un documento principale inesistente, il visualizzatore dei dati indica che il documento non esiste.

Avviso: anche se i documenti principali inesistenti vengono visualizzati nella console, non vengono visualizzati nelle query e negli snapshot. Devi creare il documento per includerlo nei risultati della query.

Query sui dati

Puoi eseguire query sui documenti nella scheda Query Builder della pagina Cloud Firestore Dati.

1. Vai alla pagina Dati di Cloud Firestore

2. Fai clic sulla scheda Query Builder.

3. Seleziona un ambito di query.

   Seleziona Raccolta per eseguire una query su una singola raccolta. Nel campo di testo, inserisci il percorso di una raccolta.

   Seleziona Gruppo di raccolte per eseguire query su tutte le raccolte con lo stesso ID. Nel campo Gruppo di raccolte, inserisci un ID gruppo di raccolte.

   La tabella mostrerà automaticamente i documenti della raccolta o del gruppo di raccolte specificato.

4. Fai clic su Aggiungi alla query per filtrare il set di documenti restituito. Per impostazione predefinita, Query Builder aggiunge una clausola WHERE. Puoi modificare questa clausola utilizzando i menu a discesa e i campi di testo oppure passare a una delle altre clausole disponibili. Per continuare a creare query più complesse, fai clic su Aggiungi alla query.

   Per rimuovere una clausola di query, fai clic sul relativo pulsante di rimozione. Per rimuovere tutte le clausole di query, fai clic su Cancella.

   Nota: le query devono soddisfare i requisiti e le limitazioni Cloud Firestore per le query. In caso contrario, la query non va a buon fine e la pagina restituisce un errore che descrive il motivo dell'errore.

5. Fai clic su Esegui per recuperare i risultati dal database.

Requisiti e limitazioni delle query

Quando utilizzi Query Builder, tieni presente i requisiti e le limitazioni riportati di seguito per le query.

• Tutte le query devono essere supportate da uno o più indici. Se il database non riesce a trovare un indice per supportare la query, restituirà un errore contenente un link per creare l'indice richiesto.

• Le clausole ORDER BY devono corrispondere ai campi nelle clausole WHERE e devono essere nello stesso ordine. Per impostazione predefinita, i risultati sono ordinati in base all'ID documento. Se filtri in base a un altro campo con un valore diverso da un'uguaglianza (==), aggiungi una clausola ORDER BY per quel campo.

• Le clausole di query intervallo (<, <=, >, >=) e diverso da (!=, not-in) devono essere tutte applicate allo stesso campo.

Per ulteriori limitazioni, consulta Limitazioni delle query.

Gestisci dati

In Cloud Firestore, archivi i dati nei documenti e organizzi i documenti in raccolte. Prima di iniziare ad aggiungere dati, scopri di più sul modello dei dati Cloud Firestore.

Puoi aggiungere, modificare ed eliminare documenti e raccolte dalla console Firebase. Per gestire i tuoi dati, apri la scheda Dati nella sezione Cloud Firestore:

Nota: le operazioni di lettura, scrittura ed eliminazione eseguite nella console vengono conteggiate ai fini del tuo utilizzo di Cloud Firestore. Alcune attività della console, come la visualizzazione di un documento contenente più campi, possono generare diverse operazioni.

Aggiungi dati

1. Fai clic su Aggiungi raccolta, poi inserisci il nome della raccolta e fai clic su Avanti.
2. Inserisci un ID documento specifico o fai clic su ID automatico, quindi aggiungi i campi per i dati nel documento.
3. Fai clic su Salva. La nuova raccolta e il nuovo documento vengono visualizzati nel visualizzatore dei dati.
4. Per aggiungere altri documenti alla raccolta, fai clic su Aggiungi documento.

Modifica dati

1. Fai clic su una raccolta per visualizzarne i documenti, quindi fai clic su un documento per visualizzarne i campi e le sottoraccolte.
2. Fai clic su un campo per modificarne il valore. Per aggiungere campi o sottocollezioni al documento selezionato, fai clic su Aggiungi campo o Aggiungi collezione.

Elimina dati

Per eliminare una collezione:

1. Seleziona la raccolta da eliminare.
2. Fai clic sull'icona del menu nella parte superiore della colonna dei documenti e poi su Elimina raccolta.

Per eliminare un documento o tutti i suoi campi:

1. Seleziona il documento da eliminare.
2. Fai clic sull'icona del menu nella parte superiore della colonna dei dettagli del documento. Seleziona Elimina documento o Elimina campi documento.

L'eliminazione di un documento comporta l'eliminazione di tutti i dati nidificati al suo interno, incluse eventuali sottoraccolte. Tuttavia, l'eliminazione dei campi di un documento non comporta l'eliminazione delle relative sottoraccolte.

Per eliminare un campo specifico in un documento:

1. Seleziona il documento per visualizzarne i campi.
2. Fai clic sull'icona di eliminazione accanto al campo da eliminare.

Gestisci Cloud Firestore Security Rules

Per aggiungere, modificare ed eliminare Cloud Firestore Security Rules dalla console Firebase, vai alla scheda Regole nella sezione Cloud Firestore. Scopri di più su come configurare e personalizzare le regole.

Gestisci indici

Per creare nuovi indici per le query e gestire quelli esistenti dalla console Firebase, vai alla scheda Indici nella sezione Cloud Firestore. Scopri di più sulla gestione degli indici.

Monitorare l'utilizzo

Per monitorare l'utilizzo di Cloud Firestore, apri la scheda Cloud Firestore Utilizzo nella Console Firebase. Utilizza la dashboard per misurare il tuo utilizzo in periodi di tempo diversi.