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

  • Статья

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

Возвращает строки путем отмены вложенности массива с нумерацией позиций с использованием семантики OUTER.

Синтаксис

posexplode_outer(expr)

Аргументы

  • expr: выражение ARRAY или MAP.

Возвраты

Набор строк, состоящих из позиции и элементов массива или ключей и значений карты. Столбцы, созданные posexplode_outer массивом, именуются pos и col. Столбцы для карты вызываются poskey и value.

Если expr имеет NULL значение, одна строка со значениями NULL для значений карты или массива.

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

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

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

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

Примеры

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

> SELECT posexplode_outer(array(10, 20)) AS elem, 'Spark';
 0  10 Spark
 1  20 Spark

> SELECT posexplode_outer(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
 0  1   a   Spark
 1  2   b   Spark

> SELECT posexplode_outer(array(1, 2)), posexplode_outer(array(3, 4));
  Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

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

> SELECT pos, col FROM posexplode_outer(array(10, 20));
 0  10
 1  20

> SELECT pos, key, value FROM posexplode_outer(map(10, 'a', 20, 'b'));
 0  10   a
 1  22   b

> SELECT p1.*, p2.* FROM posexplode_outer(array(1, 2)) AS p1, posexplode_outer(array(3, 4)) AS p2;
 0  1  0  3
 0  1  1  4
 1  2  0  3
 1  2  1  4

-- Using lateral correlation in Databricks 12.2 and above
> SELECT p1.*, p2.* FROM posexplode_outer(array(1, 2)) AS p1, LATERAL posexplode_outer(array(3 * p1.col, 4 * p1.col)) AS p2;
 0      1  0  3
 0      1  1  4
 1      2  0  6
 1      2  1  8