Les tableaux suivants répertorient les types de données, les pilotes et les outils tiers MongoDB compatibles avec Cloud Firestore.
Types de données
| Type BSON | Compatible |
|---|---|
| Entier 32 bits | Oui |
| Entier 64 bits | Oui |
| Tableau | Oui |
| Données binaires | Oui |
| Booléen | Oui |
| Date | Oui |
| DBPointer | Non |
| Decimal128 | Oui |
| Double | Oui |
| JavaScript | Non |
| JavaScript (avec champ d'application) | Non |
| MaxKey | Oui |
| MinKey | Oui |
| Vide | Oui |
| Objet | Oui |
| ObjectId | Oui |
| Expression régulière | Oui |
| Chaîne | Oui |
| Symbole | Non |
| Horodatage | Oui |
| Indéterminé | Non |
_id du document
Le champ _id de premier niveau d'un document doit être de l'un des types suivants :
- ObjectId
- Chaîne
- Entier 64 bits
- Entier 32 bits
- Double
- Binaire
- Objet
- Booléen
La taille totale de _id ne doit pas dépasser 1 500 octets.
Chaque valeur d'un ID de type objet doit également être d'un type d'ID compatible ou d'un tableau de valeurs, chacune d'entre elles étant d'un type d'ID compatible.
Les autres types BSON ne sont pas acceptés.
Langages et pilotes MongoDB
Cloud Firestore est compatible avec les versions de pilote suivantes :
| Langue | Versions des pilotes |
|---|---|
| Java | 5.x |
| Node.js | 6.x 5.x |
| Python | 4.x 3.x (x ≥ 12) |
| Accéder | 2.x |
| C# | 3.x |
| Ruby | 2.x (x ≥ 16) |
Compatibilité avec l'authentification OIDC
Les pilotes Go, C# et Ruby sont compatibles avec l'authentification OpenID Connect (OIDC) à partir de Google Cloud pour toutes les versions de pilote compatibles.
Les pilotes Java, Node.js et Python sont compatibles avec l'authentification OIDC à partir de Google Cloud, à partir des versions de pilote suivantes :
- Java : 4.10
- Node.js : 6.7
- Python : 4,7
Outils tiers
Cloud Firestore est compatible avec les outils tiers décrits dans cette section.
| Outil | Description | Remarques |
|---|---|---|
| mongoimport | Outils de base de données MongoDB | Consultez Chargement groupé de données. |
| mongoexport | Outils de base de données MongoDB | |
| mongodump | Outils de base de données MongoDB | |
| mongorestore | Outils de base de données MongoDB | Consultez Chargement groupé de données. |
| mongosh | Shell MongoDB | |
| Mongoose | Outil de modélisation d'objets MongoDB | |
| MongoDB Compass | Outil basé sur une IUG pour l'exploration des données |
Compatibilité des types BSON et Cloud Firestore
Cette section récapitule le mappage entre les types BSON MongoDB et les valeurs Cloud Firestore. Étant donné que BSON est un format binaire et que l'API Cloud Firestore utilise des tampons de protocole, certains types sont mappés directement, tandis que d'autres nécessitent des représentations de mappage spéciales.
Présentation du mappage
Les tableaux suivants montrent comment les types de données BSON correspondent aux représentations de tampon de protocole Cloud Firestore.
Mappages directs
Ces types ont un équivalent direct dans les deux systèmes.
| Type BSON | BSON | Cloud Firestore Proto | Remarques |
|---|---|---|---|
| Double | 1.23 |
double_value: 1.23 |
|
| Chaîne | "hello" |
string_value: "hello" |
|
| Objet | { |
map_value { |
|
| Array | [ |
array_value { |
|
| Binaire (sous-type zéro) | BinData(0, 'SGVsbG8=') |
bytes_value: "Hello" |
|
| Booléen | true |
boolean_value: true |
|
| Null | null |
null_value: NULL_VALUE |
|
| Entier 64 bits | Long('1234567890') |
integer_value: 1234567890 |
|
| Date | ISODate('2026-05-22T04:00:00Z') |
timestamp_value { |
Les valeurs de code temporel Cloud Firestore sont stockées avec une précision de l'ordre de la microseconde, mais toute précision supérieure à la milliseconde est perdue lors de la conversion en BSON. |
Types BSON représentés sous forme de mappages dans l'API Cloud Firestore
Ces types BSON sont encapsulés dans le Cloud Firestore map_value avec des clés spéciales pour indiquer le type.
| Type BSON | BSON | Cloud Firestore Proto | Remarques |
|---|---|---|---|
| Entier 32 bits | 123 |
map_value { |
|
| Binaire (sous-type non nul) | BinData(1, 'AQIDBA==') |
map_value { |
Octet de sous-type ajouté aux données. |
| ObjectId | ObjectId('67eea9446dc71ec469e9496a') |
map_value { |
Chaîne hexadécimale en minuscules. |
| Timestamp (Internal) | Timestamp(123, 1) |
map_value { |
Code temporel interne MongoDB. |
| Expression régulière | RegExp('.*', 'im') |
map_value { |
|
| Clé minimale | MinKey() |
map_value { |
|
| Clé maximale | MaxKey() |
map_value { |
|
| Decimal128 | Decimal128('4E7') |
map_value { |
Types Cloud Firestore non natifs dans BSON
Ces types Cloud Firestore sont représentés sous forme de mappages spécialement structurés lorsqu'ils sont convertis en BSON.
| Type : Cloud Firestore | BSON | Cloud Firestore Proto |
|---|---|---|
| GeoPoint | { |
geo_point_value { |
| Vecteur | { |
map_value { |
| Document Ref | { |
reference_value: "projects/.../documents/col/doc" |
Noms des champs
Les noms de champs de MongoDB qui correspondent à __.*__ sont échappés en incorporant r: lorsqu'ils sont stockés dans Cloud Firestore. Par exemple, un champ BSON __foo__ devient __r:foo__ dans Cloud Firestore.
Types de données BSON dans les SDK client
Lorsque vous utilisez les SDK clients Cloud Firestore, vous pouvez utiliser des classes de SDK spécialisées pour représenter les types de données BSON tels que les décimales 128 bits, les expressions régulières et les codes temporels BSON.
Node.js
const { RegexValue, Decimal128Value, BsonTimestamp } = require('@google-cloud/firestore'); // Setting fields with BSON data types const res = await db.collection('foo').doc('bar').set({ regex: new RegexValue('myRegexPattern', 'i'), decimal: new Decimal128Value('0.73e-7'), bsonTimestamp: new BsonTimestamp(1732754912, 500), });
Java
import com.google.cloud.firestore.BsonTimestamp; import com.google.cloud.firestore.Decimal128Value; import com.google.cloud.firestore.RegexValue; import java.util.HashMap; import java.util.Map; Map<String, Object> data = new HashMap<>(); data.put("regex", new RegexValue("myRegexPattern", "i")); data.put("decimal", new Decimal128Value("0.73e-7")); data.put("bson_timestamp", new BsonTimestamp(1732754912, 500)); db.collection("foo").doc("bar").set(data);
Java
import com.google.firebase.firestore.BsonTimestamp; import com.google.firebase.firestore.Decimal128Value; import com.google.firebase.firestore.RegexValue; import java.util.HashMap; import java.util.Map; Map<String, Object> data = new HashMap<>(); data.put("regex", new RegexValue("myRegexPattern", "i")); data.put("decimal", new Decimal128Value("0.73e-7")); data.put("bson_timestamp", new BsonTimestamp(1732754912, 500)); db.collection("foo").doc("bar").set(data);
Accéder
import ( "context" "cloud.google.com/go/firestore" ) func writeBsonTypes(ctx context.Context, client *firestore.Client) error { _, err := client.Collection("foo").Doc("bar").Set(ctx, map[string]interface{}{ "regex": firestore.RegexValue{Pattern: "myRegexPattern", Options: "i"}, "decimal": firestore.Decimal128Value{Value: "0.73e-7"}, "bson_timestamp": firestore.BsonTimestamp{Seconds: 1732754912, Increment: 500}, }) return err }
Étape suivante
- Suivez le Guide de démarrage rapide : créer une base de données et s'y connecter.
- En savoir plus sur les différences de comportement
- Pour obtenir une répartition des fonctionnalités compatibles en fonction de la version de MongoDB, consultez la page