JSON
| 入力 | 出力 | エイリアス |
|---|---|---|
| ✔ | ✔ |
説明
JSONフォーマットは、データをJSON形式で読み込み、出力します。
JSONフォーマットは以下を返します：
| パラメータ | 説明 |
|---|---|
meta | カラム名とタイプ。 |
data | データテーブル |
rows | 出力行の総数。 |
rows_before_limit_at_least | LIMITがなかった場合に存在したであろう最小限の行数。クエリにLIMITが含まれている場合のみ出力されます。クエリにGROUP BYが含まれている場合、rows_before_limit_at_leastはLIMITなしで存在したであろう正確な行数です。 |
statistics | elapsed、rows_read、bytes_readなどの統計。 |
totals | 合計値（WITH TOTALSを使用している場合）。 |
extremes | 極端な値（extremesが1に設定されている場合）。 |
JSONタイプはJavaScriptと互換性があります。そのため、いくつかの文字は追加でエスケープされます：
- スラッシュ
/は\/としてエスケープされます。 - 一部のブラウザで問題を起こす代替行区切り
U+2028およびU+2029は\uXXXXとしてエスケープされます。 - ASCII制御文字（バックスペース、フォームフィード、ラインフィード、キャリッジリターン、水平タブ）はそれぞれ
\b、\f、\n、\r、\tで置き換えられ、00-1F範囲内の残りのバイトは\uXXXXシーケンスでエスケープされます。 - 無効なUTF-8シーケンスは置換文字�に変更され、出力テキストは有効なUTF-8シーケンスとなります。
JavaScriptとの互換性のために、Int64およびUInt64整数はデフォルトで二重引用符で囲まれます。
引用符を除去するには、設定パラメータoutput_format_json_quote_64bit_integersを0に設定します。
ClickHouseはNULLをサポートしており、これはJSON出力でnullとして表示されます。出力で+nan、-nan、+inf、-infの値を有効にするには、output_format_json_quote_denormalsを1に設定します。
使用例
例：
フォーマット設定
JSON入力フォーマットの場合、設定input_format_json_validate_types_from_metadataが1に設定されていると、
入力データのメタデータからのタイプがテーブルの対応するカラムのタイプと比較されます。