Collection.write_delta#

Collection.write_delta(target: str | Path | deltalake.DeltaTable, **kwargs: Any) → None[source]#

Write the members of this collection to Delta Lake tables.

This method writes each member to a Delta Lake table at the provided target location. The target can be a path, URI, or an existing DeltaTable object. No table is written for optional members which are not provided in the current collection.

Parameters:

  • target – The location or DeltaTable where the data should be written. If the location does not exist, it is created automatically, including all of its parents.

  • kwargs – Additional keyword arguments passed to polars.DataFrame.write_delta().

Attention

Schema metadata is stored as custom commit metadata. Only the schema information from the last commit is used, so any table modifications that are not through dataframely will result in losing the metadata.

Be aware that appending to an existing table via mode=”append” may result in violation of group constraints that dataframely cannot catch without re-validating. Only use appends if you are certain that they do not break your schema.

This method suffers from the same limitations as serialize().