Cloud Firestore Veri modeli

Cloud Firestore, NoSQL, belge tabanlı bir veritabanıdır. SQL veritabanının aksine, tablo veya satır bulunmaz. Bunun yerine, verileri koleksiyonlar halinde düzenlenen dokümanlarda depolarsınız.

Her doküman bir dizi anahtar/değer çifti içerir. Cloud Firestore, büyük boyutlu küçük doküman koleksiyonlarını depolamak için optimize edilmiştir.

Tüm dokümanlar koleksiyonlarda depolanmalıdır. Belgeler, alt koleksiyonlar ve iç içe yerleştirilmiş nesneler içerebilir. Bunların her ikisi de dizeler gibi temel alanları veya listeler gibi karmaşık nesneleri içerebilir.

Koleksiyonlar ve belgeler, Cloud Firestore'da dolaylı olarak oluşturulur. Bir koleksiyondaki dokümana veri atamanız yeterlidir. Koleksiyon veya belge yoksa Cloud Firestore tarafından oluşturulur.

Dokümanlar

Cloud Firestore'da, depolama birimi belgedir. Belge, değerlerle eşlenen alanlar içeren basit bir kayıttır. Her belgenin bir adı bulunur.

alovelace kullanıcısını temsil eden bir doküman aşağıdaki gibi görünebilir:

• class alovelace

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

Bir dokümandaki karmaşık, iç içe yerleştirilmiş nesnelere harita adı verilir. Örneğin, yukarıdaki örnekte verilen kullanıcı adını bir haritayla şu şekilde yapılandırabilirsiniz:

• class alovelace

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

Dokümanların JSON'a çok benzediğini fark edebilirsiniz. Öyle diyebiliriz. Bazı farklılıklar vardır (örneğin, dokümanlar ek veri türlerini destekler ve boyut olarak 1 MB ile sınırlıdır) ancak genel olarak dokümanları basit JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Dokümanlar, yalnızca doküman kapsayıcıları olan koleksiyonlarda bulunur. Örneğin, her biri bir belgeyle temsil edilen, çeşitli kullanıcılarınızı içeren bir users koleksiyonunuz olabilir:

• collections_bookmark kullanıcı

  • class alovelace

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

  • class turu

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

Cloud Firestore şemasız olduğundan her belgeye yerleştireceğiniz alanlar ve bu alanlarda hangi veri türlerini depolayacağınız konusunda tam özgürlük vardır. Aynı koleksiyondaki belgelerin tümü farklı alanlar içerebilir veya bu alanlarda farklı veri türleri depolayabilir. Ancak, belgeleri daha kolay sorgulayabilmeniz için birden fazla belgede aynı alanları ve veri türlerini kullanmak iyi bir fikirdir.

Koleksiyonlar yalnızca belgeler içerir ancak başka hiçbir öğe içermez. Değer içeren ham alanları doğrudan içeremez ve başka koleksiyonlar içeremez. (Cloud Firestore'da daha karmaşık verilerin nasıl yapılandırılacağıyla ilgili açıklama için Hiyerarşik Veriler'e bakın.)

Bir koleksiyondaki dokümanların adları benzersizdir. Kullanıcı kimlikleri gibi kendi anahtarlarınızı sağlayabilir veya Cloud Firestore'un sizin için otomatik olarak rastgele kimlikler oluşturmasına izin verebilirsiniz.

Koleksiyonları "oluşturmanız" veya "silmeniz" gerekmez. Koleksiyondaki ilk belgeyi oluşturduğunuzda koleksiyon oluşturulur. Bir koleksiyondaki tüm dokümanları silerseniz koleksiyon artık mevcut olmaz.

Referanslar

Cloud Firestore'daki her belge, veritabanındaki konumuyla benzersiz şekilde tanımlanır. Önceki örnekte, users koleksiyonundaki alovelace adlı bir doküman gösteriliyordu. Kodunuzda bu konuma referans vermek için bir referans oluşturabilirsiniz.

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

Referans, yalnızca veritabanınızdaki bir konuma işaret eden hafif bir nesnedir. Burada veri olup olmamasına bakılmaksızın bir referans oluşturabilirsiniz. Referans oluşturmak, herhangi bir ağ işlemi gerçekleştirmez.

Ayrıca koleksiyonlar için referanslar oluşturabilirsiniz:

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

Kolaylık sağlaması açısından, bir dokümanın veya koleksiyonun yolunu bir dize olarak belirterek de referans oluşturabilirsiniz. Yol bileşenleri düz eğik çizgiyle (/) ayrılır. Örneğin, alovelace dokümanına referans oluşturmak için:

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

Hiyerarşik Veriler

Hiyerarşik veri yapılarının Cloud Firestore'da nasıl çalıştığını anlamak için mesajlar ve sohbet odaları içeren örnek bir sohbet uygulaması kullanmayı düşünün.

Farklı sohbet odalarını depolamak için rooms adında bir koleksiyon oluşturabilirsiniz:

• collections_bookmark oda

  • class oda A

    name : "my chat room"
    

  • class oda B

    ...
    

Artık sohbet odalarınız olduğuna göre mesajlarınızı nasıl depolayacağınıza karar verebilirsiniz. Bunları sohbet odasının dokümanında saklamak istemeyebilirsiniz. Cloud Firestore'daki belgeler basit olmalıdır ve bir sohbet odasında çok sayıda mesaj bulunabilir. Ancak sohbet odanızın dokümanında alt koleksiyonlar olarak ek koleksiyonlar oluşturabilirsiniz.

Alt koleksiyonlar

Bu senaryoda, iletileri depolamanın en iyi yolu alt koleksiyonlar kullanmaktır. Alt koleksiyon, belirli bir dokümanla ilişkilendirilmiş koleksiyonlardır.

rooms koleksiyonunuzdaki her oda dokümanı için messages adında bir alt koleksiyon oluşturabilirsiniz:

• collections_bookmark oda

  • class oda A

    name : "my chat room"
    

    • collections_bookmark mesaj

      • class mesaj1

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

      • class mesaj2

        ...
        

  • class oda B

    ...
    

Bu örnekte, aşağıdaki kodu kullanarak alt koleksiyondaki bir mesaja referans oluşturursunuz:

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

Koleksiyonların ve dokümanların alternatif kalıbına dikkat edin. Koleksiyonlarınız ve dokümanlarınız her zaman bu kalıbı izlemelidir. Koleksiyondaki bir koleksiyona veya dokümandaki bir dokümana referans veremezsiniz.

Alt koleksiyonlar, verileri hiyerarşik olarak yapılandırmanıza olanak tanıyarak verilere erişimi kolaylaştırır. roomA uygulamasındaki tüm mesajları almak üzere messages alt koleksiyona yönelik bir koleksiyon referansı oluşturabilir ve diğer koleksiyon referanslarında olduğu gibi bu alt koleksiyonla etkileşimde bulunabilirsiniz.

Alt koleksiyonlardaki belgeler, alt koleksiyonlar da içerebilir. Bu sayede verileri daha fazla iç içe yerleştirebilirsiniz. Verileri 100 düzey derine kadar iç içe yerleştirebilirsiniz.