diff --git a/docs/source/delta-uniform.md b/docs/source/delta-uniform.md index b95221ef409..8dacb01f591 100644 --- a/docs/source/delta-uniform.md +++ b/docs/source/delta-uniform.md @@ -61,13 +61,25 @@ CREATE TABLE T(c1 INT) USING DELTA TBLPROPERTIES( 'delta.universalFormat.enabledFormats' = 'iceberg'); ``` -You can enable UniForm Iceberg on an existing table using the following syntax: +In Delta 3.3 and above, you can enable or upgrade UniForm Iceberg on an existing table using the following syntax: +```sql +ALTER TABLE table_name SET TBLPROPERTIES( + 'delta.enableIcebergCompatV2' = 'true', + 'delta.universalFormat.enabledFormats' = 'iceberg'); +``` + +You can also use REORG to enable UniForm Iceberg and rewrite underlying data files, as in the following example: ```sql REORG TABLE table_name APPLY (UPGRADE UNIFORM(ICEBERG_COMPAT_VERSION=2)); ``` +Use REORG if any of following are true: +* Your table has deletion vectors enabled. +* You previously enabled the IcebergCompatV1 version of UniForm Iceberg. +* You need to read from Iceberg engines that don't support Hive-style Parquet files, such as Athena or Redshift. + You can enable UniForm Hudi on an existing table using the following syntax: ```sql @@ -156,4 +168,4 @@ The following features work for Delta clients when UniForm is enabled, b - Delta Sharing .. replace:: Delta Lake -.. replace:: Apache Spark \ No newline at end of file +.. replace:: Apache Spark