Model data

Model data

Firestore adalah database NoSQL berorientasi dokumen. Tidak seperti database SQL, Cloud Firestore tidak memiliki tabel atau baris. Sebagai gantinya, data disimpan dalam berbagai dokumen, yang disusun menjadi koleksi.

Setiap dokumen berisi kumpulan key-value pair. Firestore adalah dioptimalkan untuk menyimpan koleksi besar dokumen kecil.

Semua dokumen harus disimpan dalam koleksi. Dokumen dapat berisi subkoleksi dan objek bertingkat. Sementara itu, subkoleksi dan objek bertingkat dapat mencakup kolom standar (misalnya, string) atau objek kompleks (misalnya, daftar).

Koleksi dan dokumen dibuat secara implisit di Firestore. Cukup tetapkan data ke dokumen dalam koleksi. Jika koleksi atau dokumen tidak ada, Firestore akan membuatnya.

Dokumen

Di Firestore, unit penyimpanan adalah dokumen. Dokumen adalah data ringan yang berisi kolom, yang dipetakan ke nilai. Setiap dokumen diidentifikasi dengan nama.

Dokumen yang mewakili pengguna alovelace mungkin terlihat seperti ini:

• alovelace

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

Catatan: Firestore mendukung berbagai jenis data untuk nilai: boolean, angka, string, titik geografis, blob biner, dan stempel waktu. Anda juga dapat menggunakan array atau objek bertingkat, yang disebut peta, untuk membuat struktur data dalam dokumen.

Objek kompleks dan bertingkat dalam dokumen disebut peta. Misalnya, Anda dapat membuat struktur nama pengguna dari contoh di atas dengan peta, seperti ini:

• alovelace

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

Seperti dapat dilihat, dokumen sangat mirip dengan JSON. Faktanya, keduanya memang sangat mirip. Ada beberapa perbedaan (misalnya, dokumen mendukung jenis data tambahan dan ukurannya terbatas hingga 1 MB). Namun secara umum, Anda dapat memperlakukan dokumen sebagai data JSON ringan.

Koleksi

Dokumen berada dalam koleksi, yang merupakan container-nya. Misalnya, Anda dapat memiliki koleksi users untuk menampung berbagai pengguna, yang masing-masing diwakili oleh dokumen:

• users

  • alovelace

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

  • aturing

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

Firestore tidak memiliki skema, sehingga Anda memiliki kebebasan penuh atas apa {i>field<i} yang Anda masukkan ke dalam setiap dokumen dan tipe data apa yang Anda simpan di {i>field<i} tersebut. Dokumen dalam koleksi yang sama dapat berisi kolom yang berbeda, atau menyimpan jenis data yang berbeda di kolom tersebut. Namun, sebaiknya gunakan kolom dan jenis data yang sama untuk beberapa dokumen, sehingga Anda dapat membuat kueri dokumen dengan lebih mudah.

Koleksi hanya berisi dokumen. Koleksi tidak dapat langsung berisi kolom mentah dengan nilai, dan tidak dapat berisi koleksi lainnya. (Lihat Hierarkis Data untuk penjelasan tentang cara membuat struktur yang lebih kompleks data di Firestore.)

Nama dokumen dalam koleksi bersifat unik. Anda dapat menyediakan kunci, seperti ID pengguna, atau Anda dapat mengizinkan Firestore membuat ID acak untuk Anda secara otomatis.

Anda tidak perlu "membuat" atau "menghapus" koleksi. Setelah dokumen pertama dalam koleksi dibuat, koleksi tersebut akan otomatis ada. Jika semua dokumen dalam koleksi dihapus, koleksi tersebut akan otomatis terhapus.

Referensi

Setiap dokumen di Firestore diidentifikasi secara unik berdasarkan lokasinya dalam {i>database<i}. Contoh sebelumnya menunjukkan dokumen alovelace dalam koleksi users. Untuk merujuk ke lokasi ini dalam kode Anda, buat referensi yang menunjuk kepadanya.

Web versi 9

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

import { doc } from "firebase/firestore";

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

Web versi 8

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

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

Swift

Catatan: Produk ini tidak tersedia di target watchOS dan App Clip.

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

Objective-C

Catatan: Produk ini tidak tersedia di target watchOS dan App Clip.

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

Kotlin+KTX
Android

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

Java
Android

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
(Asinkron)

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

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Unity

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

C#

C#

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Ruby

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

Referensi adalah objek ringan yang hanya menunjuk ke lokasi di database Anda. Anda dapat membuat referensi, terlepas dari ada atau tidaknya data di lokasi tersebut. Pembuatan referensi tidak akan memicu operasi jaringan.

Anda juga dapat membuat referensi ke koleksi:

Web versi 9

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

import { collection } from "firebase/firestore";

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

Web versi 8

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

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

Swift

Catatan: Produk ini tidak tersedia di target watchOS dan App Clip.

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

Objective-C

Catatan: Produk ini tidak tersedia di target watchOS dan 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

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
(Asinkron)

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

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Unity

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

C#

C#

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Ruby

collection_ref = firestore.col "users"
data_model.rb

Catatan: Referensi koleksi dan referensi dokumen adalah dua jenis referensi yang berbeda dan dapat digunakan untuk melakukan operasi yang berbeda. Misalnya, Anda dapat menggunakan referensi koleksi untuk membuat kueri dokumen dalam koleksi, dan menggunakan referensi dokumen untuk membaca atau menulis suatu dokumen tertentu.

Untuk memudahkan, Anda juga dapat membuat referensi dengan menentukan jalur ke dokumen atau koleksi sebagai string, dengan komponen jalur yang dipisahkan oleh garis miring (/). Misalnya, untuk membuat referensi ke dokumen alovelace:

Web versi 9

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

import { doc } from "firebase/firestore"; 

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

Web versi 8

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

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

Swift

Catatan: Produk ini tidak tersedia di target watchOS dan App Clip.

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

Objective-C

Catatan: Produk ini tidak tersedia di target watchOS dan 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

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
(Asinkron)

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

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Unity

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

C#

C#

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Ruby

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

Data Hierarkis

Untuk memahami cara kerja struktur data hierarkis di Firestore, pertimbangkan contoh aplikasi {i>chat<i} dengan pesan dan ruang {i>chat<i}.

Anda dapat membuat koleksi yang disebut rooms untuk menyimpan berbagai ruang chat:

• rooms

  • roomA

    name : "my chat room"
    

  • roomB

    ...
    

Setelah menambahkan ruang chat, tentukan cara menyimpan pesan. Sebaiknya jangan simpan pesan di dokumen ruang chat. Dokumen di Firestore harus ringan, dan ruang obrolan dapat berisi banyak pesan. Namun, Anda dapat membuat koleksi tambahan di dalam dokumen ruang chat sebagai subkoleksi.

Subkoleksi

Cara terbaik untuk menyimpan pesan dalam skenario ini adalah dengan menggunakan subkoleksi. Subkoleksi adalah koleksi yang terkait dengan dokumen tertentu.

Catatan: Anda dapat membuat kueri untuk berbagai subkoleksi dengan ID koleksi yang sama menggunakan Kueri Grup Koleksi.

Anda dapat membuat subkoleksi yang disebut messages untuk setiap dokumen ruang di koleksi rooms:

• rooms

  • roomA

    name : "my chat room"
    

    • messages

      • message1

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

      • message2

        ...
        

  • roomB

    ...
    

Dalam contoh ini, Anda akan membuat referensi ke pesan di subkoleksi dengan kode berikut:

Web versi 9

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

import { doc } from "firebase/firestore"; 

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

Web versi 8

Pelajari lebih lanjut Web API modular yang dapat di-tree-shaking dan upgrade dari API namespace.

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

Swift

Catatan: Produk ini tidak tersedia di target watchOS dan App Clip.

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

Objective-C

Catatan: Produk ini tidak tersedia di target watchOS dan 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

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
(Asinkron)

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

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Unity

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

C#

C#

Untuk melakukan autentikasi ke Firestore, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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

Ruby

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

Perhatikan pola bergantian antara koleksi dan dokumen. Koleksi dan dokumen Anda harus selalu mengikuti pola ini. Anda tidak dapat merujuk ke suatu koleksi dalam koleksi atau merujuk ke suatu dokumen dalam dokumen.

Dengan subkoleksi, Anda dapat menyusun data secara hierarkis, sehingga membuat data lebih mudah diakses. Untuk mendapatkan semua pesan di roomA, Anda dapat membuat referensi koleksi ke subkoleksi messages dan berinteraksi dengannya sama seperti saat menggunakan referensi koleksi lainnya.

Dokumen dalam subkoleksi dapat berisi subkoleksi juga, sehingga Anda dapat membuat data makin bertingkat. Anda dapat membuat data bertingkat hingga kedalaman 100 tingkat.

Peringatan: Subkoleksi tidak akan terhapus meski dokumennya dihapus.

Ketika Anda menghapus dokumen yang memiliki subkoleksi, subkoleksi tersebut tidak akan dihapus. Misalnya, mungkin ada dokumen yang terletak di coll/doc/subcoll/subdoc, meskipun dokumen coll/doc sudah tidak ada lagi. Jika ingin menghapus dokumen di subkoleksi saat menghapus dokumen induk, Anda harus melakukannya secara manual, seperti yang ditunjukkan di bagian Menghapus Koleksi.