all

docs/sql-manual/sql-functions/scalar-functions/string-functions/compress.md

@@ -0,0 +1,63 @@
+---
+{
+    "title": "COMPRESS",
+    "language": "en"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## Description
+The COMPRESS function is used to compress strings or values into binary data. The compressed data can be decompressed using the UNCOMPRESS function.
+
+## Syntax
+
+```sql
+SELECT(<uncompressed>, <compressed>)
+```
+
+## Parameters
+
+| Parameters                | Description            |
+|--------------------|---------------|
+| `<uncompressed>` | Uncompressed raw string |
+| `<compressed>`          | Compressed binary data      |
+
+The parameter type is varchar or string
+
+## Return Value
+The return string is the same as the input <uncompressed> type  
+The first ten digits of the returned string are the hexadecimal length of the original string, for example, 0x01000000. Followed by the compressed value.
+
+Special case：
+- <uncompressed> Return '0x' when input is ''
+
+## Example
+
+``` sql
+select compress('abc');
+```
+```text
++----------------------------------+
+| compress('abc')                  |
++----------------------------------+
+| 0x03000000789C4B4C4A0600024D0127 |
++----------------------------------+
+```

docs/sql-manual/sql-functions/scalar-functions/string-functions/uncompressed.md

@@ -0,0 +1,63 @@
+---
+{
+    "title": "UNCOMPRESS",
+    "language": "en"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## Description
+The UNCOMPRESS function is used to extract binary data into a string or value, and the binary data needs to be the result of 'COMPRESS'
+
+## Syntax
+
+```sql
+UNCOMPRESS(<compressed>, <uncompressed>)
+```
+
+## Parameters
+
+| 参数                | 说明            |
+|--------------------|---------------|
+| `<compressed>` | Compressed binary data |
+| `<uncompressed>`          | Uncompressed raw string      |
+
+The parameter type is varchar or string
+
+## Return Value
+The return value is the same as the input <compressed> type
+
+Special cases:
+- <compressed> Returns NULL if the binary data is not compressed.
+
+
+## Example
+
+``` sql
+select uncompress(compress('abc'));
+```
+```text 
++-----------------------------+
+| uncompress(compress('abc')) |
++-----------------------------+
+| abc                         |
++-----------------------------+
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/compress.md

@@ -0,0 +1,62 @@
+---
+{
+    "title": "COMPRESS",
+    "language": "zh-CN"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 描述
+COMPRESS 函数用于将字符串或值压缩成二进制数据，压缩后的数据可通过 `UNCOMPRESS` 函数解压还原。
+
+## 语法
+
+```sql
+SELECT(<uncompressed>, <compressed>)
+```
+
+## 参数
+
+| 参数                | 说明            |
+|--------------------|---------------|
+| `<uncompressed>` | 未压缩的原串 |
+| `<compressed>`          | 压缩后的二进制数据      |
+
+参数类型是varchar或者string
+
+## 返回值
+返回串与输入的 <uncompressed> 类型一致  
+返回串的前十位是原串长度的十六进制形式, 例如: 0x01000000。后面的是压缩值。  
+特殊情况：
+- <uncompressed> 输入为 ‘’ 时，返回 '0x'
+
+## 举例
+
+``` sql
+select compress('abc');
+```
+```text
++----------------------------------+
+| compress('abc')                  |
++----------------------------------+
+| 0x03000000789C4B4C4A0600024D0127 |
++----------------------------------+
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/string-functions/uncompressed.md

@@ -0,0 +1,62 @@
+---
+{
+    "title": "UNCOMPRESS",
+    "language": "zh-CN"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 描述
+UNCOMPRESS 函数用于将二进制数据解压缩成字符串或值，二进制数据需要是`COMPRESS`的结果
+
+## 语法
+
+```sql
+UNCOMPRESS(<compressed>, <uncompressed>)
+```
+
+## 参数
+
+| 参数                | 说明            |
+|--------------------|---------------|
+| `<compressed>` | 压缩得到的二进制数据 |
+| `<uncompressed>`          | 未压缩的原串      |
+
+参数类型是varchar或者string
+
+## 返回值
+返回值与输入的 <compressed> 类型一致
+特殊情况：
+- <compressed> 输入不是`COMPRESS`得到的二进制数据时, 返回 NULL.
+
+
+## 举例
+
+``` sql
+select uncompress(compress('abc'));
+```
+```text 
++-----------------------------+
+| uncompress(compress('abc')) |
++-----------------------------+
+| abc                         |
++-----------------------------+
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/string-functions/compress.md

@@ -0,0 +1,62 @@
+---
+{
+    "title": "COMPRESS",
+    "language": "zh-CN"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 描述
+COMPRESS 函数用于将字符串或值压缩成二进制数据，压缩后的数据可通过 `UNCOMPRESS` 函数解压还原。
+
+## 语法
+
+```sql
+SELECT(<uncompressed>, <compressed>)
+```
+
+## 参数
+
+| 参数                | 说明            |
+|--------------------|---------------|
+| `<uncompressed>` | 未压缩的原串 |
+| `<compressed>`          | 压缩后的二进制数据      |
+
+参数类型是varchar或者string
+
+## 返回值
+返回串与输入的 <uncompressed> 类型一致  
+返回串的前十位是原串长度的十六进制形式, 例如: 0x01000000。后面的是压缩值。  
+特殊情况：
+- <uncompressed> 输入为 ‘’ 时，返回 '0x'
+
+## 举例
+
+``` sql
+select compress('abc');
+```
+```text
++----------------------------------+
+| compress('abc')                  |
++----------------------------------+
+| 0x03000000789C4B4C4A0600024D0127 |
++----------------------------------+
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/string-functions/uncompressed.md

@@ -0,0 +1,62 @@
+---
+{
+    "title": "UNCOMPRESS",
+    "language": "zh-CN"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 描述
+UNCOMPRESS 函数用于将二进制数据解压缩成字符串或值，二进制数据需要是`COMPRESS`的结果
+
+## 语法
+
+```sql
+UNCOMPRESS(<compressed>, <uncompressed>)
+```
+
+## 参数
+
+| 参数                | 说明            |
+|--------------------|---------------|
+| `<compressed>` | 压缩得到的二进制数据 |
+| `<uncompressed>`          | 未压缩的原串      |
+
+参数类型是varchar或者string
+
+## 返回值
+返回值与输入的 <compressed> 类型一致
+特殊情况：
+- <compressed> 输入不是`COMPRESS`得到的二进制数据时, 返回 NULL.
+
+
+## 举例
+
+``` sql
+select uncompress(compress('abc'));
+```
+```text 
++-----------------------------+
+| uncompress(compress('abc')) |
++-----------------------------+
+| abc                         |
++-----------------------------+
+```

sidebars.json

@@ -941,11 +941,13 @@
                                         "sql-manual/sql-functions/scalar-functions/string-functions/rpad",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/lcase",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/ucase",
+                                        "sql-manual/sql-functions/scalar-functions/string-functions/uncompress",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/initcap",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/repeat",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/reverse",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/char",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/concat",
+                                        "sql-manual/sql-functions/scalar-functions/string-functions/compress",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/concat-ws",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/substring",
                                         "sql-manual/sql-functions/scalar-functions/string-functions/count_substrings",