Desteklenen veri türleri

Bu sayfada Cloud Firestore'un desteklediği veri türleri açıklanmaktadır.

Veri türleri

Aşağıdaki tabloda, Cloud Firestore tarafından desteklenen veri türleri listelenmiştir. Burada, aynı türden değerler karşılaştırılırken kullanılan sıralama düzeni de açıklanır:

Veri türü Sıralama şekli Notlar
Dizi Öğe değerlerine göre

Bir dizi, öğelerinden biri olarak başka bir dizi değeri içeremez.

Bir dizi içinde öğeler, kendilerine atanan konumu korur. İki veya daha fazla diziyi sıralarken diziler, öğe değerlerine göre sıralanır.

İki dizi karşılaştırılırken her bir dizinin ilk öğeleri karşılaştırılır. İlk öğeler eşitse ikinci öğeler karşılaştırılır ve bir fark bulunana kadar bu şekilde devam edilir. Bir dizide, karşılaştırılacak öğelerin sayısı azalıyor ancak bu noktaya eşitse kısa dizi, uzun diziden önce sıralanır.

Örneğin, [1, 2, 3] < [1, 2, 3, 1] < [2]. [2] dizisi, en büyük birinci öğe değerine sahip. [1, 2, 3] dizisi, [1, 2, 3, 1] dizisinin ilk üç öğesine eşit elemanlara sahip ancak uzunlukları daha kısa.

Boole false < true —
Bayt Bayt sırası En fazla 1.048.487 bayt (1 MiB - 89 bayt). Sorgular tarafından yalnızca ilk 1.500 bayt dikkate alınır.
Tarih ve saat Kronolojik Cloud Firestore'da depolandığında yalnızca mikrosaniyelere kadar hassastır. Tüm ek hassasiyetler aşağı doğru yuvarlanır.
Kayan nokta sayısı Sayısal 64 bit çift duyarlıklılık, IEEE 754.
Coğrafi nokta Enlem ve ardından boylama göre Şu anda, sorgulama sınırlamaları nedeniyle bu veri türünü kullanmanızı önermiyoruz. Enlem ve boylamın ayrı sayısal alanlar olarak depolanması genellikle daha iyidir. Uygulamanız mesafeye dayalı basit coğrafi sorgulara ihtiyaç duyuyorsa Coğrafi sorgular konusuna bakın
Tam sayı Sayısal 64 bit, imzalı
Harita Anahtarlara ve ardından değere göre

Doküman içine yerleştirilmiş bir nesneyi temsil eder. Dizine eklendiğinde, alt alanlarda sorgu yapabilirsiniz. Bu değeri dizine ekleme işleminden hariç tutarsanız tüm alt alanlar da dizine eklenmeden hariç tutulur.

Anahtar sıralaması her zaman sıralanır. Örneğin, {c: "foo", a: "bar", b: "qux"} yazarsanız harita anahtara göre sıralanır ve {a: "bar", b: "qux", c: "foo"} olarak kaydedilir.

Eşleme alanları anahtara göre sıralanır ve önce anahtarlar, sonra değerler karşılaştırılarak anahtar/değer çiftlerine göre karşılaştırılır. İlk anahtar/değer çiftleri eşitse sonraki anahtar/değer çiftleri karşılaştırılır ve bu şekilde devam eder. İki eşlemenin anahtar/değer çiftlerinin tümü aynıysa harita uzunluğu dikkate alınır. Örneğin, aşağıdaki haritalar artan sıradadır:

{a: "aaa", b: "baz"}
{a: "foo", b: "bar"}
{a: "foo", b: "bar", c: "qux"}
{a: "foo", b: "baz"}
{b: "aaa", c: "baz"}
{c: "aaa"}
NaN Yok —
Boş Yok —
Referans Yol öğelerine göre (koleksiyon, doküman kimliği, koleksiyon, doküman kimliği...) Örneğin, projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH].
Metin dizesi UTF-8 olarak kodlanmış bayt sırası En fazla 1.048.487 bayt (1 MiB - 89 bayt). UTF-8 temsilinin yalnızca ilk 1.500 baytı sorgular tarafından dikkate alınır.
Vektör Boyuta ve ardından bağımsız öğe değerlerine göre En fazla desteklenen yerleştirme boyutu 2048'dir. Daha büyük boyutlara sahip vektörleri depolamak için boyutluluk azaltma özelliğini kullanın.

Değer türü sıralaması

Bir sorgu, karma tür değerlerine sahip bir alan içerdiğinde Cloud Firestore, dahili temsillere göre deterministik bir sıralama kullanır. Aşağıdaki listede sıra gösterilmektedir:

  1. Boş değerler
  2. Boole değerleri
  3. NaN değerleri
  4. Sayısal sıralamaya göre sıralanmış tam sayı ve kayan nokta değerleri
  5. Tarih değerleri
  6. Metin dizesi değerleri
  7. Bayt değerleri
  8. Cloud Firestore referansları
  9. Coğrafi puan değerleri
  10. Dizi değerleri
  11. Vektör yerleştirmeleri
  12. Değerleri eşleştirin