Cloud Firestore Veri modeli

Cloud Firestore, NoSQL, belge odaklı bir veritabanıdır. SQL veritabanının aksine tablo veya satır yoktur. Bunun yerine, verileri koleksiyonlar halinde düzenlenen belgelerde depolarsınız.

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

Tüm belgeler koleksiyonlarda saklanmalıdır. Belgeler alt koleksiyonlar ve iç içe geçmiş nesneler içerebilir; bunların her ikisi de dizeler gibi ilkel alanları veya listeler gibi karmaşık nesneleri içerebilir.

Koleksiyonlar ve belgeler Cloud Firestore'da örtülü olarak oluşturulur. Bir koleksiyon içindeki bir belgeye veri atamanız yeterlidir. Koleksiyon veya belge mevcut değilse Cloud Firestore onu oluşturur.

Belgeler

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

alovelace kullanıcısını temsil eden bir belge şöyle görünebilir:

• alovelace

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

Not: Cloud Firestore, değerler için çeşitli veri türlerini destekler: boolean, sayı, dize, coğrafi nokta, ikili blob ve zaman damgası. Bir belge içindeki verileri yapılandırmak için dizileri veya harita adı verilen iç içe geçmiş nesneleri de kullanabilirsiniz.

Bir belgedeki karmaşık, iç içe geçmiş nesnelere haritalar denir. Örneğin, yukarıdaki örnekte kullanıcının adını aşağıdaki gibi bir haritayla yapılandırabilirsiniz:

• alovelace

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

Belgelerin JSON'a çok benzediğini fark edebilirsiniz. Aslında temelde öyleler. Bazı farklılıklar vardır (örneğin, belgeler ekstra veri türlerini destekler ve boyutları 1 MB ile sınırlıdır), ancak genel olarak belgeleri hafif JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Belgeler, yalnızca belge taşıyıcıları olan koleksiyonlarda bulunur. Örneğin, her biri bir belgeyle temsil edilen çeşitli kullanıcılarınızı içerecek bir users koleksiyonunuz olabilir:

• kullanıcıları

  • alovelace

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

  • olgunlaşması

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

Cloud Firestore şemasız olduğundan, her belgeye hangi alanları koyacağınız ve bu alanlarda hangi veri türlerini depolayacağınız konusunda tam özgürlüğe sahipsiniz. Aynı koleksiyondaki belgelerin tümü farklı alanlar içerebilir veya bu alanlarda farklı türde veriler depolayabilir. Ancak belgeleri daha kolay sorgulayabilmeniz için birden fazla belgede aynı alanları ve veri türlerini kullanmak iyi bir fikirdir.

Bir koleksiyon belgeler içerir ve başka hiçbir şey içermez. Değerleri olan ham alanları doğrudan içeremez ve diğer koleksiyonları içeremez. (Cloud Firestore'da daha karmaşık verilerin nasıl yapılandırılacağına ilişkin bir açıklama için bkz . Hiyerarşik Veriler .)

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

Koleksiyonları "oluşturmanıza" veya "silmenize" gerek yoktur. Bir koleksiyondaki ilk belgeyi oluşturduktan sonra koleksiyon var olur. Bir koleksiyondaki tüm belgeleri silerseniz koleksiyon artık mevcut olmaz.

Referanslar

Cloud Firestore'daki her belge, veritabanı içindeki konumuna göre benzersiz bir şekilde tanımlanır. Önceki örnek, koleksiyon users arasında alovelace bir belgeyi gösteriyordu. Kodunuzda bu konuma atıfta bulunmak için buraya bir referans oluşturabilirsiniz.

Web modular API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

import { doc } from "firebase/firestore";

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

Web namespaced API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

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

Süratli

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Amaç-C

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Kotlin+KTX

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

Gitmek

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ı'na bakın.

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

Birlik

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ı'na bakın.

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

Yakut

document_ref = firestore.col("users").doc("alovelace")
data_model.rb

Referans, yalnızca veritabanınızdaki bir konuma işaret eden hafif bir nesnedir. Orada veri bulunsun veya bulunmasın, bir referans oluşturabilirsiniz ve bir referans oluşturmak herhangi bir ağ işlemi gerçekleştirmez.

Ayrıca koleksiyonlara referanslar da oluşturabilirsiniz:

Web modular API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

import { collection } from "firebase/firestore";

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

Web namespaced API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

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

Süratli

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Amaç-C

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Kotlin+KTX

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

Gitmek

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ı'na bakın.

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

Birlik

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ı'na bakın.

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

Yakut

collection_ref = firestore.col "users"
data_model.rb

Not: Koleksiyon referansları ve belge referansları iki farklı referans türüdür ve farklı işlemler gerçekleştirmenize olanak tanır. Örneğin, koleksiyondaki belgeleri sorgulamak için koleksiyon referansını kullanabilirsiniz ve tek bir belgeyi okumak veya yazmak için belge referansını kullanabilirsiniz.

Kolaylık sağlamak için, bir belgenin veya koleksiyonun yolunu, yol bileşenleri eğik çizgiyle ( / ) ayrılmış şekilde bir dize olarak belirterek de referanslar oluşturabilirsiniz. Örneğin alovelace belgesine bir referans oluşturmak için:

Web modular API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

import { doc } from "firebase/firestore"; 

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

Web namespaced API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

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

Süratli

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Amaç-C

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Kotlin+KTX

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

Gitmek

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ı'na bakın.

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

Birlik

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ı'na bakın.

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

Yakut

document_path_ref = firestore.doc "users/alovelace"
data_model.rb

Hiyerarşik Veriler

Cloud Firestore'da hiyerarşik veri yapılarının nasıl çalıştığını anlamak için mesajların ve sohbet odalarının bulunduğu örnek bir sohbet uygulamasını düşünün.

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

• odaları

  • A

    name : "my chat room"
    

  • B

    ...
    

Artık sohbet odalarınız olduğuna göre mesajlarınızı nasıl saklayacağınıza karar verin. Bunları sohbet odasının belgesinde saklamak istemeyebilirsiniz. Cloud Firestore'daki belgeler hafif olmalı ve bir sohbet odası çok sayıda mesaj içermelidir. Ancak sohbet odanızın belgesinde alt koleksiyonlar olarak ek koleksiyonlar oluşturabilirsiniz.

Alt koleksiyonlar

Bu senaryoda iletileri saklamanın en iyi yolu alt koleksiyonları kullanmaktır. Alt koleksiyon, belirli bir belgeyle ilişkili bir koleksiyondur.

Not: Koleksiyon Grubu Sorgularını kullanarak aynı koleksiyon kimliğine sahip alt koleksiyonlar arasında sorgulama yapabilirsiniz.

rooms koleksiyonunuzdaki her oda belgesi için messages adı verilen bir alt koleksiyon oluşturabilirsiniz:

• odaları

  • A

    name : "my chat room"
    

    • mesajları

      • mesajı1

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

      • mesajı2

        ...
        

  • B

    ...
    

Bu örnekte, alt koleksiyondaki bir iletiye aşağıdaki kodla bir başvuru oluşturacaksınız:

Web modular API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

import { doc } from "firebase/firestore"; 

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

Web namespaced API

Ağaç sallanabilir modüler Web API'si hakkında daha fazla bilgi edinin ve ad alanlı API'den yükseltme yapın .

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

Süratli

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Amaç-C

Not: Bu ürün watchOS ve App Clip hedeflerinde mevcut değildir.

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

Kotlin+KTX

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

Gitmek

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ı'na bakın.

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

Birlik

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ı'na bakın.

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

Yakut

message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")
data_model.rb

Koleksiyonların ve belgelerin değişen düzenine dikkat edin. Koleksiyonlarınız ve belgeleriniz her zaman bu modeli takip etmelidir. Bir koleksiyondaki bir koleksiyona veya bir belgedeki bir belgeye referans veremezsiniz.

Alt koleksiyonlar, verileri hiyerarşik olarak yapılandırmanıza olanak tanıyarak verilere erişimi kolaylaştırır. roomA tüm mesajları almak için alt koleksiyon messages bir koleksiyon referansı oluşturabilir ve diğer koleksiyon referanslarında olduğu gibi bu mesajlarla etkileşimde bulunabilirsiniz.

Alt koleksiyonlardaki belgeler, verileri daha fazla iç içe yerleştirmenize olanak tanıyan alt koleksiyonlar da içerebilir. Verileri 100 seviyeye kadar derinlikte iç içe yerleştirebilirsiniz.

Uyarı: Bir belgenin silinmesi onun alt koleksiyonlarının silinmesine neden olmaz!

Alt koleksiyonları olan bir belgeyi sildiğinizde bu alt koleksiyonlar silinmez. Örneğin, coll/doc/subcoll/subdoc konumunda bir belge coll/doc artık mevcut olmasa bile bulunabilir. Bir ana belgeyi silerken alt koleksiyonlardaki belgeleri de silmek istiyorsanız bunu Koleksiyonları Sil bölümünde gösterildiği gibi manuel olarak yapmanız gerekir.