diff --git "a/content/zh/docs/AboutopenGauss/gms_output\345\267\245\345\205\267\345\214\205.md" "b/content/zh/docs/AboutopenGauss/gms_output\345\267\245\345\205\267\345\214\205.md" new file mode 100644 index 0000000000000000000000000000000000000000..43e022a553e75493e9f06e775732f7f2ac495000 --- /dev/null +++ "b/content/zh/docs/AboutopenGauss/gms_output\345\267\245\345\205\267\345\214\205.md" @@ -0,0 +1,33 @@ +# GMS_OUTPUT工具包 + +## 可获得性 + +本特性自openGauss 6.0.0版本开始引入 + +## 特性简介 + +特性主要用来实现[GMS_OUTPUT高级包](../ExtensionReference/gms_output-Extension.md),用于实现多个输出相关的函数接口供用户使用。 + +## 客户价值 + +GMS_OUTPUT包主要用于调试PL/SQL程序。它允许开发者从存储过程、包等中发送信息(messages),这些信息可以被捕获并显示在客户端(如SQL*Plus、SQL Developer等)上,从而帮助开发者定位问题、理解程序执行流程。 + +## 特性描述 + +- `GMS_OUTPUT` 最显著的特点是作为 PL/SQL 代码的调试工具。它允许开发者在 PL/SQL 代码的任何位置插入 `GMS_OUTPUT.PUT_LINE` 或 `GMS_OUTPUT.PUT` 调用,以输出变量值、消息或执行状态。这对于诊断问题、理解代码逻辑和执行流程至关重要。 +- 通过 `GMS_OUTPUT.ENABLE` 和 `GMS_OUTPUT.DISABLE` 过程,可以控制是否将输出发送到客户端。该过程本质上是开辟存储messages的缓冲区和释放缓冲区操作,这允许开发者在需要时启用调试输出,而在生产环境中禁用它。 +- 通过`GMS_OUTPUT.GET_LINE`和`GMS_OUTPUT.GET_LINES`过程从缓冲区中检索行数组,并读取一行或指定行数的文本信息。 +- `GMS_OUTPUT.NEW_LINE`过程则向行缓冲区中放置一个行结束标记。 + +## 特性增强 + +无 + +## 特性约束 + +- 仅支持Create extension命令方式加载插件后再使用。 + +## 依赖关系 + +无。 + diff --git "a/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.md" "b/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.md" index 5d52c4a3f4253191a58be029f7fd6361d0f4e2ec..4a02c0645d8735348a79e989432b00048fe8433d 100644 --- "a/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.md" +++ "b/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.md" @@ -23,7 +23,7 @@ - **[管道函数](管道函数.md)** - **[全局临时表](全局临时表.md)** - + - **[伪列ROWNUM](伪列ROWNUM.md)** - **[支持存储过程调试](支持存储过程调试.md)** @@ -42,4 +42,6 @@ - **[事件触发器](事件触发器.md)** -- **[支持UWAL特性](支持UWAL特性.md)** \ No newline at end of file +- **[支持UWAL特性](支持UWAL特性.md)** + +- **[支持gms_output工具包](gms_output工具包.md)** \ No newline at end of file diff --git a/content/zh/menu/index.md b/content/zh/menu/index.md index 775c1ca93671bc41b4abcc639369738d26d535a0..a08bdc370c96d103cb9470a71a600b642c58a694 100644 --- a/content/zh/menu/index.md +++ b/content/zh/menu/index.md @@ -134,6 +134,7 @@ headless: true - [支持特殊浮点数]({{< relref "./docs/AboutopenGauss/支持特殊浮点数.md" >}}) - [事件触发器]({{< relref "./docs/AboutopenGauss/事件触发器.md" >}}) - [支持UWAL特性]({{< relref "./docs/AboutopenGauss/支持UWAL特性.md" >}}) + - [支持gms_output工具包]({{< relref "./docs/AboutopenGauss/gms_output工具包.md" >}}) - [应用开发接口]({{< relref "./docs/AboutopenGauss/应用开发接口.md" >}}) - [支持标准SQL]({{< relref "./docs/AboutopenGauss/支持标准SQL.md" >}}) - [支持标准开发接口]({{< relref "./docs/AboutopenGauss/支持标准开发接口.md" >}}) diff --git "a/sphinx/source/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.rst" "b/sphinx/source/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.rst" index ae6fbf30e31fd30e7b1c8aa0d6ed5cce46f8e941..0d244731938248e355da6958decc8c1c2af685d8 100644 --- "a/sphinx/source/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.rst" +++ "b/sphinx/source/AboutopenGauss/\344\274\201\344\270\232\347\272\247\347\211\271\346\200\247.rst" @@ -23,4 +23,5 @@ ../content/zh/docs/AboutopenGauss/外键锁增强 ../content/zh/docs/AboutopenGauss/支持OLTP场景数据压缩 ../content/zh/docs/AboutopenGauss/支持特殊浮点数 - ../content/zh/docs/AboutopenGauss/事件触发器 \ No newline at end of file + ../content/zh/docs/AboutopenGauss/事件触发器 + ../content/zh/docs/AboutopenGauss/gms_output工具包 \ No newline at end of file