From b64dbdefc5a795ca623833e2ad243b432e24e3eb Mon Sep 17 00:00:00 2001 From: He Bomou Date: Mon, 21 Apr 2025 20:34:46 +0800 Subject: [PATCH] =?UTF-8?q?fix(IC125I):=20=E8=A1=A5=E5=85=85=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0=20B=20=E5=BA=93=20convert=20=E5=87=BD=E6=95=B0?= =?UTF-8?q?=E7=9A=84=E7=9B=B8=E5=85=B3=20GUC=20=E5=8F=82=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...14\346\223\215\344\275\234\347\254\246.md" | 28 +++++++++++++++---- content/docs-lite/zh/docs/SQLReference/SET.md | 2 +- ...14\346\223\215\344\275\234\347\254\246.md" | 28 +++++++++++++++---- content/zh/docs/SQLReference/SET.md | 2 +- 4 files changed, 48 insertions(+), 12 deletions(-) diff --git "a/content/docs-lite/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" "b/content/docs-lite/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" index 2c4f6c7a6..ff1ec3299 100644 --- "a/content/docs-lite/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" +++ "b/content/docs-lite/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" @@ -432,16 +432,17 @@ (1 row) ``` -- convert(expr using transcoding_name), convert(expr, type_name) +- `convert(expr using transcoding_name)` - 描述：通过transcoding_name指定的编码方式转换expr;或者将指定内容转换为对应的数据类型 - 注意：默认库中支持如下格式： convert(string bytea, src_encoding name, dest_encoding name);以dest_encoding指定的编码方式转换bytea，dolphin下支持通过using关键字后transcoding_name指定要转换的编码方式，对expr进行转换，不支持上述三个参数的表示方式。对于convert(expr, type_name)场景，当dolphin.b_compatibility_mode为on时，如果type_name为char，实际会转换成varchar。为off时仍保持原始openGauss表现，转换成char。 + 描述：通过 `transcoding_name` 指定的编码方式转换 `expr`。 + 注意：默认库中支持如下格式：`convert(string bytea, src_encoding name, dest_encoding name)`，以 `dest_encoding` 指定的编码方式转换 `bytea`；dolphin 下支持通过 `using` 关键字后 `transcoding_name` 指定要转换的编码方式，对 `expr` 进行转换，不支持上述三个参数的表示方式。 + 另外，该函数需要在 GUC 参数 `b_format_behavior_compat_options` 包含 `enable_multi_charset` 时才可生效。 - 返回值类型：text或者type_name指定的数据类型 + 返回值类型：`text` 示例： - ``` + ```sql b_compatibility_database=# select convert('a' using 'utf8'); convert --------- @@ -455,6 +456,23 @@ (1 row) ``` +- `convert(expr, type_name)` + + 将指定内容转换为对应的数据类型。 + 当 `dolphin.b_compatibility_mode` 为 `on` 时，如果 `type_name` 为 `char` ，实际会转换成 `varchar` 。为 `off` 时仍保持原始 openGauss 表现，转换成 `char`。 + + 返回值类型：`type_name` 指定的数据类型 + + 示例： + + ```sql + b_compatibility_database=# select convert('a', bytea); + bytea + ---------- + \x61 + (1 row) + ``` + - elt(number, str1,str2,str3,...) 描述：返回后面字符串的第N个字符串。 diff --git a/content/docs-lite/zh/docs/SQLReference/SET.md b/content/docs-lite/zh/docs/SQLReference/SET.md index 6d44abf0f..e5677cad0 100644 --- a/content/docs-lite/zh/docs/SQLReference/SET.md +++ b/content/docs-lite/zh/docs/SQLReference/SET.md @@ -108,7 +108,7 @@ 该选项额外还会将GUC参数character\_set\_connection设置成encoding\_name，用于设置字符串常量的默认字符集。若未指定COLLATE collate\_name选项， - 则会将将GUC参数collation\_connection设置成当前encoding\_name的默认字符序。 + 则会将 GUC 参数 `collation_connection` 设置成当前 `encoding_name` 的默认字符序。 - **COLLATE collate\_name** diff --git "a/content/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" "b/content/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" index 073334ad1..74b09fb3b 100644 --- "a/content/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" +++ "b/content/zh/docs/ExtensionReference/dolphin-\345\255\227\347\254\246\345\244\204\347\220\206\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" @@ -432,16 +432,17 @@ (1 row) ``` -- convert(expr using transcoding_name), convert(expr, type_name) +- `convert(expr using transcoding_name)` - 描述：通过transcoding_name指定的编码方式转换expr;或者将指定内容转换为对应的数据类型 - 注意：默认库中支持如下格式： convert(string bytea, src_encoding name, dest_encoding name);以dest_encoding指定的编码方式转换bytea，dolphin下支持通过using关键字后transcoding_name指定要转换的编码方式，对expr进行转换，不支持上述三个参数的表示方式。对于convert(expr, type_name)场景，当dolphin.b_compatibility_mode为on时，如果type_name为char，实际会转换成varchar。为off时仍保持原始openGauss表现，转换成char。 + 描述：通过 `transcoding_name` 指定的编码方式转换 `expr`。 + 注意：默认库中支持如下格式：`convert(string bytea, src_encoding name, dest_encoding name)`，以 `dest_encoding` 指定的编码方式转换 `bytea`；dolphin 下支持通过 `using` 关键字后 `transcoding_name` 指定要转换的编码方式，对 `expr` 进行转换，不支持上述三个参数的表示方式。 + 另外，该函数需要在 GUC 参数 `b_format_behavior_compat_options` 包含 `enable_multi_charset` 时才可生效。 - 返回值类型：text或者type_name指定的数据类型 + 返回值类型：`text` 示例： - ``` + ```sql b_compatibility_database=# select convert('a' using 'utf8'); convert --------- @@ -455,6 +456,23 @@ (1 row) ``` +- `convert(expr, type_name)` + + 将指定内容转换为对应的数据类型。 + 当 `dolphin.b_compatibility_mode` 为 `on` 时，如果 `type_name` 为 `char` ，实际会转换成 `varchar` 。为 `off` 时仍保持原始 openGauss 表现，转换成 `char`。 + + 返回值类型：`type_name` 指定的数据类型 + + 示例： + + ```sql + b_compatibility_database=# select convert('a', bytea); + bytea + ---------- + \x61 + (1 row) + ``` + - elt(number, str1,str2,str3,...) 描述：返回后面字符串的第N个字符串。 diff --git a/content/zh/docs/SQLReference/SET.md b/content/zh/docs/SQLReference/SET.md index 12cb1f219..704994e2e 100644 --- a/content/zh/docs/SQLReference/SET.md +++ b/content/zh/docs/SQLReference/SET.md @@ -116,7 +116,7 @@ 该选项额外还会将GUC参数character\_set\_connection设置成encoding\_name，用于设置字符串常量的默认字符集。若未指定COLLATE collate\_name选项， - 则会将将GUC参数collation\_connection设置成当前encoding\_name的默认字符序。 + 则会将 GUC 参数 `collation_connection` 设置成当前 `encoding_name` 的默认字符序。 - **COLLATE collate\_name** -- Gitee