Skip to main content
Edit this page

JSONのエクスポート

インポート用に使用されるほぼすべてのJSONフォーマットは、エクスポートにも使用できます。最も一般的なのはJSONEachRowです:

SELECT * FROM sometable FORMAT JSONEachRow
{"path":"Bob_Dolman","month":"2016-11-01","hits":245}
{"path":"1-krona","month":"2017-01-01","hits":4}
{"path":"Ahmadabad-e_Kalij-e_Sofla","month":"2017-01-01","hits":3}

または、カラム名を省略してディスク容量を節約するためにJSONCompactEachRowを使用できます:

SELECT * FROM sometable FORMAT JSONCompactEachRow
["Bob_Dolman", "2016-11-01", 245]
["1-krona", "2017-01-01", 4]
["Ahmadabad-e_Kalij-e_Sofla", "2017-01-01", 3]

データ型を文字列としてオーバーライドする​

ClickHouseはデータ型を尊重し、JSONを標準に従ってエクスポートします。しかし、すべての値を文字列としてエンコードする必要がある場合は、JSONStringsEachRowフォーマットを使用できます:

SELECT * FROM sometable FORMAT JSONStringsEachRow
{"path":"Bob_Dolman","month":"2016-11-01","hits":"245"}
{"path":"1-krona","month":"2017-01-01","hits":"4"}
{"path":"Ahmadabad-e_Kalij-e_Sofla","month":"2017-01-01","hits":"3"}

ここでは、数値カラムhitsが文字列としてエンコードされています。文字列としてのエクスポートはすべてのJSON*フォーマットでサポートされており、JSONStrings\*やJSONCompactStrings\*フォーマットを探索できます:

SELECT * FROM sometable FORMAT JSONCompactStringsEachRow
["Bob_Dolman", "2016-11-01", "245"]
["1-krona", "2017-01-01", "4"]
["Ahmadabad-e_Kalij-e_Sofla", "2017-01-01", "3"]

データと共にメタデータをエクスポートする​

アプリで一般的なJSONフォーマットは、結果データだけでなくカラムタイプやクエリ統計もエクスポートします:

SELECT * FROM sometable FORMAT JSON
{
    "meta":
    [
        {
            "name": "path",
            "type": "String"
        },
        …
    ],

    "data":
    [
        {
            "path": "Bob_Dolman",
            "month": "2016-11-01",
            "hits": 245
        },
        …
    ],

    "rows": 3,

    "statistics":
    {
        "elapsed": 0.000497457,
        "rows_read": 3,
        "bytes_read": 87
    }
}

JSONCompactフォーマットは、同じメタデータを表示しますが、データ自体をコンパクトな形式で出力します:

SELECT * FROM sometable FORMAT JSONCompact
{
    "meta":
    [
        {
            "name": "path",
            "type": "String"
        },
        …
    ],

    "data":
    [
        ["Bob_Dolman", "2016-11-01", 245],
        ["1-krona", "2017-01-01", 4],
        ["Ahmadabad-e_Kalij-e_Sofla", "2017-01-01", 3]
    ],

    "rows": 3,

    "statistics":
    {
        "elapsed": 0.00074981,
        "rows_read": 3,
        "bytes_read": 87
    }
}

すべての値を文字列としてエンコードするために、JSONStringsまたはJSONCompactStringsバリアントを検討してください。

JSONデータと構造をコンパクトにエクスポートする方法​

データとその構造の両方を持つより効率的な方法は、JSONCompactEachRowWithNamesAndTypesフォーマットを使用することです:

SELECT * FROM sometable FORMAT JSONCompactEachRowWithNamesAndTypes
["path", "month", "hits"]
["String", "Date", "UInt32"]
["Bob_Dolman", "2016-11-01", 245]
["1-krona", "2017-01-01", 4]
["Ahmadabad-e_Kalij-e_Sofla", "2017-01-01", 3]

この形式は、カラム名とタイプを持つ2つのヘッダ行を前置したコンパクトなJSON形式を使用します。このフォーマットは別のClickHouseインスタンス（または他のアプリ）にデータをインジェストするために使用できます。

JSONをファイルにエクスポートする​

JSONデータをファイルに保存するには、INTO OUTFILE句を使用できます:

SELECT * FROM sometable INTO OUTFILE 'out.json' FORMAT JSONEachRow
36838935 rows in set. Elapsed: 2.220 sec. Processed 36.84 million rows, 1.27 GB (16.60 million rows/s., 572.47 MB/s.)

ClickHouseは37百万件近いレコードをJSONファイルにエクスポートするのにわずか2秒しかかかりません。また、COMPRESSION句を使用してオンザフライの圧縮を有効にしてエクスポートすることもできます:

SELECT * FROM sometable INTO OUTFILE 'out.json.gz' FORMAT JSONEachRow
36838935 rows in set. Elapsed: 22.680 sec. Processed 36.84 million rows, 1.27 GB (1.62 million rows/s., 56.02 MB/s.)

達成するのにより多くの時間がかかりますが、はるかに小さな圧縮ファイルが生成されます:

2.2G    out.json
576M    out.json.gz