Cloud Firestore Veri modeli

Cloud Firestore, NoSQL, belge odaklı bir veritabanıdır. SQL veritabanından farklı olarak, tablo veya satır yoktur. Bunun yerine, koleksiyonlar halinde organize edilir belgeleri, veri depolamak.

Her bir belge anahtar değer çiftleri kümesini içerir. Cloud Firestore, büyük küçük belge koleksiyonlarını depolamak için optimize edilmiştir.

Tüm belgeler koleksiyonlarda saklanmalıdır. Belgeler listeleri gibi dizeleri veya karmaşık nesneler gibi ilkel alanları içerebilir, her ikisi de subcollections ve iç içe nesneleri içerebilir.

Koleksiyonlar ve belgeler, Cloud Firestore'da dolaylı olarak oluşturulur. Bir koleksiyon içindeki bir belgeye veri atamanız yeterlidir. Koleksiyon veya belge yoksa, Cloud Firestore onu oluşturur.

Belgeler

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

Bir kullanıcı temsil eden bir belge alovelace şöyle olabilir:

• alovelace

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

Not: boolean, sayı, dize, coğrafi açıdan, ikili blob ve zaman damgası: Bulut Firestore değerleri için veri türleri çeşitli destekler. Bir belge içindeki verileri yapılandırmak için diziler veya haritalar adı verilen iç içe nesneler de kullanabilirsiniz.

Bir belgedeki karmaşık, iç içe nesnelere haritalar denir. Örneğin, yukarıdaki örnekteki kullanıcının adını aşağıdaki gibi bir harita ile 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 ek veri türlerini destekler ve boyut olarak 1 MB ile sınırlıdır), ancak genel olarak belgeleri hafif JSON kayıtları olarak değerlendirebilirsiniz.

Koleksiyonlar

Belgeler, yalnızca belgeler için kapsayıcı olan koleksiyonlarda yaşar. Örneğin, bir olabilir users sizin çeşitli kullanıcıları, bir belgenin temsil her içerecek şekilde toplanmasını:

• kullanıcıları

  • 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ı koyacağınız ve bu alanlarda hangi veri türlerini depolayacağınız konusunda tam bir özgürlüğe sahipsiniz. Aynı koleksiyondaki belgelerin tümü farklı alanlar içerebilir veya bu alanlarda farklı veri türleri depolayabilir. Ancak, belgeleri daha kolay sorgulayabilmeniz için aynı alanları ve veri türlerini birden çok belgede 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. (Bkz Hiyerarşik Veri Bulut Firestore daha karmaşık veri yapısı hakkında açıklama için).

Bir koleksiyon içindeki 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, artık mevcut olmaz.

Referanslar

Cloud Firestore'daki her belge, veritabanındaki konumuyla benzersiz bir şekilde tanımlanır. Önceki örnek belge gösterdi alovelace koleksiyonu dahilinde users . Kodunuzdaki bu konuma bakın, bunu bir başvuru oluşturabilirsiniz.

Web sürümü 9

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

import { doc } from "firebase/firestore";

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

Web sürümü 8

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

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

Süratli

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

Amaç-C

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

Java

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");
DocSnippets.java

Kotlin+KTX

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

Java

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
References.java

piton

a_lovelace_ref = db.collection(u'users').document(u'alovelace')
snippets.py

piton

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

alovelaceRef := client.Collection("users").Doc("alovelace")
retrieve.go

PHP

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

Birlik

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

C#

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 referans oluşturmak herhangi bir ağ işlemi gerçekleştirmez.

Ayrıca koleksiyonlarına referanslar oluşturabilirsiniz:

Web sürümü 9

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

import { collection } from "firebase/firestore";

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

Web sürümü 8

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

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

Süratli

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

Amaç-C

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

Java

CollectionReference usersCollectionRef = db.collection("users");
DocSnippets.java

Kotlin+KTX

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

Java

// Reference to the collection "users"
CollectionReference collection = db.collection("users");
References.java

piton

users_ref = db.collection(u'users')
snippets.py

piton

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

usersRef := client.Collection("users")
retrieve.go

PHP

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

Birlik

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

C#

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

yakut

collection_ref = firestore.col "users"
data_model.rb

Not: Koleksiyon referansları ve belge referanslar referanslar iki ayrı tip ve farklı işlemleri gerçekleştirmek edelim. Örneğin, koleksiyondaki belgeleri sorgulamak için bir koleksiyon referansı ve tek bir belgeyi okumak veya yazmak için bir belge referansı kullanabilirsiniz.

Yol bileşenleri eğik çizgi (ayrılmış olan rahatlığı için, ayrıca, bir dize olarak bir belge veya koleksiyona yolu belirterek referanslar oluşturabilirsiniz / ). Örneğin, bir referans oluşturmak için alovelace belge:

Web sürümü 9

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

import { doc } from "firebase/firestore"; 

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

Web sürümü 8

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

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

Süratli

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

Amaç-C

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

Java

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");
DocSnippets.java

Kotlin+KTX

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

Java

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
References.java

piton

a_lovelace_ref = db.document(u'users/alovelace')
snippets.py

piton

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

alovelaceRef := client.Doc("users/alovelace")
retrieve.go

PHP

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

Birlik

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

C#

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 ve sohbet odaları içeren örnek bir sohbet uygulamasını düşünün.

Sen adında bir koleksiyon oluşturabilirsiniz rooms farklı sohbet odaları saklamak için:

• odaları

  • rooma

    name : "my chat room"
    

  • roomB

    ...
    

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ıdır ve bir sohbet odası çok sayıda mesaj içerebilir. Ancak, sohbet odanızın belgesinde 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 belgeyle ilişkili bir koleksiyondur.

Not: kullanarak aynı toplama kimliğiyle subcollections genelinde sorgulayabilir Koleksiyon Grup Sorguları .

Bir subcollection denilen oluşturabilir messages sizin her odada belgesi için rooms koleksiyonu:

• odaları

  • rooma

    name : "my chat room"
    

    • mesajları

      • message1

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

      • mesajı 2

        ...
        

  • roomB

    ...
    

Bu örnekte, aşağıdaki kodla alt koleksiyondaki bir mesaja referans oluşturacaksınız:

Web sürümü 9

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

import { doc } from "firebase/firestore"; 

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

Web sürümü 8

Daha fazla bilgi ağaç shakeable Web v9 modüler SDK hakkında ve yükseltme sürüm 8.

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

Süratli

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

Amaç-C

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

Java

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");
DocSnippets.java

Kotlin+KTX

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

Java

// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
References.java

piton

room_a_ref = db.collection(u'rooms').document(u'roomA')
message_ref = room_a_ref.collection(u'messages').document(u'message1')
snippets.py

piton

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

messageRef := client.Collection("rooms").Doc("roomA").
	Collection("messages").Doc("message1")
retrieve.go

PHP

$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#

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 izlemelidir. Bir koleksiyondaki bir koleksiyona veya bir belgedeki bir belgeye başvuramazsınız.

Alt koleksiyonlar, verileri hiyerarşik olarak yapılandırmanıza izin vererek verilere erişimi kolaylaştırır. Tüm iletileri almak için roomA , sen subcollection bir koleksiyon referans oluşturabilirsiniz messages ve onunla etkileşim başka herhangi bir tahsilat referans gibi.

Alt koleksiyonlardaki belgeler, alt koleksiyonlar da içerebilir, bu da daha fazla veri yerleştirmenize olanak tanır. Verileri 100 seviyeye kadar derinliğe yerleştirebilirsiniz.

Uyarı: Bir belgeyi silindiğinde, subcollections silmez!

Alt koleksiyonları olan bir belgeyi sildiğinizde, bu alt koleksiyonlar silinmez. Örneğin, bulunan bir belge olabilir coll/doc/subcoll/subdoc belge olsa coll/doc artık yok. Bir üst belgesini silerken subcollections belgeleri silmek isterseniz gösterildiği gibi, sen, bunu manuel yapmanız gerekir Sil Koleksiyon .