Поделиться через


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

Область применения:Отметка: Да Databricks SQL Отметка: Да Databricks Runtime

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

Синтаксис

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

Аргументы

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

Возвраты

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

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

  • Применимо к:выбрано Databricks Runtime 12.1 и более ранним версиям:

    json_tuple можно помещать только в список SELECT в качестве корневого элемента выражения или следом за LATERAL VIEW. При размещении генерирующей функции в списке 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;