JSON

Entrée	Sortie	Alias
✔	✔

Description

Le format JSON lit et produit des données au format JSON. Le format JSON renvoie les éléments suivants :

Parameter	Description
`meta`	Noms et types des colonnes.
`data`	Tables de données
`rows`	Le nombre total de lignes en sortie.
`rows_before_limit_at_least`	L’estimation minimale du nombre de lignes qu’il y aurait eu sans LIMIT. N’est renvoyée que si la requête contient LIMIT. Cette estimation est calculée à partir des blocs de données traités dans le pipeline d’exécution de la requête avant la transformation de limite, mais ceux-ci peuvent ensuite être écartés par cette transformation. Si les blocs n’atteignent même pas la transformation de limite dans le pipeline d’exécution de la requête, ils ne sont pas pris en compte dans l’estimation.
`statistics`	Des statistiques telles que `elapsed`, `rows_read`, `bytes_read`.
`totals`	Valeurs totales (lors de l’utilisation de WITH TOTALS).
`extremes`	Valeurs extrêmes (lorsque `extremes` est défini sur 1).

Le type JSON est compatible avec JavaScript. Pour garantir cette compatibilité, certains caractères sont en outre échappés :

la barre oblique / est échappée en \/
les séparateurs de ligne alternatifs U+2028 et U+2029, qui posent problème dans certains navigateurs, sont échappés en \uXXXX.
les caractères de contrôle ASCII sont échappés : retour arrière, saut de page, saut de ligne, retour chariot et tabulation horizontale sont remplacés par \b, \f, \n, \r, \t, et les octets restants dans la plage 00-1F le sont à l’aide de séquences \uXXXX.
les séquences UTF-8 invalides sont remplacées par le caractère de remplacement � afin que le texte en sortie soit composé de séquences UTF-8 valides.

Pour assurer la compatibilité avec JavaScript, les entiers Int64 et UInt64 sont, par défaut, entourés de guillemets doubles. Pour supprimer les guillemets, vous pouvez définir le paramètre de configuration output_format_json_quote_64bit_integers sur 0. ClickHouse prend en charge NULL, qui s’affiche sous la forme null dans la sortie JSON. Pour activer les valeurs +nan, -nan, +inf, -inf dans la sortie, définissez output_format_json_quote_denormals sur 1.

Exemple d’utilisation

Exemple :

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
        }
}

Paramètres de format

Pour le format d’entrée JSON, si le paramètre input_format_json_validate_types_from_metadata est défini sur 1, les types issus des métadonnées des données d’entrée seront comparés aux types des colonnes correspondantes de la table.

Voir aussi

format JSONEachRow
réglage output_format_json_array_of_rows

Référence SQL

Types de données

Moteurs

Fonctions

Formats

Paramètres

Tables système

Lacs de données

Description

Exemple d’utilisation

Paramètres de format

Voir aussi

​Description

​Exemple d’utilisation

​Paramètres de format

​Voir aussi

Description

Exemple d’utilisation

Paramètres de format

Voir aussi