Cloud Firestore Veri modeli

Cloud Firestore, NoSQL, belge tabanlı bir veritabanıdır. SQL veritabanlarından farklı olarak tablo veya satır yoktur. Bunun yerine, verilerinizi sizin için saklanmış olan dokümanlarda koleksiyonlar halinde düzenlenir.

Her belge 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. Bu nesneler, dize gibi basit alanlar veya liste gibi karmaşık nesneler içerebilir.

Koleksiyonlar ve dokümanlar Cloud Firestore içinde dolaylı olarak oluşturulur. Bir koleksiyondaki dokümana veri atamanız yeterlidir. Koleksiyon veya doküman mevcut değilse Cloud Firestore bunları oluşturur.

Dokümanlar

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

alovelace kullanıcısını temsil eden bir doküman şöyle 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ının adını bir harita ile ş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 temel olarak öyledir. Bazı farklılıklar vardır (örneğin, dokümanlar ek veri türlerini destekler ve dosya boyutu 1 MB ile sınırlıdır), ancak genel olarak dokümanları basit JSON kayıtları.

Koleksiyonlar

Dokümanlar, dokümanlar için kapsayıcı olan koleksiyonlarda bulunur. Örneğin, her biri bir dokümanla 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 hangi öğelerin alanları ve bu alanlarda hangi veri türlerini depoladığınızı gösterir. Aynı koleksiyondaki belgelerin tümü farklı alanlar içerebilir veya bu alanlarda farklı veri türleri depolayabilir. Ancak bunun için birden çok belgede aynı alanları ve veri türlerini kapsar. Böylece, daha kolay hale getirir.

Koleksiyonlar yalnızca doküman içerir. Doğrudan değer içeren ham alanlar ve başka koleksiyonlar içeremez. (Bkz. Hiyerarşik Veriler'i tıklayın. verileri Cloud Firestore içindedir.)

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. İlk dosyayı oluşturduktan sonra doküman bir koleksiyonda bulunuyorsa koleksiyon var demektir. Bir koleksiyondaki tüm dokümanları silerseniz koleksiyon artık mevcut olmaz.

Referanslar

Cloud Firestore hizmetindeki her doküman, konumuyla benzersiz şekilde tanımlanır söz konusu olabilir. Önceki örnekte, içinde alovelace başlıklı bir doküman gösterildi users koleksiyonu. Kodunuzda bu konuma referans vermek için, referansta bulunabilir.

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 projenizdeki bir konuma işaret eden hafif bir nesnedir Burada veri olup olmamasına bakılmaksızın bir referans oluşturabilir ve referans oluşturulması 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 belgenin veya koleksiyonun yolunu, yol bileşenleri eğik çizgiyle (/) ayrılmış bir dize olarak belirterek de referans oluşturabilirsiniz. Örneğin, alovelace belgesine 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'te nasıl çalıştığını anlamak için mesajlar ve sohbet odaları içeren örnek bir sohbet uygulamasını düşünün.

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

• collections_bookmark oda

  • class oda A

    name : "my chat room"
    

  • class odaB

    ...
    

Sohbet odalarınız olduğuna göre mesajlarınızı nasıl depolayacağınıza karar verin. B bunları sohbet odasının dokümanında depolamak istiyorsunuz. Cloud Firestore içindeki dokümanlar hafif olmalı ve sohbet odası çok sayıda mesaj içerebilir. Ancak, sohbet odanızın dokümanında ek koleksiyonlar oluşturabilirsiniz. bunu her zaman alt koleksiyonlar halinde yapabilirsiniz.

Alt koleksiyonlar

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

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

• collections_bookmark oda

  • class oda A

    name : "my chat room"
    

    • collections_bookmark mesajlar

      • class. mesaj1

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

      • class message2

        ...
        

  • class oda B

    ...
    

Bu örnekte, aşağıdaki kodla 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ın ve dokümanların alternatif kalıbına dikkat edin. Koleksiyonlarınız ve belgelerinizin adı her zaman bu kalıbı izlemelidir. Bir koleksiyona referans veremezsiniz kolayca erişilebilir hale getirebilirsiniz.

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 için koleksiyon referansı oluşturabilirsiniz ve diğer alt koleksiyona benzer şekilde bu alt koleksiyonla messages koleksiyonu referansını gösterir.

Alt koleksiyonlardaki dokümanlar da alt koleksiyon içerebilir. Bu sayede verileri daha da iç içe yerleştirebilirsiniz. Verileri 100 seviye derine kadar iç içe yerleştirebilirsiniz.