Desteklenen veri türleri

Bu sayfada, Cloud Firestore tarafından desteklenen veri türleri açıklanmaktadır.

Veri türleri

Aşağıdaki tabloda, Cloud Firestore tarafından desteklenen veri türleri listelenmiştir. Aynı türdeki 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.

Dizideki öğeler, kendilerine atanan konumu korur. İki veya daha fazla dizi sıralanırken diziler öğe değerlerine göre sıralanır.

İki dizi karşılaştırılırken her 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 işlem devam eder. Bir dizinin karşılaştırılacak öğeleri biterse ancak o noktaya kadar eşitse daha kısa dizi daha uzun diziden önce sıralanır.

Örneğin, [1, 2, 3] < [1, 2, 3, 1] < [2]. [2] dizisi, en büyük ilk öğe değerine sahiptir. [1, 2, 3] dizisi, [1, 2, 3, 1] dizisinin ilk üç öğesine eşit öğelere sahiptir ancak daha kısadır.

Boole false < true —
Bayt Bayt sırası En fazla 1.048.487 bayt (1 MiB - 89 bayt). Sorgular yalnızca ilk 1.500 baytı dikkate alır.
Tarih ve saat Kronolojik Cloud Firestore olarak depolandığında yalnızca mikrosaniye cinsinden hassastır; ek hassasiyetler aşağı yuvarlanır.
Kayan nokta sayısı Sayısal 64 bit çift hassasiyet, IEEE 754.
Coğrafi nokta Enleme ve ardından boylama göre Sorgulama sınırlamaları nedeniyle şu anda bu veri türünü kullanmanızı önermiyoruz. Enlem ve boylamı ayrı sayısal alanlar olarak depolamak genellikle daha iyidir. Uygulamanız için basit mesafe tabanlı coğrafi sorgulara ihtiyaç varsa Coğrafi sorgular başlıklı makaleyi inceleyin.
Tamsayı Sayısal 64 bit, imzalı
Harita Anahtarlara ve ardından değere göre

Bir dokümana yerleştirilmiş nesneyi temsil eder. Dizine eklendiğinde alt alanlarla ilgili sorgu yapabilirsiniz. Bu değeri dizine ekleme işleminden hariç tutarsanız tüm alt alanlar da dizine ekleme işleminden 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.

Harita alanları anahtara göre sıralanır ve anahtar/değer çiftlerine göre karşılaştırılır. Önce anahtarlar, ardından değerler 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 işlem devam eder. İki haritanın anahtar/değer çiftlerinin tümü aynıysa harita uzunluğu dikkate alınır. Örneğin, aşağıdaki haritalar artan düzendedir:

{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, belge kimliği, koleksiyon, belge kimliği...) Örneğin, projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH].
Metin dizesi UTF-8 ile kodlanmış bayt sırası En fazla 1.048.487 bayt (1 MiB - 89 bayt). Sorgular yalnızca UTF-8 gösteriminin ilk 1.500 baytını dikkate alır.
Vector Boyuta ve ardından tek tek öğe değerlerine göre Desteklenen maksimum yerleştirme boyutu 2048'dir. Daha büyük boyutlara sahip vektörleri depolamak için boyut azaltma özelliğini kullanın.

Değer türü sıralaması

Bir sorgu, karma türlerde değerler içeren bir alan içeriyorsa Cloud Firestore, dahili temsillere dayalı bir zorunlu 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 düzende 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 nokta değerleri
  10. Dizi değerleri
  11. Vektör yerleştirmeleri
  12. Değerleri eşleme