Modello dati

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

Python
(asincrono)

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

Go

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

PHP

Visualizza su GitHub Feedback

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

Unità

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

C#

Visualizza su GitHub Feedback

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

Ruby

samples/snippets/src/main/java/com/example/firestore/snippets/References.java

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

Un riferimento è un oggetto leggero che punta solo a una posizione nel tuo database. Puoi creare un riferimento indipendentemente dalla presenza o meno di dati; inoltre, la creazione di un riferimento non esegue alcuna operazione di rete.

Puoi anche creare riferimenti a raccolte:

Versione 9 web

import { collection } from "firebase/firestore";

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

Versione 8 web

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

Swift

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Objective-C

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Kotlin+KTX
Android

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

Java
Android

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

Freccetto

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

Java

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

Python

users_ref = db.collection(u'users')snippets.py

Python
(asincrono)

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

Go

usersRef := client.Collection("users")retrieve.go

PHP

Visualizza su GitHub Feedback

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

Unità

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

C#

Visualizza su GitHub Feedback

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

Ruby

samples/snippets/src/main/java/com/example/firestore/snippets/References.java

collection_ref = firestore.col "users"data_model.rb

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

Versione 9 web

import { doc } from "firebase/firestore";

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

Versione 8 web

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

Swift

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Objective-C

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Kotlin+KTX
Android

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

Java
Android

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

Freccetto

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

Java

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

Python

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

Python
(asincrono)

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

Go

// Reference to a document with id "alovelace" in the collection "users"
alovelaceRef := client.Doc("users/alovelace")retrieve.go

PHP

Visualizza su GitHub Feedback

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

Unità

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

C#

Visualizza su GitHub Feedback

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

Ruby

samples/snippets/src/main/java/com/example/firestore/snippets/References.java

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

Dati gerarchici

Per capire come funzionano le strutture dei dati gerarchiche in Firestore, valuta un esempio di app di chat con messaggi e stanze virtuali.

Puoi creare una raccolta chiamata rooms per archiviare stanze virtuali diverse:

stanze
- stanzaA
  
  name : "my chat room"
- stanzaB
  
  ...

Ora che hai le stanze virtuali, decidi come archiviare i messaggi. Potresti non voler archiviarli nel documento della stanza virtuale. I documenti in Firestore devono essere leggeri e una stanza virtuale può contenere un numero elevato di messaggi. Tuttavia, puoi creare raccolte aggiuntive all'interno del documento della stanza virtuale, come sottoraccolte.

Collezioni secondarie

Il modo migliore per archiviare i messaggi in questo scenario è utilizzare le sottoraccolte. Per raccolta secondaria si intende una raccolta associata a un documento specifico.

Puoi creare una raccolta secondaria denominata messages per ogni documento della stanza nella raccolta rooms:

stanze
- stanzaA
  
  name : "my chat room"
  - messaggi
    - messaggio1
      
      from : "alex"
      msg : "Hello World!"
    - messaggio2
      
      ...
- stanzaB
  
  ...

In questo esempio viene creato un riferimento a un messaggio nella raccolta secondaria con il codice seguente:

Versione 9 web

import { doc } from "firebase/firestore";

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

Versione 8 web

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

Swift

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Objective-C

Nota:questo prodotto non è disponibile per i target watchOS e app clip.

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

Kotlin+KTX
Android

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

Java
Android

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

Freccetto

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

Java

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

Python

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

Python
(asincrono)

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

Go

messageRef := client.Collection("rooms").Doc("roomA").
	Collection("messages").Doc("message1")retrieve.go

PHP

Visualizza su GitHub Feedback

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

Unità

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

C#

Visualizza su GitHub Feedback

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

Ruby