DataFrame を TableArg オブジェクトに変換します。このオブジェクトは、UDTF (User-Defined Table Function) を含む TVF (Table-Valued 関数) のテーブル引数として使用できます。
構文
asTable()
返品
TableArg: テーブル引数を表す TableArg オブジェクト。
メモ
このメソッドを使用して DataFrame から TableArg を取得した後、partitionBy インスタンスでorderBy、withSinglePartition、TableArgなどのメソッドを呼び出すことによって、テーブル引数のパーティション分割と順序付けを指定できます。
例示
from pyspark.sql.functions import udtf
@udtf(returnType="id: int, doubled: int")
class DoubleUDTF:
def eval(self, row):
yield row["id"], row["id"] * 2
df = spark.createDataFrame([(1,), (2,), (3,)], ["id"])
result = DoubleUDTF(df.asTable())
result.show()
# +---+-------+
# | id|doubled|
# +---+-------+
# | 1| 2|
# | 2| 4|
# | 3| 6|
# +---+-------+
df2 = spark.createDataFrame(
[(1, "a"), (1, "b"), (2, "c"), (2, "d")], ["key", "value"]
)
@udtf(returnType="key: int, value: string")
class ProcessUDTF:
def eval(self, row):
yield row["key"], row["value"]
result2 = ProcessUDTF(df2.asTable().partitionBy("key").orderBy("value"))
result2.show()
# +---+-----+
# |key|value|
# +---+-----+
# | 1| a|
# | 1| b|
# | 2| c|
# | 2| d|
# +---+-----+