値の書式

実装済み

値を UTF-8、JSON、16 進数、MessagePack、Base64、Protobuf、または展開した gzip、zstd、LZ4 として表示でき、選択した形式はキーごとに記憶されます。

値ビューアは、検出した形式だけでなく、選んだ形式でも値を表示できます。値を開き、 値を開く Redis キーで、次に 値ビューアーで開く… または 16 進数で表示… 結果セルに、または ペイロードのプレビュー Pub/Sub ビューアーで、次を使用します フォーマット ビューアーのツールバーにあるメニュー。メニューはグループ化されています: プレーン表示、エンコーディング、圧縮、言語シリアライザーの順です。形式は表示だけのもので、どれを選んでもキーに保存されているバイトは変わりません。

  • 自動 - 検出されたビュー(JSON、XML、画像、ジオメトリ、テキスト)。どれにも一致しない場合、Auto は先頭バイトと値の構造も調べ、gzip、zstd、LZ4、zlib、Java シリアライズ、Python の pickle、PHP serialize、Base64、Protobuf。見つかったものはメニューの横に表示されます(「Auto: gzip → JSON (1,234 → 5,678 bytes)」)。構造の判定は意図的に保守的で、値全体が解析できる必要があり、Base64 と推定するのは、16 文字以上でデコード後のバイトが読める内容の値だけです。そのため、ふつうの単語、16 進 ID、あるいは次のようなキー名は user:42 テキストのままです。
  • UTF-8 - テキストとしてのバイト列。無効な UTF-8 は置換文字で表示され、その旨の注記が付きます。
  • JSON - ツリービューで整形表示されます。有効な JSON ではない値は、注記付きで元のテキストのまま保持されます。
  • YAML - ハイライト表示され、JSON と同じ検索可能なツリーを備えます。YAML のマッピングやリストではない値は、注記付きで元のテキストのまま保持されます。
  • Markdown - Raw モードではハイライト表示され、次ではレンダリング(見出し、リスト、テーブル、コードブロック、リンク)されます プレビュー モード。
  • 16 進 - 標準的な 16 進ダンプ。
  • MessagePack - ツリーとハイライターに渡すために JSON にデコードされます。バイナリフィールドは次のように表示されます {"$binary": "<hex>"}、標準的なタイムスタンプは次として {"$timestamp": "2023-11-14T22:13:20Z"}、その他の拡張値として {"$ext": {"type": n, "data": "<hex>"}}、および JSON オブジェクトのキーとして衝突してしまうキーを持つマップ(整数 1 文字列の横 "1"、または重複したキー)として {"$map": [[key, value], …]} そのため、エントリは失われません。有効な MessagePack ではないペイロードは、デコーダーのエラー理由とともに 16 進ダンプにフォールバックします。
  • Base64 - 標準または URL セーフで、パディングの有無は問わず、改行は無視されます。デコードされたバイト列は、その内容に応じて、JSON や XML のツリー、テキスト、認識されたシリアライズ形式、または 16 進ダンプとして表示されます。
  • Protobuf - スキーマなしで走査される Protocol Buffers メッセージなので、どんなメッセージでも調べられます。フィールド番号がキーになり、varint は数値として、固定幅フィールドは整数と浮動小数点の両方の読みで表示されます({"$fixed64": …, "$double": …})、長さ区切りのフィールドは、テキストとして読める場合はテキストとして、1 つのメッセージとして辿れる場合はネストしたメッセージとして表示され、 {"$bytes": "<hex>"} そうでない場合は、繰り返しフィールドは配列になります。フィールド名にはメッセージのスキーマが必要です。次を登録してください .proto 次の下にあるファイル 設定 › 結果 › Protobuf スキーマ (下記参照)。
  • gzip - zstd, LZ4, deflate、値は解凍され、結果は含まれている内容に応じて表示されます(JSON と XML はツリー、PHP、Java、pickle、Protobuf のペイロードはデコード結果、テキストはそのテキスト、それ以外は 16 進ダンプ)。前後のサイズも注記で示されます。1 回の選択で解く層は 1 つだけで、圧縮ストリームの中の圧縮ストリームは注記に示されるだけで、再度は解凍されません。LZ4 はフレーム形式と、元のサイズを先頭に付けた生ブロックの両方を受け付け、deflate は zlib でラップされたストリームと生のストリームを受け付けます。zstd は SQLly のブラウザー版では利用できず、メニューにもその旨が表示されます。
  • PHP シリアライズ - serialize() JSON にデコードされた出力: リストは配列に、その他の配列はオブジェクトになり、オブジェクトは {"$class": "Name", "$properties": {…}} protected および private のプロパティ名が次のつづりで現れ protected:name そして private:Class:name、次を参照 {"$ref": n}、および UTF-8 ではない文字列 {"$bytes": "<hex>"}.
  • Java シリアライゼーション - 1 つの ObjectOutputStream ペイロードはヘッダーで識別され、要約されます。ストリームのバージョン、含まれるクラスとそれぞれの serialVersionUID、およびその中の文字列。フィールド値はデコードされません。それにはクラス自体が必要です。
  • Python pickle - プロトコル 2 以降の pickle はヘッダーで認識され、プロトコル、オペコード数、グローバル(module.name)が参照しているもの、含まれる文字列のサンプル、正常に終端しているかどうか。オブジェクトは再構築されません。再構築すると pickle の命令を実行することになるためです。

すべてのデコーダーは、値を信頼できないものとして扱います。展開後の出力は 16 MB に制限され、gzip のトレーラー、zstd のフレームヘッダー、LZ4 のブロックプレフィックスがすでにそれを超えるサイズを示している場合は、展開を開始する前に拒否されます。途切れた、または破損したストリームは、デコーダーの理由とともにデコード不可として報告され、部分的な出力として表示されることはありません。Protobuf と PHP のネストは 128 階層で止まり、値の内部にあるすべての長さは実際に存在するバイト数と照合され、すべてのバイトを説明できないウォーカーは値全体を拒否します。

独自のスキーマで Protobuf を使う

下の 設定 › 結果 › Protobuf スキーマ, .proto ファイルを追加… は 1 つ以上の .proto ファイル(ファイルのフォルダーが、その importが検索され、標準の google/protobuf/* 型は組み込みです)、および 記述子セットを追加… コンパイル済みセットを次から登録します protoc --descriptor_set_out。各スキーマは、そのメッセージタイプとともに、読み取れない場合はコンパイラーが示す理由とともに一覧表示されます。 再読み込み 変更後にファイルを再読み込みし、 削除 は、ファイルには手を触れずに登録を解除します。

スキーマが登録されていると、Protobuf として表示される値に メッセージ Format メニューの隣にあるメニュー。メッセージ型を選ぶと、値が実際のフィールド名でデコードされ、JSON ツリーに表示されます。入れ子のメッセージ、名前付きの列挙型、配列としての繰り返しフィールド、数値としての 64 ビット整数が表されます。値に含まれていてメッセージに定義されていないフィールドは、注記の中に番号で一覧表示されます。値がメッセージにまったく一致しない場合(フィールドのワイヤ型が誤っている、またはどのフィールドもメッセージに属していない)、またはスキーマがその後削除された場合は、ビューアーはスキーマなしのフィールド番号表示に戻り、その理由を示します。メッセージ型は形式と同じように記憶されます。Redis キーであれば再起動後も(次の中で protobuf-schemas.json SQLly のデータフォルダー内)、またはセッション中のその他のセル用。ブラウザー版はスキーマファイルを読み取れないため、そこでは Protobuf の値は常にフィールド番号で表示されます。

圧縮された値を編集する

圧縮して保存された値。gzip、zlib、生の deflate、zstd、LZ4(フレームまたはサイズプレフィックス付きブロック)、または MySQL COMPRESS() 出力は、その中のテキストとして編集でき、まったく同じ方法で圧縮して書き戻されるため、それを読むものは引き続き動作します:

  • 結果グリッド。 圧縮されたバイナリセルをビューアーで開く(16 進数で表示… または 構造化データビューアーを開く)。ビューが圧縮を解除した値であるとき、 編集 テキストを開き、 gzip としてステージ (またはどのパッケージ形式で読み込まれたものでも)で再圧縮し、そのセルの保留中の変更としてステージします。他のグリッド編集と同じように確認して保存できます。
  • Redis キービュー。 圧縮された文字列、ハッシュフィールド、リスト要素の編集は、その展開されたテキストから始まり、次を使用します 再圧縮して名前を付けて保存… オン:レビューされたコマンドが再圧縮したバイトを書き込みます。入力した通りのテキストを保存するにはオフにします。

値のパッケージングは正確に一致させます(zlib ヘッダーは zlib ヘッダーのまま、MySQL の 4 バイト長プレフィックスは新しい長さに書き直します)。さらに、再圧縮したバイト列を解凍して元のテキストに戻ることを、ステージングの前に確認します。パッケージングを特定できない値や、内容がテキストではなくバイナリの値は、編集の対象にしません。

バイナリ セルにも、次の場所に同じピッカーが表示されます セル詳細 パネルの 16 進ビューと、そこから開くビューアーで使えるため、どのバイナリ列の MessagePack 値でも同じ方法でデコードできます。

MessagePack デコーダーはペイロードを信頼できないものとして扱います。データ内の長さは実際に存在するバイト数と照合されるため、切り詰められたペイロードや悪意のあるペイロードは、メモリを使い果たすのではなく、デコードできないものとして報告され、128 レベルを超える入れ子は拒否されます。

Redis のキーの読み取りの場合(GET, HGETALL, LRANGE, JSON.GET…) 結果のセルから開くと、その選択は接続・データベース・キー・カラムごとに記憶され、SQLly を再起動しても保持されます。どのタブや行に表示しても、キーの値は選んだ形式で表示されます。選択は次の場所に保存されます: value-formats.json SQLly のデータフォルダー内にあり、最近選択された 2,000 個のキーを保持します。古いものから先に忘れられます。ファイルにはバージョン番号が含まれ、より新しい SQLly が書き込んだ、このバージョンが認識しない形式名は、ファイルを拒否せず Auto として読み取られます。ファイルが読み取れない場合、SQLly はそれに触れず、ビューアーのツールバーの下にその旨を表示し、新しい選択はこのセッションの間だけ保持します。その他の結果セルは、SQLly を終了するまで、そのクエリ・行・列に対する選択を記憶します。Auto を選ぶと忘れられます。1 MB を超える値は、検出されたビューのみを保持します。

SQLly
値ビューアーの形式ピッカー: MessagePack でエンコードされた Redis の値を JSON ツリーにデコードしたところ。
値ビューアーの形式ピッカー: MessagePack でエンコードされた Redis の値を JSON ツリーにデコードしたところ。