Différences de comportement

Ne concerne que l'édition Cloud Firestore Enterprise.

Cette page décrit les différences de comportement entre Cloud Firestore compatible avec MongoDB et MongoDB.

Pour obtenir la liste des fonctionnalités compatibles en fonction de la version de MongoDB, consultez les ressources suivantes :

Connexions et bases de données

  • Chaque connexion est limitée à une seule base de données Cloud Firestore compatible avec MongoDB.
  • Vous devez créer une base de données avant de vous y connecter.

Dénomination

Les différences suivantes s'appliquent à la dénomination des parties de votre modèle de données.

Collections

  • Les noms de collections correspondant à __.*__ ne sont pas acceptés.

Champs

  • Les noms de champs correspondant à __.*__ ne sont pas acceptés.
  • Les noms de champs vides ne sont pas acceptés.

Documents

  • La taille maximale d'un document est de 4 Mio.
  • La profondeur d'imbrication maximale des champs est de 20. Chaque champ de type Array et Object ajoute un niveau à la profondeur globale.

_id

  • Le document _id (champ de premier niveau) doit être un ObjectId, une chaîne ou un entier de 64 bits. Les autres types BSON ne sont pas acceptés.
  • Les chaînes vides ("") et les valeurs 0 64 bits (0L) ne sont pas acceptées.

Valeurs

  • Les types BSON JavaScript, Symbol, DBPointer et Undefined ne sont pas acceptés.

Date

  • Les valeurs de date doivent être comprises dans [0001-01-01T00:00:00Z, 9999-12-31T23:59:59Z].

Decimal128

  • Les valeurs NaN, l'infini positif et l'infini négatif sont canonisées lors de l'écriture.
  • Les opérations arithmétiques sur Decimal128 ne sont pas acceptées.

Double

  • Les valeurs NaN sont canonisées lors de l'écriture.

Expression régulière

  • Les options d'expression régulière doivent être valides ("i", "m", "s", "u" ou "x") et fournies dans l'ordre alphabétique, sans répétition.

Requêtes

  • L'ordre de tri naturel (requêtes sans tri explicite) ne correspond pas à l'ordre d'insertion ni à l'ordre croissant de _id.

Agrégations

  • Les agrégations sont limitées à 250 étapes.
  • Les étapes $merge et $out ne sont pas acceptées. Consultez la section Commandes pour obtenir la liste complète des étapes et des opérateurs compatibles.
  • L'étape $lookup n'est pas compatible avec les champs let et pipeline.

Écritures

  • Les documents dont le nom commence par un signe dollar ("$") ne peuvent pas être créés à l'aide de la fonctionnalité d'insertion/mise à jour de update ou findAndModify.
  • Assurez-vous que votre chaîne de connexion inclut retryWrites=false (ou utilisez la méthode appropriée à votre pilote) pour vous assurer que le pilote ne tente pas d'utiliser cette fonctionnalité. Les écritures pouvant faire l'objet d'une nouvelle tentative ne sont pas acceptées.

Transactions

  • L'isolation d'instantané et les transactions sérialisables sont acceptées.

  • Par défaut, les transactions utilisent des contrôles de simultanéité optimistes avec isolation d'instantané.

Lire l'inquiétude

  • Cloud Firestore compatible avec MongoDB accepte les niveaux de cohérence de lecture snapshot, majority et linearizable. La valeur par défaut est snapshot, qui fait référence à l'isolation des instantanés.

    Utilisez linearizable lorsque l'application nécessite une cohérence stricte et doit empêcher les anomalies de biais d'écriture. Pour les autres charges de travail, snapshot peut améliorer les performances et réduire la contention des transactions.

Niveau de fiabilité de l'écriture

  • Seuls les niveaux de confirmation d'écriture w: 'majority' et w: 1 sont acceptés.

Préférence de lecture

  • Seuls les niveaux de cohérence en lecture primary, primaryPreferred, primary_preferred, secondary_preferred et nearest sont acceptés.

Index

  • Les index avec caractères génériques ne sont pas acceptés.
  • Cloud Firestore compatible avec MongoDB ne crée pas automatiquement d'index sur _id, mais il garantit que les valeurs de _id sont uniques dans une collection.
  • Les index pour lesquels la clé multiple n'est pas activée ne sont pas automatiquement convertis en index à clé multiple en fonction des opérations d'écriture. Vous devez activer la clé multiple lorsque vous créez l'index. Cette option ne peut pas être modifiée.

Erreurs

  • Les codes et messages d'erreur peuvent différer entre Cloud Firestore compatible avec MongoDB et MongoDB.

Commandes

Les différences de comportement suivantes s'appliquent à des commandes spécifiques.

  • Les commandes qui ne figurent pas dans les tableaux ci-dessous ne sont pas compatibles.
  • maxTimeMS est accepté par la plupart des commandes, mais peut être ignoré.

Requêtes et écritures

Commande Champs non acceptés

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

Dans une instruction DELETE :

  • collation
  • hint

findAndModify

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

count

  • hint
  • readConcern
  • collation
  • comment

distinct

  • readConcern
  • collation
  • comment
  • hint

getMore

  • comment

killCursors

(aucun)

Transactions et sessions

Commande Champs non acceptés

commitTransaction

  • comment

abortTransaction

  • comment

endSessions

(aucun)

Administration

Commande Champs non acceptés Remarques

listDatabases

  • authorizedDatabases
  • comment
 filter doit être vide s'il est fourni.

listCollections

  • comment
 Si authorizedCollections est fourni, il doit être défini sur "false".

listIndexes

  • comment

createCollection

  • timeseries
  • expireAfterSeconds
  • clusteredIndex
  • changeStreamPreAndPostImages
  • size
  • max
  • storageEngine
  • validator
  • validationLevel
  • validationAction
  • indexOptionDefaults
  • viewOn
  • pipeline
  • collation
  • writeConcern
  • encryptedFields
  • comment
 Cette commande est une opération sans effet.

capped doit être défini sur "false" s'il est fourni.

Étape suivante