JSON - ClickHouse Documentation

入力	出力	別名
✔	✔

説明

JSON フォーマットは、JSON フォーマットでデータを読み取り、出力します。 JSON フォーマットは次の内容を返します。

Parameter	Description
`meta`	カラム名と型。
`data`	データテーブル。
`rows`	出力行数の合計。
`rows_before_limit_at_least`	LIMIT がなかった場合に出力されていたと見込まれる行数の下限推定値。クエリに LIMIT が含まれている場合にのみ出力されます。この推定値は、limit transform の前にクエリパイプラインで処理されたデータブロックに基づいて計算されますが、その後 limit transform によって破棄される場合があります。ブロックがクエリパイプライン内で limit transform に到達していない場合、それらはこの推定に含まれません。
`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 シーケンスのみで構成されます。

64 ビット以上の整数 (Int64、UInt64、Int128 など) は、デフォルトでは引用符なしで出力されます。 JavaScript との互換性のため、設定パラメーター output_format_json_quote_64bit_integers を 1 に設定すると、これらの整数をダブルクォートで囲むことができます。 ClickHouse は NULL をサポートしており、JSON 出力では null として表示されます。出力で +nan、-nan、+inf、-inf の値を有効にするには、output_format_json_quote_denormals を 1 に設定します。

使用例

例:

SELECT SearchPhrase, count() AS c FROM test.hits GROUP BY SearchPhrase WITH TOTALS ORDER BY c DESC LIMIT 5 FORMAT JSON

{
        "meta":
        [
                {
                        "name": "num",
                        "type": "Int32"
                },
                {
                        "name": "str",
                        "type": "String"
                },
                {
                        "name": "arr",
                        "type": "Array(UInt8)"
                }
        ],

        "data":
        [
                {
                        "num": 42,
                        "str": "hello",
                        "arr": [0,1]
                },
                {
                        "num": 43,
                        "str": "hello",
                        "arr": [0,1,2]
                },
                {
                        "num": 44,
                        "str": "hello",
                        "arr": [0,1,2,3]
                }
        ],

        "rows": 3,

        "rows_before_limit_at_least": 3,

        "statistics":
        {
                "elapsed": 0.001137687,
                "rows_read": 3,
                "bytes_read": 24
        }
}

フォーマット設定

JSON入力フォーマットでは、設定 input_format_json_validate_types_from_metadata が 1 に設定されている場合、入力データ内のメタデータに含まれる型が、テーブル内の対応するカラムの型と比較されます。

関連項目

JSONEachRow フォーマット
output_format_json_array_of_rows 設定