A BaseRelation that can be used to insert data into it through the insert method.
If overwrite in insert method is true, the old data in the relation should be overwritten with
the new data. If overwrite in insert method is false, the new data should be appended.
InsertableRelation has the following three assumptions.
1. It assumes that the data (Rows in the DataFrame) provided to the insert method
exactly matches the ordinal of fields in the schema of the BaseRelation.
2. It assumes that the schema of this relation will not be changed.
Even if the insert method updates the schema (e.g. a relation of JSON or Parquet data may have a
schema update after an insert operation), the new schema will not be used.
3. It assumes that fields of the data provided in the insert method are nullable.
If a data source needs to check the actual nullability of a field, it needs to do it in the
insert method.
Annotations
@Stable()
Since
1.3.0
Linear Supertypes
AnyRef, Any
Ordering
Alphabetic
By Inheritance
Inherited
InsertableRelation
AnyRef
Any
Hide All
Show All
Visibility
Public
All
Abstract Value Members
abstract definsert(data: DataFrame, overwrite: Boolean): Unit
A BaseRelation that can be used to insert data into it through the insert method. If overwrite in insert method is true, the old data in the relation should be overwritten with the new data. If overwrite in insert method is false, the new data should be appended.
InsertableRelation has the following three assumptions. 1. It assumes that the data (Rows in the DataFrame) provided to the insert method exactly matches the ordinal of fields in the schema of the BaseRelation. 2. It assumes that the schema of this relation will not be changed. Even if the insert method updates the schema (e.g. a relation of JSON or Parquet data may have a schema update after an insert operation), the new schema will not be used. 3. It assumes that fields of the data provided in the insert method are nullable. If a data source needs to check the actual nullability of a field, it needs to do it in the insert method.
1.3.0