הבדלים בהתנהגות

רלוונטי רק למהדורת Cloud Firestore Enterprise.

בדף הזה מוסבר על ההבדלים בהתנהגות בין Cloud Firestore עם תאימות ל-MongoDB לבין MongoDB.

לפירוט של התכונות הנתמכות בהתאם לגרסת MongoDB, אפשר לעיין במאמרים הבאים:

חיבורים ומסדי נתונים

  • כל חיבור מוגבל למסד נתונים יחיד עם תאימות ל-MongoDB ב-Cloud Firestore.
  • צריך ליצור מסד נתונים לפני שמתחברים אליו.

מתן שמות

ההבדלים הבאים חלים על שמות של חלקים במודל הנתונים.

אוספים

  • אין תמיכה בשמות של אוספים שתואמים ל-__.*__.

שדות

  • אין תמיכה בשמות שדות שתואמים ל-__.*__.
  • אין תמיכה בשמות שדות ריקים.

לכתוב מסמכים

  • גודל המסמך המקסימלי הוא 4MiB.
  • העומק המקסימלי של הקינון בשדות הוא 20. כל שדה מסוג Array ו-Object מוסיף רמה אחת לעומק הכולל.

_id

  • השדה _id ברמה העליונה חייב להיות ObjectId,‏ String,‏ 64-bit integer,‏ 32-bit integer,‏ Double,‏ Binary או Object. אין תמיכה בסוגים אחרים של BSON.

ערכים

  • אין תמיכה בסוגי ה-BSON‏ JavaScript,‏ Symbol,‏ DBPointer ו-Undefined.

תאריך

  • ערכי התאריכים צריכים להיות בטווח [0001-01-01T00:00:00Z, 9999-12-31T23:59:59Z].

Decimal128

  • הערכים NaN, אינסוף חיובי ואינסוף שלילי עוברים קנוניזציה בזמן הכתיבה.
  • אין תמיכה בפעולות אריתמטיות ב-Decimal128.

זוגית

  • הערכים של NaN עוברים קנוניזציה בזמן הכתיבה.

ביטוי רגולרי

  • האפשרויות של הביטוי הרגולרי צריכות להיות תקינות (i,‏ m,‏ s,‏ u או x) ולסופק בסדר אלפביתי ללא חזרות.

שאילתות

  • סדר המיון הטבעי (שאילתות ללא מיון מפורש) לא תואם לסדר ההוספה או למיון לפי _id בסדר עולה.

צבירות

  • הצבירות מוגבלות ל-250 שלבים.
  • אין תמיכה בשלבים $merge ו-$out. רשימה מלאה של השלבים והאופרטורים הנתמכים מופיעה בקטע בנושא פקודות.
  • בשלב $lookup אין תמיכה בשדות let ו-pipeline.

כותב

  • אי אפשר ליצור מסמכים עם שמות שמתחילים בסימן דולר ("$") באמצעות התכונה upsert של update או findAndModify.
  • מוודאים שמחרוזת החיבור כוללת את retryWrites=false (או משתמשים בשיטה שמתאימה לדרייבר) כדי לוודא שהדרייבר לא ינסה להשתמש בתכונה הזו. אין תמיכה בכתיבות שאפשר לנסות שוב.

עסקאות

  • יש תמיכה בבידוד snapshot ובטרנזקציות שניתנות לסריאליזציה.

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

קריאה של נתוני הבעיה

  • ‫Cloud Firestore עם תאימות ל-MongoDB תומך בבעיות הקריאה snapshot , majority ו-linearizable. ברירת המחדל היא snapshot, שמתייחסת לבידוד snapshot.

    משתמשים ב-linearizable כשהאפליקציה דורשת עקביות קפדנית וצריכה למנוע אנומליות של הטיה בכתיבה. במקרים אחרים, snapshot יכול לשפר את הביצועים ולצמצם את התחרות על משאבים בעסקאות.

כתיבה של נתוני הדאגה

  • יש תמיכה רק ב-write concerns‏ w: 'majority' ו-w: 1.

העדפת קריאה

  • רק רמות הדאגה לגבי קריאה primary,‏ primaryPreferred,‏ primary_preferred,‏ secondary_preferred ו-nearest נתמכות.

אינדקסים

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

שגיאות

  • קודי השגיאה וההודעות עשויים להיות שונים בין Cloud Firestore עם תאימות ל-MongoDB לבין MongoDB.

פקודות

ההבדלים הבאים בהתנהגות חלים על פקודות ספציפיות.

  • פקודות שלא מופיעות בטבלאות הבאות לא נתמכות.
  • רוב הפקודות מקבלות את maxTimeMS, אבל יכול להיות שהן יתעלמו ממנו.

שאילתות וכתיבה

Command שדות שלא נתמכים

find

  • comment
  • readConcern
  • max
  • min
  • returnKey
  • showRecordId
  • tailable
  • oplogReplay
  • noCursorTimeout
  • awaitData
  • allowPartialResults
  • collation
  • allowDiskUsage
  • let

aggregate

  • bypassDocumentValidation
  • readConcern
  • collation
  • hint
  • comment
  • let

insert

  • bypassDocumentValidation
  • comment

update

  • collation
  • arrayFilters
  • hint

delete

  • comment
  • write

בתוך הצהרת מחיקה:

  • collation
  • hint

findAndModify

  • fields
  • bypassDocumentValidation
  • collation
  • arrayFilters
  • hint
  • comment
  • let

count

  • hint
  • readConcern
  • collation
  • comment

distinct

  • readConcern
  • collation
  • comment
  • hint

getMore

  • comment

killCursors

(ללא)

עסקאות וסשנים

Command שדות שלא נתמכים

commitTransaction

  • comment

abortTransaction

  • comment

endSessions

(ללא)

ניהול

Command שדות שלא נתמכים Notes

listDatabases

  • authorizedDatabases
  • comment
 אם מציינים את הערך filter, הוא חייב להיות ריק.

listCollections

  • comment
 אם מציינים את הערך authorizedCollections, הוא חייב להיות false.

listIndexes

  • comment

createCollection

  • timeseries
  • expireAfterSeconds
  • clusteredIndex
  • changeStreamPreAndPostImages
  • size
  • max
  • storageEngine
  • validator
  • validationLevel
  • validationAction
  • indexOptionDefaults
  • viewOn
  • pipeline
  • collation
  • writeConcern
  • encryptedFields
  • comment
 הפקודה הזו לא מבצעת פעולה.

capped צריך להיות false אם הוא מסופק.

המאמרים הבאים