Udostępnij przez


TableValuedFunction.inline

Eksploduje tablicę struktur w tabeli.

Ta funkcja przyjmuje kolumnę wejściową zawierającą tablicę struktur i zwraca nową kolumnę, w której każda struktura tablicy jest eksplodowana w osobnym wierszu.

Składnia

spark.tvf.inline(input)

Parametry

Parameter Typ Description
input pyspark.sql.Column Kolumna wejściowa wartości do eksplodowania.

Zwraca

pyspark.sql.DataFrame: Ramka danych z eksplodowanym wierszem struktury.

Przykłady

Przykład 1: Używanie wbudowanej tablicy z jedną tablicą struktur

import pyspark.sql.functions as sf
spark.tvf.inline(sf.array(
    sf.named_struct(sf.lit("a"), sf.lit(1), sf.lit("b"), sf.lit(2)),
    sf.named_struct(sf.lit("a"), sf.lit(3), sf.lit("b"), sf.lit(4))
)).show()
+---+---+
|  a|  b|
+---+---+
|  1|  2|
|  3|  4|
+---+---+

Przykład 2: Używanie wbudowanej kolumny tablicy struktury pustej

import pyspark.sql.functions as sf
spark.tvf.inline(sf.array().astype("array<struct<a:int,b:int>>")).show()
+---+---+
|  a|  b|
+---+---+
+---+---+

Przykład 3. Użycie wbudowanej kolumny tablicy struktury zawierającej wartości null

import pyspark.sql.functions as sf
spark.tvf.inline(sf.array(
    sf.named_struct(sf.lit("a"), sf.lit(1), sf.lit("b"), sf.lit(2)),
    sf.lit(None),
    sf.named_struct(sf.lit("a"), sf.lit(3), sf.lit("b"), sf.lit(4))
)).show()
+----+----+
|   a|   b|
+----+----+
|   1|   2|
|NULL|NULL|
|   3|   4|
+----+----+