סוגי נתונים נתמכים

דף זה מתאר את סוגי הנתונים שבהם תומכת Cloud Firestore.

סוגי מידע

הטבלה הבאה מפרטת את סוגי הנתונים הנתמכים על ידי Cloud Firestore. זה גם מתאר את סדר המיון המשמש בעת השוואת ערכים מאותו סוג:

סוג מידע סדר המיון הערות
מַעֲרָך לפי ערכי אלמנט

מערך אינו יכול להכיל ערך מערך אחר כאחד האלמנטים שלו.

בתוך מערך, אלמנטים שומרים על המיקום שהוקצה להם. בעת מיון שני מערכים או יותר, מערכים מסודרים על סמך ערכי האלמנטים שלהם.

כאשר משווים בין שני מערכים, המרכיבים הראשונים של כל מערך מושווים. אם האלמנטים הראשונים שווים, אז האלמנטים השניים מושווים וכך הלאה עד שנמצא הבדל. אם במערך נגמרים האלמנטים להשוואה אך הוא שווה עד לנקודה זו, אזי המערך הקצר יותר מסודר לפני המערך הארוך יותר.

לדוגמה, [1, 2, 3] < [1, 2, 3, 1] < [2] . למערך [2] יש את ערך האלמנט הראשון הגדול ביותר. למערך [1, 2, 3] יש אלמנטים השווים לשלושת האלמנטים הראשונים של [1, 2, 3, 1] אך הוא קצר יותר באורכו.

בוליאנית false < true
בתים סדר בתים עד 1,048,487 בתים (1 MiB - 89 בתים). רק 1,500 הבתים הראשונים נחשבים בשאילתות.
תאריך ושעה כּרוֹנוֹלוֹגִי כאשר מאוחסן ב-Cloud Firestore, מדויק רק למיקרו-שניות; כל דיוק נוסף מעוגל כלפי מטה.
מספר נקודה צפה מספרי דיוק כפול של 64 סיביות, IEEE 754 .
נקודה גיאוגרפית לפי קו רוחב, ואז קו אורך בשלב זה איננו ממליצים להשתמש בסוג נתונים זה עקב מגבלות שאילתות. בדרך כלל עדיף לאחסן קווי רוחב ואורך כשדות מספריים נפרדים. אם האפליקציה שלך זקוקה לשאילתות גיאוגרפיות פשוטות המבוססות על מרחק, ראה שאילתות גיאוגרפיות
מספר שלם מספרי 64 ביט, חתום
מַפָּה לפי מפתחות, ואז לפי ערך

מייצג אובייקט המוטבע בתוך מסמך. לאחר אינדקס, אתה יכול לבצע שאילתות על שדות משנה. אם תחריג ערך זה מהוספה לאינדקס, אזי כל שדות המשנה לא ייכללו בהוספה לאינדקס.

הזמנת מפתחות מסודרת תמיד. לדוגמה, אם אתה כותב {c: "foo", a: "bar", b: "qux"} המפה ממוינת לפי מפתח ונשמרת בתור {a: "bar", b: "qux", c: "foo"} .

שדות המפה ממוינים לפי מפתח ומשווים לפי צמדי מפתח-ערך, תחילה משווים בין המפתחות ולאחר מכן בין הערכים. אם צמדי המפתח-ערך הראשונים שווים, זוגות המפתח-ערך הבאים מושווים, וכן הלאה. אם שתי מפות מתחילות באותם זוגות מפתח-ערך, אורך המפה נחשב. לדוגמה, המפות הבאות בסדר עולה:

{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 אף אחד
ריק אף אחד
התייחסות לפי רכיבי נתיב (אוסף, מזהה מסמך, אוסף, מזהה מסמך...) לדוגמה, projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH] .
מחרוזת טקסט סדר בתים מקודד UTF-8 עד 1,048,487 בתים (1 MiB - 89 בתים). רק 1,500 הבתים הראשונים של ייצוג UTF-8 נחשבים בשאילתות.

הזמנת סוג ערך

כאשר שאילתה כוללת שדה עם ערכים מסוגים מעורבים, Cloud Firestore משתמש בסדר דטרמיניסטי המבוסס על הייצוגים הפנימיים. הרשימה הבאה מציגה את הסדר:

  1. ערכים אפסים
  2. ערכים בוליאניים
  3. ערכי NaN
  4. ערכי מספר שלם ונקודה צפה, ממוינים בסדר מספרי
  5. ערכי תאריך
  6. ערכי מחרוזת טקסט
  7. ערכי בתים
  8. הפניות של Cloud Firestore
  9. ערכי נקודות גיאוגרפיים
  10. ערכי מערך
  11. ערכי מפה