Функция генератора табличных значений inline_outer
Область применения: Databricks SQL Databricks Runtime
Разворачивает массив структур в таблицу с семантикой OUTER
.
В Databricks Runtime 16.1 и выше эта функция поддерживает вызов именованных параметров.
Синтаксис
inline_outer(input)
Аргументы
-
input
: выражение STRUCT < МАССИВа>.
Набор строк, состоящих из полей в элементах структуры массива input
.
Столбцы, созданные по inline
именам полей.
Если input
имеется NULL
одна строка с NULL
s для каждого столбца, создается.
Применимо к: Databricks Runtime 12.1 и более ранних версий:
inline_outer
можно поместить только в списокSELECT
в качестве корневого элемента выражения или после LATERAL VIEW. При размещении функции в спискеSELECT
не должно быть другой функции генератора в том жеSELECT
списке или UNSUPPORTED_GENERATOR. MULTI_GENERATOR вызывается.Применимо к: Databricks SQL Databricks Runtime 12.2 LTS и выше:
Вызов из предложения LATERAL VIEW или списка
SELECT
не рекомендуется. Вместо этого вызовитеinline_outer
как table_reference.
Примеры
Применимо к: Databricks Runtime 12.1 и более ранних версий:
> SELECT inline_outer(array(struct(1, 'a'), struct(2, 'b'))), 'Spark SQL';
1 a Spark SQL
2 b Spark SQL
> SELECT inline_outer(array(struct(1, 'a'), struct(1, 'b'))),
inline_outer(array(struct('c', 1.0), struct('d', 2.0))),
'Spark SQL';
1 a Spark SQL
2 b Spark SQL
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
Применимо к: Databricks SQL Databricks Runtime 12.2 LTS и выше:
> SELECT i.*, 'Spark SQL'
FROM inline_outer(array(struct(1, 'a'), struct(2, 'b'))) AS i;
1 a Spark SQL
2 b Spark SQL
> SELECT i1.*, i2.*, 'Spark SQL'
FROM inline_outer(array(struct(1, 'a'), struct(1, 'b'))) AS i1,
inline_outer(array(struct('c', 1.0), struct('d', 2.0))) AS i2;
1 a c 1.0 Spark SQL
1 b c 1.0 Spark SQL
1 a d 2.0 Spark SQL
1 b d 2.0 Spark SQL