無安定

DataFrame を TableArg オブジェクトに変換します。このオブジェクトは、UDTF (User-Defined Table Function) を含む TVF (Table-Valued 関数) のテーブル引数として使用できます。

構文

asTable()

返品

TableArg: テーブル引数を表す TableArg オブジェクト。

メモ

このメソッドを使用して DataFrame から TableArg を取得した後、partitionBy インスタンスでorderBywithSinglePartitionTableArgなどのメソッドを呼び出すことによって、テーブル引数のパーティション分割と順序付けを指定できます。

例示

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|
# +---+-----+