Model danych Cloud Firestore

Cloud Firestore to baza danych NoSQL zorientowana na dokumenty. W przeciwieństwie do bazy danych SQL nie ma w niej tabel ani wierszy. Zamiast tego przechowujesz dane w dokumentach, które są porządkowane w kolekcje.

Każdy dokument zawiera zestaw par klucz-wartość. Cloud Firestore jest zoptymalizowany pod kątem przechowywania dużych kolekcji małych dokumentów.

Wszystkie dokumenty muszą być przechowywane w kolekcjach. Dokumenty mogą zawierać podkolekcje i zagnieżdżone obiekty, które mogą zawierać pola prymitywne, takie jak ciągi znaków, lub złożone obiekty, takie jak listy.

Kolekcje i dokumenty są tworzone domyślnie w usłudze Cloud Firestore. Po prostu przypisz dane do dokumentu w kolekcji. Jeśli kolekcja lub dokument nie istnieją, Cloud Firestore je tworzy.

Dokumenty

W Cloud Firestore jednostką przechowywania danych jest dokument. Dokument to lekki rekord zawierający pola, które są mapowane na wartości. Każdy dokument jest identyfikowany za pomocą nazwy.

Dokument reprezentujący użytkownika alovelace może wyglądać tak:

• class alovelace

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

Złożone, zagnieżdżone obiekty w dokumencie nazywane są mapami. Możesz na przykład ustrukturyzować nazwę użytkownika z powyższego przykładu za pomocą mapy takiej jak ta:

• class alovelace

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

Możesz zauważyć, że dokumenty są bardzo podobne do formatu JSON. W zasadzie tak. Istnieją pewne różnice (np. dokumenty obsługują dodatkowe typy danych, a ich rozmiar jest ograniczony do 1 MB), ale ogólnie można traktować dokumenty jak lekkie rekordy JSON.

Kolekcje

Dokumenty znajdują się w kolekcjach, które są po prostu kontenerami na dokumenty. Możesz na przykład mieć kolekcję users zawierającą różnych użytkowników, z których każdy jest reprezentowany przez dokument:

• collections_bookmark użytkowników

  • class alovelace

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

  • class aturing

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

Cloud Firestore nie ma schematu, więc masz pełną swobodę w wybieraniu pól do umieszczania w każdym dokumencie i typów danych, które mają być w nich przechowywane. Dokumenty w tej samej kolekcji mogą zawierać różne pola lub przechowywać w nich różne typy danych. Warto jednak używać tych samych pól i typów danych w kilku dokumentach, ponieważ ułatwia to tworzenie zapytań dotyczących tych dokumentów.

Kolekcja zawiera tylko dokumenty. Nie może on bezpośrednio zawierać pól z wartościami ani innych kolekcji. Wyjaśnienie, jak tworzyć strukturę bardziej złożonych danych w narzędziu Cloud Firestore, znajdziesz w artykule Dane hierarchiczne.

Nazwy dokumentów w kolekcji są unikalne. Możesz podać własne klucze, takie jak identyfikatory użytkowników, lub pozwolić Cloud Firestore automatycznie tworzyć losowe identyfikatory.

Nie musisz tworzyć ani usuwać kolekcji. Po utworzeniu pierwszego dokumentu w kolekcji kolekcja istnieje. Jeśli usuniesz wszystkie dokumenty z kolekcji, kolekcja przestanie istnieć.

Odniesienia

Każdy dokument w Cloud Firestore jest jednoznacznie identyfikowany przez swoją lokalizację w bazie danych. Poprzedni przykład dotyczył dokumentu alovelace w kolekcji users. Aby odwoływać się do tej lokalizacji w kodzie, możesz utworzyć odniesienie do niej.

import { doc } from "firebase/firestore";

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

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

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

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

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

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

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

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

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

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

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

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

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

func createDocReference(client *firestore.Client) {

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

	_ = alovelaceRef
}
retrieve_data_reference_document.go

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

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

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

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

Odwołania to lekkie obiekty, które wskazują po prostu lokalizację w bazie danych. Możesz utworzyć odwołanie niezależnie od tego, czy istnieją w nim dane. Utworzenie odwołania nie powoduje żadnych operacji sieciowych.

Możesz też tworzyć odwołania do kolekcji:

import { collection } from "firebase/firestore";

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

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

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

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

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

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

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

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

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

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

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

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

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

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

	_ = usersRef
}
retrieve_data_reference_collection.go

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

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

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

collection_ref = firestore.col "users"
data_model.rb

Dla wygody możesz też tworzyć odwołania, podając ścieżkę do dokumentu lub kolekcji jako ciąg znaków, z elementami ścieżki rozdzielonymi znakiem ukośnika (/). Na przykład, aby utworzyć odwołanie do dokumentu alovelace:

import { doc } from "firebase/firestore"; 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Dane hierarchiczne

Aby zrozumieć, jak działają hierarchiczne struktury danych w Cloud Firestore, zastanów się nad przykładową aplikacją do czatu z wiadomościami i pokojem czatu.

Możesz utworzyć kolekcję o nazwie rooms, aby przechowywać różne pokoje czatu:

• collections_bookmark pokoju

  • class roomA

    name : "my chat room"
    

  • class pokój B

    ...
    

Teraz, gdy masz pokoje czatu, zdecyduj, jak przechowywać wiadomości. Być może nie chcesz zapisywać ich w dokumencie pokoju czatu. Dokumenty w usłudze Cloud Firestore powinny być nieduże, a pokój czatu może zawierać wiele wiadomości. W dokumencie w pokoju czatu możesz jednak tworzyć dodatkowe kolekcje jako kolekcje podrzędne.

Podkolekcji

W tym przypadku najlepszym sposobem na przechowywanie wiadomości jest użycie podkolekcji. Kolekcja podrzędna to kolekcja powiązana z określonym dokumentem.

Możesz utworzyć podkolekcją o nazwie messages dla każdego dokumentu sali w kolekcji rooms:

• collections_bookmark sal

  • class roomA

    name : "my chat room"
    

    • collections_bookmark wiadomości

      • class wiadomość1

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

      • class message2

        ...
        

  • class sala B

    ...
    

W tym przykładzie utworzysz odwołanie do wiadomości w podkolekcji za pomocą tego kodu:

import { doc } from "firebase/firestore"; 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Zwróć uwagę na naprzemienny wzór kolekcji i dokumentów. Twoje kolekcje i dokumenty muszą zawsze być zgodne z tym wzorcem. Nie możesz odwoływać się do kolekcji w kolekcji ani do dokumentu w dokumencie.

Podzbiory umożliwiają uporządkowanie danych w hierarchii, co ułatwia do nich dostęp. Aby uzyskać wszystkie wiadomości w kolekcji roomA, możesz utworzyć odwołanie do podkolekcji messages i działać z nim tak samo jak z dowolnym innym odwołaniem do kolekcji.

Dokumenty w kolekcjach podrzędnych mogą też zawierać podkolekcje, co pozwala na dalsze zagnieżdżanie danych. Dane możesz zagnieżdżać do 100 poziomów.