From b6f6194c843eed0bde6a4e70a1703834eada267b Mon Sep 17 00:00:00 2001 From: Songlin Li Date: Fri, 2 Jun 2023 09:49:20 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8DMarkdown=E8=AF=AD?= =?UTF-8?q?=E6=B3=95=E4=B8=AD=E5=AF=B9=E4=BA=8E=E5=8A=A0=E7=B2=97=E8=AF=AD?= =?UTF-8?q?=E6=B3=95=E7=9A=84bug?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../DataBaseReference/connection-settings.md | 4 +- ...57\345\212\250\346\227\266\351\227\264.md" | 2 +- .../DatabaseAdministrationGuide/mysql_fdw.md | 2 +- ...3\226openGauss\347\211\271\346\200\247.md" | 6 +- ...73\346\234\215\345\212\241\345\231\250.md" | 2 +- .../\345\206\205\345\255\230-31.md" | 6 +- ...14\346\240\274\345\274\217\345\214\226.md" | 2 +- ...57\345\206\231\350\277\233\347\250\213.md" | 2 +- ...07\344\273\275\346\201\242\345\244\215.md" | 2 +- .../\350\256\276\347\275\256.md" | 4 +- ...02\346\225\260\345\217\202\350\200\203.md" | 64 +++++++++---------- .../\344\275\277\347\224\250openGauss.md" | 2 +- ...45\350\257\242\350\260\203\344\274\230.md" | 2 +- ...20\347\272\247\350\260\203\344\274\230.md" | 4 +- ...76\345\274\217\346\270\270\346\240\207.md" | 8 +-- .../gsql\346\246\202\350\277\260.md" | 6 +- ...36\345\274\272\347\211\271\346\200\247.md" | 8 +-- content/zh/docs/BriefTutorial/DCF.md | 4 +- content/zh/docs/BriefTutorial/Ustore.md | 6 +- ...57\345\212\250\346\227\266\351\227\264.md" | 2 +- ...51\345\256\271\346\236\266\346\236\204.md" | 2 +- ...3\226openGauss\347\211\271\346\200\247.md" | 6 +- ...73\346\234\215\345\212\241\345\231\250.md" | 2 +- .../\345\206\205\345\255\230-21.md" | 6 +- ...45\255\230_GUC\345\217\202\346\225\260.md" | 6 +- ...14\346\240\274\345\274\217\345\214\226.md" | 2 +- ...57\345\206\231\350\277\233\347\250\213.md" | 4 +- .../\350\256\276\347\275\256.md" | 4 +- ...02\346\225\260\345\217\202\350\200\203.md" | 64 +++++++++---------- ...45\350\257\242\350\260\203\344\274\230.md" | 2 +- ...20\347\272\247\350\260\203\344\274\230.md" | 2 +- ...76\345\274\217\346\270\270\346\240\207.md" | 4 +- .../ToolandCommandReference/gs_upgradectl.md | 10 +-- .../zh/docs/ToolandCommandReference/gsql.md | 6 +- ...56\350\200\205\350\257\204\351\200\211.md" | 4 +- 35 files changed, 131 insertions(+), 131 deletions(-) diff --git a/content/docs-lite/en/docs/DataBaseReference/connection-settings.md b/content/docs-lite/en/docs/DataBaseReference/connection-settings.md index c610abb15..44b06ae49 100644 --- a/content/docs-lite/en/docs/DataBaseReference/connection-settings.md +++ b/content/docs-lite/en/docs/DataBaseReference/connection-settings.md @@ -180,7 +180,7 @@ This parameter is a USERSET parameter used for O&M. You are advised not to chang ## enable\_dolphin\_proto -**Parameter descriptio：**Whether enable dolphin database protocol or not +**Parameter descriptio：** Whether enable dolphin database protocol or not This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](../DatabaseAdministrationGuide/resetting-parameters.md#en-us_topic_0283137176_en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). @@ -196,4 +196,4 @@ This parameter is a POSTMASTER parameter. Set it based on instructions provided **Value range**: an integer ranging from 1024 to 65535 -**Default value**: **3308** \ No newline at end of file +**Default value**: **3308** diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" index 35eb9419a..3ab6e06e0 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" @@ -26,7 +26,7 @@ **图 1** 冷启动时间性能基准 ![](figures/冷启动时间性能基准.png "冷启动时间性能基准") - - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 + - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）** 表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 >![](public_sys-resources/icon-note.gif) **说明：** diff --git a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md index 21001f045..f03739fc4 100644 --- a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md +++ b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md @@ -14,7 +14,7 @@ mysql\_fdw是一款[开源插件](https://github.com/EnterpriseDB/mysql_fdw)。o 编译完成后，编译产物为**mysql\_fdw.so** ，位于安装目录的**lib/postgresql/** 下。mysql\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/extension/**下。 -如果编译安装时，没有加入**--enable-mysql-fdw**选项，可以在openGauss安装完成后，再次编译mysql\_fdw，然后手动将编译产物**mysql\_fdw.so**放到对应的安装目录 **lib/postgresql/**，将 **mysql\_fdw--1.0--1.1.sql、mysql\_fdw--1.1.sql，mysql\_fdw--1.0.sql，mysql\_fdw.control** 放到对应的安装目录 **share/postgresql/extension/** 即可。 +如果编译安装时，没有加入 **--enable-mysql-fdw** 选项，可以在openGauss安装完成后，再次编译mysql\_fdw，然后手动将编译产物**mysql\_fdw.so**放到对应的安装目录 **lib/postgresql/**，将 **mysql\_fdw--1.0--1.1. sql、mysql\_fdw--1.1.sql，mysql\_fdw--1.0.sql，mysql\_fdw.control** 放到对应的安装目录 **share/postgresql/extension/** 即可。 ## 使用mysql\_fdw diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" index ee29bf037..5f54778a6 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" @@ -35,8 +35,8 @@ MOT DW机制将指令传递给MOT存储引擎，用于实际建表。同样， 存储引擎负责存储、读取、更新和删除底层内存和存储系统中的数据。存储引擎不处理日志、检查点和恢复，特别是因为某些事务包含多个不同存储引擎的表。因此，为了数据持久化和复制，openGauss封装使用如下高可用性设施： - **持久性**：MOT引擎通过WAL记录使数据持久化，WAL记录使用openGauss的XLOG接口。这为openGauss提供了使用相同API进行复制的好处。具体请参见[MOT持久性概念](MOT持久性概念.md)。 -- **检查点设定：**通过向openGauss Checkpointer注册回调来启用MOT检查点每当执行通用数据库检查点时，MOT检查点也被调用。MOT保留了检查点的日志序列号（LSN），以便与openGauss恢复对齐。MOT Checkpointing算法是高度优化的异步算法，不会停止并发事务。具体请参见[MOT检查点概念](MOT检查点概念.md)。 -- **恢复：**启动时，openGauss首先调用MOT回调，通过加载到内存行并创建索引来恢复MOT检查点，然后根据检查点的LSN重放记录来执行WAL恢复。MOT检查点使用多线程并行恢复，每个线程读取不同的数据段。这使MOT检查点在多核硬件上的恢复速度相当快，尽管可能比仅重放WAL记录的基于磁盘的表慢一些。具体请参见[MOT恢复概念](MOT恢复概念.md)。 +- **检查点设定**：通过向openGauss Checkpointer注册回调来启用MOT检查点每当执行通用数据库检查点时，MOT检查点也被调用。MOT保留了检查点的日志序列号（LSN），以便与openGauss恢复对齐。MOT Checkpointing算法是高度优化的异步算法，不会停止并发事务。具体请参见[MOT检查点概念](MOT检查点概念.md)。 +- **恢复**：启动时，openGauss首先调用MOT回调，通过加载到内存行并创建索引来恢复MOT检查点，然后根据检查点的LSN重放记录来执行WAL恢复。MOT检查点使用多线程并行恢复，每个线程读取不同的数据段。这使MOT检查点在多核硬件上的恢复速度相当快，尽管可能比仅重放WAL记录的基于磁盘的表慢一些。具体请参见[MOT恢复概念](MOT恢复概念.md)。 ## VACUUM和DROP @@ -48,5 +48,5 @@ MOT DW机制将指令传递给MOT存储引擎，用于实际建表。同样， ## 查询本机编译（JIT） -MOT引擎的FDW适配器还包含一个轻量级执行路径，该路径使用LLVM编译器执行JIT编译查询。有关MOT查询本机编译的更多信息可以在**查询本机编译（JIT）**一节中找到。 +MOT引擎的FDW适配器还包含一个轻量级执行路径，该路径使用LLVM编译器执行JIT编译查询。有关MOT查询本机编译的更多信息可以在**查询本机编译（JIT）** 一节中找到。 diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" "b/content/docs-lite/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" index 73b074c2a..b02f19717 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" @@ -247,7 +247,7 @@ gs_guc reload -Z datanode -D @DN_PATH@ -c "synchronous_standby_names='ANY 1(AZ1, 参考[表1](../DatabaseAdministrationGuide/参数设置.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中方式对应设置方法进行设置。 -**修改建议：**由流式容灾密码传递工具自动设置，不需要用户手动添加。 +**修改建议：** 由流式容灾密码传递工具自动设置，不需要用户手动添加。 **取值范围**：字符串 diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\345\206\205\345\255\230-31.md" "b/content/docs-lite/zh/docs/DatabaseReference/\345\206\205\345\255\230-31.md" index f86da6e5c..c267f05f8 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\345\206\205\345\255\230-31.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\345\206\205\345\255\230-31.md" @@ -120,7 +120,7 @@ shared\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB， 该参数属于POSTMASTER类型参数，请参考[表1](../DatabaseAdministrationGuide/参数设置.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 -**取值说明：**整型，16 \~ 1073741823，单位为8KB。 +**取值说明：** 整型，16 \~ 1073741823，单位为8KB。 segment\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即segment\_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 @@ -142,7 +142,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信 **默认值：** 2GB -**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 +**设置建议：** 建议导入压力大的场景中增加数据库节点中此参数配置。 ## standby\_shared\_buffers\_fraction @@ -405,4 +405,4 @@ resilience_memory_reject_percent = '70,90' > ![](public_sys-resources/icon-notice.gif) **须知：** > > - 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。 -> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 \ No newline at end of file +> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" "b/content/docs-lite/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" index 0955524c2..4853934b9 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" @@ -18,7 +18,7 @@ > >gs\_initdb会将这个参数初始化成与[lc\_time](#zh-cn_topic_0283136798_zh-cn_topic_0237124733_zh-cn_topic_0059778109_scbb410b3c5c94682a3eec218c7ff0220)一致的值。 -**设置建议：**优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、CST”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间\(Central Standard Time \(USA\) UT-6:00\)、澳大利亚中部时间\(Central Standard Time \(Australia\) UT+9:30\)、中国标准时间\(China Standard Time UT+8:00\)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。 +**设置建议：** 优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、CST”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间\(Central Standard Time \(USA\) UT-6:00\)、澳大利亚中部时间\ (Central Standard Time \(Australia\) UT+9:30\)、中国标准时间\(China Standard Time UT+8:00\)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。 ## IntervalStyle diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" "b/content/docs-lite/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" index 5122d0f90..fd1c0d055 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" @@ -16,7 +16,7 @@ **默认值：** 2s -**设置建议：**在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 +**设置建议：** 在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 ## candidate\_buf\_percent\_target diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md" "b/content/docs-lite/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md" index ca238ad18..ddeffe56e 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md" @@ -32,7 +32,7 @@ 该参数属于SIGHUP类型参数，请参考[表1](../DatabaseAdministrationGuide/参数设置.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中方式对应设置方法进行设置。 -**修改建议：**该参数的取值应和本地磁盘大小相关，建议设置为磁盘大小的50%。 +**修改建议：** 该参数的取值应和本地磁盘大小相关，建议设置为磁盘大小的50%。 **取值范围**：整型，0\~2147483647‬ diff --git "a/content/docs-lite/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" "b/content/docs-lite/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" index 19e69f5b1..6bb710c8c 100644 --- "a/content/docs-lite/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" +++ "b/content/docs-lite/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" @@ -166,7 +166,7 @@ **默认值：** 2048（即16MB） -**设置建议：**每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 +**设置建议：** 每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 ## wal\_writer\_delay @@ -289,7 +289,7 @@ ## force\_promote -**参考说明：**备机强切功能开关。 +**参考说明：** 备机强切功能开关。 备机强切在集群故障状态下，以丢失部分数据为代价换取集群尽可能快的恢复服务；是集群状态为不可用时的一个逃生方法，不建议频繁触发。如果操作者不清楚备机强切后丢失数据对业务的影响，请勿使用本功能。 diff --git "a/content/docs-lite/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" "b/content/docs-lite/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" index f2eb3c903..cd231a355 100644 --- "a/content/docs-lite/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" +++ "b/content/docs-lite/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" @@ -2,47 +2,47 @@ ## targetServerType -**原理：**值为master时会依次尝试连接串中配置的ip，直到能够连接到集群中的主机， +**原理：** 值为master时会依次尝试连接串中配置的ip，直到能够连接到集群中的主机， 值为slave时会依次尝试连接串中配置的ip，直到能够连接到集群中的备机（查询语句为：select local\_role, db\_state from pg\_stat\_get\_stream\_replications\(\);）。 -**建议：**有写操作的业务建议配置master，以保证主备切换后能正常连接主机，但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建连，导致业务语句无法正常执行。 +**建议：** 有写操作的业务建议配置master，以保证主备切换后能正常连接主机，但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建连，导致业务语句无法正常执行。 ## hostRecheckSeconds -**原理：**JDBC内部存储的dn列表保持可信的时间，未超过此时间时会从中直接读取存储的主机地址，当超过此时间时或者在可信时间内连接主机失败时会通过更新dn列表中该节点状态，之后连接其他的ip。 +**原理：** JDBC内部存储的dn列表保持可信的时间，未超过此时间时会从中直接读取存储的主机地址，当超过此时间时或者在可信时间内连接主机失败时会通过更新dn列表中该节点状态，之后连接其他的ip。 -**建议：**默认值10s，建议根据业务进行调整，配合参数targetServerType使用。 +**建议：** 默认值10s，建议根据业务进行调整，配合参数targetServerType使用。 ## allowReadOnly -**原理：**是否可以通过setReadOnly来修改事务访问模式，如果为true则可以修改，如果为false则无法通过此接口来修改，修改语句为SET SESSION CHARACTERISTICS AS TRANSACTION + READ ONLY / READ WEITE。 +**原理：** 是否可以通过setReadOnly来修改事务访问模式，如果为true则可以修改，如果为false则无法通过此接口来修改，修改语句为SET SESSION CHARACTERISTICS AS TRANSACTION + READ ONLY / READ WEITE。 -**建议：**保持默认值为true。 +**建议：** 保持默认值为true。 ## fetchsize -**原理：**fetchsize在设置为n后，数据库服务器端在执行查询后，调用者在执行resultset.next\(\)的时候，JDBC会先与服务器端进行通信，取n条数据到jdbc的客户端中，然后返回第一条给调用者，当调用者取到第n+1条数据的时候，会再次到数据库服务端去拿数据。 +**原理：** fetchsize在设置为n后，数据库服务器端在执行查询后，调用者在执行resultset.next\(\)的时候，JDBC会先与服务器端进行通信，取n条数据到jdbc的客户端中，然后返回第一条给调用者，当调用者取到第n+1条数据的时候，会再次到数据库服务端去拿数据。 -**作用：**避免了数据库一下把所有结果全部传输到客户端来，将客户端的内存资源撑爆掉。 +**作用：** 避免了数据库一下把所有结果全部传输到客户端来，将客户端的内存资源撑爆掉。 -**建议：**建议根据自身的业务查询数据数量和客户端机器内存情况来配置此参数，设置fetchsize时要关闭自动提交\(autocommit=false\)，否则会导致fetchsize无法生效。 +**建议：** 建议根据自身的业务查询数据数量和客户端机器内存情况来配置此参数，设置fetchsize时要关闭自动提交\(autocommit=false\)，否则会导致fetchsize无法生效。 ## defaultRowFetchSize -**作用：**fetchsize默认值为0，defaultRowFetchSize会修改fetchsize的默认值。 +**作用：** fetchsize默认值为0，defaultRowFetchSize会修改fetchsize的默认值。 ## batchMode -**作用：**用于确定是否使用batch模式连接。默认值为on，开启后可以提升批量更新的性能，同时批量更新的返回值会发生改变，例如，批量插入三条数据，在开启时返回值为\[3,0,0\]，在关闭后返回值为\[1,1,1\]。 +**作用：** 用于确定是否使用batch模式连接。默认值为on，开启后可以提升批量更新的性能，同时批量更新的返回值会发生改变，例如，批量插入三条数据，在开启时返回值为\[3,0,0\]，在关闭后返回值为\[1,1,1\]。 -**建议：**如果本身业务框架\(例如hibernate\)在批量更新时会检测返回值，可以通过调整此参数来解决。 +**建议：** 如果本身业务框架\(例如hibernate\)在批量更新时会检测返回值，可以通过调整此参数来解决。 ## loginTimeout -**作用：**控制与数据库建联时间，其中时间包括connectiontimeout和sockettimeout，超过阈值则退出。计算方式为：loginTimeout=connectiontimeout\*节点数量+连接认证时间+初始化语句执行时间。 +**作用：** 控制与数据库建联时间，其中时间包括connectiontimeout和sockettimeout，超过阈值则退出。计算方式为：loginTimeout=connectiontimeout\*节点数量+连接认证时间+初始化语句执行时间。 -**建议：**配置后会每次建连都会开启一个异步线程，在连接数较多的情况可能会导致客户端压力增大，如果业务确认需要此设置此参数，需要注意在集中式下建议调整为3\*connectTimeout防止在网络异常情况且第三个IP为主的情况下，无法连接。 +**建议：** 配置后会每次建连都会开启一个异步线程，在连接数较多的情况可能会导致客户端压力增大，如果业务确认需要此设置此参数，需要注意在集中式下建议调整为3\*connectTimeout防止在网络异常情况且第三个IP为主的情况下，无法连接。 >![](public_sys-resources/icon-notice.gif) **须知：** > @@ -50,21 +50,21 @@ ## cancelSignalTimeout -**作用：**发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒。主要为了防止连接超时取消时本身执行超时检测。 +**作用：** 发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒。主要为了防止连接超时取消时本身执行超时检测。 -**建议：**默认值为10秒，建议根据业务进行调整。 +**建议：** 默认值为10秒，建议根据业务进行调整。 ## connectTimeout -**作用：**控制建立连接时套接字超时阈值（此时是jdbc通过socket连接到数据的时间，并不是返回connection对象的时间），超过阈值查找下一个IP。 +**作用：** 控制建立连接时套接字超时阈值（此时是jdbc通过socket连接到数据的时间，并不是返回connection对象的时间），超过阈值查找下一个IP。 -**建议：**该参数决定了每个节点TCP连接建立的最大超时时间，如果某节点网络故障，与该节点建立连接时会等待connectTimeout超时，然后尝试连接下一个节点。考虑到网络抖动，时延等情况，默认建议设置为3s。 +**建议：** 该参数决定了每个节点TCP连接建立的最大超时时间，如果某节点网络故障，与该节点建立连接时会等待connectTimeout超时，然后尝试连接下一个节点。考虑到网络抖动，时延等情况，默认建议设置为3s。 ## socketTimeout -**作用：**控制套接字操作超时值，如果业务语句执行或者从网络读取数据流超过此阈值，连接中断（即语句超过规定时间执行，没有数据返回的时候）。 +**作用：** 控制套接字操作超时值，如果业务语句执行或者从网络读取数据流超过此阈值，连接中断（即语句超过规定时间执行，没有数据返回的时候）。 -**建议：**该参数限制单SQL最长的执行时间，单语句执行超过该值则会超时报错退出，建议根据业务特征进行配置。 +**建议：** 该参数限制单SQL最长的执行时间，单语句执行超过该值则会超时报错退出，建议根据业务特征进行配置。 ## socketTimeoutInConnecting ## **作用：** 控制建连阶段套接字操作超时值，在建连阶段，如果从网络中读取数据流超过此阈值，则尝试查找下一个节点建连。 @@ -73,37 +73,37 @@ ## autosave -**作用：**值为always时可以在事务中每个语句前面设置一个savepoint点，在事务中语句执行报错时会返回到最近的上一个savepoint点，可以让事务中后续语句可以正常执行，最终可以正常提交。 +**作用：** 值为always时可以在事务中每个语句前面设置一个savepoint点，在事务中语句执行报错时会返回到最近的上一个savepoint点，可以让事务中后续语句可以正常执行，最终可以正常提交。 -**建议：**不建议设置此参数，性能劣化严重。 +**建议：** 不建议设置此参数，性能劣化严重。 ## currentSchema -**作用：**设置当前连接的schema，如果未设置，则默认schema为连接使用的用户名。 +**作用：** 设置当前连接的schema，如果未设置，则默认schema为连接使用的用户名。 -**建议：**建议配置此参数，业务数据所在的schema。 +**建议：** 建议配置此参数，业务数据所在的schema。 ## prepareThreshold -**作用：**默认值为5，如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令，会将其缓存起来，提升执行速度。 +**作用：** 默认值为5，如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令，会将其缓存起来，提升执行速度。 -**建议：**默认值为5，根据业务需要进行调整。 +**建议：** 默认值为5，根据业务需要进行调整。 ## preparedStatementCacheQueries -**作用：**确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement\(\)调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。 +**作用：** 确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement\(\)调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。 -**建议：**默认值为256，根据业务需要进行调整。配合prepareThreshold使用。 +**建议：** 默认值为256，根据业务需要进行调整。配合prepareThreshold使用。 ## blobMode -**作用：**setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。例如在preparestatement和callablestatement对象中对参数进行赋值操作。 +**作用：** setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。例如在preparestatement和callablestatement对象中对参数进行赋值操作。 -**建议：**默认值为true。 +**建议：** 默认值为true。 ## setAutocommit方法 -**作用：**值为true时，执行每个语句都会自动开启事务，在执行结束后自动提交事务，即每个语句都是一个事务。值为false时，会自动开启一个事务，事务需要通过执行SQL手动提交。 +**作用：** 值为true时，执行每个语句都会自动开启事务，在执行结束后自动提交事务，即每个语句都是一个事务。值为false时，会自动开启一个事务，事务需要通过执行SQL手动提交。 -**建议：**根据业务特征进行调整，如果基于性能或者其它方面考虑，需要关闭autocommit时，需要应用程序自己来保证事务的提交。例如，在指定的业务SQL执行完之后做显式提交，特别是客户端退出之前务必保证所有的事务已经提交。 +**建议：** 根据业务特征进行调整，如果基于性能或者其它方面考虑，需要关闭autocommit时，需要应用程序自己来保证事务的提交。例如，在指定的业务SQL执行完之后做显式提交，特别是客户端退出之前务必保证所有的事务已经提交。 diff --git "a/content/docs-lite/zh/docs/GettingStarted/\344\275\277\347\224\250openGauss.md" "b/content/docs-lite/zh/docs/GettingStarted/\344\275\277\347\224\250openGauss.md" index 21b215383..0f9e69332 100644 --- "a/content/docs-lite/zh/docs/GettingStarted/\344\275\277\347\224\250openGauss.md" +++ "b/content/docs-lite/zh/docs/GettingStarted/\344\275\277\347\224\250openGauss.md" @@ -59,7 +59,7 @@ openGauss正常运行。 使用GRANT命令进行相关权限设置，具体操作请参考[GRANT](../SQLReference/GRANT.md)。 - **引申信息：**关于数据库用户的更多信息请参考[管理用户及权限](../DatabaseAdministrationGuide/管理用户及权限.md)。 + **引申信息：** 关于数据库用户的更多信息请参考[管理用户及权限](../DatabaseAdministrationGuide/管理用户及权限.md)。 4. 创建数据库。 diff --git "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" index 88472129f..95ddac934 100644 --- "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" +++ "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" @@ -456,7 +456,7 @@ Filter: (c1 = t1.c1) ## 更多优化示例 -**示例：**修改select语句，将子查询修改为和主表的join，或者修改为可以提升的subquery，但是在修改前后需要保证语义的正确性。 +**示例：** 修改select语句，将子查询修改为和主表的join，或者修改为可以提升的subquery，但是在修改前后需要保证语义的正确性。 ``` explain (costs off) select * from t1 where t1.c1 in (select t2.c1 from t2 where t1.c1 = t2.c2); diff --git "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" index a318b574d..9db9758e1 100644 --- "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" +++ "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" @@ -10,7 +10,7 @@ ## 算子级调优示例 -**示例1：**基表扫描时，对于点查或者范围扫描等过滤大量数据的查询，如果使用SeqScan全表扫描会比较耗时，可以在条件列上建立索引选择IndexScan进行索引扫描提升扫描效率。 +**示例1：** 基表扫描时，对于点查或者范围扫描等过滤大量数据的查询，如果使用SeqScan全表扫描会比较耗时，可以在条件列上建立索引选择IndexScan进行索引扫描提升扫描效率。 ``` openGauss=# explain (analyze on, costs off) select * from store_sales where ss_sold_date_sk = 2450944; @@ -40,7 +40,7 @@ openGauss=# explain (analyze on, costs off) select * from store_sales_row where 上述例子中，全表扫描返回3360条数据，过滤掉大量数据，在ss\_sold\_date\_sk列上建立索引后，使用IndexScan扫描效率显著提高，从3.6秒提升到13毫秒。 -**示例2：**如果从执行计划中看，两表join选择了NestLoop，而实际行数比较大时，NestLoop Join可能执行比较慢。如下的例子中NestLoop耗时181秒，如果设置参数enable\_mergejoin=off关掉Merge Join，同时设置参数enable\_nestloop=off关掉NestLoop，让优化器选择HashJoin，则Join耗时提升至200多毫秒。 +**示例2：** 如果从执行计划中看，两表join选择了NestLoop，而实际行数比较大时，NestLoop Join可能执行比较慢。如下的例子中NestLoop耗时181秒，如果设置参数enable\_mergejoin=off关掉Merge Join，同时设置参数enable\_nestloop=off关掉NestLoop，让优化器选择HashJoin，则Join耗时提升至200多毫秒。 ![](figures/12-4-5-4-算子级调优(示例错乱调整1).png) diff --git "a/content/docs-lite/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" "b/content/docs-lite/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" index 8901f11ff..72e8f2214 100644 --- "a/content/docs-lite/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" +++ "b/content/docs-lite/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" @@ -6,7 +6,7 @@ 显式游标处理需六个PL/SQL步骤： -1. **定义静态游标：**就是定义一个游标名，以及与其相对应的SELECT语句。 +1. **定义静态游标：** 就是定义一个游标名，以及与其相对应的SELECT语句。 定义静态游标的语法图，请参见[图1](#zh-cn_topic_0283137015_zh-cn_topic_0237122244_zh-cn_topic_0059778930_f3cd97ed9f2474aa785f5626e468a75de)。 @@ -29,7 +29,7 @@ >+ 根据执行计划的不同，系统会自动判断该游标是否可以用于以倒序的方式检索数据行。 >+ 语法上支持parameter为输出参数，但其行为与输入参数保持一致。 - **定义动态游标：**指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。 + **定义动态游标：** 指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。 定义动态游标的语法图，请参见[图2](#zh-cn_topic_0283137015_zh-cn_topic_0237122244_zh-cn_topic_0059778930_f1579c1867b984124b10da33d032a55b0)和[图3](#zh-cn_topic_0283137015_zh-cn_topic_0237122244_zh-cn_topic_0059778930_fceaf870eaa73494496e8a65e7afc8cec)。 @@ -39,14 +39,14 @@ **图 3** dynamic\_cursor\_define::= ![](figures/dynamic_cursor_define.png "dynamic_cursor_define") -2. **打开静态游标：**就是执行游标所对应的SELECT语句，将其查询结果放入工作区，并且指针指向工作区的首部，标识游标结果集合。如果游标查询语句中带有FOR UPDATE选项，OPEN语句还将锁定数据库表中游标结果集合对应的数据行。 +2. **打开静态游标：** 就是执行游标所对应的SELECT语句，将其查询结果放入工作区，并且指针指向工作区的首部，标识游标结果集合。如果游标查询语句中带有FOR UPDATE选项，OPEN语句还将锁定数据库表中游标结果集合对应的数据行。 打开静态游标的语法图，请参见[图4](#zh-cn_topic_0283137015_zh-cn_topic_0237122244_zh-cn_topic_0059778930_fac5b397fa6184f35a416626255a9280d)。 **图 4** open\_static\_cursor::= ![](figures/open_static_cursor.png "open_static_cursor") - **打开动态游标：**可以通过OPEN FOR语句打开动态游标，动态绑定SQL语句。 + **打开动态游标：** 可以通过OPEN FOR语句打开动态游标，动态绑定SQL语句。 打开动态游标的语法图，请参见[图5](#zh-cn_topic_0283137015_zh-cn_topic_0237122244_zh-cn_topic_0059778930_f8e95270034c744b3bec53bd78cf56a22)。 diff --git "a/content/docs-lite/zh/docs/ToolandCommandReference/gsql\346\246\202\350\277\260.md" "b/content/docs-lite/zh/docs/ToolandCommandReference/gsql\346\246\202\350\277\260.md" index b0af897c5..8462c3ab8 100644 --- "a/content/docs-lite/zh/docs/ToolandCommandReference/gsql\346\246\202\350\277\260.md" +++ "b/content/docs-lite/zh/docs/ToolandCommandReference/gsql\346\246\202\350\277\260.md" @@ -2,14 +2,14 @@ ## 基本功能 -- **连接数据库：**默认只支持从服务器本机连接，如果需要连接到远端的数据库，必须在服务端进行配置。详细操作请参见《快速入门》中“访问openGauss \> 使用gsql访问openGauss”章节。 +- **连接数据库：** 默认只支持从服务器本机连接，如果需要连接到远端的数据库，必须在服务端进行配置。详细操作请参见《快速入门》中“访问openGauss \> 使用gsql访问openGauss”章节。 >![](public_sys-resources/icon-note.gif) **说明：** >gsql创建连接时，会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 >针对此问题，可以参考[常见问题处理](常见问题处理-gsql.md)。 -- **执行SQL语句：**支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 -- **执行元命令：**元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果，以及连接到新的数据库等。元命令的详细说明请参见[元命令参考](元命令参考.md)。 +- **执行SQL语句：** 支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 +- **执行元命令：** 元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果，以及连接到新的数据库等。元命令的详细说明请参见[元命令参考](元命令参考.md)。 ## 高级特性 diff --git "a/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\345\242\236\345\274\272\347\211\271\346\200\247.md" "b/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\345\242\236\345\274\272\347\211\271\346\200\247.md" index 320e9d2f6..429de0c57 100644 --- "a/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\345\242\236\345\274\272\347\211\271\346\200\247.md" +++ "b/content/zh/docs/AboutopenGauss/\344\274\201\344\270\232\347\272\247\345\242\236\345\274\272\347\211\271\346\200\247.md" @@ -41,16 +41,16 @@ openGauss支持： 数据分区带来的好处在于： -- **改善可管理性：**利用分区，可以将表和索引划分为一些更小、更易管理的单元。这样，数据库管理员在进行数据管理时就能采取“分而治之”的方法。 有了分区，维护操作可以专门针对表的特定部分执行。 -- **可提升删除操作的性能：**删除数据时可以删除整个分区，与分别删除每行相比，这种操作非常高效和快速。 +- **改善可管理性：** 利用分区，可以将表和索引划分为一些更小、更易管理的单元。这样，数据库管理员在进行数据管理时就能采取“分而治之”的方法。 有了分区，维护操作可以专门针对表的特定部分执行。 +- **可提升删除操作的性能：** 删除数据时可以删除整个分区，与分别删除每行相比，这种操作非常高效和快速。 删除分区表与删除普通表的语法一致，都是通过DROP TABLE语法进行删除。 -- **改善查询性能：**通过限制要检查或操作的数据数量，分区可带来许多性能优势。 +- **改善查询性能：** 通过限制要检查或操作的数据数量，分区可带来许多性能优势。 分区剪枝：分区剪枝（也称为分区消除）是openGauss在执行时过滤掉不需要扫描的分区，只对相关的分区进行扫描的技术。分区剪枝通常可以将查询性能提高若干数量级。 -- **智能化分区联接：**通过使用一种称为智能化分区联接的技术，分区还可以改善多表联接的性能。当将两个表联接在一起，并且至少其中一个表使用联接键进行分区时，可以应用智能化分区联接。智能化分区联接将一个大型联接分为多个较小的联接，这些较小的联接包含与联接的表“相同”的数据集。这里，“相同”定义为恰好包含联接的两端中相同的分区键值集，因此可以确保只有这些“相同”数据集的联接才会有效，而不必考虑其他数据集，目前不支持列表分区和哈希分区。 +- **智能化分区联接：** 通过使用一种称为智能化分区联接的技术，分区还可以改善多表联接的性能。当将两个表联接在一起，并且至少其中一个表使用联接键进行分区时，可以应用智能化分区联接。智能化分区联接将一个大型联接分为多个较小的联接，这些较小的联接包含与联接的表“相同”的数据集。这里，“相同”定义为恰好包含联接的两端中相同的分区键值集，因此可以确保只有这些“相同”数据集的联接才会有效，而不必考虑其他数据集，目前不支持列表分区和哈希分区。 ## 向量化执行和行列混合引擎 diff --git a/content/zh/docs/BriefTutorial/DCF.md b/content/zh/docs/BriefTutorial/DCF.md index 3533f434e..57f8b7a91 100644 --- a/content/zh/docs/BriefTutorial/DCF.md +++ b/content/zh/docs/BriefTutorial/DCF.md @@ -35,8 +35,8 @@ DCF功能架构如[图1](#fig31591049102410)所示，主要包括：功能模块 DCF在标准的multi-paxos基础上，支持在线添加、删除节点，支持在线将leader能力转让给其他节点。这更适合广泛业务场景，构建开发的生态。 - **支持优先级选主和策略化多数派** - - **策略化多数派：**经典Paxos 理论中，多数派达成一致后数据就可以提交，而多数派是非特定的，并不能保证某个或某些节点一定能得到完整的数据。在实际应用中，往往是地理位置较近的节点会拥有强一致的数据，而地理位置较远的节点，一直处于非强一致的状态，在发生城市级容灾的时候无法激活为主节点，形同虚设。策略化多数派能力，可以让用户通过动态配置，指定某个或某些节点必须保有强一致的数据，在出现容灾需求的时，可以立即激活为主节点。 - - **优先级选主：**用户可以指定各个节点的优先级。DCF严格按照指定的优先级选主，只有在优先级高的节点全部不可用时，才会激活优先级低的节点。 + - **策略化多数派：** 经典Paxos 理论中，多数派达成一致后数据就可以提交，而多数派是非特定的，并不能保证某个或某些节点一定能得到完整的数据。在实际应用中，往往是地理位置较近的节点会拥有强一致的数据，而地理位置较远的节点，一直处于非强一致的状态，在发生城市级容灾的时候无法激活为主节点，形同虚设。策略化多数派能力，可以让用户通过动态配置，指定某个或某些节点必须保有强一致的数据，在出现容灾需求的时，可以立即激活为主节点。 + - **优先级选主：** 用户可以指定各个节点的优先级。DCF严格按照指定的优先级选主，只有在优先级高的节点全部不可用时，才会激活优先级低的节点。 - **支持节点角色多样性** diff --git a/content/zh/docs/BriefTutorial/Ustore.md b/content/zh/docs/BriefTutorial/Ustore.md index 96443c648..c71a91c9f 100644 --- a/content/zh/docs/BriefTutorial/Ustore.md +++ b/content/zh/docs/BriefTutorial/Ustore.md @@ -12,9 +12,9 @@ Ustore存储引擎结合UNDO空间，可以实现更高效、更全面的闪回 ## 核心优势 -- **高性能：**对插入、更新、删除等不同负载的业务，性能以及资源使用表现相对均衡。更新操作采用原地更新模式在频繁更新类的业务场景下可拥有更高、更平稳的性能表现。适应“短”（事务短）、“频”（更新操作频繁）、“快”（性能要求高）的典型OLTP类业务场景。 -- **高效存储：**支持最大限度的原位更新, 极大节约了空间；将回滚段、数据页面分离存储，具备更高效、平稳的IO使用能力，UNDO子系统采用NUMA-aware设计，具有更好的多核扩展性，UNDO空间统一分配，集中回收，复用效率更高，存储空间使用更加高效、平稳。 -- **细粒度资源控制：**Ustore引擎提供多维度的事务“监管”方式，可基于事务运行时长、单事务使用UNDO空间大小、以及整体UNDO空间限制等方式对事务运行进行“监管”，防止异常、非预期内的行为出现，方便数据库管理员对数据库系统资源使用进行规范和约束。 +- **高性能：** 对插入、更新、删除等不同负载的业务，性能以及资源使用表现相对均衡。更新操作采用原地更新模式在频繁更新类的业务场景下可拥有更高、更平稳的性能表现。适应“短”（事务短）、“频”（更新操作频繁）、“快”（性能要求高）的典型OLTP类业务场景。 +- **高效存储：** 支持最大限度的原位更新, 极大节约了空间；将回滚段、数据页面分离存储，具备更高效、平稳的IO使用能力，UNDO子系统采用NUMA-aware设计，具有更好的多核扩展性，UNDO空间统一分配，集中回收，复用效率更高，存储空间使用更加高效、平稳。 +- **细粒度资源控制：** Ustore引擎提供多维度的事务“监管”方式，可基于事务运行时长、单事务使用UNDO空间大小、以及整体UNDO空间限制等方式对事务运行进行“监管”，防止异常、非预期内的行为出现，方便数据库管理员对数据库系统资源使用进行规范和约束。 Ustore存储引擎可以在数据频繁更新场景下性能依旧稳如泰山，使业务系统运行更加平稳，适应更多业务场景和工作负载，特别是对性能和稳定性有更高要求的金融核心业务场景。 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" "b/content/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" index aa06dde0c..113a68dd8 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/MOT\346\201\242\345\244\215\346\227\266\351\227\264\347\233\256\346\240\207_RTO\345\222\214\345\206\267\345\220\257\345\212\250\346\227\266\351\227\264.md" @@ -22,7 +22,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 **图 1** 冷启动时间性能基准 ![](figures/cold-start-time-performance-benchmarks2.png "冷启动时间性能基准") -- 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 +- 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）** 表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 >![](public_sys-resources/icon-note.png) **说明：** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/MOT\347\272\265\345\220\221\346\211\251\345\256\271\346\236\266\346\236\204.md" "b/content/zh/docs/DatabaseAdministrationGuide/MOT\347\272\265\345\220\221\346\211\251\345\256\271\346\236\266\346\236\204.md" index ab0110778..55f2955cd 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/MOT\347\272\265\345\220\221\346\211\251\345\256\271\346\236\266\346\236\204.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/MOT\347\272\265\345\220\221\346\211\251\345\256\271\346\236\266\346\236\204.md" @@ -13,7 +13,7 @@ MOT旨在实现以下目标： - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 -- **极低的事务性时延：**与市场上任何其他OLTP供应商相比，MOT提供事务性存储引擎，可以达到极低的事务时延。 +- **极低的事务性时延**：与市场上任何其他OLTP供应商相比，MOT提供事务性存储引擎，可以达到极低的事务时延。 - **无缝集成和利用openGauss产品**：MOT事务引擎与openGauss产品标准无缝集成。通过这种方式，MOT最大限度地重用了位于其事务性存储引擎顶部的openGauss层功能。 ## 设计原则 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" "b/content/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" index cfd6f5785..f15800b14 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\346\211\251\345\261\225FDW\344\270\216\345\205\266\344\273\226openGauss\347\211\271\346\200\247.md" @@ -34,9 +34,9 @@ MOT DW机制将指令传递给MOT存储引擎，用于实际建表。同样， 存储引擎负责存储、读取、更新和删除底层内存和存储系统中的数据。存储引擎不处理日志、检查点和恢复，特别是因为某些事务包含多个不同存储引擎的表。因此，为了数据持久化和复制，openGauss封装使用如下高可用性设施： -- **持久性**：MOT引擎通过WAL记录使数据持久化，WAL记录使用openGauss的XLOG接口。这为openGauss提供了使用相同API进行复制的好处。具体请参见[MOT持久性概念](MOT持久性概念.md)。 -- **检查点设定：**通过向openGauss Checkpointer注册回调来启用MOT检查点每当执行通用数据库检查点时，MOT检查点也被调用。MOT保留了检查点的日志序列号（LSN），以便与openGauss恢复对齐。MOT Checkpointing算法是高度优化的异步算法，不会停止并发事务。具体请参见[MOT检查点概念](MOT检查点概念.md)。 -- **恢复：**启动时，openGauss首先调用MOT回调，通过加载到内存行并创建索引来恢复MOT检查点，然后根据检查点的LSN重放记录来执行WAL恢复。MOT检查点使用多线程并行恢复，每个线程读取不同的数据段。这使MOT检查点在多核硬件上的恢复速度相当快，尽管可能比仅重放WAL记录的基于磁盘的表慢一些。具体请参见[MOT恢复概念](MOT恢复概念.md)。 +- **持久性：** MOT引擎通过WAL记录使数据持久化，WAL记录使用openGauss的XLOG接口。这为openGauss提供了使用相同API进行复制的好处。具体请参见[MOT持久性概念](MOT持久性概念.md)。 +- **检查点设定：** 通过向openGauss Checkpointer注册回调来启用MOT检查点每当执行通用数据库检查点时，MOT检查点也被调用。MOT保留了检查点的日志序列号（LSN），以便与openGauss恢复对齐。MOT Checkpointing算法是高度优化的异步算法，不会停止并发事务。具体请参见[MOT检查点概念](MOT检查点概念.md)。 +- **恢复：** 启动时，openGauss首先调用MOT回调，通过加载到内存行并创建索引来恢复MOT检查点，然后根据检查点的LSN重放记录来执行WAL恢复。MOT检查点使用多线程并行恢复，每个线程读取不同的数据段。这使MOT检查点在多核硬件上的恢复速度相当快，尽管可能比仅重放WAL记录的基于磁盘的表慢一些。具体请参见[MOT恢复概念](MOT恢复概念.md)。 ## VACUUM和DROP diff --git "a/content/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" "b/content/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" index 7db1523cc..68b375dc4 100644 --- "a/content/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" +++ "b/content/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md" @@ -301,7 +301,7 @@ 参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中方式对应设置方法进行设置。 -**修改建议：**由流式容灾密码传递工具自动设置，不需要用户手动添加。 +**修改建议：** 由流式容灾密码传递工具自动设置，不需要用户手动添加。 **取值范围**：字符串 diff --git "a/content/zh/docs/DatabaseReference/\345\206\205\345\255\230-21.md" "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230-21.md" index 6cc534870..44dde8da1 100644 --- "a/content/zh/docs/DatabaseReference/\345\206\205\345\255\230-21.md" +++ "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230-21.md" @@ -120,7 +120,7 @@ shared\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB， 该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 -**取值说明：**整型，16 \~ 1073741823，单位为8KB。 +**取值说明：** 整型，16 \~ 1073741823，单位为8KB。 segment\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即segment\_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 @@ -140,7 +140,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信 **默认值：** 2GB -**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 +**设置建议：** 建议导入压力大的场景中增加数据库节点中此参数配置。 ## standby\_shared\_buffers\_fraction @@ -370,4 +370,4 @@ resilience_memory_reject_percent = '70,90' > ![](public_sys-resources/icon-notice.png) **须知：** > > - 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。 -> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 \ No newline at end of file +> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 diff --git "a/content/zh/docs/DatabaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md" index 25868c4d0..ec394379f 100644 --- "a/content/zh/docs/DatabaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md" +++ "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md" @@ -120,7 +120,7 @@ shared\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB， 该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 -**取值说明：**整型，16 \~ 1073741823，单位为8KB。 +**取值说明：** 整型，16 \~ 1073741823，单位为8KB。 segment\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即segment\_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 @@ -140,7 +140,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信 **默认值：** 2GB -**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 +**设置建议：** 建议导入压力大的场景中增加数据库节点中此参数配置。 ## standby\_shared\_buffers\_fraction @@ -396,4 +396,4 @@ resilience_memory_reject_percent = '70,90' > ![](public_sys-resources/icon-notice.png) **须知：** > > - 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。 -> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 \ No newline at end of file +> - 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 diff --git "a/content/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" "b/content/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" index 898ab58e9..000a142d4 100644 --- "a/content/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" +++ "b/content/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md" @@ -18,7 +18,7 @@ > >gs\_initdb会将这个参数初始化成与[lc\_time](#zh-cn_topic_0283136798_zh-cn_topic_0237124733_zh-cn_topic_0059778109_scbb410b3c5c94682a3eec218c7ff0220)一致的值。 -**设置建议：**优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、CST”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间\(Central Standard Time \(USA\) UT-6:00\)、澳大利亚中部时间\(Central Standard Time \(Australia\) UT+9:30\)、中国标准时间\(China Standard Time UT+8:00\)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。 +**设置建议：** 优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、CST”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间\(Central Standard Time \(USA\) UT-6:00\)、澳大利亚中部时间\(Central Standard Time \(Australia\) UT+9:30\)、中国标准时间\(China Standard Time UT+8:00\)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。 ## IntervalStyle diff --git "a/content/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" "b/content/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" index 7c7679a7c..49567fda6 100644 --- "a/content/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" +++ "b/content/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md" @@ -16,7 +16,7 @@ **默认值：** 2s -**设置建议：**在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 +**设置建议：** 在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 ## candidate\_buf\_percent\_target @@ -128,4 +128,4 @@ **取值范围**：整型，32～256 -**默认值**：256 \ No newline at end of file +**默认值**：256 diff --git "a/content/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" "b/content/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" index 68d28f31d..b50ed16e6 100644 --- "a/content/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" +++ "b/content/zh/docs/DatabaseReference/\350\256\276\347\275\256.md" @@ -170,7 +170,7 @@ **默认值：** 2048，即16MB -**设置建议：**每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 +**设置建议：** 每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 ## wal\_writer\_delay @@ -294,7 +294,7 @@ ## force\_promote -**参考说明：**备机强切功能开关。 +**参考说明：** 备机强切功能开关。 备机强切在集群故障状态下，以丢失部分数据为代价换取集群尽可能快的恢复服务；是集群状态为不可用时的一个逃生方法，不建议频繁触发。如果操作者不清楚备机强切后丢失数据对业务的影响，请勿使用本功能。 diff --git "a/content/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" "b/content/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" index b62ad0783..e4cec561f 100644 --- "a/content/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" +++ "b/content/zh/docs/DeveloperGuide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" @@ -2,68 +2,68 @@ ## targetServerType -**原理：**值为master时会依次尝试连接串中配置的ip，直到能够连接到集群中的主机， +**原理：** 值为master时会依次尝试连接串中配置的ip，直到能够连接到集群中的主机， 值为slave时会依次尝试连接串中配置的ip，直到能够连接到集群中的备机（查询语句为：select local\_role, db\_state from pg\_stat\_get\_stream\_replications\(\);）。 -**建议：**有写操作的业务建议配置master，以保证主备切换后能正常连接主机，但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建连，导致业务语句无法正常执行。 +**建议：** 有写操作的业务建议配置master，以保证主备切换后能正常连接主机，但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建连，导致业务语句无法正常执行。 ## hostRecheckSeconds -**原理：**JDBC内部存储的dn列表保持可信的时间，未超过此时间时会从中直接读取存储的主机地址，当超过此时间时或者在可信时间内连接主机失败时会通过更新dn列表中该节点状态，之后连接其他的ip。 +**原理：** JDBC内部存储的dn列表保持可信的时间，未超过此时间时会从中直接读取存储的主机地址，当超过此时间时或者在可信时间内连接主机失败时会通过更新dn列表中该节点状态，之后连接其他的ip。 -**建议：**默认值10s，建议根据业务进行调整，配合参数targetServerType使用。 +**建议：** 默认值10s，建议根据业务进行调整，配合参数targetServerType使用。 ## allowReadOnly -**原理：**是否可以通过setReadOnly来修改事务访问模式，如果为true则可以修改，如果为false则无法通过此接口来修改，修改语句为SET SESSION CHARACTERISTICS AS TRANSACTION + READ ONLY / READ WEITE。 +**原理：** 是否可以通过setReadOnly来修改事务访问模式，如果为true则可以修改，如果为false则无法通过此接口来修改，修改语句为SET SESSION CHARACTERISTICS AS TRANSACTION + READ ONLY / READ WEITE。 -**建议：**保持默认值为true。 +**建议：** 保持默认值为true。 ## fetchsize -**原理：**fetchsize在设置为n后，数据库服务器端在执行查询后，调用者在执行resultset.next\(\)的时候，JDBC会先与服务器端进行通信，取n条数据到jdbc的客户端中，然后返回第一条给调用者，当调用者取到第n+1条数据的时候，会再次到数据库服务端去拿数据。 +**原理：** fetchsize在设置为n后，数据库服务器端在执行查询后，调用者在执行resultset.next\(\)的时候，JDBC会先与服务器端进行通信，取n条数据到jdbc的客户端中，然后返回第一条给调用者，当调用者取到第n+1条数据的时候，会再次到数据库服务端去拿数据。 -**作用：**避免了数据库一下把所有结果全部传输到客户端来，将客户端的内存资源撑爆掉。 +**作用：** 避免了数据库一下把所有结果全部传输到客户端来，将客户端的内存资源撑爆掉。 -**建议：**建议根据自身的业务查询数据数量和客户端机器内存情况来配置此参数，设置fetchsize时要关闭自动提交\(autocommit=false\)，否则会导致fetchsize无法生效。 +**建议：** 建议根据自身的业务查询数据数量和客户端机器内存情况来配置此参数，设置fetchsize时要关闭自动提交\(autocommit=false\)，否则会导致fetchsize无法生效。 ## defaultRowFetchSize -**作用：**fetchsize默认值为0，defaultRowFetchSize会修改fetchsize的默认值。 +**作用：** fetchsize默认值为0，defaultRowFetchSize会修改fetchsize的默认值。 ## batchMode -**作用：**用于确定是否使用batch模式连接。默认值为on，开启后可以提升批量更新的性能，同时批量更新的返回值会发生改变，例如，批量插入三条数据，在开启时返回值为\[3,0,0\]，在关闭后返回值为\[1,1,1\]。 +**作用：** 用于确定是否使用batch模式连接。默认值为on，开启后可以提升批量更新的性能，同时批量更新的返回值会发生改变，例如，批量插入三条数据，在开启时返回值为\[3,0,0\]，在关闭后返回值为\[1,1,1\]。 -**建议：**如果本身业务框架\(例如hibernate\)在批量更新时会检测返回值，可以通过调整此参数来解决。 +**建议：** 如果本身业务框架\(例如hibernate\)在批量更新时会检测返回值，可以通过调整此参数来解决。 ## loginTimeout -**作用：**控制与数据库建联时间，其中时间包括connectiontimeout和sockettimeout，超过阈值则退出。计算方式为：loginTimeout=connectiontimeout\*节点数量+连接认证时间+初始化语句执行时间。 +**作用：** 控制与数据库建联时间，其中时间包括connectiontimeout和sockettimeout，超过阈值则退出。计算方式为：loginTimeout=connectiontimeout\*节点数量+连接认证时间+初始化语句执行时间。 -**建议：**配置后会每次建连都会开启一个异步线程，在连接数较多的情况可能会导致客户端压力增大，如果业务确认需要此设置此参数，需要注意在集中式下建议调整为3\*connectTimeout防止在网络异常情况且第三个IP为主的情况下，无法连接。 +**建议：** 配置后会每次建连都会开启一个异步线程，在连接数较多的情况可能会导致客户端压力增大，如果业务确认需要此设置此参数，需要注意在集中式下建议调整为3\*connectTimeout防止在网络异常情况且第三个IP为主的情况下，无法连接。 >![](public_sys-resources/icon-notice.png) **须知：** >此参数设置后对于多ip而言，时间是尝试连接ip的时间，可能会出现因为设置的值较小导致后面的ip无法连接的问题，例如设置了三个ip，如果logintimeout为5s，但前两个ip建连总共用了5s，第三个ip会无法进行连接，在集中式环境下，此最后一个ip恰好为主机，可能会导致自动寻主失败。 ## cancelSignalTimeout -**作用：**发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒。主要为了防止连接超时取消时本身执行超时检测。 +**作用：** 发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒。主要为了防止连接超时取消时本身执行超时检测。 -**建议：**默认值为10秒，建议根据业务进行调整。 +**建议：** 默认值为10秒，建议根据业务进行调整。 ## connectTimeout -**作用：**控制建立连接时套接字超时阈值（此时是jdbc通过socket连接到数据的时间，并不是返回connection对象的时间），超过阈值查找下一个IP。 +**作用：** 控制建立连接时套接字超时阈值（此时是jdbc通过socket连接到数据的时间，并不是返回connection对象的时间），超过阈值查找下一个IP。 -**建议：**该参数决定了每个节点TCP连接建立的最大超时时间，如果某节点网络故障，与该节点建立连接时会等待connectTimeout超时，然后尝试连接下一个节点。考虑到网络抖动，时延等情况，默认建议设置为3s。 +**建议：** 该参数决定了每个节点TCP连接建立的最大超时时间，如果某节点网络故障，与该节点建立连接时会等待connectTimeout超时，然后尝试连接下一个节点。考虑到网络抖动，时延等情况，默认建议设置为3s。 ## socketTimeout -**作用：**控制套接字操作超时值，如果业务语句执行或者从网络读取数据流超过此阈值，连接中断（即语句超过规定时间执行，没有数据返回的时候）。 +**作用：** 控制套接字操作超时值，如果业务语句执行或者从网络读取数据流超过此阈值，连接中断（即语句超过规定时间执行，没有数据返回的时候）。 -**建议：**该参数限制单SQL最长的执行时间，单语句执行超过该值则会超时报错退出，建议根据业务特征进行配置。 +**建议：** 该参数限制单SQL最长的执行时间，单语句执行超过该值则会超时报错退出，建议根据业务特征进行配置。 ## socketTimeoutInConnecting ## **作用：** 控制建连阶段套接字操作超时值，在建连阶段，如果从网络中读取数据流超过此阈值，则尝试查找下一个节点建连。 @@ -72,37 +72,37 @@ ## autosave -**作用：**值为always时可以在事务中每个语句前面设置一个savepoint点，在事务中语句执行报错时会返回到最近的上一个savepoint点，可以让事务中后续语句可以正常执行，最终可以正常提交。 +**作用：** 值为always时可以在事务中每个语句前面设置一个savepoint点，在事务中语句执行报错时会返回到最近的上一个savepoint点，可以让事务中后续语句可以正常执行，最终可以正常提交。 -**建议：**不建议设置此参数，性能劣化严重。 +**建议：** 不建议设置此参数，性能劣化严重。 ## currentSchema -**作用：**设置当前连接的schema，如果未设置，则默认schema为连接使用的用户名。 +**作用：** 设置当前连接的schema，如果未设置，则默认schema为连接使用的用户名。 -**建议：**建议配置此参数，业务数据所在的schema。 +**建议：** 建议配置此参数，业务数据所在的schema。 ## prepareThreshold -**作用：**默认值为5，如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令，会将其缓存起来，提升执行速度。 +**作用：** 默认值为5，如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令，会将其缓存起来，提升执行速度。 -**建议：**默认值为5，根据业务需要进行调整。 +**建议：** 默认值为5，根据业务需要进行调整。 ## preparedStatementCacheQueries -**作用：**确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement\(\)调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。 +**作用：** 确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement\(\)调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。 -**建议：**默认值为256，根据业务需要进行调整。配合prepareThreshold使用。 +**建议：** 默认值为256，根据业务需要进行调整。配合prepareThreshold使用。 ## blobMode -**作用：**setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。例如在preparestatement和callablestatement对象中对参数进行赋值操作。 +**作用：** setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。例如在preparestatement和callablestatement对象中对参数进行赋值操作。 -**建议：**默认值为true。 +**建议：** 默认值为true。 ## setAutocommit方法 -**作用：**值为true时，执行每个语句都会自动开启事务，在执行结束后自动提交事务，即每个语句都是一个事务。值为false时，会自动开启一个事务，事务需要通过执行SQL手动提交。 +**作用：** 值为true时，执行每个语句都会自动开启事务，在执行结束后自动提交事务，即每个语句都是一个事务。值为false时，会自动开启一个事务，事务需要通过执行SQL手动提交。 -**建议：**根据业务特征进行调整，如果基于性能或者其它方面考虑，需要关闭autocommit时，需要应用程序自己来保证事务的提交。例如，在指定的业务SQL执行完之后做显式提交，特别是客户端退出之前务必保证所有的事务已经提交。 +**建议：** 根据业务特征进行调整，如果基于性能或者其它方面考虑，需要关闭autocommit时，需要应用程序自己来保证事务的提交。例如，在指定的业务SQL执行完之后做显式提交，特别是客户端退出之前务必保证所有的事务已经提交。 diff --git "a/content/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" "b/content/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" index b7eebe329..e79ad3d4a 100644 --- "a/content/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" +++ "b/content/zh/docs/PerformanceTuningGuide/\345\255\220\346\237\245\350\257\242\350\260\203\344\274\230.md" @@ -467,7 +467,7 @@ Filter: (c1 = t1.c1) ## 更多优化示例 -**示例：**修改select语句，将子查询修改为和主表的join，或者修改为可以提升的subquery，但是在修改前后需要保证语义的正确性。 +**示例：** 修改select语句，将子查询修改为和主表的join，或者修改为可以提升的subquery，但是在修改前后需要保证语义的正确性。 ``` explain (costs off) select * from t1 where t1.c1 in (select t2.c1 from t2 where t1.c1 = t2.c2); diff --git "a/content/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" "b/content/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" index b6116f42b..9997f9640 100644 --- "a/content/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" +++ "b/content/zh/docs/PerformanceTuningGuide/\347\256\227\345\255\220\347\272\247\350\260\203\344\274\230.md" @@ -10,7 +10,7 @@ ## 算子级调优示例 -**示例1：**基表扫描时，对于点查或者范围扫描等过滤大量数据的查询，如果使用SeqScan全表扫描会比较耗时，可以在条件列上建立索引选择IndexScan进行索引扫描提升扫描效率。 +**示例1：** 基表扫描时，对于点查或者范围扫描等过滤大量数据的查询，如果使用SeqScan全表扫描会比较耗时，可以在条件列上建立索引选择IndexScan进行索引扫描提升扫描效率。 ``` openGauss=# explain (analyze on, costs off) select * from store_sales where ss_sold_date_sk = 2450944; diff --git "a/content/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" "b/content/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" index 458b689f1..5a4f75bcd 100644 --- "a/content/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" +++ "b/content/zh/docs/SQLReference/\346\230\276\345\274\217\346\270\270\346\240\207.md" @@ -29,7 +29,7 @@ >+ 根据执行计划的不同，系统会自动判断该游标是否可以用于以倒序的方式检索数据行。 >+ 语法上支持parameter为输出参数，但其行为与输入参数保持一致。 - **定义动态游标：**指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。 + **定义动态游标：** 指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。 定义动态游标的语法图，请参见[图2](#zh-cn_topic_0237122244_zh-cn_topic_0059778930_f1579c1867b984124b10da33d032a55b0)和[图3](#zh-cn_topic_0237122244_zh-cn_topic_0059778930_fceaf870eaa73494496e8a65e7afc8cec)。 @@ -46,7 +46,7 @@ **图 4** open\_static\_cursor::= ![](figures/open_static_cursor.png "open_static_cursor") - **打开动态游标：**可以通过OPEN FOR语句打开动态游标，动态绑定SQL语句。 + **打开动态游标：** 可以通过OPEN FOR语句打开动态游标，动态绑定SQL语句。 打开动态游标的语法图，请参见[图5](#zh-cn_topic_0237122244_zh-cn_topic_0059778930_f8e95270034c744b3bec53bd78cf56a22)。 diff --git a/content/zh/docs/ToolandCommandReference/gs_upgradectl.md b/content/zh/docs/ToolandCommandReference/gs_upgradectl.md index bd454b36c..7608e2b55 100644 --- a/content/zh/docs/ToolandCommandReference/gs_upgradectl.md +++ b/content/zh/docs/ToolandCommandReference/gs_upgradectl.md @@ -183,7 +183,7 @@ Successfully set finish flag. PreInstallationGuide succeeded. ``` -**示例二：**使用gs\_upgradectl脚本执行就地升级。 +**示例二：** 使用gs\_upgradectl脚本执行就地升级。 ``` gs_upgradectl -t upgrade -X /data/xml/3node_3c3d_1m2s_etcd.xml @@ -219,7 +219,7 @@ Once the check done, please execute following command to commit upgrade: gs_upgradectl -t commit-upgrade -X /data/xml/3node_3c3d_1m2s_etcd.xml ``` -**示例三：**使用gs\_upgradectl脚本执行自动回滚，撤销已经成功/失败的升级操作（升级回滚）。 +**示例三：** 使用gs\_upgradectl脚本执行自动回滚，撤销已经成功/失败的升级操作（升级回滚）。 ``` gs_upgradectl -t auto-rollback -X /data/xml/3node_3c3d_1m2s_etcd.xml @@ -244,7 +244,7 @@ Successfully cleaned new install path. Rollback succeeded. ``` -**示例四：**使用gs\_upgradectl脚本执行升级后提交（升级提交）。 +**示例四：** 使用gs\_upgradectl脚本执行升级后提交（升级提交）。 ``` gs_upgradectl -t commit -X /data/xml/3node_3c3d_1m2s_etcd.xml @@ -253,7 +253,7 @@ Successfully Cleaned old install path. Commit binary upgrade succeeded. ``` -**示例五：**使用gs\_upgradectl脚本执行指定节点升级。. +**示例五：** 使用gs\_upgradectl脚本执行指定节点升级。. 升级部分指定节点 ``` @@ -327,7 +327,7 @@ gs_upgradectl -t commit-upgrade -X /data/node2.xml Successfully upgrade all nodes. ``` -**示例六：**使用gs\_upgradectl脚本执行集群管理组件增量升级。 +**示例六：** 使用gs\_upgradectl脚本执行集群管理组件增量升级。 ``` gs_upgradectl -t upgrade-cm --upgarde-package /data/openGauss-3.1.0-CentOS-64bit-cm.tar.gz Start ot perform the upgrade of CM component in cluster. diff --git a/content/zh/docs/ToolandCommandReference/gsql.md b/content/zh/docs/ToolandCommandReference/gsql.md index 46654b9ee..061a275b5 100644 --- a/content/zh/docs/ToolandCommandReference/gsql.md +++ b/content/zh/docs/ToolandCommandReference/gsql.md @@ -6,15 +6,15 @@ gsql是openGauss提供在命令行下运行的数据库连接工具，可以通 **基本功能** -- **连接数据库：**详细操作请参见《快速入门》中“访问openGauss \> 使用gsql访问openGauss”章节。 +- **连接数据库：** 详细操作请参见《快速入门》中“访问openGauss \> 使用gsql访问openGauss”章节。 >![](public_sys-resources/icon-note.png) **说明：** > >gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 >针对此问题，可以参考[常见问题处理](#section1780814211263)。 -- **执行SQL语句：**支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 -- **执行元命令：**元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果、以及连接到新的数据库等。元命令的详细说明请参见[元命令参考](#section17631544132716)。 +- **执行SQL语句：** 支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 +- **执行元命令：** 元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果、以及连接到新的数据库等。元命令的详细说明请参见[元命令参考](#section17631544132716)。 **高级特性** diff --git "a/contribute/\350\264\241\347\214\256\344\272\213\350\277\271/\344\274\230\347\247\200\350\264\241\347\214\256\350\200\205\350\257\204\351\200\211.md" "b/contribute/\350\264\241\347\214\256\344\272\213\350\277\271/\344\274\230\347\247\200\350\264\241\347\214\256\350\200\205\350\257\204\351\200\211.md" index ae3daa20e..83a1042f9 100644 --- "a/contribute/\350\264\241\347\214\256\344\272\213\350\277\271/\344\274\230\347\247\200\350\264\241\347\214\256\350\200\205\350\257\204\351\200\211.md" +++ "b/contribute/\350\264\241\347\214\256\344\272\213\350\277\271/\344\274\230\347\247\200\350\264\241\347\214\256\350\200\205\350\257\204\351\200\211.md" @@ -22,8 +22,8 @@ openGauss Docs SIG月度活跃贡献者（1-2名）、半年度最佳贡献者 十月份月度活跃贡献者评选已启动，欢迎各位Docs SIG组成员在docs仓提交PR申报事迹。 - **提交格式：**MD文件，名称为“自荐/推荐+参评人姓名”，内容为“参评人姓名+推选理由+举证材料”。 - **截止时间：**次月5日 + **提交格式：** MD文件，名称为“自荐/推荐+参评人姓名”，内容为“参评人姓名+推选理由+举证材料”。 + **截止时间：** 次月5日 + **Docs SIG评审：** -- Gitee From 4611e690c7706a0721ad8cc61a7ed3f1c0b83f4f Mon Sep 17 00:00:00 2001 From: ExDevilLee Date: Mon, 5 Jun 2023 12:26:25 +0800 Subject: [PATCH 2/2] fix more Markdown style bugs --- ...6\272\220\345\210\251\347\224\250\347\216\207.md" | 2 +- .../zh/docs/DatabaseAdministrationGuide/mysql_fdw.md | 4 ++-- ...6\237\245\347\234\213\346\225\260\346\215\256.md" | 2 +- ...6\215\256\345\214\205\350\243\205\345\231\250.md" | 4 ++-- ...5\256\211\350\243\205\347\216\257\345\242\203.md" | 2 +- .../\350\241\214\346\225\260\347\232\204Hint.md" | 2 +- .../zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md | 4 ++-- ...7\216\257\345\242\203\351\203\250\347\275\262.md" | 2 +- ...4\275\277\347\224\250\345\207\206\345\244\207.md" | 4 ++-- ...4\275\277\347\224\250\347\244\272\344\276\213.md" | 2 +- content/zh/docs/BriefTutorial/DCF.md | 4 ++-- ...6\272\220\345\210\251\347\224\250\347\216\207.md" | 2 +- .../zh/docs/DatabaseAdministrationGuide/mysql_fdw.md | 8 ++++---- ...6\215\256\345\214\205\350\243\205\345\231\250.md" | 4 ++-- ...5\256\211\350\243\205\347\216\257\345\242\203.md" | 4 ++-- ...\242\203_\344\274\201\344\270\232\347\211\210.md" | 6 +++--- ...5\256\211\350\243\205\347\216\257\345\242\203.md" | 2 +- .../\350\241\214\346\225\260\347\232\204Hint.md" | 2 +- .../zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md | 4 ++-- .../zh/docs/ToolandCommandReference/gs_encrypt.md | 2 +- .../zh/docs/ToolandCommandReference/gs_upgradectl.md | 2 +- ...4\277\256\346\224\271\345\206\205\345\256\271.md" | 2 +- ...0\264\241\347\214\256\347\273\217\351\252\214.md" | 2 +- ...5\217\202\350\200\203\346\250\241\346\235\277.md" | 10 +++++----- ...5\217\202\350\200\203\346\250\241\346\235\277.md" | 12 ++++++------ 25 files changed, 47 insertions(+), 47 deletions(-) diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" index c102f3332..663ce07fd 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" @@ -3,7 +3,7 @@ 在4路96核512GB RAM的x86服务器上测试的资源利用率如下所示。MOT能够高效持续消耗几乎所有可用的CPU资源。例如，192核390万tpmC的CPU利用率几乎达到100%。 - tmpC：每分钟完成的TPC-C事务数以橙色条柱和左侧的Y轴**tpmC**表示。 -- CPU利用率（%）：CPU利用率由蓝色线条和右侧的Y轴**CPU%**表示。 +- CPU利用率（%）：CPU利用率由蓝色线条和右侧的Y轴**CPU%** 表示。 **图 1** 资源利用率性能基准 ![](figures/资源利用率性能基准.png "资源利用率性能基准") diff --git a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md index f03739fc4..e84df64dc 100644 --- a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md +++ b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md @@ -10,9 +10,9 @@ mysql\_fdw是一款[开源插件](https://github.com/EnterpriseDB/mysql_fdw)。o 配置好源后，使用**yum install MariaDB-devel MariaDB-shared**安装相关开发库。另外**MariaDB-client**是MariaDB的客户端工具，也可以根据需要安装，用于连接MariaDB进行测试。 -安装好开发包后，就可以开始编译mysql\_fdw了。编译时需要在执行**configure**时，加入**--enable-mysql-fdw**选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 **软件安装编译** ） +安装好开发包后，就可以开始编译mysql\_fdw了。编译时需要在执行**configure**时，加入 **--enable-mysql-fdw** 选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 **软件安装编译** ） -编译完成后，编译产物为**mysql\_fdw.so** ，位于安装目录的**lib/postgresql/** 下。mysql\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/extension/**下。 +编译完成后，编译产物为**mysql\_fdw.so** ，位于安装目录的**lib/postgresql/** 下。mysql\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/extension/** 下。 如果编译安装时，没有加入 **--enable-mysql-fdw** 选项，可以在openGauss安装完成后，再次编译mysql\_fdw，然后手动将编译产物**mysql\_fdw.so**放到对应的安装目录 **lib/postgresql/**，将 **mysql\_fdw--1.0--1.1. sql、mysql\_fdw--1.1.sql，mysql\_fdw--1.0.sql，mysql\_fdw.control** 放到对应的安装目录 **share/postgresql/extension/** 即可。 diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\237\245\347\234\213\346\225\260\346\215\256.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\237\245\347\234\213\346\225\260\346\215\256.md" index ec2145db7..fd5188f36 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\237\245\347\234\213\346\225\260\346\215\256.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\346\237\245\347\234\213\346\225\260\346\215\256.md" @@ -12,7 +12,7 @@ openGauss=# \d+ customer_t1; ``` -- 执行如下命令查询表customer\_t1****的数据量。 +- 执行如下命令查询表customer\_t1的数据量。 ``` openGauss=# SELECT count(*) FROM customer_t1; diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" index 5eaa2ca0b..084056791 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" @@ -12,9 +12,9 @@ oracle\_fdw（foreign data wrapper for oracle）用于Oracle的外部数据包 安装好开发包后，就可以开始编译oracle\_fdw了。编译时需要在执行**configure**时，加入 **--enable-oracle-fdw** 选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 **软件安装编译** ） -编译完成后，编译产物为 **oracle\_fdw.so**，位于安装目录的 **lib/postgresql/**下。oracle\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/extension/**下。 +编译完成后，编译产物为 **oracle\_fdw.so**，位于安装目录的 **lib/postgresql/** 下。oracle\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/extension/** 下。 -如果编译安装时，没有加入 **--enable-oracle-fdw** 选项，可以在openGauss安装完成后，再次编译oracle\_fdw，然后手动将编译产物 **oracle\_fdw.so**放到对应的安装目录 **lib/postgresql/** ，将 **oracle\_fdw--1.0--1.1.sql，oracle\_fdw--1.1.sql，oracle\_fdw.control**放到对应的安装目录 **share/postgresql/extension/**即可。 +如果编译安装时，没有加入 **--enable-oracle-fdw** 选项，可以在openGauss安装完成后，再次编译oracle\_fdw，然后手动将编译产物 **oracle\_fdw.so**放到对应的安装目录 **lib/postgresql/** ，将 **oracle\_fdw--1.0--1.1.sql，oracle\_fdw--1.1.sql，oracle\_fdw.control**放到对应的安装目录 **share/postgresql/extension/** 即可。 ## 使用oracle\_fdw diff --git "a/content/docs-lite/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/docs-lite/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" index 76e11221d..98282c644 100644 --- "a/content/docs-lite/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/docs-lite/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -188,7 +188,7 @@ openGauss轻量版的软件依赖要求如[表3](#zh-cn_topic_0283136474_table12 vim /etc/selinux/config ``` - b. 修改“SELINUX“的值“disabled“，执行**:wq**保存并退出修改。 + b. 修改“SELINUX“的值“disabled“，执行 **:wq** 保存并退出修改。 ``` SELINUX=disabled diff --git "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" index e81f90d9e..7b5d4e467 100644 --- "a/content/docs-lite/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" +++ "b/content/docs-lite/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" @@ -12,7 +12,7 @@ rows(table_list #|+|-|* const) ## 参数说明 -- **\#**,**+**,**-**,**\***，进行行数估算hint的四种操作符号。\#表示直接使用后面的行数进行hint。+,-,\*表示对原来估算的行数进行加、减、乘操作，运算后的行数最小值为1行。table\_list为hint对应的单表或多表join结果集，与[Join方式的Hint](Join方式的Hint.md)中[table\_list](Join方式的Hint.md#zh-cn_topic_0283137375_zh-cn_topic_0237121534_li1090312446510)相同。 +- **\#**,**+**,**-**,\*，进行行数估算hint的四种操作符号。\#表示直接使用后面的行数进行hint。+,-,\*表示对原来估算的行数进行加、减、乘操作，运算后的行数最小值为1行。table\_list为hint对应的单表或多表join结果集，与[Join方式的Hint](Join方式的Hint.md)中[table\_list](Join方式的Hint.md#zh-cn_topic_0283137375_zh-cn_topic_0237121534_li1090312446510)相同。 - **const**可以是任意非负数，支持科学计数法。 diff --git a/content/docs-lite/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md b/content/docs-lite/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md index 87008b0ac..dd996afa5 100644 --- a/content/docs-lite/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md +++ b/content/docs-lite/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md @@ -42,8 +42,8 @@ CREATE CLIENT MASTER KEY client_master_key_name WITH （KEY_STORE = key_store_na 由本语法创建的用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值范围：RSA\_2048、RSA\_3072和SM2。 >![](public_sys-resources/icon-note.gif) **说明：** - >**密钥存储路径：**默认情况下，localkms将在$LOCALKMS\_FILE\_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS\_FILE\_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 - >**密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY\_PATH = "key\_path\_value", 四个文件的名称分别为key\_path\_value.pub、key\_path\_value.pub.rand、 key\_path\_value.priv、 key\_path\_value.priv.rand。 + >**密钥存储路径：** 默认情况下，localkms将在$LOCALKMS\_FILE\_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS\_FILE\_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 + >**密钥相关文件名：** 使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY\_PATH = "key\_path\_value", 四个文件的名称分别为key\_path\_value.pub、key\_path\_value.pub.rand、 key\_path\_value.priv、 key\_path\_value.priv.rand。 >所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 diff --git "a/content/zh/docs/AIFeatureGuide/Prometheus-Exporter\347\273\204\344\273\266\347\216\257\345\242\203\351\203\250\347\275\262.md" "b/content/zh/docs/AIFeatureGuide/Prometheus-Exporter\347\273\204\344\273\266\347\216\257\345\242\203\351\203\250\347\275\262.md" index f829747e2..3424b2c08 100644 --- "a/content/zh/docs/AIFeatureGuide/Prometheus-Exporter\347\273\204\344\273\266\347\216\257\345\242\203\351\203\250\347\275\262.md" +++ "b/content/zh/docs/AIFeatureGuide/Prometheus-Exporter\347\273\204\344\273\266\347\216\257\345\242\203\351\203\250\347\275\262.md" @@ -18,7 +18,7 @@ 如采用一键式部署，Prometheus和node\_exporter的软件压缩包下载路径以及解压缩路径在用户的家目录$HOME下。 -3. 部署过程中为支持部署位置正确以及后续的运行和监测正常运行，程序会要求用户互动性地输入一些参数，主要包括以下内容，**应当注意到的是Prometheus和node-exporter的默认侦听地址是0.0.0.0，由于Prometheus和node-exporter属于开源软件，DBMind也无法获知用户希望绑定的IP地址，故无法直接进行修改，需要用户进行配置。**但是在安装过程中，DBMind会给予用户相应的提示，提示用户将侦听地址绑定到具体的某个IP地址上。下面是部署工具的配置文件示例，该工具会进行交互式配置，不建议用户手动修改。配置文件如下： +3. 部署过程中为支持部署位置正确以及后续的运行和监测正常运行，程序会要求用户互动性地输入一些参数，主要包括以下内容，**应当注意到的是Prometheus和node-exporter的默认侦听地址是0.0.0.0，由于Prometheus和node-exporter属于开源软件，DBMind也无法获知用户希望绑定的IP地址，故无法直接进行修改，需要用户进行配置。** 但是在安装过程中，DBMind会给予用户相应的提示，提示用户将侦听地址绑定到具体的某个IP地址上。下面是部署工具的配置文件示例，该工具会进行交互式配置，不建议用户手动修改。配置文件如下： ``` [DOWNLOADING] diff --git "a/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\345\207\206\345\244\207.md" "b/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\345\207\206\345\244\207.md" index 9d333c162..dfadedc56 100644 --- "a/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\345\207\206\345\244\207.md" +++ "b/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\345\207\206\345\244\207.md" @@ -64,11 +64,11 @@ X-Tuner在运行前需要加载配置文件，用户可以通过** --help**命 ... ``` -修改配置文件的配置项可以指引X-Tuner执行不同的动作，用户可以根据自己的不同需求来修改配置文件的内容，配置文件的配置项说明详见[表2](X-Tuner-参数调优与诊断命令参考.md#table10217184512711)。如果需要修改配置文件的加载路径，则可以通过选项**-x**命令行选项来指定。 +修改配置文件的配置项可以指引X-Tuner执行不同的动作，用户可以根据自己的不同需求来修改配置文件的内容，配置文件的配置项说明详见[表2](X-Tuner-参数调优与诊断命令参考.md#table10217184512711)。如果需要修改配置文件的加载路径，则可以通过选项 **-x** 命令行选项来指定。 ## Benchmark的选择与配置 -Benchmark的驱动脚本存放路径为X-Tuner目录（即**$GAUSSHOME**/bin/dbmind/components/xtuner，下同）的子目录benchmark中。X-Tuner自带常用的benchmark驱动脚本，例如基于时间周期的探测脚本（**默认**）、TPC-C、TPC-H等。X-Tuner通过调用benchmark/\_\_init\_\_.py文件中 **get\_benchmark\_instance\(\)**命令来加载不同的benchmark驱动脚本，获取benchmark驱动实例。其中，benchmark驱动脚本的格式说明如下： +Benchmark的驱动脚本存放路径为X-Tuner目录（即 **$GAUSSHOME**/bin/dbmind/components/xtuner，下同）的子目录benchmark中。X-Tuner自带常用的benchmark驱动脚本，例如基于时间周期的探测脚本（**默认**）、TPC-C、TPC-H等。X-Tuner通过调用benchmark/\_\_init\_\_.py文件中 **get\_benchmark\_instance\(\)** 命令来加载不同的benchmark驱动脚本，获取benchmark驱动实例。其中，benchmark驱动脚本的格式说明如下： - 驱动脚本文件名：表示benchmark的名字，该名字用于表示驱动脚本的唯一性，可通过在X-Tuner的配置文件中的配置项**benchmark\_script**来指定选择加载哪个benchmark驱动脚本。 - 驱动脚本内容三要素：path变量、cmd变量以及run函数。 diff --git "a/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\347\244\272\344\276\213.md" "b/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\347\244\272\344\276\213.md" index d4ea88a11..6c0d67487 100644 --- "a/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\347\244\272\344\276\213.md" +++ "b/content/zh/docs/AIFeatureGuide/X-Tuner-\345\217\202\346\225\260\350\260\203\344\274\230\344\270\216\350\257\212\346\226\255\344\275\277\347\224\250\347\244\272\344\276\213.md" @@ -83,7 +83,7 @@ gs_dbmind component xtuner recommend -f connection.json - rl\_steps：训练过程的最大迭代步数。 - max\_episode\_steps：每个回合的最大步数。 - scenario：明确指定的workload类型，如果为auto则为自动判断。在不同模式下，推荐的调优参数列表也不一样。 -- tuning\_list：**用户指定需要调哪些参数，如果不指定，则根据workload类型自动推荐应该调的参数列表。**如需指定，则tuning\_list表示调优列表文件的路径。一个调优列表配置文件的文件内容示例如下： +- tuning\_list：**用户指定需要调哪些参数，如果不指定，则根据workload类型自动推荐应该调的参数列表。** 如需指定，则tuning\_list表示调优列表文件的路径。一个调优列表配置文件的文件内容示例如下： ``` { diff --git a/content/zh/docs/BriefTutorial/DCF.md b/content/zh/docs/BriefTutorial/DCF.md index 57f8b7a91..573af7c26 100644 --- a/content/zh/docs/BriefTutorial/DCF.md +++ b/content/zh/docs/BriefTutorial/DCF.md @@ -43,7 +43,7 @@ DCF功能架构如[图1](#fig31591049102410)所示，主要包括：功能模块 DCF除了可以提供经典的Leader、Follow、Candidate角色外，还可以提供定制化的角色。例如Passive角色（有日志，有数据，没有被选举权，不参与多数派投票），log角色（有日志，没有数据，没有被选举权，参与多数派投票）。有了这些节点角色的支持，DCF可以支持节点同步、同异步混合部署等多集群部署方式。 - **Batch & Pipeline** - - **Batch：**DCF支持多级batch操作，主要包括： + - **Batch：** DCF支持多级batch操作，主要包括： - 将多个日志合并成单个消息进行发送。 - 将多个日志合并写磁盘。 @@ -51,7 +51,7 @@ DCF功能架构如[图1](#fig31591049102410)所示，主要包括：功能模块 Batch可以有效的降低消息粒度带来的额外损耗，提升吞吐。 - - **Pipeline：**是指在上一个消息返回结果以前，并发的发送下一个消息到对应节点的机制，通过提高并发发送消息数量（Pipeline数量），可以有效的降低并发单请求延迟，提升性能；DCF在日志持久化、网络发送、日志复制等多个阶段采用纯异步方式，将Pipeline性能发挥至极致。 + - **Pipeline：** 是指在上一个消息返回结果以前，并发的发送下一个消息到对应节点的机制，通过提高并发发送消息数量（Pipeline数量），可以有效的降低并发单请求延迟，提升性能；DCF在日志持久化、网络发送、日志复制等多个阶段采用纯异步方式，将Pipeline性能发挥至极致。 - **高效流控算法** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" "b/content/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" index 832d1e884..8b3398b69 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/MOT\350\265\204\346\272\220\345\210\251\347\224\250\347\216\207.md" @@ -3,7 +3,7 @@ 在4路96核512GB RAM的x86服务器上测试的资源利用率如下所示。MOT能够高效持续消耗几乎所有可用的CPU资源。例如，192核390万tpmC的CPU利用率几乎达到100%。 - tmpC：每分钟完成的TPC-C事务数以橙色条柱和左侧的Y轴**tpmC**表示。 -- CPU利用率（%）：CPU利用率由蓝色线条和右侧的Y轴**CPU%**表示。 +- CPU利用率（%）：CPU利用率由蓝色线条和右侧的Y轴**CPU%** 表示。 **图 1** 资源利用率性能基准 ![](figures/Resource-utilization-performance-benchmark.png "资源利用率性能基准") diff --git a/content/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md b/content/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md index 0783ef9ff..3b74dc096 100644 --- a/content/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md +++ b/content/zh/docs/DatabaseAdministrationGuide/mysql_fdw.md @@ -10,11 +10,11 @@ mysql\_fdw是一款[开源插件](https://github.com/EnterpriseDB/mysql_fdw)。o 配置好源后，使用**yum install MariaDB-devel MariaDB-shared**安装相关开发库。另外**MariaDB-client**是MariaDB的客户端工具，也可以根据需要安装，用于连接MariaDB进行测试。 -安装好开发包后，就可以开始编译mysql\_fdw了。编译时需要在执行**configure**时，加入**--enable-mysql-fdw**选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考**软件安装编译**） +安装好开发包后，就可以开始编译mysql\_fdw了。编译时需要在执行**configure**时，加入 **--enable-mysql-fdw** 选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 **软件安装编译** ） -编译完成后，编译产物为**mysql\_fdw.so**，位于安装目录的**lib/postgresql/** 下。mysql\_fdw相关的sql文件和control文件，位于安装目录的**share/postgresql/Extension/**下。 +编译完成后，编译产物为**mysql\_fdw.so**，位于安装目录的**lib/postgresql/** 下。mysql\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/Extension/** 下。 -如果编译安装时，没有加入**--enable-mysql-fdw**选项，可以在openGauss安装完成后，再次编译mysql\_fdw，然后手动将编译产物**mysql\_fdw.so**放到对应的安装目录**lib/postgresql/**，将**mysql\_fdw--1.0--1.1.sql、mysql\_fdw--1.1.sql、mysql\_fdw--1.0.sql、mysql\_fdw.control**放到对应的安装目录**share/postgresql/Extension/**即可。 +如果编译安装时，没有加入 **--enable-mysql-fdw**选项，可以在openGauss安装完成后，再次编译mysql\_fdw，然后手动将编译产物**mysql\_fdw.so**放到对应的安装目录**lib/postgresql/**，将**mysql\_fdw--1.0--1.1.sql、mysql\_fdw--1.1.sql、mysql\_fdw--1.0.sql、mysql\_fdw.control**放到对应的安装目录 **share/postgresql/Extension/** 即可。 ## 使用mysql\_fdw @@ -47,7 +47,7 @@ mysql\_fdw是一款[开源插件](https://github.com/EnterpriseDB/mysql_fdw)。o - 创建USER MAPPING时使用的MariaDB/MySQL Server用户需要有远程连接MariaDB/MySQL Server及对表相关操作的权限。使用外表前，可以在openGauss server所在的机器上，使用MariaDB/MySQL Server的客户端，使用对应的用户名密码确认能否成功连接MariaDB/MySQL Server并进行操作。 -- 对外表执行DML操作时，出现**Can't initialize character set SQL\_ASCII \(path: compiled\_in\)**错误。由于MariaDB不支持**SQL\_ASCII**编码格式，目前只能通过修改openGauss database的编码格式解决该问题。修改database编码格式的方式为**update pg\_database set encoding = pg\_char\_to\_encoding\('UTF-8'\) where datname = 'postgres';** datname根据实际情况填写。注意修改完编码格式后，需要重新开启一个gsql会话，才能使mysql\_fdw使用更新后的参数。也可以通过在执行**gs\_initdb**时，使用**--locale=LOCALE**，指定默认的编码格式为**非SQL\_ASCII**编码。 +- 对外表执行DML操作时，出现**Can't initialize character set SQL\_ASCII \(path: compiled\_in\)**错误。由于MariaDB不支持**SQL\_ASCII**编码格式，目前只能通过修改openGauss database的编码格式解决该问题。修改database编码格式的方式为**update pg\_database set encoding = pg\_char\_to\_encoding\('UTF-8'\) where datname = 'postgres';** datname根据实际情况填写。注意修改完编码格式后，需要重新开启一个gsql会话，才能使mysql\_fdw使用更新后的参数。也可以通过在执行**gs\_initdb**时，使用 **--locale=LOCALE** ，指定默认的编码格式为**非SQL\_ASCII**编码。 ## 注意事项 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" "b/content/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" index 56bb49862..53885ef39 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\347\224\250\344\272\216Oracle\347\232\204\345\244\226\351\203\250\346\225\260\346\215\256\345\214\205\350\243\205\345\231\250.md" @@ -12,9 +12,9 @@ oracle\_fdw（foreign data wrapper for oracle）用于Oracle的外部数据包 安装好开发包后，就可以开始编译oracle\_fdw了。编译时需要在执行**configure**时，加入 **--enable-oracle-fdw** 选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 **软件安装编译** ） -编译完成后，编译产物为 **oracle\_fdw.so**，位于安装目录的 **lib/postgresql/**下。oracle\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/Extension/**下。 +编译完成后，编译产物为 **oracle\_fdw.so**，位于安装目录的 **lib/postgresql/** 下。oracle\_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/Extension/** 下。 -如果编译安装时，没有加入 **--enable-oracle-fdw** 选项，可以在openGauss安装完成后，再次编译oracle\_fdw，然后手动将编译产物 **oracle\_fdw.so**放到对应的安装目录 **lib/postgresql/** ，将 **oracle\_fdw--1.0--1.1.sql、oracle\_fdw--1.1.sql、oracle\_fdw.control**放到对应的安装目录 **share/postgresql/Extension/**即可。 +如果编译安装时，没有加入 **--enable-oracle-fdw** 选项，可以在openGauss安装完成后，再次编译oracle\_fdw，然后手动将编译产物 **oracle\_fdw.so**放到对应的安装目录 **lib/postgresql/** ，将 **oracle\_fdw--1.0--1.1.sql、oracle\_fdw--1.1.sql、oracle\_fdw.control**放到对应的安装目录 **share/postgresql/Extension/** 即可。 ## 使用oracle\_fdw diff --git "a/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" index 6bdfd6828..eb6ccd02a 100644 --- "a/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -204,7 +204,7 @@ openGauss的软件依赖要求如[表3 ](#zh-cn_topic_0283136474_table1212531681 vim /etc/selinux/config - b. 修改“SELINUX”的值“disabled”，执行**:wq**保存并退出修改。 + b. 修改“SELINUX”的值“disabled”，执行 **:wq** 保存并退出修改。 SELINUX=disabled @@ -351,4 +351,4 @@ HISTSIZE=0 source /etc/profile ``` -**----结束** \ No newline at end of file +**----结束** diff --git "a/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203_\344\274\201\344\270\232\347\211\210.md" "b/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203_\344\274\201\344\270\232\347\211\210.md" index db8c935c7..09c7e97d5 100644 --- "a/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203_\344\274\201\344\270\232\347\211\210.md" +++ "b/content/zh/docs/InstallationGuide/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203_\344\274\201\344\270\232\347\211\210.md" @@ -449,7 +449,7 @@ source /etc/profile PermitRootLogin yes ``` - c. 执行**:wq**保存并退出编辑页面。 + c. 执行 **:wq** 保存并退出编辑页面。 2. 修改Banner配置，去掉连接到系统时，系统提示的欢迎信息。欢迎信息会干扰安装时远程操作的返回结果，影响安装正常执行。 @@ -465,7 +465,7 @@ source /etc/profile #Banner XXXX ``` - c. 执行**:wq**保存并退出编辑页面。 + c. 执行 **:wq** 保存并退出编辑页面。 3. 使用如下命令使设置生效。 @@ -481,4 +481,4 @@ source /etc/profile > ![](public_sys-resources/icon-note.png) **说明：** > - > xxx.xxx.xxx.xxx为安装openGauss环境的IP地址。 \ No newline at end of file + > xxx.xxx.xxx.xxx为安装openGauss环境的IP地址。 diff --git "a/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" index 8038a80ae..f48eb7774 100644 --- "a/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -68,7 +68,7 @@ tar -zxvf openGauss-x.x.x-openEuler-64bit-om.tar.gz cd /opt/software/openGauss/script ``` -5.如果是openEuler的操作系统，执行如下命令打开performance.sh文件，用\#注释sysctl -w vm.min\_free\_kbytes=112640 &\> /dev/null，键入“ESC”键进入指令模式，执行**:wq**保存并退出修改。 +5.如果是openEuler的操作系统，执行如下命令打开performance.sh文件，用\#注释sysctl -w vm.min\_free\_kbytes=112640 &\> /dev/null，键入“ESC”键进入指令模式，执行 **:wq** 保存并退出修改。 ``` vi /etc/profile.d/performance.sh diff --git "a/content/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" "b/content/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" index c58d62d79..55a97142b 100644 --- "a/content/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" +++ "b/content/zh/docs/PerformanceTuningGuide/\350\241\214\346\225\260\347\232\204Hint.md" @@ -12,7 +12,7 @@ rows(table_list #|+|-|* const) ## 参数说明 -- **\#**、**+**、**-**、**\***，进行行数估算hint的四种操作符号。\#表示直接使用后面的行数进行hint。+、-、\*表示对原来估算的行数进行加、减、乘操作，运算后的行数最小值为1行。table\_list为hint对应的单表或多表join结果集，与[Join方式的Hint](Join方式的Hint.md)中[table\_list](Join方式的Hint.md#zh-cn_topic_0237121534_li1090312446510)相同。 +- **\#**、**+**、**-**、\*，进行行数估算hint的四种操作符号。\#表示直接使用后面的行数进行hint。+、-、\*表示对原来估算的行数进行加、减、乘操作，运算后的行数最小值为1行。table\_list为hint对应的单表或多表join结果集，与[Join方式的Hint](Join方式的Hint.md)中[table\_list](Join方式的Hint.md#zh-cn_topic_0237121534_li1090312446510)相同。 - **const**可以是任意非负数，支持科学计数法。 diff --git a/content/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md b/content/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md index a0ccc406a..ffae66513 100644 --- a/content/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md +++ b/content/zh/docs/SQLReference/CREATE-CLIENT-MASTER-KEY.md @@ -40,9 +40,9 @@ CREATE CLIENT MASTER KEY client_master_key_name WITH （KEY_STORE = key_store_na >![](public_sys-resources/icon-note.png) **说明：** > - >**密钥存储路径：**默认情况下，localkms将在$LOCALKMS\_FILE\_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS\_FILE\_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 + >**密钥存储路径：** 默认情况下，localkms将在$LOCALKMS\_FILE\_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS\_FILE\_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 > - >**密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY\_PATH = "key\_path\_value", 四个文件的名称分别为key\_path\_value.pub、key\_path\_value.pub.rand、 key\_path\_value.priv、 key\_path\_value.priv.rand。 + >**密钥相关文件名：** 使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY\_PATH = "key\_path\_value", 四个文件的名称分别为key\_path\_value.pub、key\_path\_value.pub.rand、 key\_path\_value.priv、 key\_path\_value.priv.rand。 >所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 diff --git a/content/zh/docs/ToolandCommandReference/gs_encrypt.md b/content/zh/docs/ToolandCommandReference/gs_encrypt.md index 34cefa47b..2f6aa0dbc 100644 --- a/content/zh/docs/ToolandCommandReference/gs_encrypt.md +++ b/content/zh/docs/ToolandCommandReference/gs_encrypt.md @@ -50,7 +50,7 @@ gs_encrypt [OPTION]... PLAINTEXT ## 示例 -示例1**：**通过输入key和vector明文值来对明文字符串进行加密操作。由于每次加密时使用的IV值是随机生成的，因此使用同样的key和vector以及明文字符串加密后对应的密文串不相同。单次支持加密的明文字符串最大长度为335字节。 +示例1：通过输入key和vector明文值来对明文字符串进行加密操作。由于每次加密时使用的IV值是随机生成的，因此使用同样的key和vector以及明文字符串加密后对应的密文串不相同。单次支持加密的明文字符串最大长度为335字节。 ``` gs_encrypt -k password@123 -v 1234567890123456 test_encrypt diff --git a/content/zh/docs/ToolandCommandReference/gs_upgradectl.md b/content/zh/docs/ToolandCommandReference/gs_upgradectl.md index 7608e2b55..806c13fa2 100644 --- a/content/zh/docs/ToolandCommandReference/gs_upgradectl.md +++ b/content/zh/docs/ToolandCommandReference/gs_upgradectl.md @@ -33,7 +33,7 @@ - 执行升级的过程中请不要手动设置GUC参数。 - 灰度升级中，升级的时候都会产生不超过10s的业务中断。 - 升级过程中，必须保持内核版本与om版本一致才可执行om操作。这里的一致是指，内核代码和om代码都来自同一个软件包。如果执行了升级包的前置脚本却没有升级，或者升级回滚后没有执行基线包的前置脚本，就会造成内核代码和om代码的不一致。 -- 升级过程中如果系统表新增了字段，升级后通过**\\d**命令将查看不到这些新增的字段。此时通过**select**命令可以查到这些新增的字段。 +- 升级过程中如果系统表新增了字段，升级后通过 **\\d** 命令将查看不到这些新增的字段。此时通过**select**命令可以查到这些新增的字段。 - 升级需要guc参数enable\_stream\_replication=on，该参数为off时不允许升级。 - 灰度升级中， 业务并发要小于200并发读加200并发写的情况。 - 建议数据库节点磁盘使用率低于80%时再执行升级操作。 diff --git "a/contribute/OperationGuide/\346\243\200\350\247\206\344\277\256\346\224\271\345\206\205\345\256\271.md" "b/contribute/OperationGuide/\346\243\200\350\247\206\344\277\256\346\224\271\345\206\205\345\256\271.md" index 9035dd8ac..0ce8f02d2 100644 --- "a/contribute/OperationGuide/\346\243\200\350\247\206\344\277\256\346\224\271\345\206\205\345\256\271.md" +++ "b/contribute/OperationGuide/\346\243\200\350\247\206\344\277\256\346\224\271\345\206\205\345\256\271.md" @@ -22,7 +22,7 @@ PR需要经过两位人员的检视认可之后，才可以合入。目前，只 - 单击PR下的“文件”页签，查看文件及其修改。 4. 开始审核，审核时关注点请参见[检视建议](#section1158952223818)。 - - 有评审意见，请在文件上修改行单击左侧**+**号，填写评审意见后，单击评论即可。 + - 有评审意见，请在文件上修改行单击左侧 **+** 号，填写评审意见后，单击评论即可。 - 低错类内容的建议注明【低错】，方便作者分辨问题严重程度。 - 低错类问题PR需要批量提交，多个问题合并为一个PR。如果多次少量提交低错PR，PR可能不会被审核通过。 diff --git "a/contribute/OperationGuide/\350\264\241\347\214\256\347\273\217\351\252\214.md" "b/contribute/OperationGuide/\350\264\241\347\214\256\347\273\217\351\252\214.md" index 655e65256..b3ae616f2 100644 --- "a/contribute/OperationGuide/\350\264\241\347\214\256\347\273\217\351\252\214.md" +++ "b/contribute/OperationGuide/\350\264\241\347\214\256\347\273\217\351\252\214.md" @@ -24,7 +24,7 @@ openGauss博客用于发布一些用户的使用技巧、经验总结、常见 ## 提交流程 -1. **准备环境。**您需要完成以下操作： +1. **准备环境。** 您需要完成以下操作： - 拥有自己的Gitee账号，详情请参见[注册Gitee账户](注册Gitee账户.md)。 - 签署CLA，详情请参见[签署openGauss社区贡献者许可协议（CLA）](签署openGauss社区贡献者许可协议（CLA）.md)。 - 如果需要批量修改多个文件，请安装并配置Git，详情请参见[安装并配置Git](安装并配置Git.md)。 diff --git "a/contribute/template/SQL\345\217\202\350\200\203\346\250\241\346\235\277.md" "b/contribute/template/SQL\345\217\202\350\200\203\346\250\241\346\235\277.md" index fbec69c44..4b68b5869 100644 --- "a/contribute/template/SQL\345\217\202\350\200\203\346\250\241\346\235\277.md" +++ "b/contribute/template/SQL\345\217\202\350\200\203\346\250\241\346\235\277.md" @@ -4,13 +4,13 @@ SQL参考用于介绍SQL语句的功能、语法、参数说明等信息，方 ## 功能描述 -**【写作说明】**此处用于说明SQL语句的主要功能。必要时可以包含简单的使用场景说明，使用户更加深入的了解该SQL语句的功能。 +**【写作说明】** 此处用于说明SQL语句的主要功能。必要时可以包含简单的使用场景说明，使用户更加深入的了解该SQL语句的功能。 -**【写作样例】**在当前数据库创建一个空白表。 +**【写作样例】** 在当前数据库创建一个空白表。 ## 注意事项 -**【写作说明】**描述使用SQL语句时的约束条件以及带来的影响，包括但不限于以下方面： +**【写作说明】** 描述使用SQL语句时的约束条件以及带来的影响，包括但不限于以下方面： - 权限限制：使用该SQL语句用户需要拥有的特定权限。 - 功能限制： @@ -64,7 +64,7 @@ ABORT [ WORK | TRANSACTION ] ; ## 示例 -**【写作说明】**提供SQL语句相关的代码示例。 +**【写作说明】** 提供SQL语句相关的代码示例。 - 示例建议添加简要的描述以说明示例内容，帮助其他人更好理解示例。 - 关键代码处需要注释说明。以--为提示符。 @@ -77,5 +77,5 @@ ABORT [ WORK | TRANSACTION ] ; ## 相关链接 -**【写作说明】**与该SQL语句强相关的SQL语句章节链接。提供用户可能想要了解的内容。 +**【写作说明】** 与该SQL语句强相关的SQL语句章节链接。提供用户可能想要了解的内容。 diff --git "a/contribute/template/\345\267\245\345\205\267\345\217\202\350\200\203\346\250\241\346\235\277.md" "b/contribute/template/\345\267\245\345\205\267\345\217\202\350\200\203\346\250\241\346\235\277.md" index bac894ef8..2b5c5fb11 100644 --- "a/contribute/template/\345\267\245\345\205\267\345\217\202\350\200\203\346\250\241\346\235\277.md" +++ "b/contribute/template/\345\267\245\345\205\267\345\217\202\350\200\203\346\250\241\346\235\277.md" @@ -4,13 +4,13 @@ ## 背景信息 -**【写作说明】**说明工具的作用、使用场景、可以帮助用户达成什么目的。 +**【写作说明】** 说明工具的作用、使用场景、可以帮助用户达成什么目的。 **【写作示例】**gs\_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等内容，并对系统控制参数、I/O配置、网络配置和THP服务等信息进行配置。 ## 前提条件 -**【写作说明】**使用工具前需要准备的软硬件环境、依赖关系、限制条件等信息。 +**【写作说明】** 使用工具前需要准备的软硬件环境、依赖关系、限制条件等信息。 **【写作示例】** @@ -20,7 +20,7 @@ ## 语法 -**【写作说明】**描述命令的作用以及对应的命令格式。如果存在多个命令，使用无序列表一一说明。 +**【写作说明】** 描述命令的作用以及对应的命令格式。如果存在多个命令，使用无序列表一一说明。 **【写作示例】** @@ -40,7 +40,7 @@ ## 参数说明 -**【写作说明】**语法中关键字或者参数的含义、取值范围、注意事项等信息。用无序列表一一描述。 +**【写作说明】** 语法中关键字或者参数的含义、取值范围、注意事项等信息。用无序列表一一描述。 **【写作示例】** @@ -59,7 +59,7 @@ ## 示例 -**【写作说明】**该工具常用的命令代码举例。 +**【写作说明】** 该工具常用的命令代码举例。 **【写作示例】** @@ -77,5 +77,5 @@ Successfully started . ## 相关链接 -**【写作说明】**该工具依赖或者强相关的内容链接，方便用户进行相关阅读，以解决用户可能想了解的内容。 +**【写作说明】** 该工具依赖或者强相关的内容链接，方便用户进行相关阅读，以解决用户可能想了解的内容。 -- Gitee