Compartilhar via


withColumnsRenamed

Retorna um novo DataFrame renomeando várias colunas. Esse é um no-op se o esquema não contiver os nomes de coluna especificados.

Sintaxe

withColumnsRenamed(colsMap: Dict[str, str])

Parâmetros

Parâmetro Tipo Descrição
colsMap dicionário Um ditado de nomes de coluna existentes e nomes de colunas desejados correspondentes. Atualmente, há suporte apenas para um único mapa.

Devoluções

DataFrame: DataFrame com colunas renomeada.

Exemplos

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