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 2c4f6c7a6579a841a617d60f53cc77c35155dd8b..ff1ec3299952a835c24dabfb77efd60790585d68 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 6d44abf0f01b273b5513d48962a53a2228866b79..e5677cad0aa54b2e9192e53319c06883139f2eb8 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 073334ad1dcf178f60b4c2491646ed42e2c75dbe..74b09fb3bf4591d29bfdd0c69d08e512d97368b1 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 12cb1f21954d5ecb668e37877a93a934e56b497b..704994e2e8d64e86c2e193b20b3e3b03ec6eb660 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**