This is an automated email from the ASF dual-hosted git repository.
morningman 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 d7c7a85f4306 [docs] Add URL functions chapter across active versions
and locales (#4631)
d7c7a85f4306 is described below
commit d7c7a85f4306aa0de5ac47c711712b760512ee6e
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Fri Nov 13 08:04:55 2026 +0800
[docs] Add URL functions chapter across active versions and locales (#4631)
URL parsing, domain extraction, and URL encoding functions are mixed
into String Functions, which makes them harder to find. Add a separate
URL Functions chapter with an English and Chinese overview, and group
the ten existing function pages under it in Dev, 4.x, and 3.x.
The function document IDs and URLs stay stable. Existing String
Functions overview pages link to the new chapter, and Chinese sidebar
labels are translated consistently in all three active versions.
Validation: parsed all edited sidebar/translation JSON; evaluated the
TypeScript sidebar; verified each URL chapter has exactly eleven unique
entries, with matching English/Chinese files; checked all sixty overview
links and `git diff --check`. No full site build or SQL runtime test was
needed for this navigation change.
Fixes #2175
Co-authored-by: morningman <[email protected]>
---
.../scalar-functions/string-functions/overview.md | 2 ++
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
.../docusaurus-plugin-content-docs/current.json | 4 ++++
.../scalar-functions/string-functions/overview.md | 2 ++
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
.../version-3.x.json | 4 ++++
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
.../version-4.x.json | 4 ++++
.../scalar-functions/string-functions/overview.md | 2 ++
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
sidebars.ts | 27 ++++++++++++++--------
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
.../scalar-functions/string-functions/overview.md | 2 ++
.../scalar-functions/url-functions/overview.md | 24 +++++++++++++++++++
versioned_sidebars/version-3.x-sidebars.json | 27 ++++++++++++++--------
versioned_sidebars/version-4.x-sidebars.json | 27 ++++++++++++++--------
16 files changed, 215 insertions(+), 30 deletions(-)
diff --git
a/docs/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
b/docs/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
index 3bdaaf781c74..4ce7c7845b12 100644
---
a/docs/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
+++
b/docs/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
@@ -10,6 +10,8 @@
String functions are built-in functions used to process and manipulate string
data. They help perform various string operations, such as concatenation,
splitting, replacement, searching, etc.
+For URL parsing, domain extraction, and URL encoding or decoding, see [URL
Functions](../url-functions/overview.md).
+
## UTF-8 Encoding Support
UTF-8 encoding is a variable-length character encoding that can represent
almost all characters in the world, including Cyrillic, Greek, Chinese
characters, emojis, and more.
diff --git
a/docs/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/docs/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..c3de6f8abf3c
--- /dev/null
+++ b/docs/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL Functions Overview",
+ "language": "en",
+ "description": "Find functions for extracting URL components, processing
domains, and encoding or decoding URL strings."
+}
+---
+
+# URL Functions Overview
+
+URL functions extract components such as domains, protocols, and query
parameters, or encode and decode URL strings. Use the function reference pages
below for syntax, input requirements, and examples.
+
+| Function | Purpose |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | Extract the domain from a URL. |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | Extract
the domain and remove a leading `www.`. |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | Extract the
top-level domain. |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| Extract the first significant subdomain. |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| Keep the domain up to the first significant subdomain. |
+| [PROTOCOL](../string-functions/protocol.md) | Extract the protocol from a
URL. |
+| [PARSE_URL](../string-functions/parse-url.md) | Extract a specified URL
component. |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
Extract a named URL query parameter. |
+| [URL_ENCODE](../string-functions/url-encode.md) | Encode a string for use in
a URL. |
+| [URL_DECODE](../string-functions/url-decode.md) | Decode a URL-encoded
string. |
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
b/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
index 57d1e0d93c9b..ad4993c51c7c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
@@ -479,6 +479,10 @@
"message": "字符串函数",
"description": "The label for category String Functions in sidebar docs"
},
+ "sidebar.docs.category.URL Functions": {
+ "message": "URL 函数",
+ "description": "The label for category URL Functions in sidebar docs"
+ },
"sidebar.docs.category.Date Functions": {
"message": "时间日期函数",
"description": "The label for category Date Functions in sidebar docs"
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
index 789a980d9a0d..2fa896667368 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
@@ -10,6 +10,8 @@
字符串函数是用于处理和操作字符串数据的内置函数。它们可以帮助我们执行各种字符串操作，如连接、分割、替换、查找等。
+URL 解析、域名提取和 URL 编解码函数见 [URL 函数](../url-functions/overview.md)。
+
## UTF-8 编码支持
UTF-8编码是一种变长的字符编码方式，可以表示世界上几乎所有的字符，包括西里尔字母、希腊字母、汉字、表情等。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..4aaa50dc2c56
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL 函数概述",
+ "language": "zh-CN",
+ "description": "查找用于提取 URL 组成部分、处理域名以及进行 URL 编解码的函数。"
+}
+---
+
+# URL 函数概述
+
+URL 函数用于提取域名、协议、查询参数等组成部分，或对 URL 字符串进行编码和解码。各函数的语法、输入要求和示例见下表中的参考页面。
+
+| 函数 | 用途 |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | 提取 URL 中的域名。 |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | 提取域名并去掉开头的
`www.`。 |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | 提取顶级域名。 |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| 提取第一个有效子域名。 |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| 保留从顶级域名到第一个有效子域名的部分。 |
+| [PROTOCOL](../string-functions/protocol.md) | 提取 URL 的协议部分。 |
+| [PARSE_URL](../string-functions/parse-url.md) | 提取指定的 URL 组成部分。 |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
提取指定名称的 URL 查询参数。 |
+| [URL_ENCODE](../string-functions/url-encode.md) | 对字符串进行 URL 编码。 |
+| [URL_DECODE](../string-functions/url-decode.md) | 对经过 URL 编码的字符串进行解码。 |
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x.json
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x.json
index 0258d95aaf29..a3031d0b8a9d 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x.json
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x.json
@@ -387,6 +387,10 @@
"message": "字符串函数",
"description": "The label for category String Functions in sidebar docs"
},
+ "sidebar.docs.category.URL Functions": {
+ "message": "URL 函数",
+ "description": "The label for category URL Functions in sidebar docs"
+ },
"sidebar.docs.category.Date Functions": {
"message": "时间日期函数",
"description": "The label for category Date Functions in sidebar docs"
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..4aaa50dc2c56
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL 函数概述",
+ "language": "zh-CN",
+ "description": "查找用于提取 URL 组成部分、处理域名以及进行 URL 编解码的函数。"
+}
+---
+
+# URL 函数概述
+
+URL 函数用于提取域名、协议、查询参数等组成部分，或对 URL 字符串进行编码和解码。各函数的语法、输入要求和示例见下表中的参考页面。
+
+| 函数 | 用途 |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | 提取 URL 中的域名。 |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | 提取域名并去掉开头的
`www.`。 |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | 提取顶级域名。 |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| 提取第一个有效子域名。 |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| 保留从顶级域名到第一个有效子域名的部分。 |
+| [PROTOCOL](../string-functions/protocol.md) | 提取 URL 的协议部分。 |
+| [PARSE_URL](../string-functions/parse-url.md) | 提取指定的 URL 组成部分。 |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
提取指定名称的 URL 查询参数。 |
+| [URL_ENCODE](../string-functions/url-encode.md) | 对字符串进行 URL 编码。 |
+| [URL_DECODE](../string-functions/url-decode.md) | 对经过 URL 编码的字符串进行解码。 |
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
index 7584b5e2a3bd..6810d6600094 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
@@ -467,6 +467,10 @@
"message": "字符串函数",
"description": "The label for category String Functions in sidebar docs"
},
+ "sidebar.docs.category.URL Functions": {
+ "message": "URL 函数",
+ "description": "The label for category URL Functions in sidebar docs"
+ },
"sidebar.docs.category.Date Functions": {
"message": "时间日期函数",
"description": "The label for category Date Functions in sidebar docs"
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
index 789a980d9a0d..2fa896667368 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
@@ -10,6 +10,8 @@
字符串函数是用于处理和操作字符串数据的内置函数。它们可以帮助我们执行各种字符串操作，如连接、分割、替换、查找等。
+URL 解析、域名提取和 URL 编解码函数见 [URL 函数](../url-functions/overview.md)。
+
## UTF-8 编码支持
UTF-8编码是一种变长的字符编码方式，可以表示世界上几乎所有的字符，包括西里尔字母、希腊字母、汉字、表情等。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..4aaa50dc2c56
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL 函数概述",
+ "language": "zh-CN",
+ "description": "查找用于提取 URL 组成部分、处理域名以及进行 URL 编解码的函数。"
+}
+---
+
+# URL 函数概述
+
+URL 函数用于提取域名、协议、查询参数等组成部分，或对 URL 字符串进行编码和解码。各函数的语法、输入要求和示例见下表中的参考页面。
+
+| 函数 | 用途 |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | 提取 URL 中的域名。 |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | 提取域名并去掉开头的
`www.`。 |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | 提取顶级域名。 |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| 提取第一个有效子域名。 |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| 保留从顶级域名到第一个有效子域名的部分。 |
+| [PROTOCOL](../string-functions/protocol.md) | 提取 URL 的协议部分。 |
+| [PARSE_URL](../string-functions/parse-url.md) | 提取指定的 URL 组成部分。 |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
提取指定名称的 URL 查询参数。 |
+| [URL_ENCODE](../string-functions/url-encode.md) | 对字符串进行 URL 编码。 |
+| [URL_DECODE](../string-functions/url-decode.md) | 对经过 URL 编码的字符串进行解码。 |
diff --git a/sidebars.ts b/sidebars.ts
index 19d6b10cc80d..ef0c19dd5c15 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -1597,20 +1597,15 @@ const sidebars: SidebarsConfig = {
'sql-manual/sql-functions/scalar-functions/string-functions/concat-ws',
'sql-manual/sql-functions/scalar-functions/string-functions/compress',
'sql-manual/sql-functions/scalar-functions/string-functions/count_substrings',
-
'sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain',
'sql-manual/sql-functions/scalar-functions/string-functions/damerau_levenshtein_distance',
'sql-manual/sql-functions/scalar-functions/string-functions/decode',
'sql-manual/sql-functions/scalar-functions/string-functions/digital-masking',
-
'sql-manual/sql-functions/scalar-functions/string-functions/domain',
-
'sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www',
'sql-manual/sql-functions/scalar-functions/string-functions/encode',
'sql-manual/sql-functions/scalar-functions/string-functions/ends-with',
'sql-manual/sql-functions/scalar-functions/string-functions/export-set',
'sql-manual/sql-functions/scalar-functions/string-functions/elt',
-
'sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter',
'sql-manual/sql-functions/scalar-functions/string-functions/from-base64',
'sql-manual/sql-functions/scalar-functions/string-functions/find-in-set',
-
'sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain',
'sql-manual/sql-functions/scalar-functions/string-functions/format',
'sql-manual/sql-functions/scalar-functions/string-functions/format-number',
'sql-manual/sql-functions/scalar-functions/string-functions/hex',
@@ -1635,9 +1630,7 @@ const sidebars: SidebarsConfig = {
'sql-manual/sql-functions/scalar-functions/string-functions/ngram-search',
'sql-manual/sql-functions/scalar-functions/string-functions/overlay',
'sql-manual/sql-functions/scalar-functions/string-functions/parse-data-size',
-
'sql-manual/sql-functions/scalar-functions/string-functions/parse-url',
'sql-manual/sql-functions/scalar-functions/string-functions/position',
-
'sql-manual/sql-functions/scalar-functions/string-functions/protocol',
'sql-manual/sql-functions/scalar-functions/string-functions/quote',
'sql-manual/sql-functions/scalar-functions/string-functions/random_bytes',
'sql-manual/sql-functions/scalar-functions/string-functions/regexp',
@@ -1670,19 +1663,33 @@ const sidebars: SidebarsConfig = {
'sql-manual/sql-functions/scalar-functions/string-functions/tokenize',
'sql-manual/sql-functions/scalar-functions/string-functions/trim',
'sql-manual/sql-functions/scalar-functions/string-functions/trim-in',
-
'sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain',
'sql-manual/sql-functions/scalar-functions/string-functions/to-base64',
'sql-manual/sql-functions/scalar-functions/string-functions/translate',
'sql-manual/sql-functions/scalar-functions/string-functions/uncompress',
'sql-manual/sql-functions/scalar-functions/string-functions/unhex',
'sql-manual/sql-functions/scalar-functions/string-functions/ucase',
'sql-manual/sql-functions/scalar-functions/string-functions/unicode_normalize',
-
'sql-manual/sql-functions/scalar-functions/string-functions/url-decode',
-
'sql-manual/sql-functions/scalar-functions/string-functions/url-encode',
'sql-manual/sql-functions/scalar-functions/string-functions/uuid',
'sql-manual/sql-functions/scalar-functions/string-functions/xpath-string',
],
},
+ {
+ type: 'category',
+ label: 'URL Functions',
+ items: [
+
'sql-manual/sql-functions/scalar-functions/url-functions/overview',
+
'sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain',
+
'sql-manual/sql-functions/scalar-functions/string-functions/domain',
+
'sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www',
+
'sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter',
+
'sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain',
+
'sql-manual/sql-functions/scalar-functions/string-functions/parse-url',
+
'sql-manual/sql-functions/scalar-functions/string-functions/protocol',
+
'sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain',
+
'sql-manual/sql-functions/scalar-functions/string-functions/url-decode',
+
'sql-manual/sql-functions/scalar-functions/string-functions/url-encode',
+ ],
+ },
{
type: 'category',
label: 'Date Functions',
diff --git
a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..c3de6f8abf3c
--- /dev/null
+++
b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL Functions Overview",
+ "language": "en",
+ "description": "Find functions for extracting URL components, processing
domains, and encoding or decoding URL strings."
+}
+---
+
+# URL Functions Overview
+
+URL functions extract components such as domains, protocols, and query
parameters, or encode and decode URL strings. Use the function reference pages
below for syntax, input requirements, and examples.
+
+| Function | Purpose |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | Extract the domain from a URL. |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | Extract
the domain and remove a leading `www.`. |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | Extract the
top-level domain. |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| Extract the first significant subdomain. |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| Keep the domain up to the first significant subdomain. |
+| [PROTOCOL](../string-functions/protocol.md) | Extract the protocol from a
URL. |
+| [PARSE_URL](../string-functions/parse-url.md) | Extract a specified URL
component. |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
Extract a named URL query parameter. |
+| [URL_ENCODE](../string-functions/url-encode.md) | Encode a string for use in
a URL. |
+| [URL_DECODE](../string-functions/url-decode.md) | Decode a URL-encoded
string. |
diff --git
a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
index 3bdaaf781c74..4ce7c7845b12 100644
---
a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
+++
b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/overview.md
@@ -10,6 +10,8 @@
String functions are built-in functions used to process and manipulate string
data. They help perform various string operations, such as concatenation,
splitting, replacement, searching, etc.
+For URL parsing, domain extraction, and URL encoding or decoding, see [URL
Functions](../url-functions/overview.md).
+
## UTF-8 Encoding Support
UTF-8 encoding is a variable-length character encoding that can represent
almost all characters in the world, including Cyrillic, Greek, Chinese
characters, emojis, and more.
diff --git
a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
new file mode 100644
index 000000000000..c3de6f8abf3c
--- /dev/null
+++
b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/url-functions/overview.md
@@ -0,0 +1,24 @@
+---
+{
+ "title": "URL Functions Overview",
+ "language": "en",
+ "description": "Find functions for extracting URL components, processing
domains, and encoding or decoding URL strings."
+}
+---
+
+# URL Functions Overview
+
+URL functions extract components such as domains, protocols, and query
parameters, or encode and decode URL strings. Use the function reference pages
below for syntax, input requirements, and examples.
+
+| Function | Purpose |
+| --- | --- |
+| [DOMAIN](../string-functions/domain.md) | Extract the domain from a URL. |
+| [DOMAIN_WITHOUT_WWW](../string-functions/domain-without-www.md) | Extract
the domain and remove a leading `www.`. |
+| [TOP_LEVEL_DOMAIN](../string-functions/top-level-domain.md) | Extract the
top-level domain. |
+|
[FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/first-significant-subdomain.md)
| Extract the first significant subdomain. |
+|
[CUT_TO_FIRST_SIGNIFICANT_SUBDOMAIN](../string-functions/cut-to-first-significant-subdomain.md)
| Keep the domain up to the first significant subdomain. |
+| [PROTOCOL](../string-functions/protocol.md) | Extract the protocol from a
URL. |
+| [PARSE_URL](../string-functions/parse-url.md) | Extract a specified URL
component. |
+| [EXTRACT_URL_PARAMETER](../string-functions/extract-url-parameter.md) |
Extract a named URL query parameter. |
+| [URL_ENCODE](../string-functions/url-encode.md) | Encode a string for use in
a URL. |
+| [URL_DECODE](../string-functions/url-decode.md) | Decode a URL-encoded
string. |
diff --git a/versioned_sidebars/version-3.x-sidebars.json
b/versioned_sidebars/version-3.x-sidebars.json
index a20d7b8e6a3a..9c5e653ae6d0 100644
--- a/versioned_sidebars/version-3.x-sidebars.json
+++ b/versioned_sidebars/version-3.x-sidebars.json
@@ -1253,15 +1253,10 @@
"sql-manual/sql-functions/scalar-functions/string-functions/concat",
"sql-manual/sql-functions/scalar-functions/string-functions/concat-ws",
"sql-manual/sql-functions/scalar-functions/string-functions/count_substrings",
-
"sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain",
"sql-manual/sql-functions/scalar-functions/string-functions/digital-masking",
-
"sql-manual/sql-functions/scalar-functions/string-functions/domain",
-
"sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www",
"sql-manual/sql-functions/scalar-functions/string-functions/elt",
"sql-manual/sql-functions/scalar-functions/string-functions/ends-with",
-
"sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter",
"sql-manual/sql-functions/scalar-functions/string-functions/find-in-set",
-
"sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain",
"sql-manual/sql-functions/scalar-functions/string-functions/from-base64",
"sql-manual/sql-functions/scalar-functions/string-functions/hex",
"sql-manual/sql-functions/scalar-functions/string-functions/initcap",
@@ -1280,8 +1275,6 @@
"sql-manual/sql-functions/scalar-functions/string-functions/multi-search-all-positions",
"sql-manual/sql-functions/scalar-functions/string-functions/ngram-search",
"sql-manual/sql-functions/scalar-functions/string-functions/overlay",
-
"sql-manual/sql-functions/scalar-functions/string-functions/parse-url",
-
"sql-manual/sql-functions/scalar-functions/string-functions/protocol",
"sql-manual/sql-functions/scalar-functions/string-functions/quote",
"sql-manual/sql-functions/scalar-functions/string-functions/random_bytes",
"sql-manual/sql-functions/scalar-functions/string-functions/regexp",
@@ -1309,20 +1302,34 @@
"sql-manual/sql-functions/scalar-functions/string-functions/substring-index",
"sql-manual/sql-functions/scalar-functions/string-functions/to-base64",
"sql-manual/sql-functions/scalar-functions/string-functions/tokenize",
-
"sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain",
"sql-manual/sql-functions/scalar-functions/string-functions/translate",
"sql-manual/sql-functions/scalar-functions/string-functions/trim",
"sql-manual/sql-functions/scalar-functions/string-functions/trim-in",
"sql-manual/sql-functions/scalar-functions/string-functions/ucase",
"sql-manual/sql-functions/scalar-functions/string-functions/unhex",
-
"sql-manual/sql-functions/scalar-functions/string-functions/url-decode",
-
"sql-manual/sql-functions/scalar-functions/string-functions/url-encode",
"sql-manual/sql-functions/scalar-functions/string-functions/uuid",
"sql-manual/sql-functions/scalar-functions/string-functions/xpath-string",
"sql-manual/sql-functions/scalar-functions/string-functions/week-ceil",
"sql-manual/sql-functions/scalar-functions/string-functions/week-floor"
]
},
+ {
+ "type": "category",
+ "label": "URL Functions",
+ "items": [
+
"sql-manual/sql-functions/scalar-functions/url-functions/overview",
+
"sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/domain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www",
+
"sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter",
+
"sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/parse-url",
+
"sql-manual/sql-functions/scalar-functions/string-functions/protocol",
+
"sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/url-decode",
+
"sql-manual/sql-functions/scalar-functions/string-functions/url-encode"
+ ]
+ },
{
"type": "category",
"label": "Date Functions",
diff --git a/versioned_sidebars/version-4.x-sidebars.json
b/versioned_sidebars/version-4.x-sidebars.json
index 3c8f4cfa9f05..4fe5609ff3e2 100644
--- a/versioned_sidebars/version-4.x-sidebars.json
+++ b/versioned_sidebars/version-4.x-sidebars.json
@@ -1733,18 +1733,13 @@
"sql-manual/sql-functions/scalar-functions/string-functions/concat-ws",
"sql-manual/sql-functions/scalar-functions/string-functions/compress",
"sql-manual/sql-functions/scalar-functions/string-functions/count_substrings",
-
"sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain",
"sql-manual/sql-functions/scalar-functions/string-functions/damerau_levenshtein_distance",
"sql-manual/sql-functions/scalar-functions/string-functions/digital-masking",
-
"sql-manual/sql-functions/scalar-functions/string-functions/domain",
-
"sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www",
"sql-manual/sql-functions/scalar-functions/string-functions/ends-with",
"sql-manual/sql-functions/scalar-functions/string-functions/export-set",
"sql-manual/sql-functions/scalar-functions/string-functions/elt",
-
"sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter",
"sql-manual/sql-functions/scalar-functions/string-functions/from-base64",
"sql-manual/sql-functions/scalar-functions/string-functions/find-in-set",
-
"sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain",
"sql-manual/sql-functions/scalar-functions/string-functions/format",
"sql-manual/sql-functions/scalar-functions/string-functions/format-number",
"sql-manual/sql-functions/scalar-functions/string-functions/hex",
@@ -1769,9 +1764,7 @@
"sql-manual/sql-functions/scalar-functions/string-functions/ngram-search",
"sql-manual/sql-functions/scalar-functions/string-functions/overlay",
"sql-manual/sql-functions/scalar-functions/string-functions/parse-data-size",
-
"sql-manual/sql-functions/scalar-functions/string-functions/parse-url",
"sql-manual/sql-functions/scalar-functions/string-functions/position",
-
"sql-manual/sql-functions/scalar-functions/string-functions/protocol",
"sql-manual/sql-functions/scalar-functions/string-functions/quote",
"sql-manual/sql-functions/scalar-functions/string-functions/random_bytes",
"sql-manual/sql-functions/scalar-functions/string-functions/regexp",
@@ -1803,19 +1796,33 @@
"sql-manual/sql-functions/scalar-functions/string-functions/tokenize",
"sql-manual/sql-functions/scalar-functions/string-functions/trim",
"sql-manual/sql-functions/scalar-functions/string-functions/trim-in",
-
"sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain",
"sql-manual/sql-functions/scalar-functions/string-functions/to-base64",
"sql-manual/sql-functions/scalar-functions/string-functions/translate",
"sql-manual/sql-functions/scalar-functions/string-functions/uncompress",
"sql-manual/sql-functions/scalar-functions/string-functions/unhex",
"sql-manual/sql-functions/scalar-functions/string-functions/ucase",
"sql-manual/sql-functions/scalar-functions/string-functions/unicode_normalize",
-
"sql-manual/sql-functions/scalar-functions/string-functions/url-decode",
-
"sql-manual/sql-functions/scalar-functions/string-functions/url-encode",
"sql-manual/sql-functions/scalar-functions/string-functions/uuid",
"sql-manual/sql-functions/scalar-functions/string-functions/xpath-string"
]
},
+ {
+ "type": "category",
+ "label": "URL Functions",
+ "items": [
+
"sql-manual/sql-functions/scalar-functions/url-functions/overview",
+
"sql-manual/sql-functions/scalar-functions/string-functions/cut-to-first-significant-subdomain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/domain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/domain-without-www",
+
"sql-manual/sql-functions/scalar-functions/string-functions/extract-url-parameter",
+
"sql-manual/sql-functions/scalar-functions/string-functions/first-significant-subdomain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/parse-url",
+
"sql-manual/sql-functions/scalar-functions/string-functions/protocol",
+
"sql-manual/sql-functions/scalar-functions/string-functions/top-level-domain",
+
"sql-manual/sql-functions/scalar-functions/string-functions/url-decode",
+
"sql-manual/sql-functions/scalar-functions/string-functions/url-encode"
+ ]
+ },
{
"type": "category",
"label": "Date Functions",
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
