שימוש ומגבלות

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

מעקב אחר השימוש

כדי לעקוב אחרי השימוש ב-Cloud Firestore, צריך לפתוח את Cloud Firestore הכרטיסייה שימוש במסוף Firebase. השתמשו במרכז השליטה כדי להעריך את השימוש שלכם של תקופות זמן שונות.

שימוש מפורט במסוף Google Cloud

כשיוצרים פרויקט Firebase, יוצרים גם פרויקט Google Cloud. מכסות ל-API: Cloud Firestore וגם מכסות ל-App Engine דפים במסוף Google Cloud עוקבים אחרי השימוש והמכסה ב-Cloud Firestore מידע.

מכסה בחינם

ב-Cloud Firestore יש מכסה בחינם שמאפשרת לך להתחיל לעבוד עם את מסד הנתונים (default) ללא עלות. סכומי המכסות בחינם מפורטים בהמשך. אם אתם צריכים עוד מכסה, צריך להפעיל את החיוב בפרויקט Google Cloud.

המכסות חלות מדי יום ומתאפסות בסביבות חצות לפי שעון החוף המערבי של ארה"ב.

רק מסד הנתונים (default) עומד בדרישות המכסה בחינם.

רמת חברות ללא תשלום מכסה
נתונים מאוחסנים 1GiB
קריאות מסמכים 50,000 ביום
כתיבה של מסמכים 20,000 ביום
מחיקה של מסמכים 20,000 ביום
העברת נתונים יוצאת 10 GiB לחודש

הפעולות והתכונות הבאות לא כוללות שימוש בחינם. צריך להפעיל את החיוב כדי להשתמש בתכונות הבאות:

  • שימוש במסדי נתונים בעלי שם (לא ברירת מחדל)
  • מחיקה ב-TTL
  • נתוני PITR
  • גיבוי נתונים
  • פעולות שחזור

למידע נוסף על אופן החיוב של תכונות אלה, ראו תמחור האחסון.

מגבלות רגילות

בטבלאות הבאות מוצגות המגבלות שחלות על Cloud Firestore אלה מגבלות קפדניות, אלא אם צוין אחרת.

מסדי נתונים

הגבלה פרטים
המספר המקסימלי של מסדי נתונים לכל פרויקט

100

אפשר לפנות לתמיכה כדי לבקש הגדלה של המגבלה הזו.

אוספים, מסמכים ושדות

הגבלה פרטים
מגבלות על מזהי קולקציות
  • צריך להזין תווי UTF-8 חוקיים
  • האורך המקסימלי הוא 1,500 בייטים
  • אסור להשתמש בקו נטוי לפנים (/)
  • לא יכול להכיל רק נקודה אחת (.) או נקודות כפולות (..)
  • לא ניתן להתאים לביטוי הרגולרי __.*__
העומק המקסימלי של אוספי משנה 100
מגבלות על מזהי מסמכים
  • צריך להזין תווי UTF-8 חוקיים
  • האורך המקסימלי הוא 1,500 בייטים
  • אסור להשתמש בקו נטוי לפנים (/)
  • לא יכול להכיל רק נקודה אחת (.) או נקודות כפולות (..)
  • לא ניתן להתאים את הביטוי הרגולרי __.*__
  • אם מייבאים ישויות של Datastore למסד נתונים של Firestore, מזהי ישויות מספריים נחשפים כ-__id[0-9]+__
הגודל המקסימלי של שם המסמך 6 KiB
הגודל המקסימלי של מסמך 1 MiB (1,048,576 בייטים)
מגבלות על שמות שדות צריך להזין תווי UTF-8 חוקיים
הגודל המקסימלי של שם השדה 1,500 בייטים
מגבלות בנתיבי השדות
  • יש להפריד בין שמות השדות באמצעות נקודה אחת (.)
  • ניתן להעביר כמחרוזת של פלחים (.) מופרדת בנקודות, כאשר כל פלח הוא שם של שדה פשוט או שם של שדה במירכאות (מוגדר למטה).
שם פשוט של שדה הוא שם שבו כל התנאים הבאים מתקיימים:
  • מכיל רק את התווים a-z, A-Z, 0-9 וקו תחתון (_)
  • לא מתחיל ב-0-9
שם של שדה במירכאות מתחיל ומסתיים בתו (`). לדוגמה, foo.`x&y` מתייחס לשדה x&y שנמצא מתחת לשדה foo. כדי ליצור שם של שדה עם תו האישור ההפוך, צריך לסמן בתו בריחה (escape) את התו ההפוך באמצעות הלוכסן ההפוך (\). מטעמי נוחות, אפשר להעביר את נתיב השדה כאובייקט FieldPath (לדוגמה, ראו JavaScript FieldPath) כדי להימנע משמות של שדות במירכאות.
הגודל המקסימלי של נתיב השדה 1,500 בייטים
הגודל המקסימלי של ערך בשדה 1MiB – 89 בייטים (1,048,487 בייטים)
עומק מקסימלי של שדות במפה או במערך

20

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


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

כתיבה ועסקאות

בנוסף למגבלות האלה, צריך לראות גם שיטות מומלצות לתכנון התאמה לעומס (scaling).

הגבלה פרטים
הגודל המקסימלי של בקשת API ‎10 MiB
מגבלת זמן לעסקה 270 שניות, עם זמן תפוגה של 60 שניות ללא פעילות

מדדים

המגבלות הבאות חלות על אינדקסים של שדה יחיד ועל אינדקסים מורכבים:

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

  • 200 אם לא הפעלתם חיוב עבור לפרויקט Google Cloud שלך.

    אם אתם זקוקים להגדלת מכסה, עליכם הפעלת החיוב בפרויקט Google Cloud.

  • 500 אם מפעילים חיוב בפרויקט Google Cloud.

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

המספר המקסימלי של רשומות במדד לכל מסמך

40,000

מספר הרשומות של האינדקס הוא הסכום של הדברים הבאים עבור מסמך:

  • מספר הרשומות באינדקס עם שדה יחיד
  • מספר הרשומות באינדקס המורכב

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

7.5 KiB

כדי לראות איך Cloud Firestore מחשב את הגודל של רשומת האינדקס, אפשר לעיין גודל רשומת האינדקס.
סכום מקסימלי של רשומות האינדקס של מסמך

8 MiB

הגודל הכולל של כל מסמך הוא הסכום של הרכיבים הבאים:

  • סכום הגודל של רשומות האינדקס בשדה יחיד של מסמך
  • סכום הגודל של רשומות האינדקס המורכבות של מסמך
    		•
    הגודל המקסימלי של ערך שדה שנוסף לאינדקס

    1,500 בייטים

    ערכי שדות שגדולים מ-1,500 בייטים ייחתכו. שאילתות שכוללות ערכים בשדות קטועים עשויים להחזיר תוצאות לא עקביות.

    אורך חיים (TTL)

    הגבלה פרטים
    המספר המקסימלי של תצורות בשדה יחיד למסד נתונים

    • 200 אם לא הפעלתם חיוב עבור לפרויקט Google Cloud שלך.

      אם אתם זקוקים להגדלת מכסה, עליכם הפעלת החיוב בפרויקט Google Cloud.

    • 500 אם מפעילים חיוב בפרויקט Google Cloud.

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

    ייצוא/ייבוא

    המגבלות הבאות חלות על פעולות מנוהלות של ייבוא וייצוא:

    הגבלה פרטים
    המספר המקסימלי הכולל של בקשות ייצוא וייבוא שמותר לשלוח בכל דקה בפרויקט 20
    המספר המקסימלי של פעולות ייצוא וייבוא בו-זמנית 50
    המספר המקסימלי של מסננים של מזהי אוספים לבקשות ייצוא וייבוא 100

    כללי אבטחה

    הגבלה פרטים
    מספר מקסימלי של exists(), get() ו-getAfter() שיחות לכל בקשה
    • 10 לבקשות למסמך יחיד ובקשות שאילתה.

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

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

    אם חורגים מכל אחת מהמגבלות האלה, מתקבלת הודעת שגיאה מסוג 'הרשאה נדחתה'.

    ייתכן שחלק מהקריאות לגישה למסמכים יישמרו במטמון, ושיחות שנשמרו במטמון לא נכללות בחישוב של המגבלות.
    העומק המקסימלי של דף חשבון match בתצוגת עץ 10
    אורך נתיב מקסימלי, במקטעי נתיב, מותר בתוך קבוצה של match דוחות 100
    המספר המקסימלי של משתני תיעוד נתיב שמותר להשתמש בהם בתוך קבוצה של משפטי match בתצוגת עץ 20
    עומק הקריאה המקסימלי של הפונקציה 20
    המספר המקסימלי של ארגומנטים של פונקציות 7
    המספר המקסימלי של let קישורי משתנים לכל פונקציה 10
    המספר המקסימלי של הפעלות של פונקציות רקורסיביות או מחזוריות 0 (לא אפשרי)
    המספר המקסימלי של ביטויים שנבדקים לכל בקשה 1,000
    גודל מקסימלי של קבוצת כללים קבוצות כללים חייבות לציית לשתי מגבלות גודל:
    • מגבלה של 256KB על הגודל של מקור הטקסט בקבוצת הכללים שפורסמו ממסוף Firebase או מ-CLI באמצעות firebase deploy.
    • מגבלה של 250KB על הגודל של קבוצת הכללים המורכבת שמובילה כשמערכת Firebase מעבדת את המקור והופכת אותו לפעיל בקצה העורפי.

    ניהול ההוצאות

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

    הגדרת תקציב חודשי

    כדי לעקוב אחרי עלויות Cloud Firestore, צריך ליצור תקציב חודשי מסוף Google Cloud. התקציבים לא יגבילו את השימוש, אבל אפשר להגדיר התראות לקבל התראה כשאתם מתקרבים לעלויות המתוכננות שלכם או חורגים מהן. בחודש.

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

    מידע נוסף על להגדיר תקציבים והתראות לגבי תקציבים.