Cloud Firestore Veri modeli

Cloud Firestore, NoSQL tabanlı, belge odaklı 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 doküman bir dizi anahtar/değer çifti 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 depolanmalıdır. Dokümanlar, alt koleksiyonlar ve iç içe yerleştirilmiş nesneler içerebilir. Bunların her ikisi de dize gibi temel alanlar veya liste gibi karmaşık nesneler içerebilir.

Koleksiyonlar ve dokümanlar Cloud Firestore içinde dolaylı olarak oluşturulur. Verileri bir koleksiyondaki dokümana atamanız yeterlidir. Koleksiyon veya doküman yoksa Cloud Firestore bunları oluşturur.

Dokümanlar

Cloud Firestore'da depolama birimi dokümandır. Belge, değerlerle eşlenen alanlar içeren hafif bir kayıttır. Her doküman bir adla tanımlanır.

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 denir. Örneğin, yukarıdaki örnekte yer alan 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, temelde aynıdırlar. Bazı farklılıklar vardır (örneğin, dokümanlar ek veri türlerini destekler ve doküman boyutu sınırına tabidir) ancak genel olarak dokümanları basit JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Belgeler, belgeler için kapsayıcı 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 aturing

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

Cloud Firestore şemasızdır. Bu nedenle, her dokümana hangi alanları ekleyeceğiniz ve bu alanlarda hangi veri türlerini depolayacağınız konusunda tamamen özgürsünüz. Aynı koleksiyondaki belgelerin tümü farklı alanlar içerebilir veya bu alanlarda farklı veri türleri depolayabilir. Ancak dokümanları daha kolay sorgulayabilmek için birden fazla dokümanda aynı alanları ve veri türlerini kullanmak iyi bir fikirdir.

Koleksiyonlar yalnızca doküman içerir. Doğrudan değer içeren ham alanlar ve başka 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.)

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

Koleksiyon "oluşturmanız" veya "silmeniz" gerekmez. Koleksiyondaki ilk dokümanı oluşturduktan sonra koleksiyon oluşturulur. Bir koleksiyondaki tüm dokümanları silerseniz koleksiyon da silinir.

Referanslar

Cloud Firestore içindeki her doküman, veritabanındaki konumuyla benzersiz şekilde tanımlanır. Önceki örnekte, users koleksiyonundaki alovelace dokümanı gösterilmişti. Kodunuzda bu konuma başvurmak 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, veritabanınızdaki bir konumu işaret eden basit bir nesnedir. Veri olup olmamasından bağımsız olarak bir referans oluşturabilirsiniz. Referans oluşturmak herhangi bir ağ işlemi gerçekleştirmez.

Koleksiyonlara da referans 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ğlamak için 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

Cloud Firestore uygulamasında hiyerarşik veri yapılarının işleyiş şeklini anlamak için mesajlar ve sohbet odaları içeren örnek bir sohbet uygulamasını ele alalım.

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

• collections_bookmark oda

  • class odaA

    name : "my chat room"
    

  • class roomB

    ...
    

Sohbet odalarınız olduğuna göre mesajlarınızı nasıl saklayacağınıza karar verin. Bunları sohbet odasının dokümanında saklamak istemeyebilirsiniz. Cloud Firestore içindeki dokümanlar hafif 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 mesajları 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 mesaj

      • class message1

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

      • class message2

        ...
        

  • class roomB

    ...
    

Bu örnekte, aşağıdaki kodla 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 belgelerin dönüşümlü olarak sıralandığına dikkat 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ıyarak verilere erişimi kolaylaştırır. roomA içindeki tüm mesajları almak için messages alt koleksiyonuna bir koleksiyon referansı oluşturabilir ve diğer koleksiyon referanslarında olduğu gibi bu referansla 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.