Gestire Firestore con la console

Gestire Firestore con la console

Puoi gestire Firestore tramite le azioni seguenti nella Console Google Cloud:

• Visualizzare, eseguire query, aggiungere, modificare ed eliminare dati.
• Gestisci gli indici.

Nota: per gestire le regole di sicurezza, utilizza la Console Firebase.

Visualizza dati

Puoi visualizzare tutti i dati di Firestore nella console Google Cloud. Nel visualizzatore dei dati di Firestore, fai clic su un documento o una raccolta per aprire i dati nidificati all'interno dell'elemento.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Firestore Studio.

Apri un percorso specifico

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

Documenti predecessori inesistenti

Un documento può esistere anche se uno o più dei relativi predecessori non esistono esistono. Ad esempio, il documento nel percorso/mycoll/mydoc/mysubcoll/mysubdoc può esistere anche se il documento antecessore/mycoll/mydoc non esiste. Il visualizzatore dei dati di Firestore mostra i documenti antenati non esistenti come segue:

• Nell'elenco dei documenti di una raccolta, gli ID documento dei documenti antecessori non esistenti sono in corsivo.
• Nel riquadro informativo di un documento predecessore inesistente, il visualizzatore dati sottolinea 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.

Filtra dati

Puoi filtrare i documenti di una raccolta in base al valore del campo e alle condizioni ==, !-, >, >=, <, <=, in, not-in, array-contains,array-contains-any. Ad esempio, puoi visualizzare solo i documenti in cui il valore del campo firstname è uguale a Sam. Per applicare un filtro alla raccolta:

1. Fai clic sul pulsante del filtro accanto a un ID raccolta:

   

2. Dal menu Aggiungi filtri, seleziona un campo del documento, una condizione di filtro e un ordine di ordinamento.

   

3. Fai clic su Applica.

Per rimuovere un filtro della raccolta, apri lo stesso menu e fai clic su Cancella filtro.

Query sui dati

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

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Firestore Studio.

4. Fai clic sulla scheda Query Builder.

5. Seleziona un ambito della 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.

6. Fai clic su Aggiungi alla query per filtrare il set di documenti restituito. Per impostazione predefinita, Query Builder aggiunge una clausola WHERE. Puoi modifica questa clausola utilizzando i menu a discesa e i campi di testo oppure impostane uno 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 Rimuovi . Per rimuovere tutte le clausole di query, fai clic su Cancella.

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

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

   

Suggerimento: le query che esegui vengono memorizzate nella cronologia del browser. Durante sessione, puoi spostarti avanti e indietro all'interno del browser per accedere alle query. Puoi aggiungere ai preferiti le query a cui vuoi accedere di frequente o da condividere con altri.

Requisiti e limitazioni per le query

Quando utilizzi Query Builder, tieni presente i seguenti requisiti e limitazioni per le query.

• Tutte le query devono essere supportate da un altro indice. Se il database non riesce a trovare a un indice per supportare la query, restituirà un errore che contiene un link a creare l'indice richiesto.

  

• Le clausole ORDER BY devono corrispondere ai campi delle clausole WHERE e devono essere incluse nello stesso ordine. Per impostazione predefinita, i risultati sono ordinati in base all'ID documento. Se filtri da qualsiasi altro campo con un valore diverso da un'uguaglianza (==), aggiungi un 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 i dati

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

Puoi aggiungere, modificare ed eliminare documenti e raccolte dalla console Firebase. Per gestire i tuoi dati dalla console Google Cloud, Vai alla pagina di Firestore Studio:

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Firestore Studio.

Nota: le operazioni di lettura, scrittura ed eliminazione eseguite nella console vengono conteggiate ai fini del calcolo il tuo utilizzo di Firestore.

Aggiungi dati

1. Fai clic su Avvia raccolta.
2. Inserisci un ID raccolta. Inserisci un ID documento. Firestore generare l'ID documento, ma puoi sovrascrivere un ID documento specifico. 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 al documento selezionato, fai clic su Aggiungi campo oppure Avvia raccolta.

Elimina dati

Puoi eliminare documenti o raccolte dal visualizzatore dei dati.

Nota: in alcuni casi, l'eliminazione di un numero elevato di documenti potrebbe causare un caricamento lento del visualizzatore dei dati o restituire un errore di timeout. Vale per operazioni di eliminazione eseguite tramite il visualizzatore dati e altrove.

Per eliminare una raccolta:

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:

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.

L'eliminazione dei campi di un documento non comporta l'eliminazione delle relative sottoraccolte. Anche se vuoto, il documento esiste ancora e può essere visualizzato nei risultati della query.

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 da eliminare.

Gestisci le regole di sicurezza di Firestore

Puoi visualizzare le regole di sicurezza di Firestore dalla console Google Cloud. Per modificare o eliminare il set di regole, abilita Firebase utilizza l'interfaccia a riga di comando di Firebase o la console Firebase.

Attivazione di Firebase

Per modificare le regole di sicurezza di Firestore, devi attivare Firebase per il tuo progetto Google Cloud. Se Firebase non è abilitato, puoi attivare Firebase dalla pagina Regole di sicurezza:

La funzionalità Regole di sicurezza di Firestore è strettamente integrata con Firebase Auth e gli SDK Firebase (piattaforme web, Android, Apple). Per saperne di più su Firebase e Firestore, consulta la pagina Introduzione a Firebase.

Visualizza regole di sicurezza

Per visualizzare le regole di sicurezza di Firestore dalla console Google Cloud, vai a Pagina Regole di sicurezza:

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Regole di sicurezza.

Modifica regole di sicurezza

Per modificare o eliminare le regole di sicurezza di Firestore, utilizza l'interfaccia a riga di comando di Firebase o la console Firebase. Nella console Firebase, vai alla scheda Regole nella sezione 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 Firestore. Scopri di più sulla gestione degli indici.