Model danych Cloud Firestore

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

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

Wszystkie dokumenty muszą być przechowywane w kolekcjach. Dokumenty mogą zawierać podkolekcje i obiekty zagnieżdżone, które mogą zawierać pola podstawowe np. ciągi tekstowe 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 żadna z tych opcji lub dokument nie istnieje, Cloud Firestore go tworzy.

Dokumenty

W systemie Cloud Firestore jednostką pamięci masowej jest dokument. Dokument to prosty rekord zawierający pola, które są mapowane na wartości. Każdy dokument jest które są rozpoznawane pod nazwą.

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

• alovelace

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

.

Uwaga: Cloud Firestore obsługuje różne typy danych wartości: boolean, number, string, geo point, binarny obiekt blob i sygnatura czasowa. Możesz też użyć tablicami lub obiektami zagnieżdżonymi, nazywanymi mapami, do porządkowania danych w dokumencie.

Złożone, zagnieżdżone obiekty w dokumencie są nazywane mapami. Możesz na przykład: utwórz strukturę nazwy użytkownika z powyższego przykładu za pomocą mapy w następujący sposób:

• alovelace

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

Możesz zauważyć, że dokumenty wyglądają podobnie do JSON. W zasadzie tak właśnie są. Istnieją pewne różnice (np. dokumenty obsługują dodatkowe typy danych mogą nie przekraczać 1 MB), ale generalnie dokumenty można traktować jako lekkie rekordy JSON.

Kolekcje

Dokumenty znajdują się w kolekcjach, które są po prostu kontenerami na dokumenty. Dla: możesz mieć np. kolekcję users zawierającą różnych użytkowników, z których każdy reprezentowane przez dokument:

•  użytkowników

  • alovelace

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

  • Zjazd

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

Funkcja Cloud Firestore jest nieschematyczna, więc masz pełną swobodę umieszczonych w każdym dokumencie oraz typy danych w nich przechowywanych. Dokumenty w tej samej kolekcji mogą zawierać różne pola lub przechowywać różne typy danych w tych polach. Warto jednak użyć atrybutu tych samych pól i typów danych w wielu dokumentach, dzięki czemu możesz wykonywać zapytania dokumenty.

Kolekcja zawiera dokumenty i nic więcej. Nie może zawierać bezpośrednio nieprzetworzonych danych pola z wartościami i nie może zawierać innych kolekcji. (Patrz sekcja Hierarchiczna dane wyjaśniające, w jaki sposób utworzyć bardziej złożoną strukturę. w tabeli Cloud Firestore.)

Nazwy dokumentów w kolekcji są unikalne. Możesz podać własne takich jak identyfikatory użytkowników, lub pozwolić aplikacji Cloud Firestore na tworzenie losowych identyfikatorów automatycznie.

Nie musisz tworzyć lub „usuń” kolekcji. Po utworzeniu pierwszego dokument w kolekcji, zbiór istnieje. Jeśli usuniesz wszystkie dokumentów w kolekcji, już nie istnieje.

Odniesienia

Każdy dokument w domenie Cloud Firestore jest jednoznacznie identyfikowany na podstawie lokalizacji w bazie danych. W poprzednim przykładzie pokazaliśmy dokument alovelace w obrębie kolekcję users. Aby odwołać się do tej lokalizacji w kodzie, możesz utworzyć odwołania do nich.

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

import { doc } from "firebase/firestore";

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

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

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

Swift

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Objective-C

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Java

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

Python

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

Go

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

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Unity

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

C#

C#

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Ruby

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

Plik referencyjny to nieduży obiekt, który wskazuje tylko w bazie danych. Możesz utworzyć odwołanie niezależnie od tego, czy dane w nim są, czy nie. utworzenie odwołania nie wykonuje żadnych operacji sieciowych.

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

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

import { collection } from "firebase/firestore";

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

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

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

Swift

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Objective-C

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Java

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

Python

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

Go

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

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

	_ = usersRef
}
retrieve_data_reference_collection.go

PHP

PHP

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Unity

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

C#

C#

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Ruby

collection_ref = firestore.col "users"
data_model.rb

Uwaga: referencje do kolekcji i odwołania do dokumentów to 2 różne typy. i wykonywać różne operacje. Możesz na przykład: użyj odniesienia do kolekcji do wysyłania zapytań dotyczących dokumentów w tej kolekcji, mogą użyć odniesienia do dokumentu, aby odczytać lub napisać pojedynczy dokument.

Dla wygody możesz także tworzyć odwołania, podając ścieżkę do pliku dokument lub kolekcja w postaci ciągu znaków, z komponentami ścieżki rozdzielonymi znakiem przekierowania ukośnik (/). Aby na przykład utworzyć odwołanie do dokumentu alovelace:

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

import { doc } from "firebase/firestore"; 

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

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

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

Swift

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Objective-C

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

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("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

Go

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

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Unity

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

C#

C#

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Ruby

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

Dane hierarchiczne

Aby dowiedzieć się, jak działają hierarchiczne struktury danych w Cloud Firestore, rozważ zastosowanie przykładowej aplikacji do obsługi wiadomości i pokoi czatu.

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

• pokoju

  • sala A

    name : "my chat room"
    

  • sala B

    ...
    

Skoro masz już pokoje czatu, zdecyduj, jak chcesz przechowywać wiadomości. Możesz nie chcesz je zapisać w dokumencie pokoju czatu. Dokumenty w folderze Cloud Firestore a pokój czatu może zawierać wiele wiadomości. Dodatkowe kolekcje możesz jednak utworzyć w dokumencie w pokoju czatu. jako kolekcji podrzędnych.

Podkolekcje

W takim przypadku najlepszym sposobem przechowywania wiadomości jest użycie kolekcji podrzędnych. O kolekcja podrzędna jest zbiorem powiązanym z określonym dokumentem.

Uwaga: możesz wysyłać zapytania obejmujące ten sam identyfikator kolekcji za pomocą funkcji Zapytania dotyczące grup kolekcji.

Możesz utworzyć kolekcję podrzędną o nazwie messages dla każdego dokumentu w pokoju w Twoja kolekcja rooms:

• pokoju

  • sala A

    name : "my chat room"
    

    • wiadomości

      • wiadomość1

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

      • wiadomość2

        ...
        

  • sala B

    ...
    

W tym przykładzie możesz utworzyć odwołanie do wiadomości w kolekcji podrzędnej następującym kodem:

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

import { doc } from "firebase/firestore"; 

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

Web

Informacje więcej o modularnym Web API z możliwością potrząsania drzewami przejść z w interfejsie API z przestrzenią nazw.

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

Swift

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

Objective-C

Uwaga: ten produkt nie jest dostępny na urządzeniach docelowych watchOS i wycinków aplikacji.

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

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("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

Go

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

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Unity

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

C#

C#

Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.

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

Ruby

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

Zwróć uwagę na naprzemienne wzorce kolekcji i dokumentów. Twoje kolekcje a dokumenty muszą zawsze być zgodne z tym wzorcem. Nie możesz odwoływać się do kolekcji w kolekcji lub w dokumencie w dokumencie.

Kolekcje podrzędne pozwalają hierarchicznie porządkować dane, co ułatwia ich dostęp. Aby pobrać wszystkie wiadomości z usługi roomA, możesz utworzyć plik referencyjny kolekcji do kolekcji podrzędnej messages i korzystać z niej jak z każdej innej odniesienie do kolekcji.

Dokumenty w kolekcjach podrzędnych mogą też zawierać podkolekcje, dzięki czemu możesz: zagnieżdżać dane. Dane można zagnieżdżać do 100 poziomów.

Ostrzeżenie: usunięcie dokumentu nie powoduje usunięcia jego kolekcji podrzędnych.

Gdy usuniesz dokument, który zawiera podkolekcje, nie usunięto. Na przykład może istnieć dokument znajdujący się pod adresem coll/doc/subcoll/subdoc mimo że dokument coll/doc już nie istnieje. Jeśli chcesz usunąć dokumentów w kolekcjach podrzędnych podczas usuwania dokumentu nadrzędnego, musisz to zrobić ręcznie. jak w sekcji Usuń Kolekcje.