Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs][3.3] Update documentation for Row Tracking to include Row Tracking Backfill introduced in Delta 3.3 #3969

Merged
merged 3 commits into from
Dec 13, 2024
Merged

[Docs][3.3] Update documentation for Row Tracking to include Row Tracking Backfill introduced in Delta 3.3 #3969

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3570804
Update wording
longvu-db Dec 12, 2024
5e214d9
Use available from
longvu-db Dec 12, 2024
d3c47c5
Remove limitation mode
longvu-db Dec 12, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions docs/source/delta-row-tracking.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Row tracking allows <Delta> to track row-level lineage in a <Delta> table. When

- **Row commit versions** record the last version of the table in which the row was modified. A row is assigned a new version whenever it is modified using a `MERGE` or `UPDATE` statement.

.. note:: This feature is available in <Delta> 3.2.0 and above. This feature is in experimental support mode with [_](#limitations).
.. note:: This feature is available in <Delta> 3.2.0 and above. Enabling this feature on existing non-empty tables is available in <Delta> 3.3.0 and above.

## Enable row tracking

Expand All @@ -37,7 +37,7 @@ You must explicitly enable row tracking using one of the following methods:
CREATE TABLE graduate CLONE student;
```

- **Existing table**: Set the table property `'delta.enableRowTracking' = 'true'` in the `ALTER TABLE` command.
- **Existing table**: Available from Delta 3.3 and above, set the table property `'delta.enableRowTracking' = 'true'` in the `ALTER TABLE` command.

```sql
ALTER TABLE grade SET TBLPROPERTIES ('delta.enableRowTracking' = 'true');
Expand Down Expand Up @@ -108,7 +108,6 @@ ALTER TABLE table_name SET TBLPROPERTIES (delta.enableRowTracking = false);
The following limitations exist:

- The row ids and row commit versions metadata fields cannot be accessed while reading the [Change data feed](/delta/delta-change-data-feed.md).
- Row Tracking can currently only be enabled when creating the table or when the table is empty. Enabling row tracking on a non-empty table is currently not supported.
- Once the Row Tracking feature is added to the table it cannot be removed without recreating the table.

.. <Delta> replace:: Delta Lake
Expand Down
Loading