Skip to main content
`Ctrl`+`K`

# 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_identifier str

      Table identifier.

    catalog_name str, optional

      The name of the catalog.

    catalog_properties dict of {str: str}, optional

      The properties that are used next to the catalog configuration.

    location str, optional

      Location for the table.

    append bool, default False

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

    snapshot_properties dict 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")