Экспорт 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]

Этот формат использует компактный JSON, предваряемый двумя строками заголовка с именами и типами колонок. Этот формат может быть использован для приема данных в другую инстанцию ClickHouse (или в другие приложения).