/ /

/ /

HexData()（mongoshメソッド）

定義

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

構文

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

HexData( <subType>, <buffer> )

次の値を返します。	バイナリデータオブジェクト。

コマンドフィールド

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

フィールド

タイプ

必要性

説明

subType

integer

必須

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

番号	説明
0	汎用バイナリのサブタイプ
1	関数データ
2	バイナリ（旧）
3	UUID（旧）
4	UUID
5	MD5
6	暗号化された BSON 値
7	圧縮された時系列データバージョン 5.2 で追加。
8	キーやシークレットなどの機密データ。 MongoDB では、サブタイプ 8 のバイナリデータのリテラル値はログに記録されません。代わりに、MongoDB は`###`のプレースホルダー値をログに記録します。
9	ベクトルデータとは、同じ型の数値が高密度に圧縮された配列です。
128	カスタムデータ

buffer

string

必須

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

注意

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

例

サンプルコレクションを作成する

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

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

Retrieve the document

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

db.hexCollection.find()

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

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

詳細

戻る

日付

ObjectId

定義

構文

コマンドフィールド

注意

例

サンプル コレクションを作成する

Retrieve the document

詳細

サンプルコレクションを作成する