This is an automated email from the ASF dual-hosted git repository.
zclll pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 39b66cf832a [doc](function) add doc for is_uuid (#3015)
39b66cf832a is described below
commit 39b66cf832a82a38fc00d96ce19349de28614644
Author: admiring_xm <[email protected]>
AuthorDate: Fri Oct 31 17:19:41 2025 +0800
[doc](function) add doc for is_uuid (#3015)
## Versions
- [x] dev
- [ ] 3.x
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../scalar-functions/string-functions/is-uuid.md | 99 ++++++++++++++++++++++
.../scalar-functions/string-functions/is-uuid.md | 98 +++++++++++++++++++++
sidebars.json | 1 +
3 files changed, 198 insertions(+)
diff --git
a/docs/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
b/docs/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
new file mode 100644
index 00000000000..3792314a0b7
--- /dev/null
+++ b/docs/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
@@ -0,0 +1,99 @@
+---
+{
+ "title": "IS_UUID",
+ "language": "en"
+}
+---
+
+## Description
+
+If the parameter is a valid UUID, return 1. If it is an invalid UUID, return
0. If the parameter is NULL, return NULL.
+
+A UUID is considered valid if its length is correct and it contains only
permitted characters (hexadecimal digits in any case, along with optional
hyphens and curly brackets). It can be summarised as one of the following three
formats:
+```text
+aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
+aaaaaaaabbbbccccddddeeeeeeeeeeee
+{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}
+```
+
+## Syntax
+
+```sql
+IS_UUID ( <str> )
+```
+
+## Parameters
+| Parameter | Description |
+|------------|-----------------|
+| `<str>` | a string |
+
+
+## Return Value
+
+`<str>` is a valid UUID, returns 1; otherwise returns 0.
+
+Special cases:
+- If the parameter is NULL, returns NULL.
+
+## Examples
+
+
+```sql
+select is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1");
+```
+
+```text
++-------------------------------------------------+
+| is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1") |
++-------------------------------------------------+
+| 1 |
++-------------------------------------------------+
+```
+
+```sql
+select is_uuid("{88a06b4a-732c-48bd-9984-fecb81285cc1}");
+```
+
+```text
++-------------------------------------------------+
+| is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1") |
++-------------------------------------------------+
+| 1 |
++-------------------------------------------------+
+```
+
+```sql
+select is_uuid("88a06b4a732c48bd9984fecb81285cc1");
+```
+
+```text
++---------------------------------------------+
+| is_uuid("88a06b4a732c48bd9984fecb81285cc1") |
++---------------------------------------------+
+| 1 |
++---------------------------------------------+
+```
+
+```sql
+select is_uuid("{88a06b4a732c48bd9984fecb81285cc1}");
+```
+
+```text
++-----------------------------------------------+
+| is_uuid("{88a06b4a732c48bd9984fecb81285cc1}") |
++-----------------------------------------------+
+| 0 |
++-----------------------------------------------+
+```
+
+```sql
+select is_uuid(NULL);
+```
+
+```text
++---------------+
+| is_uuid(NULL) |
++---------------+
+| NULL |
++---------------+
+```
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
new file mode 100644
index 00000000000..b725b5e5637
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/is-uuid.md
@@ -0,0 +1,98 @@
+---
+{
+ "title": "IS_UUID",
+ "language": "zh-CN"
+}
+---
+
+## 描述
+
+如果参数是一个有效的uuid，返回1。如果是一个无效的uuid，返回0。参数为NULL，则返回NULL。
+
+一个uuid被称为有效，即其长度正确且仅包含允许的字符（任意大小写的十六进制数字，以及可选的连字符和花括号）。可概括为以下三种格式之一：
+
+```text
+aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
+aaaaaaaabbbbccccddddeeeeeeeeeeee
+{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}
+```
+
+## 语法
+
+```sql
+IS_UUID ( <str> )
+```
+## 参数
+
+| 参数 | 说明 |
+|-------|--------------|
+| `<str>` | 一个字符串 |
+
+## 返回值
+
+`<str>` 为有效的uuid，返回1，否则返回0。
+
+特殊情况：
+- 如果参数为 NULL，返回 NULL
+
+## 示例
+
+```sql
+select is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1");
+```
+
+```text
++-------------------------------------------------+
+| is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1") |
++-------------------------------------------------+
+| 1 |
++-------------------------------------------------+
+```
+
+```sql
+select is_uuid("{88a06b4a-732c-48bd-9984-fecb81285cc1}");
+```
+
+```text
++-------------------------------------------------+
+| is_uuid("88a06b4a-732c-48bd-9984-fecb81285cc1") |
++-------------------------------------------------+
+| 1 |
++-------------------------------------------------+
+```
+
+```sql
+select is_uuid("88a06b4a732c48bd9984fecb81285cc1");
+```
+
+```text
++---------------------------------------------+
+| is_uuid("88a06b4a732c48bd9984fecb81285cc1") |
++---------------------------------------------+
+| 1 |
++---------------------------------------------+
+```
+
+```sql
+select is_uuid("{88a06b4a732c48bd9984fecb81285cc1}");
+```
+
+```text
++-----------------------------------------------+
+| is_uuid("{88a06b4a732c48bd9984fecb81285cc1}") |
++-----------------------------------------------+
+| 0 |
++-----------------------------------------------+
+```
+
+```sql
+select is_uuid(NULL);
+```
+
+```text
++---------------+
+| is_uuid(NULL) |
++---------------+
+| NULL |
++---------------+
+```
\ No newline at end of file
diff --git a/sidebars.json b/sidebars.json
index 3da6786fff6..f30e9870c97 100644
--- a/sidebars.json
+++ b/sidebars.json
@@ -1298,6 +1298,7 @@
"sql-manual/sql-functions/scalar-functions/string-functions/initcap",
"sql-manual/sql-functions/scalar-functions/string-functions/instr",
"sql-manual/sql-functions/scalar-functions/string-functions/int-to-uuid",
+
"sql-manual/sql-functions/scalar-functions/string-functions/is-uuid",
"sql-manual/sql-functions/scalar-functions/string-functions/lcase",
"sql-manual/sql-functions/scalar-functions/string-functions/length",
"sql-manual/sql-functions/scalar-functions/string-functions/locate",
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
