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:

• alovelace

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

Not: Cloud Firestore, değerler için çeşitli veri türlerini destekler: boole, sayı, dize, coğrafi nokta, ikili blob ve zaman damgası. Ayrıca, bir dokümandaki verileri yapılandırmak için dizileri veya harita adı verilen iç içe yerleştirilmiş nesneleri de kullanabilirsiniz.

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:

• 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:

• kullanıcı

  • alovelace

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

  • 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.

Web

import { doc } from "firebase/firestore";

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

Web

Ağaç yapısı oluşturulabilen modüler Web API'si ve ad alanı içeren API'ye göre avantajları hakkında daha fazla bilgi edinin.

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

Swift

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Objective-C

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Kotlin

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

Java

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

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

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Unity

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

C#

C#

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Ruby

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:

Web

import { collection } from "firebase/firestore";

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

Web

Ağaç yapısı oluşturulabilen modüler Web API'si ve ad alanı içeren API'ye göre avantajları hakkında daha fazla bilgi edinin.

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

Swift

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Objective-C

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];
ViewController.m

Kotlin

val usersCollectionRef = db.collection("users")
DocSnippets.kt

Java

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

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

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Unity

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

C#

C#

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Ruby

collection_ref = firestore.col "users"
data_model.rb

Not: Koleksiyon referansları ve doküman referansları, iki farklı referans türüdür ve farklı işlemler yapmanıza olanak tanır. Örneğin, koleksiyondaki dokümanları sorgulamak için koleksiyon referansı, tek bir dokümanı okumak veya yazmak için ise doküman referansı kullanabilirsiniz.

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:

Web

import { doc } from "firebase/firestore"; 

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

Web

Ağaç yapısı oluşturulabilen modüler Web API'si ve ad alanı içeren API'ye göre avantajları hakkında daha fazla bilgi edinin.

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

Swift

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Objective-C

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Kotlin

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

Java

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

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

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Unity

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

C#

C#

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Ruby

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:

• oda

  • odaA

    name : "my chat room"
    

  • 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.

Not: Aynı koleksiyon kimliğine sahip alt koleksiyonlarda sorgu yapmak için koleksiyon grubu sorgularını kullanabilirsiniz.

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

• oda

  • odaA

    name : "my chat room"
    

    • mesajlar

      • message1

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

      • message2

        ...
        

  • odaB

    ...
    

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

Web

import { doc } from "firebase/firestore"; 

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

Web

Ağaç yapısı oluşturulabilen modüler Web API'si ve ad alanı içeren API'ye göre avantajları hakkında daha fazla bilgi edinin.

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

Swift

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

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

Objective-C

Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.

FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];
ViewController.m

Kotlin

val messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
DocSnippets.kt

Java

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

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

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Unity

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

C#

C#

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore İstemci Kitaplıkları başlıklı makaleyi inceleyin.

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

Ruby

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.

Uyarı: Bir dokümanın silinmesi, alt koleksiyonlarının silinmesine neden olmaz.

Alt koleksiyonları olan bir dokümanı sildiğinizde bu alt koleksiyonlar silinmez. Örneğin, coll/doc dokümanı artık mevcut olmasa bile coll/doc/subcoll/subdoc konumunda bir doküman olabilir. Bir üst dokümanı silerken alt koleksiyonlardaki dokümanları da silmek istiyorsanız Koleksiyonları Silme bölümünde gösterildiği gibi bunu manuel olarak yapmanız gerekir.