Gestisci Cloud Firestore con la console Firebase

Puoi eseguire le seguenti azioni su Cloud Firestore quando utilizzi la console Firebase :

• Visualizza, aggiungi, modifica ed elimina dati.
• Crea e aggiorna le regole di sicurezza di Cloud Firestore.
• Gestire gli indici.
• Monitorare l'utilizzo.

Visualizza i dati

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

Apri un percorso specifico

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

Filtra i documenti in una raccolta

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

Documenti degli antenati inesistenti

Un documento può esistere anche se uno o più suoi antenati non esistono. Ad esempio, il documento nel percorso /mycoll/mydoc/mysubcoll/mysubdoc può esistere anche se il documento antenato /mycoll/mydoc non esiste. Il visualizzatore dati Cloud Firestore visualizza un documento predecessore inesistente come segue:

• Nell'elenco dei documenti di una raccolta, gli ID dei documenti antenati inesistenti sono in corsivo .
• Nel pannello informativo di un documento antenato inesistente, il visualizzatore dati sottolinea che il documento non esiste.

Avvertenza: anche se nella console vengono visualizzati documenti antenati inesistenti, non vengono visualizzati nelle query e negli snapshot. È necessario creare il documento per includerlo nei risultati della query.

Interrogare i dati

Puoi eseguire query sui documenti nella scheda Generatore di query della pagina Dati di Cloud Firestore.

1. Vai alla pagina dei dati di Cloud Firestore

2. Fare clic sulla scheda Generatore di query .

3. Seleziona un ambito di query .

   Seleziona Raccolta per interrogare una singola raccolta. Nel campo di testo, inserisci il percorso di una raccolta.

   Seleziona Gruppo di raccolte per interrogare tutte le raccolte con lo stesso ID. Nel campo Gruppo di raccolta , inserisci un ID gruppo di raccolta.

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

4. Fare clic su Aggiungi alla query per filtrare la serie di documenti restituiti. Per impostazione predefinita, il generatore di query aggiunge una clausola WHERE . Puoi modificare questa clausola utilizzando i menu a discesa e i campi di testo o 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, fare clic sul pulsante Rimuovi . Per rimuovere tutte le clausole della query, fare clic su Cancella .

   Nota: le query devono soddisfare i requisiti e le limitazioni di Cloud Firestore per le query. In caso contrario, la query ha esito negativo e la pagina restituisce un errore che descrive il motivo per cui la query non è riuscita.

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

Requisiti e limitazioni delle query

Quando utilizzi il generatore di query, tieni presente i seguenti requisiti e limitazioni 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 che contiene un collegamento per creare l'indice richiesto.

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

• Le clausole di query Range ( < , <= , > , >= ) e Not equals ( != , not-in ) devono tutte filtrare sullo stesso campo.

Per ulteriori limitazioni, consulta Limitazioni delle query .

Gestisci i dati

In Cloud Firestore, archivi i dati in documenti e li organizzi in raccolte. Prima di iniziare ad aggiungere dati, scopri di più sul modello 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 dell'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 , quindi 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. Fare clic su Salva . La tua nuova raccolta e il tuo documento verranno visualizzati nel visualizzatore dati.
4. Per aggiungere altri documenti alla raccolta, fai clic su Aggiungi documento .

Modifica dati

1. Fare clic su una raccolta per visualizzarne i documenti, quindi fare clic su un documento per visualizzarne i campi e le sottoraccolte.
2. Fare clic su un campo per modificarne il valore. Per aggiungere campi o raccolte secondarie al documento selezionato, fare clic su Aggiungi campo o Aggiungi raccolta .

Elimina dati

Per eliminare una raccolta:

1. Seleziona la raccolta che desideri eliminare.
2. Fai clic sull'icona del menu nella parte superiore della colonna dei documenti, quindi fai clic su Elimina raccolta .

Per eliminare un documento o tutti i suoi campi:

1. Seleziona il documento che desideri 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 elimina tutti i dati nidificati in quel documento, incluse eventuali sottoraccolte. Tuttavia, l'eliminazione dei campi di un documento non elimina le relative sottoraccolte.

Per eliminare un campo specifico in un documento:

1. Seleziona il documento per visualizzarne i campi.
2. Fai clic sull'icona Elimina accanto al campo che desideri eliminare.

Gestisci le regole di sicurezza di Cloud Firestore

Per aggiungere, modificare ed eliminare le regole di sicurezza di Cloud Firestore dalla console Firebase, vai alla scheda Regole nella sezione Cloud Firestore . Ulteriori informazioni sull'impostazione e la personalizzazione delle regole .

Gestire gli indici

Per creare nuovi indici per le tue query e gestire gli indici esistenti dalla console Firebase, vai alla scheda Indici nella sezione Cloud Firestore . Ulteriori informazioni sulla gestione degli indici .

Monitorare l'utilizzo

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