posexplode_outer
функция генератора с табличным значением
Область применения: Databricks SQL Databricks Runtime
Возвращает строки путем отмены вложенности массива с нумерацией позиций с использованием семантики OUTER
.
Начиная с версии Databricks Runtime 16.1 эта функция поддерживает вызов именованных параметров .
Синтаксис
posexplode_outer(collection)
Аргументы
-
collection
: выражение ARRAY или MAP.
Возвраты
Набор строк, состоящих из позиции и элементов массива или ключей и значений карты.
Столбцы, производимые частью массива posexplode_outer
, называются pos
и col
.
Столбцы карты называются pos
, key
и value
.
Если collection
равно NULL
, одна строка с NULL значениями для массива или карты.
Применимо к: Databricks Runtime 12.1 и более ранних версий:
posexplode_outer
можно поместить только в списокSELECT
в качестве корневого элемента выражения либо после LATERAL VIEW. При помещении функции в список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