Mô hình dữ liệu trên Cloud Firestore

Cloud Firestore là một cơ sở dữ liệu NoSQL, hướng đến tài liệu. Không giống như cơ sở dữ liệu SQL, cơ sở dữ liệu NoSQL không có bảng hoặc hàng. Thay vào đó, bạn lưu trữ dữ liệu trong tài liệu, được sắp xếp thành bộ sưu tập.

Mỗi tài liệu chứa một tập hợp các cặp khoá-giá trị. Cloud Firestore được tối ưu hoá để lưu trữ các bộ sưu tập lớn gồm nhiều tài liệu nhỏ.

Tất cả tài liệu phải được lưu trữ trong các bộ sưu tập. Tài liệu có thể chứa các tập hợp con và các đối tượng lồng nhau, cả hai đều có thể bao gồm các trường gốc như chuỗi hoặc các đối tượng phức tạp như danh sách.

Các bộ sưu tập và tài liệu được tạo ngầm trong Cloud Firestore. Bạn chỉ cần chỉ định dữ liệu cho một tài liệu trong một tập hợp. Nếu bộ sưu tập hoặc tài liệu không tồn tại, Cloud Firestore sẽ tạo bộ sưu tập hoặc tài liệu đó.

Tài liệu

Trong Cloud Firestore, đơn vị lưu trữ là tài liệu. Tài liệu là một bản ghi nhẹ chứa các trường liên kết với các giá trị. Mỗi tài liệu được xác định bằng một tên.

Tài liệu đại diện cho một alovelace người dùng có thể có dạng như sau:

• alovelace

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

Lưu ý: Cloud Firestore hỗ trợ nhiều loại dữ liệu cho các giá trị: boolean, số, chuỗi, điểm địa lý, blob nhị phân và dấu thời gian. Bạn cũng có thể sử dụng các mảng hoặc đối tượng lồng nhau (gọi là bản đồ) để sắp xếp cấu trúc dữ liệu trong một tài liệu.

Các đối tượng phức tạp, lồng nhau trong một tài liệu được gọi là bản đồ. Ví dụ: bạn có thể cấu trúc tên người dùng trong ví dụ trên bằng một bản đồ, như sau:

• alovelace

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

Bạn có thể nhận thấy rằng các tài liệu trông rất giống JSON. Trên thực tế, về cơ bản là chúng. Có một số điểm khác biệt (ví dụ: tài liệu hỗ trợ các loại dữ liệu bổ sung và bị giới hạn về kích thước ở mức 1 MB), nhưng nhìn chung, bạn có thể coi tài liệu là bản ghi JSON nhẹ.

Bộ sưu tập

Tài liệu nằm trong các bộ sưu tập, đây chỉ là vùng chứa cho tài liệu. Ví dụ: bạn có thể có một bộ sưu tập users để chứa nhiều người dùng, mỗi người dùng được biểu thị bằng một tài liệu:

• người dùng

  • alovelace

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

  • aturing

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

Cloud Firestore không có giản đồ, vì vậy, bạn có toàn quyền quyết định những trường sẽ đưa vào mỗi tài liệu và loại dữ liệu sẽ lưu trữ trong các trường đó. Tất cả tài liệu trong cùng một tập hợp có thể chứa các trường khác nhau hoặc lưu trữ nhiều loại dữ liệu trong những trường đó. Tuy nhiên, bạn nên sử dụng cùng một trường và loại dữ liệu trên nhiều tài liệu để có thể truy vấn các tài liệu dễ dàng hơn.

Bộ sưu tập chỉ chứa tài liệu và không có nội dung nào khác. Tập hợp này không được trực tiếp chứa các trường thô có giá trị và không được chứa các tập hợp khác. (Xem phần Dữ liệu phân cấp để biết nội dung giải thích về cách tạo cấu trúc dữ liệu phức tạp hơn trong Cloud Firestore.)

Tên của các tài liệu trong một bộ sưu tập phải là duy nhất. Bạn có thể cung cấp khoá của riêng mình, chẳng hạn như mã nhận dạng người dùng, hoặc bạn có thể để Cloud Firestore tự động tạo mã nhận dạng ngẫu nhiên cho bạn.

Bạn không cần phải "tạo" hoặc "xoá" bộ sưu tập. Sau khi bạn tạo tài liệu đầu tiên trong bộ sưu tập, bộ sưu tập đó sẽ tồn tại. Nếu bạn xoá tất cả tài liệu trong một bộ sưu tập, bộ sưu tập đó sẽ không còn tồn tại.

Tài liệu tham khảo

Mỗi tài liệu trong Cloud Firestore được xác định duy nhất theo vị trí của tài liệu đó trong cơ sở dữ liệu. Ví dụ trước đã cho thấy một tài liệu alovelace trong bộ sưu tập users. Để tham chiếu đến vị trí này trong mã, bạn có thể tạo một tham chiếu đến vị trí đó.

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

import { doc } from "firebase/firestore";

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

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

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

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và App Clip.

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

Objective-C

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và 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

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

Tiến hành

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

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Unity

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

C#

C#

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Ruby

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

Tham chiếu là một đối tượng nhẹ chỉ trỏ đến một vị trí trong cơ sở dữ liệu. Bạn có thể tạo tệp đối chiếu cho dù có dữ liệu hay không, đồng thời việc tạo tệp đối chiếu sẽ không thực hiện bất kỳ thao tác nào trên mạng.

Bạn cũng có thể tạo tham chiếu đến bộ sưu tập:

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

import { collection } from "firebase/firestore";

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

Web

Tìm hiểu thêm về API Web mô-đun có thể thay đổi kiểu cây và nâng cấp từ API không gian tên.

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

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và App Clip.

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

Objective-C

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và 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

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

Tiến hành

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

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

	_ = usersRef
}
retrieve_data_reference_collection.go

PHP

PHP

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Unity

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

C#

C#

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Ruby

collection_ref = firestore.col "users"
data_model.rb

Lưu ý: Tham chiếu tập hợp và tham chiếu tài liệu là hai loại tham chiếu khác nhau và cho phép bạn thực hiện các thao tác khác nhau. Ví dụ: bạn có thể sử dụng tệp đối chiếu tập hợp để truy vấn các tài liệu trong tập hợp và bạn có thể sử dụng tệp đối chiếu tài liệu để đọc hoặc ghi một tài liệu riêng lẻ.

Để thuận tiện, bạn cũng có thể tạo tệp đối chiếu bằng cách chỉ định đường dẫn đến tài liệu hoặc tập hợp dưới dạng chuỗi, với các thành phần đường dẫn được phân tách bằng dấu gạch chéo lên (/). Ví dụ: để tạo tham chiếu đến tài liệu alovelace:

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

import { doc } from "firebase/firestore"; 

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

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

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

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và App Clip.

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

Objective-C

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và 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

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

Tiến hành

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

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Unity

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

C#

C#

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

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

Ruby

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

Dữ liệu phân cấp

Để hiểu cách hoạt động của cấu trúc dữ liệu phân cấp trong Cloud Firestore, hãy xem xét một ứng dụng trò chuyện mẫu có tin nhắn và phòng trò chuyện.

Bạn có thể tạo một bộ sưu tập có tên là rooms để lưu trữ nhiều phòng trò chuyện:

• phòng

  • roomA

    name : "my chat room"
    

  • roomB

    ...
    

Vì bạn đã có phòng trò chuyện, hãy quyết định cách lưu trữ tin nhắn. Bạn có thể không muốn lưu trữ các tệp đó trong tài liệu của phòng trò chuyện. Các tài liệu trong Cloud Firestore phải có kích thước nhỏ và phòng trò chuyện có thể chứa một lượng lớn tin nhắn. Tuy nhiên, bạn có thể tạo thêm các bộ sưu tập trong tài liệu của phòng trò chuyện, dưới dạng bộ sưu tập phụ.

Bộ sưu tập phụ

Cách tốt nhất để lưu trữ thư trong trường hợp này là sử dụng các bộ sưu tập con. Một tập hợp con là một tập hợp được liên kết với một tài liệu cụ thể.

Lưu ý: Bạn có thể truy vấn trên nhiều tập hợp con với cùng một mã bộ sưu tập bằng cách sử dụng Truy vấn nhóm bộ sưu tập.

Bạn có thể tạo một bộ sưu tập con có tên messages cho mọi tài liệu phòng trong bộ sưu tập rooms:

• phòng

  • phòngA

    name : "my chat room"
    

    • thông báo

      • thông báo 1

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

      • message2

        ...
        

  • roomB

    ...
    

Trong ví dụ này, bạn sẽ tạo một tệp tham chiếu đến một thông báo trong tập hợp con bằng mã sau:

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

import { doc } from "firebase/firestore"; 

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

Web

Tìm hiểu thêm về API Web mô-đun có thể loại bỏ cây và nâng cấp từ API có không gian tên.

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

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và App Clip.

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

Objective-C

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu watchOS và 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

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

Tiến hành

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

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng 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#

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng 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

Lưu ý đến mẫu luân phiên của các bộ sưu tập và tài liệu. Bộ sưu tập và tài liệu của bạn phải luôn tuân theo mẫu này. Bạn không thể tham chiếu một tập hợp trong một tập hợp hoặc một tài liệu trong một tài liệu.

Bộ sưu tập phụ cho phép bạn sắp xếp dữ liệu theo phân cấp, giúp dễ dàng truy cập dữ liệu hơn. Để nhận tất cả thông báo trong roomA, bạn có thể tạo một tham chiếu đến bộ sưu tập con messages và tương tác với bộ sưu tập đó như cách bạn thực hiện với bất kỳ tham chiếu bộ sưu tập nào khác.

Tài liệu trong các tập hợp con cũng có thể chứa các tập hợp con, cho phép bạn lồng thêm dữ liệu. Bạn có thể lồng dữ liệu đến tối đa 100 cấp độ.

Cảnh báo: Thao tác xoá một tài liệu sẽ không xoá các bộ sưu tập con của tài liệu đó!

Khi bạn xoá một tài liệu có bộ sưu tập con, các bộ sưu tập con đó sẽ không bị xoá. Ví dụ: có thể có một tài liệu nằm ở coll/doc/subcoll/subdoc mặc dù tài liệu coll/doc không còn tồn tại. Nếu muốn xoá tài liệu trong các bộ sưu tập con khi xoá tài liệu mẹ, bạn phải xoá theo cách thủ công, như trong phần Xoá bộ sưu tập.