Modello di dati Cloud Firestore

Cloud Firestore è un database NoSQL orientato ai documenti. A differenza di un database SQL, non ci sono tabelle o righe. I dati vengono invece archiviati in documenti , che sono organizzati in raccolte .

Ogni documento contiene una serie di coppie chiave-valore. Cloud Firestore è ottimizzato per l'archiviazione di grandi raccolte di piccoli documenti.

Tutti i documenti devono essere archiviati in raccolte. I documenti possono contenere sottoraccolte e oggetti nidificati, entrambi i quali possono includere campi primitivi come stringhe o oggetti complessi come elenchi.

Raccolte e documenti vengono creati implicitamente in Cloud Firestore. Assegna semplicemente i dati a un documento all'interno di una raccolta. Se la raccolta o il documento non esiste, Cloud Firestore lo crea.

Documenti

In Cloud Firestore, l'unità di archiviazione è il documento. Un documento è un record leggero che contiene campi associati a valori. Ogni documento è identificato da un nome.

Un documento che rappresenta un utente alovelace potrebbe assomigliare a questo:

• amorosa

  first : "Ada"
last : "Lovelace"
born : 1815
  

Nota: Cloud Firestore supporta una varietà di tipi di dati per i valori: booleano, numero, stringa, punto geografico, blob binario e timestamp. Puoi anche utilizzare array o oggetti nidificati, chiamati mappe, per strutturare i dati all'interno di un documento.

Gli oggetti complessi e nidificati in un documento sono chiamati mappe. Ad esempio, potresti strutturare il nome dell'utente dall'esempio sopra con una mappa, in questo modo:

• amorosa

  name :
first : "Ada"
last : "Lovelace"
born : 1815
  

Potresti notare che i documenti assomigliano molto a JSON. In effetti, fondamentalmente lo sono. Esistono alcune differenze (ad esempio, i documenti supportano tipi di dati aggiuntivi e hanno dimensioni limitate a 1 MB), ma in generale è possibile trattare i documenti come record JSON leggeri.

Collezioni

I documenti vivono in raccolte, che sono semplicemente contenitori di documenti. Ad esempio, potresti avere una raccolta users per contenere i vari utenti, ciascuno rappresentato da un documento:

• utenti

  • amorosa

    first : "Ada"
last : "Lovelace"
born : 1815
    

  • lezione in

    first : "Alan"
last : "Turing"
born : 1912
    

Cloud Firestore è senza schema, quindi hai completa libertà su quali campi inserire in ciascun documento e quali tipi di dati archiviare in tali campi. I documenti all'interno della stessa raccolta possono contenere tutti campi diversi o archiviare diversi tipi di dati in tali campi. Tuttavia, è consigliabile utilizzare gli stessi campi e tipi di dati in più documenti, in modo da poter eseguire query sui documenti più facilmente.

Una raccolta contiene documenti e nient'altro. Non può contenere direttamente campi non elaborati con valori e non può contenere altre raccolte. (Vedi Dati gerarchici per una spiegazione su come strutturare dati più complessi in Cloud Firestore.)

I nomi dei documenti all'interno di una raccolta sono univoci. Puoi fornire le tue chiavi, ad esempio gli ID utente, oppure lasciare che Cloud Firestore crei automaticamente ID casuali per te.

Non è necessario "creare" o "eliminare" raccolte. Dopo aver creato il primo documento in una raccolta, la raccolta esiste. Se elimini tutti i documenti di una raccolta, questa non esiste più.

Riferimenti

Ogni documento in Cloud Firestore è identificato in modo univoco dalla sua posizione all'interno del database. L'esempio precedente mostrava un documento alovelace all'interno della raccolta users . Per fare riferimento a questa posizione nel codice, puoi creare un riferimento ad essa.

Web modular API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

import { doc } from "firebase/firestore";

const alovelaceDocumentRef = doc(db, 'users', 'alovelace');
doc_reference.js

Web namespaced API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

var alovelaceDocumentRef = db.collection('users').doc('alovelace');
test.firestore.js

Veloce

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

let alovelaceDocumentRef = db.collection("users").document("alovelace")
ViewController.swift

Obiettivo-C

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

FIRDocumentReference *alovelaceDocumentRef =
    [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];
ViewController.m

Kotlin+KTX

val alovelaceDocumentRef = db.collection("users").document("alovelace")
DocSnippets.kt

Java

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");
DocSnippets.java

Dart

final alovelaceDocumentRef = db.collection("users").doc("alovelace");
firestore.dart

Giava

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
References.java

Pitone

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

Python

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

C++

DocumentReference alovelace_document_reference =
    db->Collection("users").Document("alovelace");
snippets.cpp

Node.js

const alovelaceDocumentRef = db.collection('users').doc('alovelace');
index.js

Andare

import (
	"cloud.google.com/go/firestore"
)

func createDocReference(client *firestore.Client) {

	alovelaceRef := client.Collection("users").Doc("alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document.go

PHP

PHP

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

$document = $db->collection('samples/php/users')->document('alovelace');
data_reference_document.php

Unità

DocumentReference documentRef = db.Collection("users").Document("alovelace");

C#

C#

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

DocumentReference documentRef = db.Collection("users").Document("alovelace");
Program.cs

Rubino

document_ref = firestore.col("users").doc("alovelace")
data_model.rb

Un riferimento è un oggetto leggero che punta semplicemente a una posizione nel database. È possibile creare un riferimento indipendentemente dal fatto che i dati esistano o meno e la creazione di un riferimento non esegue alcuna operazione di rete.

Puoi anche creare riferimenti alle collezioni :

Web modular API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

import { collection } from "firebase/firestore";

const usersCollectionRef = collection(db, 'users');
collection_reference.js

Web namespaced API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

var usersCollectionRef = db.collection('users');
test.firestore.js

Veloce

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

let usersCollectionRef = db.collection("users")
ViewController.swift

Obiettivo-C

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];
ViewController.m

Kotlin+KTX

val usersCollectionRef = db.collection("users")
DocSnippets.kt

Java

CollectionReference usersCollectionRef = db.collection("users");
DocSnippets.java

Dart

final usersCollectionRef = db.collection("users");
firestore.dart

Giava

// Reference to the collection "users"
CollectionReference collection = db.collection("users");
References.java

Pitone

users_ref = db.collection("users")
snippets.py

Python

users_ref = db.collection("users")
snippets.py

C++

CollectionReference users_collection_reference = db->Collection("users");
snippets.cpp

Node.js

const usersCollectionRef = db.collection('users');
index.js

Andare

import (
	"cloud.google.com/go/firestore"
)

func createCollectionReference(client *firestore.Client) {
	usersRef := client.Collection("users")

	_ = usersRef
}
retrieve_data_reference_collection.go

PHP

PHP

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

$collection = $db->collection('samples/php/users');
data_reference_collection.php

Unità

CollectionReference collectionRef = db.Collection("users");

C#

C#

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

CollectionReference collectionRef = db.Collection("users");
Program.cs

Rubino

collection_ref = firestore.col "users"
data_model.rb

Nota: i riferimenti alle raccolte e i riferimenti ai documenti sono due tipi distinti di riferimenti e consentono di eseguire operazioni diverse. Ad esempio, potresti utilizzare un riferimento a una raccolta per eseguire query sui documenti nella raccolta e potresti utilizzare un riferimento a un documento per leggere o scrivere un singolo documento.

Per comodità, puoi anche creare riferimenti specificando il percorso di un documento o di una raccolta come una stringa, con i componenti del percorso separati da una barra ( / ). Ad esempio, per creare un riferimento al documento alovelace :

Web modular API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

import { doc } from "firebase/firestore"; 

const alovelaceDocumentRef = doc(db, 'users/alovelace');
doc_reference_alternative.js

Web namespaced API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

var alovelaceDocumentRef = db.doc('users/alovelace');
test.firestore.js

Veloce

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

let aLovelaceDocumentReference = db.document("users/alovelace")
ViewController.swift

Obiettivo-C

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

FIRDocumentReference *aLovelaceDocumentReference =
    [self.db documentWithPath:@"users/alovelace"];
ViewController.m

Kotlin+KTX

val alovelaceDocumentRef = db.document("users/alovelace")
DocSnippets.kt

Java

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");
DocSnippets.java

Dart

final aLovelaceDocRef = db.doc("users/alovelace");
firestore.dart

Giava

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
References.java

Pitone

a_lovelace_ref = db.document("users/alovelace")
snippets.py

Python

a_lovelace_ref = db.document("users/alovelace")
snippets.py

C++

DocumentReference alovelace_document = db->Document("users/alovelace");
snippets.cpp

Node.js

const alovelaceDocumentRef = db.doc('users/alovelace');
index.js

Andare

import (
	"cloud.google.com/go/firestore"
)

func createDocReferenceFromString(client *firestore.Client) {
	// Reference to a document with id "alovelace" in the collection "users"
	alovelaceRef := client.Doc("users/alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document_path.go

PHP

PHP

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

$document = $db->document('users/alovelace');
data_reference_document_path.php

Unità

DocumentReference documentRef = db.Document("users/alovelace");

C#

C#

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

DocumentReference documentRef = db.Document("users/alovelace");
Program.cs

Rubino

document_path_ref = firestore.doc "users/alovelace"
data_model.rb

Dati gerarchici

Per comprendere come funzionano le strutture di dati gerarchiche in Cloud Firestore, considera un'app di chat di esempio con messaggi e chat room.

Puoi creare una raccolta denominata rooms per archiviare diverse chat room:

• stanze

  • A

    name : "my chat room"
    

  • ...
    

Ora che hai le chat room, decidi come archiviare i tuoi messaggi. Potresti non volerli archiviare nel documento della chat room. I documenti in Cloud Firestore dovrebbero essere leggeri e una chat room potrebbe contenere un numero elevato di messaggi. Tuttavia, puoi creare raccolte aggiuntive all'interno del documento della chat room, come sottoraccolte.

Sottoraccolte

Il modo migliore per archiviare i messaggi in questo scenario consiste nell'utilizzare le sottoraccolte. Una sottoraccolta è una raccolta associata a un documento specifico.

Nota: è possibile eseguire query su sottoraccolte con lo stesso ID raccolta utilizzando Query gruppo di raccolta .

Puoi creare una sottoraccolta chiamata messages per ogni documento della stanza nella tua raccolta rooms :

• stanze

  • A

    name : "my chat room"
    

    • messaggi

      • messaggio

        from : "alex"
msg : "Hello World!"
        

      • messaggio

        ...
        

  • ...
    

In questo esempio, creerai un riferimento a un messaggio nella sottoraccolta con il seguente codice:

Web modular API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

import { doc } from "firebase/firestore"; 

const messageRef = doc(db, "rooms", "roomA", "messages", "message1");
subcollection_reference.js

Web namespaced API

Scopri di più sull'API Web modulare modificabile ad albero e sull'aggiornamento dall'API con spazio dei nomi.

var messageRef = db.collection('rooms').doc('roomA')
                .collection('messages').doc('message1');
test.firestore.js

Veloce

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

let messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
ViewController.swift

Obiettivo-C

Nota: questo prodotto non è disponibile sui target watchOS e App Clip.

FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];
ViewController.m

Kotlin+KTX

val messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
DocSnippets.kt

Java

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");
DocSnippets.java

Dart

final messageRef = db
    .collection("rooms")
    .doc("roomA")
    .collection("messages")
    .doc("message1");
firestore.dart

Giava

// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
References.java

Pitone

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

Python

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

C++

DocumentReference message_reference = db->Collection("rooms")
    .Document("roomA")
    .Collection("messages")
    .Document("message1");
snippets.cpp

Node.js

const messageRef = db.collection('rooms').doc('roomA')
  .collection('messages').doc('message1');
index.js

Andare

import (
	"cloud.google.com/go/firestore"
)

func createSubcollectionReference(client *firestore.Client) {
	messageRef := client.Collection("rooms").Doc("roomA").
		Collection("messages").Doc("message1")

	_ = messageRef
}
retrieve_data_reference_subcollection.go

PHP

PHP

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

$document = $db
    ->collection('rooms')
    ->document('roomA')
    ->collection('messages')
    ->document('message1');
data_reference_subcollection.php

Unità

DocumentReference documentRef = db
	.Collection("Rooms").Document("RoomA")
	.Collection("Messages").Document("Message1");

C#

C#

Per ulteriori informazioni sull'installazione e sulla creazione di un client Cloud Firestore, fare riferimento a Librerie client Cloud Firestore .

DocumentReference documentRef = db
    .Collection("Rooms").Document("RoomA")
    .Collection("Messages").Document("Message1");
Program.cs

Rubino

message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")
data_model.rb

Si noti lo schema alternato di raccolte e documenti. Le tue collezioni e i tuoi documenti devono sempre seguire questo schema. Non è possibile fare riferimento a una raccolta in una raccolta o a un documento in un documento.

Le sottoraccolte consentono di strutturare i dati in modo gerarchico, facilitando l'accesso ai dati. Per ottenere tutti i messaggi in roomA , puoi creare un riferimento alla raccolta per messages della sottoraccolta e interagire con esso come faresti con qualsiasi altro riferimento alla raccolta.

I documenti nelle sottoraccolte possono contenere anche sottoraccolte, consentendo di nidificare ulteriormente i dati. È possibile annidare i dati fino a 100 livelli di profondità.

Attenzione: l'eliminazione di un documento non elimina le sue sottoraccolte!

Quando elimini un documento che contiene sottoraccolte, tali sottoraccolte non vengono eliminate. Ad esempio, potrebbe esserci un documento situato in coll/doc/subcoll/subdoc anche se il documento coll/doc non esiste più. Se desideri eliminare documenti nelle sottoraccolte quando elimini un documento principale, devi farlo manualmente, come mostrato in Elimina raccolte .