modo (DataFrameWriter)

Especifica o comportamento quando já existem dados ou tabelas.

Sintaxe

mode(saveMode)

Parâmetros

Parâmetro Tipo Descrição
saveMode str O modo de gravação. Os valores aceites são 'append' (anexar aos dados existentes), 'overwrite' (sobrescrever dados existentes), 'error' ou 'errorifexists' (lançar uma exceção se existirem dados), e 'ignore' (saltar silenciosamente se existirem dados).

Devoluções

DataFrameWriter

Exemplos

Escreve um ficheiro Parquet de volta com vários modos e lê-o.

import tempfile
with tempfile.TemporaryDirectory(prefix="mode") as d:
    # Overwrite the path with a new Parquet file
    spark.createDataFrame(
        [{"age": 100, "name": "Alice"}]
    ).write.mode("overwrite").format("parquet").save(d)

    # Append another DataFrame into the Parquet file
    spark.createDataFrame(
        [{"age": 120, "name": "Sue"}]
    ).write.mode("append").format("parquet").save(d)

    # Read the Parquet file as a DataFrame.
    spark.read.parquet(d).show()
    # +---+-------------+
    # |age|         name|
    # +---+-------------+
    # |120| Sue          |
    # |100| Alice       |
    # +---+-------------+