Функция генератора табличных значений json_tuple

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime

Возвращает несколько объектов JSON в виде кортежа.

Синтаксис

json_tuple(jsonStr, path1 [, ...] )

Аргументы

  • jsonStr: строковое выражение с хорошо сформированным JSON.
  • pathN: строковый литерал STRING с путем в формате JSON.

Возвраты

Одна строка, состоящая из объектов JSON.

Если объект не найден, NULL возвращается для этого объекта.

  • Применимо к: Databricks Runtime 12.1 и более ранних версий:проверка помечены да

    json_tuple можно поместить только в список в SELECT качестве корневого элемента выражения или после бокового представления. При размещении функции в списке SELECT не должно быть другой функции генератора в том же SELECT списке или UNSUPPORTED_GENERATOR. MULTI_GENERATOR вызывается.

  • Применимо к:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и выше:

    Вызов из предложения LATERAL VIEW или SELECT списка не рекомендуется. Вместо этого вызовите json_tuple как table_reference.

Примеры

Применимо к: Databricks Runtime 12.1 и более ранних версий:проверка помечены да

> SELECT json_tuple('{"a":1, "b":2}', 'a', 'b'), 'Spark SQL';
 1  2  Spark SQL

> SELECT json_tuple('{"a":1, "b":2}', 'a', 'c'), 'Spark SQL';
 1  NULL  Spark SQL

> SELECT json_tuple('{"a":1, "b":2}', 'a', 'c'), json_tuple('{"c":1, "d":2}', 'c', 'd'), 'Spark SQL';
 Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

Применимо к:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и выше:

> SELECT j.*, 'Spark SQL' FROM json_tuple('{"a":1, "b":2}', 'a', 'b') AS j;
 1  2  Spark SQL

> SELECT j.*, 'Spark SQL' FROM json_tuple('{"a":1, "b":2}', 'a', 'c') AS j;
 1  NULL  Spark SQL

> SELECT j1.*, j2.*, 'Spark SQL'
 FROM json_tuple('{"a":1, "b":2}', 'a', 'c') AS j1,
      json_tuple('{"c":1, "d":2}', 'c', 'd') AS j2;