BSON types

ObjectId

ObjectId は小さく、ユニークである可能性が高く、生成が速く、順序付けられています。ObjectId の値は長さ 12 バイトで、次の要素で構成されます。

• Unix エポックからの秒数で測定される ObjectId の作成を表す 4 バイトのタイムスタンプ。

• プロセスごとに 1 回生成される 5 バイトのランダム値。このランダム値はマシンとプロセスに固有です。

• ランダム値で初期化される 3 バイトのインクリメント カウンター。

タイムスタンプとカウンターの値では、最上位バイトがバイトシーケンスの最初に表示されます（ビッグエンディアン）。これは、再下位バイトが最初に表示される（リトルエンディアン）他の BSON 値との相違点です。

ObjectId の作成に整数値が使用される場合は、その整数がタイムスタンプに置き換わります。

MongoDB では、コレクション内に保存される各ドキュメントにはプライマリキーとして機能するユニークな _id フィールドが必要です。挿入されたドキュメントで _id フィールドが省略されている場合、MongoDB ドライバーは _id フィールドの ObjectId を自動的に生成します。

上記は、アップサート: true に設定した更新操作を通じて挿入されるドキュメントにも適用されます。

MongoDB クライアントは、ユニークな ObjectId を持つ _id フィールドを追加します。_id フィールドに ObjectId を使用すると、次のような追加のメリットが得られます。

• ObjectIdメソッドを使用して、mongosh ObjectId.getTimestamp()の 作成時間にアクセスできます。

• ObjectId は作成時間順におおよそ順序付けられますが、完全には順序付けられません。 ObjectId値を含む_idフィールドでコレクションをソートすることは、作成時間でソートすることとほぼ同等です。

  重要

  ObjectId の値は時間の経過とともに増加するはずですが、必ずしも単調ではありません。その理由は以下のとおりです。

  • 同じ場所からデータを取得できる間隔は 1 秒のみであるため、同一秒内に作成された ObjectId の順序は保証されません。

  • クライアントによって生成され、システムクロックが異なる可能性があります。

ObjectId 値を設定、取得するには、ObjectId() メソッドを使用します。

MongoDB 5.0 以降、mongosh は、レガシーの mongo shell を置き換えます。ObjectId()メソッドは、mongosh とレガシー shell の mongo では異なる動作をします。レガシー メソッドの詳細については、「レガシー mongo Shell」を参照してください。

文字列

BSON 文字列は UTF-8 です。通常、各プログラミング言語のドライバーは、BSON の直列化と逆直列化時に、言語の文字列形式を UTF-8 に変換します。これにより、ほとんどの国際文字は BSON 文字列形式で簡単に保存できるようになります。[1]さらに、MongoDB $regex クエリは正規表現文字列形式の UTF-8 をサポートしています。

タイムスタンプ

BSON には MongoDB 内部で使用される、通常の Date 型とは関連付けられていない特殊なタイムスタンプ型があります。この内部タイムスタンプ型は 64 ビット値であり、次の属性を持ちます。

• 最上位の 32 ビットは time_t 値（UNIX エポックからの秒数）です。

• 最下位 32 ビットは、指定された秒内の操作に対して増加していく ordinal です。

BSON 形式はリトルエンディアンであるため最下位ビットを最初に保存しますが、mongod インスタンスは エンディアン属性にかかわらず、すべてのプラットフォームで ordinal 値の前に time_t 値を常に比較します。

mongod の単一インスタンス内では、タイムスタンプ値は常に一意です。

レプリケーション中、oplog には ts フィールドが生成され、BSON タイムスタンプ値を使用する optime を反映した値がこのフィールドに入ります。

MongoDB では、最上位フィールドのタイムスタンプ値が空のドキュメントを挿入する際、空のタイムスタンプ値をその時点のタイムスタンプ値に置き換えます。ただし、例外として、_id フィールド自体に空のタイムスタンプ値が含まれている場合は、常に空の値のまま挿入され、置き換えは行われません。

db.test.insertOne( { ts: new Timestamp() } );

{ "_id" : ObjectId("542c2b97bac0595474108b48"), "ts" : Timestamp(1412180887, 1) }

日付

BSON Date は、UNIX エポック（1970 年 1 月 1 日）以降のミリ秒数を表す 64 ビットの整数であり、過去から未来にわたって約 2 億 9000 万年の日付範囲を表現可能にします。

正規の BSON 仕様は BSON Date 型を UTC datetime として参照します。

BSON Date 型は符号付き整数です。[2] 負の値は 1970 年以前の日付を表します。

var mydate1 = new Date()

var mydate2 = ISODate()

mydate1.toString()

mydate1.getMonth()