asc_nulls_first

指定された列名の昇順に基づいて並べ替え式を返します。null 値は非 null 値の前に返されます。Spark Connect をサポートします。

構文

Python

from pyspark.databricks.sql import functions as dbf

dbf.asc_nulls_first(col=<col>)

パラメーター

パラメーター	Type	説明
col	pyspark.sql.Column または str	ターゲットカラムを昇順に並べ替えます。

戻り値

pyspark.sql.Column: 順序を指定する列。

例

例 1 : null 値を持つ DataFrame を昇順で並べ替えます。

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(1, "Bob"), (0, None), (2, "Alice")], ["age", "name"])
df.sort(dbf.asc_nulls_first(df.name)).show()

Output

+---+-----+
|age| name|
+---+-----+
|  0| NULL|
|  2|Alice|
|  1|  Bob|
+---+-----+

例 2 : 列名文字列を使用して、null 値を持つ DataFrame を昇順で並べ替えます。

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(1, "Bob"), (0, None), (2, "Alice")], ["age", "name"])
df.sort(dbf.asc_nulls_first("name")).show()

Output

+---+-----+
|age| name|
+---+-----+
|  0| NULL|
|  2|Alice|
|  1|  Bob|
+---+-----+