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 verileri koleksiyonlar halinde düzenlenen dokümanlarda depolarsınız.

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. Koleksiyondaki bir dokümana veri atamanız yeterlidir. Koleksiyon veya belge 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:

• 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ı. Bir dokümandaki verileri yapılandırmak için dizileri veya haritalar olarak adlandırılan iç içe yerleştirilmiş nesneleri de kullanabilirsiniz.

Bir dokümanda bulunan karmaşık, iç içe yerleştirilmiş nesnelere harita denir. Örneğin, yukarıdaki örnekteki kullanıcının adını bir harita ile ş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 temel olarak öyledir. Bazı farklılıklar vardır (örneğin, dokümanlar ek veri türlerini destekler ve boyutları 1 MB ile sınırlıdır). Ancak genel olarak dokümanları hafif JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Dokümanlar, dokümanların bulunduğu koleksiyonlarda bulunur. Örneğin, her biri bir dokümanla temsil edilen çeşitli kullanıcılarınızı içeren bir users koleksiyonunuz olabilir:

• kullanıcı

  • alovelace

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

  • aturing

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

Cloud Firestore şemasız olduğundan her dokümana hangi alanları ve bu alanlarda hangi veri türlerini ekleyeceğiniz konusunda tam özgürlük sahibisiniz. 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'de daha karmaşık verilerin nasıl yapılandırılacağına dair 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'ün sizin için otomatik olarak rastgele kimlikler oluşturmasına izin verebilirsiniz.

Koleksiyon "oluşturmanız" veya "silmeniz" gerekmez. Koleksiyonda ilk dokümanı oluşturduktan sonra koleksiyon oluşturulur. Bir koleksiyondaki tüm dokümanları silerseniz koleksiyon artık mevcut olmaz.

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ştir. Kodunuzda bu konuma referans vermek için bu konuma referans oluşturabilirsiniz.

Web

import { doc } from "firebase/firestore";

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

Web

Ağda sarmalanabilir modüler Web API ve ad alanı içeren API'ye kıyasla 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 istemci 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 istemci 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, veritabanınızdaki bir konumu işaret eden hafif bir nesnedir. Veri bulunsa da bulunmasa da referans oluşturabilirsiniz. Referans oluşturmak herhangi bir ağ işlemi gerçekleştirmez.

Koleksiyonlara da referans oluşturabilirsiniz:

Web

import { collection } from "firebase/firestore";

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

Web

Ağda sarmalanabilir modüler Web API ve ad alanı içeren API'ye kıyasla 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 istemci 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 istemci 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ı, farklı referans türleridir 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ğ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:

Web

import { doc } from "firebase/firestore"; 

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

Web

Ağda sarmalanabilir modüler Web API ve ad alanı içeren API'ye kıyasla 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 istemci 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 istemci 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

Cloud Firestore'te hiyerarşik veri yapılarının işleyiş şeklini 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:

• oda

  • odaA

    name : "my chat room"
    

  • odaB

    ...
    

Sohbet odalarınız olduğuna göre mesajlarınızı nasıl depolayacağınıza karar verin. Bunları sohbet odasının dokümanında saklamak istemeyebilirsiniz. Cloud Firestore içindeki dokümanlar hafif olmalı ve sohbet odası çok sayıda mesaj içerebilir. Ancak sohbet odanızı belgenizde 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şkili bir koleksiyondur.

Not: Koleksiyon grubu sorgularını kullanarak aynı koleksiyon kimliğine sahip alt koleksiyonlarda sorgu yapabilirsiniz.

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

• oda

  • odaA

    name : "my chat room"
    

    • mesajlar

      • mesaj1

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

      • message2

        ...
        

  • odaB

    ...
    

Bu örnekte, aşağıdaki kodla 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ğda sarmalanabilir modüler Web API ve ad alanı içeren API'ye kıyasla 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 istemci 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 istemci 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 birbirini takip eden düzenine dikkat edin. Koleksiyonlarınız ve belgelerinizin her zaman bu kalıba uyması gerekir. Bir koleksiyondaki koleksiyona veya bir dokümanda dokümana referans veremezsiniz.

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

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

Uyarı: Bir doküman silindiğinde alt koleksiyonları silinmez.

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. Üst bir dokümanı silerken alt koleksiyonlardaki dokümanları da silmek istiyorsanız bunu Koleksiyonları silme bölümünde gösterildiği gibi manuel olarak yapmanız gerekir.