Skip to content

Commit

Permalink
Update Delta uniform documentation to include ALTER enabling - 3.3 (#…
Browse files Browse the repository at this point in the history
…3963)

<!--
Thanks for sending a pull request!  Here are some tips for you:
1. If this is your first time, please read our contributor guidelines:
https://github.com/delta-io/delta/blob/master/CONTRIBUTING.md
2. If the PR is unfinished, add '[WIP]' in your PR title, e.g., '[WIP]
Your PR title ...'.
  3. Be sure to keep the PR description updated to reflect all changes.
  4. Please write your PR title to summarize what this PR proposes.
5. If possible, provide a concise example to reproduce the issue for a
faster review.
6. If applicable, include the corresponding issue number in the PR title
and link it in the body.
-->

#### Which Delta project/connector is this regarding?
<!--
Please add the component selected below to the beginning of the pull
request title
For example: [Spark] Title of my pull request
-->

- [ ] Spark
- [ ] Standalone
- [ ] Flink
- [ ] Kernel
- [x] Other (fill in here)

## Description

Update Delta uniform documentation to include ALTER enabling
  • Loading branch information
lzlfred authored Dec 19, 2024
1 parent 6177288 commit fb3fd94
Showing 1 changed file with 14 additions and 2 deletions.
16 changes: 14 additions & 2 deletions docs/source/delta-uniform.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -156,4 +168,4 @@ The following <Delta> features work for Delta clients when UniForm is enabled, b
- Delta Sharing

.. <Delta> replace:: Delta Lake
.. <AS> replace:: Apache Spark
.. <AS> replace:: Apache Spark

0 comments on commit fb3fd94

Please sign in to comment.