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

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

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

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

שימוש מפורט במסוף הענן של Google

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

מכסה חינם

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

המכסות מיושמות מדי יום ומתאפסות בסביבות חצות השקט.

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

גבולות סטנדרטיים

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

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

לְהַגבִּיל פרטים
מגבלות על מזהי אוסף
  • חייב להיות תווים 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 בתים
אילוצים בנתיבי שטח
  • חייבים להפריד שמות השדות עם תקופה אחת ( . )
  • יתקבלו כמחרוזת כאשר כל שמות השדות בנתיב פשוטים, אחרת יש להעביר כאובייקט FieldPath ( למשל JavaScript FieldPath )
שם שדה פשוט הוא שם שבו כל הדברים הבאים נכונים:
  • מכיל רק את התווים az , AZ , 0-9 , ו קו תחתון ( _ )
  • האם לא להתחיל עם 0-9
גודל מרבי של נתיב שדה 1,500 בתים
גודל מרבי של ערך שדה 1 מיב - 89 בתים (1,048,487 בייט)
עומק מרבי של שדות במפה או מערך 20

כותב ועסקאות

לְהַגבִּיל פרטים
מקסימום כתיבה לשנייה למסד נתונים 10,000 (עד 10 מיב לשנייה)
גודל בקשת API מרבי 10 מיב
מספר מרבי של כותב כי ניתן להעביר אל Commit פעולה או שבוצעה עסקה 500
מספר מרבי של טרנספורמציות שדה שיכול להתבצע על מסמך יחיד Commit פעולה או עסקה 500
מגבלת זמן לעסקה 270 שניות, עם זמן פקיעה סרק של 60 שניות

גבולות רכים

Cloud Firestore אינו מונע ממך לחרוג מהספים למטה, אך פעולה זו משפיעה על הביצועים.

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

1 לשנייה

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

קצב כתיבה מקסימלי לאוסף שבו מסמכים מכילים ערכים עוקבים בשדה אינדקס 500 לשנייה

עדכונים בזמן אמת

גבול רך פרטים
חיבורים מקבילים מקבילים ללקוחות סלולר/אינטרנט לכל מסד נתונים

1,000,000

Cloud Firestore לא מונע ממך לחרוג ממגבלה רכה זו אך פעולה זו משפיעה רבות על זמן האחזור ושיעור השגיאות.

אינדקסים

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

לְהַגבִּיל פרטים
מספר מקסימלי של אינדקסים מורכבים למסד נתונים 200
מספר הפטורים המרבי של אינדקס בשדה יחיד למסד נתונים 200

מספר ערכי אינדקס מרבי לכל מסמך

40,000

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

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

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

גודל מרבי של ערך אינדקס

7.5 KiB

כדי לראות כיצד Google Cloud Firestore מחשבת גודל הכניסה למדד, לראות בגודל כניסה למדד .

סכום מקסימלי של גדלי ערכי האינדקס של מסמך

8 מיב

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

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

    1500 בתים

    ערכי שדות מעל 1500 בתים נקטעים. שאילתות הקשורות לערכי שדה קטועים עשויות להחזיר תוצאות לא עקביות.

    ייצוא ייבוא

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

    לְהַגבִּיל פרטים
    המספר הכולל המרבי של בקשות ייצוא וייבוא ​​לפרויקט מותר לדקה 20
    מספר הייצוא והיבוא המקביל 50
    המספר המרבי של מסנני מזהה אוסף לבקשות ייצוא ויבוא 100

    כללי אבטחה

    לְהַגבִּיל פרטים
    מספר מרבי של exists() , get() , ולאחר getAfter() קוראת לכל בקשה
    • 10 לבקשות של מסמך יחיד ובקשות שאילתה.
    • 20 עבור קריאה מרובה מסמכים, עסקאות וכתיבה בקבוצות. המגבלה הקודמת של 10 חלה גם על כל פעולה.

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

    חריגה ממגבלה גורמת לשגיאת שלילת הרשאה.

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

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

    ניהול הוצאות

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

    קבע תקציב חודשי

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

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

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

    קבע מגבלת הוצאה יומית

    כדי להגביל את השימוש שלך ב- Cloud Firestore, הגדר מגבלת הוצאה יומית באמצעות App Engine. App Engine מאפשר לך להגדיר את תקרת הוצאה יומית על המשאבים הקשורים App Engine, כולל ה- Cloud firestore. מגבלת App Engine אינה חלה על מוצרי Firebase אחרים.