class DataFrameWriter extends AnyRef
Provides methods for writing data from a DataFrame to supported output destinations.
You can write data to the following locations:
- A Snowflake table
- A file on a stage
Saving Data to a Table
To use this object to write into a table:
- Access an instance of a DataFrameWriter by calling the DataFrame.write method.
- Specify the save mode to use (overwrite or append) by calling the mode method. This method returns a DataFrameWriter that is configured to save data using the specified mode. The default SaveMode is SaveMode.Append .
- (Optional) If you need to set some options for the save operation (e.g. columnOrder), call the options or option method.
-
Call a
saveAs*
method to save the data to the specified destination.
For example:
df.write.mode("overwrite").saveAsTable("T")
Saving Data to a File on a Stage
To save data to a file on a stage:
- Access an instance of a DataFrameWriter by calling the DataFrame.write method.
- Specify the save mode to use (Overwrite or ErrorIfExists) by calling the mode method. This method returns a DataFrameWriter that is configured to save data using the specified mode. The default SaveMode is SaveMode.ErrorIfExists for this case.
- (Optional) If you need to set some options for the save operation (e.g. file format options), call the options or option method.
- Call the method named after a file format to save the data in the specified format:
For example:
Example 1: Write a DataFrame to a CSV file.
val result = df.write.csv("@myStage/prefix")
Example 2: Write a DataFrame to a CSV file without compression.
val result = df.write.option("compression", "none").csv("@myStage/prefix")
- Since
-
0.1.0
- Alphabetic
- By Inheritance
- DataFrameWriter
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Value Members
-
final
def
!=
(
arg0:
Any
)
:
Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##
()
:
Int
- Definition Classes
- AnyRef → Any
-
final
def
==
(
arg0:
Any
)
:
Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf
[
T0
]
:
T0
- Definition Classes
- Any
-
def
async
:
DataFrameWriterAsyncActor
Returns a DataFrameWriterAsyncActor object that can be used to execute DataFrameWriter actions asynchronously.
Returns a DataFrameWriterAsyncActor object that can be used to execute DataFrameWriter actions asynchronously.
Example:
val asyncJob = df.write.mode(SaveMode.Overwrite).async.saveAsTable(tableName) // At this point, the thread is not blocked. You can perform additional work before // calling asyncJob.getResult() to retrieve the results of the action. // NOTE: getResult() is a blocking call. asyncJob.getResult()
- returns
-
A DataFrameWriterAsyncActor object
- Since
-
0.11.0
-
def
clone
()
:
AnyRef
- Attributes
- protected[ lang ]
- Definition Classes
- AnyRef
- Annotations
- @throws ( ... ) @native () @HotSpotIntrinsicCandidate ()
-
def
csv
(
path:
String
)
:
WriteFileResult
Saves the contents of the DataFrame to a CSV file on a stage.
Saves the contents of the DataFrame to a CSV file on a stage.
Example 1: Write a DataFrame to a CSV file.
val result = df.write.csv("@myStage/prefix")
Example 2: Write a DataFrame to a CSV file without compression.
val result = df.write.option("compression", "none").csv("@myStage/prefix")
- path
-
The path (including the stage name) to the CSV file.
- returns
- Since
-
1.5.0
-
final
def
eq
(
arg0:
AnyRef
)
:
Boolean
- Definition Classes
- AnyRef
-
def
equals
(
arg0:
Any
)
:
Boolean
- Definition Classes
- AnyRef → Any
-
final
def
getClass
()
:
Class
[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native () @HotSpotIntrinsicCandidate ()
-
def
hashCode
()
:
Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native () @HotSpotIntrinsicCandidate ()
-
final
def
isInstanceOf
[
T0
]
:
Boolean
- Definition Classes
- Any
-
def
json
(
path:
String
)
:
WriteFileResult
Saves the contents of the DataFrame to a JSON file on a stage.
Saves the contents of the DataFrame to a JSON file on a stage.
NOTE: You can call this method only on a DataFrame that contains a column of the type Variant, Array, or Map. If the DataFrame does not contain a column of one of these types, you must call the
to_variant
,array_construct
, orobject_construct
to return a DataFrame that contains a column of one of these types.Example 1: Write a DataFrame with one variant to a JSON file.
val result = session.sql("select to_variant('a')").write.json("@myStage/prefix")
Example 2: Transform a DataFrame with some columns with array_construct() and write to a JSON file without compression.
val df = Seq((1, 1.1, "a"), (2, 2.2, "b")).toDF("a", "b", "c") val df2 = df.select(array_construct(df.schema.names.map(df(_)): _*)) val result = df2.write.option("compression", "none").json("@myStage/prefix")
Example 3: Transform a DataFrame with some columns with object_construct() and write to a JSON file without compression.
val df = Seq((1, 1.1, "a"), (2, 2.2, "b")).toDF("a", "b", "c") val df2 = df.select(object_construct(df.schema.names.map(x => Seq(lit(x), df(x))).flatten: _*)) val result = df2.write.option("compression", "none").json("@myStage/prefix")
- path
-
The path (including the stage name) to the JSON file.
- returns
- Since
-
1.5.0
-
def
mode
(
saveMode:
SaveMode
)
:
DataFrameWriter
Returns a new DataFrameWriter with the specified save mode configuration.
Returns a new DataFrameWriter with the specified save mode configuration.
- saveMode
-
One of the following save modes: SaveMode.Append , SaveMode.Overwrite , SaveMode.ErrorIfExists , SaveMode.Ignore
- Since
-
0.1.0
-
def
mode
(
saveMode:
String
)
:
DataFrameWriter
Returns a new DataFrameWriter with the specified save mode configuration.
Returns a new DataFrameWriter with the specified save mode configuration.
- saveMode
-
One of the following strings:
"APPEND"
,"OVERWRITE"
,"ERRORIFEXISTS"
, or"IGNORE"
- Since
-
0.1.0
-
final
def
ne
(
arg0:
AnyRef
)
:
Boolean
- Definition Classes
- AnyRef
-
final
def
notify
()
:
Unit
- Definition Classes
- AnyRef
- Annotations
- @native () @HotSpotIntrinsicCandidate ()
-
final
def
notifyAll
()
:
Unit
- Definition Classes
- AnyRef
- Annotations
- @native () @HotSpotIntrinsicCandidate ()
-
def
option
(
key:
String
,
value:
Any
)
:
DataFrameWriter
Sets the specified option in the DataFrameWriter.
Sets the specified option in the DataFrameWriter.
Sets the specified option for saving data to a table
Use this method to configure options:
- columnOrder: save data into a table with table's column name order if saveMode is Append and target table exists.
Sets the specified option for saving data to a file on a stage
Use this method to configure options:
Note that you cannot use the
option
andoptions
methods to set the following options:-
The
TYPE
format type option. -
The
OVERWRITE
copy option. To set this option, use the mode method instead.-
To set
OVERWRITE
toTRUE
, useSaveMode.Overwrite
. -
To set
OVERWRITE
toFALSE
, useSaveMode.ErrorIfExists
.
-
To set
Example 1: Write a DataFrame to a CSV file.
val result = df.write.csv("@myStage/prefix")
Example 2: Write a DataFrame to a CSV file without compression.
val result = df.write.option("compression", "none").csv("@myStage/prefix")
- key
-
Name of the option.
- value
-
Value of the option.
- returns
- Since
-
1.4.0
-
def
options
(
configs:
Map
[
String
,
Any
]
)
:
DataFrameWriter
Sets multiple specified options in the DataFrameWriter.
Sets multiple specified options in the DataFrameWriter.
Sets the specified options for saving Data to a Table
Use this method to configure options:
- columnOrder: save data into a table with table's column name order if saveMode is Append and target table exists.
Sets the specified options for saving data to a file on a stage
Use this method to configure options:
Note that you cannot use the
option
andoptions
methods to set the following options:-
The
TYPE
format type option. -
The
OVERWRITE
copy option. To set this option, use the mode method instead.-
To set
OVERWRITE
toTRUE
, useSaveMode.Overwrite
. -
To set
OVERWRITE
toFALSE
, useSaveMode.ErrorIfExists
.
-
To set
Example 1: Write a DataFrame to a CSV file.
val result = df.write.csv("@myStage/prefix")
Example 2: Write a DataFrame to a CSV file without compression.
val result = df.write.option("compression", "none").csv("@myStage/prefix")
- configs
-
Map of the names of options (e.g.
compression
, etc.) and their corresponding values. - returns
- Since
-
1.5.0
-
def
parquet
(
path:
String
)
:
WriteFileResult
Saves the contents of the DataFrame to a Parquet file on a stage.
Saves the contents of the DataFrame to a Parquet file on a stage.
Example 1: Write a DataFrame to a parquet file.
val result = df.write.parquet("@myStage/prefix")
Example 2: Write a DataFrame to a Parquet file without compression.
val result = df.write.option("compression", "LZO").parquet("@myStage/prefix")
- path
-
The path (including the stage name) to the Parquet file.
- returns
- Since
-
1.5.0
-
def
saveAsTable
(
multipartIdentifier:
List
[
String
]
)
:
Unit
Writes the data to the specified table in a Snowflake database.
Writes the data to the specified table in a Snowflake database.
For example:
val list = new java.util.ArrayList[String](3) list.add(db) list.add(sc) list.add(tableName) df.write.saveAsTable(list)
- multipartIdentifier
-
A list of strings that specify the database name, schema name, and table name.
- Since
-
0.5.0
-
def
saveAsTable
(
multipartIdentifier:
Seq
[
String
]
)
:
Unit
Writes the data to the specified table in a Snowflake database.
Writes the data to the specified table in a Snowflake database.
For example:
df.write.saveAsTable(Seq("db_name", "schema_name", "table_name"))
- multipartIdentifier
-
A sequence of strings that specify the database name, schema name, and table name (e.g.
Seq("database_name", "schema_name", "table_name")
).
- Since
-
0.5.0
-
def
saveAsTable
(
tableName:
String
)
:
Unit
Writes the data to the specified table in a Snowflake database.
Writes the data to the specified table in a Snowflake database.
tableName
can be a fully-qualified object identifier.For example:
df.write.saveAsTable("db1.public_schema.table1")
- tableName
-
Name of the table where the data should be saved.
- Since
-
0.1.0
-
final
def
synchronized
[
T0
]
(
arg0: ⇒
T0
)
:
T0
- Definition Classes
- AnyRef
-
def
toString
()
:
String
- Definition Classes
- AnyRef → Any
-
final
def
wait
(
arg0:
Long
,
arg1:
Int
)
:
Unit
- Definition Classes
- AnyRef
- Annotations
- @throws ( ... )
-
final
def
wait
(
arg0:
Long
)
:
Unit
- Definition Classes
- AnyRef
- Annotations
- @throws ( ... ) @native ()
-
final
def
wait
()
:
Unit
- Definition Classes
- AnyRef
- Annotations
- @throws ( ... )
Deprecated Value Members
-
def
finalize
()
:
Unit
- Attributes
- protected[ lang ]
- Definition Classes
- AnyRef
- Annotations
- @throws ( classOf[java.lang.Throwable] ) @Deprecated
- Deprecated