AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs Menu

HexData()(mongoshメソッド)

16 進データからバイナリ データ オブジェクトを作成します。

HexData() の構文は次のとおりです。

HexData( <subType>, <buffer> )
次の値を返します。

バイナリ データ オブジェクト。

このコマンドは、次のフィールドを取ります。

フィールド
タイプ
必要性
説明

subType

integer

必須

データサブタイプを指定します。

  • 0: 汎用バイナリのサブタイプ

  • 1: 関数

  • 2: バイト配列

  • 3: 古い UUID

  • 4: UUID

  • 5: MD5

  • 128: ユーザー定義

buffer

string

必須

16 進データ。 string は、有効な 16 進数ではない最初の文字までデコードされます。 16 進 string では大文字または小文字を使用できます。

注意

mongosh は、無効な 16 進文字を拒否するレガシー shell とは異なり、最初の 16 進数以外の文字で解析を暗黙的に停止します。HexData() 出力が有効かどうかを判断するには、HexData() 出力で .toString('hex') メソッドを使用し、大文字と小文字を区別しない比較を使用して、その string を元の入力 string と比較します。

1

HexData()を使用して、16 進 string から作成されたバイナリ データを含むドキュメントをテスト コレクションに挿入します。

db.hexCollection.insertOne( {
_id: 0, hexField: HexData( 0, "123456abcdef" )
} )
2

ドキュメントを返すには、次のfindコマンドを実行します。

db.hexCollection.find()

出力には、 Binary.createFromBase64()を使用して、 hexFieldの値が64の基数として表示されます。

[ { _id: 0, hexField: Binary.createFromBase64('EjRWq83v', 0) } ]