動作の違い

Cloud Firestore Enterprise エディションにのみ関連します。

このページでは、MongoDB 互換の Cloud Firestore と MongoDB の動作の違いについて説明します。

MongoDB のバージョンに応じてサポートされている機能の内訳については、以下をご覧ください。

接続とデータベース

  • 各接続は、1 つの MongoDB 互換の Cloud Firestore データベースに制限されます。
  • データベースに接続する前に、データベースを作成する必要があります。

命名

データモデルの各部分の命名には、次の違いが適用されます。

コレクション

  • __.*__ に一致するコレクション名はサポートされていません。

フィールド

  • __.*__ に一致するフィールド名はサポートされていません。
  • 空のフィールド名はサポートされていません。

ドキュメント

  • ドキュメントの最大サイズは 4 MiB です。
  • フィールドのネストの最大深度は 20 です。Array 型フィールドと Object 型フィールドはそれぞれ、全体的な深度を 1 レベル引き上げます。

_id

  • ドキュメント _id（トップレベル フィールド）は、ObjectId、文字列、または 64 ビット整数である必要があります。他の BSON 型はサポートされていません。
  • 空の文字列（""）と 64 ビット 0（0L）はサポートされていません。

値

  • JavaScript、Symbol、DBPointer、Undefined BSON の型はサポートされていません。

日付

  • 日付の値は [0001-01-01T00:00:00Z, 9999-12-31T23:59:59Z] の範囲内である必要があります。

Decimal128

  • NaN、正の無限大、負の無限大の値は、書き込み時に正規化されます。
  • Decimal128 の算術演算はサポートされていません。

Double

  • NaN 値は書き込み時に正規化されます。

正規表現

  • 正規表現のオプションは有効なもの（「i」、「m」、「s」、「u」、「x」）であり、重複せずにアルファベット順で指定する必要があります。

クエリ

  • 自然な並べ替え順序（明示的な並べ替えのないクエリ）は、挿入順序または _id 昇順の並べ替えと一致しません。

集約

  • 集約は 250 ステージに制限されています。
  • $merge ステージと $out ステージはサポートされていません。サポートされているステージと演算子の完全なリストについては、コマンドセクションをご覧ください。
  • $lookup ステージは let フィールドと pipeline フィールドをサポートしていません。

書き込み

  • update または findAndModify の upsert 機能を使用して、ドル記号（「$」）で始まる名前のドキュメントを作成することはできません。
  • 接続文字列に retryWrites=false を含める（またはドライバに適したメソッドを使用する）ことで、ドライバがこの機能を使用しないようにします。 再試行可能な書き込みはサポートされていません。

トランザクション

  • スナップショット分離とシリアル化可能なトランザクションがサポートされています。

  • デフォルトでは、トランザクションはスナップショット分離によるオプティミスティック同時実行制御を使用します。

読み取り保証

  • MongoDB 互換の Cloud Firestore は、snapshot、majority、linearizable の読み取り保証をサポートしています。デフォルトは snapshot で、スナップショット分離を指します。

    アプリケーションに厳密な整合性が必要で、書き込みスキューの異常を防ぐ必要がある場合は、linearizable を使用します。他のワークロードでは、snapshot を使用することでパフォーマンスが向上し、トランザクションの競合が軽減されます。

書き込み保証

  • w: 'majority' と w: 1 の書き込み保証のみがサポートされています。

読み取り保証

  • サポートされているのは、primary、primaryPreferred、primary_preferred、secondary_preferred、nearest の読み取り保証のみです。

インデックス

  • ワイルドカード インデックスはサポートされていません。
  • MongoDB 互換の Cloud Firestore は _id に自動的にインデックスを作成しませんが、_id の値がコレクション内で一意であることを保証します。
  • マルチキーが有効になっていないインデックスは、書き込みオペレーションに基づいて自動的にマルチキー インデックスに変更されることはありません。インデックスの作成時にマルチキーを有効にする必要があります。このオプションは変更できません。

エラー

  • エラーコードとメッセージは、MongoDB 互換の Cloud Firestore と MongoDB で異なる場合があります。

コマンド

以下の動作の違いは、特定のコマンドに適用されます。

  • 次の表に記載されていないコマンドはサポートされていません。
  • maxTimeMS はほとんどのコマンドで受け入れられますが、無視されることもあります。

クエリと書き込み

コマンド サポートされていないフィールド

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

DELETE ステートメント内:

  • collation
  • hint

findAndModify

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

count

  • hint
  • readConcern
  • collation
  • comment

distinct

  • readConcern
  • collation
  • comment
  • hint

getMore

  • comment

killCursors

（なし）

トランザクションとセッション

コマンド サポートされていないフィールド

commitTransaction

  • comment

abortTransaction

  • comment

endSessions

（なし）

管理

コマンド サポートされていないフィールド 注

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
 このコマンドは no-op です。

指定されている場合は、capped は false にする必要があります。

次のステップ