This is an automated email from the ASF dual-hosted git repository.
etudenhoefner pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg.git
The following commit(s) were added to refs/heads/main by this push:
new 9bb86fa496 Docs: Fix spacing/descriptions on Branching and Tagging DDL
(#10091)
9bb86fa496 is described below
commit 9bb86fa496a798f360ae3353122b7e1e22e0a89d
Author: bering <[email protected]>
AuthorDate: Tue Apr 9 17:16:45 2024 +0900
Docs: Fix spacing/descriptions on Branching and Tagging DDL (#10091)
---
docs/docs/spark-ddl.md | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/docs/docs/spark-ddl.md b/docs/docs/spark-ddl.md
index 8b30710997..1d1dc695d1 100644
--- a/docs/docs/spark-ddl.md
+++ b/docs/docs/spark-ddl.md
@@ -478,10 +478,11 @@ Note that although the identifier is removed, the column
will still exist in the
#### `ALTER TABLE ... CREATE BRANCH`
Branches can be created via the `CREATE BRANCH` statement with the following
options:
+
* Do not fail if the branch already exists with `IF NOT EXISTS`
* Update the branch if it already exists with `CREATE OR REPLACE`
-* Create at a snapshot
-* Create with retention
+* Create a branch at a specific snapshot
+* Create a branch with a specified retention period
```sql
-- CREATE audit-branch at current snapshot with default retention.
@@ -497,7 +498,7 @@ ALTER TABLE prod.db.sample CREATE OR REPLACE BRANCH
`audit-branch`
ALTER TABLE prod.db.sample CREATE BRANCH `audit-branch`
AS OF VERSION 1234
--- CREATE audit-branch at snapshot 1234, retain audit-branch for 31 days, and
retain the latest 31 days. The latest 3 snapshot snapshots, and 2 days worth of
snapshots.
+-- CREATE audit-branch at snapshot 1234, retain audit-branch for 30 days, and
retain the latest 30 days. The latest 3 snapshot snapshots, and 2 days worth of
snapshots.
ALTER TABLE prod.db.sample CREATE BRANCH `audit-branch`
AS OF VERSION 1234 RETAIN 30 DAYS
WITH SNAPSHOT RETENTION 3 SNAPSHOTS 2 DAYS
@@ -506,10 +507,11 @@ WITH SNAPSHOT RETENTION 3 SNAPSHOTS 2 DAYS
#### `ALTER TABLE ... CREATE TAG`
Tags can be created via the `CREATE TAG` statement with the following options:
+
* Do not fail if the tag already exists with `IF NOT EXISTS`
* Update the tag if it already exists with `CREATE OR REPLACE`
-* Create at a snapshot
-* Create with retention
+* Create a tag at a specific snapshot
+* Create a tag with a specified retention period
```sql
-- CREATE historical-tag at current snapshot with default retention.
