Skip to main content
Skip to main content
Edit this page

JSON函数

在Yandex.Metrica中，用户使用JSON作为访问参数。为了处理这些JSON，实现了一些函数。（尽管在大多数情况下，JSON是预先进行额外处理的，并将结果值放在单独的列中。）所有的这些函数都进行了尽可能的假设。以使函数能够尽快的完成工作。

我们对JSON格式做了如下假设：

  1. 字段名称（函数的参数）必须使常量。
  2. 字段名称必须使用规范的编码。例如：visitParamHas('{"abc":"def"}', 'abc') = 1，但是 visitParamHas('{"\\u0061\\u0062\\u0063":"def"}', 'abc') = 0
  3. 函数可以随意的在多层嵌套结构下查找字段。如果存在多个匹配字段，则返回第一个匹配字段。
  4. JSON除字符串文本外不存在空格字符。

visitParamHas(参数，名称)​

检查是否存在«name»名称的字段

visitParamExtractUInt(参数，名称)​

将名为«name»的字段的值解析成UInt64。如果这是一个字符串字段，函数将尝试从字符串的开头解析一个数字。如果该字段不存在，或无法从它中解析到数字，则返回0。

visitParamExtractInt(参数，名称)​

与visitParamExtractUInt相同，但返回Int64。

visitParamExtractFloat(参数，名称)​

与visitParamExtractUInt相同，但返回Float64。

visitParamExtractBool(参数，名称)​

解析true/false值。其结果是UInt8类型的。

visitParamExtractRaw(参数，名称)​

返回字段的值，包含空格符。

示例:

visitParamExtractString(参数，名称)​

使用双引号解析字符串。这个值没有进行转义。如果转义失败，它将返回一个空白字符串。

示例:

目前不支持\uXXXX\uYYYY这些字符编码，这些编码不在基本多文种平面中（它们被转化为CESU-8而不是UTF-8）。

以下函数基于simdjson，专为更复杂的JSON解析要求而设计。但上述假设2仍然适用。

JSONHas(json[, indices_or_keys]...)​

如果JSON中存在该值，则返回1。

如果该值不存在，则返回0。

示例：

indices_or_keys可以是零个或多个参数的列表，每个参数可以是字符串或整数。

  • String = 按成员名称访问JSON对象成员。
  • 正整数 = 从头开始访问第n个成员/成员名称。
  • 负整数 = 从末尾访问第n个成员/成员名称。

您可以使用整数来访问JSON数组和JSON对象。

例如：

JSONLength(json[, indices_or_keys]...)​

返回JSON数组或JSON对象的长度。

如果该值不存在或类型错误，将返回0。

示例：

JSONType(json[, indices_or_keys]...)​

返回JSON值的类型。

如果该值不存在，将返回Null。

示例：

JSONExtractUInt(json[, indices_or_keys]...)​

JSONExtractInt(json[, indices_or_keys]...)​

JSONExtractFloat(json[, indices_or_keys]...)​

JSONExtractBool(json[, indices_or_keys]...)​

解析JSON并提取值。这些函数类似于visitParam*函数。

如果该值不存在或类型错误，将返回0。

示例:

JSONExtractString(json[, indices_or_keys]...)​

解析JSON并提取字符串。此函数类似于visitParamExtractString函数。

如果该值不存在或类型错误，则返回空字符串。

该值未转义。如果unescaping失败，则返回一个空字符串。

示例:

JSONExtract(json[, indices_or_keys...], Return_type)​

解析JSON并提取给定ClickHouse数据类型的值。

这是以前的JSONExtract<type>函数的变体。 这意味着JSONExtract(..., ‘String’)返回与JSONExtractString()返回完全相同。JSONExtract(..., ‘Float64’)返回于JSONExtractFloat()`返回完全相同。

示例:

JSONExtractKeysAndValues(json[, indices_or_keys...], Value_type)​

从JSON中解析键值对，其中值是给定的ClickHouse数据类型。

示例：

JSONExtractRaw(json[, indices_or_keys]...)​

返回JSON的部分。

如果部件不存在或类型错误，将返回空字符串。

示例: