withColumnsRenamed

Retourne un nouveau DataFrame en renommant plusieurs colonnes. Il s’agit d’un no-op si le schéma ne contient pas les noms de colonnes donnés.

Syntaxe

withColumnsRenamed(colsMap: Dict[str, str])

Paramètres

Paramètre Type Description
colsMap dictionnaire dictée des noms de colonnes existants et des noms de colonnes souhaités correspondants. Actuellement, une seule carte est prise en charge.

Retours

DataFrame: DataFrame avec des colonnes renommées.

Exemples

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

df.withColumnsRenamed({"age": "age2"}).show()
# +----+-----+
# |age2| name|
# +----+-----+
# |   2|Alice|
# |   5|  Bob|
# +----+-----+

df.withColumnsRenamed({"age": "age2", "name": "name2"}).show()
# +----+-----+
# |age2|name2|
# +----+-----+
# |   2|Alice|
# |   5|  Bob|
# +----+-----+

df.withColumnsRenamed({"non_existing": "new_name"}).show()
# +---+-----+
# |age| name|
# +---+-----+
# |  2|Alice|
# |  5|  Bob|
# +---+-----+