JSON と XML のセルビューアー

実装済み

JSON や XML のセルを、記号だらけの文字列ではなく、整理された展開可能な構造として開きます。

JSON や XML のドキュメントを保持する列は、グリッドの行内では読みづらく、セルの端からはみ出す 1 本の長い行として表示されます。SQLly は値が実際にドキュメントであることを検知し、それ用の適切なビューアーを提供します。

セルが認識される仕組み

検出では、セルの 生の値 - 表示用の整形や列のマスキングが適用される前の実データを調べ、列の宣言された型には依存しません。値がドキュメントとして扱われるのは、正しい形式で始まり、かつパースに成功する場合です:

  • JSON - トリミングした値が次で始まる { または [ そして 有効な JSON として解析されます。
  • XML - トリミングした値が次で始まる < そして 整形式の XML として解析できます。
  • YAML - 値が次で始まる --- ドキュメントマーカーがある、または少なくとも2つのトップレベルの key: value 行に加えてさらに構造 (3 つ目のキー、入れ子のブロック、リスト項目) がある場合、最上位の行はすべて YAML 形式です。 そして 解析されます。コロンを含む文や 2 行のメモは、テキストのままです。
  • Markdown - フェンス付きコードブロック、テーブル、または 2 種類の異なる Markdown(見出し、リスト、引用ブロック、リンク、太字、インラインコード)を含む 2 行以上。見出し 1 つだけ、または短いリストだけの場合はテキストのままです。

解析の成功を必須にしているのは意図的です。波括弧で始まるだけの文字列は、開けないドキュメントとして提示されるのではなく、そのままテキストとして残されます。だからこそ、JSON を保持する nvarchar JSONを保持する列は認識されますが、本物の json 列が不正な形式のテキストを保持している場合は認識されません。

ビューアーを開く

  • 右クリック › 構造化データビューアーを開く。 常に利用でき、バイナリやジオメトリのセルにも使える方法です。(セルをダブルクリックした場合は、代わりに値がコピーされます。)
  • セルの詳細パネル。 選択したセルが変わっても同じビューアをインラインで表示するので、ドキュメントを横に開いたままグリッドを移動できます。セルの右クリックメニューから開きます(セルを編集 › セル詳細)。次を使用し、 ⌘⌥I (CtrlAltI Windows と Linux では)、またはコマンドパレットから (セル詳細パネルの切り替え). 固定 は、移動してもそのセルに留まります。

ビューアー内

  • 整形済み。 ドキュメントは、読み込み時にインデントし直されます。JSON オブジェクトのキーは並べ替えられるため、同じドキュメントは常に同じ見た目になり、2 つの行を 1 行ずつ比較できます。
  • 構文ハイライト表示 Raw モードでは、整形済みテキストをスクロール可能なビューで表示します。
  • ツリーモード - ライブ検索ボックスとノードごとのコピーを備えた折りたたみ可能なノード。スクロールするには長すぎるドキュメントから 1 つのフィールドを探すためのものです。JSON、XML、YAML のすべてで使えます。
  • プレビューモード Markdownの場合は、見出し、リスト、テーブル、コードブロックを含めてレンダリングされたテキストが表示されます。ハイライトされたソースを表示するにはRawに切り替えます。
整形してコピー はセルの右クリックメニューにもあります。場所は 形式を指定してコピー、何も開かずに、整形したテキストをクリップボードに入れたいとき。

セル詳細パネルで値を編集する

結果を編集できる場合(キーを持つ単一テーブルのクエリで、変更を許可する接続の場合)、パネルの「値」ビューには 編集 ボタン。セル上に広々とした複数行エディターを開きます。長い説明やJSONドキュメントをグリッドセルに直接打ち込むよりずっと楽です。

  • 適用 (または ⌘Enter, CtrlEnter Windows と Linux では) ステージします 他のグリッド編集とまったく同じように、新しい値として扱われます。行にはステージ済みマーカーが付き、レビューして 保存 (または破棄)します。 Esc または キャンセル 下書きを破棄します。
  • NULL と空は異なる。 空のエディターを適用すると、空の文字列がステージングされます。 NULL を設定 NULL をステージします。
  • 値は、その列に対してチェックされます 行エディターがフィールドを検証するのと同じ方法です(整数列には整数、日付列には有効な日付など)。値が合わない場合はステータスバーに理由が表示され、下書きは開いたままになります。 json または jsonb 列では、有効なJSONではないテキストもステージされ、エディターの下に警告が表示されます。
  • 長い値は、最初に全体が読み込まれます。 短縮プレビューとして届いたセルは、パネルが完全な値を取得するまで編集できません。
  • 編集できない場合 パネルには「編集」の代わりにその理由が表示されます。たとえば、複数のテーブルにまたがるクエリ、読み取り専用接続、マスク列や計算列、バイナリ値などです(これらは次で変更できます ファイルから読み込む または 16 進ビューアー)。
  • ピン留めされたパネル グリッド内で移動した後でも、ピン留めしたセルを編集します。

その他の種類のセルコンテンツ

同じビューアーが、グリッドのセルに収まらないそれ以外のものも扱います: 画像 (PNG、JPEG、GIF、WebP、BMP はマジックバイトで判別され、描画されます)、 バイナリ (ASCII 表示付きの 16 進ダンプとして表示)、および ジオメトリ 値。