pandas.DataFrame.to_iceberg

DataFrame.to_iceberg(table_identifier, catalog_name=None, *, catalog_properties=None, location=None, append=False, snapshot_properties=None)

Write a DataFrame to an Apache Iceberg table.

Added in version 3.0.0.

Warning

to_iceberg is experimental and may change without warning.

Parameters:

table_identifierstr

Table identifier.

catalog_namestr, optional

The name of the catalog.

catalog_propertiesdict of {str: str}, optional

The properties that are used next to the catalog configuration.

locationstr, optional

Location for the table.

appendbool, default False

If True, append data to the table, instead of replacing the content.

snapshot_propertiesdict of {str: str}, optional

Custom properties to be added to the snapshot summary

See also

read_iceberg

Read an Apache Iceberg table.

DataFrame.to_parquet

Write a DataFrame in Parquet format.

Examples

>>> df = pd.DataFrame(data={"col1": [1, 2], "col2": [4, 3]})
>>> df.to_iceberg("my_table", catalog_name="my_catalog")