BSON コンバーター
MongoDB のバイナリ形式である BSON を Extended JSON にデコードしたり、Extended JSON を BSON バイト列としてエンコードしたりできます。ドキュメントを 16 進数または Base64 で貼り付けると、MongoDB Extended JSON で ObjectId、日付、64 ビット整数、バイナリデータを確認できます。読みやすさを優先する relaxed 出力、またはすべての型を保持する canonical 出力を選べます。
よくある質問
BSON とは何ですか?
BSON は MongoDB が保存や送信に使うバイナリドキュメント形式です。JSON のデータモデルを拡張し、ObjectId、Date、32 ビットおよび 64 ビット整数、Decimal128、バイナリデータなどの型を扱います。
Extended JSON とは何ですか?
MongoDB Extended JSON は、JSON にない BSON 型を小さなオブジェクトとして記述します。たとえば、ObjectId は {"$oid": "..."}、日付は {"$date": "2024-01-01T00:00:00Z"} のように表します。エンコード時にも同じ記法を使用できます。
relaxed と canonical の違いは何ですか?
relaxed 出力では数値は通常の JSON 数値、日付は ISO 文字列として記述され、読みやすくなります。canonical 出力ではすべての型が保持されます。たとえば {"$numberInt": "5"} や {"$numberLong": "5"} のように表すため、情報を失わずにドキュメントを元に戻せます。
配列や単一の値をエンコードできますか?
できません。BSON ドキュメントのトップレベルは常にオブジェクトです。ほかの値は {"items": [...]} のようなオブジェクトで包んでください。
貼り付ける BSON バイト列はどのように入手できますか?
mongodump の .bson ファイル、ネットワークキャプチャ、またはドライバーから、16 進数か Base64 として取得できます。ドキュメントを 1 つ貼り付けてください。バイト列の先頭にある長さがデータと一致している必要があります。
BSON が拒否されるのはなぜですか?
バイト列が有効なドキュメント 1 つを構成していない可能性があります。たとえば、長さのプレフィックスが一致しない、データが途中で切れている、文字列が有効な UTF-8 ではない場合です。エラーメッセージにはデコーダーが報告した理由が表示されます。