This is an automated email from the ASF dual-hosted git repository.
lzljs3620320 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/paimon.git
The following commit(s) were added to refs/heads/master by this push:
new 798bec8600 [doc] Document ignoreIfExists for create_branch
798bec8600 is described below
commit 798bec86004974a94fd0502db9a9c4ad27c2429b
Author: JingsongLi <[email protected]>
AuthorDate: Sat Mar 7 14:24:00 2026 +0800
[doc] Document ignoreIfExists for create_branch
---
docs/content/flink/procedures.md | 13 +++----------
docs/content/spark/procedures.md | 1 +
2 files changed, 4 insertions(+), 10 deletions(-)
diff --git a/docs/content/flink/procedures.md b/docs/content/flink/procedures.md
index 38bef4ab63..739e3d4754 100644
--- a/docs/content/flink/procedures.md
+++ b/docs/content/flink/procedures.md
@@ -760,21 +760,14 @@ All available procedures are listed below.
<tr>
<td>create_branch</td>
<td>
- -- Use named argument<br/>
CALL [catalog.]sys.create_branch(`table` => 'identifier', branch =>
'branchName', tag => 'tagName')<br/><br/>
- -- Use indexed argument<br/>
- -- based on the specified tag <br/>
- CALL [catalog.]sys.create_branch('identifier', 'branchName',
'tagName')<br/>
- -- based on the specified branch's tag <br/>
- CALL [catalog.]sys.create_branch('branch_table', 'branchName',
'tagName')<br/>
- -- create empty branch <br/>
- CALL [catalog.]sys.create_branch('identifier', 'branchName')
</td>
<td>
To create a branch based on given tag, or just create empty branch.
Arguments:
<li>table: the target table identifier or branch identifier.
Cannot be empty.</li>
- <li>branchName: name of the new branch.</li>
- <li>tagName: name of the tag which the new branch is based on.</li>
+ <li>branch: name of the new branch.</li>
+ <li>tag: name of the tag which the new branch is based on.</li>
+ <li>ignoreIfExists: ignore if branch exists, default is false.</li>
</td>
<td>
CALL sys.create_branch(`table` => 'default.T', branch => 'branch1',
tag => 'tag1')<br/>
diff --git a/docs/content/spark/procedures.md b/docs/content/spark/procedures.md
index 089b0ea7fc..29ad120eab 100644
--- a/docs/content/spark/procedures.md
+++ b/docs/content/spark/procedures.md
@@ -298,6 +298,7 @@ This section introduce all available spark procedures about
paimon.
<li>table: the target table identifier or branch identifier.
Cannot be empty.</li>
<li>branch: name of the branch to be merged.</li>
<li>tag: name of the new tag. Cannot be empty.</li>
+ <li>ignoreIfExists: ignore if branch exists, default is false.</li>
</td>
<td>
CALL sys.create_branch(table => 'test_db.T', branch =>
'test_branch')<br/><br/>
