Cloud Firestore Veri modeli

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

Her belge, bir anahtar/değer çifti grubu içerir. Cloud Firestore, küçük dokümanlardan oluşan büyük koleksiyonları depolamak için optimize edilmiştir.

Tüm dokümanlar koleksiyonlarda saklanmalıdır. Dokümanlar, hem dizeler gibi temel alanları hem de listeler gibi karmaşık nesneleri içerebilen alt koleksiyonlar ve iç içe yerleştirilmiş nesneler içerebilir.

Koleksiyonlar ve dokümanlar Cloud Firestore içinde örtülü olarak oluşturulur. Verileri bir koleksiyondaki dokümana atamanız yeterlidir. Koleksiyon veya doküman 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 belge bir adla tanımlanır.

Bir kullanıcıyı temsil eden bir doküman alovelace şu şekilde 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 örnekteki 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. Aslında bu iki kavram temelde aynıdır. Bazı farklılıklar (ör. dokümanlar ek veri türlerini destekler ve boyutları 1 MB ile sınırlıdır) olsa da genel olarak dokümanları hafif JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Dokümanlar, dokümanların bulunduğu kapsayıcılar olan koleksiyonlarda yer alır. Örneğin, çeşitli kullanıcılarınızı içeren bir users koleksiyonunuz olabilir. Bu koleksiyondaki her kullanıcı bir belgeyle temsil edilir:

• collections_bookmark kullanıcı

  • class alovelace

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

  • class aturing

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

Cloud Firestore şemasızdır. Bu nedenle, her belgeye hangi alanları yerleştireceğiniz ve bu alanlarda hangi veri türlerini saklayacağınız konusunda tamamen özgürsünüz. Aynı koleksiyondaki belgeler farklı alanlar içerebilir veya bu alanlarda farklı türlerde veriler depolayabilir. Ancak belgeleri daha kolay sorgulayabilmek için birden fazla belgede aynı alanları ve veri türlerini kullanmanız önerilir.

Koleksiyonlar yalnızca belge içerir. Doğrudan değer içeren ham alanlar ve diğer koleksiyonlar içeremez. (Cloud Firestore içinde daha karmaşık verilerin nasıl yapılandırılacağıyla ilgili açıklama için Hiyerarşik Veriler bölümüne bakın.)

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

Koleksiyon "oluşturmanız" veya "silmeniz" gerekmez. Bir koleksiyonda ilk belgeyi oluşturduktan sonra koleksiyon var olur. Bir koleksiyondaki tüm belgeleri silerseniz koleksiyon artık mevcut olmaz.

Referanslar

Cloud Firestore içindeki her doküman, veritabanındaki konumuyla benzersiz şekilde tanımlanır. Önceki örnekte, koleksiyon users içindeki bir doküman alovelace gösteriliyordu. Kodunuzda bu konuma başvurmak için konuma 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 konumu işaret eden basit bir nesnedir. Veri olup olmadığına bakılmaksızın referans oluşturabilirsiniz ve referans oluşturma işlemi herhangi bir ağ işlemi gerçekleştirmez.

Ayrıca koleksiyonlara referans da 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 dize olarak belirterek de referans oluşturabilirsiniz. Yol bileşenleri 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 bir örnek sohbet uygulamasını ele alalım.

Farklı sohbet odalarını saklamak için rooms adlı bir koleksiyon oluşturabilirsiniz:

• collections_bookmark oda

  • class odaA

    name : "my chat room"
    

  • class odaB

    ...
    

Artık sohbet odalarınız olduğuna göre, mesajlarınızı nasıl saklayacağınıza karar verin. Bu bilgileri sohbet odasının dokümanında saklamak istemeyebilirsiniz. Cloud Firestore içindeki dokümanlar hafif olmalıdır ve bir sohbet odası çok sayıda mesaj içerebilir. Ancak sohbet odanızın dokümanında alt koleksiyon 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şkili bir koleksiyondur.

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

• collections_bookmark oda

  • class odaA

    name : "my chat room"
    

    • collections_bookmark mesajlar

      • class message1

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

      • class message2

        ...
        

  • class odaB

    ...
    

Bu örnekte, aşağıdaki kodu kullanarak alt koleksiyondaki bir iletiye 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 ve dokümanların dönüşümlü olarak sıralandığını fark edin. Koleksiyonlarınız ve dokümanlarınız her zaman bu kalıba uymalıdır. Bir koleksiyondaki koleksiyona veya bir dokümandaki dokümana referans veremezsiniz.

Alt koleksiyonlar, verileri hiyerarşik olarak yapılandırmanıza olanak tanır. Böylece verilere erişmek kolaylaşır. roomA içindeki tüm mesajları almak için messages alt koleksiyonuna bir koleksiyon referansı oluşturabilir ve bu referansla diğer koleksiyon referanslarıyla etkileşimde bulunduğunuz gibi etkileşimde bulunabilirsiniz.

Alt koleksiyonlardaki dokümanlar da alt koleksiyonlar içerebilir. Bu sayede verileri daha fazla iç içe yerleştirebilirsiniz. Verileri 100 düzeye kadar iç içe yerleştirebilirsiniz.