withColumnRenamed

Возвращает новый кадр данных путем переименования существующего столбца. Это no-op, если схема не содержит заданного имени столбца.

Синтаксис

withColumnRenamed(existing: str, new: str)

Параметры

Параметр Тип Описание
existing str Имя существующего столбца, который необходимо переименовать.
new str Новое имя, назначенное столбцу.

Возвраты

DataFrame: новый кадр данных с переименованным столбцом.

Примеры

df = spark.createDataFrame([(2, "Alice"), (5, "Bob")], schema=["age", "name"])

df.withColumnRenamed("age", "age2").show()
# +----+-----+
# |age2| name|
# +----+-----+
# |   2|Alice|
# |   5|  Bob|
# +----+-----+

df.withColumnRenamed("non_existing", "new_name").show()
# +---+-----+
# |age| name|
# +---+-----+
# |  2|Alice|
# |  5|  Bob|
# +---+-----+

df.withColumnRenamed("age", "age2").withColumnRenamed("name", "name2").show()
# +----+-----+
# |age2|name2|
# +----+-----+
# |   2|Alice|
# |   5|  Bob|
# +----+-----+