| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
Develops and maintains database security technologies of the openGauss community.
Defines and develops the certification process and test suites for the openGauss release.
Develops and maintains database security technologies of the openGauss community.
Defines and develops the certification process and test suites for the openGauss release.
| + | ++ | ++ | ++ | +
|---|---|---|---|
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | +pg_authid.oid + |
++ | +
| + | ++ | +pg_proc.oid + |
++ | +
| + | ++ | ++ | +Controls in which the session replication role modes the event trigger fires. O: Trigger fires in "origin" and "local" modes. D: Trigger is disabled. R: Trigger fires in "replica" mode. A: Trigger fires always. + |
+
| + | ++ | ++ | +Command tags for which this trigger will fire. If NULL, the firing of this trigger is not restricted by the command tag. + |
+
Parameter: audit_login_logout
+Parameter: audit_login_logout
Its default value is 7, which indicates that the function of user login and logout audit is enabled. 0 indicates that the function of user login and logout audit is disabled. Other values are not recommended.
Parameter: audit_database_process
+Parameter: audit_database_process
Its default value is 1, which indicates that the audit of database startup, stop, recovery, and switchover is enabled.
Parameter: audit_user_locked
+Parameter: audit_user_locked
Its default value is 1, which indicates that the audit of user locking and unlocking is enabled.
Parameter: audit_user_violation
+Parameter: audit_user_violation
Its default value is 0, which indicates that the audit of unauthorized access disabled.
Parameter: audit_grant_revoke
+Parameter: audit_grant_revoke
Its default value is 1, which indicates that the audit of permission granting and revoking is enabled.
Audit of CREATE, ALTER, and DROP operations on a database object
Parameter: audit_system_object
+Parameter: audit_system_object
Its default value is 12295, which indicates that the CREATE, ALTER, and DROP operations only on databases, schemas, users, and data sources are audited.
Audit of INSERT, UPDATE, and DELETE operations on a specific table
Parameter: audit_dml_state
+Parameter: audit_dml_state
Its default value is 0, which indicates that the audit of DML operations (except SELECT) on a specific table is disabled.
Parameter: audit_dml_state_select
+Parameter: audit_dml_state_select
Its default value is 0, which indicates that the audit of SELECT operations is disabled.
Parameter: audit_copy_exec
+Parameter: audit_copy_exec
Its default value is 1, which indicates that the audit of COPY operations is enabled.
Parameter: audit_function_exec
+Parameter: audit_function_exec
Its default value is 0, which indicates that no execution audit logs of stored procedures and customized functions are recorded.
Parameter: audit_set_parameter
+Parameter: audit_set_parameter
Its default value is 1, which indicates that the audit of SET operations is enabled.
Parameter: audit_xid_info
+Parameter: audit_xid_info
Its default value is 0, which indicates that the function of recording transaction IDs in audit logs is disabled.
Specifies whether to check the reuse days of a new password.
Specifies whether to check the reuse times of a new password.
If the number of consecutive login attempts with incorrect passwords reaches this value, the account is locked.
Number of days prior to account password expiration that a user is notified
Audit log file format. Currently, only the binary format is supported.
Time interval of creating an audit log file. If the difference between the current time and the time when the previous audit log file is created is greater than the value of audit_rotation_interval, a new audit log file will be generated.
Maximum capacity of an audit log file. If the total number of messages in an audit log exceeds the value of audit_rotation_size, the server will generate a new audit log file.
Policy for determining whether audit logs are preferentially stored by space or time. on indicates that audit logs are preferentially stored by space.
Minimum duration required for recording audit logs. This parameter is valid only when audit_resource_policy is set to off.
+Minimum duration required for recording audit logs. This parameter is valid only when audit_resource_policy is set to off.
Specifies whether to audit user logins (including login successes and failures) and logouts.
Specifies whether to audit database startup, stop, switchover, and restoration operations.
Specifies whether to audit database user locking and unlocking.
Specifies whether to audit beyond-authority operations of a database user.
Specifies whether to audit user permission granting and reclaiming operations.
Specifies whether to audit the CREATE, DROP, and ALTER operations on database objects.
Specifies whether to audit the INSERT, UPDATE, and DELETE operations on a specific table.
Specifies whether to record audit information during execution of stored procedures, anonymous blocks, or customized functions (excluding system functions).
If the duration of a connection session exceeds the parameter value, the session is automatically disconnected.
Number of iterations during the generation of encrypted information for authentication
Has permissions to query only some system catalogs and views. For details, see System Catalogs and System Views.
+Has permissions to query only some system catalogs and views. For details, see System Catalogs and System Views.
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | +Variable list, which matches the %s placeholder in the query. + |
+
| + | ++ | +
|---|---|
| + | ++ | +
| + | +Variable list, which matches the %s placeholder in the query. + |
+
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
addConnectionEventListener (ConnectionEventListener listener) + |
++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
removeConnectionEventListener (ConnectionEventListener listener) + |
++ | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | +SQL statement to be executed. One SQL statement can be executed at a time. + |
+
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
SQLAllocHandle is a generic function for allocating handles. It can replace the following functions:
-SQLAllocHandle is a generic function for allocating handles. It can replace the following functions:
+SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions:
-SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions:
+Waiting status of the current thread. For details about the waiting status, see Table 2.
+Waiting status of the current thread. For details about the waiting status, see Table 2.
Waiting status of the current thread. For details about the waiting status, see Table 2.
+Waiting status of the current thread. For details about the waiting status, see Table 2.
+
+In a wide table containing a huge amount of data, a query usually only includes certain columns. In this case, the query performance of the row-store engine is poor. For example, a single table containing the data of a meteorological agency has 200 to 800 columns. Among these columns, only 10 are frequently accessed. In this case, a vectorized execution and column-store engine can significantly improve performance by saving storage space.
+
+Row-store tables and column-store tables have their own advantages and disadvantages. You are advised to select a table based on the site requirements.
+
+- Row-store table
+
+ Row-store tables are created by default. Data is stored by row. Row-store supports adding, deleting, modifying, and querying data of a complete row. Therefore, this storage model applies to scenarios where data needs to be updated frequently.
+
+- Column-store table
+
+ Data is stored by column. The I/O of data query in a single column is small, and column-store tables occupy less storage space than row-store tables. This storage model applies to scenarios where data is inserted in batches, less updated, and queried for statistical analysis. The performance of single point query and single record insertion in a column-store table is poor.
+
+
+The principles for selecting row-store and column-store tables are as follows:
+
+- Update frequency
+
+ If data is frequently updated, use a row-store table.
+
+- Insert frequency
+
+ If a small amount of data is frequently inserted each time, use a row-store table. If a large amount of data is inserted at a time, use column storage.
+
+- Number of columns
+
+ If a table is to contain many columns, use a column-store table.
+
+- Number of columns to be queried
+
+ If only a small number of columns \(less than 50% of the total\) is queried each time, use a column-store table.
+
+- Compression ratio
+
+ The compression ratio of a column-store table is higher than that of a row-store table. The higher the compression ratio is, the more CPU resources will be consumed.
+
+### In-place Upate Storage
+
+The in-place update storage engine solves the problems of space expansion and large tuples of the Append update storage engine. The design of efficient rollback segments is the basis of the in-place update storage engine.
+
+### Xlog Lockless Update and Parallel Page Playback
+
+**Figure 2** Xlog lock less Design
+
+
+This feature optimizes the WalInsertLock mechanism by using log sequence numbers \(LSNs\) and log record counts \(LRCs\) to record the copy progress of each backend and canceling the WalInsertLock mechanism. The backend can directly copy logs to the WalBuffer without contending for the WalInsertLock. In addition, a dedicated WALWriter thread is used to write logs, and the backend thread does not need to ensure the Xlog flushing. After the preceding optimization, the WalInsertLock contention and WalWriter dedicated disk write threads are canceled. The system performance can be further improved while the original XLog function remains unchanged. This feature optimizes the Ustore in-place update WALs and Ustore DML operation parallel playback and distribution. Prefixes and suffixes are used to reduce the update WALs. The playback thread is divided into multiple types to solve the problem that most Ustore DML WALs are replayed on multiple pages. In addition, the Ustore data page playback is distributed based on blkno to improve the degree of parallel playback.
+
+### Adaptive Compression
+
+Currently, mainstream databases usually use the data compression technology. Various compression algorithms are used for different data types. If pieces of data of the same type have different characteristics, their compression algorithms and results will also be different. Adaptive compression chooses the suitable compression algorithm for data based on the data type and characteristics, achieving high performance in compression ratio, import, and query.
+
+Importing and frequently querying a huge amount of data are the main application scenarios. When you import data, adaptive compression greatly reduces the data volume, increases I/O operation efficiency several times, and clusters data before storage, achieving fast data import. In this way, only a small number of I/O operations is required and data is quickly decompressed in a query. Data can be quickly retrieved and the query result is quickly returned.
+
+Currently, the database has implemented various compression algorithms, including RLE, DELTA, BYTEPACK/BITPACK, LZ4, ZLIB, and LOCAL DICTIONARY. The following table lists data types and the compression algorithms suitable for them.
+
+
+| + | ++ | ++ | ++ | ++ | ++ | ++ | +
|---|---|---|---|---|---|---|
| + + + + | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | +
| + + | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| - | -- | -- | -
|---|---|---|
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -
|---|---|---|---|---|---|---|
| - - - - | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -
| - - | -- | -- | -- | -- | -- | -- | -
只可以查看部分系统表和视图。详细请参见系统表和系统视图。
+只可以查看部分系统表和视图。详细请参见系统表和系统视图。
使用ALTER SYSTEM SET修改数据库参数。
+使用ALTER SYSTEM SET修改数据库参数。
openGauss=# ALTER SYSTEM SET paraname TO value;
openGauss=# ALTER SYSTEM SET paraname TO value;diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\220\221\350\241\250\344\270\255\346\217\222\345\205\245\346\225\260\346\215\256.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\220\221\350\241\250\344\270\255\346\217\222\345\205\245\346\225\260\346\215\256.md" index 3619d8129708d6f72b8c70ef17a82856b30ce6c2..faa2372e8df217455077011b65eed088c4da393c 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\220\221\350\241\250\344\270\255\346\217\222\345\205\245\346\225\260\346\215\256.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\220\221\350\241\250\344\270\255\346\217\222\345\205\245\346\225\260\346\215\256.md" @@ -1,6 +1,6 @@ # 向表中插入数据 -在创建一个表后，表中并没有数据，在使用这个表之前，需要向表中插入数据。本小节介绍如何使用[INSERT](../SQLReference/INSERT.md)命令插入一行或多行数据，及从指定表插入数据。如果有大量数据需要批量导入表中，请参考[导入数据](导入数据.md)。 +在创建一个表后，表中并没有数据，在使用这个表之前，需要向表中插入数据。本小节介绍如何使用[INSERT](../SQLReference/INSERT.md)命令插入一行或多行数据，及从指定表插入数据。如果有大量数据需要批量导入表中，请参考[导入数据](../DatabaseOMGuide/导入数据.md)。 ## 背景信息 @@ -45,7 +45,7 @@ > **说明：** > ->数据库[DBCOMPATIBILITY](../SQLReference/CREATE-DATABASE.md#zh-cn_topic_0283137050_zh-cn_topic_0237122099_zh-cn_topic_0059778277_l4aa2b919b99d47caa81872841c30b8c4)设为兼容TD模式，且[td\_compatible\_truncation](平台和客户端兼容性.md#zh-cn_topic_0283137001_zh-cn_topic_0237124738_zh-cn_topic_0059779195_sb8212ce57eb9432a972e390f77203b7c)参数设置为on的情况下，才会对超长字符串进行截断。 +>数据库[DBCOMPATIBILITY](../SQLReference/CREATE-DATABASE.md#zh-cn_topic_0283137050_zh-cn_topic_0237122099_zh-cn_topic_0059778277_l4aa2b919b99d47caa81872841c30b8c4)设为兼容TD模式，且[td\_compatible\_truncation](../DatabaseReference/平台和客户端兼容性.md#zh-cn_topic_0283137001_zh-cn_topic_0237124738_zh-cn_topic_0059779195_sb8212ce57eb9432a972e390f77203b7c)参数设置为on的情况下，才会对超长字符串进行截断。 执行如下命令建立示例中需要使用的表table1、table2。 diff --git "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\256\241\350\256\241\346\246\202\350\277\260.md" "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\256\241\350\256\241\346\246\202\350\277\260.md" index dea9a8e01df3f5deaf248e2d9cb7b59b801ba773..5b8c6bca3c2a1f53ac18bdccff0084b4fc0170a8 100644 --- "a/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\256\241\350\256\241\346\246\202\350\277\260.md" +++ "b/content/docs-lite/zh/docs/DatabaseAdministrationGuide/\345\256\241\350\256\241\346\246\202\350\277\260.md" @@ -6,7 +6,7 @@ 关于审计功能，用户需要了解以下几点内容： -- 审计总开关[audit\_enabled](../DataBaseReference/审计开关.md#zh-cn_topic_0283137524_zh-cn_topic_0237124745_zh-cn_topic_0059777744_sb3d1b703f24c49f096b36087a60fdfcd)支持动态加载。在数据库运行期间修改该配置项的值会立即生效，无需重启数据库。默认值为on，表示开启审计功能。 +- 审计总开关[audit\_enabled](../DatabaseReference//审计开关.md#zh-cn_topic_0283137524_zh-cn_topic_0237124745_zh-cn_topic_0059777744_sb3d1b703f24c49f096b36087a60fdfcd)支持动态加载。在数据库运行期间修改该配置项的值会立即生效，无需重启数据库。默认值为on，表示开启审计功能。 - 除了审计总开关，各个审计项也有对应的开关。只有开关开启，对应的审计功能才能生效。 - 各审计项的开关支持动态加载。在数据库运行期间修改审计开关的值，不需要重启数据库便可生效。 @@ -23,31 +23,31 @@
默认值为12295，表示只对DATABASE、SCHEMA、USER、DATA SOURCE这四类数据库对象的CREATE、ALTER、DROP操作进行审计。
+默认值为67121159，表示只对DATABASE、SCHEMA、USER、DATA SOURCE这四类数据库对象的CREATE、ALTER、DROP操作进行审计。
指定创建一个新审计日志文件的时间间隔。当现在的时间减去上次创建一个审计日志的时间超过了此参数值时，服务器将生成一个新的审计日志文件。
表示需记录审计日志的最短时间要求，该参数在audit_resource_policy为off时生效。
+表示需记录审计日志的最短时间要求，该参数在audit_resource_policy为off时生效。
| - | -- | -- | -- | -- | -- | -- | -- | -
|---|---|---|---|---|---|---|---|
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| - | -- | -- | -- | -- | -- | -- | -- | -
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
|---|---|---|---|---|---|---|---|
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | ++ | ++ | ++ | ++ | +
本产品支持如下几种认证方式，详细解释请参见表2：
-MD5加密算法安全性低，存在安全风险，建议使用更安全的加密算法。
+采用这种认证模式时，本产品只完全信任从服务器本机使用gsql且不指定-U参数的连接，此时不需要口令。
trust认证对于单用户工作站的本地连接是非常合适和方便的，通常不适用于多用户环境。如果想使用这种认证方法，可利用文件系统权限限制对服务器的Unix域套接字文件的访问。要使用这种限制有两个方法：
-用户拥有的ANY权限，取值参考表1。
+用户拥有的ANY权限，取值参考表1。
用户拥有的ANY权限，取值参考表1。
+用户拥有的ANY权限，取值参考表1。
PG_TYPE.oid
可能取值及其含义见于pg_type.h中诸type定义，主要分为多态（isPolymorphicType）和非多态两类。
+可能取值及其描述见于系统表pg_type或查看源码中的pg_type.h文件中type定义，主要分为多态（isPolymorphicType）和非多态两类。
PG_TYPE.oid
PG_TYPE.oid
PG_TYPE.oid
PG_TYPE.oid
角色密码密文，加密方式由GUC参数password_encryption_type确定。
+角色密码密文，加密方式由GUC参数password_encryption_type确定。
PG_TABLESPACE.nspname
+PG_TABLESPACE.spcname
语句锁事件的列表，该列表按时间书序记录事件，记录的数量受参数track_stmt_details_size的影响，该字段为二进制，需要借助解析函数pg_catalog.statement_detail_decode读取，见（表6）。
+语句锁事件的列表，该列表按时间书序记录事件，记录的数量受参数track_stmt_details_size的影响，该字段为二进制，需要借助解析函数pg_catalog.statement_detail_decode读取，见（表6）。
openGauss=# select length(lpad('123',0,'*')) from sys_dummy;
length
--------
-
(1 row)
openGauss=# select length(lpad('123',0,'*')) from sys_dummy;
+
length
--------
0
@@ -259,7 +259,7 @@ length
控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考MERGE INTO） 和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。
+控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考MERGE INTO） 和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。
若设置此配置项，当存在上述场景时，该冲突行将会多次执行UPDATE；否则（默认）报错，即MERGE或INSERT操作失败。
开启此参数后，创建函数，存储过程，包支持未定义的对象。可以新建成功。可以在GS_DEPENDENCIES和GS_DEPENDENCIES_OBJ查询对应的依赖关系。
开启此参数后，创建PLSQL对象时，会主动维护依赖于该PLSQL对象的OID，不再需要用户手动更新。
注意: 1.在并发创建PLSQL对象时，如果需要维护的对象间存在竞争关系，可能会造成死锁。
-注意：该参数只支持distinct，不支持distinct on，且当 DOLPHIN 插件存在时不生效，转由 dolphin.sql_mode 参数控制。dolphin.sql_mode 未设置 sql_mode_full_group 选项时相当于打开此选项。
| + | ++ | +
|---|---|
| + | +控制存储过程中FOR_LOOP查询语句行为设置此项时，在FOR rec IN query LOOP语句中，若rec已经定义，不会复用已经定义的rec变量，而且重新建立一个新的变量。否则，会复用已经定义的rec变量，不会建立新的变量。(与proc_implicit_for_loop_variable相同，后续进性收编) + |
+
| + | ++ | +
| + | ++ | ++ | ++ | +
|---|---|---|---|
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
GUC参数connection_info（参见connection_info）中显示驱动部署路径和进程属主用户的开关。
+GUC参数connection_info（参见connection_info）中显示驱动部署路径和进程属主用户的开关。
默认值为0。当设置为1时，ODBC驱动会将当前驱动的部署路径、进程属主用户上报到数据库中，记录在connection_info参数（参见connection_info）里；同时可以在PG_STAT_ACTIVITY中查询到。
+默认值为0。当设置为1时，ODBC驱动会将当前驱动的部署路径、进程属主用户上报到数据库中，记录在connection_info参数（参见connection_info）里；同时可以在PG_STAT_ACTIVITY中查询到。
链接字符串，字符串中的字段见链接字符章节。
+链接字符串，字符串中的字段见链接参数章节。
要链接的主机名，详见链接字符章节描述的host字段。
+要链接的主机名，详见链接参数章节描述的host字段。
主机服务器的端口号，详见链接字符描述的port字段。
+主机服务器的端口号，详见链接参数描述的port字段。
添加命令行选项以在运行时发送到服务器，详见链接字符描述的options字段。
+添加命令行选项以在运行时发送到服务器，详见链接参数描述的options字段。
要链接的数据库名，详见链接字符描述的dbname字段。
+要链接的数据库名，详见链接参数描述的dbname字段。
要链接的用户名，详见链接字符章节描述的user字段。
+要链接的用户名，详见链接参数章节描述的user字段。
如果服务器要求口令认证，所用的口令，详见链接字符描述的password字段。
+如果服务器要求口令认证，所用的口令，详见链接参数描述的password字段。
缺省时，连接日志只记录所连接主机的IP地址。打开这个选项会同时记录主机名。
-该参数同时影响 查看审计结果、GS_SESSION_MEMORY_DETAIL、PG_STAT_ACTIVITY和log_line_prefix参数。
+该参数同时影响 查看审计结果、GS_SESSION_MEMORY_DETAIL、PG_STAT_ACTIVITY和log_line_prefix参数。
缺省时，连接日志只记录所连接主机的IP地址。打开这个选项会同时记录主机名。
-该参数同时影响 查看审计结果、GS_SESSION_MEMORY_DETAIL、PG_STAT_ACTIVITY和log_line_prefix参数。
+该参数同时影响 查看审计结果、GS_SESSION_MEMORY_DETAIL、PG_STAT_ACTIVITY和log_line_prefix参数。
SQLAllocHandle：申请句柄资源，可替代如下函数：
-SQLAllocHandle：申请句柄资源，可替代如下函数：
+SQLFreeHandle：释放句柄资源，可替代如下函数：
-SQLFreeHandle：释放句柄资源，可替代如下函数：
+| diff --git a/content/docs-lite/zh/docs/ToolandCommandReference/gs_dump.md b/content/docs-lite/zh/docs/ToolandCommandReference/gs_dump.md index 8d1203beedc6a7bc83e954827a21e674dff4e3a6..075ef24750d56557e749551a1c451393679e18f9 100644 --- a/content/docs-lite/zh/docs/ToolandCommandReference/gs_dump.md +++ b/content/docs-lite/zh/docs/ToolandCommandReference/gs_dump.md @@ -17,6 +17,12 @@ gs\_dump支持将数据库信息导出至纯文本格式的SQL脚本文件或其 - 纯文本格式的SQL脚本文件：包含将数据库恢复为其保存时的状态所需的SQL语句。通过[gsql](gsql.md)运行该SQL脚本文件，可以恢复数据库。即使在其他主机和其他数据库产品上，只要对SQL脚本文件稍作修改，也可以用来重建数据库。 - 归档格式文件：包含将数据库恢复为其保存时的状态所需的数据，可以是tar格式、目录归档格式或自定义归档格式，详见[表1](#zh-cn_topic_0058967678_t17db29a12e7342cfbf02b2f6e50ff1a5)。 +gs\_dump工具支持MySQL兼容性。（仅限于3.0.0，3.1.0，3.1.1的MySQL兼容性需求） + +> **须知：** +>- show create procedure/function等show create语句的database collation和collation connection与数据库的lc_collate相同，由于InitSession会重新初始化lc_collate参数，lc_collate有时会被初始化为C，所以show create procedure/function等show create语句的database collation和collation connection这两个列的值不稳定。 +>- 临时表不支持导入导出。 + ## 主要功能 gs\_dump可以创建四种不同的导出文件格式，通过**\[**-F或者--format=**\]**选项指定，具体如[表1](#zh-cn_topic_0058967678_t17db29a12e7342cfbf02b2f6e50ff1a5)所示。 @@ -44,7 +50,7 @@ gs\_dump可以创建四种不同的导出文件格式，通过**\[**-F或者--fo | - | 使用gsql工具恢复数据库对象前，可根据需要使用文本编辑器编辑纯文本导出文件。 + | 使用gsql工具恢复数据库对象前，可根据需要使用文本编辑器编辑纯文本导出文件。 |
|||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -55,7 +61,7 @@ gs\_dump可以创建四种不同的导出文件格式，通过**\[**-F或者--fo | - | 使用gs_restore可以选择要从自定义归档/目录归档/tar归档导出文件中导入相应的数据库对象。 + | 使用gs_restore可以选择要从自定义归档/目录归档/tar归档导出文件中导入相应的数据库对象。 |
|||||||||||||||||||||||
| diff --git a/content/docs-lite/zh/docs/ToolandCommandReference/gs_dumpall.md b/content/docs-lite/zh/docs/ToolandCommandReference/gs_dumpall.md index d9e08b113f1a33879db06b82bb645bf00d2f641a..d8a1517c35ee9f414d5ea5234571b59bf28b7c27 100644 --- a/content/docs-lite/zh/docs/ToolandCommandReference/gs_dumpall.md +++ b/content/docs-lite/zh/docs/ToolandCommandReference/gs_dumpall.md @@ -17,6 +17,12 @@ gs\_dumpall在导出所有数据库时分为两部分： 以上两部分导出的结果为纯文本格式的SQL脚本文件，使用[gsql](gsql.md)运行该脚本文件可以恢复数据库。 +gs\_dumpall工具支持MySQL兼容性。（仅限于3.0.0，3.1.0，3.1.1的MySQL兼容性需求） + +> **须知：** +>- show create procedure/function等show create语句的database collation和collation connection与数据库的lc_collate相同，由于InitSession会重新初始化lc_collate参数，lc_collate有时会被初始化为C，所以show create procedure/function等show create语句的database collation和collation connection这两个列的值不稳定。 +>- 临时表不支持导入导出。 + ## 注意事项 - 禁止修改导出的文件和内容，否则可能无法恢复成功。 diff --git a/content/docs-lite/zh/docs/ToolandCommandReference/gs_guc.md b/content/docs-lite/zh/docs/ToolandCommandReference/gs_guc.md index 61cfe8e58e7f8d77d88eee958e899f7f4c1ccf67..02b49284de7db43e403f4ec917a78ba147348441 100644 --- a/content/docs-lite/zh/docs/ToolandCommandReference/gs_guc.md +++ b/content/docs-lite/zh/docs/ToolandCommandReference/gs_guc.md @@ -222,14 +222,15 @@ 取值范围：已经创建的逻辑数据库名称。 -- --ignore-node=NODES +- --ignore-node=NODES - 需要忽略的主机名称。 + 需要忽略的主机名称。 - > **说明：** - >- 该参数必须与set/reload一起使用，且-Z只支持datanode/coordinator。 - >- 该参数不支持与-D一起使用。 - >- 在与reload一起使用时，如果--ignore-node没有指定主节点，则集群中所有节点的参数依然会全部同步修改。 + > **说明：** + >- 该参数必须与set/reload一起使用，且-Z只支持datanode/coordinator。 + >- 该参数不支持与-D一起使用。 + >- 在与reload一起使用时，如果--ignore-node没有指定主节点，则集群中所有节点的参数依然会全部同步修改。 + >- --ignore-node必须在-N all时才可生效。 - -c parameter diff --git a/content/docs-lite/zh/docs/ToolandCommandReference/gs_restore.md b/content/docs-lite/zh/docs/ToolandCommandReference/gs_restore.md index 1b75b61ae785dac7a9f1801cf586794f98cf0c25..0a44959edefa830e80b418a3650ba7b43f7413ef 100644 --- a/content/docs-lite/zh/docs/ToolandCommandReference/gs_restore.md +++ b/content/docs-lite/zh/docs/ToolandCommandReference/gs_restore.md @@ -4,6 +4,12 @@ gs\_restore是openGauss提供的针对gs\_dump导出数据的导入工具。通过此工具可将gs\_dump导出生成的文件进行导入。 +gs\_restore工具支持MySQL兼容性。（仅限于3.0.0，3.1.0，3.1.1的MySQL兼容性需求） + +> **须知：** +>- show create procedure/function等show create语句的database collation和collation connection与数据库的lc_collate相同，由于InitSession会重新初始化lc_collate参数，lc_collate有时会被初始化为C，所以show create procedure/function等show create语句的database collation和collation connection这两个列的值不稳定。 +>- 临时表不支持导入导出。 + 主要功能包含： - 导入到数据库 diff --git a/content/docs-lite/zh/menu/index.md b/content/docs-lite/zh/menu/index.md index 183d43f95ca517eb232c46c7f32d5da62bb2f9d2..57178ed77426078298782a88799888630291f76c 100644 --- a/content/docs-lite/zh/menu/index.md +++ b/content/docs-lite/zh/menu/index.md @@ -5,7 +5,7 @@ headless: true - [法律声明]({{< relref "./docs/ReleaseNotes/法律声明.md" >}}) -- [发行说明]({{< relref "./docs/ReleaseNotes/ReleaseNotes.md" >}}) +- [发行说明]({{< relref "./docs/ReleaseNotes/Releasenotes.md" >}}) - [用户须知]({{< relref "./docs/ReleaseNotes/用户须知.md" >}}) - [版本介绍]({{< relref "./docs/ReleaseNotes/版本介绍.md" >}}) - [特性介绍]({{< relref "./docs/ReleaseNotes/特性介绍.md" >}}) @@ -236,24 +236,54 @@ headless: true - [示例：jdbc主备集群负载均衡]({{< relref "./docs/Developerguide/示例-jdbc主备集群负载均衡.md" >}}) - [JDBC接口参考]({{< relref "./docs/DeveloperGuide/JDBC接口参考.md" >}}) - [JDBC常用参数参考]({{< relref "./docs/DeveloperGuide/JDBC常用参数参考.md" >}}) - - [基于libpq开发]({{< relref "./docs/DeveloperGuide/基于libpq开发.md" >}}) - - [libpq使用依赖的头文件]({{< relref "./docs/DeveloperGuide/libpq使用依赖的头文件.md" >}}) - - [开发流程]({{< relref "./docs/DeveloperGuide/开发流程_libpq.md" >}}) - - [示例]({{< relref "./docs/DeveloperGuide/示例-libpq.md" >}}) - - [libpq接口参考]({{< relref "./docs/DeveloperGuide/libpq接口参考.md" >}}) - - [链接参数]({{< relref "./docs/DeveloperGuide/链接参数.md" >}}) - - [基于Psycopg开发]({{< relref "./docs/DeveloperGuide/基于Psycopg开发.md" >}}) - - [Psycopg包]({{< relref "./docs/DeveloperGuide/Psycopg包.md" >}}) - - [开发流程]({{< relref "./docs/DeveloperGuide/开发流程_Psycopg.md" >}}) - - [加载驱动]({{< relref "./docs/DeveloperGuide/加载驱动_Psycopg.md" >}}) - - [连接数据库]({{< relref "./docs/DeveloperGuide/连接数据库_Psycopg.md" >}}) - - [执行SQL语句]({{< relref "./docs/DeveloperGuide/执行SQL语句_Psycopg.md" >}}) - - [处理结果集]({{< relref "./docs/DeveloperGuide/处理结果集_Psycopg.md" >}}) - - [关闭连接]({{< relref "./docs/DeveloperGuide/关闭连接_Psycopg.md" >}}) - - [连接数据库（SSL方式）]({{< relref "./docs/DeveloperGuide/连接数据库_SSL方式_Psycopg.md" >}}) - - [示例：常用操作]({{< relref "./docs/DeveloperGuide/示例-常用操作_Psycopg.md" >}}) - - [Psycopg接口参考]({{< relref "./docs/DeveloperGuide/Psycopg接口参考.md" >}}) - - [编译与调试]({{< relref "./docs/DeveloperGuide/编译与调试.md" >}}) + - [基于ODBC开发]({{< relref "./docs/DeveloperGuide/基于ODBC开发.md" >}}) + - [ODBC包及依赖的库和头文件]({{< relref "./docs/DeveloperGuide/ODBC包及依赖的库和头文件.md" >}}) + - [Linux下配置数据源]({{< relref "./docs/DeveloperGuide/Linux下配置数据源.md" >}}) + - [开发流程]({{< relref "./docs/DeveloperGuide/开发流程_ODBC.md" >}}) + - [示例：常用功能和批量绑定]({{< relref "./docs/DeveloperGuide/示例-常用功能和批量绑定.md" >}}) + - [典型应用场景配置]({{< relref "./docs/DeveloperGuide/典型应用场景配置.md" >}}) + - [ODBC接口参考]({{< relref "./docs/DeveloperGuide/ODBC接口参考.md" >}}) + - [SQLAllocEnv]({{< relref "./docs/DeveloperGuide/SQLAllocEnv.md" >}}) + - [SQLAllocConnect]({{< relref "./docs/DeveloperGuide/SQLAllocConnect.md" >}}) + - [SQLAllocHandle]({{< relref "./docs/DeveloperGuide/SQLAllocHandle.md" >}}) + - [SQLAllocStmt]({{< relref "./docs/DeveloperGuide/SQLAllocStmt.md" >}}) + - [SQLBindCol]({{< relref "./docs/DeveloperGuide/SQLBindCol.md" >}}) + - [SQLBindParameter]({{< relref "./docs/DeveloperGuide/SQLBindParameter.md" >}}) + - [SQLColAttribute]({{< relref "./docs/DeveloperGuide/SQLColAttribute.md" >}}) + - [SQLConnect]({{< relref "./docs/DeveloperGuide/SQLConnect.md" >}}) + - [SQLDisconnect]({{< relref "./docs/DeveloperGuide/SQLDisconnect.md" >}}) + - [SQLExecDirect]({{< relref "./docs/DeveloperGuide/SQLExecDirect.md" >}}) + - [SQLExecute]({{< relref "./docs/DeveloperGuide/SQLExecute.md" >}}) + - [SQLFetch]({{< relref "./docs/DeveloperGuide/SQLFetch.md" >}}) + - [SQLFreeStmt]({{< relref "./docs/DeveloperGuide/SQLFreeStmt.md" >}}) + - [SQLFreeConnect]({{< relref "./docs/DeveloperGuide/SQLFreeConnect.md" >}}) + - [SQLFreeHandle]({{< relref "./docs/DeveloperGuide/SQLFreeHandle.md" >}}) + - [SQLFreeEnv]({{< relref "./docs/DeveloperGuide/SQLFreeEnv.md" >}}) + - [SQLPrepare]({{< relref "./docs/DeveloperGuide/SQLPrepare.md" >}}) + - [SQLGetData]({{< relref "./docs/DeveloperGuide/SQLGetData.md" >}}) + - [SQLGetDiagRec]({{< relref "./docs/DeveloperGuide/SQLGetDiagRec.md" >}}) + - [SQLSetConnectAttr]({{< relref "./docs/DeveloperGuide/SQLSetConnectAttr.md" >}}) + - [SQLSetEnvAttr]({{< relref "./docs/DeveloperGuide/SQLSetEnvAttr.md" >}}) + - [SQLSetStmtAttr]({{< relref "./docs/DeveloperGuide/SQLSetStmtAttr.md" >}}) + - [示例]({{< relref "./docs/DeveloperGuide/示例-2.md" >}}) + - [基于libpq开发]({{< relref "./docs/DeveloperGuide/基于libpq开发.md" >}}) + - [libpq使用依赖的头文件]({{< relref "./docs/DeveloperGuide/libpq使用依赖的头文件.md" >}}) + - [开发流程]({{< relref "./docs/DeveloperGuide/开发流程_libpq.md" >}}) + - [示例]({{< relref "./docs/DeveloperGuide/示例-libpq.md" >}}) + - [libpq接口参考]({{< relref "./docs/DeveloperGuide/libpq接口参考.md" >}}) + - [链接参数]({{< relref "./docs/DeveloperGuide/链接参数.md" >}}) + - [基于Psycopg开发]({{< relref "./docs/DeveloperGuide/基于Psycopg开发.md" >}}) + - [Psycopg包]({{< relref "./docs/DeveloperGuide/Psycopg包.md" >}}) + - [开发流程]({{< relref "./docs/DeveloperGuide/开发流程_Psycopg.md" >}}) + - [加载驱动]({{< relref "./docs/DeveloperGuide/加载驱动_Psycopg.md" >}}) + - [连接数据库]({{< relref "./docs/DeveloperGuide/连接数据库_Psycopg.md" >}}) + - [执行SQL语句]({{< relref "./docs/DeveloperGuide/执行SQL语句_Psycopg.md" >}}) + - [处理结果集]({{< relref "./docs/DeveloperGuide/处理结果集_Psycopg.md" >}}) + - [关闭连接]({{< relref "./docs/DeveloperGuide/关闭连接_Psycopg.md" >}}) + - [连接数据库（SSL方式）]({{< relref "./docs/DeveloperGuide/连接数据库_SSL方式_Psycopg.md" >}}) + - [示例：常用操作]({{< relref "./docs/DeveloperGuide/示例-常用操作_Psycopg.md" >}}) + - [Psycopg接口参考]({{< relref "./docs/DeveloperGuide/Psycopg接口参考.md" >}}) + - [编译与调试]({{< relref "./docs/DeveloperGuide/编译与调试.md" >}}) - [编译指南]({{< relref "./docs/CompilationGuide/Compilation.md" >}}) - [简介]({{< relref "./docs/CompilationGuide/简介.md" >}}) @@ -570,7 +600,7 @@ headless: true - [案例：改写SQL消除子查询（案例1）]({{< relref "./docs/PerformanceTuningGuide/案例-改写SQL消除子查询_案例1.md" >}}) - [案例：改写SQL消除子查询（案例2）]({{< relref "./docs/PerformanceTuningGuide/案例-改写SQL消除子查询_案例2.md" >}}) - [案例：改写SQL消除in-clause]({{< relref "./docs/PerformanceTuningGuide/案例-改写SQL消除in-clause.md" >}}) - + - [SQL参考]({{< relref "./docs/SQLReference/SQL参考.md" >}}) - [SQL语法格式说明]({{< relref "./docs/SQLReference/SQL语法格式说明.md" >}}) - [SQL语言结构和语法]({{< relref "./docs/SQLReference/SQL语言结构和语法.md" >}}) @@ -598,6 +628,7 @@ headless: true - [ALTER EXTENSION]({{< relref "./docs/SQLReference/ALTER-EXTENSION.md" >}}) - [ALTER EVENT]({{< relref "./docs/SQLReference/ALTER-EVENT.md" >}}) - [ALTER EVENT TRIGGER]({{< relref "./docs/SQLReference/ALTER-EVENT-TRIGGER.md" >}}) + - [ALTER FOREIGN DATA WRAPPER]({{< relref "./docs/SQLReference/ALTER-FOREIGN-DATA-WRAPPER.md" >}}) - [ALTER FOREIGN TABLE]({{< relref "./docs/SQLReference/ALTER-FOREIGN-TABLE.md" >}}) - [ALTER FUNCTION]({{< relref "./docs/SQLReference/ALTER-FUNCTION.md" >}}) - [ALTER GROUP]({{< relref "./docs/SQLReference/ALTER-GROUP.md" >}}) @@ -654,6 +685,7 @@ headless: true - [CREATE EXTENSION]({{< relref "./docs/SQLReference/CREATE-EXTENSION.md" >}}) - [CREATE EVENT]({{< relref "./docs/SQLReference/CREATE-EVENT.md" >}}) - [CREATE EVENT TRIGGER]({{< relref "./docs/SQLReference/CREATE-EVENT-TRIGGER.md" >}}) + - [CREATE FOREIGN DATA WRAPPER]({{< relref "./docs/SQLReference/CREATE-FOREIGN-DATA-WRAPPER.md" >}}) - [CREATE FOREIGN TABLE]({{< relref "./docs/SQLReference/CREATE-FOREIGN-TABLE.md" >}}) - [CREATE FUNCTION]({{< relref "./docs/SQLReference/CREATE-FUNCTION.md" >}}) - [CREATE GROUP]({{< relref "./docs/SQLReference/CREATE-GROUP.md" >}}) @@ -705,6 +737,7 @@ headless: true - [DROP EXTENSION]({{< relref "./docs/SQLReference/DROP-EXTENSION.md" >}}) - [DROP EVENT]({{< relref "./docs/SQLReference/DROP-EVENT.md" >}}) - [DROP EVENT TRIGGER]({{< relref "./docs/SQLReference/DROP-EVENT-TRIGGER.md" >}}) + - [DROP FOREIGN DATA WRAPPER]({{< relref "./docs/SQLReference/DROP-FOREIGN-DATA-WRAPPER.md" >}}) - [DROP FOREIGN TABLE]({{< relref "./docs/SQLReference/DROP-FOREIGN-TABLE.md" >}}) - [DROP FUNCTION]({{< relref "./docs/SQLReference/DROP-FUNCTION.md" >}}) - [DROP GROUP]({{< relref "./docs/SQLReference/DROP-GROUP.md" >}}) @@ -1204,6 +1237,7 @@ headless: true - [DBE\_PLDEBUGGER.turn\_off]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-turn_off.md" >}}) - [DBE\_PLDEBUGGER.local\_debug\_server\_info]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-local_debug_server_info.md" >}}) - [DBE\_PLDEBUGGER.attach]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-attach.md" >}}) + - [DBE\_PLDEBUGGER.info\_locals]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-info_locals.md" >}}) - [DBE\_PLDEBUGGER.next]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-next.md" >}}) - [DBE\_PLDEBUGGER.continue]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-continue.md" >}}) - [DBE\_PLDEBUGGER.abort]({{< relref "./docs/SQLReference/DBE_PLDEBUGGER-abort.md" >}}) @@ -2448,4 +2482,4 @@ headless: true - [openGauss资源获取]({{< relref "./docs/Appendix/openGauss资源获取.md" >}}) - [错误日志信息参考]({{< relref "./docs/Appendix/错误日志信息参考.md" >}}) - [内核错误信息]({{< relref "./docs/Appendix/内核错误信息.md" >}}) - - [术语表]({{< relref "./docs/Appendix/术语表.md" >}}) \ No newline at end of file + - [术语表]({{< relref "./docs/Appendix/术语表.md" >}}) diff --git a/content/en/docs/AIFeatureGuide/prometheus-exporter-environment-deployment.md b/content/en/docs/AIFeatureGuide/prometheus-exporter-environment-deployment.md index f3d8f36d1701c6997c75a84c3590a3830ed0d445..4ae9371768c65e0d5da7b4721e84d41200d65800 100644 --- a/content/en/docs/AIFeatureGuide/prometheus-exporter-environment-deployment.md +++ b/content/en/docs/AIFeatureGuide/prometheus-exporter-environment-deployment.md @@ -161,6 +161,6 @@ The exporter component uses HTTPS for communication by default. Therefore, you n >The default communication protocol used by openGauss is incompatible with PostgreSQL. As a result, the PostgreSQL-based Python driver **psycopg2-binary** installed using the PyPI source cannot connect to the openGauss database. >Therefore, you need to compile **psycopg2** or modify GUC parameters for adaptation. You can also download **psycopg2** compiled based on openGauss from the openGauss official website. \(The official website provides only the compilation packages of some Python versions. You need to check whether the compilation packages are consistent with the current Python version.\) >- Download the openGauss Python driver from the official website: -> https://opengauss.org/en/download.html +> https://opengauss.org/en/download/ >- For details about the adaptation of the Python driver, see the openGauss operation guide at: > https://mp.weixin.qq.com/s/2TobUQKtw0N9sBpMZJr6zw diff --git a/content/en/docs/AboutopenGauss/data-check-tool-gs_datacheck.md b/content/en/docs/AboutopenGauss/data-check-tool-gs_datacheck.md new file mode 100644 index 0000000000000000000000000000000000000000..38f1ffbe2474a6845387d5679320f308e9e61b2f --- /dev/null +++ b/content/en/docs/AboutopenGauss/data-check-tool-gs_datacheck.md @@ -0,0 +1,48 @@ +# Data Check Tool gs\_datacheck + +## Availability + +This feature is available since openGauss 5.0.0. + +## Introduction + +gs\_datacheck is a tool for checking data from MySQL to openGauss based on the JDK 11 and Spring Boot 2.6.7 framework. This tool provides real-time full and incremental data check capabilities to implement data consistency check from MySQL to openGauss. + +## Benefits + +You can use the gs\_datacheck tool to check data consistency from the MySQL database to the openGauss database. + +## Description + +gs\_datacheck provides full and incremental check functions to check data consistency between MySQL and openGauss databases. + +- Full data check: + + After full data migration is complete, the extract service extracts data from the source MySQL database and target openGauss database in JDBC mode, normalizes and calculates the data, and pushes the calculated intermediate data to Kafka. Finally, the check service extracts intermediate data from Kafka, constructs a Merkle tree, checks table data through Merkle tree comparison, and outputs the check result. + +- Incremental data check: + + The debezium service listens to the incremental data of the source MySQL database to the specified topic. Then, the source extract service processes the incremental data of the topic and triggers the incremental check. + + +## Enhancements + +None. + +## Constraints + +- JDK 11 or later is required. +- The current version supports data check only between the source MySQL database and the target openGauss database. +- The current version supports only data check and does not support table object check. +- MySQL 5.7 or later is required. +- The current version does not support geographical location geometric data check. +- When row-level filtering rules are configured for data check, only data within the [offset,count] range can be extracted and filtered. +- When data within the range [10,100] is extracted based on the row-level filtering rule, if data before the range [0,10] is deleted from the source end, then data in the table is offset. As a result, the data check result is different. In this case, set **offset** to a smaller value to expand the range and set **count** to a larger value to increase the number of extracted records, for example, [3,107]. +- If a primary key UPDATE statement is not synchronized to the target end through incremental migration or an error occurs during primary key synchronization, data check is performed. The updated data on the source end and the old data on the target end are two independent data records. When the check difference is processed, two statements are generated to delete the old data and insert the new data. In this scenario, a primary key UPDATE statement is split into two statements (INSERT+DELETE) and executed in two transactions. Atomicity cannot be ensured. +- Incremental check does not support table-level rules. +- Incremental check does not support row-level rules. +- Incremental check supports only data addition, deletion, and modification checks. The consistency of table structures (objects) is not checked. + +## Dependencies + +None. diff --git a/content/en/docs/AboutopenGauss/database-security.md b/content/en/docs/AboutopenGauss/database-security.md index 00e0aa6934e3292a60011494cf335e8f7cc2e4f7..024ee85f9618e76214944efe59ddd1946f9090a1 100644 --- a/content/en/docs/AboutopenGauss/database-security.md +++ b/content/en/docs/AboutopenGauss/database-security.md @@ -16,7 +16,7 @@ - **[Unified Audit](unified-audit.md)** -- **[Dynamic Data Masking](dynamic-data-masking.md.md)** +- **[Dynamic Data Masking](dynamic-data-masking.md)** - **[Row-Level Access Control](row-level-access-control.md)** diff --git a/content/en/docs/AboutopenGauss/embedded-sql-preprocessor-ecpg.md b/content/en/docs/AboutopenGauss/embedded-sql-preprocessor-ecpg.md new file mode 100644 index 0000000000000000000000000000000000000000..424d3b6f7b319d9b4c33587847698de8cae312d2 --- /dev/null +++ b/content/en/docs/AboutopenGauss/embedded-sql-preprocessor-ecpg.md @@ -0,0 +1,33 @@ +# Embedded SQL Preprocessor ECPG + +## Availability + +This feature is available since openGauss 3.1.0. + +## Introduction + +Embedded SQL programs in C language are supported. + +## Benefits + +Embedded SQL programs compiled for other SQL databases can be easily migrated to openGauss, ensuring quick service migration. + +## Description + +An embedded SQL program consists of code written in an ordinary programming language, in this case C, mixed with SQL commands in specially marked sections. To build the program, the source code (\*.pgc) is first passed through the embedded SQL preprocessor, which converts it to an ordinary C program (\*.c), and afterwards it can be processed by a C compiler. Converted ECPG applications call functions in the libpq library through the embedded SQL library (ecpglib), and communicate with the openGauss server using the normal frontend-backend protocol. +The embedded SQL program has an advantage over other methods in processing SQL commands for C code. +1. It handles the lengthy information transfer between variables in C programs. +2. The SQL code in the program is checked during compilation to ensure syntax correctness. +3. SQL embedded in C is specified in SQL standards and is supported by many other SQL database systems. + +## Enhancements + +None. + +## Constraints + +ECPG supports most of the openGauss SQL syntax. However, the current syntax and lexical of the ECPG do not support the processing of anonymous block statements and package statements. Therefore, anonymous block statements and package creation statements cannot be used as embedded SQL statements. + +## Dependencies + +None. diff --git a/content/en/docs/AboutopenGauss/enhanced-features.md b/content/en/docs/AboutopenGauss/enhanced-features.md index 11c618917a0ea3b2a4365b108c373267d02a196b..5691adb6fe6fe1b3bcdee24edbf6aa5b1f77bf50 100644 --- a/content/en/docs/AboutopenGauss/enhanced-features.md +++ b/content/en/docs/AboutopenGauss/enhanced-features.md @@ -165,7 +165,7 @@ openGauss supports 10,000 concurrent connections through server thread pools. It To locate performance issues of a query, you can use **EXPLAIN PERFORMANCE** to query its execution plan. However, this method produces many logs, requires to modify service logic, and depends on expertise to locate problems. SQL self-diagnosis enables users to locate performance issues more efficiently. -Before running a job, set the GUC parameters **resource\_track\_level** and **resource\_track\_cost**, and obtain the possible performance issues after job execution by checking the related system view. The system view describes the possible causes of performance issues. To optimize low-performance jobs, see "**Performance Tuning **\> **SQL Tuning** \> **Typical SQL Optimization Methods** \> **Optimizing SQL Self-Diagnosis**" in the *Developer Guide*. +Before running a job, set the GUC parameters **resource\_track\_level** and **resource\_track\_cost**, and obtain the possible performance issues after job execution by checking the related system view. The system view describes the possible causes of performance issues. To optimize low-performance jobs, see [Optimizing SQL Self-Diagnosis](../PerformanceTuningGuide/optimizing-sql-self-diagnosis.md). SQL self-diagnosis helps users locate and optimize performance issues without affecting operations or modifying service logic. diff --git a/content/en/docs/AboutopenGauss/enhanced-mysql-compatibility.md b/content/en/docs/AboutopenGauss/enhanced-mysql-compatibility.md new file mode 100644 index 0000000000000000000000000000000000000000..13c77e588477ad48c6c1c6cb9c593a2e311877a9 --- /dev/null +++ b/content/en/docs/AboutopenGauss/enhanced-mysql-compatibility.md @@ -0,0 +1,27 @@ + +# Enhanced MySQL Compatibility + +## Availability + +This feature is available since openGauss 3.0.0. + +## Introduction + +This feature enhances the compatibility between openGauss and MySQL from the following aspects (only some typical syntax is listed. For details, see section "MySQL Compatibility" in the *Data Migration Guide*): + +User locks are supported. Users can use SQL statements to add user-defined locks so that multiple programs can complete lock-related interaction. In this way, clients can obtain consistent lock views from any location. + +When data is inserted into a newly created table, the current time is recorded by default. When data is updated without specifying the update time, the current time is displayed by default. + +The session-level SQL mode can be set to allow runtime, global, and intra-session changes. + +Hidden indexes are supported and are not used by the optimizer. + +Columns are case sensitive. The column names used during table creation retain case-sensitive information in the system catalog. When these columns are used, case-insensitive information is ignored. + +The default character set and collation can be set and modified at the schema, table, and column levels. + + +## Benefits + +A user lock is set to protect data, data structures, and some character strings, preventing mutual interference between sessions and ensuring information consistency and security. It solves the problem that the operation timestamp is recorded when the user service data is written or modified. By setting the SQL mode, you can solve the known issues in earlier versions and compatibility issues in later versions. By hiding indexes, you can test the impact of deleting an index on the query performance without disabling, deleting, or re-creating the index, improving the SQL tuning efficiency. By supporting case sensitivity, column names can remain case sensitive during query. You can set and modify the default character set and collation at the schema, table, and column levels based on the actual application scenarios. diff --git a/content/en/docs/AboutopenGauss/equality-query-in-a-fully-encrypted-database.md b/content/en/docs/AboutopenGauss/equality-query-in-a-fully-encrypted-database.md index ec22263726754172d5bcb9ad94ba0a3145f808a0..6e1464836a7b81d528ee92a4ef8b64c29536b07b 100644 --- a/content/en/docs/AboutopenGauss/equality-query-in-a-fully-encrypted-database.md +++ b/content/en/docs/AboutopenGauss/equality-query-in-a-fully-encrypted-database.md @@ -46,7 +46,7 @@ None. - Data can only be imported to the encrypted table by running **copy from stdin**, **\\copy**, or **insert into values \(...\)** on the client. - Copying an encrypted table to a file is not supported. - The system does not support encrypted queries, such as sorting, range query, and fuzzy query, except equality query. -- The encrypted syntax of stored procedures for some functions is supported. For details about the constraints, see "Encrypted Functions and Stored Procedures" in the *Developer Guide*. +- The encrypted syntax of stored procedures for some functions is supported. For details about the constraints, see [Encrypted Functions and Stored Procedures](../DatabaseAdministrationGuide/encrypted-functions-and-stored-procedures.md). - Non-encrypted table data cannot be inserted into encrypted table data using the **INSERT INTO... SELECT...** or **MERGE INTO** syntax. - For a request in connection state, the CEK information change on the server can be detected only after the cache update operation is triggered \(for example, the user is changed or the encrypted column fails to be decrypted\) and the connection is re-established. - Encrypted equality query is not supported on columns encrypted using the random encryption algorithm. diff --git a/content/en/docs/AboutopenGauss/event-trigger.md b/content/en/docs/AboutopenGauss/event-trigger.md index c3c349dbded4cce11fbcd45d381cd00ee47240d9..a934a9c98de42174161aaf4e09044b318555d739 100644 --- a/content/en/docs/AboutopenGauss/event-trigger.md +++ b/content/en/docs/AboutopenGauss/event-trigger.md @@ -16,18 +16,18 @@ A typical application scenario is as follows: An event trigger is used to captur ## Description The event trigger can capture DDL operations in the current database and target objects of DDL operations. It cannot capture operations on shared objects, such as databases, roles, and tablespaces. -The event trigger can capture four types of events: ddl_command_start, ddl_command_end, sql_drop, and table_rewrite. -1. The ddl_command_start event occurs before the CREATE, ALTER, DROP, SECURITY LABEL, COMMENT, GRANT, or REVOKE statement is executed. The existence of the affected object is not checked before the event trigger is used. -2. The ddl_command_end event captures DDL operations and occurs after DDL execution. -3. The sql_drop event captures any operation of deleting database objects and is executed before ddl_command_end. -4. The table_rewrite event occurs only before the table is overwritten by some actions of the ALTER TABLE and ALTER TYPE statements. +The event trigger can capture four types of events: ddl\_command\_start, ddl\_command\_end, sql\_drop, and table\_rewrite. +1. The ddl\_command\_start event occurs before the CREATE, ALTER, DROP, SECURITY LABEL, COMMENT, GRANT, or REVOKE statement is executed. The existence of the affected object is not checked before the event trigger is used. +2. The ddl\_command\_end event captures DDL operations and occurs after DDL execution. +3. The sql\_drop event captures any operation of deleting database objects and is executed before ddl\_command\_end. +4. The table\_rewrite event occurs only before the table is overwritten by some actions of the ALTER TABLE and ALTER TYPE statements. ## Constraints - This feature is available only in PG-compatible mode. - Only the system administrator can add, delete, and modify the event trigger. -- Built-in functions related to the event trigger can be used only for event trigger functions (the return type is event_trigger). +- Built-in functions related to the event trigger can be used only for event trigger functions (the return type is event\_trigger). ## Dependencies diff --git a/content/en/docs/AboutopenGauss/figures/global-syscache-principle.png b/content/en/docs/AboutopenGauss/figures/global-syscache-principle.png index 62239c90d9c6477b467f29177ac7c6039b05aade..ded222408e1f0d7ef50c09fb55933611a2e17767 100644 Binary files a/content/en/docs/AboutopenGauss/figures/global-syscache-principle.png and b/content/en/docs/AboutopenGauss/figures/global-syscache-principle.png differ diff --git a/content/en/docs/AboutopenGauss/figures/opengauss-logical-architecture.png b/content/en/docs/AboutopenGauss/figures/opengauss-logical-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..5207195f395c5af8f4856e6133245f3e173539ff Binary files /dev/null and b/content/en/docs/AboutopenGauss/figures/opengauss-logical-architecture.png differ diff --git a/content/en/docs/AboutopenGauss/figures/opengauss-resource-pooling-architecture.png b/content/en/docs/AboutopenGauss/figures/opengauss-resource-pooling-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..be0c2ac69b90d14c1edef3014d16334d11a5c687 Binary files /dev/null and b/content/en/docs/AboutopenGauss/figures/opengauss-resource-pooling-architecture.png differ diff --git a/content/en/docs/AboutopenGauss/figures/resource-pooling-architecture.jpg b/content/en/docs/AboutopenGauss/figures/resource-pooling-architecture.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5660ba63a46a9ad5d100ee08f129615f670c9280 Binary files /dev/null and b/content/en/docs/AboutopenGauss/figures/resource-pooling-architecture.jpg differ diff --git a/content/en/docs/AboutopenGauss/full-migration-tool-gs_mysync.md b/content/en/docs/AboutopenGauss/full-migration-tool-gs_mysync.md new file mode 100644 index 0000000000000000000000000000000000000000..7e917a642348e7126a98895de084298d19d53b47 --- /dev/null +++ b/content/en/docs/AboutopenGauss/full-migration-tool-gs_mysync.md @@ -0,0 +1,29 @@ +# Full Migration Tool gs\_mysync + +## Availability + +This feature is available since openGauss 5.0.0. + +## Introduction + +gs\_mysync is a Python-based tool that supports replication from MySQL to openGauss. This tool provides the capability of replicating initial full data and objects (views, triggers, functions, and stored procedures) to migrate data and objects from MySQL to openGauss. It supports full migration of various data types in MySQL, and maintains the precision of floating-point data after migration, including the decimal, dec, numeric, float, float4, float8, real, double, double precision, and fixed types. + +## Benefits + +You can use gs\_mysync to migrate data from the MySQL database to the openGauss database. + +## Description + +gs\_mysync provides the full data replication function to migrate data from the MySQL database to the openGauss database. gs\_mysync stores the mappings between MySQL and openGauss data types and supports migration of various data types in MySQL. Specifically, floating-point data in MySQL, including decimal, dec, numeric, float, float4, float8, real, double, double precision and fixed, will be converted to the number[p, s\] type in openGauss if the precision is specified or contained by default. If the precision is not specified, the data will be converted to the number data type in openGauss. In this way, the data precision remains unchanged after offline and online migration. + +## Enhancements + +None. + +## Constraints + +- MySQL 5.7 is supported. + +## Dependencies + +gs\_mysync depends on the MySQL migration tool gs\_rep\_portal. diff --git a/content/en/docs/AboutopenGauss/gray-upgrade.md b/content/en/docs/AboutopenGauss/gray-upgrade.md index 0cbe6887306b51d9a2b765af54ce3ae117559215..231049f5234ea7b34fdecfc830369cd015aa1955 100644 --- a/content/en/docs/AboutopenGauss/gray-upgrade.md +++ b/content/en/docs/AboutopenGauss/gray-upgrade.md @@ -22,8 +22,8 @@ None. ## Constraints -For details about the gray upgrade constraints, see "Before You Start \> Upgrade Impact and Constraints" in _Upgrade Guide_. - +For details about the gray upgrade constraints, see [Before You Start](../DatabaseOMGuide/before-you-start.md). + ## Dependencies None. diff --git a/content/en/docs/AboutopenGauss/gs_rep_portal.md b/content/en/docs/AboutopenGauss/gs_rep_portal.md new file mode 100644 index 0000000000000000000000000000000000000000..d2ff2bbfeacce6defd8e2236f1d0012ca6f1aeec --- /dev/null +++ b/content/en/docs/AboutopenGauss/gs_rep_portal.md @@ -0,0 +1,37 @@ +# MySQL Migration Tool gs\_rep\_portal + +## Availability + +This feature is available since openGauss 5.0.0. + +## Introduction + +gs\_rep\_portal is a Java-based tool that runs on Linux and integrates full migration, incremental migration, reverse migration, and data check. gs\_rep\_portal allows you to install the preceding tools in one-click mode and set migration tasks. The tasks invoke the corresponding tools to complete each migration step based on the user-defined execution plan and display the status, progress, and exception cause of each step in real time. + +## Benefits + +You can use gs\_rep\_portal to quickly start a migration plan that contains multiple migration tools. Multiple migration plans can be started at the same time. + +## Description + +gs\_rep\_portal is a Java-based tool that runs on Linux and integrates full migration, incremental migration, reverse migration, and data check. gs\_rep\_portal allows you to install the preceding tools in one-click mode and set migration tasks. The tasks invoke the corresponding tools to complete each migration step based on the user-defined execution plan and display the status, progress, and exception cause of each step in real time. + +## Enhancements + +None. + +## Constraints + +- The curl tool is required for incremental migration, reverse migration, and incremental check on the portal. + +- Incremental migration and reverse migration of the same migration plan cannot be enabled at the same time. If a plan contains incremental migration and reverse migration, you need to manually stop incremental migration and start reverse migration. Incremental migration cannot be started after reverse migration is started. + +- After stopping incremental migration and before starting reverse migration, do not perform jobs on openGauss. Otherwise, data will be lost. + +- The value of **workspace.id** used by the portal can contain only lowercase letters and digits. + +- When starting multiple plans on the portal, ensure that the MySQL database instances are different and openGauss databases are different. In addition, incremental migration and reverse migration of the same MySQL database instance and openGauss database cannot be enabled at the same time. + +## Dependencies + +This feature depends on the normal use of migration tools. diff --git a/content/en/docs/AboutopenGauss/incremental-migration-tool-gs_replicate.md b/content/en/docs/AboutopenGauss/incremental-migration-tool-gs_replicate.md new file mode 100644 index 0000000000000000000000000000000000000000..06db125dcc783a8cb4fc0e99568db9a2ec591c83 --- /dev/null +++ b/content/en/docs/AboutopenGauss/incremental-migration-tool-gs_replicate.md @@ -0,0 +1,50 @@ +# Incremental Migration Tool gs\_replicate + +## Availability + +This feature is available since openGauss 5.0.0. + +## Introduction + +gs\_replicate migrates incremental data generated during MySQL data migration (including full and incremental migration) to openGauss. + +## Benefits + +You can use gs\_replicate to migrate incremental data from the MySQL database to the openGauss database. + +## Description + +The source end of the debezium mysql connector monitors binlogs of the MySQL database and writes DDL and DML operations to Kafka in AVRO format. The sink end of the debezium mysql connector reads DDL and DML operations in AVRO format from Kafka, assembles the data into transactions, and plays back the transactions in parallel on the openGauss based on the transaction granularity to migrate DDL and DML operations from MySQL to openGauss online. + +This solution strictly ensures the transaction sequence. Therefore, DDL and DML operations are routed in a topic of Kafka, and the number of partitions of the topic can only be 1 (**num.partitions=1**). In this way, the data pushed from the source end to Kafka and the data obtained by the sink end from Kafka is in strict sequence. + +## Enhancements + +None. + +## Constraints + +- Currently, incremental data generated by MySQL INSERT, UPDATE, and DELETE (IUD) operations can be migrated to openGauss. + +- MySQL DDL statements compatible with the openGauss database can be migrated. For incompatible DDL statements, an error will be reported during the migration. (openGauss is improving its compatibility with DDL statements.) + +- To ensure the sequence and consistency of transactions, settings such as skip\_event, limit\_table, skip\_table are not supported. + +- MySQL 5.7 or later is required. + +- The MySQL parameter must be set to **log\_bin=ON, binlog\_format=ROW, binlog\_row\_image=FULL, gtid\_mode = ON**. If **gtid\_mode** is set to **off**, the sink end replays data in serial mode based on the transaction sequence, which deteriorates the online migration performance. + +- Full migration is performed by using [gs_mysync](https://gitee.com/opengauss/openGauss-tools-chameleon/blob/master/README.en.md) before incremental migration. + +- Kafka stores data in AVRO format. The AVRO [naming rules](https://avro.apache.org/docs/1.11.1/specification/#names) are as follows: + + ``` + - Start with [A-Za-z_]. + - Subsequently contain only [A-Za-z0-9_]. + ``` + + Therefore, naming identifiers in MySQL, including table names and column names, must comply with the preceding naming rules. Otherwise, an error will be reported during online migration. + +## Dependencies + +gs_replicate depends on the MySQL migration tool gs_rep\_portal. diff --git a/content/en/docs/AboutopenGauss/resource-pooling.md b/content/en/docs/AboutopenGauss/resource-pooling.md new file mode 100644 index 0000000000000000000000000000000000000000..c73aaec55458d2e7e4e8bee283c02e5380da8902 --- /dev/null +++ b/content/en/docs/AboutopenGauss/resource-pooling.md @@ -0,0 +1,55 @@ +# Resource Pooling + +## Availability + +This feature is available since openGauss 3.1.1. + +## Introduction + +This feature enables the primary and standby nodes to share the same storage, implementing resource pooling HA deployment based on disk arrays. This solves the problem that the storage capacity is doubled compared with that of a single server in traditional HA deployment. In addition, the standby server supports real-time consistent read. The following figure shows the resource pooling architecture. + +**Figure 1** Resource pooling architecture + + +## Benefits + +In traditional HA deployment mode, the storage capacity is doubled compared with that of a single node, reducing the storage capacity. The standby node supports real-time consistent read, fully utilizing the computing power of multiple primary/standby nodes. + +## Description + +- The resource pooling depends on two Huawei-developed components: + - Distributed storage service (DSS) + + DSS is classified into DSS API and DSS server. The DSS server is an independent process that directly manages raw devices of disk arrays and provides capabilities similar to distributed file systems for external systems. The DSS API is a dynamic library integrated in the database. The DSS component uses the shared memory and client API dynamic library to provide the database with the capabilities of creating files, deleting files, expanding and shrinking files, and reading and writing files. + + - Distributed Memory Service (DMS) + + DMS is a dynamic library integrated in the database. It transmits page content through the TCP/RDMA network, integrates the primary and standby memories, and provides the memory pooling capability to implement real-time consistent read on the standby node. + + +- Storage pooling uses the DSS component to enable the primary and standby nodes to share the same storage. Compared with traditional database creation, resource pooling classifies directories into three types: exclusively used and not shared by each instance, exclusively used and shared by each instance, and shared by all instances. The directories to be shared must be stored on the disk array, and the directories that are not shared must be stored on the local disk. In addition, to create a database on the standby node, you only need to create a directory that belongs to the standby node. You do not need to create a directory structure shared by all instances. GUC parameters are added to the resource pooling, and the storage mode of system catalogs is switched from page mode to segment-page mode. +- Memory pooling uses the DMS component to implement real-time page exchange between the primary and standby nodes and ensure real-time data consistency on standby nodes. That is, after a transaction is committed on the primary node, the transaction can be read on the standby node immediately. There is no delayed read (the transaction isolation level is read committed). +- Memory pooling can use OCK RDMA to reduce the DMS primary/standby page switching latency. Compared with the latency of read consistency on a standby node in TCP mode, when OCK RDMA is enabled, the latency is reduced by at least 20%. + +## Enhancements + +In version 5.0.0, this feature is enhanced as follows: + +- Resource pooling can be upgraded from 5.0.0 to a later version. + +## Constraints + +- The resource pooling solution depends on disk arrays. The LUN of the disk array must support the SCSI-3 PR protocol, including PERSISTENT RESERVE OUT (PR OUT), PERSISTENT RESERVE IN (PR IN), and INQUIRY, to implement cluster IO FENCE. In addition, the COMPARE AND WRITE (CAW) protocol of SCSI-3 must be supported to implement shared disk locks. For example, Dorado 5000 V3 disk array. +- The HA deployment mode implemented by resource pooling supports a maximum of one primary node and seven standby nodes. +- Resource pooling depends on functions similar to the distributed file system to implement the real-time read consistency on standby nodes. Therefore, the less the file metadata changes, the better. To ensure performance, this feature supports only segment-page tables. +- The primary and standby nodes must be deployed on the same disk array. DR deployment and hybrid deployment of the primary and standby nodes are not supported. For example, the primary and standby nodes are deployed on different disk arrays. +- Page exchange between the primary and standby nodes is accelerated by RDMA, depending on the CX5 NIC and OCK RDMA dynamic library. +- Currently, standby node rebuild, node replacement, and node restoration are not supported. +- Databases in resource pooling mode and databases in traditional mode cannot be upgraded to each other. +- In resource pooling mode, the following functions cannot be used: gs\_xlogdump\_xid, gs\_xlogdump\_lsn, gs\_xlogdump\_tablepath, gs\_xlogdump\_parsepage\_tablepath, pg\_create\_logical\_replication\_slot, gs\_verify\_and\_tryrepair\_page, gs\_repair\_page, and gs\_repair\_file. +- In resource pooling mode, the following subscription functions are not supported: T\_CreatePublicationStmt, T\_AlterPublicationStmt, T\_CreateSubscriptionStmt, T\_AlterSubscriptionStmt, and T\_DropSubscriptionStmt. +- Global temporary tables are not supported in resource pooling mode. + +## Dependencies + +None. diff --git a/content/en/docs/AboutopenGauss/reverse-migration-gs_replicate.md b/content/en/docs/AboutopenGauss/reverse-migration-gs_replicate.md new file mode 100644 index 0000000000000000000000000000000000000000..b2e6483c9c774c53050b2ca5a15d40e69665d397 --- /dev/null +++ b/content/en/docs/AboutopenGauss/reverse-migration-gs_replicate.md @@ -0,0 +1,32 @@ +# Reverse Migration + +## Introduction + +The incremental data can be migrated from openGauss to MySQL online. + +## Benefits + +Reverse migration allows you to migrate data from the source database to the target database, switch applications to the target database, and then migrate new data from the target database to the source database. Reverse migration meets users' requirements for service migration survival. It ensures that the source and target databases run concurrently. If the target database is faulty, applications can be switched back to the source database in time. + +## Description + +The source end of the debezium opengauss connector monitors openGauss xlogs and writes DML operations to Kafka in AVRO format. + +The sink end of the debezium opengauss connector reads data in AVRO format from Kafka and plays back the data by table on MySQL. In this way, DML operations are migrated from openGauss to MySQL online. + +## Enhancements + +None. + +## Constraints + +1. The value of the GUC parameter **wal\_level** must be set to **logical**. +2. This operation can be performed only by users who can perform logical replication. +3. DDL operations cannot be migrated. +4. If the SSL connection is required, the GUC parameter **ssl** must be set to **on**. +5. Multiple databases cannot use the same logical replication slot. +6. Do not perform operations on the replication slot on other nodes when the logical replication slot is being used. You can use the **slot.drop.on.stop** parameter to determine whether to delete the logical replication slot when the tool exits. + +## Dependencies + +It depends on logical replication and publication-subscription. diff --git a/content/en/docs/AboutopenGauss/rolling-upgrade.md b/content/en/docs/AboutopenGauss/rolling-upgrade.md index 4ce7b5ea7c3388a897d30704b730eb3441d6d676..e58b76ed1a060df0338675e20305814ea443e0d7 100644 --- a/content/en/docs/AboutopenGauss/rolling-upgrade.md +++ b/content/en/docs/AboutopenGauss/rolling-upgrade.md @@ -23,7 +23,7 @@ None. ## Constraints All gray upgrade constraints are met. -For details about the gray upgrade constraints, see "Before You Start \> Upgrade Impact and Constraints" in *Upgrade Guide*. +For details about the gray upgrade constraints, see [Before You Start](../DatabaseOMGuide/before-you-start.md). ## Dependencies diff --git a/content/en/docs/AboutopenGauss/support-for-advanced-analysis-functions.md b/content/en/docs/AboutopenGauss/support-for-advanced-analysis-functions.md index 2830b77b5ddceb7689995cfaa24b48164ab66900..a3c35ebb7d70fc38f0639e4d12747a01d1308bad 100644 --- a/content/en/docs/AboutopenGauss/support-for-advanced-analysis-functions.md +++ b/content/en/docs/AboutopenGauss/support-for-advanced-analysis-functions.md @@ -35,7 +35,7 @@ sales | 4 | 4800 | 4866.6666666666666667 The analysis function **avg\(salary\) OVER \(PARTITION BY depname\)** easily calculates each employee's salary and the average salary of the department. -Currently, the system supports the following analysis functions: **row\_number\(\)**, **rank\(\)**, **dense\_rank\(\)**, **percent\_rank\(\)**, **cume\_dist\(\)**, **ntile\(\)**, **lag\(\)**, **lead\(\)**, **first\_value\(\)**, **last\_value\(\)**, and **nth\_value\(\)**. For details about functions and statements, see "SQL Reference \> Functions and Operators \> Window Functions" in the _Developer Guide_. +Currently, the system supports the following analysis functions: **row\_number\(\)**, **rank\(\)**, **dense\_rank\(\)**, **percent\_rank\(\)**, **cume\_dist\(\)**, **ntile\(\)**, **lag\(\)**, **lead\(\)**, **first\_value\(\)**, **last\_value\(\)**, and **nth\_value\(\)**. For details about functions and statements, see [Window Functions](../SQLReference/window-functions.md). ## Enhancements diff --git a/content/en/docs/AboutopenGauss/system-architecture.md b/content/en/docs/AboutopenGauss/system-architecture.md index 54f86a3ef1dc974d6808951d50f2d3621b748847..8b2e08e505dba59c6006abbfd00f72732d68f45b 100644 --- a/content/en/docs/AboutopenGauss/system-architecture.md +++ b/content/en/docs/AboutopenGauss/system-architecture.md @@ -1,51 +1,33 @@ # System Architecture -openGauss is a standalone database where data is stored on a single physical node and data access tasks are pushed to service nodes. In this way, high concurrency of servers enables quick data processing. In addition, data can be copied to the standby server through log replication, ensuring high reliability and scalability. +Digital technologies are accelerating the implementation of industry applications and support abundant online applications and services. Industry digitalization accelerates the generation of massive data. Multiple data types, such as graphs, flows, time sequences, and map spaces, are emerging one after another, requiring different computing architectures for processing. The computing requirements of databases evolve from general-purpose CPUs to diversified computing such as GPUs and NPUs. In addition, to effectively meet the ultimate requirements of large-scale databases for reliability, performance, and usability, databases in the industry gradually adopt a unified and standard resource pooling architecture. + + To address the evolution trend of diversified computing, openGauss implements a resource pooling architecture and decouples computing, memory, and storage for the first time. Layer-by-layer pooling brings better resource scheduling efficiency, better processing performance, and innovation agility. Based on the trend of multi-mode data convergence, the HTAP architecture is implemented. In addition, the data processing capabilities of different models, such as graph databases and time series databases, are jointly developed in the openGauss community. This enables openGauss to implement multi-mode data convergence processing and analysis. + +The future-oriented openGauss resource pooling architecture consists of three pooling layers, one platform, and one standard. The following figure shows the architecture. + +  + + +Three pooling layers include storage pooling, memory pooling, and compute pooling. Storage pooling supports multiple types of storage, such as distributed storage and enterprise storage. One data service can be used for multiple types of computing. The NDP technology of SQL operator offloading greatly improves SQL processing efficiency and reduces network I/O traffic. Memory pooling implements memory interconnection between compute nodes. Transaction information and database cache are synchronized to implement consistent read of multi-version snapshots on multiple nodes. RoCE and SCM hardware are used to implement ultimate commit acceleration and large-capacity memory access. Computing pooling supports diversified computing power. Based on computing power such as x86 and Kunpeng, it provides applications with comprehensive data services such as TP row store acceleration, AP column store acceleration, and AI training and inference. Above the three-layer pooling, it is a full-scenario SQL standard that provides applications with a series of query interfaces for data analysis, AI inference, and graph query, fully unleashing data value. In addition, the integrated platform implements intelligent O&M, cluster management, and resource orchestration capabilities to ensure stable running and elastic scaling of databases under heavy loads. ## Software Architecture -openGauss is a standalone database and can be deployed in primary/standby mode. - -openGauss shows the logical components of [Figure 1](#en-us_topic_0283136530_en-us_topic_0237080634_en-us_topic_0231764167_fig5205420191411). - -**Figure 1** openGauss logical components - - -**Table 1** Architecture description - - - + + + +The openGauss resource pooling architecture supports one primary node and seven standby nodes. The primary node supports read and write, and the standby node supports scale-out read capability to meet the performance requirements of typical loads in the real world. Real-time data consistency among multiple nodes supports transparent expansion of data consistency-sensitive application loads from a single node to multiple nodes. It eliminates the overhead of traditional primary/standby log replication, reducing storage costs by more than 50%. The lightweight RPC framework is implemented based on the high-performance RDMA network, significantly reducing the CPU resource overhead and achieving μs-level network latency. The multi-level cache capability of SCM improves performance by 30% at the same memory cost. + + +**Table 1** Architecture description +| Name | Description | +|------|-----------------------------------------------------------------------------------------------------------------------------------------| +| DMS | DMS is a dynamic library integrated in the database. It transmits page content through the TCP/RDMA network, integrates the primary and standby memories, and provides the memory pooling capability to implement real-time consistent read on the standby node. | +| DSS | DSS is an independent process that directly manages raw devices of disk arrays and provides capabilities similar to distributed file systems for external systems. The shared memory and client API dynamic library provide the database with the capabilities of creating files, deleting files, expanding and shrinking files, and reading and writing files. | +| Shared storage| The enterprise-level storage and distributed storage are supported. Compared with traditional database creation, resource pooling classifies directories into three types: exclusively used and not shared by each instance, exclusively used and shared by each instance, and shared by all instances. The directories to be shared must be stored on the shared storage, and the directories that are not shared must be stored on the local disk. In addition, to create a database on the standby node, you only need to create a directory that belongs to the standby node. You do not need to create a directory structure shared by all instances.| +| OCK-RDMA | OCK RDMA can be used to reduce the latency of DMS primary/standby page switching. After OCK RDMA is enabled, the consistent read latency of the standby node is improved by over 20%.| +|SCM | SCM acceleration based on persistent memory improves performance by 30% at the same memory cost.| diff --git a/content/en/docs/AboutopenGauss/tool-chain.md b/content/en/docs/AboutopenGauss/tool-chain.md index 21c5fd25087948ebf563962afeab7e6357524b1b..2e1191dacbeac8b1ff13189760645f2a83433fac 100644 --- a/content/en/docs/AboutopenGauss/tool-chain.md +++ b/content/en/docs/AboutopenGauss/tool-chain.md @@ -1,5 +1,5 @@ # Tool Chain -- **[MySQL to openGauss Migration Tool Chameleon](mysql-to-opengauss-migration-tool-chameleon.md)** + - **[OpenGauss Client Tool DataStudio](opengauss-client-tool-datastudio.md)** diff --git a/content/en/docs/Appendix/figures/en-us_image_0000001103872542.png b/content/en/docs/Appendix/figures/en-us_image_0000001103872542.png new file mode 100644 index 0000000000000000000000000000000000000000..9047c62644435c6ef5258e05fdd6f5a73f75594e Binary files /dev/null and b/content/en/docs/Appendix/figures/en-us_image_0000001103872542.png differ diff --git a/content/en/docs/Appendix/figures/en-us_image_0000001104198936.png b/content/en/docs/Appendix/figures/en-us_image_0000001104198936.png new file mode 100644 index 0000000000000000000000000000000000000000..9b1b2c786fbbd32a7246fb982ad59148a97d3c2b Binary files /dev/null and b/content/en/docs/Appendix/figures/en-us_image_0000001104198936.png differ diff --git a/content/en/docs/Appendix/obtaining-opengauss-resources.md b/content/en/docs/Appendix/obtaining-opengauss-resources.md index ab06cb717e539fa2d4bfba8f71be5ae70bb1188e..ed3f3e140f37ad5a515b1ab3a691d4a39cf59f93 100644 --- a/content/en/docs/Appendix/obtaining-opengauss-resources.md +++ b/content/en/docs/Appendix/obtaining-opengauss-resources.md @@ -19,7 +19,7 @@ openGauss provides online resources that contain a lot of useful information, su openGauss has opened the database source code and an [openGauss community](https://gitee.com/opengauss) has been established. openGauss encourages users to contribute to and cooperate with the community, hoping to jointly build an enterprise-level open-source database community that can integrate diversified technical architectures. -The openGauss community is organized based on different Special Interest Groups \(SIGs\) to better manage and improve the work process. SIGs are open to everyone to make contributions. Each SIG has one or more code repositories on the Gitee platform. You can commit issues, participate in issue discussions, pull requests, and review code in the code repository of an SIG. [Table 1](#table9705652154412) lists common SIGs. You can find the SIGs that you are interested in from the SIG list. For details about how to contribute to the community, see [Contribution](https://opengauss.org/zh/contribution.html). +The openGauss community is organized based on different Special Interest Groups \(SIGs\) to better manage and improve the work process. SIGs are open to everyone to make contributions. Each SIG has one or more code repositories on the Gitee platform. You can commit issues, participate in issue discussions, pull requests, and review code in the code repository of an SIG. [Table 1](#table9705652154412) lists common SIGs. You can find the SIGs that you are interested in from the SIG list. For details about how to contribute to the community, see [Contribution](https://opengauss.org/zh/contribution/). **Table 1** Common SIGs in the openGauss community @@ -100,7 +100,7 @@ The openGauss community is organized based on different Special Interest Groups | Develops and maintains database security technologies of the openGauss community. |
|||||||||||||||||||||||||
| + | ||||||||||||||||||||||||||
Defines and develops the certification process and test suites for the openGauss release. |
@@ -135,11 +135,11 @@ The openGauss community is organized based on different Special Interest Groups
## Blog
-openGauss provides a [blog](https://opengauss.org/zh/blogs/blogs.html) section, where users can exchange their problems and experience during the use of openGauss. If you encounter any problem, you can also search for other users' solutions. Or, post blogs to share your experience with other users, helping them solve problems.
+openGauss provides a [blog](https://opengauss.org/zh/blogs/) section, where users can exchange their problems and experience during the use of openGauss. If you encounter any problem, you can also search for other users' solutions. Or, post blogs to share your experience with other users, helping them solve problems.
## Mailing List
-The openGauss community uses the mailing list for online communication. We sincerely invite you to participate indiscussions through the mailing list. For details, see [Communication](https://opengauss.org/zh/community/onlineCommunication.html).
+The openGauss community uses the mailing list for online communication. We sincerely invite you to participate indiscussions through the mailing list. For details, see [Communication](https://opengauss.org/zh/community/onlineCommunication/).
## Learning Platform
diff --git a/content/en/docs/BriefTutorial/BriefTutorial.md b/content/en/docs/BriefTutorial/BriefTutorial.md
index 1bc620c63a4969f14b54f0a2351d149ca6998294..e4c50af8ef0c106f4726fb5de2c545e9987ccc37 100644
--- a/content/en/docs/BriefTutorial/BriefTutorial.md
+++ b/content/en/docs/BriefTutorial/BriefTutorial.md
@@ -6,5 +6,5 @@ For example the **Installation Guide** provides information about installation r
Many important features of openGauss are introduced in the **Developer Guide** section.
-For example, the **[MOT Engine](../Developerguide/mot.md)** section provides a detailed review of the Memory Optimized Tables, a high performance storage engine embedded side-by-side the standard storage engine. This includes “MOT Introduction” section (including performance benchmarks), followed by the “Using MOT” section complete manual guide, and concluded by the “MOT Concepts” section with deeper insight into MOT design and technologies.
+For example, the **[MOT Engine](../DatabaseAdministrationGuide/using-mot.md)** section provides a detailed review of the Memory Optimized Tables, a high performance storage engine embedded side-by-side the standard storage engine. This includes “MOT Introduction” section (including performance benchmarks), followed by the “Using MOT” section complete manual guide, and concluded by the “MOT Concepts” section with deeper insight into MOT design and technologies.
diff --git a/content/en/docs/BriefTutorial/expressions.md b/content/en/docs/BriefTutorial/expressions.md
index aa1b211b8038f85a9cb5e4234a874858f90e51ac..2725fbc290d84b55cbeeb9214172d3af527281a4 100644
--- a/content/en/docs/BriefTutorial/expressions.md
+++ b/content/en/docs/BriefTutorial/expressions.md
@@ -6,7 +6,7 @@ An expression is similar to a formula. You can use it in a query statement to se
- Logical expressions
- [Logical Operators](operators.md#section2075011374558) lists the operators and computation rules of logical expressions.
+ [Logical Operators](../DeveloperGuide/operators.md#section2075011374558) lists the operators and computation rules of logical expressions.
- Comparison expressions
diff --git a/content/en/docs/BriefTutorial/obtaining-opengauss-resources.md b/content/en/docs/BriefTutorial/obtaining-opengauss-resources.md
index ab06cb717e539fa2d4bfba8f71be5ae70bb1188e..ed3f3e140f37ad5a515b1ab3a691d4a39cf59f93 100644
--- a/content/en/docs/BriefTutorial/obtaining-opengauss-resources.md
+++ b/content/en/docs/BriefTutorial/obtaining-opengauss-resources.md
@@ -19,7 +19,7 @@ openGauss provides online resources that contain a lot of useful information, su
openGauss has opened the database source code and an [openGauss community](https://gitee.com/opengauss) has been established. openGauss encourages users to contribute to and cooperate with the community, hoping to jointly build an enterprise-level open-source database community that can integrate diversified technical architectures.
-The openGauss community is organized based on different Special Interest Groups \(SIGs\) to better manage and improve the work process. SIGs are open to everyone to make contributions. Each SIG has one or more code repositories on the Gitee platform. You can commit issues, participate in issue discussions, pull requests, and review code in the code repository of an SIG. [Table 1](#table9705652154412) lists common SIGs. You can find the SIGs that you are interested in from the SIG list. For details about how to contribute to the community, see [Contribution](https://opengauss.org/zh/contribution.html).
+The openGauss community is organized based on different Special Interest Groups \(SIGs\) to better manage and improve the work process. SIGs are open to everyone to make contributions. Each SIG has one or more code repositories on the Gitee platform. You can commit issues, participate in issue discussions, pull requests, and review code in the code repository of an SIG. [Table 1](#table9705652154412) lists common SIGs. You can find the SIGs that you are interested in from the SIG list. For details about how to contribute to the community, see [Contribution](https://opengauss.org/zh/contribution/).
**Table 1** Common SIGs in the openGauss community
@@ -100,7 +100,7 @@ The openGauss community is organized based on different Special Interest Groups
Develops and maintains database security technologies of the openGauss community. |
|||||||||||||||||||||||||
| + | ||||||||||||||||||||||||||
Defines and develops the certification process and test suites for the openGauss release. |
@@ -135,11 +135,11 @@ The openGauss community is organized based on different Special Interest Groups
## Blog
-openGauss provides a [blog](https://opengauss.org/zh/blogs/blogs.html) section, where users can exchange their problems and experience during the use of openGauss. If you encounter any problem, you can also search for other users' solutions. Or, post blogs to share your experience with other users, helping them solve problems.
+openGauss provides a [blog](https://opengauss.org/zh/blogs/) section, where users can exchange their problems and experience during the use of openGauss. If you encounter any problem, you can also search for other users' solutions. Or, post blogs to share your experience with other users, helping them solve problems.
## Mailing List
-The openGauss community uses the mailing list for online communication. We sincerely invite you to participate indiscussions through the mailing list. For details, see [Communication](https://opengauss.org/zh/community/onlineCommunication.html).
+The openGauss community uses the mailing list for online communication. We sincerely invite you to participate indiscussions through the mailing list. For details, see [Communication](https://opengauss.org/zh/community/onlineCommunication/).
## Learning Platform
diff --git a/content/en/docs/BriefTutorial/primary-standby-shared-storage.md b/content/en/docs/BriefTutorial/primary-standby-shared-storage.md
index 9053c2f0234b1161ef70dc51206fbcdbf049a4bd..1dc626e151391125ff373975268f4cadaabb7b12 100644
--- a/content/en/docs/BriefTutorial/primary-standby-shared-storage.md
+++ b/content/en/docs/BriefTutorial/primary-standby-shared-storage.md
@@ -46,7 +46,7 @@ Compared with traditional gs\_initdb database creation, directories are classifi
>Step-by-step manual installation means that you can run related commands step by step to create a database for shared storage after project compilation. For details about how to install the openGauss, see the *Installation Guide*.
- Prerequisites
- - The code of the project has been compiled. For details about the compilation, see [Software Compilation and Installation](../Compilationguide/setting-up-the-compilation-environment.md.md).
+ - The code of the project has been compiled. For details about the compilation, see [Software Compilation and Installation](../CompilationGuide/setting-up-the-compilation-environment.md).
- The LUN of the disk array has been mounted to the host, the UltraPath software has been installed, and the disk array is available.
@@ -238,7 +238,7 @@ The shared storage feature provides the real-time read consistency function on s
3. Perform steps [1](#li0988195961613) to [5](#li23296624419) to gs\_initdb to create a database.
4. Modify the **postgresql.conf** file.
- Set **ss\_interconnect\_type** to **RDMA** and add the **ss\_rdma\_work\_config** and **ss\_ock\_log\_path** configuration items. For details about the parameter description and configuration, see [Shared Storage Parameters](../DataBaseReference/en-us_topic_0000001371524841.md).
+ Set **ss\_interconnect\_type** to **RDMA** and add the **ss\_rdma\_work\_config** and **ss\_ock\_log\_path** configuration items. For details about the parameter description and configuration, see [Shared Storage Parameters](primary-standby-shared-storage.md).
Example:
diff --git a/content/en/docs/BriefTutorial/python.md b/content/en/docs/BriefTutorial/python.md
index fcdd1d82dbfc1b326e552706060de0ced52b3dd2..7c8f90129b3c964db9040dcebd23120a7c2e21be 100644
--- a/content/en/docs/BriefTutorial/python.md
+++ b/content/en/docs/BriefTutorial/python.md
@@ -29,7 +29,7 @@ openGauss supports the psycopg2 feature and allows psycopg2 to be connected in S
## Loading a Driver
- Before using the driver, perform the following operations:
- 1. Download the compiled psycopg2 package from the [openGauss website](https://opengauss.org/zh/download.html).
+ 1. Download the compiled psycopg2 package from the [openGauss website](https://opengauss.org/zh/download/).
> **NOTE:**
>The psycopg2 downloaded from the openGauss website matches Python 3.6. If you use Python of another version, you need to compile psycopg2. The compilation method is similar to that in the PostgreSQL database. You only need to modify the code for verifying the version number of **setup.py** during compilation by running the following command:
diff --git a/content/en/docs/BriefTutorial/transactions.md b/content/en/docs/BriefTutorial/transactions.md
index 37af3175f113ef377ceec0f4b2dd06a5e36af10c..bbe13994b4b9174ed6c1204dbcab229ba6e1a7b8 100644
--- a/content/en/docs/BriefTutorial/transactions.md
+++ b/content/en/docs/BriefTutorial/transactions.md
@@ -10,7 +10,7 @@ A transaction is a user-defined sequence of database operations, which form an i
Transaction isolation at this level meets the requirements of many applications, and is fast and easy to use. However, applications performing complicated queries and updates may require data that is more consistent than this level can provide.
-- **REPEATABLE READ**: A transaction can only read data committed before it starts. Uncommitted data or data committed in other concurrent transactions cannot be read. However, a query can read earlier data updates in its transaction, regardless of whether they have been committed. **READ UNCOMMITTED** differs from this level in that a transaction reads the snapshot taken at the start of the transaction, not at the beginning of the current query within the transaction. Therefore, the SELECT statement within a transaction always reads the same data, and cannot read data committed by other concurrent transactions after the transaction starts. Applications at this level must be able to retry transactions, because serialization failures may occur.
+- **REPEATABLE READ**: A transaction can only read data committed before it starts. Uncommitted data or data committed in other concurrent transactions cannot be read. However, a query can read earlier data updates in its transaction, regardless of whether they have been committed. **READ COMMITTED** differs from this level in that a transaction reads the snapshot taken at the start of the transaction, not at the beginning of the current query within the transaction. Therefore, the SELECT statement within a transaction always reads the same data, and cannot read data committed by other concurrent transactions after the transaction starts. Applications at this level must be able to retry transactions, because serialization failures may occur.
## Syntax
diff --git a/content/en/docs/BriefTutorial/understanding-opengauss.md b/content/en/docs/BriefTutorial/understanding-opengauss.md
deleted file mode 100644
index 3ae3c65b373bbeb0c83b95c61ec9c66edd6bb3c7..0000000000000000000000000000000000000000
--- a/content/en/docs/BriefTutorial/understanding-opengauss.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Understanding openGauss
-
-- **[What Is openGauss?](what-is-opengauss.md)**
-
-- **[Software Architecture](software-architecture.md)**
-
-
diff --git a/content/en/docs/Compilationguide/Compilation.md b/content/en/docs/CompilationGuide/Compilation.md
similarity index 100%
rename from content/en/docs/Compilationguide/Compilation.md
rename to content/en/docs/CompilationGuide/Compilation.md
diff --git a/content/en/docs/Compilationguide/compiling-the-version.md b/content/en/docs/CompilationGuide/compiling-the-version.md
similarity index 99%
rename from content/en/docs/Compilationguide/compiling-the-version.md
rename to content/en/docs/CompilationGuide/compiling-the-version.md
index f289f9a322aafecb45587a14f36b3b50ae6549e5..634b68378284d99ec5b8007aabfd8d034fc5e29e 100644
--- a/content/en/docs/Compilationguide/compiling-the-version.md
+++ b/content/en/docs/CompilationGuide/compiling-the-version.md
@@ -39,9 +39,9 @@ The git and git-lfs have been installed and configured on the local host.
>- **openGauss-third\_party**: open-source third-party software repository on which openGauss depends.
>- **binarylibs**: package for storing the built open-source third-party software. You can obtain the package by referring to [Compiling Open-source Software](#Compiling Open-source Software) . Since compiling and building open-source software take a long time, we have compiled and built **binarylibs** using **openGauss-third\_party** and compress and upload **binarylibs** to the Internet.
> The community provides binary files compiled on three platforms. The download links are as follows:\
- **openEuler_arm:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz
- **openEuler_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz
- **Centos_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz
+ **openEuler_arm:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz
+ **openEuler_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz
+ **Centos_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz
> After the download is complete, decompress and rename the package: **mv openGauss-third\_party\_binarylibs binarylibs**.
diff --git a/content/en/docs/Compilationguide/faqs.md b/content/en/docs/CompilationGuide/faqs.md
similarity index 100%
rename from content/en/docs/Compilationguide/faqs.md
rename to content/en/docs/CompilationGuide/faqs.md
diff --git "a/content/en/docs/Compilationguide/figures/\347\273\230\345\233\2761.png" "b/content/en/docs/CompilationGuide/figures/\347\273\230\345\233\2761.png"
similarity index 100%
rename from "content/en/docs/Compilationguide/figures/\347\273\230\345\233\2761.png"
rename to "content/en/docs/CompilationGuide/figures/\347\273\230\345\233\2761.png"
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-caution.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-caution.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-caution.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-caution.gif
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-danger.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-danger.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-danger.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-danger.gif
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-note.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-note.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-note.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-note.gif
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-notice.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-notice.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-notice.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-notice.gif
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-tip.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-tip.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-tip.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-tip.gif
diff --git a/content/en/docs/DataBaseReference/public_sys-resources/icon-warning.gif b/content/en/docs/CompilationGuide/public_sys-resources/icon-warning.gif
similarity index 100%
rename from content/en/docs/DataBaseReference/public_sys-resources/icon-warning.gif
rename to content/en/docs/CompilationGuide/public_sys-resources/icon-warning.gif
diff --git a/content/en/docs/Compilationguide/setting-up-the-compilation-environment.md b/content/en/docs/CompilationGuide/setting-up-the-compilation-environment.md
similarity index 100%
rename from content/en/docs/Compilationguide/setting-up-the-compilation-environment.md
rename to content/en/docs/CompilationGuide/setting-up-the-compilation-environment.md
diff --git a/content/en/docs/DataMigrationGuide/data-check.md b/content/en/docs/DataMigrationGuide/data-check.md
index 893c79eb3d7813faa9e443ee6655bff57af827a4..d3a9b4394aff7a6cd6cc8b6e6f5b022459252576 100644
--- a/content/en/docs/DataMigrationGuide/data-check.md
+++ b/content/en/docs/DataMigrationGuide/data-check.md
@@ -160,7 +160,7 @@ The debezium service listens to the incremental data of the source MySQL databas
Download the package from the following link, decompress the package, configure related configuration files, and run the shell script to start the service: For details about the configuration information and operation procedure, see the source code installation part.
```
-https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/openGauss-datachecker-performance-5.0.0.tar.gz
+https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/tools/openGauss-datachecker-performance-5.0.0.tar.gz
tar -zxvf openGauss-datachecker-performance-5.0.0.tar.gz
```
diff --git a/content/en/docs/DataMigrationGuide/figures/en-us_image_0000001368504658.png b/content/en/docs/DataMigrationGuide/figures/en-us_image_0000001368504658.png
new file mode 100644
index 0000000000000000000000000000000000000000..3748a88975a9b9e6c9a51df82a9491438ce721fe
Binary files /dev/null and b/content/en/docs/DataMigrationGuide/figures/en-us_image_0000001368504658.png differ
diff --git a/content/en/docs/DataMigrationGuide/full-migration.md b/content/en/docs/DataMigrationGuide/full-migration.md
index 944cdf7c7cffe85d4c164c3d464f93e3b06077a5..8b84b520cc01fa28c67b82276d67dc4f2ad69ea2 100644
--- a/content/en/docs/DataMigrationGuide/full-migration.md
+++ b/content/en/docs/DataMigrationGuide/full-migration.md
@@ -17,7 +17,7 @@ ARM+openEuler 20.03 or x86+CentOS 5.7
## Installing Chameleon
- **Installing using WHL**
- 1. Download the installation package. Download address: [https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/chameleon/chameleon-1.0.0-py3-none-any.whl](https://gitee.com/link?target=https%3A%2F%2Fopengauss.obs.cn-south-1.myhuaweicloud.com%2Flatest%2Fchameleon%2Fchameleon-1.0.0-py3-none-any.whl). After the installation package is downloaded, install it in the Python virtual environment.
+ 1. Download the installation package. Download address: [https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/chameleon/chameleon-1.0.0-py3-none-any.whl](https://gitee.com/link?target=https%3A%2F%2Fopengauss.obs.cn-south-1.myhuaweicloud.com%2Flatest%2Fchameleon%2Fchameleon-1.0.0-py3-none-any.whl). After the installation package is downloaded, install it in the Python virtual environment.
2. Run the following commands to create and activate the Python virtual environment:
```
diff --git a/content/en/docs/DataMigrationGuide/migrating-data-from-mysql-database-to-opengauss.md b/content/en/docs/DataMigrationGuide/migrating-data-from-mysql-database-to-opengauss.md
index ab6ceb1afeea91bcf4c056114831532bd84c4184..a566ff48ef0c12a0d955bb7c12e6cd8511d366ec 100644
--- a/content/en/docs/DataMigrationGuide/migrating-data-from-mysql-database-to-opengauss.md
+++ b/content/en/docs/DataMigrationGuide/migrating-data-from-mysql-database-to-opengauss.md
@@ -1,20 +1,14 @@
-# Migrating Data from MySQL database to openGauss
+# Migrating Data from MySQL Database to openGauss
## Tool Deployment Architecture
-
+
Currently, openGauss supports the following MySQL migration services:
-- Offline migration of full objects and data
-- Online migration of incremental data
-- Full and incremental data check
-- Reverse migration
+- **[Quick MySQL Migration](quick-mysql-migration.md)**
- **[Full migration](full-migration.md)**
-
- **[Incremental migration](incremental-migration.md)**
-
-- **[Data check](data-check.md)**
-
- **[Reverse migration](reverse-migration.md)**
+- **[Data check](data-check.md)**
diff --git a/content/en/docs/DataMigrationGuide/mysql-migration.md b/content/en/docs/DataMigrationGuide/mysql-migration.md
new file mode 100644
index 0000000000000000000000000000000000000000..7553dc5b84c149edc7d93ec1742819396a4b076a
--- /dev/null
+++ b/content/en/docs/DataMigrationGuide/mysql-migration.md
@@ -0,0 +1 @@
+# MySQL Migration
diff --git a/content/en/docs/DataMigrationGuide/quick-mysql-migration.md b/content/en/docs/DataMigrationGuide/quick-mysql-migration.md
new file mode 100644
index 0000000000000000000000000000000000000000..12d94199c3afb808b82fd648a0b5608dd1044bab
--- /dev/null
+++ b/content/en/docs/DataMigrationGuide/quick-mysql-migration.md
@@ -0,0 +1,504 @@
+# Quick MySQL Migration
+
+## Functions
+
+gs\_rep\_portal is a Java-based tool that runs on Linux and integrates full migration, incremental migration, reverse migration, and data check. gs\_rep\_portal allows you to install the preceding tools in one-click mode and set migration tasks. The tasks invoke the corresponding tools to complete each migration step based on the user-defined execution plan and display the status, progress, and exception cause of each step in real time.
+
+## Precautions
+
+- The curl tool is required for incremental migration, reverse migration, and incremental check on the portal.
+
+- Incremental migration and reverse migration of the same migration plan cannot be enabled at the same time. If a plan contains incremental migration and reverse migration, you need to manually stop incremental migration and start reverse migration. Incremental migration cannot be started after reverse migration is started.
+
+- After stopping incremental migration and before starting reverse migration, do not perform jobs on openGauss. Otherwise, data will be lost.
+
+- The value of **workspace.id** used by the portal can contain only lowercase letters and digits.
+
+- When starting multiple plans on the portal, ensure that the MySQL database instances are different and openGauss databases are different. In addition, incremental migration and reverse migration of the same MySQL database instance and openGauss database cannot be enabled at the same time.
+
+ ## Default File Structure
+
+The file structure of the portal installed by using the default configuration is as follows:
+
+ ```
+portal/
+ config/
+ migrationConfig.properties
+ toolspath.properties
+ status
+ currentPlan
+ input
+ chameleon/
+ config-example.yml
+ datacheck/
+ application-source.yml
+ application-sink.yml
+ application.yml
+ log4j2.xml
+ log4j2source.xml
+ log4j2sink.xml
+ debezium/
+ connect-avro-standalone.properties
+ mysql-sink.properties
+ mysql-source.properties
+ opengauss-sink.properties
+ opengauss-source.properties
+ logs/
+ portal.log
+ pkg/
+ chameleon/
+ chameleon-5.0.0-py3-none-any.whl
+ datacheck/
+ openGauss-datachecker-performance-5.0.0.tar.gz
+ debezium/
+ confluent-community-5.5.1-2.12.zip
+ debezium-connector-mysql-1.8.1.Final-plugin.tar.gz
+ debezium-connector-opengauss-1.8.1.Final-plugin.tar.gz
+ kafka_2.13-3.2.3.tgz
+ tmp/
+ tools/
+ chameleon/
+ datacheck/
+ debezium/
+ confluent-5.5.1/
+ kafka_2.13-3.2.3/
+ plugin/
+ debezium-connector-mysql/
+ debezium-connector-opengauss/
+ portal.portId.lock
+ portalControl-1.0-SNAPSHOT-exec.jar
+ gs_datacheck.sh
+ gs_mysync.sh
+ gs_rep_portal.sh
+ gs_replicate.sh
+ README.md
+ ```
+
+## Installation Guide
+
+The default portal installation directory is **/ops/portal**. You can change it as required.
+
+### Installation using source code:
+
+1. Run the git command to download the source code and copy the **portal** folder in the source code to the **/ops** directory.
+
+```
+git clone https://gitee.com/opengauss/openGauss-migration-portal.git
+```
+
+2. Run the maven command to compile the source code to obtain the **portalControl-1.0-SNAPSHOT-exec.jar** package and save the JAR package to the **/ops/portal** directory.
+
+```
+mvn clean package -Dmaven.test.skip=true
+```
+
+Java version: open JDK 11 or later
+
+Maven version: 3.8.1 or later
+
+3. When using the one-click script to start the portal, extract the .sh file from the **/ops/portal/shell** directory and place it in the **/ops/portal/** directory, that is, the directory where the JAR package is stored.
+
+### Installation using a package:
+
+Download link:
+
+https://opengauss.obs.cn-south-1.myhuaweicloud.com/tools/portal/PortalControl-5.0.0.tar.gz
+
+1. Download the gs\_rep\_portal installation package.
+
+ ```
+wget -c https://opengauss.obs.cn-south-1.myhuaweicloud.com/tools/portal/PortalControl-5.0.0.tar.gz
+ ```
+
+2. Decompress the gs\_rep\_portal package.
+
+ ```
+tar -zxvf PortalControl-5.0.0.tar.gz
+ ```
+
+## Startup Mode
+
+Use the one-click script **gs\_rep\_portal** to start the portal and use the portal functions through parameters.
+
+ ```
+sh gs\_rep\_portal.sh *Parameter* workspace.id &
+ ```
+
+A parameter consists of several words connected by underscores (_), for example, **start\_mysql\_full\_migration**. The parameters can be installation, startup, stop, and uninstallation commands, which will be described in the following sections.
+
+The portal creates a folder with ID corresponding to the **workspace** folder and saves the parameters and logs generated during task execution to the folder. If **workspace.id** is not specified, the default value is **1**.
+
+Run the following command to view the help information (including the usage mode and available commands).
+
+ ```
+sh gs_rep_portal.sh help &
+ ```
+
+Parameter priority: parameters set in **workspace** > public space parameters. If the workspace ID used is the same as the existing workspace ID, the parameters in the original workspace are used. If they are different, the portal copies a configuration file from the **config** folder to the workspace corresponding to the ID as the configuration file of the task.
+
+You are advised to use a different workspace ID each time you run a migration task.
+
+### Installing Migration Tools
+
+The following table lists the migration functions and corresponding migration tools.
+
+| Migration Function | Tool |
+| ---------------------------------- | ---------------------------------------------- |
+| Full migration | chameleon |
+| Incremental migration | kafka, confluent, and debezium-connector-mysql |
+| Reverse migration | kafka, confluent, and debezium-connector-opengauss|
+| Data check (including full check and incremental check)| kafka, confluent, and datacheck |
+
+Recommended tool versions:
+
+| Tool | Version |
+| ---------------------------- | ---------- |
+| chameleon | 5.0.0 |
+| kafka | 2.13-3.2.3 |
+| confluent | 5.5.1 |
+| datacheck | 5.0.0 |
+| debezium-connector-mysql | 1.8.1 |
+| debezium-connector-opengauss | 1.8.1 |
+
+Change the tool installation path in the **toolspath.properties** file in the **/ops/portal/config** directory. The folder name must end with a slash (/).
+
+| Parameter | Description |
+| ---------------------------- | ------------------------------------------------------------ |
+| chameleon.venv.path | Path of the chameleon virtual environment |
+| chameleon.pkg.path | Path of the chameleon installation package |
+| chameleon.pkg.name | Name of the chameleon installation package |
+| chameleon.pkg.url | Link for downloading the chameleon installation package |
+| debezium.path | Path of debezium and kafka (By default, kafka, confluent, and connector are installed in this path.)|
+| kafka.path | Path of kafka |
+| confluent.path | Path of confluent |
+| connector.path | Path of connector |
+| debezium.pkg.path | Path of the debezium and kafka installation packages (By default, the kafka, confluent, and connector installation packages are stored in this path.)|
+| kafka.pkg.name | Name of the kafka installation package |
+| kafka.pkg.url | Link for downloading the kafka installation package |
+| confluent.pkg.name | Name of the confluent installation package |
+| confluent.pkg.url | Link for downloading the confluent installation package |
+| connector.mysql.pkg.name | Name of the MySQL connector installation package |
+| connector.mysql.pkg.url | Link for downloading the MySQL connector installation package |
+| connector.opengauss.pkg.name | Name of the openGauss connector installation package |
+| connector.opengauss.pkg.url | Link for downloading the openGauss connector installation package |
+| datacheck.install.path | Path for installing datacheck |
+| datacheck.path | Path of datacheck |
+| datacheck.pkg.path | Path of the datacheck installation package |
+| datacheck.pkg.name | Name of the datacheck installation package |
+| datacheck.pkg.url | Link for downloading the datacheck installation package |
+
+Tools can be installed online or offline.
+
+- Online installation: Download the installation package from the specified link to the specified location, obtain the package from the specified location, decompress the package, and install it.
+- Offline installation: Obtain the installation package from the specified location, decompress the package, and install it.
+
+If you do not specify the installation mode when running the command, the portal determines the installation mode based on the parameters in the **migrationConfig.properties** file in the **/ops/portal/config** directory.
+
+| Parameter | Description |
+| ----------------------------------------------------- | ----------------------------------------------------- |
+| default.install.mysql.full.migration.tools.way | Default installation mode of the full migration tool: **offline** or **online**|
+| default.install.mysql.incremental.migration.tools.way | Default installation mode of the incremental migration tool: **offline** or **online**|
+| default.install.mysql.datacheck.tools.way | Default installation mode of the datacheck tool: **offline** or **online**|
+| default.install.mysql.reverse.migration.tools.way | Default installation mode of the reverse migration tool: **offline** or **online**|
+
+Run the following command to install the corresponding migration tools:
+
+ ```
+sh gs_rep_portal.sh install_mysql_all_migration_tools 1 &
+ ```
+
+You can run this command on the CLI to install all migration tools.
+
+### Installation Commands
+
+| Command | Description |
+| ------------------------------------------------- | ------------------------------------------------- |
+| install_mysql_full_migration_tools_online | Installs the MySQL full migration tool online. |
+| install_mysql_full_migration_tools_offline | Installs the MySQL full migration tool offline. |
+| install_mysql_full_migration_tools | Installs the MySQL full migration tool. (The installation mode is specified in the configuration file.) |
+| install_mysql_incremental_migration_tools_online | Installs the MySQL incremental migration tool online. |
+| install_mysql_incremental_migration_tools_offline | Installs the MySQL incremental migration tool offline. |
+| install_mysql_incremental_migration_tools | Installs the MySQL incremental migration tool. (The installation mode is specified in the configuration file.) |
+| install_mysql_reverse_migration_tools_online | Installs the MySQL reverse migration tool online. |
+| install_mysql_reverse_migration_tools_offline | Installs the MySQL reverse migration tool offline. |
+| install_mysql_reverse_migration_tools | Installs the MySQL reverse migration tool. (The installation mode is specified in the configuration file.) |
+| install_mysql_datacheck_tools_online | Installs the MySQL datacheck tool online. |
+| install_mysql_datacheck_tools_offline | Installs the MySQL datacheck tool offline. |
+| install_mysql_datacheck_tools | Installs the MySQL datacheck tool. (The installation mode is specified in the configuration file.) |
+| install_mysql_all_migration_tools | Installs the MySQL migration tools. (The installation mode of each tool is specified in the configuration file.)|
+
+### Configuration Parameters
+
+You can modify migration parameters in the **migrationConfig.properties** file in the **/ops/portal/config** directory.
+
+Parameter priority: parameters set in **workspace** > public space parameters. If the workspace ID used is the same as the existing workspace ID, the parameters in the original workspace are used. If they are different, the portal copies a configuration file from the **config** folder to the workspace corresponding to the ID as the configuration file of the task.
+
+| Parameter | Description |
+| ------------------------- | ----------------------- |
+| mysql.user.name | MySQL database user name |
+| mysql.user.password | MySQL database user password |
+| mysql.database.host | IP address of the MySQL database |
+| mysql.database.port | MySQL database port |
+| mysql.database.name | MySQL database name |
+| opengauss.user.name | openGauss database user name |
+| opengauss.user.password | openGauss database user password|
+| opengauss.database.host | IP address of the openGauss database |
+| opengauss.database.port | openGauss database port |
+| opengauss.database.name | openGauss database name |
+| opengauss.database.schema | openGauss database schema name |
+
+In addition to the basic parameters used for migration, you can also configure the parameters used by the tool in the specified location. However, the portal modifies the temporary files and log locations of the tool by default and allocates some ports used by the tool. You can view and modify the configuration file of the tool. The following table lists the default configuration file of the tool.
+
+Precautions:
+
+- The default ZooKeeper port 2181, Kafka port 9092, and schema-registry port 8081 are not automatically allocated. Other tools automatically allocate ports. If you need to change the port number of the tool, do not change the IP address. If you need to change the Kafka port, change the value of **listeners** in the Kafka file to **PLAINTEXT://localhost:***Port to be configured*.
+- In the following table, **${config}** indicates the **/ops/portal/config** directory, that is, the parameter configured for the public space. If you want to modify the parameter of a workspace, for example, the parameters of the plan whose **workspace.id** is **2**, replace **/ops/portal/config** with **/ops/portal/workspace/2/config**.
+- In the following table, **${kafka.path}** indicates the value of **kafka.path** in the **toolspath.properties** file in the **/ops/portal/config** directory.
+- In the following table, **${confluent.path}** indicates the value of **confluent.path** in the **toolspath.properties** file in the **/ops/portal/config** directory.
+- Each time a task is created, the **connect-avro-standalone.properties** file in the **/ops/portal/config/debezium** directory is automatically copied into four copies and the port number is changed.
+
+||||||||||||||||||||||||||
| Tool | +Location of the Configuration File | +
| chameleon | +${config}/chameleon/config-example.yml | +
| zookeeper | +${kafka.path}/config/zookeeper.properties | +
| kafka | +${kafka.path}/config/server.properties | +
| schema-registry | +${confluent.path}/etc/schema-registry/schema-registry.properties | +
| connector-mysql | +${config}/debezium/connect-avro-standalone.properties | +
| ${config}/debezium/mysql-source.properties | +|
| ${config}/debezium/mysql-sink.properties | +|
| connector-opengauss | +${config}/debezium/connect-avro-standalone.properties | +
| ${config}/debezium/opengauss-source.properties | +|
| ${config}/debezium/opengauss-sink.properties | +|
| datacheck | +${config}/datacheck/application-source.yml | +
| ${config}/datacheck/application-sink.yml | +|
| ${config}/datacheck/application.yml | +
The following authentication modes are supported. For details, see Table 2.
-The MD5 encryption algorithm has lower security and poses security risks. Therefore, you are advised to use a more secure encryption algorithm.
+In trust mode, only the connection initiated from the local server using gsql with the -U parameter not specified is trusted. In this case, no password is required.
The trust authentication mode applies to local connection of a single-user workstation, but not of a multi-user workstation. To use this authentication mode, you can use the file system permissions to control the access to the Unix-domain socket file on the server. You can use either of the following methods to control the access:
-
+
+Networking features:
+If a single AZ is deployed, one synchronous standby node and one asynchronous standby node can be configured.
+
+Advantages:
+1. Three nodes are equivalent. If any node is faulty, the other nodes can still provide services.
+2. The cost is low.
+
+Disadvantages:
+The high availability (HA) is low. If an AZ-level fault occurs, you can only restore the entire node.
+
+Applicability:
+Applicable to service systems that have low requirements on HA.
+
+## Intra-City Dual-Center Deployment
+
+**Figure 2** Intra-city dual-center deployment
+
+
+ 
+
+Networking features:
+Two intra-city AZs are more reliable than a single AZ. A synchronous standby node can be configured for the primary center and the intra-city center respectively.
+
+Advantages:
+1. Intra-city synchronous replication. If one data center is faulty, the other data center can still provide services without data loss. RPO = 0.
+2. The cost is reasonable.
+
+Disadvantages:
+1. The intra-city distance should not be too long. It is recommended that the distance be within 70 km. The total latency caused by excessive read/write times should be considered during service design.
+2. Remote DR is not supported.
+
+Applicability:
+Applicable to common service systems.
+
+## Two-City Three-DC Deployment
+
+**Figure 3** Two-city three-dc deployment
+
+
+ 
+
+Networking features:
+In the two-city three-DC deployment, each AZ must have at least one synchronous standby node. The cluster reliability can reach the highest level when the number of cities and data centers increases.
+
+Advantages:
+It supports zero data loss in remote DR, and has the highest reliability. RPO = 0.
+
+Disadvantages:
+1. If the remote DR distance is long and synchronous standby node is configured in the remote center, the performance may be affected.
+2. The cost is relatively high.
+
+Applicability:
+Applicable to core and important service systems.
+
+## Two-City Three-DC Streaming DR Solution
+
+**Figure 4** Two-city three-DC streaming DR solution
+
+
+ 
+
+Networking features:
+Two independent clusters are deployed in the dual-cluster DR solution. The primary and DR cluster networking modes can be selected as required. The DR cluster selects the first standby DN to connect to the primary DN of the primary cluster. In the DR cluster, the first standby DN is connected in cascading standby mode.
+
+Advantages:
+1. The primary cluster has the advantage of single-cluster networking. You need to manually switch to the standby cluster only when the primary cluster is unavailable.
+2. There is only one cross-cluster (remote) replication link regardless of whether a DR switchover occurs. Therefore, less network bandwidth is occupied.
+3. The networking is more flexible. The primary cluster and DR cluster can use different networking modes.
+
+Disadvantages:
+1. DR clusters need to be added, increasing costs.
+2. Remote DR RPO > 0
+
+Applicability:
+Applicable to core and important service systems.
+
+For more information, see [Two-City Three-DC DR](two-city-three-dc-dr.md).
+
+> **NOTE:**
+>
+>The preceding deployments are typical solutions. You can adjust the deployment solutions based on actual service scenarios, for example, adding or deleting standby nodes, adjusting the number of centers, properly deploying synchronous and asynchronous standby nodes, and properly using cascaded standby nodes.
diff --git a/content/en/docs/DatabaseAdministrationGuide/overview_configuring-database-audit.md b/content/en/docs/DatabaseAdministrationGuide/overview_configuring-database-audit.md
index 7ad0d6b7496e065802c089dd4cf6390a183a719f..df1c9ce60dae8c645e0a7348096a3d8f6739e556 100644
--- a/content/en/docs/DatabaseAdministrationGuide/overview_configuring-database-audit.md
+++ b/content/en/docs/DatabaseAdministrationGuide/overview_configuring-database-audit.md
@@ -23,73 +23,73 @@ You need to know the following about the audit function:
Parameter: audit_login_logout
+Parameter: audit_login_logout
Its default value is 7, which indicates that the function of user login and logout audit is enabled. 0 indicates that the function of user login and logout audit is disabled. Other values are not recommended.
Parameter: audit_database_process
+Parameter: audit_database_process
Its default value is 1, which indicates that the audit of database startup, stop, recovery, and switchover is enabled.
Parameter: audit_user_locked
+Parameter: audit_user_locked
Its default value is 1, which indicates that the audit of user locking and unlocking is enabled.
Parameter: audit_user_violation
+Parameter: audit_user_violation
Its default value is 0, which indicates that the audit of unauthorized access disabled.
Parameter: audit_grant_revoke
+Parameter: audit_grant_revoke
Its default value is 1, which indicates that the audit of permission granting and revoking is enabled.
Audit of CREATE, ALTER, and DROP operations on a database object
Parameter: audit_system_object
+Parameter: audit_system_object
Its default value is 12295, which indicates that the CREATE, ALTER, and DROP operations only on databases, schemas, users, and data sources are audited.
Audit of INSERT, UPDATE, and DELETE operations on a specific table
Parameter: audit_dml_state
+Parameter: audit_dml_state
Its default value is 0, which indicates that the audit of DML operations (except SELECT) on a specific table is disabled.
Parameter: audit_dml_state_select
+Parameter: audit_dml_state_select
Its default value is 0, which indicates that the audit of SELECT operations is disabled.
Parameter: audit_copy_exec
+Parameter: audit_copy_exec
Its default value is 1, which indicates that the audit of COPY operations is enabled.
Parameter: audit_function_exec
+Parameter: audit_function_exec
Its default value is 0, which indicates that no execution audit logs of stored procedures and customized functions are recorded.
Parameter: audit_set_parameter
+Parameter: audit_set_parameter
Its default value is 1, which indicates that the audit of SET operations is enabled.
Parameter: audit_xid_info
+Parameter: audit_xid_info
Its default value is 0, which indicates that the function of recording transaction IDs in audit logs is disabled.
Specifies whether to check the reuse days of a new password.
Specifies whether to check the reuse times of a new password.
If the number of consecutive login attempts with incorrect passwords reaches this value, the account is locked.
Number of days prior to account password expiration that a user is notified
Audit log file format. Currently, only the binary format is supported.
Time interval of creating an audit log file. If the difference between the current time and the time when the previous audit log file is created is greater than the value of audit_rotation_interval, a new audit log file will be generated.
Maximum capacity of an audit log file. If the total number of messages in an audit log exceeds the value of audit_rotation_size, the server will generate a new audit log file.
Policy for determining whether audit logs are preferentially stored by space or time. on indicates that audit logs are preferentially stored by space.
Minimum duration required for recording audit logs. This parameter is valid only when audit_resource_policy is set to off.
+Minimum duration required for recording audit logs. This parameter is valid only when audit_resource_policy is set to off.
Specifies whether to audit user logins (including login successes and failures) and logouts.
Specifies whether to audit database startup, stop, switchover, and restoration operations.
Specifies whether to audit database user locking and unlocking.
Specifies whether to audit beyond-authority operations of a database user.
Specifies whether to audit user permission granting and reclaiming operations.
Specifies whether to audit the CREATE, DROP, and ALTER operations on database objects.
Specifies whether to audit the INSERT, UPDATE, and DELETE operations on a specific table.
Specifies whether to record audit information during execution of stored procedures, anonymous blocks, or customized functions (excluding system functions).
If the duration of a connection session exceeds the parameter value, the session is automatically disconnected.
Number of iterations during the generation of encrypted information for authentication
Figure 1: openGauss resource pooling architecture
+
Figure 1: openGauss resource pooling deployment
+
Has permissions to query only some system catalogs and views. For details, see System Catalogs and System Views.
+Has permissions to query only some system catalogs and views. For details, see System Catalogs and System Views.
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
The duration is the same as the operation duration. Generally, the duration does not exceed 30 minutes.
ANY permission of a user. For details about the value, see Table 1.
+ANY permission of a user. For details about the value, see Table 1.
| + | ++ | ++ | ++ | +
|---|---|---|---|
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | +pg_authid.oid + |
++ | +
| + | ++ | +pg_proc.oid + |
++ | +
| + | ++ | ++ | +Controls in which the session replication role modes the event trigger fires. O: Trigger fires in "origin" and "local" modes. D: Trigger is disabled. R: Trigger fires in "replica" mode. A: Trigger fires always. + |
+
| + | ++ | ++ | +Command tags for which this trigger will fire. If NULL, the firing of this trigger is not restricted by the command tag. + |
+
A string in JSON format recording the driver type, driver version, driver deployment path, and process owner of the connected database. For details, see connection_info.
+A string in JSON format recording the driver type, driver version, driver deployment path, and process owner of the connected database. For details, see connection_info.
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | +LSN of the publisher when the last keepalive message is received. + |
+
| + | ++ | ++ | +
By default, connection logs only record the IP addresses of connected hosts. With this function, the host names will also be recorded.
-This parameter affects parameters in Querying Audit Results, GS_SESSION_MEMORY_DETAIL, PG_STAT_ACTIVITY, and log_line_prefix.
+This parameter affects parameters in Querying Audit Results, GS_SESSION_MEMORY_DETAIL, PG_STAT_ACTIVITY, and log_line_prefix.
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | +Driver installation path, which is the same as the dynamic library path in Driver64. + |
+ + | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | +
+ NOTE:
+ After a user established a connection, the ODBC driver automatically clears their password stored in memory. +However, if this parameter is configured, UnixODBC will cache data source files, which may cause the password to be stored in the memory for a long time. +When you connect to an application, you are advised to send your password through an API instead of writing it in a data source configuration file. After the connection has been established, immediately clear the memory segment where your password is stored. + |
+
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | +If this parameter is set to 1, the mylog file of the PostgreSQL ODBC driver will be printed. The directory generated for storing logs is /tmp/. If this parameter is set to 0, no directory is generated. + |
+ + | +
| + | +Whether to enable the extended query protocol for the database. +The value can be 0 or 1. The default value is 1, indicating that the extended query protocol is enabled. + |
+ + | +
| + | +Whether to enable the batch query protocol. If it is enabled, DML performance can be improved. The value can be 0 or 1. The default value is 1. +If this parameter is set to 0, the batch query protocol is disabled (mainly for communication with earlier database versions). +If this parameter is set to 1 and support_batch_bind is set to on, the batch query protocol is enabled. + |
+ + | +
| + | ++ | ++ | +
| + | +Each time SQLFreeHandle is invoked to release statements, ODBC sends a Deallocate plan_name statement to the server. A large number of such statements exist in the service. To reduce the number of the statements to be sent, stmt->plan_name is left empty so that the database can identify them as unnamed statements. This parameter is added to control the threshold for unnamed statements. + |
+ + | +
| + | +Whether to display the driver deployment path and process owner in the connection_info parameter mentioned in connection_info. + |
+
+ NOTE:
+ The default value is 0. If this parameter is set to 1, the ODBC driver reports the driver deployment path and process owner to the database and displays the information in the connection_info parameter (see connection_info). In this case, you can query the information from PG_STAT_ACTIVITY. + |
+
| + | +If this parameter is set to Yes, the Boolean value is mapped to the SQL_CHAR type. If this parameter is not set, the value is mapped to the SQL_BIT type. + |
+ + | +
| + | +When an attempt is made to update a row of data, setting this parameter to Yes allows the application to detect whether the data has been modified by other users. + |
+ + | +
| + | +By default, the driver regards the system table as a common SQL table. + |
+ + | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | +Variable list, which matches the %s placeholder in the query. + |
+
| + | ++ | +
|---|---|
| + | ++ | +
| + | +Variable list, which matches the %s placeholder in the query. + |
+
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | +SQLAllocHandle is a generic function for allocating a handle. It can replace the following functions: +
|
+
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | +SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions: +
|
+
**警告：**
+>
+> ODBC is the central layer of the application program and the database. It is responsible for transmitting the SQL instructions issued by the application program to the database, and does not parse the SQL syntax by itself. Therefore, when an SQL statement with confidential information (such as a plaintext password) is written in an application, the confidential information will be exposed in the driver log.
+
diff --git a/content/en/docs/Developerguide/development-process-jdbc.md b/content/en/docs/DeveloperGuide/development-process-jdbc.md
similarity index 100%
rename from content/en/docs/Developerguide/development-process-jdbc.md
rename to content/en/docs/DeveloperGuide/development-process-jdbc.md
diff --git a/content/en/docs/Developerguide/development-process-libpq.md b/content/en/docs/DeveloperGuide/development-process-libpq.md
similarity index 100%
rename from content/en/docs/Developerguide/development-process-libpq.md
rename to content/en/docs/DeveloperGuide/development-process-libpq.md
diff --git a/content/en/docs/Developerguide/development-process-psycopg.md b/content/en/docs/DeveloperGuide/development-process-psycopg.md
similarity index 100%
rename from content/en/docs/Developerguide/development-process-psycopg.md
rename to content/en/docs/DeveloperGuide/development-process-psycopg.md
diff --git a/content/en/docs/Developerguide/development-process.md b/content/en/docs/DeveloperGuide/development-process.md
similarity index 100%
rename from content/en/docs/Developerguide/development-process.md
rename to content/en/docs/DeveloperGuide/development-process.md
diff --git a/content/en/docs/Developerguide/development-specifications.md b/content/en/docs/DeveloperGuide/development-specifications.md
similarity index 100%
rename from content/en/docs/Developerguide/development-specifications.md
rename to content/en/docs/DeveloperGuide/development-specifications.md
diff --git a/content/en/docs/DeveloperGuide/example-common-functions-and-batch-binding.md b/content/en/docs/DeveloperGuide/example-common-functions-and-batch-binding.md
new file mode 100644
index 0000000000000000000000000000000000000000..c7ef34d262600db1be80ced5621cf71c6706614d
--- /dev/null
+++ b/content/en/docs/DeveloperGuide/example-common-functions-and-batch-binding.md
@@ -0,0 +1,434 @@
+# Example: Common Functions and Batch Binding
+
+## Code for Common Functions
+
+```
+//The following example shows how to obtain data from openGauss through the ODBC interface.
+// DBtest.c (compile with: libodbc.so)
+#include | + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
addConnectionEventListener (ConnectionEventListener listener) + |
++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
removeConnectionEventListener (ConnectionEventListener listener) + |
++ | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | +SQL statement to be executed. One SQL statement can be executed at a time. + |
+
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
Query the information about the current external connection (or internal thread).
Display the user permission information in openGauss.
Display information about storage functions.
Terminate a specified connection or an SQL statement executed under the connection.
Use ALTER SYSTEM SET to modify database parameters.
+Use ALTER SYSTEM SET to modify database parameters.
openGauss=# ALTER SYSTEM SET paraname TO value;
openGauss=# ALTER SYSTEM SET paraname TO value;diff --git a/content/en/docs/ExtensionReference/dolphin-revoke.md b/content/en/docs/ExtensionReference/dolphin-revoke.md index 49c2f30645d88fd83542a784ef36a28754556610..9b7ef36a800aadd5c24e6b27ceb81aa31caa2d0d 100644 --- a/content/en/docs/ExtensionReference/dolphin-revoke.md +++ b/content/en/docs/ExtensionReference/dolphin-revoke.md @@ -112,4 +112,4 @@ REVOKE INDEX FROM TEST_USER; ## Helpful Links -[REVOKE](REVOKE.md) +[REVOKE](../SQLReference/REVOKE.md) diff --git a/content/en/docs/ExtensionReference/dolphin-select-hint.md b/content/en/docs/ExtensionReference/dolphin-select-hint.md new file mode 100644 index 0000000000000000000000000000000000000000..f535bf73b7c25955616a169bd7033d7b6fbfbc07 --- /dev/null +++ b/content/en/docs/ExtensionReference/dolphin-select-hint.md @@ -0,0 +1,43 @@ +# SELECT HINT + +## Function + +SELECT HINT sets GUC parameters related to query optimization that take effect during the query execution. This section describes the enhanced SELECT HINT syntax of Dolphin. For details about the hints supported by the kernel, see [Plan Hint Optimization](../PerformanceTuningGuide/plan-hint-optimization). + +## Syntax + +``` +set_var(param = value) +``` + +## Parameters + + +- **param** + + Parameter name. + + Currently, the following parameters can be set and take effect by using hints: + - Boolean + + enable\_bitmapscan, enable\_hashagg, enable\_hashjoin, enable\_indexscan, enable\_indexonlyscan, enable\_material, enable\_mergejoin, enable\_nestloop, enable\_index\_nestloop, enable\_seqscan, enable\_sort, enable\_tidscan, partition\_iterator\_elimination, partition\_page\_estimation, enable\_functional\_dependency, var\_eq\_const\_selectivity, + + - Integer + + query\_dop + + - Floating point + + cost\_weight\_index, default\_limit\_rows, seq\_page\_cost, random\_page\_cost, cpu\_tuple\_cost, cpu\_index\_tuple\_cost, cpu\_operator\_cost, effective\_cache\_size + + - Enumeration + + try_vector_engine_strategy + + - Character string + + dolphin.optimizer\_switch + +- **value** + + Value of a parameter. diff --git a/content/en/docs/ExtensionReference/dolphin-show-status.md b/content/en/docs/ExtensionReference/dolphin-show-status.md new file mode 100644 index 0000000000000000000000000000000000000000..242db03a4717441c9510b634e086393448d2d1cd --- /dev/null +++ b/content/en/docs/ExtensionReference/dolphin-show-status.md @@ -0,0 +1,494 @@ +# SHOW STATUS + +## Function + +SHOW STATUS displays the data of all values in the current statistics status of the system. This statement does not require any permissions. It only requires the ability to connect to the server. + + +## Precautions + +N/A + +## Syntax + +```sql +SHOW [GLOBAL | SESSION] STATUS + [LIKE 'pattern' | WHERE expr] +``` + + +## Examples + +```sql +openGauss=# show status; + Variable_name | Value +--------------------------------------+------------------------------- + apply_counter | 0 + apply_total_dur | 0 + avgiotim | 11 + bg_commit_counter | 14 + bg_resp_avg | 2380520 + bg_resp_max | 7032370 + bg_resp_min | 160 + bg_resp_total | 33327281 + bg_rollback_counter | 0 + blk_read_time | 0 + blks_hit | 475019 + blks_read | 1296 + blk_write_time | 0 + buffers_alloc | 0 + buffers_backend | 0 + buffers_backend_fsync | 0 + buffers_checkpoint | 0 + buffers_clean | 0 + checkpoints_req | 4 + checkpoints_timed | 27 + checkpoint_sync_time | 6376 + checkpoint_write_time | 5 + ckpt_clog_flush_num | 0 + ckpt_csnlog_flush_num | 0 + ckpt_multixact_flush_num | 0 + ckpt_predicate_flush_num | 0 + ckpt_redo_point | 0/28DDB58 + ckpt_twophase_flush_num | 0 + commit_counter | 5 + confl_bufferpin | 0 + confl_deadlock | 0 + conflicts | 0 + confl_lock | 0 + confl_snapshot | 0 + confl_tablespace | 0 + curr_dwn | 0 + current_xlog_insert_lsn | 0/28DDF28 + curr_start_page | 1661 + curr_time | 1 + datid | 16384 + datname | tt + dcl_count | 0 + ddl_count | 0 + deadlocks | 0 + delete_count | 0 + dml_count | 8 + file_id | 0 + file_reset_num | 0 + file_trunc_num | 0 + global_instance_time_count | 10 + high_threshold_pages | 0 + high_threshold_writes | 0 + insert_count | 0 + last_replayed_read_ptr | 0 + local_max_ptr | 0 + locks_count | 43 + login_counter | 3 + logout_counter | 2 + low_threshold_pages | 17 + low_threshold_writes | 2 + lstiotim | 10 + maxiowtm | 32 + maxwritten_clean | 0 + miniotim | 3 + min_recovery_point | 0 + node_name | single_node1 + numbackends | 1 + os_runtime_count | 19 + os_threads_count | 23 + p80 | 0 + p95 | 0 + pgwr_actual_flush_total_num | 7 + pgwr_last_flush_num | 7 + phyblkrd | 501 + phyblkwrt | 7 + phyblkwrt | 6 + phyrds | 501 + phywrts | 6 + phywrts | 7 + primary_flush_ptr | 42852136 + process_pending_counter | 0 + process_pending_total_dur | 0 + queue_head_page_rec_lsn | 0/28DDB58 + queue_rec_lsn | 0/28DDB58 + read_data_io_counter | 0 + read_data_io_total_dur | 0 + read_ptr | 42851160 + read_xlog_io_counter | 2 + read_xlog_io_total_dur | 471 + recovery_done_ptr | 0 + redo_done_time | 0 + redo_start_ptr | 42851160 + redo_start_time | 732333220674305 + remain_dirty_page_num | 3 + resp_avg | 8090 + resp_max | 35491 + resp_min | 140 + resp_total | 40449 + rollback_counter | 0 + select_count | 5 + single_node1-backend_used_memory | 1 + single_node1-cstore_used_memory | 0 + single_node1-dynamic_peak_memory | 562 + single_node1-dynamic_peak_shrctx | 180 + single_node1-dynamic_used_memory | 561 + single_node1-dynamic_used_shrctx | 180 + single_node1-gpu_dynamic_peak_memory | 0 + single_node1-gpu_dynamic_used_memory | 0 + single_node1-gpu_max_dynamic_memory | 0 + single_node1-max_backend_memory | 348 + single_node1-max_cstore_memory | 512 + single_node1-max_dynamic_memory | 8142 + single_node1-max_process_memory | 12288 + single_node1-max_sctpcomm_memory | 0 + single_node1-max_shared_memory | 3285 + single_node1-other_used_memory | 0 + single_node1-pooler_conn_memory | 0 + single_node1-pooler_freeconn_memory | 0 + single_node1-process_used_memory | 800 + single_node1-sctpcomm_peak_memory | 0 + single_node1-sctpcomm_used_memory | 0 + single_node1-shared_used_memory | 215 + single_node1-storage_compress_memory | 0 + single_node1-udf_reserved_memory | 0 + speed | 0 + stats_reset | 2023-03-16 17:34:43.424584+08 + stats_reset | 2023-03-16 17:34:25.277803+08 + summary_file_iostat_count | 62 + temp_bytes | 0 + temp_files | 0 + total_pages | 17 + total_writes | 2 + tup_deleted | 61 + tup_fetched | 64396 + tup_inserted | 9906 + tup_returned | 55952 + tup_updated | 305 + update_count | 0 + user_id | 10 + user_name | hlv + wait_events_count | 401 + worker_info | no redo worker + workload | default_pool + write_data_io_counter | 0 + write_data_io_total_dur | 0 + writetim | 75 + xact_commit | 1235 + xact_rollback | 28 +(148 rows) + +openGauss=# show global status; + Variable_name | Value +--------------------------------------+------------------------------- + apply_counter | 0 + apply_total_dur | 0 + avgiotim | 10 + bg_commit_counter | 168 + bg_resp_avg | 53200083 + bg_resp_max | 122185319 + bg_resp_min | 79 + bg_resp_total | 8937613869 + bg_rollback_counter | 2 + blk_read_time | 0 + blks_hit | 504050 + blks_read | 1444 + blk_write_time | 0 + buffers_alloc | 0 + buffers_backend | 0 + buffers_backend_fsync | 0 + buffers_checkpoint | 0 + buffers_clean | 0 + checkpoints_req | 4 + checkpoints_timed | 29 + checkpoint_sync_time | 6794 + checkpoint_write_time | 5 + ckpt_clog_flush_num | 1 + ckpt_csnlog_flush_num | 0 + ckpt_multixact_flush_num | 1 + ckpt_predicate_flush_num | 0 + ckpt_redo_point | 0/28DE060 + ckpt_twophase_flush_num | 0 + commit_counter | 10 + confl_bufferpin | 0 + confl_deadlock | 0 + conflicts | 0 + confl_lock | 0 + confl_snapshot | 0 + confl_tablespace | 0 + curr_dwn | 0 + current_xlog_insert_lsn | 0/28DE180 + curr_start_page | 1684 + curr_time | 1 + datid | 16384 + datname | tt + dcl_count | 0 + ddl_count | 0 + deadlocks | 0 + delete_count | 0 + dml_count | 21 + file_id | 0 + file_reset_num | 0 + file_trunc_num | 2 + global_instance_time_count | 10 + high_threshold_pages | 0 + high_threshold_writes | 0 + insert_count | 0 + last_replayed_read_ptr | 0 + local_max_ptr | 0 + locks_count | 44 + login_counter | 9 + logout_counter | 8 + low_threshold_pages | 27 + low_threshold_writes | 4 + lstiotim | 8 + maxiowtm | 32 + maxwritten_clean | 0 + miniotim | 3 + min_recovery_point | 0 + node_name | single_node1 + numbackends | 1 + os_runtime_count | 19 + os_threads_count | 23 + p80 | 0 + p95 | 0 + pgwr_actual_flush_total_num | 10 + pgwr_last_flush_num | 3 + phyblkrd | 520 + phyblkwrt | 10 + phyblkwrt | 8 + phyrds | 520 + phywrts | 8 + phywrts | 9 + primary_flush_ptr | 42852736 + process_pending_counter | 0 + process_pending_total_dur | 0 + queue_head_page_rec_lsn | 0/0 + queue_rec_lsn | 0/28DE060 + read_data_io_counter | 0 + read_data_io_total_dur | 0 + read_ptr | 42851160 + read_xlog_io_counter | 2 + read_xlog_io_total_dur | 471 + recovery_done_ptr | 0 + redo_done_time | 0 + redo_start_ptr | 42851160 + redo_start_time | 732333220674305 + remain_dirty_page_num | 0 + resp_avg | 47907 + resp_max | 254914 + resp_min | 116 + resp_total | 479066 + rollback_counter | 0 + select_count | 15 + single_node1-backend_used_memory | 1 + single_node1-cstore_used_memory | 0 + single_node1-dynamic_peak_memory | 571 + single_node1-dynamic_peak_shrctx | 181 + single_node1-dynamic_used_memory | 558 + single_node1-dynamic_used_shrctx | 181 + single_node1-gpu_dynamic_peak_memory | 0 + single_node1-gpu_dynamic_used_memory | 0 + single_node1-gpu_max_dynamic_memory | 0 + single_node1-max_backend_memory | 348 + single_node1-max_cstore_memory | 512 + single_node1-max_dynamic_memory | 8142 + single_node1-max_process_memory | 12288 + single_node1-max_sctpcomm_memory | 0 + single_node1-max_shared_memory | 3285 + single_node1-other_used_memory | 0 + single_node1-pooler_conn_memory | 0 + single_node1-pooler_freeconn_memory | 0 + single_node1-process_used_memory | 806 + single_node1-sctpcomm_peak_memory | 0 + single_node1-sctpcomm_used_memory | 0 + single_node1-shared_used_memory | 220 + single_node1-storage_compress_memory | 0 + single_node1-udf_reserved_memory | 0 + speed | 0 + stats_reset | 2023-03-16 17:34:25.277803+08 + stats_reset | 2023-03-16 17:34:43.424584+08 + summary_file_iostat_count | 65 + temp_bytes | 0 + temp_files | 0 + total_pages | 27 + total_writes | 4 + tup_deleted | 61 + tup_fetched | 68794 + tup_inserted | 9906 + tup_returned | 59299 + tup_updated | 305 + update_count | 0 + user_id | 10 + user_name | hlv + wait_events_count | 401 + worker_info | no redo worker + workload | default_pool + write_data_io_counter | 0 + write_data_io_total_dur | 0 + writetim | 93 + xact_commit | 1324 + xact_rollback | 30 +(148 rows) + +openGauss=# show session status; + Variable_name | Value +--------------------------------------+------------------------------- + apply_counter | 0 + apply_total_dur | 0 + avgiotim | 10 + bg_commit_counter | 168 + bg_resp_avg | 53200083 + bg_resp_max | 122185319 + bg_resp_min | 79 + bg_resp_total | 8937613869 + bg_rollback_counter | 2 + blk_read_time | 0 + blks_hit | 504050 + blks_read | 1444 + blk_write_time | 0 + buffers_alloc | 0 + buffers_backend | 0 + buffers_backend_fsync | 0 + buffers_checkpoint | 0 + buffers_clean | 0 + checkpoints_req | 4 + checkpoints_timed | 29 + checkpoint_sync_time | 6794 + checkpoint_write_time | 5 + ckpt_clog_flush_num | 1 + ckpt_csnlog_flush_num | 0 + ckpt_multixact_flush_num | 1 + ckpt_predicate_flush_num | 0 + ckpt_redo_point | 0/28DE060 + ckpt_twophase_flush_num | 0 + commit_counter | 10 + confl_bufferpin | 0 + confl_deadlock | 0 + conflicts | 0 + confl_lock | 0 + confl_snapshot | 0 + confl_tablespace | 0 + curr_dwn | 0 + current_xlog_insert_lsn | 0/28DE180 + curr_start_page | 1684 + curr_time | 1 + datid | 16384 + datname | tt + dcl_count | 0 + ddl_count | 0 + deadlocks | 0 + delete_count | 0 + dml_count | 21 + file_id | 0 + file_reset_num | 0 + file_trunc_num | 2 + global_instance_time_count | 10 + high_threshold_pages | 0 + high_threshold_writes | 0 + insert_count | 0 + last_replayed_read_ptr | 0 + local_max_ptr | 0 + locks_count | 44 + login_counter | 9 + logout_counter | 8 + low_threshold_pages | 27 + low_threshold_writes | 4 + lstiotim | 8 + maxiowtm | 32 + maxwritten_clean | 0 + miniotim | 3 + min_recovery_point | 0 + node_name | single_node1 + numbackends | 1 + os_runtime_count | 19 + os_threads_count | 23 + p80 | 0 + p95 | 0 + pgwr_actual_flush_total_num | 10 + pgwr_last_flush_num | 3 + phyblkrd | 520 + phyblkwrt | 10 + phyblkwrt | 8 + phyrds | 520 + phywrts | 8 + phywrts | 9 + primary_flush_ptr | 42852736 + process_pending_counter | 0 + process_pending_total_dur | 0 + queue_head_page_rec_lsn | 0/0 + queue_rec_lsn | 0/28DE060 + read_data_io_counter | 0 + read_data_io_total_dur | 0 + read_ptr | 42851160 + read_xlog_io_counter | 2 + read_xlog_io_total_dur | 471 + recovery_done_ptr | 0 + redo_done_time | 0 + redo_start_ptr | 42851160 + redo_start_time | 732333220674305 + remain_dirty_page_num | 0 + resp_avg | 47907 + resp_max | 254914 + resp_min | 116 + resp_total | 479066 + rollback_counter | 0 + select_count | 15 + single_node1-backend_used_memory | 1 + single_node1-cstore_used_memory | 0 + single_node1-dynamic_peak_memory | 571 + single_node1-dynamic_peak_shrctx | 181 + single_node1-dynamic_used_memory | 558 + single_node1-dynamic_used_shrctx | 181 + single_node1-gpu_dynamic_peak_memory | 0 + single_node1-gpu_dynamic_used_memory | 0 + single_node1-gpu_max_dynamic_memory | 0 + single_node1-max_backend_memory | 348 + single_node1-max_cstore_memory | 512 + single_node1-max_dynamic_memory | 8142 + single_node1-max_process_memory | 12288 + single_node1-max_sctpcomm_memory | 0 + single_node1-max_shared_memory | 3285 + single_node1-other_used_memory | 0 + single_node1-pooler_conn_memory | 0 + single_node1-pooler_freeconn_memory | 0 + single_node1-process_used_memory | 806 + single_node1-sctpcomm_peak_memory | 0 + single_node1-sctpcomm_used_memory | 0 + single_node1-shared_used_memory | 220 + single_node1-storage_compress_memory | 0 + single_node1-udf_reserved_memory | 0 + speed | 0 + stats_reset | 2023-03-16 17:34:25.277803+08 + stats_reset | 2023-03-16 17:34:43.424584+08 + summary_file_iostat_count | 65 + temp_bytes | 0 + temp_files | 0 + total_pages | 27 + total_writes | 4 + tup_deleted | 61 + tup_fetched | 68794 + tup_inserted | 9906 + tup_returned | 59299 + tup_updated | 305 + update_count | 0 + user_id | 10 + user_name | hlv + wait_events_count | 401 + worker_info | no redo worker + workload | default_pool + write_data_io_counter | 0 + write_data_io_total_dur | 0 + writetim | 93 + xact_commit | 1324 + xact_rollback | 30 +(148 rows) + +openGauss=# show status like 'xact%'; + Variable_name | Value +---------------+------- + xact_commit | 1390 + xact_rollback | 31 +(2 rows) + +openGauss=# show status where variable_name = 'ckpt_redo_point'; + Variable_name | Value +-----------------+----------- + ckpt_redo_point | 0/28DE2A0 +(1 row) +``` diff --git a/content/en/docs/ExtensionReference/dolphin-show-warnings.md b/content/en/docs/ExtensionReference/dolphin-show-warnings.md new file mode 100644 index 0000000000000000000000000000000000000000..41cba1867524c5f5c12fd1a84d415563c152b661 --- /dev/null +++ b/content/en/docs/ExtensionReference/dolphin-show-warnings.md @@ -0,0 +1,175 @@ +# SHOW WARNINGS/ERRORS + +## Function + +SHOW WARNINGS/ERRORS displays information about storage functions. + +## Precautions + +- The added system parameter **sql\_note** determines whether to display note-level information in SHOW WARNINGS. + +- The **Code** column shows the error codes. The meaning of the number corresponds to the macro definition in ERRCODE. The status macros of various information are generated by the MAKE\_SQLSTATE(ch1, ch2, ch3, ch4, ch5). MAKE\_SQLSTATE is used to subtract '0' from the ASCII codes of ch1 to ch5, and then obtain the last six bits of the binary codes to obtain res1 to res5. The five data records form a 30-bit binary result (res5res4res3res2res1) from the least significant bit to the most significant bit. The result is converted into a decimal number, that is, the number of the error code. + Different error code numbers correspond to different status macros. + +## Syntax + +```sql +SHOW WARNINGS [LIMIT [offset,] row_count] +SHOW COUNT(*) WARNINGS + +SHOW ERRORS [LIMIT [offset,] row_count] +SHOW COUNT(*) ERRORS +``` + +## Parameter Description + +- **row_count** + + Maximum rows of warnings/errors information generated by the previous SQL statement. + +- **offset** + + Sequence number of the row from which the information is displayed. + +- **Added system parameter** + + [sql_note](dolphin-guc-parameters.md) determines whether to display note-level information in SHOW WARNINGS. + +## Return Result Set + +| Column | Type | Description | +| -------------------- | ----------------------- | -------------------------------- | +| Level | Character | Information level (Note/Warning/Error) | +| Code | Integer | Error code corresponding to the information status | +| Message | Character | Information content | + +## Examples + +```sql +openGauss=# show sql_note; + sql_note +---------- + on +(1 row) + +openGauss=# create table test(id int, name varchar default 11); +CREATE TABLE +openGauss=# create table test(id int, name varchar default 11); +ERROR: relation "test" already exists in schema "public" +DETAIL: creating new table with existing name in the same schema +openGauss=# show warnings limit 1; + level | code | message +-------+-----------+--------------------------------------------------- + Error | 117571716 | relation "test" already exists in schema "public" +(1 row) + +openGauss=# show count(*) warnings; + count +------- + 1 +(1 row) + +openGauss=# CREATE OR REPLACE FUNCTION TEST_FUNC(tempdata char) RETURNS VOID AS $$ +openGauss$# BEGIN +openGauss$# raise info'TEST CHAR VALUE IS %',tempdata; +openGauss$# END; +openGauss$# $$ LANGUAGE plpgsql; +CREATE FUNCTION +openGauss=# select TEST_FUNC('abc'::clob); +INFO: TEST CHAR VALUE IS abc +CONTEXT: referenced column: test_func + test_func +----------- + +(1 row) + +openGauss=# show warnings; + level | code | message +-------+------+------------------------ + Note | 0 | TEST CHAR VALUE IS abc +(1 row) + +openGauss=# set sql_note=false; +SET +openGauss=# select TEST_FUNC('abc'::clob); +INFO: TEST CHAR VALUE IS abc +CONTEXT: referenced column: test_func + test_func +----------- + +(1 row) + +openGauss=# show warnings; + level | code | message +-------+------+--------- +(0 rows) + +openGauss=# SELECT pg_advisory_unlock(1), pg_advisory_unlock_shared(2), pg_advisory_unlock(1, 1), pg_advisory_unlock_shared(2, 2); +WARNING: you don't own a lock of type ExclusiveLock +CONTEXT: referenced column: pg_advisory_unlock +WARNING: you don't own a lock of type ShareLock +CONTEXT: referenced column: pg_advisory_unlock_shared +WARNING: you don't own a lock of type ExclusiveLock +CONTEXT: referenced column: pg_advisory_unlock +WARNING: you don't own a lock of type ShareLock +CONTEXT: referenced column: pg_advisory_unlock_shared + pg_advisory_unlock | pg_advisory_unlock_shared | pg_advisory_unlock | pg_advisory_unlock_shared +--------------------+---------------------------+--------------------+--------------------------- + f | f | f | f +(1 row) + +openGauss=# show warnings; + level | code | message +---------+------+-------------------------------------------- + Warning | 64 | you don't own a lock of type ExclusiveLock + Warning | 64 | you don't own a lock of type ShareLock + Warning | 64 | you don't own a lock of type ExclusiveLock + Warning | 64 | you don't own a lock of type ShareLock +(4 rows) + +openGauss=# show warnings limit 2, 4; + level | code | message +---------+------+-------------------------------------------- + Warning | 64 | you don't own a lock of type ExclusiveLock + Warning | 64 | you don't own a lock of type ShareLock +(2 rows) + +``` +(3 rows) +``` + +```sql +--sql\_note is used to determine whether to store note information. +CREATE OR REPLACE FUNCTION TEST_FUNC(tempdata char) RETURNS VOID AS $$ +BEGIN + raise info'TEST CHAR VALUE IS %',tempdata; +END; +$$ LANGUAGE plpgsql; +select TEST_FUNC('abc'::clob); +INFO: TEST CHAR VALUE IS abc +CONTEXT: referenced column: test_func + test_func +----------- + +(1 row) + +show warnings; + level | code | message +-------+------+------------------------ + Note | 0 | TEST CHAR VALUE IS abc +(1 row) + +set sql_note=false; +select TEST_FUNC('abc'::clob); +INFO: TEST CHAR VALUE IS abc +CONTEXT: referenced column: test_func + test_func +----------- + +(1 row) + +show warnings; + level | code | message +-------+------+--------- +(0 rows) +``` diff --git a/content/en/docs/ExtensionReference/dolphin-stored-procedures.md b/content/en/docs/ExtensionReference/dolphin-stored-procedures.md new file mode 100644 index 0000000000000000000000000000000000000000..82be0def9543a7a747d337d5c5c489f0f30d2f05 --- /dev/null +++ b/content/en/docs/ExtensionReference/dolphin-stored-procedures.md @@ -0,0 +1,3 @@ +# Stored Procedures + +- **[Basic Statements](dolphin-basic-statements.md)** diff --git a/content/en/docs/ExtensionReference/dolphin-type-conversion-functions.md b/content/en/docs/ExtensionReference/dolphin-type-conversion-functions.md new file mode 100644 index 0000000000000000000000000000000000000000..36c9fd2afb56137844aa01ecaa676ddd9e9b8078 --- /dev/null +++ b/content/en/docs/ExtensionReference/dolphin-type-conversion-functions.md @@ -0,0 +1,52 @@ +# Type Conversion Functions + +## Type Conversion Functions + +- cast\(x as y\) + + Description: Converts x into the type specified by y. If the target data type is char, the data type is converted to varchar in the case of **dolphin.b\_compatibility\_mode=on**. Otherwise, the data type is still char. + + Example: + + ``` + openGauss=# set dolphin.b_compatibility_mode=on; + + openGauss=# SELECT cast('abc' as char(10)); + varchar + --------- + abc + (1 row) + + openGauss=# SELECT dolphin.b_compatibility_mode=off; + + openGauss=# SELECT cast('abc' as char(10)); + bpchar + ------------ + abc + (1 row) + ``` + + In subsequent development, the extended CAST function includes the conversion from money to unsigned and from timestamp to unsigned. + + ```sql + CREATE CAST (timestamp AS uint8) WITH FUNCTION timestamp_uint8(timestamp) AS ASSIGNMENT; + CREATE CAST (money AS uint8) WITH FUNCTION cash_uint(money) AS ASSIGNMENT; + ``` + + ## Compatibility + + The CREATE CAST instruction complies with the SQL standard. Except that the SQL does not have extra parameters that can be forcibly converted to binary types or implement functions. + + ```sql + openGauss=# SELECT CAST('$2'::money as unsigned); + uint8 + ------- + 2 + (1 row) + openGauss=# SELECT CAST(CURRENT_TIMESTAMP::TIMESTAMP AS UNSIGNED); + current_timestamp + ------------------- + 20230103023621 + (1 row) + + ``` diff --git a/content/zh/docs/Developerguide/figures/assignment_value.png b/content/en/docs/ExtensionReference/figures/assignment_value.png similarity index 100% rename from content/zh/docs/Developerguide/figures/assignment_value.png rename to content/en/docs/ExtensionReference/figures/assignment_value.png diff --git a/content/zh/docs/Developerguide/figures/case.jpg b/content/en/docs/ExtensionReference/figures/case.jpg similarity index 100% rename from content/zh/docs/Developerguide/figures/case.jpg rename to content/en/docs/ExtensionReference/figures/case.jpg diff --git a/content/zh/docs/Developerguide/figures/nvl.jpg b/content/en/docs/ExtensionReference/figures/nvl.jpg similarity index 100% rename from content/zh/docs/Developerguide/figures/nvl.jpg rename to content/en/docs/ExtensionReference/figures/nvl.jpg diff --git a/content/en/docs/GettingStarted/GettingStarted.md b/content/en/docs/GettingStarted/GettingStarted.md index 63158c9ed981d8b36a9b203ffc1a679269e8eec0..5f44628ed471fcfa462d6b4a084bf7a4bffba7d3 100644 --- a/content/en/docs/GettingStarted/GettingStarted.md +++ b/content/en/docs/GettingStarted/GettingStarted.md @@ -6,5 +6,5 @@ For example the **Installation Guide** provides information about installation r Many important features of openGauss are introduced in the **Developer Guide** section. -For example, the **[MOT Engine](../Administration/mot.md)** section provides a detailed review of the Memory Optimized Tables, a high performance storage engine embedded side-by-side the standard storage engine. This includes “MOT Introduction” section (including performance benchmarks), followed by the “Using MOT” section complete manual guide, and concluded by the “MOT Concepts” section with deeper insight into MOT design and technologies. +For example, the **[MOT Engine](../DatabaseAdministrationGuide/mot.md)** section provides a detailed review of the Memory Optimized Tables, a high performance storage engine embedded side-by-side the standard storage engine. This includes “MOT Introduction” section (including performance benchmarks), followed by the “Using MOT” section complete manual guide, and concluded by the “MOT Concepts” section with deeper insight into MOT design and technologies. diff --git a/content/en/docs/GettingStarted/container-based-installation-on-a-single-node.md b/content/en/docs/GettingStarted/container-based-installation-on-a-single-node.md index 47d8802a1184d2ab99994c53d7fa83c9dd4c5f16..e96e4f56ef0b847864e4d79978a6c9dab66f8559 100644 --- a/content/en/docs/GettingStarted/container-based-installation-on-a-single-node.md +++ b/content/en/docs/GettingStarted/container-based-installation-on-a-single-node.md @@ -16,7 +16,7 @@ Use the **buildDockerImage.sh** script to build a Docker image. This script is > **NOTE:** > -> - Before the installation, you need to provide the openGauss binary installation package. After decompressing the package, place the package \(**openGauss-***X.X.X***-CentOS-64bit.tar.bz2**\) in the **dockerfiles/**<*version*\> folder. The binary package can be downloaded from [https://opengauss.org/en/download.html](https://opengauss.org/en/download.html). Ensure that the correct yum source is available. +> - Before the installation, you need to provide the openGauss binary installation package. After decompressing the package, place the package \(**openGauss-***X.X.X***-CentOS-64bit.tar.bz2**\) in the **dockerfiles/**<*version*\> folder. The binary package can be downloaded from [https://opengauss.org/en/download/](https://opengauss.org/en/download/). Ensure that the correct yum source is available. > > - If the **-i** option is not specified when you run the **buildDockerImage.sh** script, the SHA-256 check is performed by default. You need to manually write the check result to the **sha256\_file\_amd64** file. > ``` diff --git a/content/en/docs/GettingStarted/installation.md b/content/en/docs/GettingStarted/installation.md index b30b46929d7a6cd62c4a245ea332e2c1af6445ad..446ede8bc8e1ecd8574083b7833d8ca12dd70026 100644 --- a/content/en/docs/GettingStarted/installation.md +++ b/content/en/docs/GettingStarted/installation.md @@ -4,7 +4,7 @@ openGauss supports simplified installation using scripts. - **[Preparing Installation](#Preparing-Installation.md)** -- **[Container-based Installation on a Single Node ](Container-based-Installation-on-a-Single-Node.md)** +- **[Container-based Installation on a Single Node ](container-based-installation-on-a-single-node.md)** - **[Installation on a Single Node](installation-on-a-single-node.md)** diff --git a/content/en/docs/GettingStarted/odbc.md b/content/en/docs/GettingStarted/odbc.md index a69f6aa07c65ad20ccce468f1514afdfff5378ba..0cf4df6e4fd9b4c94400e0b3a4322e00352be3d2 100644 --- a/content/en/docs/GettingStarted/odbc.md +++ b/content/en/docs/GettingStarted/odbc.md @@ -464,84 +464,84 @@ Run the **./isql -v** *MPPODBC* command \(***MPPODBC*** is the data source na
SQLAllocHandle is a generic function for allocating handles. It can replace the following functions:
-SQLAllocHandle is a generic function for allocating handles. It can replace the following functions:
+SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions:
-SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions:
+
+ 
- [B站](https://space.bilibili.com/543286270?from=search&seid=7579369334374103192&spm_id_from=333.337.0.0)
- [CSDN](https://blog.csdn.net/weixin_49727236)
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-caution.gif b/content/zh/docs/Appendix/public_sys-resources/icon-caution.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-caution.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-caution.png b/content/zh/docs/Appendix/public_sys-resources/icon-caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-caution.png differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-danger.gif b/content/zh/docs/Appendix/public_sys-resources/icon-danger.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-danger.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-danger.png b/content/zh/docs/Appendix/public_sys-resources/icon-danger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-danger.png differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-note.gif b/content/zh/docs/Appendix/public_sys-resources/icon-note.gif
deleted file mode 100644
index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-note.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-note.png b/content/zh/docs/Appendix/public_sys-resources/icon-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-note.png differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-notice.gif b/content/zh/docs/Appendix/public_sys-resources/icon-notice.gif
deleted file mode 100644
index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-notice.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-notice.png b/content/zh/docs/Appendix/public_sys-resources/icon-notice.png
new file mode 100644
index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-notice.png differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-tip.gif b/content/zh/docs/Appendix/public_sys-resources/icon-tip.gif
deleted file mode 100644
index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-tip.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-tip.png b/content/zh/docs/Appendix/public_sys-resources/icon-tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-tip.png differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-warning.gif b/content/zh/docs/Appendix/public_sys-resources/icon-warning.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Appendix/public_sys-resources/icon-warning.gif and /dev/null differ
diff --git a/content/zh/docs/Appendix/public_sys-resources/icon-warning.png b/content/zh/docs/Appendix/public_sys-resources/icon-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8
Binary files /dev/null and b/content/zh/docs/Appendix/public_sys-resources/icon-warning.png differ
diff --git "a/content/zh/docs/Appendix/\344\272\247\345\223\201FAQ.md" "b/content/zh/docs/Appendix/\344\272\247\345\223\201FAQ.md"
index d54c84ee60e0515e2a83ac7b535d9f46acd6af41..eab9f6dab6353d152309196b22f0d26f9318efc6 100644
--- "a/content/zh/docs/Appendix/\344\272\247\345\223\201FAQ.md"
+++ "b/content/zh/docs/Appendix/\344\272\247\345\223\201FAQ.md"
@@ -1,4 +1,4 @@
-# 产品FAQ
+# 产品FAQ
### **Q1：“极致RTO”、“并行恢复”与“备机可读”的关系是什么？**
diff --git "a/content/zh/docs/Appendix/\344\275\277\347\224\250FAQ.md" "b/content/zh/docs/Appendix/\344\275\277\347\224\250FAQ.md"
index f43700301cbad76b2cb62821bc1d517c31be9841..96c5a67a5cbfe1bee334c0e3ffcfbdc7adc05e1b 100644
--- "a/content/zh/docs/Appendix/\344\275\277\347\224\250FAQ.md"
+++ "b/content/zh/docs/Appendix/\344\275\277\347\224\250FAQ.md"
@@ -1,4 +1,4 @@
-# 使用FAQ
+# 使用FAQ
### **Q1：gsql连接数据库，提示“unknow:26000”，错误如下，要如何处理？**
diff --git "a/content/zh/docs/Appendix/\345\206\205\346\240\270\351\224\231\350\257\257\344\277\241\346\201\257.md" "b/content/zh/docs/Appendix/\345\206\205\346\240\270\351\224\231\350\257\257\344\277\241\346\201\257.md"
index 21bb0dafdc9a52f9eafa72b5bd047dc900893b07..3570be2fd2773ca4db5d655acd4fcc03a8b2fb9f 100644
--- "a/content/zh/docs/Appendix/\345\206\205\346\240\270\351\224\231\350\257\257\344\277\241\346\201\257.md"
+++ "b/content/zh/docs/Appendix/\345\206\205\346\240\270\351\224\231\350\257\257\344\277\241\346\201\257.md"
@@ -1,4 +1,4 @@
-# 内核错误信息
+# 内核错误信息
ERRMSG: "unsupported syntax: ENCRYPTED WITH in this operation"
@@ -624,7 +624,7 @@ CAUSE: "System error."
ACTION: "Contact engineer to support."
-ERRMSG: "ExtensionReference with OID %u does not exist"
+ERRMSG: "Extension with OID %u does not exist"
SQLSTATE: 42704
diff --git "a/content/zh/docs/Appendix/\346\234\257\350\257\255\350\241\250.md" "b/content/zh/docs/Appendix/\346\234\257\350\257\255\350\241\250.md"
index fbe2edfbb2ed0d9593eb56a6c4f9d4e7ba359828..e4f310fb4ce9663a05ce6a584265bba3def9a5ee 100644
--- "a/content/zh/docs/Appendix/\346\234\257\350\257\255\350\241\250.md"
+++ "b/content/zh/docs/Appendix/\346\234\257\350\257\255\350\241\250.md"
@@ -1,4 +1,4 @@
-# 术语表
+# 术语表
**表 1** 术语表
diff --git "a/content/zh/docs/Appendix/\351\224\231\350\257\257\346\227\245\345\277\227\344\277\241\346\201\257\345\217\202\350\200\203.md" "b/content/zh/docs/Appendix/\351\224\231\350\257\257\346\227\245\345\277\227\344\277\241\346\201\257\345\217\202\350\200\203.md"
index 889078d84ea85bcdab8fcd5c2c73be7215d7344e..1f48b29f4eb3fb26499aebe9e2427a858c9e9dbe 100644
--- "a/content/zh/docs/Appendix/\351\224\231\350\257\257\346\227\245\345\277\227\344\277\241\346\201\257\345\217\202\350\200\203.md"
+++ "b/content/zh/docs/Appendix/\351\224\231\350\257\257\346\227\245\345\277\227\344\277\241\346\201\257\345\217\202\350\200\203.md"
@@ -1,4 +1,4 @@
-# 错误日志信息参考
+# 错误日志信息参考
- **[内核错误信息](内核错误信息.md)**
diff --git "a/content/zh/docs/BriefTutorial/ALTER-TABLE\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/ALTER-TABLE\350\257\255\345\217\245.md"
index c9f0803a0c79fcf73e70d9eb85750f31b3de5f63..329427fdffb8759f9f739cc464e2eddd770c8eab 100644
--- "a/content/zh/docs/BriefTutorial/ALTER-TABLE\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/ALTER-TABLE\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# ALTER TABLE语句
+# ALTER TABLE语句
修改表，包括修改表的定义、重命名表、重命名表中指定的列、重命名表的约束、设置表的所属模式、添加/更新多个列、打开/关闭行访问控制开关。
diff --git a/content/zh/docs/BriefTutorial/DB4AI.md b/content/zh/docs/BriefTutorial/DB4AI.md
index 3e59f78b44707585b8c2008e4a578e4332d029ec..cb709f263a473fd3458ae796db642083bfde2487 100644
--- a/content/zh/docs/BriefTutorial/DB4AI.md
+++ b/content/zh/docs/BriefTutorial/DB4AI.md
@@ -1,4 +1,4 @@
-# DB4AI
+# DB4AI
openGauss当前版本支持了原生DB4AI能力，通过引入原生AI算子，简化操作流程，充分利用数据库优化器、执行器的优化与执行能力，获得高性能的数据库内模型训练能力。更简化的模型训练与预测流程、更高的性能表现，让开发者在更短时间内能更专注于模型的调优与数据分析上，而避免了碎片化的技术栈与冗余的代码实现。
diff --git a/content/zh/docs/BriefTutorial/DCF.md b/content/zh/docs/BriefTutorial/DCF.md
index 6bc030c6f84be21f74cc87640b3ed4e4ebde0cf9..3533f434e42e3a9362d64756413f8787c5c3fda5 100644
--- a/content/zh/docs/BriefTutorial/DCF.md
+++ b/content/zh/docs/BriefTutorial/DCF.md
@@ -1,4 +1,4 @@
-# DCF
+# DCF
DCF全称是Distributed Consensus Framework，即分布式一致性共识框架。DCF实现了Paxos、Raft等解决分布式一致性问题典型算法。使用DCF可以提供日志复制、集群高可用等能力。DCF提供了自选主能力，支持少数派强起能力，日志复制支持动态流量调整。同时也提供了基于Paxos多种角色节点类型，并能进行调整。
@@ -9,7 +9,7 @@ DCF是一款高性能、高度成熟可靠、易扩展、易使用的独立基
DCF功能架构如[图1](#fig31591049102410)所示，主要包括：功能模块、存储模块、通信模块、服务层等。
**图 1** DCF功能架构图
-
+
- **算法模块：**
@@ -60,7 +60,7 @@ DCF功能架构如[图1](#fig31591049102410)所示，主要包括：功能模块
流控算法主要流程如[图2](#fig548518330404)所示：
**图 2** 流控算法流程
- 
+ 
核心算法流程如下：
diff --git "a/content/zh/docs/BriefTutorial/DELETE\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/DELETE\350\257\255\345\217\245.md"
index 48526dac7984217223a7b0d8d4273bdec978644d..d0e0c80372452663574eafc81eb7fb7139a13107 100644
--- "a/content/zh/docs/BriefTutorial/DELETE\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/DELETE\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# DELETE语句
+# DELETE语句
DELETE语句可以从指定的表里删除满足WHERE子句的行。如果WHERE子句不存在，将删除表中所有行，结果只保留表结构。
diff --git a/content/zh/docs/BriefTutorial/DISTINCT.md b/content/zh/docs/BriefTutorial/DISTINCT.md
index f79a38682bfecdc970c76f7649f509a9b32d35d3..479b7e545bd56cf765525811dcf022302480db2e 100644
--- a/content/zh/docs/BriefTutorial/DISTINCT.md
+++ b/content/zh/docs/BriefTutorial/DISTINCT.md
@@ -1,4 +1,4 @@
-# DISTINCT
+# DISTINCT
DISTINCT关键字与SELECT语句一起使用，用于去除重复记录，只获取唯一的记录。
diff --git "a/content/zh/docs/BriefTutorial/GROUP-BY\345\255\220\345\217\245.md" "b/content/zh/docs/BriefTutorial/GROUP-BY\345\255\220\345\217\245.md"
index 0285250274a7af51a2371c91d040da01e59e5b1f..1c38ea51863d9794b1199031700198b418896621 100644
--- "a/content/zh/docs/BriefTutorial/GROUP-BY\345\255\220\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/GROUP-BY\345\255\220\345\217\245.md"
@@ -1,4 +1,4 @@
-# GROUP BY子句
+# GROUP BY子句
GROUP BY语句和SELECT语句一起使用，用来对相同的数据进行分组。您可以对一列或者多列进行分组，但是被分组的列必须存在。
diff --git "a/content/zh/docs/BriefTutorial/HAVING\345\255\220\345\217\245.md" "b/content/zh/docs/BriefTutorial/HAVING\345\255\220\345\217\245.md"
index 6f746413e7305cc1fb72d3dcd416bdc927640f8d..a7ee5e654e58813f632c57ff62c2cccf24bdb172 100644
--- "a/content/zh/docs/BriefTutorial/HAVING\345\255\220\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/HAVING\345\255\220\345\217\245.md"
@@ -1,4 +1,4 @@
-# HAVING子句
+# HAVING子句
HAVING子句可以让我们筛选分组后的各组数据。
diff --git "a/content/zh/docs/BriefTutorial/INSERT-INTO\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/INSERT-INTO\350\257\255\345\217\245.md"
index ccfa2be715d68f91a9c4100027b8a8528637a75a..0e4fdf8a0d0843d5157e82a0bf487bc80669aeb2 100644
--- "a/content/zh/docs/BriefTutorial/INSERT-INTO\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/INSERT-INTO\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# INSERT INTO语句
+# INSERT INTO语句
在创建一个表后，表中并没有数据，使用这个表之前，需要向表中插入数据。INSERT INTO语句用于向表中插入新记录。该语句可以插入一行数据也可以同时插入多行数据。
diff --git a/content/zh/docs/BriefTutorial/JOIN.md b/content/zh/docs/BriefTutorial/JOIN.md
index e8d94a1a1d7e30ac71722a164d42123d40c7393b..805eefba8b85a51cd4c248e57c1b0c295d6636ef 100644
--- a/content/zh/docs/BriefTutorial/JOIN.md
+++ b/content/zh/docs/BriefTutorial/JOIN.md
@@ -1,4 +1,4 @@
-# JOIN
+# JOIN
JOIN子句用于把来自两个或多个表的行结合起来，基于这些表之间的共同字段。
diff --git a/content/zh/docs/BriefTutorial/LLVM.md b/content/zh/docs/BriefTutorial/LLVM.md
index f453e403a68da7c4183df30939680fdc900592bf..4bcd30739fded45f6d2d92d0a5247390252a2372 100644
--- a/content/zh/docs/BriefTutorial/LLVM.md
+++ b/content/zh/docs/BriefTutorial/LLVM.md
@@ -1,4 +1,4 @@
-# LLVM
+# LLVM
openGauss借助LLVM（Low Level Virtual Machine）提供的库函数，依据查询执行计划树，将原本在执行器阶段才会确定查询实际执行路径的过程提前到执行初始化阶段，从而规避原本查询执行时候伴随的函数调用、逻辑条件分支判断以及大量的数据读取等问题，以达到提升查询性能的目的。
@@ -84,7 +84,7 @@ LLVM优化效果不仅依赖于数据库内部具体的实现，还与当前所
2. 设置合理的codegen\_cost\_threshold\(默认值为10000\)，确保小数据量场景下避免使用LLVM动态编译优化。当codegen\_cost\_threshold的值设定后，因使用LLVM动态编译优化引入性能劣化，则建议增加codegen\_cost\_threshold的取值。
3. 对于表达式计算使用LLVM动态编译优化，如果存在大量的调用C-函数的场景，建议关闭LLVM动态编译优化。
- > **说明：**
+ > **说明：**
>在资源许可的情况下，数据量越大，可获得的性能提升效果越好。
diff --git a/content/zh/docs/BriefTutorial/MOT.md b/content/zh/docs/BriefTutorial/MOT.md
index 3d9c8b130cf0f294b40dd5abf0368355b63afb63..8359cf047cf3d777a2e568aac33033eeeed2226d 100644
--- a/content/zh/docs/BriefTutorial/MOT.md
+++ b/content/zh/docs/BriefTutorial/MOT.md
@@ -1,4 +1,4 @@
-# MOT
+# MOT
openGauss引入了MOT（Memory-Optimized Table，MOT）存储引擎，它是一种事务性行存储，针对多核和大内存服务器进行了优化。MOT是openGauss数据库最先进的生产级特性（Beta版本），它为事务性工作负载提供更高的性能。MOT完全支持ACID特性，并包括严格的持久性和高可用性支持。企业可以在关键任务、性能敏感的在线事务处理（OLTP）中使用MOT，以实现高性能、高吞吐、可预测低延迟以及多核服务器的高利用率。MOT尤其适合在多路和多核处理器的现代服务器上运行，例如基于Arm/鲲鹏处理器的华为TaiShan服务器，以及基于x86的戴尔或类似服务器。
@@ -94,7 +94,7 @@ MOT可用于各种应用，例如：
以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。
- > **说明：**
+ > **说明：**
>MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与openGauss数据库集成，所以需要授权用户权限。
要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次：
@@ -154,7 +154,7 @@ MOT可用于各种应用，例如：
create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ;
```
- > **说明：**
+ > **说明：**
>在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。
@@ -186,7 +186,7 @@ MOT可用于各种应用，例如：
6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。
7. 恢复应用程序活动。
- > **须知：**
+ > **须知：**
>由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
- 转换示例
@@ -200,7 +200,7 @@ MOT可用于各种应用，例如：
```
benchmarksql-# \d+ customer
Table "public.customer"
- Column | Type | Modifiers | Storage | Stats target | AboutopenGauss
+ Column | Type | Modifiers | Storage | Stats target | Description
--------+---------+-----------+---------+--------------+-------------
x | integer | | plain | |
y | integer | | plain | |
diff --git "a/content/zh/docs/BriefTutorial/NULL\345\200\274.md" "b/content/zh/docs/BriefTutorial/NULL\345\200\274.md"
index 6ea07c111ca9b4f3a7ca86d8b84cb16a9bf65cf7..02f235c9ae0d49c135a9390306499a6ac7bad56d 100644
--- "a/content/zh/docs/BriefTutorial/NULL\345\200\274.md"
+++ "b/content/zh/docs/BriefTutorial/NULL\345\200\274.md"
@@ -1,4 +1,4 @@
-# NULL值
+# NULL值
NULL值代表未知数据。无法比较NULL和0，因为它们是不等价的。
diff --git "a/content/zh/docs/BriefTutorial/ORDER-BY\345\255\220\345\217\245.md" "b/content/zh/docs/BriefTutorial/ORDER-BY\345\255\220\345\217\245.md"
index d18d104217d2d579364270e01d61ea687f7bfaf1..c6009f61f5547ac0e5495e314d4dc3f50778fbc7 100644
--- "a/content/zh/docs/BriefTutorial/ORDER-BY\345\255\220\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/ORDER-BY\345\255\220\345\217\245.md"
@@ -1,4 +1,4 @@
-# ORDER BY子句
+# ORDER BY子句
ORDER BY对对SELECT语句检索得到的一列或者多列数据进行升序（ASC）或者降序（DESC）排列。
diff --git a/content/zh/docs/BriefTutorial/SCHEMA.md b/content/zh/docs/BriefTutorial/SCHEMA.md
index 6f5cef32b801e2be3b57c986ab2acabe4beadeb8..cd7d45c4670cf8ededea42aff5f83027fb557711 100644
--- a/content/zh/docs/BriefTutorial/SCHEMA.md
+++ b/content/zh/docs/BriefTutorial/SCHEMA.md
@@ -1,4 +1,4 @@
-# SCHEMA
+# SCHEMA
SCHEMA又称作模式。通过管理SCHEMA，允许多个用户使用同一数据库而不相互干扰，可以将数据库对象组织成易于管理的逻辑组，同时便于将第三方应用添加到相应的SCHEMA下而不引起冲突。
@@ -48,7 +48,7 @@ SCHEMA又称作模式。通过管理SCHEMA，允许多个用户使用同一数
模式名称。
- > **须知：**
+ > **须知：**
>模式名不能和当前数据库里其他的模式重名。
>模式的名称不可以“pg\_”开头。
@@ -67,7 +67,7 @@ SCHEMA又称作模式。通过管理SCHEMA，允许多个用户使用同一数
子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。
-> **说明：**
+> **说明：**
>如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH\_PATH来查看当前搜索路径上的模式。
## 示例
diff --git "a/content/zh/docs/BriefTutorial/SELECT\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/SELECT\350\257\255\345\217\245.md"
index 286de4dbed6af0c8644af60cfa73e0b77c5e63a6..0c4e2de7c7f761a0b4cb53f786252882598b31b8 100644
--- "a/content/zh/docs/BriefTutorial/SELECT\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/SELECT\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# SELECT语句
+# SELECT语句
SELECT语句用于从表或视图中取出数据，结果被存储在一个结果表中，称为结果集。
diff --git "a/content/zh/docs/BriefTutorial/TRUNCATE-TABLE\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/TRUNCATE-TABLE\350\257\255\345\217\245.md"
index 6f36a95033b751f323e0fe8dc7f8b72ab8f91785..9066ec27594eec0b97aff9b449ced13c235319aa 100644
--- "a/content/zh/docs/BriefTutorial/TRUNCATE-TABLE\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/TRUNCATE-TABLE\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# TRUNCATE TABLE语句
+# TRUNCATE TABLE语句
清理表数据，TRUNCATE TABLE用于删除表的数据，但不删除表结构。也可以用DROP TABLE删除表，但是这个命令会连表的结构一起删除，如果想插入数据，需要重新建立这张表。
diff --git "a/content/zh/docs/BriefTutorial/UNION\345\255\220\345\217\245.md" "b/content/zh/docs/BriefTutorial/UNION\345\255\220\345\217\245.md"
index f9d4f9b2c84f0a1b31ad02962a8169e33759efb0..ac1b03b55ccd7c39d4a1cc368b05a4e0c479da27 100644
--- "a/content/zh/docs/BriefTutorial/UNION\345\255\220\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/UNION\345\255\220\345\217\245.md"
@@ -1,4 +1,4 @@
-# UNION子句
+# UNION子句
UNION计算多个SELECT语句返回行集合的并集。UNION内部的SELECT语句必须拥有相同数量的列，列也必须拥有相似的数据类型。同时，每条SELECT语句中的列的顺序必须相同。
diff --git "a/content/zh/docs/BriefTutorial/UPDATE\350\257\255\345\217\245.md" "b/content/zh/docs/BriefTutorial/UPDATE\350\257\255\345\217\245.md"
index 7d1df565917a7f0ac1fe5f4380dc99d89a08134f..bb72798d808eb91afb7958490d3590138dc62382 100644
--- "a/content/zh/docs/BriefTutorial/UPDATE\350\257\255\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/UPDATE\350\257\255\345\217\245.md"
@@ -1,4 +1,4 @@
-# UPDATE语句
+# UPDATE语句
修改已经存储在数据库中数据的行为叫做更新。用户可以更新单独一行，所有行或者指定的部分行。还可以独立更新每个字段，而其他字段则不受影响。UPDATE修改满足条件的所有行中指定的字段值，WHERE子句声明条件，SET子句指定的字段会被修改，没有出现的字段则保持它们的原值。
diff --git a/content/zh/docs/BriefTutorial/Ustore.md b/content/zh/docs/BriefTutorial/Ustore.md
index d0f3e444910091aaf2fe8b6ad9e6db8c067d9002..96443c64815be23b0ab96724aec84b5b181f469b 100644
--- a/content/zh/docs/BriefTutorial/Ustore.md
+++ b/content/zh/docs/BriefTutorial/Ustore.md
@@ -1,4 +1,4 @@
-# Ustore
+# Ustore
Ustore存储引擎，又名In-place Update存储引擎（原地更新），是openGauss 内核新增的一种存储模式。此前的版本使用的行存储引擎是Append Update（追加更新）模式。追加更新对于业务中的增、删以及HOT（HeapOnly Tuple）Update（即同一页面内更新）有很好的表现，但对于跨数据页面的非HOT UPDATE场景，垃圾回收不够高效。因此，Ustore存储引擎应运而生。
@@ -65,7 +65,7 @@ USTORE与原有的ASTORE\(Append Update\)存储引擎并存。USTORE存储引擎
```
openGauss=# \d+ test
Table "public.test"
- Column | Type | Modifiers | Storage | Stats target | AboutopenGauss
+ Column | Type | Modifiers | Storage | Stats target | Description
--------+-----------------------+-----------+----------+--------------+-------------
id | integer | | plain | |
age | integer | | plain | |
@@ -81,7 +81,7 @@ USTORE与原有的ASTORE\(Append Update\)存储引擎并存。USTORE存储引擎
```
openGauss=# \d+ test
Table "public.test"
- Column | Type | Modifiers | Storage | Stats target | AboutopenGauss
+ Column | Type | Modifiers | Storage | Stats target | Description
--------+-----------------------+-----------+----------+--------------+-------------
id | integer | | plain | |
age | integer | | plain | |
@@ -101,7 +101,7 @@ USTORE与原有的ASTORE\(Append Update\)存储引擎并存。USTORE存储引擎
```
openGauss=# \d+ test
Table "public.test"
- Column | Type | Modifiers | Storage | Stats target | AboutopenGauss
+ Column | Type | Modifiers | Storage | Stats target | Description
--------+-----------------------+-----------+----------+--------------+-------------
id | integer | | plain | |
age | integer | | plain | |
diff --git "a/content/zh/docs/BriefTutorial/WHERE\345\255\220\345\217\245.md" "b/content/zh/docs/BriefTutorial/WHERE\345\255\220\345\217\245.md"
index 18f54d7b88093f09feb4d9884cd0f3a786418fd0..c72fbe703ba1ac290ff9e292babd53e677f77fd2 100644
--- "a/content/zh/docs/BriefTutorial/WHERE\345\255\220\345\217\245.md"
+++ "b/content/zh/docs/BriefTutorial/WHERE\345\255\220\345\217\245.md"
@@ -1,4 +1,4 @@
-# WHERE子句
+# WHERE子句
当我们需要根据指定条件从表中查询数据时，就可以在SELECT语句中添加WHERE子句，从而过滤掉我们不需要数据。WHERE子句构成一个行选择表达式，用于指定条件而获取的数据，如果给定的条件满足，才返回从表中的具体数值。
diff --git "a/content/zh/docs/BriefTutorial/figures/DCF\345\212\237\350\203\275\346\236\266\346\236\204\345\233\276.png" "b/content/zh/docs/BriefTutorial/figures/DCF\345\212\237\350\203\275\346\236\266\346\236\204\345\233\276.png"
deleted file mode 100644
index 3df6d54fd8596a26a227ab23157243a5dfb34467..0000000000000000000000000000000000000000
Binary files "a/content/zh/docs/BriefTutorial/figures/DCF\345\212\237\350\203\275\346\236\266\346\236\204\345\233\276.png" and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/figures/Diagram-Of-The-DCF-Functional-Architecture.png b/content/zh/docs/BriefTutorial/figures/Diagram-Of-The-DCF-Functional-Architecture.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2a24762b31c96f2e072ca887968e68f387cf5eb
Binary files /dev/null and b/content/zh/docs/BriefTutorial/figures/Diagram-Of-The-DCF-Functional-Architecture.png differ
diff --git "a/content/zh/docs/BriefTutorial/figures/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204\345\233\276.jpg" b/content/zh/docs/BriefTutorial/figures/Resource-pooling-architecture-diagram.jpg
similarity index 100%
rename from "content/zh/docs/BriefTutorial/figures/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204\345\233\276.jpg"
rename to content/zh/docs/BriefTutorial/figures/Resource-pooling-architecture-diagram.jpg
diff --git "a/content/zh/docs/Appendix/figures/\346\225\260\346\215\256\345\272\223\351\200\273\350\276\221\347\273\223\346\236\204\345\233\276.png" b/content/zh/docs/BriefTutorial/figures/database-logical-architecture.png
similarity index 100%
rename from "content/zh/docs/Appendix/figures/\346\225\260\346\215\256\345\272\223\351\200\273\350\276\221\347\273\223\346\236\204\345\233\276.png"
rename to content/zh/docs/BriefTutorial/figures/database-logical-architecture.png
diff --git "a/content/zh/docs/BriefTutorial/figures/openGauss\351\200\273\350\276\221\346\236\266\346\236\204\345\233\276.png" "b/content/zh/docs/BriefTutorial/figures/openGauss\351\200\273\350\276\221\346\236\266\346\236\204\345\233\276.png"
deleted file mode 100644
index 27620cd425fe1d95d3ddcef802b04a4d9814e0c6..0000000000000000000000000000000000000000
Binary files "a/content/zh/docs/BriefTutorial/figures/openGauss\351\200\273\350\276\221\346\236\266\346\236\204\345\233\276.png" and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/figures/zh-011.PNG b/content/zh/docs/BriefTutorial/figures/zh-011.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..2ca243aa14fc56d7982bc1d81a389b6167866b34
Binary files /dev/null and b/content/zh/docs/BriefTutorial/figures/zh-011.PNG differ
diff --git a/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001189073180.png b/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001189073180.png
index 35508eb6ef278ccaac3b902b262391e5bb6a3552..a268d70e9fd86801c3c2601d40c84367246cdfb4 100644
Binary files a/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001189073180.png and b/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001189073180.png differ
diff --git a/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001235224851.jpg b/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001235224851.jpg
index 51596214a6fd042935a7dea030297b14b62028e2..090a6d4d4a429075f3826de56925cadf5c3dbb56 100644
Binary files a/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001235224851.jpg and b/content/zh/docs/BriefTutorial/figures/zh-cn_image_0000001235224851.jpg differ
diff --git "a/content/zh/docs/BriefTutorial/figures/\346\265\201\346\216\247\347\256\227\346\263\225\346\265\201\347\250\213.jpg" "b/content/zh/docs/BriefTutorial/figures/\346\265\201\346\216\247\347\256\227\346\263\225\346\265\201\347\250\213.jpg"
deleted file mode 100644
index 6d97f42a87194a22f24eb4cd01d08f71556665fe..0000000000000000000000000000000000000000
Binary files "a/content/zh/docs/BriefTutorial/figures/\346\265\201\346\216\247\347\256\227\346\263\225\346\265\201\347\250\213.jpg" and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-caution.png differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-danger.png differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.gif
deleted file mode 100644
index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-note.png differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.gif
deleted file mode 100644
index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.png
new file mode 100644
index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-notice.png differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.gif
deleted file mode 100644
index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-tip.png differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.gif b/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.gif and /dev/null differ
diff --git a/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.png b/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8
Binary files /dev/null and b/content/zh/docs/BriefTutorial/public_sys-resources/icon-warning.png differ
diff --git "a/content/zh/docs/BriefTutorial/\344\272\213\344\273\266\350\247\246\345\217\221\345\231\250.md" "b/content/zh/docs/BriefTutorial/\344\272\213\344\273\266\350\247\246\345\217\221\345\231\250.md"
index d336a6ac678a16235674eac077eedc8c8308a021..05e60c0b2cbd7ac613104ab88e150339e7a0e780 100644
--- "a/content/zh/docs/BriefTutorial/\344\272\213\344\273\266\350\247\246\345\217\221\345\231\250.md"
+++ "b/content/zh/docs/BriefTutorial/\344\272\213\344\273\266\350\247\246\345\217\221\345\231\250.md"
@@ -1,4 +1,4 @@
-# 事件触发器
+# 事件触发器
触发器会在指定的ddl事件发生时自动执行函数。目前事件触发器仅在PG兼容模式下可用。
diff --git "a/content/zh/docs/BriefTutorial/\344\272\213\345\212\241.md" "b/content/zh/docs/BriefTutorial/\344\272\213\345\212\241.md"
index 128d5aa6c2a50db574c656823f00b402843d2353..7800833983184bfc496dc1ee9f6c72ec77da5b20 100644
--- "a/content/zh/docs/BriefTutorial/\344\272\213\345\212\241.md"
+++ "b/content/zh/docs/BriefTutorial/\344\272\213\345\212\241.md"
@@ -1,4 +1,4 @@
-# 事务
+# 事务
事务是用户定义的一个数据库操作序列，这些操作要么全做要么全不做，是一个不可分割的工作单位。openGauss数据库支持的事务控制命令有启动、设置、提交、回滚事务。openGauss数据库支持的事务隔离级别有读已提交和可重复读。
@@ -77,7 +77,7 @@
指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。
- > **说明：**
+ > **说明：**
>在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。
取值范围：
diff --git "a/content/zh/docs/BriefTutorial/\345\205\250\345\257\206\346\200\201\346\225\260\346\215\256\345\272\223.md" "b/content/zh/docs/BriefTutorial/\345\205\250\345\257\206\346\200\201\346\225\260\346\215\256\345\272\223.md"
index c9a77a78a64872e75a65c27a5a36ca98cebd29bc..251982da40ec51912a903750a74e7eb692b4016f 100644
--- "a/content/zh/docs/BriefTutorial/\345\205\250\345\257\206\346\200\201\346\225\260\346\215\256\345\272\223.md"
+++ "b/content/zh/docs/BriefTutorial/\345\205\250\345\257\206\346\200\201\346\225\260\346\215\256\345\272\223.md"
@@ -1,4 +1,4 @@
-# 全密态数据库
+# 全密态数据库
全密态数据库意在解决数据全生命周期的隐私保护问题，使得系统无论在何种业务场景和环境下，数据在传输、运算以及存储的各个环节始终都处于密文状态。当数据拥有者在客户端完成数据加密并发送给服务端后，在攻击者借助系统脆弱点窃取用户数据的状态下仍然无法获得有效的价值信息，从而起到保护数据隐私的能力。
@@ -37,7 +37,7 @@
**【创建CMK】**
```
- CREATE CLIENT MASTER KEY client_master_key_name WITH （KEY_STORE =key_store_name, KEY_PATH = "key_path_value", ALGORITHM = algorithm_type）;
+ CREATE CLIENT MASTER KEY client_master_key_name WITH (KEY_STORE =key_store_name, KEY_PATH = "key_path_value", ALGORITHM = algorithm_type);
```
参数说明：
@@ -60,7 +60,7 @@
由本语法创建的用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值范围：RSA\_2048、RSA3072和SM2。
- > **说明：**
+ > **说明：**
>密钥存储路径：默认情况下，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。
>所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。
@@ -95,7 +95,7 @@
该值为用户指定的密钥口令，密钥口令长度范围为28 \~ 256个字符。28个字符派生出来的密钥安全强度满足AES128。若用户需要用AES256，密钥口令的长度需要39个字符。如果不指定，则会自动生成256比特的密钥。
- > **说明：**
+ > **说明：**
>由于SM2、SM3、SM4等算法属于中国国家密码标准算法，为规避法律风险，需配套使用。如果创建CMK时指定SM4算法来加密CEK，则创建CEK时必须指定SM4\_SM3算法来加密数据。
**【示例:GSQL环境下：】**
@@ -167,7 +167,7 @@
(1 row)
```
- > **说明：**
+ > **说明：**
>使用非密态客户端查看该加密表数据时是密文。
```
diff --git "a/content/zh/docs/BriefTutorial/\345\207\275\346\225\260.md" "b/content/zh/docs/BriefTutorial/\345\207\275\346\225\260.md"
index 8ccbe001d778ef857439775863459e81a57bc0d7..039559b1d45cd086f43be818d7e6978a35d1c917 100644
--- "a/content/zh/docs/BriefTutorial/\345\207\275\346\225\260.md"
+++ "b/content/zh/docs/BriefTutorial/\345\207\275\346\225\260.md"
@@ -1,4 +1,4 @@
-# 函数
+# 函数
openGauss常用的函数如下：
@@ -251,7 +251,7 @@ openGauss常用的函数如下：
描述：离输入参数最近的整数。
- 返回值类型：与输入相同。
+ 返回值类型：与输入相同（double precision或者numeric类型）。
示例：
@@ -843,7 +843,7 @@ openGauss常用的函数如下：
描述：将string使用MD5加密，并以16进制数作为返回值。
- > **说明：**
+ > **说明：**
>MD5加密算法安全性低，存在安全风险，不建议使用。
返回值类型：text
diff --git "a/content/zh/docs/BriefTutorial/\345\210\206\345\214\272\350\241\250.md" "b/content/zh/docs/BriefTutorial/\345\210\206\345\214\272\350\241\250.md"
index 38db8bc8bfc93104abd6923d63be75e93b7e6bc0..fcbeb69c2d3eb55b932268e610301c019c641c1f 100644
--- "a/content/zh/docs/BriefTutorial/\345\210\206\345\214\272\350\241\250.md"
+++ "b/content/zh/docs/BriefTutorial/\345\210\206\345\214\272\350\241\250.md"
@@ -1,4 +1,4 @@
-# 分区表
+# 分区表
一张表内的数据过多时，就会严重影响到数据的查询和操作效率。openGauss支持把一张表从逻辑上分成多个小的分片，从而避免一次处理大量数据，提高处理效率。
@@ -641,7 +641,7 @@ CREATE TABLE partition_table_name
partition\_key为分区键的名称。
- 列表分区策略的分区键仅支持1列。
+ 列表分区策略的分区键最大支持16列。
- **partition\_name**
diff --git "a/content/zh/docs/BriefTutorial/\345\210\227\345\255\230\345\202\250.md" "b/content/zh/docs/BriefTutorial/\345\210\227\345\255\230\345\202\250.md"
index fd385c2cba6f3b3966da3c83a43d0b5e0c00c9f2..543d8325fae9189e86ec9429fa985fce5778d982 100644
--- "a/content/zh/docs/BriefTutorial/\345\210\227\345\255\230\345\202\250.md"
+++ "b/content/zh/docs/BriefTutorial/\345\210\227\345\255\230\345\202\250.md"
@@ -1,4 +1,4 @@
-# 列存储
+# 列存储
openGauss支持行列混合存储。行存储是指将表按行存储到硬盘分区上，列存储是指将表按列存储到硬盘分区上。
@@ -7,7 +7,7 @@ openGauss支持行列混合存储。行存储是指将表按行存储到硬盘
**图 1** 行存储和列存储的差异
-
+
上图中，左上为行存表，右上为行存表在硬盘上的存储方式。左下为列存表，右下为列存表在硬盘上的存储方式。
diff --git "a/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\346\225\260\346\215\256\345\272\223.md" "b/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\346\225\260\346\215\256\345\272\223.md"
index fe473e1b0024194aa7df61a508daee8bdf6f8ce2..48913487ce1f327cbe3a3efb364ce3767bfe88ed 100644
--- "a/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\346\225\260\346\215\256\345\272\223.md"
+++ "b/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\346\225\260\346\215\256\345\272\223.md"
@@ -1,4 +1,4 @@
-# 创建数据库
+# 创建数据库
数据库安装完成后，默认生成名称为postgres的数据库。您需要自己创建一个新的数据库。
diff --git "a/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\350\241\250.md" "b/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\350\241\250.md"
index c6569785ca3d1af01ce5fd26e63046d42d9b6f84..e2703b9e8b138b1f18c86ee4368d981223586858 100644
--- "a/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\350\241\250.md"
+++ "b/content/zh/docs/BriefTutorial/\345\210\233\345\273\272\350\241\250.md"
@@ -1,4 +1,4 @@
-# 创建表
+# 创建表
在当前数据库中创建一个新的空白表，该表由命令执行者所有。在不同的数据库中可以存放相同的表。您可以使用CREATE TABLE语句创建表。
diff --git "a/content/zh/docs/BriefTutorial/\345\210\253\345\220\215.md" "b/content/zh/docs/BriefTutorial/\345\210\253\345\220\215.md"
index ae0e10c4618406091aefdc48469e312c926c2061..9ed58fba08e26a10796905750f0c004200cc9f78 100644
--- "a/content/zh/docs/BriefTutorial/\345\210\253\345\220\215.md"
+++ "b/content/zh/docs/BriefTutorial/\345\210\253\345\220\215.md"
@@ -1,4 +1,4 @@
-# 别名
+# 别名
SQL可以重命名一张表或者一个字段的名称，这个名称为该表或该字段的别名。创建别名是为了让表名或列名的可读性更强。SQL中使用AS来创建别名。
diff --git "a/content/zh/docs/BriefTutorial/\345\214\277\345\220\215\345\235\227.md" "b/content/zh/docs/BriefTutorial/\345\214\277\345\220\215\345\235\227.md"
index 37b687af28c84622061555d02c136f8eb5f7add8..516824184c48a8fe4f6f020f4ff52459c0b5394e 100644
--- "a/content/zh/docs/BriefTutorial/\345\214\277\345\220\215\345\235\227.md"
+++ "b/content/zh/docs/BriefTutorial/\345\214\277\345\220\215\345\235\227.md"
@@ -1,4 +1,4 @@
-# 匿名块
+# 匿名块
匿名块（Anonymous Block）是存储过程的字块之一，没有名称。一般用于不频繁执行的脚本或不重复进行的活动。
@@ -13,7 +13,7 @@
- 匿名块程序实施部分，以BEGIN语句开始，以END语句停顿，以一个分号结束。输入“/”按回车执行它。
- > **须知：**
+ > **须知：**
>最后的结束符“/”必须独占一行，不能直接跟在END后面。
- 声明部分包括变量定义、类型、游标定义等。
diff --git "a/content/zh/docs/BriefTutorial/\345\237\272\346\234\254\346\246\202\345\277\265.md" "b/content/zh/docs/BriefTutorial/\345\237\272\346\234\254\346\246\202\345\277\265.md"
index d370addb9272d8201cada6778735b94a43fbd9af..32f2f9459a0596d362d5f8105aa2bab87644ba68 100644
--- "a/content/zh/docs/BriefTutorial/\345\237\272\346\234\254\346\246\202\345\277\265.md"
+++ "b/content/zh/docs/BriefTutorial/\345\237\272\346\234\254\346\246\202\345\277\265.md"
@@ -1,11 +1,11 @@
-# 基本概念
+# 基本概念
openGauss是一款关系型数据库管理系统（RDBMS）。关系型数据库是指采用了关系模型来组织数据的数据库，其以行和列的形式存储数据。
openGauss的数据库节点负责存储数据，其存储介质也是磁盘。逻辑视角下，可以看到数据库节点上对象包含表空间、数据库、数据文件、表、数据块。对象之间的关系如[图1](#zh-cn_topic_0283136742_zh-cn_topic_0237120245_zh-cn_topic_0059779316_fb2fa3b3cc8824dea95318504e0537913)。
**图 1** 数据库逻辑结构图
-
+
## 数据库（Database）
diff --git "a/content/zh/docs/BriefTutorial/\345\255\220\346\237\245\350\257\242.md" "b/content/zh/docs/BriefTutorial/\345\255\220\346\237\245\350\257\242.md"
index ddf0dbe321e420706b159ca35cf8ad360003b3fa..0fdebd2a237971bcb5d0cae2b4e1c6f278c14ba7 100644
--- "a/content/zh/docs/BriefTutorial/\345\255\220\346\237\245\350\257\242.md"
+++ "b/content/zh/docs/BriefTutorial/\345\255\220\346\237\245\350\257\242.md"
@@ -1,4 +1,4 @@
-# 子查询
+# 子查询
子查询或称为内部查询，嵌套查询，指的是在数据库查询的WHERE子句中嵌入查询语句，相当于临时表。一个SELECT语句的查询结果能够作为另一个语句的输入值。
diff --git "a/content/zh/docs/BriefTutorial/\345\255\230\345\202\250\350\277\207\347\250\213.md" "b/content/zh/docs/BriefTutorial/\345\255\230\345\202\250\350\277\207\347\250\213.md"
index ce3ad54b844e6ed81c9140a95921402809c62103..238f748a6f24dacb69162d00e86b4a68680bb845 100644
--- "a/content/zh/docs/BriefTutorial/\345\255\230\345\202\250\350\277\207\347\250\213.md"
+++ "b/content/zh/docs/BriefTutorial/\345\255\230\345\202\250\350\277\207\347\250\213.md"
@@ -1,4 +1,4 @@
-# 存储过程
+# 存储过程
存储过程是能够完成特定功能的SQL语句集。用户可以进行反复调用，从而减少SQL语句的重复编写数量，提高工作效率。
diff --git "a/content/zh/docs/BriefTutorial/\345\271\266\350\241\214\346\237\245\350\257\242.md" "b/content/zh/docs/BriefTutorial/\345\271\266\350\241\214\346\237\245\350\257\242.md"
index 135f6114bc006deef9fb87cf98ee09335ce1b3f9..d675f98d00656494686629cadfeb13e2b66cbe90 100644
--- "a/content/zh/docs/BriefTutorial/\345\271\266\350\241\214\346\237\245\350\257\242.md"
+++ "b/content/zh/docs/BriefTutorial/\345\271\266\350\241\214\346\237\245\350\257\242.md"
@@ -1,4 +1,4 @@
-# 并行查询
+# 并行查询
openGauss的SMP并行技术是一种利用计算机多核CPU架构来实现多线程并行计算，以充分利用CPU资源来提高查询性能的技术。在复杂查询场景中，单个查询的执行较长，系统并发度低，通过SMP并行执行技术实现算子级的并行，能够有效减少查询执行时间，提升查询性能及资源利用率。SMP并行技术的整体实现思想是对于能够并行的查询算子，将数据分片，启动若干个工作线程分别计算，最后将结果汇总，返回前端。SMP并行执行增加数据交互算子（Stream），实现多个工作线程之间的数据交互，确保查询的正确性，完成整体的查询。
@@ -87,7 +87,7 @@ SMP架构是一种利用富余资源来换取时间的方案，计划并行之
openGauss=# SET query_dop = 1;
```
- > **说明：**
+ > **说明：**
>- 资源许可的情况下，并行度越高，性能提升效果越好。
>- SMP并行度支持会话级设置，推荐客户在执行符合要求的查询前，打开smp，执行结束后，关闭smp。以免在业务峰值时，对业务造成冲击。
diff --git "a/content/zh/docs/BriefTutorial/\346\211\271\345\244\204\347\220\206\346\250\241\345\274\217.md" "b/content/zh/docs/BriefTutorial/\346\211\271\345\244\204\347\220\206\346\250\241\345\274\217.md"
index 3e427b340a59a070524be57a380d237986c7e540..1bd6182615ea0c0ee57921136a4128b11f9253fe 100644
--- "a/content/zh/docs/BriefTutorial/\346\211\271\345\244\204\347\220\206\346\250\241\345\274\217.md"
+++ "b/content/zh/docs/BriefTutorial/\346\211\271\345\244\204\347\220\206\346\250\241\345\274\217.md"
@@ -1,4 +1,4 @@
-# 批处理模式
+# 批处理模式
openGauss支持从文本文件执行SQL语句。openGauss提供了gsql工具实现SQL语句的批量处理。
diff --git "a/content/zh/docs/BriefTutorial/\346\225\260\346\215\256\347\261\273\345\236\213.md" "b/content/zh/docs/BriefTutorial/\346\225\260\346\215\256\347\261\273\345\236\213.md"
index 0901b0691eb9522cc849ac007b17b1b08d3528a5..e3e2ebc12abd24b10e03e3ef85555002fb1600ee 100644
--- "a/content/zh/docs/BriefTutorial/\346\225\260\346\215\256\347\261\273\345\236\213.md"
+++ "b/content/zh/docs/BriefTutorial/\346\225\260\346\215\256\347\261\273\345\236\213.md"
@@ -1,4 +1,4 @@
-# 数据类型
+# 数据类型
## 数值类型
@@ -329,7 +329,7 @@ openGauss支持的字符类型请参见[表6](#zh-cn_topic_0283136755_zh-cn_topi
-> **说明：**
+> **说明：**
>
>- 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-1字节，主要受列的控制头信息、元组控制头信息以及元组中是否存在NULL字段等影响。
>- NCHAR为bpchar类型的别名，NCHAR\(n\)为b\(n\)类型bpchar\(n\)的别名。
@@ -435,7 +435,7 @@ openGauss支持的二进制类型请参见[表8](#zh-cn_topic_0283136911_zh-cn_t
-> **说明：**
+> **说明：**
>
>- 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-8203字节（即1073733621字节）。
>- 不支持直接使用BYTEAWITHOUTORDERWITHEQUALCOL和BYTEAWITHOUTORDERCOL，\_BYTEAWITHOUTORDERWITHEQUALCOL，\_BYTEAWITHOUTORDERCOL类型创建表。
@@ -444,7 +444,7 @@ openGauss支持的二进制类型请参见[表8](#zh-cn_topic_0283136911_zh-cn_t
openGauss支持的日期/时间类型请参见[表9](#zh-cn_topic_0283136973_zh-cn_topic_0237121952_zh-cn_topic_0059779229_zh-cn_topic_0058965827_table60826369)。
-> **说明：**
+> **说明：**
>如果其他的数据库时间格式和openGauss的时间格式不一致，可通过修改配置参数DateStyle的值来保持一致。
**表 9** 日期/时间类型
@@ -908,7 +908,7 @@ openGauss支持两种位串类型：bit\(n\)和bit varying\(n\)，这里的n是
bit类型的数据必须准确匹配长度n，如果存储短或者长的数据都会报错。bit varying类型的数据是最长为n的变长类型，超过n的类型会被拒绝。一个没有长度的bit等效于bit\(1\)，没有长度的bit varying表示没有长度限制。
-> **说明：**
+> **说明：**
>如果用户明确地把一个位串值转换成bit\(n\)，则此位串右边的内容将被截断或者在右边补齐零，直到刚好n位，而不会抛出任何错误。
>如果用户明确地把一个位串数值转换成bit varying\(n\)，如果它超过了n位，则它的右边将被截断。
@@ -1191,7 +1191,7 @@ openGauss内存在两种数据类型JSON和JSONB，可以用来存储JSON数据
select '{"foo": [true, "bar"], "tags": {"a": 1, "b": null}}'::jsonb;
```
- > **注意：**
+ > **注意：**
>
>- 区分 'null'::json 和 null::json 是两个不同的概念，类似于字符串 str="" 和 str=null。
>- 对于数字，当使用科学计数法的时候，jsonb类型会将其展开，而json会精准拷贝输入。
@@ -1249,7 +1249,7 @@ openGauss内存在两种数据类型JSON和JSONB，可以用来存储JSON数据
- array-jsonb类型：长度长的 \> 长度短的，长度相等则依次比较每个元素。
- object-jsonb类型：长度长的 \> 长度短的，长度相等则依次比较每个键值对，先比较键，在比较值。
- > **注意：**
+ > **注意：**
>object-jsonb类型内比较时，比较时使用的是格式整理后的最终结果进行比较，因此相对于我们直接的输入未必会很直观。
- 创建索引、主外键
@@ -1342,7 +1342,7 @@ HLL与其他算法的比较请参见[表13](#table55621821164213)。
HLL在计算速度和所占存储空间上都占优势。在时间复杂度上，Sort算法需要排序至少O\(nlogn\)的时间，虽说Hash算法和HLL一样扫描一次全表O\(n\)的时间就可以得出结果，但是存储空间上，Sort算法和Hash算法都需要先把原始数据存起来再进行统计，会导致存储空间消耗巨大，而对HLL来说不需要存原始数据，只需要维护HLL数据结构，故占用空间有很大的压缩，默认规格下HLL数据结构的最大空间约为16KB。
-> **须知：**
+> **须知：**
>
>- 当前默认规格下可计算最大distinct值的数量约为1.1e+15个，误差率为0.8%。用户应注意如果计算结果超过当前规格下distinct最大值会导致计算结果误差率变大，或导致计算结果失败并报错。
>- 用户在首次使用该特性时，应该对业务的distinct value做评估，选取适当的配置参数并做验证，以确保精度符合要求：
@@ -1370,7 +1370,7 @@ HLL中主要的数据结构，请参见[表14](#table18186113885012)。
创建HLL数据类型时，可以支持0\~4个参数入参，具体的参数含义与参数规格同函数hll\_empty一致。第一个参数为log2m，表示分桶数的对数值，取值范围10\~16；第二个参数为log2explicit，表示Explicit模式的阈值大小，取值范围0\~12；第三个参数为log2sparse，表示Sparse模式的阈值大小，取值范围0\~14；第四个参数为duplicatecheck，表示是否启用duplicatecheck，取值范围为0\~1。当入参输入值为-1时，会采用默认值设定HLL的参数。可以通过\\d或\\d+查看HLL类型的参数。
-> **说明：**
+> **说明：**
>创建HLL数据类型时，根据入参的行为不同，结果不同：
>
>- 创建HLL类型时对应入参不输入或输入-1，采用默认值设定对应的HLL参数。
@@ -1410,7 +1410,7 @@ openGauss=# create table t4(id int, set hll(5,-1));
ERROR: log2m = 5 is out of range, it should be in range 10 to 16, or set -1 as default
```
-> **说明：**
+> **说明：**
>对含有HLL类型的表插入HLL对象时，HLL类型的设定参数须同插入对象的设定参数一致，否则报错。
```
@@ -2233,7 +2233,7 @@ xmlconcat
(1 row)
```
-> **说明：**
+> **说明：**
>
>- 该功能默认未开启，如需使用，需要重新使用build.sh脚本编译数据库，修改./configure配置参数，在其中加入--with-libxml参数。
>- 在执行编译之前，需要先执行yum install -y libxml2-devel，否则会有"configure: error: library 'xml2' \(version \>= 2.6.23\) is required for XML support"的报错。
diff --git "a/content/zh/docs/BriefTutorial/\346\227\266\351\227\264-\346\227\245\346\234\237\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" "b/content/zh/docs/BriefTutorial/\346\227\266\351\227\264-\346\227\245\346\234\237\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md"
index 63be4b11bb592a00fb98b6721052af98b97fee54..a7748298379cc60be2f25aafee8b36c9d90e2891 100644
--- "a/content/zh/docs/BriefTutorial/\346\227\266\351\227\264-\346\227\245\346\234\237\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md"
+++ "b/content/zh/docs/BriefTutorial/\346\227\266\351\227\264-\346\227\245\346\234\237\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md"
@@ -1,4 +1,4 @@
-# 时间/日期函数和操作符
+# 时间/日期函数和操作符
## 时间日期操作符
@@ -736,7 +736,7 @@ SELECT date '2001-10-01' - '7' AS RESULT;
timestampdiff函数是计算两个日期时间之间\(timestamp\_expr2-timestamp\_expr1\)的差值，并以unit形式返回结果。timestamp\_expr1，timestamp\_expr2必须是一个timestamp、timestamptz、date类型的值表达式。unit表示的是两个日期差的单位。
-> **说明：**
+> **说明：**
>该函数仅在openGauss兼容MY类型时（即dbcompatibility = 'B'）有效，其他类型不支持该函数。
@@ -1003,7 +1003,7 @@ extract函数从日期或时间的数值里抽取子域，比如年、小时等
星期一为1，星期天为7。
- > **说明：**
+ > **说明：**
>除了星期天外，都与dow相同。
```
@@ -1420,7 +1420,7 @@ openGauss=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
-> **说明：**
+> **说明：**
>上表中RR计算年的规则如下：
>
>- 输入的两位年份在00\~49之间：
diff --git "a/content/zh/docs/BriefTutorial/\346\235\203\351\231\220.md" "b/content/zh/docs/BriefTutorial/\346\235\203\351\231\220.md"
index 7c5f7c56100bcec504fa3835a2f259615b4ebb95..9ff1699c40d0e59e05d6a2eff13023a2e4bf9646 100644
--- "a/content/zh/docs/BriefTutorial/\346\235\203\351\231\220.md"
+++ "b/content/zh/docs/BriefTutorial/\346\235\203\351\231\220.md"
@@ -1,4 +1,4 @@
-# 权限
+# 权限
数据库对象创建后，进行对象创建的用户就是该对象的所有者。数据库安装后的默认情况下，未开启三权分立，数据库系统管理员具有与对象所有者相同的权限。也就是说对象创建后，默认只有对象所有者或者系统管理员可以查询、修改和销毁对象，以及通过[•GRANT](#li9428175732017)将对象的权限授予其他用户。
@@ -100,7 +100,7 @@ openGauss支持以下的权限，不同的权限与不同的对象类型关联
[ WITH GRANT OPTION ];
```
- > **说明：**
+ > **说明：**
>将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 同名模式下创建表的权限无法通过此语法赋予，可以通过将角色的权限赋予其他用户或角色的语法，赋予同名模式下创建表的权限。
- 将表空间的访问权限赋予指定的用户或角色。
diff --git "a/content/zh/docs/BriefTutorial/\346\237\245\347\234\213\345\257\271\350\261\241.md" "b/content/zh/docs/BriefTutorial/\346\237\245\347\234\213\345\257\271\350\261\241.md"
index 430c6ea9a2ee4e16f73247c655de7c294d785e9c..863dad3ae40ab8f4a8e05855e2b4f6be02dceab5 100644
--- "a/content/zh/docs/BriefTutorial/\346\237\245\347\234\213\345\257\271\350\261\241.md"
+++ "b/content/zh/docs/BriefTutorial/\346\237\245\347\234\213\345\257\271\350\261\241.md"
@@ -1,4 +1,4 @@
-# 查看对象
+# 查看对象
gsql工具提供了若干高级特性，便于用户使用。常见用法如下：
@@ -13,7 +13,7 @@ gsql工具提供了若干高级特性，便于用户使用。常见用法如下
```
openGauss=# \h ABORT
Command: ABORT
- AboutopenGauss: abort the current transaction
+ Description: abort the current transaction
Syntax:
ABORT [ WORK | TRANSACTION ] ;
```
diff --git "a/content/zh/docs/BriefTutorial/\346\250\241\345\274\217\345\214\271\351\205\215\346\223\215\344\275\234\347\254\246.md" "b/content/zh/docs/BriefTutorial/\346\250\241\345\274\217\345\214\271\351\205\215\346\223\215\344\275\234\347\254\246.md"
index dc0a34cffeb21632759dcb18da3347984b724a2b..eae9db86d4c572e3a6768dbde6a970e203b2a27a 100644
--- "a/content/zh/docs/BriefTutorial/\346\250\241\345\274\217\345\214\271\351\205\215\346\223\215\344\275\234\347\254\246.md"
+++ "b/content/zh/docs/BriefTutorial/\346\250\241\345\274\217\345\214\271\351\205\215\346\223\215\344\275\234\347\254\246.md"
@@ -1,4 +1,4 @@
-# 模式匹配操作符
+# 模式匹配操作符
数据库提供了三种独立的实现模式匹配的方法：SQL LIKE操作符、SIMILAR TO操作符和POSIX-风格的正则表达式。除了这些基本的操作符外，还有一些函数可用于提取或替换匹配子串并在匹配位置分离一个串。
@@ -13,7 +13,7 @@
3. 要匹配文本里的下划线或者百分号，在提供的模式里相应字符必须前导逃逸字符。逃逸字符的作用是禁用元字符的特殊含义，缺省的逃逸字符是反斜线，也可以用ESCAPE子句指定一个不同的逃逸字符。
4. 要匹配逃逸字符本身，写两个逃逸字符。例如要写一个包含反斜线的模式常量，那你就要在SQL语句里写两个反斜线。
- > **说明：**
+ > **说明：**
>参数standard\_conforming\_strings设置为off时，在文串常量中写的任何反斜线都需要被双写。因此，写一个匹配单个反斜线的模式实际上要在语句里写四个反斜线（你可以通过用ESCAPE选择一个不同的逃逸字符来避免这种情况，这样反斜线就不再是LIKE的特殊字符了。但仍然是字符文本分析器的特殊字符，所以你还是需要两个反斜线）。
>在兼容MYSQL数据模式时，您也可以通过写ESCAPE ''的方式不选择逃逸字符，这样可以有效地禁用逃逸机制，但是没有办法关闭下划线和百分号在模式中的特殊含义。
diff --git "a/content/zh/docs/BriefTutorial/\346\270\270\346\240\207.md" "b/content/zh/docs/BriefTutorial/\346\270\270\346\240\207.md"
index ab4d16fc597567d2f8d1c708ab9bb7bdacad8c80..0c9a9fdc95b1e65586b642b8a0b2c52afc5c88aa 100644
--- "a/content/zh/docs/BriefTutorial/\346\270\270\346\240\207.md"
+++ "b/content/zh/docs/BriefTutorial/\346\270\270\346\240\207.md"
@@ -1,4 +1,4 @@
-# 游标
+# 游标
为了处理SQL语句，存储过程进程分配一段内存区域来保存上下文联系。游标是指向上下文区域的句柄或指针。借助游标，存储过程可以控制上下文区域的变化。
diff --git "a/content/zh/docs/BriefTutorial/\347\211\251\345\214\226\350\247\206\345\233\276.md" "b/content/zh/docs/BriefTutorial/\347\211\251\345\214\226\350\247\206\345\233\276.md"
index cde01a3e980bba7ad639d8a79d09306519fbef91..1d63fe62015117546fc05b056eca5195aa581fd6 100644
--- "a/content/zh/docs/BriefTutorial/\347\211\251\345\214\226\350\247\206\345\233\276.md"
+++ "b/content/zh/docs/BriefTutorial/\347\211\251\345\214\226\350\247\206\345\233\276.md"
@@ -1,4 +1,4 @@
-# 物化视图
+# 物化视图
物化视图是相对普通视图而言的。普通视图是虚拟表，而物化视图实际上就是存储SQL执行语句的结果，可以直接使用数据而不用重复执行查询语句，从而提升性能。
diff --git "a/content/zh/docs/BriefTutorial/\347\256\200\345\215\225\346\225\260\346\215\256\347\256\241\347\220\206.md" "b/content/zh/docs/BriefTutorial/\347\256\200\345\215\225\346\225\260\346\215\256\347\256\241\347\220\206.md"
index 81cd4eaea5f7ced970a22ba9d282c3ee78f33ad3..d01f530750d1114536898952eeeea06673c8b264 100644
--- "a/content/zh/docs/BriefTutorial/\347\256\200\345\215\225\346\225\260\346\215\256\347\256\241\347\220\206.md"
+++ "b/content/zh/docs/BriefTutorial/\347\256\200\345\215\225\346\225\260\346\215\256\347\256\241\347\220\206.md"
@@ -1,4 +1,4 @@
-# 简单数据库管理
+# 简单数据库管理
- **[创建数据库](创建数据库.md)**
diff --git "a/content/zh/docs/BriefTutorial/\347\264\242\345\274\225.md" "b/content/zh/docs/BriefTutorial/\347\264\242\345\274\225.md"
index 6705dda89ea458993ead64f84e1ce8f756cc4796..5b68546e7ccb5d2d36b1f2d228504d254d3e5046 100644
--- "a/content/zh/docs/BriefTutorial/\347\264\242\345\274\225.md"
+++ "b/content/zh/docs/BriefTutorial/\347\264\242\345\274\225.md"
@@ -1,4 +1,4 @@
-# 索引
+# 索引
索引是一个指向表中数据的指针。一个数据库中的索引与一本书的索引目录是非常相似的。
diff --git "a/content/zh/docs/BriefTutorial/\347\264\242\345\274\225\346\216\250\350\215\220.md" "b/content/zh/docs/BriefTutorial/\347\264\242\345\274\225\346\216\250\350\215\220.md"
index 4688767452e456a154b9388ba32b7f3bac8065cb..d554c9b6ab443eded988940cdc41390d4fdf2666 100644
--- "a/content/zh/docs/BriefTutorial/\347\264\242\345\274\225\346\216\250\350\215\220.md"
+++ "b/content/zh/docs/BriefTutorial/\347\264\242\345\274\225\346\216\250\350\215\220.md"
@@ -1,4 +1,4 @@
-# 索引推荐
+# 索引推荐
openGauss的索引推荐的功能，共包含三个子功能：单query索引推荐、虚拟索引和workload级别索引推荐。
diff --git "a/content/zh/docs/BriefTutorial/\347\272\246\346\235\237.md" "b/content/zh/docs/BriefTutorial/\347\272\246\346\235\237.md"
index 6819232f481126e5b1f96c5dd59ad924c7e0bd3c..39f623a7b806966d4c973c1e5dd0236df46abc16 100644
--- "a/content/zh/docs/BriefTutorial/\347\272\246\346\235\237.md"
+++ "b/content/zh/docs/BriefTutorial/\347\272\246\346\235\237.md"
@@ -1,4 +1,4 @@
-# 约束
+# 约束
约束子句用于声明约束，新行或者更新的行必须满足这些约束才能成功插入或更新。如果存在违反约束的数据行为，行为会被约束终止。
diff --git "a/content/zh/docs/BriefTutorial/\350\201\232\351\233\206\345\207\275\346\225\260.md" "b/content/zh/docs/BriefTutorial/\350\201\232\351\233\206\345\207\275\346\225\260.md"
index c0402ba52e4ece5b6b0bd93dffe96bd638698558..a0dc27b52a4ded93f02d4d105d7223a1e9f8e85d 100644
--- "a/content/zh/docs/BriefTutorial/\350\201\232\351\233\206\345\207\275\346\225\260.md"
+++ "b/content/zh/docs/BriefTutorial/\350\201\232\351\233\206\345\207\275\346\225\260.md"
@@ -1,4 +1,4 @@
-# 聚集函数
+# 聚集函数
- sum\(expression\)
diff --git "a/content/zh/docs/BriefTutorial/\350\241\250\350\276\276\345\274\217.md" "b/content/zh/docs/BriefTutorial/\350\241\250\350\276\276\345\274\217.md"
index 8e28812bfc68436800749f9118781db1a4949df4..d403b607f12bf739d096797b1cdda0b2476c0aab 100644
--- "a/content/zh/docs/BriefTutorial/\350\241\250\350\276\276\345\274\217.md"
+++ "b/content/zh/docs/BriefTutorial/\350\241\250\350\276\276\345\274\217.md"
@@ -1,4 +1,4 @@
-# 表达式
+# 表达式
表达式类似一个公式，我们可以将其应用在查询语句中，用来查找数据库中指定条件的结果集。
@@ -32,7 +32,7 @@
expression NOTNULL
- > **须知：**
+ > **须知：**
>不要写expression=NULL或expression<\>\(!=\)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。
- is distinct from/is not distinct from
@@ -149,15 +149,15 @@
注：如果模式tpcds不存在。请创建模式tpcds后，再进行建表操作。
```
- openGauss=# CREATE TABLE tpcds.c_tabl(AboutopenGauss varchar(10), short_AboutopenGauss varchar(10), last_value varchar(10)) ;
+ openGauss=# CREATE TABLE tpcds.c_tabl(Description varchar(10), short_Description varchar(10), last_value varchar(10)) ;
openGauss=# INSERT INTO tpcds.c_tabl VALUES('abc', 'efg', '123');
openGauss=# INSERT INTO tpcds.c_tabl VALUES(NULL, 'efg', '123');
openGauss=# INSERT INTO tpcds.c_tabl VALUES(NULL, NULL, '123');
- openGauss=# SELECT AboutopenGauss, short_AboutopenGauss, last_value, COALESCE(AboutopenGauss, short_AboutopenGauss, last_value) FROM tpcds.c_tabl ORDER BY 1, 2, 3, 4;
- AboutopenGauss | short_AboutopenGauss | last_value | coalesce
+ openGauss=# SELECT Description, short_Description, last_value, COALESCE(Description, short_Description, last_value) FROM tpcds.c_tabl ORDER BY 1, 2, 3, 4;
+ Description | short_Description | last_value | coalesce
-------------+-------------------+------------+----------
abc | efg | 123 | abc
| efg | 123 | efg
@@ -167,7 +167,7 @@
openGauss=# DROP TABLE tpcds.c_tabl;
```
- 如果AboutopenGauss不为NULL，则返回AboutopenGauss的值，否则计算下一个参数short\_AboutopenGauss；如果short\_AboutopenGauss不为NULL，则返回short\_AboutopenGauss的值，否则计算下一个参数last\_value；如果last\_value不为NULL，则返回last\_value的值，否则返回（none）。
+ 如果Description不为NULL，则返回Description的值，否则计算下一个参数short\_Description；如果short\_Description不为NULL，则返回short\_Description的值，否则计算下一个参数last\_value；如果last\_value不为NULL，则返回last\_value的值，否则返回（none）。
```
openGauss=# SELECT COALESCE(NULL,'Hello World');
@@ -464,7 +464,7 @@
如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。
- > **说明：**
+ > **说明：**
>在所有情况下X NOT IN Y等价于NOT\(X IN Y\)。
diff --git "a/content/zh/docs/BriefTutorial/\350\247\206\345\233\276.md" "b/content/zh/docs/BriefTutorial/\350\247\206\345\233\276.md"
index f9e9b9d5c5a5317f7c382335f384c8e5c7c07cc9..0075c3676fecb34a99d496d11ea98b80782344e2 100644
--- "a/content/zh/docs/BriefTutorial/\350\247\206\345\233\276.md"
+++ "b/content/zh/docs/BriefTutorial/\350\247\206\345\233\276.md"
@@ -1,4 +1,4 @@
-# 视图
+# 视图
视图与基本表不同，是一个虚拟的表。数据库中仅存放视图的定义，而不存放视图对应的数据，这些数据仍存放在原来的基本表中。若基本表中的数据发生变化，从视图中查询出的数据也随之改变。从这个意义上讲，视图就像一个窗口，透过它可以看到数据库中用户感兴趣的数据及变化。
diff --git "a/content/zh/docs/BriefTutorial/\350\247\246\345\217\221\345\231\250.md" "b/content/zh/docs/BriefTutorial/\350\247\246\345\217\221\345\231\250.md"
index 7d80e94eb8da8b7ae807279c89ce558a9f9db195..8400c5b0013f4c2600aa575bec08449d16f4b2d2 100644
--- "a/content/zh/docs/BriefTutorial/\350\247\246\345\217\221\345\231\250.md"
+++ "b/content/zh/docs/BriefTutorial/\350\247\246\345\217\221\345\231\250.md"
@@ -1,4 +1,4 @@
-# 触发器
+# 触发器
触发器会在指定的数据库事件发生时自动执行函数。
diff --git "a/content/zh/docs/BriefTutorial/\350\257\255\346\263\225.md" "b/content/zh/docs/BriefTutorial/\350\257\255\346\263\225.md"
index e494960d90e5993c792362788f8a32f4c0c3c62d..4b21184fff1e469910c210378975ce5a0b37c7bb 100644
--- "a/content/zh/docs/BriefTutorial/\350\257\255\346\263\225.md"
+++ "b/content/zh/docs/BriefTutorial/\350\257\255\346\263\225.md"
@@ -1,4 +1,4 @@
-# 语法
+# 语法
默认情况下，数据库安装成功，登录后，可以使用\\help语句查看所有openGauss的SQL语法。
@@ -7,13 +7,13 @@ openGauss=# \help
Available help:
ABORT ALTER TABLE CREATE DATABASE CREATE TEXT SEARCH CONFIGURATION DROP OPERATOR MERGE
ALTER APP WORKLOAD GROUP ALTER TABLE PARTITION CREATE DIRECTORY CREATE TEXT SEARCH DICTIONARY DROP OWNED MOVE
- ALTER APP WORKLOAD GROUP MAPPING ALTER TABLESPACE CREATE ExtensionReference CREATE TRIGGER DROP PACKAGE PREPARE
+ ALTER APP WORKLOAD GROUP MAPPING ALTER TABLESPACE CREATE Extension CREATE TRIGGER DROP PACKAGE PREPARE
ALTER AUDIT POLICY ALTER TEXT SEARCH CONFIGURATION CREATE FOREIGN TABLE CREATE TYPE DROP PACKAGE BODY PREPARE TRANSACTION
ALTER DATA SOURCE ALTER TEXT SEARCH DICTIONARY CREATE FUNCTION CREATE USER DROP PROCEDURE PUBLISH SNAPSHOT
ALTER DATABASE ALTER TRIGGER CREATE GROUP CREATE VIEW DROP RESOURCE LABEL PURGE SNAPSHOT
ALTER DEFAULT PRIVILEGES ALTER TYPE CREATE INDEX CREATE WEAK PASSWORD DICTIONARY DROP RESOURCE POOL REASSIGN OWNED
ALTER DIRECTORY ALTER USER CREATE LANGUAGE CREATE WORKLOAD GROUP DROP ROLE REFRESH MATERIALIZED VIEW
- ALTER ExtensionReference ALTER VIEW CREATE MASKING POLICY CURSOR DROP ROW LEVEL SECURITY POLICY REINDEX
+ ALTER Extension ALTER VIEW CREATE MASKING POLICY CURSOR DROP ROW LEVEL SECURITY POLICY REINDEX
ALTER FOREIGN TABLE ALTER WORKLOAD GROUP CREATE MATERIALIZED VIEW DEALLOCATE DROP SCHEMA RESET
ALTER FOREIGN TABLE FOR HDFS ANALYSE CREATE MODEL DECLARE DROP SEQUENCE REVOKE
ALTER FUNCTION ANALYZE CREATE NODE DELETE DROP SERVER ROLLBACK
@@ -26,7 +26,7 @@ ABORT ALTER TABLE CREATE DATAB
ALTER NODE GROUP CLOSE CREATE RESOURCE POOL DROP DATA SOURCE DROP TYPE SET CONSTRAINTS
ALTER OPERATOR CLUSTER CREATE ROLE DROP DATABASE DROP USER SET ROLE
ALTER RESOURCE LABEL COMMENT CREATE ROW LEVEL SECURITY POLICY DROP DIRECTORY DROP VIEW SET SESSION AUTHORIZATION
- ALTER RESOURCE POOL COMMIT CREATE SCHEMA DROP ExtensionReference DROP WEAK PASSWORD DICTIONARY SET TRANSACTION
+ ALTER RESOURCE POOL COMMIT CREATE SCHEMA DROP Extension DROP WEAK PASSWORD DICTIONARY SET TRANSACTION
ALTER ROLE COMMIT PREPARED CREATE SEQUENCE DROP FOREIGN TABLE DROP WORKLOAD GROUP SHOW
ALTER ROW LEVEL SECURITY POLICY COPY CREATE SERVER DROP FUNCTION END START TRANSACTION
ALTER SCHEMA CREATE APP WORKLOAD GROUP CREATE SNAPSHOT AS DROP GROUP EXECUTE TRUNCATE
@@ -44,7 +44,7 @@ ABORT ALTER TABLE CREATE DATAB
```
openGauss=# \h ABORT
Command: ABORT
-AboutopenGauss: abort the current transaction
+Description: abort the current transaction
Syntax:
ABORT [ WORK | TRANSACTION ] ;
```
diff --git "a/content/zh/docs/BriefTutorial/\350\265\204\346\272\220\346\261\240\345\214\226.md" "b/content/zh/docs/BriefTutorial/\350\265\204\346\272\220\346\261\240\345\214\226.md"
index 56e15c87d6abef8a5a1c4b5139a43c1b12c97b57..cfbb12e4332e1465e5353df58ca1a736630cecd8 100644
--- "a/content/zh/docs/BriefTutorial/\350\265\204\346\272\220\346\261\240\345\214\226.md"
+++ "b/content/zh/docs/BriefTutorial/\350\265\204\346\272\220\346\261\240\345\214\226.md"
@@ -1,4 +1,4 @@
-# 资源池化
+# 资源池化
## 特性简介
@@ -9,7 +9,7 @@
资源池化整体架构图如下所示。
**图 1** 资源池化架构图
-
+
- 磁阵设备并且已经安装ultrapath多路径软件，磁阵设备可用。
- 分布式存储服务DSS（Distributed Storage Service）
@@ -42,7 +42,7 @@
与传统gs\_initdb建库相比，资源池化建库将目录分为三种类型，每实例独占且不共享、每实例独占且共享、所有实例共享。其中需要共享的目录均需存放到磁阵设备上，而不共享的目录存放在本地盘上。另外备机建库只需要建隶属于自己的目录，不需要再次创建所有实例共享的目录结构。资源池化新增了相关GUC参数，以及将系统表存储方式从页式切换到段页式。
-> **说明：**
+> **说明：**
>此处的单步手动安装是指工程编译之后，可单步执行相关命令进行资源池化建库。openGauss常规安装请参照《安装指南》。
- 前置条件
@@ -211,7 +211,7 @@
sh ock_rpc_opengauss.sh
```
- > **说明：**
+ > **说明：**
>实现功能：
>- 完成集群中OCK RPC二进制包的部署，解压和拷贝。
>- 配置好相关的环境变量$OCK\_RPC\_LIB\_PATH。
@@ -231,7 +231,7 @@
2. UCX\_USE\_MT\_MUTEX优化参数，RDMA发送过程中保证数据一致性锁的类型，n:原子锁；y:互斥锁。（可选参数，建议使用原子锁，性能较好）。
3. UCX\_NET\_DEVICES，UCX配置参数，用于指定网卡端口，可安装mlnx\_ofed驱动，使用ibdev2netdev命令查看当前RDMA活动端口。（建议指定活动端口）。
- > **说明：**
+ > **说明：**
>环境变量配置完之后，执行 source \~/.bashrc
@@ -321,7 +321,7 @@ SCRLock，全称smart cached remote lock，是一个带有本地锁缓存的分
5.重新拉起高斯数据库(cm_ctl stop;cm_ctl start)
```
- > **说明：**
+ > **说明：**
>实现功能：
>
>- 完成集群中OCK scrlock二进制包的部署，解压和拷贝。
diff --git "a/content/zh/docs/BriefTutorial/\350\277\220\347\256\227\347\254\246.md" "b/content/zh/docs/BriefTutorial/\350\277\220\347\256\227\347\254\246.md"
index fd638177a489a7224284b10880b1a0a5592eedd9..704271131e8594d9ad6272aed46b9b8a786d5915 100644
--- "a/content/zh/docs/BriefTutorial/\350\277\220\347\256\227\347\254\246.md"
+++ "b/content/zh/docs/BriefTutorial/\350\277\220\347\256\227\347\254\246.md"
@@ -1,4 +1,4 @@
-# 运算符
+# 运算符
openGauss中运算符是一个保留关键字或字符，一般用在WHERE语句中，作为过滤条件。常见运算符如下。
diff --git "a/content/zh/docs/BriefTutorial/\351\224\201.md" "b/content/zh/docs/BriefTutorial/\351\224\201.md"
index 8fc4b3da2264c54240ebfdcf3cfefe1f585ffff6..6aad28917d6dd16540bf8f6b1aea42542913b31f 100644
--- "a/content/zh/docs/BriefTutorial/\351\224\201.md"
+++ "b/content/zh/docs/BriefTutorial/\351\224\201.md"
@@ -1,4 +1,4 @@
-# 锁
+# 锁
如果需要保持数据库数据的一致性，可以使用LOCK TABLE来阻止其他用户修改表。
diff --git "a/content/zh/docs/BriefTutorial/\351\231\204\345\275\225-SQL\350\257\255\346\263\225.md" "b/content/zh/docs/BriefTutorial/\351\231\204\345\275\225-SQL\350\257\255\346\263\225.md"
index 35ee622a4b5a9e336015b37459d1c58f1039773f..65d71008ac80e089671a181c5165d2ea6e378aa0 100644
--- "a/content/zh/docs/BriefTutorial/\351\231\204\345\275\225-SQL\350\257\255\346\263\225.md"
+++ "b/content/zh/docs/BriefTutorial/\351\231\204\345\275\225-SQL\350\257\255\346\263\225.md"
@@ -1,4 +1,4 @@
-# 附录：SQL语法
+# 附录：SQL语法
## ABORT
diff --git "a/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\346\225\260\346\215\256\347\256\241\347\220\206.md" "b/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\346\225\260\346\215\256\347\256\241\347\220\206.md"
index 3fda48dc6c084b5ef95c65c8a7d4e90dac45690a..8fc8fea0c52dfc82bd38950b2edfa9f8db64d5fc 100644
--- "a/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\346\225\260\346\215\256\347\256\241\347\220\206.md"
+++ "b/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\346\225\260\346\215\256\347\256\241\347\220\206.md"
@@ -1,4 +1,4 @@
-# 高级数据库管理
+# 高级数据库管理
- **[约束](约束.md)**
diff --git "a/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\347\211\271\346\200\247.md" "b/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\347\211\271\346\200\247.md"
index 7d0bcc81518260fe0a12ebe713e19cfe320c15a7..b0215fe6e38f59cd62a53cfe162872dba0cf298c 100644
--- "a/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\347\211\271\346\200\247.md"
+++ "b/content/zh/docs/BriefTutorial/\351\253\230\347\272\247\347\211\271\346\200\247.md"
@@ -1,4 +1,4 @@
-# 高级特性
+# 高级特性
- **[索引推荐](索引推荐.md)**
diff --git a/content/zh/docs/Compilationguide/Compilation.md b/content/zh/docs/CompilationGuide/Compilation.md
similarity index 60%
rename from content/zh/docs/Compilationguide/Compilation.md
rename to content/zh/docs/CompilationGuide/Compilation.md
index dcfe658348a81ce4e0ea2242fc18ec4c32984b7f..3d3f6474724cae42ce4457de3779b5052d95ebb6 100644
--- a/content/zh/docs/Compilationguide/Compilation.md
+++ b/content/zh/docs/CompilationGuide/Compilation.md
@@ -1,6 +1,6 @@
-# 编译指导书
+# 编译指导书
-## 概述
+## 概述
本文档介绍了openGauss对于操作系统的要求、编译环境的要求、软件依赖、编译方法以及编译结果的存放位置等。
diff --git a/content/zh/docs/Compilationguide/FAQ.md b/content/zh/docs/CompilationGuide/FAQ.md
similarity index 97%
rename from content/zh/docs/Compilationguide/FAQ.md
rename to content/zh/docs/CompilationGuide/FAQ.md
index 7a85fff2e7e0171cb4c990b7d9ca32174f95305f..10115c6784b0a7f4a9ac0d442f7cb2afe1ddf4f0 100644
--- a/content/zh/docs/Compilationguide/FAQ.md
+++ b/content/zh/docs/CompilationGuide/FAQ.md
@@ -1,4 +1,4 @@
-# FAQ
+# FAQ
## 如何清除编译过程中生成的临时文件
diff --git "a/content/zh/docs/Compilationguide/figures/\347\273\230\345\233\2761.png" b/content/zh/docs/CompilationGuide/figures/Compilation-process.png
similarity index 100%
rename from "content/zh/docs/Compilationguide/figures/\347\273\230\345\233\2761.png"
rename to content/zh/docs/CompilationGuide/figures/Compilation-process.png
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-caution.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-caution.png differ
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-danger.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-danger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-danger.png differ
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-note.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-note.png differ
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-notice.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-notice.png
new file mode 100644
index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-notice.png differ
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-tip.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-tip.png differ
diff --git a/content/zh/docs/CompilationGuide/public_sys-resources/icon-warning.png b/content/zh/docs/CompilationGuide/public_sys-resources/icon-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8
Binary files /dev/null and b/content/zh/docs/CompilationGuide/public_sys-resources/icon-warning.png differ
diff --git "a/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md" "b/content/zh/docs/CompilationGuide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md"
similarity index 98%
rename from "content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md"
rename to "content/zh/docs/CompilationGuide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md"
index 79769bfbbbe1953ccd5a9537a6739ab344d97320..d47d72138a17618838ebe4d2c43132b9b2f95661 100644
--- "a/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md"
+++ "b/content/zh/docs/CompilationGuide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md"
@@ -1,4 +1,4 @@
-# 搭建编译环境
+# 搭建编译环境
## 硬件要求
diff --git "a/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md" "b/content/zh/docs/CompilationGuide/\347\211\210\346\234\254\347\274\226\350\257\221.md"
similarity index 97%
rename from "content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md"
rename to "content/zh/docs/CompilationGuide/\347\211\210\346\234\254\347\274\226\350\257\221.md"
index 9db7722da49eed8f5e4502d361310a0183175e42..cf39a29bb01d7c71c3cc4c931fa04abd048d438c 100644
--- "a/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md"
+++ "b/content/zh/docs/CompilationGuide/\347\211\210\346\234\254\347\274\226\350\257\221.md"
@@ -1,4 +1,4 @@
-# 版本编译
+# 版本编译
@@ -16,7 +16,7 @@ openGauss的编译过程和生成安装包的过程已经写成了一个一键
本章节会介绍openGauss编译需要满足的前提条件，编译的操作步骤等，下图是对编译流程的大致概括，详细内容见下文。
-
+
@@ -39,14 +39,14 @@ openGauss的编译过程和生成安装包的过程已经写成了一个一键
[user@linux sda]$ # mkdir binarylibs 关于此注释步骤，请阅读说明
```
- > **说明：**
+ > **说明：**
>
>- branchname：代码分支名称，缺省可不填，如需编译openGauss 2.1.0的代码，可加上-b 2.1.0的参数。
>- binarylibs：存放编译构建好的开源第三方软件的文件夹，用户可通过[开源软件编译构建](#开源软件编译构建)获取。由于开源软件编译构建耗时长，我们特地使用openGauss-third\_party编译构建出了一份binarylibs并压缩上传到了网上，用户可以直接下载获取。
> 社区提供三个平台编译好的二进制文件。对应各个平台下载地址：\
- **openEuler_arm:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz
- **openEuler_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz
- **Centos_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz
+ **openEuler_arm:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz
+ **openEuler_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz
+ **Centos_x86:** https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz
> 下载完毕后执行解压并重命名 mv openGauss-third_party_binarylibs binarylibs。
@@ -186,7 +186,7 @@ openGauss的编译，需要提前把所依赖的开源第三方软件进行编
即可编译生成openssl
- > **说明：**
+ > **说明：**
>
>相关的报错日志可以查看对应的build目录下对应名字的log以及对应模块下的log，如dependency模块下的openssl的相关编译安装日志可以查看：
>
@@ -266,7 +266,7 @@ openGauss-server/build.sh是编译过程中的重要脚本工具。其集成了
-> **说明：**
+> **说明：**
>
>- -m \[debug | release | memcheck\]表示可选择三种目标版本：
>
@@ -374,7 +374,7 @@ openGauss-server/build.sh是编译过程中的重要脚本工具。其集成了
./configure --gcc-version=7.3.0 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib --enable-memory-check
```
- > **说明：**
+ > **说明：**
>
>- _\[debug | release | memcheck\]_ 表示可选择三种目标版本，三种目标版本如下所示：
>
@@ -413,7 +413,7 @@ openGauss-server/build.sh是编译过程中的重要脚本工具。其集成了
## openGauss-OM编译
-源码编译完openGauss-server代码仓之后，并没有gs_om。如需使用gs_om，需单独编译openGauss-OM，并将编译好的openGauss-xxx-om.tar.gz的包拷贝到openGauss-server安装包所在的目录，再按照[企业版]( https://opengauss.org/zh/docs/latest/docs/InstallationGuide/%E4%BC%81%E4%B8%9A%E7%89%88%E5%AE%89%E8%A3%85.html )的方式进行安装。
+源码编译完openGauss-server代码仓之后，并没有gs_om。如需使用gs_om，需单独编译openGauss-OM，并将编译好的openGauss-xxx-om.tar.gz的包拷贝到openGauss-server安装包所在的目录，再按照[企业版]( https://docs.opengauss.org/zh/docs/5.0.0/docs/InstallationGuide/%E4%BC%81%E4%B8%9A%E7%89%88%E5%AE%89%E8%A3%85.html )的方式进行安装。
### 操作步骤
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-caution.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-caution.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-caution.gif and /dev/null differ
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-danger.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-danger.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-danger.gif and /dev/null differ
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-note.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-note.gif
deleted file mode 100644
index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-note.gif and /dev/null differ
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-notice.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-notice.gif
deleted file mode 100644
index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-notice.gif and /dev/null differ
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-tip.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-tip.gif
deleted file mode 100644
index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-tip.gif and /dev/null differ
diff --git a/content/zh/docs/Compilationguide/public_sys-resources/icon-warning.gif b/content/zh/docs/Compilationguide/public_sys-resources/icon-warning.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/Compilationguide/public_sys-resources/icon-warning.gif and /dev/null differ
diff --git "a/content/zh/docs/DataBaseReference/AI\347\211\271\346\200\247_GUC.md" "b/content/zh/docs/DataBaseReference/AI\347\211\271\346\200\247_GUC.md"
deleted file mode 100644
index e1ae341a55506df6e58c816fdfc5da17f8447b8d..0000000000000000000000000000000000000000
--- "a/content/zh/docs/DataBaseReference/AI\347\211\271\346\200\247_GUC.md"
+++ /dev/null
@@ -1,58 +0,0 @@
-# AI特性
-
-## enable\_hypo\_index
-
-**参数说明：**该参数控制数据库的优化器进行EXPLAIN时是否考虑创建虚拟索引。通过对特定的查询语句执行explain，用户可根据优化器给出的执行计划评估该索引是否能够提升该查询语句的执行效率。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**布尔型
-
-- on表示在进行EXPLAIN时创建虚拟索引。
-- off表示在进行EXPLAIN时不创建虚拟索引。
-
-**默认值：**off
-
-## db4ai\_snapshot\_mode
-
-**参数说明：**snapshot有2种模式：MSS（物化模式，存储数据实体）和CSS（计算模式，存储增量信息）。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**字符串，MSS/CSS
-
-- MSS表示物化模式，db4ai在创建快照的时候存储数据实体。
-- CSS表示计算模式，db4ai在创建快照的时候存储增量信息。
-
-**默认值：**MSS
-
-## db4ai\_snapshot\_version\_delimiter
-
-**参数说明：**该参数为数据表快照版本分隔符。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**字符串，长度大于0
-
-**默认值：**@
-
-## db4ai\_snapshot\_version\_separator
-
-**参数说明：**该参数用于指定数据表快照子版本分隔符。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**字符串，长度大于0
-
-**默认值：**.
-
-## unix\_socket\_directory
-
-**参数说明：**用于指定unix\_socket通信方式中，文件存放的路径。此参数只能在配置文件postgresql.conf中指定。再启动fenced模式前需要设定该GUC参数。
-
-该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**字符串，长度大于等于0
-
-**默认值：**''
-
diff --git "a/content/zh/docs/DataBaseReference/CM\347\233\270\345\205\263\345\217\202\346\225\260.md" "b/content/zh/docs/DataBaseReference/CM\347\233\270\345\205\263\345\217\202\346\225\260.md"
deleted file mode 100644
index bd072c175c206e4fd89b68b236f32680619cfe2f..0000000000000000000000000000000000000000
--- "a/content/zh/docs/DataBaseReference/CM\347\233\270\345\205\263\345\217\202\346\225\260.md"
+++ /dev/null
@@ -1,9 +0,0 @@
-# CM相关参数
-
-CM相关参数的修改对GaussDB Kernel的运行机制有影响，建议由GaussDB Kernel的工程师协助修改。修改CM相关参数的方法，请参考[表2](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中方式一进行设置。
-
-- **[cm\_agent参数](cm_agent参数.md)**
-
-- **[cm\_server参数](cm_server参数.md)**
-
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-01481----GAUSS-01490.md b/content/zh/docs/DataBaseReference/GAUSS-01481----GAUSS-01490.md
deleted file mode 100644
index 7fa875e25417e7550d057a8aacf13ce4524ea787..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-01481----GAUSS-01490.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# GAUSS-01481 -- GAUSS-01490
-
-GAUSS-01481: "parameter '%s' cannot be set in a secondary ExtensionReference control file"
-
-SQLSTATE: 42601
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在secondary control file中指定了default\_version或者directory参数。
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，不能在secondary control file中指定default\_version或者directory参数。
-
-GAUSS-01482: "parameter '%s' requires a Boolean value"
-
-SQLSTATE: 22023
-
-错误原因：\(1\)CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中没有给参数relocatable/sysadmin指定一个BOOL值。
-
-解决办法：\(1\)CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中，必须给参数relocatable/sysadmin指定一个BOOL值。
-
-GAUSS-01483: "'%s' is not a valid encoding name"
-
-SQLSTATE: 42704
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中没有给参数encoding指定一个合法的encoding名称。
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中必须给参数encoding指定一个合法的encoding名称。
-
-GAUSS-01484: "parameter '%s' must be a list of ExtensionReference names"
-
-SQLSTATE: 22023
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中没有给参数requires指定a list of ExtensionReference names
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中必须给参数requires指定a list of ExtensionReference names
-
-GAUSS-01485: "unrecognized parameter '%s' in file '%s'"
-
-SQLSTATE: 42601
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中指定了非法参数。
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中仅可指定如下参数。directory/default\_version/module\_pathname/comment/schema/relocatable/sysadmin/encoding/requires。
-
-GAUSS-01486: "parameter 'schema' cannot be specified when 'relocatable' is true"
-
-SQLSTATE: 42601
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中，当指定relocatable为true时，同时又指定了schema参数。
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时或执行ExtensionReference相关的系统函数时，在控制文件中，当指定relocatable为true时，不能再指定了schema参数。
-
-GAUSS-01487: "transaction control statements are not allowed within an ExtensionReference script"
-
-SQLSTATE: 0A000
-
-错误原因：CREATE ExtensionReference时或ALTER ExtensionReference时，ExtensionReference的SQL脚本文件中出现了控制事务的SQL语句。
-
-解决办法：CREATE ExtensionReference时或ALTER ExtensionReference时，ExtensionReference的SQL脚本文件中不能使用控制事务的SQL语句。
-
-GAUSS-01488: "permission denied to create ExtensionReference '%s'"
-
-SQLSTATE: 42501
-
-错误原因：CREATE ExtensionReference时，ExtensionReference的控制文件要求必须以系统管理员权限运行，但是实际帐户不是系统管理员。
-
-解决办法：CREATE ExtensionReference时，ExtensionReference的控制文件要求必须以系统管理员权限运行，则实际帐户也必须是系统管理员。
-
-GAUSS-01489: "permission denied to update ExtensionReference '%s'"
-
-SQLSTATE: 42501
-
-错误原因：ALTER ExtensionReference时，ExtensionReference的控制文件要求必须以系统管理员权限运行，但是实际帐户不是系统管理员。
-
-解决办法：ALTER ExtensionReference时，ExtensionReference的控制文件要求必须以系统管理员权限运行，则实际帐户也必须是系统管理员。
-
-GAUSS-01490: "ExtensionReference '%s' has no update path from version '%s' to version '%s'"
-
-SQLSTATE: 22023
-
-错误原因：CREATE ExtensionReference/ALTER ExtensionReference时，不存在从旧版本到新版本的更新路径。
-
-解决办法：CREATE ExtensionReference/ALTER ExtensionReference时，如果有版本FROM old\_version、UPDATE TO new\_version，确保新旧版本号对应的SQL文件名称和路径的正确性。
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-01491----GAUSS-01500.md b/content/zh/docs/DataBaseReference/GAUSS-01491----GAUSS-01500.md
deleted file mode 100644
index d509f92cc97e213e2318a5fb4bcd0c1157947275..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-01491----GAUSS-01500.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# GAUSS-01491 -- GAUSS-01500
-
-GAUSS-01492: "nested CREATE ExtensionReference is not supported"
-
-SQLSTATE: 0A000
-
-错误原因：CREATE ExtensionReference时，SQL中嵌套创建ExtensionReference。
-
-解决办法：CREATE ExtensionReference时，SQL中不允许嵌套创建ExtensionReference。
-
-GAUSS-01493: "unrecognized option: %s"
-
-SQLSTATE: XX000
-
-错误原因：系统内部错误。
-
-解决办法：请联系技术支持工程师提供技术支持。
-
-GAUSS-01494: "version to install must be specified"
-
-SQLSTATE: 22023
-
-错误原因：CREATE/ALTER ExtensionReference时，既没有指定new version，控制文件中也没有指定default version。
-
-解决办法：CREATE/ALTER ExtensionReference时，要么指定new version，要么在控制文件中指定default version。
-
-GAUSS-01495: "FROM version must be different from InstallationGuide target version '%s'"
-
-SQLSTATE: 22023
-
-错误原因：CREATE ExtensionReference时，FROM版本号和VERSION版本号指定的版本号相同。
-
-解决办法：CREATE ExtensionReference时，FROM版本号和VERSION版本号指定的版本号必须不同。
-
-GAUSS-01496: "ExtensionReference '%s' must be installed in schema '%s'"
-
-SQLSTATE: 0A000
-
-错误原因：CREATE ExtensionReference时，WITH SCHEMA指定的schema和控制文件中指定的schema不同。
-
-解决办法：CREATE ExtensionReference时，WITH SCHEMA指定的schema必须与控制文件中指定的schema相同。
-
-GAUSS-01497: "there is no default creation target"
-
-SQLSTATE: XX000
-
-错误原因：CREATE ExtensionReference语法中当不指定SCHEMA选项时，默认当前缺省的SCHEMA，但当前缺省的SCHEMA路径为空值。
-
-解决办法：当前缺省的SCHEMA为空，当前系统存在异常或存在人为删除当前SCHEMA的目录导致，请联系技术支持工程师提供技术支持。
-
-GAUSS-01498: "required ExtensionReference '%s' is not installed"
-
-SQLSTATE: 42704
-
-错误原因：CREATE ExtensionReference/ALTER ExtensionReference时，控制文件中指定的依赖的某个ExtensionReference尚未安装。
-
-解决办法：CREATE ExtensionReference/ALTER ExtensionReference时，控制文件中指定的所有ExtensionReference必须已经安装，已安装的ExtensionReference可以通过\\dx查看。
-
-GAUSS-01499: "cannot drop ExtensionReference '%s' because it is being modified"
-
-SQLSTATE: 55000
-
-错误原因：DROP ExtensionReference时，ExtensionReference正在被别的session修改。
-
-解决办法：DROP ExtensionReference时，ExtensionReference不能正在被别的session修改。
-
-GAUSS-01500: "pg\_ExtensionReference\_config\_dump\(\) can only be called from an SQL script executed by CREATE ExtensionReference"
-
-SQLSTATE: 0A000
-
-错误原因：pg\_ExtensionReference\_config\_dump没有在CREATE ExtensionReference的SQL脚本文件中执行。
-
-解决办法：pg\_ExtensionReference\_config\_dump只能在CREATE ExtensionReference的SQL脚本文件中执行。
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-01501----GAUSS-01510.md b/content/zh/docs/DataBaseReference/GAUSS-01501----GAUSS-01510.md
deleted file mode 100644
index c4480d72c4244b60911b76276cf4d1e32cd554f4..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-01501----GAUSS-01510.md
+++ /dev/null
@@ -1,66 +0,0 @@
-# GAUSS-01501 -- GAUSS-01510
-
-GAUSS-01501: "OID %u does not refer to a table"
-
-SQLSTATE: 42P01
-
-错误原因：pg\_ExtensionReference\_config\_dump\(\)函数的参数1不是pg\_class内定义的表。
-
-解决办法：pg\_ExtensionReference\_config\_dump\(\)函数的参数1必须是pg\_class内定义的表。
-
-GAUSS-01502: "table '%s' is not a member of the ExtensionReference being created"
-
-SQLSTATE: 55000
-
-错误原因：pg\_ExtensionReference\_config\_dump\(\)函数的参数1不是正在创建的ExtensionReference的成员。
-
-解决办法：pg\_ExtensionReference\_config\_dump\(\)函数的参数1必须是正在创建的ExtensionReference的成员。
-
-GAUSS-01503: "ExtensionReference with oid %u does not exist"
-
-SQLSTATE: XX000
-
-错误原因：根据当前ExtensionReference对象的OID从Cache中查找系统表pg\_ExtensionReference的tuple错误。
-
-解决办法：由于系统Cache存在异常导致根据ExtensionReference对象OID从Cache获取对象tuple失败，请联系技术支持工程师提供技术支持。
-
-GAUSS-01504: "extconfig is not a 1-D Oid array"
-
-SQLSTATE: XX000
-
-错误原因：系统内部错误。
-
-解决办法：请联系技术支持工程师提供技术支持。
-
-GAUSS-01505: "extconfig and extcondition arrays do not match"
-
-SQLSTATE: XX000
-
-错误原因：系统内部错误。
-
-解决办法：请联系技术支持工程师提供技术支持。
-
-GAUSS-01507: "ExtensionReference name cannot be qualified"
-
-SQLSTATE: 42601
-
-错误原因：ALTER ExtensionReference SET SCHEMA，指定ExtensionReference名称时，ExtensionReference的前面加了schema名称。
-
-解决办法：ALTER ExtensionReference SET SCHEMA，指定ExtensionReference名称时，ExtensionReference的前面不可以加schema名称。
-
-GAUSS-01508: "cannot move ExtensionReference '%s' into schema '%s' because the ExtensionReference contains the schema"
-
-SQLSTATE: 55000
-
-错误原因：ALTER ExtensionReference SET SCHEMA，新的schema是当前ExtensionReference的成员。
-
-解决办法：ALTER ExtensionReference SET SCHEMA，新的schema不可以是当前ExtensionReference的成员。
-
-GAUSS-01509: "ExtensionReference '%s' does not support SET SCHEMA"
-
-SQLSTATE: 0A000
-
-错误原因：ALTER ExtensionReference SET SCHEMA，当前ExtensionReference的relocatable参数为false。
-
-解决办法：只对ExtensionReference的relocatable参数为true的ExtensionReference执行ALTER ExtensionReference SET SCHEMA。
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-01991----GAUSS-02000.md b/content/zh/docs/DataBaseReference/GAUSS-01991----GAUSS-02000.md
deleted file mode 100644
index 3c5b2170f40dc66efe7088aab4c4b158cbe9bcab..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-01991----GAUSS-02000.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-01991 -- GAUSS-02000
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-02001----GAUSS-02010.md b/content/zh/docs/DataBaseReference/GAUSS-02001----GAUSS-02010.md
deleted file mode 100644
index 2f7ad179d883d76418a203a1062de25d69038baa..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-02001----GAUSS-02010.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-02001 -- GAUSS-02010
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-02051----GAUSS-02060.md b/content/zh/docs/DataBaseReference/GAUSS-02051----GAUSS-02060.md
deleted file mode 100644
index 6189a3ed1023ff57b9a49fd752f159eb06d3734a..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-02051----GAUSS-02060.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-02051 -- GAUSS-02060
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-04181----GAUSS-04190.md b/content/zh/docs/DataBaseReference/GAUSS-04181----GAUSS-04190.md
deleted file mode 100644
index 38a8809cc4616b9b0a4bd40e597152c538c406c2..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-04181----GAUSS-04190.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-04181 -- GAUSS-04190
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-04451----GAUSS-04460.md b/content/zh/docs/DataBaseReference/GAUSS-04451----GAUSS-04460.md
deleted file mode 100644
index 111ddc63d0b2ec2584bc67d0e60f755424bf2158..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-04451----GAUSS-04460.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-04451 -- GAUSS-04460
-
diff --git a/content/zh/docs/DataBaseReference/GAUSS-04671----GAUSS-04680.md b/content/zh/docs/DataBaseReference/GAUSS-04671----GAUSS-04680.md
deleted file mode 100644
index 5af2a132aadaf2b1f7958722d1651fba546fa2fb..0000000000000000000000000000000000000000
--- a/content/zh/docs/DataBaseReference/GAUSS-04671----GAUSS-04680.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# GAUSS-04671 -- GAUSS-04680
-
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-caution.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-caution.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-caution.gif and /dev/null differ
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-danger.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-danger.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-danger.gif and /dev/null differ
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-note.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-note.gif
deleted file mode 100644
index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-note.gif and /dev/null differ
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-notice.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-notice.gif
deleted file mode 100644
index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-notice.gif and /dev/null differ
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-tip.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-tip.gif
deleted file mode 100644
index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-tip.gif and /dev/null differ
diff --git a/content/zh/docs/DataBaseReference/public_sys-resources/icon-warning.gif b/content/zh/docs/DataBaseReference/public_sys-resources/icon-warning.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DataBaseReference/public_sys-resources/icon-warning.gif and /dev/null differ
diff --git "a/content/zh/docs/DataBaseReference/\347\211\210\346\234\254\345\222\214\345\271\263\345\217\260\345\205\274\345\256\271\346\200\247 - \345\211\257\346\234\254.md" "b/content/zh/docs/DataBaseReference/\347\211\210\346\234\254\345\222\214\345\271\263\345\217\260\345\205\274\345\256\271\346\200\247 - \345\211\257\346\234\254.md"
deleted file mode 100644
index 3b2cc4faa2229e98dca3bbe5f37242e52004a26f..0000000000000000000000000000000000000000
--- "a/content/zh/docs/DataBaseReference/\347\211\210\346\234\254\345\222\214\345\271\263\345\217\260\345\205\274\345\256\271\346\200\247 - \345\211\257\346\234\254.md"
+++ /dev/null
@@ -1,7 +0,0 @@
-# 版本和平台兼容性
-
-- **[历史版本兼容性](历史版本兼容性.md)**
-
-- **[平台和客户端兼容性](平台和客户端兼容性.md)**
-
-
diff --git "a/content/zh/docs/DataBaseReference/\351\200\232\344\277\241\345\272\223\345\217\202\346\225\260.md" "b/content/zh/docs/DataBaseReference/\351\200\232\344\277\241\345\272\223\345\217\202\346\225\260.md"
deleted file mode 100644
index 0989c73d21204d62012163642b75825d5412ee55..0000000000000000000000000000000000000000
--- "a/content/zh/docs/DataBaseReference/\351\200\232\344\277\241\345\272\223\345\217\202\346\225\260.md"
+++ /dev/null
@@ -1,90 +0,0 @@
-# 通信库参数
-
-本节介绍通信库相关的参数设置及取值范围等内容。
-
-## tcp\_keepalives\_idle
-
-**参数说明：**在支持TCP\_KEEPIDLE套接字选项的系统上，设置发送活跃信号的间隔秒数。不设置发送保持活跃信号，连接就会处于闲置状态。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-> **须知：**
->
->- 如果操作系统不支持TCP\_KEEPIDLE选项，这个参数的值必须为0。
->
->- 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。
->
->- 将该值设置为0时，将使用系统的值。
->
->- 该参数在不同的**会话之间不共享**，也就是说不同的会话连接可能有不同的值。
->
->- 查看该参数时查出来的是**当前会话连接内的参数值**，而不是**guc副本的值**。
-
-**取值范围：**0-3600，单位为s。
-
-**默认值：**0
-
-## tcp\_keepalives\_interval
-
-**参数说明：**在支持TCP\_KEEPINTVL套接字选项的操作系统上，以秒数声明在重新传输之间等待响应的时间。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：**0-180，单位为s。
-
-**默认值：**0
-
-> **须知：**
->
->- 如果操作系统不支持TCP\_KEEPINTVL选项，这个参数的值必须为0。
->
->- 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。
->
->- 将该值设置为0时，将使用系统的值。
->
->- 该参数在不同的**会话之间不共享**，也就是说不同的会话连接可能有不同的值。
->
->- 查看该参数时查出来的是**当前会话连接内的参数值**，而不是**guc副本的值**。
-
-## tcp\_keepalives\_count
-
-**参数说明：**在支持TCP\_KEEPCNT套接字选项的操作系统上，设置openGauss服务端在断开与客户端连接之前可以等待的保持活跃信号个数。
-
-该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-> **须知：**
->
->- 如果操作系统不支持TCP\_KEEPCNT选项，这个参数的值必须为0。
->
->- 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。
->
->- 将该值设置为0时，将使用系统的值。
->
->- 该参数在不同的**会话之间不共享**，也就是说不同的会话连接可能有不同的值。
->
->- 查看该参数时查出来的是**当前会话连接内的参数值**，而不是**guc副本的值**。
-
-**取值范围：**0-100，其中0表示openGauss未收到客户端反馈的保持活跃信号则立即断开连接。
-
-**默认值：**0
-
-## comm\_proxy\_attr
-
-**参数说明：**通信代理库相关参数配置。
-
-> **说明：**
-- 该参数仅支持欧拉2.9系统下的集中式ARM单机。
->- 本功能在线程池开启状态下生效，即enable\_thread\_pool为on。
->- 配置该参数时需同步配置GUC参数local\_bind\_address为libos\_kni的网卡IP。
->- 参数模板：comm\_proxy\_attr = '\{enable\_libnet:true, enable\_dfx:false, numa\_num:4, numa\_bind:\[\[30,31\],\[62,63\],\[94,95\],\[126,127\]\]\}'
->- 可配置参数说明。
-> - enable\_libnet：是否开启用户态协议，取值范围：true、false。
-> - enable\_dfx：是否开启通信代理库视图，取值范围：true、false。
-> - numa\_num：机器环境中numa的数量，支持2P、4P服务器，取值范围：4、8。
-> - numa\_bind：代理线程绑核参数，每个numa两个CPU绑核，共numa\_num组，取值范围：\[0，cpu数-1\]。
-
-该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围**：字符串，长度大于0。
-
-**默认值：**'none'
\ No newline at end of file
diff --git a/content/zh/docs/DataMigrationGuide/DataMigrationGuide.md b/content/zh/docs/DataMigrationGuide/DataMigrationGuide.md
index ffc71ed72d307afe7f58d1dc7d6b5389f7836629..6e7edcde03e66fd308a409f29e4c9265488db985 100644
--- a/content/zh/docs/DataMigrationGuide/DataMigrationGuide.md
+++ b/content/zh/docs/DataMigrationGuide/DataMigrationGuide.md
@@ -1,4 +1,4 @@
-# 数据迁移
+# 数据迁移
本文档提供了openGauss数据库与其它数据库之间进行数据迁移的方法。
diff --git "a/content/zh/docs/DataMigrationGuide/MySQL\345\205\274\345\256\271\346\200\247\350\257\264\346\230\216.md" "b/content/zh/docs/DataMigrationGuide/MySQL\345\205\274\345\256\271\346\200\247\350\257\264\346\230\216.md"
index 4ef5afbe10cd53136e78647d890161383b97f22a..2297ac61d623ae1bedcd39d39cf55b9728e51192 100644
--- "a/content/zh/docs/DataMigrationGuide/MySQL\345\205\274\345\256\271\346\200\247\350\257\264\346\230\216.md"
+++ "b/content/zh/docs/DataMigrationGuide/MySQL\345\205\274\345\256\271\346\200\247\350\257\264\346\230\216.md"
@@ -1,4 +1,6 @@
-# 内核MySQL兼容性说明
+# MySQL兼容性说明
+
+openGauss的MySQL兼容性主要通过Dolphin插件和内核实现。Dolphin插件的说明可参考[Dolphin插件介绍](../ExtensionReference/dolphin-Extension.md)。在openGauss内核中实现的MySQL兼容性特性见下表。
**表 1** 在openGauss内核中实现的MySQL兼容性特性列表
@@ -17,226 +19,226 @@
| - | -- | -- | -
|---|---|---|
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
+**图 1** 单中心部署图
+
+
组网特点：
单AZ部署，可以配置一个同步备一个异步备
@@ -21,7 +22,8 @@
## 同城双中心
**图 2** 同城双中心部署图
- 
+
+
组网特点：
同城两个AZ，相比单AZ可靠性更强，主中心和同城中心可以分别配置一个同步备
@@ -40,7 +42,9 @@
## 两地三中心
**图 3** 两地三中心部署图
- 
+
+
+
组网特点：
两地三中心，每个AZ都保证至少有一个同步备，同时地点和中心数的增加，集群的可靠性能够达到最高
@@ -58,7 +62,7 @@
## 两地三中心流式容灾方案
**图 4** 两地三中心流式容灾方案部署图
- 
+ 
组网特点：
双集群容灾方案，两个独立集群，主备集群组网方式可任意选择，备集群会选出首备连接主集群的主DN，灾备集群内都以级联备方式连接首备
@@ -77,7 +81,7 @@
两地三中心流式容灾方案更多信息详见[两地三中心跨Region容灾](两地三中心跨Region容灾.md)
-> **说明：**
+> **说明：**
>
>以上为一些典型的部署方案，用户可以依据自身实际业务场景对以上各种部署方案进行调整，比如增减备机数量、调整中心数量、适当安置同步备和异步备、适当使用级联备机等
diff --git a/content/zh/docs/DatabaseAdministrationGuide/postgres_fdw.md b/content/zh/docs/DatabaseAdministrationGuide/postgres_fdw.md
index c673b9a02634e6238b36d182b3b9505a9c691d30..4161efac1b0f24732d061a24c92c852cbd3d5704 100644
--- a/content/zh/docs/DatabaseAdministrationGuide/postgres_fdw.md
+++ b/content/zh/docs/DatabaseAdministrationGuide/postgres_fdw.md
@@ -1,22 +1,24 @@
-# postgres\_fdw
+# postgres\_fdw
postgres\_fdw是一款开源插件，其代码随PostgreSQL源码一同发布。openGauss基于开源的PostgreSQL 9.4.26版本中的postgres\_fdw源码（[https://ftp.postgresql.org/pub/source/v9.4.26/postgresql-9.4.26.tar.gz](https://ftp.postgresql.org/pub/source/v9.4.26/postgresql-9.4.26.tar.gz) ）进行开发适配。
postgres\_fdw插件默认参与编译，使用安装包安装好openGauss后，可直接使用postgres\_fdw，无须其他操作。
-> **说明：**
+> **说明：**
>
>当前postgres\_fdw仅支持openGauss连接openGauss，不支持openGauss连接PostgreSQL。
## 使用postgres\_fdw
-- 加载postgres\_fdw扩展：**CREATE ExtensionReference postgres\_fdw;**
+- 加载postgres\_fdw扩展：**CREATE Extension postgres\_fdw;**
- 创建服务器对象：**CREATE SERVER**
- 创建用户映射：**CREATE USER MAPPING**
-- 创建外表：**CREATE FOREIGN TABLE** 外表的表结构需要与远端openGauss侧的表结构保持一致。
+- 创建外表：**CREATE FOREIGN TABLE**
+
+ 外表的表结构需要与远端openGauss侧的表结构保持一致。
- 对外表做正常的操作，如 **INSERT**、**UPDATE**、**DELETE**、**SELECT**、**EXPLAIN**、**ANALYZE**、**COPY** 等。
@@ -26,7 +28,7 @@ postgres\_fdw插件默认参与编译，使用安装包安装好openGauss后，
- 删除服务器对象：**DROP SERVER**
-- 删除扩展：**DROP ExtensionReference postgres\_fdw;**
+- 删除扩展：**DROP Extension postgres\_fdw;**
- 查看REMOTE SQL PLAN：开启GUC参数show_fdw_remote_plan，可以在explain时追加打印remote sql的计划，对remote sql的explain会继承explain语句的verbose、costs选项。
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-caution.png differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-danger.png differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.gif
deleted file mode 100644
index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-note.png differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.gif
deleted file mode 100644
index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.png
new file mode 100644
index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-notice.png differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.gif
deleted file mode 100644
index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-tip.png differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.gif b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.gif
deleted file mode 100644
index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000
Binary files a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.gif and /dev/null differ
diff --git a/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.png b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8
Binary files /dev/null and b/content/zh/docs/DatabaseAdministrationGuide/public_sys-resources/icon-warning.png differ
diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\344\270\211\346\235\203\345\210\206\347\253\213.md" "b/content/zh/docs/DatabaseAdministrationGuide/\344\270\211\346\235\203\345\210\206\347\253\213.md"
index 36fe70506128bd551b1f83ad934311a027aa781c..65f7cc95e10bf27462d55b6eaa132109df4445a7 100644
--- "a/content/zh/docs/DatabaseAdministrationGuide/\344\270\211\346\235\203\345\210\206\347\253\213.md"
+++ "b/content/zh/docs/DatabaseAdministrationGuide/\344\270\211\346\235\203\345\210\206\347\253\213.md"
@@ -1,4 +1,4 @@
-# 三权分立
+# 三权分立
[默认权限机制](默认权限机制.md)和[管理员](管理员.md)两节的描述基于的是openGauss创建之初的默认情况。从前面的介绍可以看出，默认情况下拥有SYSADMIN属性的系统管理员，具备系统最高权限。
@@ -91,7 +91,7 @@
只可以查看部分系统表和视图。详细请参见系统表和系统视图。
+只可以查看部分系统表和视图。详细请参见系统表和系统视图。
默认值为12295，表示只对DATABASE、SCHEMA、USER、DATA SOURCE这四类数据库对象的CREATE、ALTER、DROP操作进行审计。
+默认值为67121159，表示只对DATABASE、SCHEMA、USER、DATA SOURCE这四类数据库对象的CREATE、ALTER、DROP操作进行审计。
指定创建一个新审计日志文件的时间间隔。当现在的时间减去上次创建一个审计日志的时间超过了此参数值时，服务器将生成一个新的审计日志文件。
表示需记录审计日志的最短时间要求，该参数在audit_resource_policy为off时生效。
+表示需记录审计日志的最短时间要求，该参数在audit_resource_policy为off时生效。
使用ALTER SYSTEM SET修改数据库参数。
+使用ALTER SYSTEM SET修改数据库参数。
openGauss=# ALTER SYSTEM SET paraname TO value;
openGauss=# ALTER SYSTEM SET paraname TO value;@@ -146,7 +146,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# -> **注意：** +> **注意：** >使用方式一和方式二设置参数时，若所设参数不属于当前环境，数据库会提示参数不在支持范围内的相关信息。 ## 操作步骤 @@ -172,7 +172,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# gs_guc set -D /gaussdb/data/dbnode -c "archive_mode=off" ``` - > **说明：** + > **说明：** > >可以使用以下命令在数据库节点上设置archive\_mode参数为off。 >``` @@ -236,7 +236,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# Success to perform gs_guc! ``` - > **说明：** + > **说明：** > >可以使用以下命令在数据库节点上设置authentication\_timeout参数为59s。 >``` diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\256\211\345\205\250\347\255\226\347\225\245.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\256\211\345\205\250\347\255\226\347\225\245.md" index df15138f9e3e5df3df44a6fa3b906cafd9ee9806..1261475fa69cac4cab680c7060a6adb0ac5b62b4 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\256\211\345\205\250\347\255\226\347\225\245.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\256\211\345\205\250\347\255\226\347\225\245.md" @@ -1,4 +1,4 @@ -# 设置安全策略 +# 设置安全策略 - **[设置帐户安全策略](设置帐户安全策略.md)** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\346\200\201\347\255\211\345\200\274\346\237\245\350\257\242.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\346\200\201\347\255\211\345\200\274\346\237\245\350\257\242.md" index 76841ba525133bca8dc27b0034736090ad6d3404..9269fa279a060267c2fe0ec6558dcd50a5e9b535 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\346\200\201\347\255\211\345\200\274\346\237\245\350\257\242.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\346\200\201\347\255\211\345\200\274\346\237\245\350\257\242.md" @@ -1,4 +1,4 @@ -# 设置密态等值查询 +# 设置密态等值查询 - **[密态等值查询概述](密态等值查询概述.md)** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\347\240\201\345\256\211\345\205\250\347\255\226\347\225\245.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\347\240\201\345\256\211\345\205\250\347\255\226\347\225\245.md" index 1ba5b17b86f45c36006d312e9be0c61130c3bd1c..1c167a56d231ea2242fea5f9d2070ddeea1b6cd0 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\347\240\201\345\256\211\345\205\250\347\255\226\347\225\245.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\257\206\347\240\201\345\256\211\345\205\250\347\255\226\347\225\245.md" @@ -49,7 +49,7 @@ gs_guc reload -N all -I all -c "password_encryption_type=2" ``` - > **须知：** + > **须知：** >为防止用户密码泄露，在执行CREATE USER/ROLE命令创建数据库用户时，不能指定UNENCRYPTED属性，即新创建的用户的密码只能是加密存储的。 5. 配置密码安全参数。 @@ -99,7 +99,7 @@ gs_guc reload -N all -I all -c "password_policy=1" ``` - >  **说明：** + >  **说明：** > > 帐户密码的复杂度要求如下： > @@ -126,7 +126,7 @@ 用户修改密码时，只有超过不可重用天数（[password\_reuse\_time](../DatabaseReference/安全和认证_postgresql-conf.md#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s36625909efc14a42af3e142435ae9794)）或不可重用次数（[password\_reuse\_max](../DatabaseReference/安全和认证_postgresql-conf.md#zh-cn_topic_0237124696_zh-cn_topic_0059778664_scad28ae18dfc4557b10f51bf147a9e53)）的密码才可以使用。参数配置说明如[表2](#zh-cn_topic_0283137010_zh-cn_topic_0237121110_zh-cn_topic_0151096202_zh-cn_topic_0085033092_zh-cn_topic_0059779155_t2013c9d251bc4cf5be274ef279c4faee)所示。 - > **说明：** + > **说明：** >不可重用天数默认值为60天，不可重用次数默认值是0。这两个参数值越大越安全，但是在使用过程中会带来不便，其默认值符合安全标准，用户可以根据需要重新设置参数，提高安全等级。 配置password\_reuse\_time参数。 @@ -163,7 +163,7 @@ 3. 执行如下命令设置成默认值60。 - > **说明：** + > **说明：** >不建议设置为0，即使需要设置也要将所有openGauss节点中的password\_reuse\_time都设置为0才能生效。 ``` @@ -210,9 +210,9 @@ - 密码有效期限 - 数据库用户的密码都有密码有效期（[password\_effect\_time](安全和认证_postgresql-conf.html#zh-cn_topic_0237124696_zh-cn_topic_0059778664_sfcc6124115734728917a548a8bd8f0d4)），当达到密码到期提醒天数（[password\_notify\_time](安全和认证_postgresql-conf.html#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s1beab889ab8d49848ef28bf60c10d8f7)）时，系统会在用户登录数据库时提示用户修改密码。 + 数据库用户的密码都有密码有效期（[password\_effect\_time](../DatabaseReference/安全和认证_postgresql-conf.md#zh-cn_topic_0237124696_zh-cn_topic_0059778664_sfcc6124115734728917a548a8bd8f0d4)），当达到密码到期提醒天数（[password\_notify\_time](../DatabaseReference/安全和认证_postgresql-conf.md#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s1beab889ab8d49848ef28bf60c10d8f7)）时，系统会在用户登录数据库时提示用户修改密码。 - > **说明：** + > **说明：** >考虑到数据库使用特殊性及业务连续性，密码过期后用户还可以登录数据库，但是每次登录都会提示修改密码，直至修改为止。 配置password\_effect\_time参数。 @@ -306,12 +306,12 @@ 以修改用户user1密码为例，以系统管理员用户连接数据库并执行如下命令： ``` - openGauss=# ALTER USER user1 IDENTIFIED BY "1234@abc" REPLACE "5678@def"; + openGauss=# ALTER USER user1 IDENTIFIED BY "$$$$$$$$" REPLACE "XXXXXXXX"; ALTER ROLE ``` - > **说明：** - >1234@abc、5678@def分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 + > **说明：** + >$$$$$$$$、XXXXXXXX分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 - 管理员可以修改自己的或者其他帐户的密码。通过修改其他帐户的密码，解决用户密码遗失所造成无法登录的问题。 @@ -322,7 +322,7 @@ ALTER ROLE ``` - > **说明：** + > **说明：** > >- 系统管理员之间不允许互相修改对方密码。 >- 系统管理员可以修改普通用户密码且不需要用户原密码。 @@ -554,7 +554,7 @@ ALTER ROLE ``` - > **说明：** + > **说明：** > >- 密码失效的用户登录数据库后，当执行简单查询或者扩展查询时，会提示用户修改密码。修改密码后可以正常执行语句。 > diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md" index d41ac348a0757b1595b5d6cfe234c7926204bba5..c1d6910d59ef19723409708d31c304b5908f94f1 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md" @@ -1,4 +1,4 @@ -# 设置帐号有效期 +# 设置帐号有效期 ## 注意事项 @@ -52,6 +52,6 @@ ``` -> **说明：** +> **说明：** >若在“CREATE ROLE”或“ALTER ROLE”语法中不指定“VALID BEGIN”，表示不对用户的开始操作时间做限定；若不指定“VALID UNTIL”，表示不对用户的结束操作时间做限定；若两者均不指定，表示该用户一直有效。 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\346\210\267\345\256\211\345\205\250\347\255\226\347\225\245.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\346\210\267\345\256\211\345\205\250\347\255\226\347\225\245.md" index 01b3eb18806071a6b46e92ab37033979853628d5..2f98f8ffcd80fbe5e61423ed83d053ed2a2851af 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\346\210\267\345\256\211\345\205\250\347\255\226\347\225\245.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\345\270\220\346\210\267\345\256\211\345\205\250\347\255\226\347\225\245.md" @@ -1,4 +1,4 @@ -# 设置帐户安全策略 +# 设置帐户安全策略 ## 背景信息 @@ -9,7 +9,7 @@ openGauss为帐户提供了自动锁定和解锁帐户、手动锁定和解锁 - 为了保证帐户安全，如果用户输入密码次数超过一定次数（failed\_login\_attempts），系统将自动锁定该帐户，默认值为10。次数设置越小越安全，但是在使用过程中会带来不便。 - 当帐户被锁定时间超过设定值（password\_lock\_time），则当前帐户自动解锁，默认值为1天。时间设置越长越安全，但是在使用过程中会带来不便。 - > **说明：** + > **说明：** > >- 参数password\_lock\_time的整数部分表示天数，小数部分可以换算成时、分、秒。 >- 当failed\_login\_attempts设置为0时，表示不限制密码错误次数。当password\_lock\_time设置为0时，表示即使超过密码错误次数限制导致帐户锁定，也会在短时间内自动解锁。因此，只有两个配置参数都为正数时，才可以进行常规的密码失败检查、帐户锁定和解锁操作。 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md" index 803f663854e44349ea2f51ef01fd7a2382735f10..1e29a0febc7f348c285b9c61cb6ead7b0f8d01c6 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md" @@ -1,4 +1,4 @@ -# 设置数据库审计 +# 设置数据库审计 - **[审计概述](审计概述.md)** - **[查看审计结果](查看审计结果.md)** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\226\207\344\273\266\346\235\203\351\231\220\345\256\211\345\205\250\347\255\226\347\225\245.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\226\207\344\273\266\346\235\203\351\231\220\345\256\211\345\205\250\347\255\226\347\225\245.md" index 002c134eb9f35273ba0db553a27ef22f7bc47aa5..c56cd78182c1b4ae6118c0d0d555d2df3baccb2e 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\226\207\344\273\266\346\235\203\351\231\220\345\256\211\345\205\250\347\255\226\347\225\245.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\346\226\207\344\273\266\346\235\203\351\231\220\345\256\211\345\205\250\347\255\226\347\225\245.md" @@ -1,4 +1,4 @@ -# 设置文件权限安全策略 +# 设置文件权限安全策略 ## 背景信息 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223.md" index 3b6e9d2fe1d07a283c00b9cece6c1658bc474819..17a4eabb9796799dfc795429ac9a62555a16c3ea 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223.md" @@ -1,4 +1,4 @@ -# 设置账本数据库 +# 设置账本数据库 - **[账本数据库概述](账本数据库概述.md)** diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\351\200\217\346\230\216\346\225\260\346\215\256\345\212\240\345\257\206_TDE.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\351\200\217\346\230\216\346\225\260\346\215\256\345\212\240\345\257\206_TDE.md" index 4153a4919467b5fc34d1811f26ce290accc56d8c..b4bf3fe371a0acfc58ce64d273c612a11c49ff27 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\351\200\217\346\230\216\346\225\260\346\215\256\345\212\240\345\257\206_TDE.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\256\276\347\275\256\351\200\217\346\230\216\346\225\260\346\215\256\345\212\240\345\257\206_TDE.md" @@ -1,4 +1,4 @@ -# 设置透明数据加密（TDE） +# 设置透明数据加密（TDE） ## 概述 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\346\233\277\346\215\242.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\346\233\277\346\215\242.md" index 104fad31f54ecbadb97d1c85ed61b2e33117cb80..bab0316e811e079fc567004161f579084bba5a8a 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\346\233\277\346\215\242.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\346\233\277\346\215\242.md" @@ -1,4 +1,4 @@ -# 证书替换 +# 证书替换 ## 操作场景 @@ -57,7 +57,7 @@ openGauss目前只支持X509v3的PEM格式证书。 gs_om -t start ``` - > **说明：** + > **说明：** >证书具有rollback功能，可以把上一次执行证书替换之前的证书，进行回退。可以使用gs\_om -t cert --rollback进行远程调用该接口；使用gs\_om -t cert --rollback -L进行本地调用该接口。以上一次成功执行证书替换后，被替换的证书版本为基础进行回退。 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\347\224\237\346\210\220.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\347\224\237\346\210\220.md" index f54805083a8ba5174baaefa91f1ca2611a46693b..a045e6d9aff5bf05f9787fc5426f89d51cdb9891 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\347\224\237\346\210\220.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\257\201\344\271\246\347\224\237\346\210\220.md" @@ -1,4 +1,4 @@ -# 证书生成 +# 证书生成 ## 操作场景 @@ -104,7 +104,7 @@ Linux环境安装了openssl组件。 organizationName = Abc organizationalUnitName = hello commonName = world - X509v3 ExtensionReferences: + X509v3 Extensions: X509v3 Basic Constraints: CA:FALSE Netscape Comment: @@ -194,7 +194,7 @@ Linux环境安装了openssl组件。 organizationName = Abc organizationalUnitName = hello commonName = world - X509v3 ExtensionReferences: + X509v3 Extensions: X509v3 Basic Constraints: CA:FALSE Netscape Comment: diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223\346\246\202\350\277\260.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223\346\246\202\350\277\260.md" index ba316df93bba02ea7b247194993932b26db54095..740987d20a88947287fd200923e82d15d7319434 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223\346\246\202\350\277\260.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\264\246\346\234\254\346\225\260\346\215\256\345\272\223\346\246\202\350\277\260.md" @@ -1,4 +1,4 @@ -# 账本数据库概述 +# 账本数据库概述 ## 背景信息 @@ -113,7 +113,7 @@ openGauss=# \d+ blockchain.ledgernsp_usertable_hist; ``` openGauss=# \d+ ledgernsp.usertable; Table "ledgernsp.usertable" - Column | Type | Modifiers | Storage | Stats target | AboutopenGauss + Column | Type | Modifiers | Storage | Stats target | Description --------+---------+-----------+----------+--------------+------------- id | integer | | plain | | name | text | | extended | | @@ -124,7 +124,7 @@ History table name: ledgernsp_usertable_hist openGauss=# \d+ blockchain.ledgernsp_usertable_hist; Table "blockchain.ledgernsp_usertable_hist" - Column | Type | Modifiers | Storage | Stats target | AboutopenGauss + Column | Type | Modifiers | Storage | Stats target | Description ----------+--------+-----------+---------+--------------+------------- rec_num | bigint | | plain | | hash_ins | hash16 | | plain | | @@ -136,12 +136,12 @@ Has OIDs: no Options: internal_mask=263 ``` -> **说明：** +> **说明：** > >+ 防篡改表不支持非行存表、临时表、外表、unlog表、非行存表均无防篡改属性。 >+ 防篡改表在创建时会自动增加一个名为hash的系统列，所以防篡改表单表最大列数为1599。 -> **警告：** +> **警告：** > >+ dbe_perf和snapshot两个模式不能ALTER为blockchain属性，如：ALTER SCHEMA dbe_perf WITH BLOCKCHAIN;。 >+ 系统模式不能 ALTER 为blockchain属性，如：ALTER SCHEMA pg_catalog WITH BLOCKCHAIN;。 diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\345\274\200\345\217\221\350\200\205\347\216\257\345\242\203\351\203\250\347\275\262.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\345\274\200\345\217\221\350\200\205\347\216\257\345\242\203\351\203\250\347\275\262.md" index 2d296a50556d30a5117df66bebdcfbd48efd7ae0..eeb3435f0ba4fff55b59145a4dbc3ca5bda85fd8 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\345\274\200\345\217\221\350\200\205\347\216\257\345\242\203\351\203\250\347\275\262.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\345\274\200\345\217\221\350\200\205\347\216\257\345\242\203\351\203\250\347\275\262.md" @@ -30,11 +30,11 @@ openGauss资源池化是openGauss推出的一种新型的集群架构.通过DMS - 已经自行使用编译方式编译出了openGauss带资源池化代码的debug版本的安装包, 可以通过确认生成的bin目录下是否有dssserver, dsscmd, lib目录下是否有libdms.so, libdssapi.so , libdssaio.so, 来判断，同时要保证编译openGauss时使用的是测试版本的DSS组件和DMS组件，详细参考下面的步骤。 ## 独立编译安装指南 -> **注意：** +> **注意：** > > 以下部署操作请勿用于生产环境 - > **说明：** + > **说明：** > - openGauss必须用Debug模式编译，不能使用Release模式，DMS和DSS组件需要使用测试版本。 > - 手动编译安装的方式中，没有包含CM和OM组件，而正式的使用环境中DSS组件和DMS组件对CM有依赖，所以在编译openGauss之前需要先用测试的模式分别编译DSS和DMS组件，参考下面的编译方式说明。 @@ -67,7 +67,7 @@ openGauss资源池化是openGauss推出的一种新型的集群架构.通过DMS cd tmp/ make -sj ``` ->  **注意：** +>  **注意：** > > 当编译完DSS、DMS、CBB之后，会自动更新到三方库，不需要手动拷贝，接下来只需按标准步骤编译数据库即可。 @@ -147,7 +147,7 @@ export DSS_HOME=/home/test/dss/dss0/dssdba ```shell data:/home/test/dss/dev/dss-dba ``` ->  **注意：** +>  **注意：** > > 一台服务器上建多个dn(数据库)节点, ip是相同的, 服务使用的端口号不同。 @@ -166,7 +166,7 @@ export DSS_HOME=/home/test/dss/dss0/dssdba dsscmd lsvg -U UDS:/home/test/dss/dss0/.dss_unix_d_socket dsscmd ls -m M -p +data -U UDS:/home/test/dss/dss0/.dss_unix_d_socket ``` ->  **注意：** +>  **注意：** > > dss不支持启动后修改卷组配置，如涉及修改请重新执行上述步骤。 @@ -176,7 +176,7 @@ export DSS_HOME=/home/test/dss/dss0/dssdba mkdir -p /home/test/data rm -rf node1 node2 -gs_intdb -D /home/test/data/node1 --nodename=node1 -U tester -w Pasword --vgname=+data --enable-dss --dms_url="0:127.0.0.1:1613,1:127.0.0.1:1614" -I 0 --socketpath='UDS:/home/test/dss/dss0/.dss_unix_d_socket' +gs_initdb -D /home/test/data/node1 --nodename=node1 -U tester -w Pasword --vgname=+data --enable-dss --dms_url="0:127.0.0.1:1613,1:127.0.0.1:1614" -I 0 --socketpath='UDS:/home/test/dss/dss0/.dss_unix_d_socket' echo "ss_enable_ssl = off listen_addresses = '*' @@ -191,7 +191,7 @@ ss_log_max_file_size = 1GB sed '91 ahost all all 0.0.0.0/0 sha256' -i /home/test/data/node1/pg_hba.conf -gs_intdb -D /home/test/data/node2 --nodename=node2 -U tester -w Pasword --vgname=+data --enable-dss --dms_url="0:127.0.0.1:1613,1:127.0.0.1:1614" -I 1 --socketpath='UDS:/home/test/dss/dss1/.dss_unix_d_socket' +gs_initdb -D /home/test/data/node2 --nodename=node2 -U tester -w Pasword --vgname=+data --enable-dss --dms_url="0:127.0.0.1:1613,1:127.0.0.1:1614" -I 1 --socketpath='UDS:/home/test/dss/dss1/.dss_unix_d_socket' echo "ss_enable_ssl = off listen_addresses = '*' diff --git "a/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204.md" "b/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204.md" index f846df69a18dc7e178c5e172594a9908e477a018..66ed7ddc535fa2bd6ef5e69abf4f9ad69d8beeea 100644 --- "a/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204.md" +++ "b/content/zh/docs/DatabaseAdministrationGuide/\350\265\204\346\272\220\346\261\240\345\214\226\346\236\266\346\236\204.md" @@ -6,7 +6,8 @@ 资源池化架构可以参考下图。
图1: openGauss资源池化架构图
-
本产品支持如下几种认证方式，详细解释请参见表2：
-MD5加密算法安全性低，存在安全风险，建议使用更安全的加密算法。
+采用这种认证模式时，本产品只完全信任从服务器本机使用gsql且不指定-U参数的连接，此时不需要口令。
trust认证对于单用户工作站的本地连接是非常合适和方便的，通常不适用于多用户环境。如果想使用这种认证方法，可利用文件系统权限限制对服务器的Unix域套接字文件的访问。要使用这种限制有两个方法：
-可以升级到openGauss1.1.0-openGauss3.1.0之间的任意版本，不包含openGauss3.1.0版本。
+使用gsql工具恢复数据库对象前，可根据需要使用文本编辑器编辑纯文本导出文件。
+使用gsql工具恢复数据库对象前，可根据需要使用文本编辑器编辑纯文本导出文件。
使用gs_restore可以选择要从自定义归档/目录归档/tar归档导出文件中导入相应的数据库对象。
+使用gs_restore可以选择要从自定义归档/目录归档/tar归档导出文件中导入相应的数据库对象。
用户拥有的ANY权限，取值参考表1。
+用户拥有的ANY权限，取值参考表1。
用户拥有的ANY权限，取值参考表1。
+用户拥有的ANY权限，取值参考表1。
PG_TYPE.oid
可能取值及其含义见于pg_type.h中诸type定义，主要分为多态（isPolymorphicType）和非多态两类。
+可能取值及其描述见于系统表pg_type或查看源码中的pg_type.h文件中type定义，主要分为多态（isPolymorphicType）和非多态两类。
PG_TYPE.oid
PG_TYPE.oid
PG_TYPE.oid
PG_TYPE.oid
diff --git a/content/zh/docs/DataBaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md b/content/zh/docs/DatabaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md
similarity index 98%
rename from content/zh/docs/DataBaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md
rename to content/zh/docs/DatabaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md
index c84a71f3220e25bc6f3740a05195c3db2b1cfee1..70f7819b0572699152ae0cf0e7c0f679cb778f88 100644
--- a/content/zh/docs/DataBaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md
+++ b/content/zh/docs/DatabaseReference/PG_AVAILABLE_EXTENSION_VERSIONS.md
@@ -1,8 +1,8 @@
-# PG\_AVAILABLE\_ExtensionReference\_VERSIONS
+# PG\_AVAILABLE\_Extension\_VERSIONS
-PG\_AVAILABLE\_ExtensionReference\_VERSIONS视图显示数据库中某些特性的扩展版本信息。
+PG\_AVAILABLE\_Extension\_VERSIONS视图显示数据库中某些特性的扩展版本信息。
-**表 1** PG\_AVAILABLE\_ExtensionReference\_VERSIONS字段
+**表 1** PG\_AVAILABLE\_Extension\_VERSIONS字段
+# PG\_CONTROL\_GROUP\_CONFIG
PG\_CONTROL\_GROUP\_CONFIG视图存储系统的控制组配置信息。查询该视图需要sysadmin权限。
diff --git a/content/zh/docs/DataBaseReference/PG_CONVERSION.md b/content/zh/docs/DatabaseReference/PG_CONVERSION.md
similarity index 99%
rename from content/zh/docs/DataBaseReference/PG_CONVERSION.md
rename to content/zh/docs/DatabaseReference/PG_CONVERSION.md
index bd304729d0ff2ad398a7204afc748ead371ae2fc..99e50faf260cbdff08e0d0379211ad1cfca593b4 100644
--- a/content/zh/docs/DataBaseReference/PG_CONVERSION.md
+++ b/content/zh/docs/DatabaseReference/PG_CONVERSION.md
@@ -1,4 +1,4 @@
-# PG\_CONVERSION
+# PG\_CONVERSION
PG\_CONVERSION系统表描述编码转换信息。
diff --git a/content/zh/docs/DataBaseReference/PG_CURSORS.md b/content/zh/docs/DatabaseReference/PG_CURSORS.md
similarity index 99%
rename from content/zh/docs/DataBaseReference/PG_CURSORS.md
rename to content/zh/docs/DatabaseReference/PG_CURSORS.md
index 9d7ebc52e7584a35608b18a01f759d797b2f6fa4..2cbd40911da2133fbfdd2e9161ef43b123164536 100644
--- a/content/zh/docs/DataBaseReference/PG_CURSORS.md
+++ b/content/zh/docs/DatabaseReference/PG_CURSORS.md
@@ -1,4 +1,4 @@
-# PG\_CURSORS
+# PG\_CURSORS
PG\_CURSORS视图列出了当前可用的游标。
diff --git a/content/zh/docs/DataBaseReference/PG_DATABASE.md b/content/zh/docs/DatabaseReference/PG_DATABASE.md
similarity index 99%
rename from content/zh/docs/DataBaseReference/PG_DATABASE.md
rename to content/zh/docs/DatabaseReference/PG_DATABASE.md
index 2589ae88b6c5118c31055d8ee6919b4879dd2e59..f0254a7d727a8d7cb0d4d6c33f83a8a12f6cc159 100644
--- a/content/zh/docs/DataBaseReference/PG_DATABASE.md
+++ b/content/zh/docs/DatabaseReference/PG_DATABASE.md
@@ -1,4 +1,4 @@
-# PG\_DATABASE
+# PG\_DATABASE
PG\_DATABASE系统表存储关于可用数据库的信息。
diff --git a/content/zh/docs/DataBaseReference/PG_DB_ROLE_SETTING.md b/content/zh/docs/DatabaseReference/PG_DB_ROLE_SETTING.md
similarity index 99%
rename from content/zh/docs/DataBaseReference/PG_DB_ROLE_SETTING.md
rename to content/zh/docs/DatabaseReference/PG_DB_ROLE_SETTING.md
index 1c4a04f9864d7876672848e1e68cd9b4e50fab9c..25faef0b8206256c7f82531328c8e717730249c9 100644
--- a/content/zh/docs/DataBaseReference/PG_DB_ROLE_SETTING.md
+++ b/content/zh/docs/DatabaseReference/PG_DB_ROLE_SETTING.md
@@ -1,4 +1,4 @@
-# PG\_DB\_ROLE\_SETTING
+# PG\_DB\_ROLE\_SETTING
PG\_DB\_ROLE\_SETTING系统表存储数据库运行时每个角色与数据绑定的配置项的默认值。
diff --git a/content/zh/docs/DataBaseReference/PG_DEFAULT_ACL.md b/content/zh/docs/DatabaseReference/PG_DEFAULT_ACL.md
similarity index 99%
rename from content/zh/docs/DataBaseReference/PG_DEFAULT_ACL.md
rename to content/zh/docs/DatabaseReference/PG_DEFAULT_ACL.md
index ef59a60b2e708aae0f22526b222ac24cb1076bf5..712436584e1b282ab3fa29045819932a4d58e031 100644
--- a/content/zh/docs/DataBaseReference/PG_DEFAULT_ACL.md
+++ b/content/zh/docs/DatabaseReference/PG_DEFAULT_ACL.md
@@ -1,4 +1,4 @@
-# PG\_DEFAULT\_ACL
+# PG\_DEFAULT\_ACL
PG\_DEFAULT\_ACL系统表存储为新建对象设置的初始权限。
diff --git a/content/zh/docs/DataBaseReference/PG_DEPEND.md b/content/zh/docs/DatabaseReference/PG_DEPEND.md
similarity index 97%
rename from content/zh/docs/DataBaseReference/PG_DEPEND.md
rename to content/zh/docs/DatabaseReference/PG_DEPEND.md
index 0e8b49b21f3371667ca74529c5e55cf5b78a3258..e09a970742ae5f2cad7b62aaa4c2a0e04b79da48 100644
--- a/content/zh/docs/DataBaseReference/PG_DEPEND.md
+++ b/content/zh/docs/DatabaseReference/PG_DEPEND.md
@@ -1,4 +1,4 @@
-# PG\_DEPEND
+# PG\_DEPEND
PG\_DEPEND系统表记录数据库对象之间的依赖关系。这个信息允许DROP命令找出哪些其它对象必须由DROP CASCADE删除，或者是在DROP RESTRICT的情况下避免删除。
@@ -88,6 +88,6 @@ PG\_DEPEND系统表记录数据库对象之间的依赖关系。这个信息允
- DEPENDENCY\_NORMAL \(n\)：独立创建的对象之间的一般关系。有依赖的对象可以在不影响被引用对象的情况下删除。被引用对象只有在声明了CASCADE的情况下删除，这时有依赖的对象也被删除。例子：一个表字段对其数据类型有一般依赖关系。
- DEPENDENCY\_AUTO \(a\)：有依赖对象可以和被引用对象分别删除，并且如果删除了被引用对象则应该被自动删除（不管是RESTRICT或CASCADE模式）。例子：一个表上面的命名约束是在该表上的自动依赖关系，因此如果删除了表，它也会被删除。
- DEPENDENCY\_INTERNAL \(i\)：有依赖的对象是作为被引用对象的一部分创建的，实际上只是它的内部实现的一部分。DROP有依赖对象是不能直接允许的（将告诉用户发出一条删除被引用对象的DROP）。一个对被引用对象的DROP将传播到有依赖对象，不管是否声明了CASCADE。
-- DEPENDENCY\_ExtensionReference \(e\)：依赖对象是被依赖对象ExtensionReference的一个成员（请参见[PG\_EXTENSION](PG_EXTENSION.md)）。依赖对象只可以通过在被依赖对象上DROP ExtensionReference删除。函数上这个依赖类型和内部依赖一样动作，但是它为了清晰和简化gs\_dump保持分开。
+- DEPENDENCY\_Extension \(e\)：依赖对象是被依赖对象Extension的一个成员（请参见[PG\_EXTENSION](PG_EXTENSION.md)）。依赖对象只可以通过在被依赖对象上DROP Extension删除。函数上这个依赖类型和内部依赖一样动作，但是它为了清晰和简化gs\_dump保持分开。
- DEPENDENCY\_PIN \(p\)：没有依赖对象；这种类型的记录标志着系统本身依赖于被引用对象，因此这个对象决不能被删除。这种类型的记录只有在initdb的时候创建。有依赖对象的字段里是零。
diff --git a/content/zh/docs/DataBaseReference/PG_DESCRIPTION.md b/content/zh/docs/DatabaseReference/PG_DESCRIPTION.md
similarity index 95%
rename from content/zh/docs/DataBaseReference/PG_DESCRIPTION.md
rename to content/zh/docs/DatabaseReference/PG_DESCRIPTION.md
index 101546c957b2c24772bc38b4e4aa4f9ef614b0ad..7defc7f9e02f097a4e113db3f19e84eeed7cfa1d 100644
--- a/content/zh/docs/DataBaseReference/PG_DESCRIPTION.md
+++ b/content/zh/docs/DatabaseReference/PG_DESCRIPTION.md
@@ -1,10 +1,10 @@
-# PG\_AboutopenGauss
+# PG\_DESCRIPTION
-PG\_AboutopenGauss系统表可以给每个数据库对象存储一个可选的描述（注释）。许多内置的系统对象的描述提供了PG\_AboutopenGauss的初始内容。
+PG\_DESCRIPTION系统表可以给每个数据库对象存储一个可选的描述（注释）。许多内置的系统对象的描述提供了PG\_DESCRIPTION的初始内容。
-这个表的功能类似[PG\_SHAboutopenGauss](PG_SHDESCRIPTION.md)，用于记录openGauss范围内共享对象的注释。
+这个表的功能类似[PG_SHDESCRIPTION](PG_SHDESCRIPTION.md)，用于记录openGauss范围内共享对象的注释。
-**表 1** PG\_AboutopenGauss字段
+**表 1** PG_SHDESCRIPTION字段
| - | 记录级别的值是L0时，开始记录等待事件的列表。显示当前语句event等待相关的统计信息。具体事件信息见等待状态列表、轻量级锁等待事件列表、IO等待事件列表和事务锁等待事件列表。关于每种事务锁对业务的影响程度，请参考LOCK语法小节的详细描述。 记录级别的值是L2时，开始记录语句锁事件的列表。该列表按时间顺序记录事件，记录的数量受参数track_stmt_details_size的影响。该字段为二进制，需要借助解析函数pg_catalog.statement_detail_decode读取，见（表6）。 + | 记录级别的值是L0时，开始记录等待事件的列表。显示当前语句event等待相关的统计信息。具体事件信息见等待状态列表、轻量级锁等待事件列表、IO等待事件列表和事务锁等待事件列表。关于每种事务锁对业务的影响程度，请参考LOCK语法小节的详细描述。 记录级别的值是L2时，开始记录语句锁事件的列表。该列表按时间顺序记录事件，记录的数量受参数track_stmt_details_size的影响。该字段为二进制，需要借助解析函数pg_catalog.statement_detail_decode读取，见（表6）。
|
diff --git a/content/zh/docs/DataBaseReference/Undo.md b/content/zh/docs/DatabaseReference/Undo.md
similarity index 95%
rename from content/zh/docs/DataBaseReference/Undo.md
rename to content/zh/docs/DatabaseReference/Undo.md
index c2ff90249c2c3eddad298bdf2a8d1beb176421ce..7da73f70c960da5fb63a807b421134a8c11c48ae 100644
--- a/content/zh/docs/DataBaseReference/Undo.md
+++ b/content/zh/docs/DatabaseReference/Undo.md
@@ -1,4 +1,4 @@
-# Undo
+# Undo
## undo\_space\_limit\_size
diff --git a/content/zh/docs/DataBaseReference/_PG_FOREIGN_DATA_WRAPPERS.md b/content/zh/docs/DatabaseReference/_PG_FOREIGN_DATA_WRAPPERS.md
similarity index 98%
rename from content/zh/docs/DataBaseReference/_PG_FOREIGN_DATA_WRAPPERS.md
rename to content/zh/docs/DatabaseReference/_PG_FOREIGN_DATA_WRAPPERS.md
index a589380e56c95651688cbed3a6b588fd14ed9259..dee97bba8c3998a34b9a20aee879a63b05e55932 100644
--- a/content/zh/docs/DataBaseReference/_PG_FOREIGN_DATA_WRAPPERS.md
+++ b/content/zh/docs/DatabaseReference/_PG_FOREIGN_DATA_WRAPPERS.md
@@ -1,4 +1,4 @@
-# \_PG\_FOREIGN\_DATA\_WRAPPERS
+# \_PG\_FOREIGN\_DATA\_WRAPPERS
显示外部数据封装器的信息。该视图只有sysadmin权限可以查看。
diff --git a/content/zh/docs/DataBaseReference/_PG_USER_MAPPINGS.md b/content/zh/docs/DatabaseReference/_PG_USER_MAPPINGS.md
similarity index 98%
rename from content/zh/docs/DataBaseReference/_PG_USER_MAPPINGS.md
rename to content/zh/docs/DatabaseReference/_PG_USER_MAPPINGS.md
index 089a5ab9bc6b14f5fabd4d2fe4f4d957b76f37e9..abf803a183abede049726885daa68f4b4002ccf4 100644
--- a/content/zh/docs/DataBaseReference/_PG_USER_MAPPINGS.md
+++ b/content/zh/docs/DatabaseReference/_PG_USER_MAPPINGS.md
@@ -1,4 +1,4 @@
-# \_PG\_USER\_MAPPINGS
+# \_PG\_USER\_MAPPINGS
存储从本地用户到远程的映射。该视图只有sysadmin权限可以查看。
diff --git "a/content/zh/docs/DataBaseReference/cm_agent\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/cm_agent\345\217\202\346\225\260.md"
similarity index 99%
rename from "content/zh/docs/DataBaseReference/cm_agent\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/cm_agent\345\217\202\346\225\260.md"
index 46373e1749c31e58fb3372e64900b445b4784f2b..4643ebc07703b468fd6343b6a5739b4cdfbd57d9 100644
--- "a/content/zh/docs/DataBaseReference/cm_agent\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/cm_agent\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# cm\_agent参数
+# cm\_agent参数
## log\_dir
@@ -151,7 +151,7 @@
**参数说明**：扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。
-> **说明：**
+> **说明：**
>该分片数请与实际扩容分片数设置为一致。
**取值范围**：整型，0\~232 - 1，单位为个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后需要重启cm\_agent才能生效。参数修改请参考[表2](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)进行设置。
diff --git "a/content/zh/docs/DataBaseReference/cm_server\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/cm_server\345\217\202\346\225\260.md"
similarity index 98%
rename from "content/zh/docs/DataBaseReference/cm_server\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/cm_server\345\217\202\346\225\260.md"
index 07d99c58a48af8d6afd74b9c4a67322dc2cd198b..1742f6584a06d23d338c51510d1e1bd6465ca4a6 100644
--- "a/content/zh/docs/DataBaseReference/cm_server\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/cm_server\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# cm\_server参数
+# cm\_server参数
## log\_dir
@@ -245,7 +245,7 @@
## force\_promote
-**参数说明：**cm\_server是否打开强起逻辑（指数据库状态为Unknown的时候以丢失部分数据为代价保证数据库基本功能可用）的开关。0代表功能关闭，1代表功能开启。该参数同时适用于dn。
+**参数说明：**cm\_server是否打开强启逻辑（指数据库状态为Unknown的时候以丢失部分数据为代价保证数据库基本功能可用）的开关。0代表功能关闭，1代表功能开启。该参数同时适用于dn。
**取值范围：**整型，0\~1。在cm\_server上修改后需要重启cm\_server才能生效。
@@ -253,7 +253,7 @@
## switch\_rto
-**参数说明：**cm\_server强起逻辑等待时延。在force\_promote被置为1时，当数据库的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。
+**参数说明：**cm\_server强启逻辑等待时延。在force\_promote被置为1时，当数据库的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强启逻辑。
**取值范围：**整型，60\~2147483647，单位为秒。修改后需要重启cm\_server才能生效。
@@ -303,7 +303,7 @@
- off表示不启用ssl。
- **默认值**：off
- > **须知：**
+ > **须知：**
>出于安全性考虑，建议不要关闭该配置。关闭后cm将**不使用**加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。
diff --git "a/content/zh/docs/DataBaseReference/openGauss\344\272\213\345\212\241.md" "b/content/zh/docs/DatabaseReference/openGauss\344\272\213\345\212\241.md"
similarity index 95%
rename from "content/zh/docs/DataBaseReference/openGauss\344\272\213\345\212\241.md"
rename to "content/zh/docs/DatabaseReference/openGauss\344\272\213\345\212\241.md"
index c8056165206c355f5ef54f4e5eaa4334c2f2a42e..db9f619fe9bee26b7d00d3989fad7bccb8a9a3b7 100644
--- "a/content/zh/docs/DataBaseReference/openGauss\344\272\213\345\212\241.md"
+++ "b/content/zh/docs/DatabaseReference/openGauss\344\272\213\345\212\241.md"
@@ -1,4 +1,4 @@
-# openGauss事务
+# openGauss事务
介绍openGauss事务隔离、事务只读、最大prepared事务数、维护模式目的参数设置及取值范围等内容。
@@ -43,7 +43,7 @@
- on表示该功能启用。
- off表示该功能被禁用。
-> **须知：**
+> **须知：**
>谨慎打开这个开关，避免引起openGauss数据不一致。
**默认值：**off
@@ -111,7 +111,7 @@
在备机请求主机进行日志复制时，如果application\_name参数没有设置，那么该参数会被用来作为备机在主机上的流复制槽名字。该流复制槽的命名方式为 "该参数值\_备机ip\_备机port"。其中，备机ip和备机port取自replconninfo参数中指定的备机ip和端口号。该流复制槽最大长度为61个字符，如果拼接后的字符串超过该长度，则会使用截断后的pgxc\_node\_name进行拼接，以保证流复制槽名字长度小于等于61个字符。
-> **注意：**
+> **注意：**
>此参数修改后会导致连接数据库实例失败，不建议进行修改。
**取值范围：**字符串
diff --git "a/content/zh/docs/DataBaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md" "b/content/zh/docs/DatabaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md"
similarity index 99%
rename from "content/zh/docs/DataBaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md"
rename to "content/zh/docs/DatabaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md"
index 6a0b7726178d1b940f8c58327aa488a0c47312fb..2b82d47682c85b6dfe782c6c865a56842f54e49e 100644
--- "a/content/zh/docs/DataBaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md"
+++ "b/content/zh/docs/DatabaseReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md"
@@ -1,4 +1,4 @@
-# openGauss可运行脚本功能说明
+# openGauss可运行脚本功能说明
以下是openGauss常用可执行脚本，仅供openGauss接口使用。
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-caution.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-caution.png differ
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-danger.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-danger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-danger.png differ
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-note.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-note.png differ
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-notice.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-notice.png
new file mode 100644
index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-notice.png differ
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-tip.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-tip.png differ
diff --git a/content/zh/docs/DatabaseReference/public_sys-resources/icon-warning.png b/content/zh/docs/DatabaseReference/public_sys-resources/icon-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8
Binary files /dev/null and b/content/zh/docs/DatabaseReference/public_sys-resources/icon-warning.png differ
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"
similarity index 78%
rename from "content/zh/docs/DataBaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md"
rename to "content/zh/docs/DatabaseReference/\344\270\273\346\234\215\345\212\241\345\231\250.md"
index 5bc3a11276b73fb33520879b9bd4e3cbd26ac785..47a6e86bb6035d779f1359a63bfb6e976279ffdc 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"
@@ -1,4 +1,4 @@
-# 主服务器
+# 主服务器
## synchronous\_standby\_names
@@ -6,7 +6,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>- 当前连接的同步备机是列表中的第一个名称。如果当前同步备机失去连接，则它会立即更换下一个优先级更高的备机，并将此备机的名称放入列表中。
>
@@ -18,7 +18,7 @@
- [FIRST] ***num_sync*** (***standby_name*** [, ...])
- ***standby_name*** [, ...]
-> **说明：**
+> **说明：**
>- 其中 ***num_sync*** 是事务需要等待其回复的同步复制的备机的数量，***standby_name*** 是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略。
>
>- ANY N \(node1,node2,...\) 表示在括号内任选N个主机名称作为同步复制的备机名称列表。例如，ANY 1 \(node1,node2\) 表示在node1和node2中任选一个作为同步复制的备机名称。
@@ -43,7 +43,7 @@
**默认值：**\*
-> **说明：**
+> **说明：**
>
>- 备机名称列表中不可出现重复的名称，配置中num_sync 不可大于备机列表数量。
>
@@ -81,7 +81,7 @@
**默认值**：0
-> **须知：**
+> **须知：**
>
>配置该参数可能会对RPO造成影响, 若主机在所配置的超时时间窗口内发生故障，则从开始阻塞到主机故障这段时间窗口内的数据可能丢失。
@@ -91,7 +91,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>- 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。
>- 此参数属于受控参数，不建议正常业务场景下关闭此参数。
@@ -110,7 +110,7 @@
该参数属于INTERNAL类型参数，默认值为off，不允许外部修改。
-> **须知：**
+> **须知：**
>
>- 此参数目前不允许正常业务场景下改变其值，即关闭WAL日志、数据页混合复制模式。
>- 当前版本默认不支持主备从部署模式。
@@ -201,7 +201,7 @@
**默认值**：300
-> **说明：**
+> **说明：**
>
>- 单位只能设置为秒。
>- 当前版本默认不支持主备从部署模式。
@@ -220,23 +220,6 @@
**默认值**：-1
-## check_sync_standby
-
-**参数说明：**打开备机检查开关，主备场景下配置了正确的synchronous_standby_names参数后，当同步备故障时，主机写业务直接报错写失败。该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-
-**取值范围：** on/off
-
-- on表示开启备机检查。
-- off表示关闭备机检查。
-
-**默认值：**off
-
-> **说明：**
->
->- 该参数不支持在job work和自治事务中同步，有可能导致检查不生效。
->- 若指定用户或session中未设置备机检查，开启强同步提交模式下备机故障，执行一个表的写操作会导致另一个用户或session中的同一个表的查询hang，此时需要备机恢复或者手动terminate hang住的客户端。
->- 不支持非写操作中触发写日志的场景中（vacuum analyze，gs_clean等）开启备机检查开关。若备机不满足同步备配置，则该场景会导致业务hang，需要手动terminate。
-
## sync_config_strategy
**参数说明：**主机和备机、备机和级联备之间配置文件的同步策略。
@@ -251,7 +234,7 @@
**默认值：**all_node
-> **须知：**
+> **须知：**
>
>- 在一个包含了主机、备机和级联备的openGauss集群中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。
>
@@ -277,7 +260,7 @@
**默认值：** off
-> **须知：**
+> **须知：**
>
>- 如果最大可用模式most_available_sync配置为on，且所有同步备机都故障时，该功能不生效。因为没有同步备可以触发该LSN的持久化。
>
@@ -288,3 +271,47 @@
>- 该功能开启后，如果主机在等待同步备机达成多数派一致性的过程中被主动停止，不会提示“该事务已在本地提交，可能未同步到远端”，避免上层业务以为数据已经达成一致。
>
>- 该功能开启后，因为等待同步的时间会由于持久化数据而变长，带有同步备的主备集群的性能会受到影响。测试数据显示，与不开启该功能相比，性能约下降20%。
+
+## hadr\_recovery\_time\_target
+
+**参数说明：**在流式容灾模式下设置hadr\_recovery\_time\_target能够让备数据库实例完成日志写入和回放。
+
+该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+**取值范围**：整型，0\~3600 （秒）
+
+0是指不开启日志流控，1\~3600是指备机能够在hadr\_recovery\_time\_target时间内完成日志的写入和回放，可以保证主数据库实例与备数据库实例切换时能够在hadr\_recovery\_time\_target秒完成日志写入和回放，保证备数据库实例能够快速升主。hadr\_recovery\_time\_target设置时间过小会影响主机的性能，设置过大会失去流控效果。
+
+**默认值：**0
+
+## hadr\_recovery\_point\_target
+
+**参数说明：**在流式容灾模式下设置hadr\_recovery\_point\_target能够让备数据库实例完成日志刷盘的rpo时间。
+
+该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+**取值范围**：整型，0\~3600 （秒）
+
+0是指不开启日志流控，1\~3600是指备机能够在hadr\_recovery\_point\_target时间内完成日志的刷盘，可以保证主数据库实例与备数据库实例切换时日志差距能够在hadr\_recovery\_point\_target秒内，保障备数据库实例升主日志量。hadr\_recovery\_point\_target设置时间过小会影响主机的性能，设置过大会失去流控效果。
+
+**默认值：**0
+
+## hadr\_super\_user\_record\_path
+
+**参数说明**：该参数为流式异地容灾参数，表示备数据库实例中hadr\_disaster用户的加密文件存放路径。该参数属于SIGHUP类型参数，请
+
+参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中方式对应设置方法进行设置。
+
+**修改建议：**由流式容灾密码传递工具自动设置，不需要用户手动添加。
+
+**取值范围**：字符串
+
+**默认值**：NULL
+
+> **须知：**
+>
+>- 在一个包含了主机、备机和级联备的数据库实例中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。
+>- 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要在接收端配置为none\_node，发送端若为备机只能配置为none\_node，发送端若为主机，配置为none\_node时主机与所有备机都不同步，为only\_sync\_node时仅与同步备同步，不与异步备同步。
+>- 配置参数同步的具体表现为，发送端发送配置文件，对接收端配置文件中的对应参数直接覆盖。若设置了配置文件需要同步的策略，则修改接收端配置参数后，发送端会立刻覆盖接收端的配置参数，使得接收端修改不生效。
+>- 即使设置了配置文件需要同步的策略，仍有部分配置参数不会被同步。包括："application\_name", "archive\_command", "audit\_directory", "available\_zone", "comm\_control\_port", "comm\_sctp\_port", "listen\_addresses", "log\_directory", "port", "replconninfo1", "replconninfo2", "replconninfo3", "replconninfo4", "replconninfo5", "replconninfo6", "replconninfo7", "replconninfo8", "replconninfo9", "replconninfo10", "replconninfo11", "replconninfo12", "replconninfo13", "replconninfo14", "replconninfo15", "replconninfo16", "replconninfo17", "replconninfo18", "ssl", "ssl\_ca\_file", "ssl\_cert\_file", "ssl\_ciphers", "ssl\_crl\_file", "ssl\_key\_file", "ssl\_renegotiation\_limit", "ssl\_cert\_notify\_time", "synchronous\_standby\_names", "local\_bind\_address", "perf\_directory", "query\_log\_directory", "asp\_log\_directory", "streaming\_router\_port", "enable\_upsert\_to\_merge", "archive\_dest", "recovery\_min\_apply\_delay", "sync\_config\_strategy"。
+
diff --git "a/content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md" "b/content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md"
rename to "content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md"
index 3b27d37b099ec92fe734f8ce82cee9b5757afec9..79009f24411de5465652b6952a59bceab593fae7 100644
--- "a/content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md"
+++ "b/content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\345\274\200\351\224\200\345\270\270\351\207\217.md"
@@ -1,4 +1,4 @@
-# 优化器开销常量
+# 优化器开销常量
介绍优化器开销常量。这里描述的开销可以按照任意标准度量。只关心其相对值，因此以相同的系数缩放它们将不会对优化器的选择产生任何影响。缺省时，它们以抓取顺序页的开销为基本单位。也就是说将seq\_page\_cost设为1.0，同时其他开销参数以它为基准设置。也可以使用其他基准，比如以毫秒计的实际执行时间。
@@ -18,14 +18,14 @@
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>虽然服务器允许将random\_page\_cost设置的比seq\_page\_cost小，但是物理上实际不受影响。如果所有数据库都位于随机访问内存中时，两者设置为相等很合理。因为在此种情况下，非顺序抓取页并没有副作用。同样，在缓冲率很高的数据库上，应该相对于CPU参数同时降低这两个值，因为获取内存中的页要比通常情况下开销小很多。
**取值范围**：浮点型，0～DBL\_MAX。
**默认值**：4
-> **说明：**
+> **说明：**
>- 对于特别表空间中的表和索引，可以通过设置同名的表空间的参数来覆盖这个值。
>- 相对于seq\_page\_cost，减少这个值将导致系统更倾向于使用索引扫描，而增加这个值使得索引扫描开销比较高。可以通过同时增加或减少这两个值来调整磁盘I/O相对于CPU的开销。
diff --git "a/content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md" "b/content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md"
similarity index 99%
rename from "content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md"
rename to "content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md"
index 16815bb2c0742db45f7a0b5fc52581cb1c36c41b..e2dd6929ecbfeda02cc8199e33a5ee838bc9bf80 100644
--- "a/content/zh/docs/DataBaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md"
+++ "b/content/zh/docs/DatabaseReference/\344\274\230\345\214\226\345\231\250\346\226\271\346\263\225\351\205\215\347\275\256.md"
@@ -1,4 +1,4 @@
-# 优化器方法配置
+# 优化器方法配置
这些配置参数提供了影响查询优化器选择查询规划的原始方法。如果优化器为特定的查询选择的缺省规划并不是最优的，可以通过使用这些配置参数强制优化器选择一个不同的规划来临时解决这个问题。更好的方法包括调节优化器开销常量、手动运行ANALYZE、增加配置参数default\_statistics\_target的值、增加使用ALTER TABLE SET STATISTICS为指定列增加收集的统计信息。
diff --git "a/content/zh/docs/DataBaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md" "b/content/zh/docs/DatabaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md"
similarity index 99%
rename from "content/zh/docs/DataBaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md"
rename to "content/zh/docs/DatabaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md"
index 5627c5777d87808b5bbaab48eb3aa839fb3841d0..b65a5cb9c50be0eee3d5b73898b9e0d149a45324 100644
--- "a/content/zh/docs/DataBaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md"
+++ "b/content/zh/docs/DatabaseReference/\344\275\277\347\224\250CSV\346\240\274\345\274\217\345\206\231\346\227\245\345\277\227.md"
@@ -1,4 +1,4 @@
-# 使用CSV格式写日志
+# 使用CSV格式写日志
## 前提条件
@@ -184,7 +184,7 @@ application_name text
COPY gaussdb_log FROM '/opt/data/pg_log/logfile.csv' WITH csv;
```
-> **说明：**
+> **说明：**
>此处的日志名“logfile.csv”要换成实际生成的日志的名称。
## 简化输入
diff --git "a/content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md" "b/content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md"
similarity index 76%
rename from "content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md"
rename to "content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md"
index d5c94abe8e127ed3362473f4a888779ad73e39b8..8cabb2bf77ee8169cd587de1150feb51be627596 100644
--- "a/content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250.md"
@@ -1,4 +1,4 @@
-# 全局临时表
+# 全局临时表
## max\_active\_global\_temporary\_table
@@ -27,7 +27,7 @@
**参数说明：**是否支持全局临时表truncate table和DML的并发执行，以及全局临时表truncate table和truncate table的并发执行。
-该参数SIGHUP类型参数，请参考[表1](https://gitee.com/opengauss/docs/blob/33dd523b07ca669b90346b9831510ee891c05069/content/docs-lite/zh/docs/DeveloperGuide/重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+该参数SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**取值范围：**布尔型
diff --git "a/content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md" "b/content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md"
similarity index 76%
rename from "content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md"
rename to "content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md"
index d5c94abe8e127ed3362473f4a888779ad73e39b8..8cabb2bf77ee8169cd587de1150feb51be627596 100644
--- "a/content/zh/docs/DataBaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md"
+++ "b/content/zh/docs/DatabaseReference/\345\205\250\345\261\200\344\270\264\346\227\266\350\241\250_GUC.md"
@@ -1,4 +1,4 @@
-# 全局临时表
+# 全局临时表
## max\_active\_global\_temporary\_table
@@ -27,7 +27,7 @@
**参数说明：**是否支持全局临时表truncate table和DML的并发执行，以及全局临时表truncate table和truncate table的并发执行。
-该参数SIGHUP类型参数，请参考[表1](https://gitee.com/opengauss/docs/blob/33dd523b07ca669b90346b9831510ee891c05069/content/docs-lite/zh/docs/DeveloperGuide/重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+该参数SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**取值范围：**布尔型
diff --git "a/content/zh/docs/DataBaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md" "b/content/zh/docs/DatabaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md"
rename to "content/zh/docs/DatabaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md"
index 16e3e1ca3be69e26fa8e8148eab72fd1fc1f35f5..e78c1ea2cdf209e65d4feb0a6241efdeda7bb7a0 100644
--- "a/content/zh/docs/DataBaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md"
+++ "b/content/zh/docs/DatabaseReference/\345\205\266\344\273\226\344\274\230\345\214\226\345\231\250\351\200\211\351\241\271.md"
@@ -1,4 +1,4 @@
-# 其他优化器选项
+# 其他优化器选项
## explain\_dna\_file
@@ -6,8 +6,10 @@
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
->这个参数的取值必须是绝对路径加上.csv格式的文件名。
+> **须知：**
+>
+>- 这个参数的取值必须是绝对路径加上.csv格式的文件名。
+>- 查询计划需为stream计划，才可以导出导出的csv信息的目标文件。
**取值范围**：字符串
@@ -26,7 +28,8 @@
- summary：代表是在pretty的基础上增加了对打印信息的分析。
- run：代表在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。
-**默认值**：pretty（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal）
+**默认值**：normal（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal,并行查询下除外）
+
## analysis\_options
@@ -36,12 +39,11 @@
**取值范围**：字符串
-- LLVM\_COMPILE表示在explain performance显示界面中显示每个线程的codegen编译时间。
+- LLVM\_COMPILE表示在开启并行执行，且explain的显示格式设置为非normal的条件下，explain显示界面中显示线程的codegen编译时间。
- HASH\_CONFLICT表示在数据库节点进程的pg\_log目录中的log日志中显示hash表的统计信息，包括hash表大小、hash链长、hash冲突情况。
- STREAM\_DATA\_CHECK表示对网络传输前后的数据进行CRC校验。
- > **说明：**
- >pretty模式当前版本不支持。
+
**默认值**：ALL,on\(\),off\(LLVM\_COMPILE、HASH\_CONFLICT、STREAM\_DATA\_CHECK\)，不开启任何定位功能。
@@ -207,6 +209,9 @@ set rewrite_rule=none; --关闭所有可选查询重写规则
**默认值**：1800，即30min
+> **须知：**
+> 由于内部的GPC清理周期为5分钟，也就是5分钟检查清理一次，所以并非一超时就被清理，而是超时后的下一个检查周期被清理，即超时后5分钟内被清理。
+
## enable\_global\_stats
**参数说明**：标识当前统计信息模式，区别采用全局统计信息收集模式还是单节点统计信息收集模式，默认创建为采用全局统计信息模式。当关闭该参数时，则默认收集openGauss第一个节点的统计信息，此时可能会影响生成查询计划的质量，但信息收集性能较优，建议客户谨慎考虑。该参数当前版本已废弃，请勿设置。
@@ -376,7 +381,7 @@ set sql_beta_feature=none;
**取值范围**：整型，-100～10000。
-> **须知：**
+> **须知：**
>
>- 比默认值大的正数数值增加了ANALYZE所需的时间，但是可能会改善优化器的估计质量。
>
@@ -404,13 +409,13 @@ set sql_beta_feature=none;
- off表示不检查约束。
- partition表示只检查继承的子表和UNION ALL子查询。
- > **须知：**
+ > **须知：**
>当constraint\_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。
**默认值**：partition
-> **说明：**
+> **说明：**
>目前， constraint\_exclusion缺省被打开，通常用来实现表分区。如果所有的表都打开它，对于简单的查询强加了额外的规划，并且对简单查询没有益处。如果不用分区表，可以关掉它。
## cursor\_tuple\_fraction
@@ -421,7 +426,7 @@ set sql_beta_feature=none;
**取值范围**：浮点型，0.0～1.0。
-> **须知：**
+> **须知：**
>比默认值小的值与使用“fast start”为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。
**默认值**：0.1
@@ -434,7 +439,7 @@ set sql_beta_feature=none;
**取值范围**：整型，1～INT\_MAX。
-> **须知：**
+> **须知：**
>比默认值小的数值将降低规划时间，但是可能生成差的执行计划。
**默认值**：8
@@ -447,7 +452,7 @@ set sql_beta_feature=none;
**取值范围**：整型，1～INT\_MAX。
-> **须知：**
+> **须知：**
>
>- 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。
>
@@ -467,7 +472,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
**默认值**：0
-> **须知：**
+> **须知：**
>
>- 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。
>
@@ -494,7 +499,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
- on表示允许开启代码生成优化。
- off表示不允许开启代码生成优化。
- > **须知：**
+ > **须知：**
>目前LLVM优化仅支持向量化执行引擎特性，在其他场景下建议关闭此参数。
**默认值**：on
@@ -510,7 +515,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
- partial表示当所计算表达式中即使包含部分未被codegen化的函数时，仍可借助表达式全codegen框架调用LLVM动态编译优化策略。
- pure表示当所计算表达式整体可被codegen化时，才考虑调用LLVM动态编译优化策略。
- > **须知：**
+ > **须知：**
>在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。
@@ -602,7 +607,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
- on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。
- off表示不使用面向列的hash表设计的Hash Agg算子。
-> **说明：**
+> **说明：**
>
>- 在开启enable\_sonic\_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景enable\_codegen打开后获得较大性能提升，对应的算子查询性能可能会出现劣化。
>
@@ -621,7 +626,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
- on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。
- off表示不使用面向列的hash表设计的Hash Join算子。
-> **说明：**
+> **说明：**
>
>- 当前开关仅适用于Inner Join的场景。
>
@@ -708,7 +713,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
- force\_generic\_plan表示强制走generic plan。
- force\_custom\_plan表示强制走custom plan。
-> **说明：**
+> **说明：**
>
>- 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。
>
@@ -778,7 +783,7 @@ OPTIMIZE\_PLAN表示通过动态规划算法进行代价估算的最优plan，
**取值范围**：整型，1\~64。打开固定SMP功能，系统会使用固定并行度。
-> **说明：**
+> **说明：**
>在开启并行查询后，请保证系统CPU、内存、网络等资源充足，以达到最佳效果。
**默认值**：1
diff --git "a/content/zh/docs/DataBaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md" "b/content/zh/docs/DatabaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md"
rename to "content/zh/docs/DatabaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md"
index 1b1d3308290d1f9ccb86a81189f91ee11dac016d..f2ca20d93603643ab8208c7fea9ada69df6a3862 100644
--- "a/content/zh/docs/DataBaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md"
+++ "b/content/zh/docs/DatabaseReference/\345\205\266\344\273\226\347\274\272\347\234\201.md"
@@ -1,4 +1,4 @@
-# 其他缺省
+# 其他缺省
主要介绍数据库系统默认的库加载参数。
@@ -16,7 +16,7 @@ dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir'
**取值范围：**字符串
-> **说明：**
+> **说明：**
>设置为空字符串，表示关闭自动路径搜索。
**默认值：**$libdir
diff --git "a/content/zh/docs/DataBaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md" "b/content/zh/docs/DatabaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md"
similarity index 94%
rename from "content/zh/docs/DataBaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md"
rename to "content/zh/docs/DatabaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md"
index 298e85c64d05e1af1d814e330a31d720ca5d496f..89a21b0cd186f6eb8a87cf432ff79526f0ce5f39 100644
--- "a/content/zh/docs/DataBaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md"
+++ "b/content/zh/docs/DatabaseReference/\345\205\266\345\256\203\351\200\211\351\241\271.md"
@@ -1,4 +1,4 @@
-# 其它选项
+# 其它选项
## enable\_default\_ustore\_table
@@ -158,7 +158,7 @@
**默认值：**空
-> **说明：**
+> **说明：**
>请勿手动设置该参数，设置不当将导致openGauss不可用。
## transparent\_encrypt\_kms\_url
@@ -183,9 +183,9 @@
## basebackup\_timeout
-**参数说明：**备份传输完成后连接无读写的超时时间。
+**参数说明：** 备份传输完成后连接无读写的超时时间。该参数并非备份超期时间，而是指服务端、客户端连接无数据交互后连接最长保持时间。
-通过gs\_basebackup工具作传输时，如果指定较高压缩率时，可能在传输表空间完成后超时（客户端需要压缩传输数据）。
+通过gs\_basebackup工具作传输时，如果指定较高压缩率时（压缩等级指定8或者9），可能在传输表空间完成后超时（客户端需要压缩传输数据）。
**取值范围：**整型，0 \~ INT\_MAX，单位为秒。其中0表示禁用该功能。
@@ -205,7 +205,7 @@
**参数说明**：自治事务最大链接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。
-该参数属于INTERNAL类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**取值范围**：0-1024
@@ -222,7 +222,7 @@
- off表示关闭SeqScan优化
**默认值**：off
-> **说明：**
+> **说明：**
>该参数只能优化EXPLAIN ANALYZE语句的seqscan算子的执行时间
## sql\_ignore\_strategy
@@ -231,7 +231,7 @@
该参数属于USERSET类型，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **说明：**
+> **说明：**
>ignore_error hint的信息请参考[将部分Error降级为Warning的Hint](../PerformanceTuningGuide/将部分Error降级为Warning的Hint.md)。
**取值范围：**枚举类型
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"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\345\206\205\345\255\230-21.md"
rename to "content/zh/docs/DatabaseReference/\345\206\205\345\255\230-21.md"
index 54f9fe76328a03e2e7319f39f8f748c93aa4a4cf..7f0f16a423a4b7fd1ea6899c4c14f23b7f3e285d 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"
@@ -1,8 +1,8 @@
-# 内存
+# 内存
介绍与内存相关的参数设置。
-> **须知：**
+> **须知：**
>这些参数只能在数据库服务重新启动后生效。
## memorypool\_enable
@@ -41,7 +41,7 @@
**默认值：**on
-> **注意：**
+> **注意：**
>
>- 若max\_process\_memory-shared\_buffers-cstore\_buffers-元数据少于2G，openGauss强制把enable\_memory\_limit设置为off。其中元数据是openGauss内部使用的内存和部分并发参数，如max\_connections、thread\_pool\_attr、max\_prepared\_transactions等参数相关。
>
@@ -61,7 +61,7 @@
数据库节点上该数值需要根据系统物理内存及单节点部署主数据库节点个数决定。建议计算公式如下：\(物理内存大小 - vm.min\_free\_kbytes\) \\\* 0.7 / \(1 + 主节点个数\)。该系数的目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点OOM。这个公式中提到vm.min\_free\_kbytes，其含义是预留操作系统内存供内核使用，通常用作操作系统内核中通信收发内存分配，至少为5%内存。即，max\_process\_memory = 物理内存 \* 0.665 / \(1 + 主节点个数\)。
-> **注意：**
+> **注意：**
>当该值设置不合理，即大于服务器物理内存，可能导致操作系统OOM问题。
## enable\_memory\_context\_control
@@ -178,7 +178,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**10
-> **说明：**
+> **说明：**
>
>一般不需要对事务显式进行PREPARE操作，如果业务对事务进行显示PREPARE操作，为避免在准备步骤失败，需要调大该值，大于需要进行PREPARE业务的并发数。
@@ -213,7 +213,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**0
-> **须知：**
+> **须知：**
>
>- 如果设置的query\_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。
>
@@ -229,7 +229,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**0
-> **须知：**
+> **须知：**
>
>- 如果设置的query\_max\_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。
>
@@ -257,7 +257,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>同样，多个正在运行的会话可能会同时进行表的局部排序操作。因此，使用的总内存可能是psort\_work\_mem的几倍。
@@ -271,7 +271,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>max\_loaded\_cudesc设置过高时，有可能引起内存分配不足。
@@ -348,7 +348,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
## resilience_memory_reject_percent
-**参数说明**：用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。该参数属于SIGHUP类型参数，请参考[表1](https://gitee.com/opengauss/docs/blob/33dd523b07ca669b90346b9831510ee891c05069/content/docs-lite/zh/docs/DeveloperGuide/重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+**参数说明**：用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**取值范围**：字符串，长度大于0
@@ -367,7 +367,7 @@ resilience_memory_reject_percent = '70,90'
表示内存使用超过最大内存上限的90%后禁止新连接接入并kill堆积的会话，kill会话过程中内存恢复到最大内存的70%以下时停止kill会话并允许新连接接入。
->  **须知：**
+>  **须知：**
>
> - 最大动态内存和已使用的动态内存可以通过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"
similarity index 88%
rename from "content/zh/docs/DataBaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/\345\206\205\345\255\230_GUC\345\217\202\346\225\260.md"
index 54f9fe76328a03e2e7319f39f8f748c93aa4a4cf..54469debae0e1f10e34b0e565b496f182692730f 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"
@@ -1,8 +1,8 @@
-# 内存
+# 内存
介绍与内存相关的参数设置。
-> **须知：**
+> **须知：**
>这些参数只能在数据库服务重新启动后生效。
## memorypool\_enable
@@ -41,7 +41,7 @@
**默认值：**on
-> **注意：**
+> **注意：**
>
>- 若max\_process\_memory-shared\_buffers-cstore\_buffers-元数据少于2G，openGauss强制把enable\_memory\_limit设置为off。其中元数据是openGauss内部使用的内存和部分并发参数，如max\_connections、thread\_pool\_attr、max\_prepared\_transactions等参数相关。
>
@@ -61,7 +61,7 @@
数据库节点上该数值需要根据系统物理内存及单节点部署主数据库节点个数决定。建议计算公式如下：\(物理内存大小 - vm.min\_free\_kbytes\) \\\* 0.7 / \(1 + 主节点个数\)。该系数的目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点OOM。这个公式中提到vm.min\_free\_kbytes，其含义是预留操作系统内存供内核使用，通常用作操作系统内核中通信收发内存分配，至少为5%内存。即，max\_process\_memory = 物理内存 \* 0.665 / \(1 + 主节点个数\)。
-> **注意：**
+> **注意：**
>当该值设置不合理，即大于服务器物理内存，可能导致操作系统OOM问题。
## enable\_memory\_context\_control
@@ -178,7 +178,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**10
-> **说明：**
+> **说明：**
>
>一般不需要对事务显式进行PREPARE操作，如果业务对事务进行显示PREPARE操作，为避免在准备步骤失败，需要调大该值，大于需要进行PREPARE业务的并发数。
@@ -213,7 +213,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**0
-> **须知：**
+> **须知：**
>
>- 如果设置的query\_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。
>
@@ -229,7 +229,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值：**0
-> **须知：**
+> **须知：**
>
>- 如果设置的query\_max\_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。
>
@@ -257,7 +257,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>同样，多个正在运行的会话可能会同时进行表的局部排序操作。因此，使用的总内存可能是psort\_work\_mem的几倍。
@@ -271,7 +271,7 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>max\_loaded\_cudesc设置过高时，有可能引起内存分配不足。
@@ -346,9 +346,35 @@ segment\_buffers 用来缓存段页式段头的内容，属于关键元数据信
**默认值**：256MB
+## memory\_trace\_level
+
+**参数说明**：动态内存使用超过最大动态内存的90%后，记录内存申请信息的管控等级。该参数仅在use\_workload\_manager和enable\_memory\_limit打开时生效。该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+**取值范围**：枚举型
+
+- none：表示不记录内存申请信息。
+- level1：动态内存使用超过最大动态内存的90%后，会记录以下信息，并将记录的内存信息保存在$GAUSSLOG/mem\_log目录下。
+ - 全局内存概况。
+ - instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
+ - 每个内存上下文的totalsize、freesize字段。
+
+- level2：动态内存使用超过最大动态内存的90%后，会记录以下信息，并将记录的内存信息保存在$GAUSSLOG/mem\_log目录下。
+ - 全局内存概况。
+ - instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
+ - 每个内存上下文的totalsize，freesize字段。
+ - 每个内存上下文上所有内存申请的详细信息，包含申请内存所在的文件，行号和大小。
+
+**默认值**：level1
+
+> **须知：**
+>
+>- 该参数设置为level2后，会记录每个内存上下文的内存申请详情（file，line，size字段），会对性能影响较大，需慎重设置。
+>- 记录的内存快照信息可以通过系统函数gs\_get\_history\_memory\_detail\(cstring\)查询，函数详情请参考“SQL参考 \> 函数和操作符 \> 统计信息函数”章节查询。
+>- 记录的内存上下文是经过将同一类型所有重名的内存上下文进行汇总之后得到的。
+
## resilience_memory_reject_percent
-**参数说明**：用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。该参数属于SIGHUP类型参数，请参考[表1](https://gitee.com/opengauss/docs/blob/33dd523b07ca669b90346b9831510ee891c05069/content/docs-lite/zh/docs/DeveloperGuide/重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+**参数说明**：用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**取值范围**：字符串，长度大于0
@@ -367,7 +393,7 @@ resilience_memory_reject_percent = '70,90'
表示内存使用超过最大内存上限的90%后禁止新连接接入并kill堆积的会话，kill会话过程中内存恢复到最大内存的70%以下时停止kill会话并允许新连接接入。
->  **须知：**
+>  **须知：**
>
> - 最大动态内存和已使用的动态内存可以通过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\350\241\250.md" "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230\350\241\250.md"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\345\206\205\345\255\230\350\241\250.md"
rename to "content/zh/docs/DatabaseReference/\345\206\205\345\255\230\350\241\250.md"
index b67602bae4132db8a90aef80341e861bd832845a..b53de9edc17b947e303fc6f54a91081bffcfd057 100644
--- "a/content/zh/docs/DataBaseReference/\345\206\205\345\255\230\350\241\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\206\205\345\255\230\350\241\250.md"
@@ -1,4 +1,4 @@
-# 内存表
+# 内存表
介绍内存表的配置参数。
@@ -22,7 +22,7 @@
**默认值**：true
-> **说明：**
+> **说明：**
>即使将force\_pseudo\_codegen\_mot设置为true，而当前平台不支持原生LLVM，那么仍然会使用伪LLVM。
## enable\_codegen\_mot\_print
diff --git "a/content/zh/docs/DataBaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md" "b/content/zh/docs/DatabaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md"
similarity index 95%
rename from "content/zh/docs/DataBaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md"
rename to "content/zh/docs/DatabaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md"
index 433038db9b9b2b0d23981f9e8e0271e1478b2658..3c3f8cc7cec24f74726f5660d829106fc8c2a4af 100644
--- "a/content/zh/docs/DataBaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\206\205\346\240\270\350\265\204\346\272\220\344\275\277\347\224\250.md"
@@ -1,4 +1,4 @@
-# 内核资源使用
+# 内核资源使用
介绍与操作系统内核相关的参数，这些参数是否生效依赖于操作系统的设置。
@@ -24,7 +24,7 @@
该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>- 如果被声明的库不存在，openGauss服务将会启动失败。
>- 每一个支持openGauss的库都有一个特殊的标记用于保证兼容性。因此，不支持openGauss的库不能用这种方法加载。
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"
similarity index 94%
rename from "content/zh/docs/DataBaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md"
rename to "content/zh/docs/DatabaseReference/\345\214\272\345\237\237\345\222\214\346\240\274\345\274\217\345\214\226.md"
index 11f9471316cc839cbfe44ab0b15d11c5a21d2f52..d2f36c83fb772e228372ceee0fc4485bc58cba0b 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"
@@ -1,4 +1,4 @@
-# 区域和格式化
+# 区域和格式化
介绍时间格式设置的相关参数。
@@ -14,7 +14,7 @@
**默认值：**ISO, MDY
-> **说明：**
+> **说明：**
>
>gs\_initdb会将这个参数初始化成与[lc\_time](#zh-cn_topic_0283136798_zh-cn_topic_0237124733_zh-cn_topic_0059778109_scbb410b3c5c94682a3eec218c7ff0220)一致的值。
@@ -34,7 +34,7 @@
- iso\_8601表示产生与在ISO 8601中定义的“格式与代号”相匹配的输出。
- a表示与numtodsinterval函数相匹配的输出结果，详细请参考[numtodsinterval](../SQLReference/时间和日期处理函数和操作符.md#zh-cn_topic_0283136846_zh-cn_topic_0237121972_zh-cn_topic_0059779084_lf9dae2de082b41c094177f70cf798433)。
-> **须知：**
+> **须知：**
>
>IntervalStyle参数也会影响不明确的间隔输入的说明。
@@ -50,7 +50,7 @@
**默认值：**GMT
-> **说明：**
+> **说明：**
>
>gs\_initdb将设置一个与其系统环境一致的时区值。
@@ -64,7 +64,7 @@
**默认值：**Default
-> **说明：**
+> **说明：**
>
>Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。
@@ -76,7 +76,7 @@
**取值范围：**整型，-15～3
-> **说明：**
+> **说明：**
>
>- 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。
>- 设置为负数，表示消除不需要的数据位。
@@ -93,7 +93,7 @@
**取值范围：**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。
-> **说明：**
+> **说明：**
>
>- 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
>- 默认情况下，gs\_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
@@ -115,7 +115,7 @@
**取值范围：**字符串
-> **说明：**
+> **说明：**
>
>- 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
>- 默认情况下，gs\_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
@@ -130,7 +130,7 @@
**取值范围：**字符串
-> **说明：**
+> **说明：**
>
>- 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
>- 默认情况下，gs\_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
@@ -145,7 +145,7 @@
**取值范围：**字符串
-> **说明：**
+> **说明：**
>
>- 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
>- 默认情况下，gs\_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
@@ -160,7 +160,7 @@
**取值范围：**字符串
-> **说明：**
+> **说明：**
>
>- 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
>- 默认情况下，gs\_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
@@ -181,7 +181,7 @@
**取值范围：**字符串
-> **说明：**
+> **说明：**
>
>openGauss支持pg\_catalog.english、pg\_catalog.simple两种配置。
diff --git "a/content/zh/docs/DataBaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md"
similarity index 93%
rename from "content/zh/docs/DataBaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md"
index 15ad874a11389b41bc78c498f20ecf2ac8f6d7a1..376d4494fa61666feed2b54f3d86f65016e48637 100644
--- "a/content/zh/docs/DataBaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/\345\215\207\347\272\247\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# 升级参数
+# 升级参数
## IsInplaceUpgrade
@@ -37,5 +37,5 @@
**默认值**：0
-> **说明：**
+> **说明：**
>特殊情况：在使用灰度升级的情况下，若选择策略为大版本升级，即需要执行升级脚本和替换二进制包，会将upgrade_mode设置为2，选择策略为小版本升级，只替换二进制包，则不会设置upgrade_mode设置为2。
diff --git "a/content/zh/docs/DataBaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md" "b/content/zh/docs/DatabaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md"
similarity index 63%
rename from "content/zh/docs/DataBaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md"
rename to "content/zh/docs/DatabaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md"
index 75102252f9564b730bd027681570047b3f3b4c05..3216572c51a9849bfa3a7d986f4f5d437244e06d 100644
--- "a/content/zh/docs/DataBaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md"
+++ "b/content/zh/docs/DatabaseReference/\345\216\206\345\217\262\347\211\210\346\234\254\345\205\274\345\256\271\346\200\247.md"
@@ -1,127 +1,142 @@
-# 历史版本兼容性
+# 历史版本兼容性
openGauss介绍数据库的向下兼容性和对外兼容性特性的参数控制。数据库系统的向后兼容性能够为旧版本的数据库应用提供支持。本节介绍的参数主要控制数据库的向后兼容性。
## array\_nulls
-**参数说明：**控制数组输入解析器是否将未用引用的NULL识别为数组的一个NULL元素。
+**参数说明：** 控制数组输入解析器是否将未用引号的NULL识别为数组的一个NULL元素。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示允许向数组中输入空元素。
- off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。
-**默认值：**on
+**默认值：** on
## backslash\_quote
-**参数说明：**控制字符串文本中的单引号是否能够用\\'表示。
+**参数说明：** 控制字符串文本中的单引号是否能够用\\'表示。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'...'）。
-**取值范围：**枚举类型
+**取值范围：** 枚举类型
- on表示一直允许使用\\'表示。
- off表示拒绝使用\\'表示。
- safe\_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\\的ASCII值时允许。
-**默认值：**safe\_encoding
+**默认值：** safe\_encoding
## escape\_string\_warning
-**参数说明：**警告在普通字符串中直接使用反斜杠转义。
+**参数说明：** 警告在普通字符串中直接使用反斜杠转义。
- 如果需要使用反斜杠作为转义，可以调整为使用转义字符串语法（E'...'）来做转义，因为在每个SQL标准中，普通字符串的默认行为现在将反斜杠作为一个普通字符。
- 这个变量可以帮助定位需要改变的代码。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
-**默认值：**on
+**默认值：** on
## lo\_compat\_privileges
-**参数说明：**控制是否启动对大对象权限检查的向后兼容模式。
+**参数说明：** 控制是否启动对大对象权限检查的向后兼容模式。
该参数属于SUSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。
-**默认值：**off
+**默认值：** off
## quote\_all\_identifiers
-**参数说明：**当数据库生成SQL时，此选项强制引用所有的标识符（包括非关键字）。这将影响到EXPLAIN的输出及函数的结果，例如pg\_get\_viewdef。详细说明请参见gs\_dump的--quote-all-identifiers选项。
+**参数说明：** 当数据库生成SQL时，此选项强制引用所有的标识符（包括非关键字）。这将影响到EXPLAIN的输出及函数的结果，例如pg\_get\_viewdef。详细说明请参见gs\_dump的--quote-all-identifiers选项。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示打开强制引用。
- off表示关闭强制引用。
-**默认值：**off
+**默认值：** off
## sql\_inheritance
-**参数说明：**控制继承语义。用来控制继承表的访问策略，off表示各种命令不能访问子表，即默认使用ONLY关键字。这是为了兼容旧版本而设置的。
+**参数说明：** 控制继承语义。用来控制继承表的访问策略，off表示各种命令不能访问子表，即默认使用ONLY关键字。这是为了兼容旧版本而设置的。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示可以访问子表。
- off表示不访问子表。
-**默认值：**on
+**默认值：** on
## standard\_conforming\_strings
-**参数说明：**控制普通字符串文本（'...'）中是否按照SQL标准把反斜扛当普通文本。
+**参数说明：** 控制普通字符串文本（'...'）中是否按照SQL标准把反斜扛当普通文本。
- 应用程序通过检查这个参数可以判断字符串文本的处理方式。
- 建议明确使用转义字符串语法（E'...'）来转义字符。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示打开控制功能。
- off表示关闭控制功能。
-**默认值：**on
+**默认值：** on
## synchronize\_seqscans
-**参数说明：**控制启动同步的顺序扫描。在大约相同的时间内并行扫描读取相同的数据块，共享I/O负载。
+**参数说明：** 控制启动同步的顺序扫描。在大约相同的时间内并行扫描读取相同的数据块，共享I/O负载。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示扫描可能从表的中间开始，然后选择“环绕”方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。
- off表示确保顺序扫描是从表头开始的。
-**默认值：**on
+**默认值：** on
## enable\_beta\_features
-**参数说明：**控制开启某些非正式发布的特性，仅用于POC验证。这些特性属于延伸特性，建议客户谨慎开启，在某些功能场景下可能存在问题。
+**参数说明：** 控制开启某些非正式发布的特性，仅用于POC验证。这些特性属于延伸特性，建议客户谨慎开启，在某些功能场景下可能存在问题。
该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。
-**取值范围：**布尔型
+**取值范围：** 布尔型
- on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。
- off表示禁止使用这些特性。
-**默认值：**off
+**默认值：** off
+
+## default\_with\_oids
+
+**参数说明：** 在没有声明WITH OIDS和WITHOUT OIDS的情况下，这个选项控制在新创建的表中CREATE TABLE和CREATE TABLE AS是否包含一个OID字段。它还决定SELECT INTO创建的表里面是否包含OID 。该参数暂未使用。
+
+不推荐在用户表中使用OID，故默认设置为off。需要带有OID字段的表应该在创建时声明WITH OIDS 。
+
+该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+**取值范围：** 布尔型
+
+- on表示在新创建的表中CREATE TABLE和CREATE TABLE AS可以包含一个OID字段。
+- off表示在新创建的表中CREATE TABLE和CREATE TABLE AS不可以包含一个OID字段。
+
+**默认值：** off
diff --git "a/content/zh/docs/DataBaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md"
similarity index 87%
rename from "content/zh/docs/DataBaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md"
index 4692ce1cee48b26146ad73ca45f899f168792d53..7aa2e15b6b816c55c49cf7961f74cad35de71fb8 100644
--- "a/content/zh/docs/DataBaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/\345\217\214\346\225\260\346\215\256\345\272\223\345\256\236\344\276\213\345\244\215\345\210\266\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# 双数据库实例复制参数
+# 双数据库实例复制参数
## RepOriginId
diff --git "a/content/zh/docs/DataBaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md" "b/content/zh/docs/DatabaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md"
similarity index 73%
rename from "content/zh/docs/DataBaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md"
rename to "content/zh/docs/DatabaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md"
index 86d130237019e3a46d5f429efb8bdc916bfb5bf9..435b39470a937a144d7458f0b564d87a497a6a97 100644
--- "a/content/zh/docs/DataBaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md"
+++ "b/content/zh/docs/DatabaseReference/\345\217\214\346\234\272\345\244\215\345\210\266.md"
@@ -1,4 +1,4 @@
-# 双机复制
+# 双机复制
- **[发送端服务器](发送端服务器.md)**
diff --git "a/content/zh/docs/DataBaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md" "b/content/zh/docs/DatabaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md"
similarity index 89%
rename from "content/zh/docs/DataBaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md"
rename to "content/zh/docs/DatabaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md"
index b0fbf34cae6c76b776fbabbb098ba68c1e81307a..f7c023a65a9319c9d2b9a98d9f4cf1d9c1da21e5 100644
--- "a/content/zh/docs/DataBaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\217\221\351\200\201\347\253\257\346\234\215\345\212\241\345\231\250.md"
@@ -1,4 +1,4 @@
-# 发送端服务器
+# 发送端服务器
## max\_wal\_senders
@@ -6,7 +6,7 @@
该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>[wal\_level](设置.md#zh-cn_topic_0283137354_zh-cn_topic_0237124707_zh-cn_topic_0059778393_s2c76f5957066407a959191148f2c780f)必须设置为archive或者hot\_standby以允许备机的连接。
@@ -43,7 +43,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>- 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为600s。
>
@@ -117,13 +117,30 @@
**默认值**：8192
+## logical\_decode\_options\_default
+
+**参数说明**：指定逻辑解码启动时未指定解码选项的全局默认值。
+
+该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+当前支持指定的逻辑解码选项包括：parallel-decode-num, parallel-queue-size, max-txn-in-memory, max-reorderbuffer-in-memory, exclude-users。选项的意义请参考《开发者指南》的“应用程序开发教程 \> 基于JDBC开发 \> 示例：逻辑复制代码示例”章节。
+
+**取值范围**：通过逗号分隔的key=value字符串，例如：'parallel-decode-num=4,parallel-queue-size=128,exclude-users=userA'。其中空字符串表示采用程序硬编码的默认值。
+
+**默认值：**""
+
+> **须知：**
+>
+>- 该参数SIGHUP生效并不会影响已经启动的逻辑解码流程；后续逻辑解码启动将使用该参数设置的选项作为其默认配置，并优先使用启动命令中指定选项的设置。
+>- 这里exclude-users选项和逻辑解码启动选项存在差异，不允许指定多个黑名单用户。
+
## enable\_wal\_shipping\_compression
**参数说明：** 在流式容灾模式下设置启动跨数据库实例日志压缩功能。
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>该参数仅作用于流式容灾中跨数据库实例传输的一对walsender与walreceiver中，在主数据库实例上配置。
**取值范围**：布尔型
@@ -139,7 +156,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>- 如果主机上开启了UUID验证功能、且配置了非空字符串的repl\_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl\_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。
>- 该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。
@@ -161,7 +178,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>- 如果主机上开启了UUID验证功能、且配置了非空字符串的repl\_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl\_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。
>- 该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。
@@ -342,3 +359,13 @@
**取值范围：** 字符串。其中空字符串表示没有配置节点信息。
**默认值：** 空字符串
+
+## max\_keep\_log\_seg
+
+**参数说明：**流控参数，逻辑复制在DN本地会解析物理日志转换成逻辑日志，当未被解析的物理日志文件数量大于该参数时会触发限流。此参数为0表示关闭限流功能。
+
+该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
+
+**取值范围：**整型，0 \~ 2147483647。
+
+**默认值：**0
\ No newline at end of file
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"
similarity index 98%
rename from "content/zh/docs/DataBaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md"
rename to "content/zh/docs/DatabaseReference/\345\220\216\347\253\257\345\206\231\350\277\233\347\250\213.md"
index fc62b8a018f92be7de0e60f47d353ffc79c6f89c..4749759992a5c776d307910ce402f57ca69591ab 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"
@@ -1,4 +1,4 @@
-# 后端写进程
+# 后端写进程
介绍后端写（background writer）进程的参数配置。后端写进程的功能就是把共享缓冲区中的脏数据（指共享缓冲区中新增或者修改的内容）写入到磁盘。目的是让数据库进程在进行用户查询时可以很少或者几乎不等待写动作的发生（写动作由后端写进程完成）。
@@ -36,7 +36,7 @@
**取值范围：**整型，0～1000
-> **说明：**
+> **说明：**
>此参数设置为0表示禁用后端写功能，禁用后端写功能不会对checkpoints产生影响。
**默认值：**100
diff --git "a/content/zh/docs/DataBaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md" "b/content/zh/docs/DatabaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md"
similarity index 98%
rename from "content/zh/docs/DataBaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md"
rename to "content/zh/docs/DatabaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md"
index 0ecc0a61ef8669fbe1de1bd48a78a060d2c11b08..271b55b16547ae0ffe4715fdff1fec3917d5075b 100644
--- "a/content/zh/docs/DataBaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md"
+++ "b/content/zh/docs/DatabaseReference/\345\221\212\350\255\246\346\243\200\346\265\213.md"
@@ -1,4 +1,4 @@
-# 告警检测
+# 告警检测
在openGauss运行的过程中，会对数据库中的错误场景进行检测，便于用户及早感知到openGauss的错误。
diff --git "a/content/zh/docs/DataBaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md"
similarity index 86%
rename from "content/zh/docs/DataBaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md"
index 04c6843d8c3da7e8e2ac8a8a4bcbdd318420d286..f4ace392cdfa6044867e6a7b4da6d8fd2c0dc5eb 100644
--- "a/content/zh/docs/DataBaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/\345\233\236\346\273\232\347\233\270\345\205\263\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# 回滚相关参数
+# 回滚相关参数
## max\_undo\_workers
diff --git "a/content/zh/docs/DataBaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md" "b/content/zh/docs/DatabaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md"
similarity index 97%
rename from "content/zh/docs/DataBaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md"
rename to "content/zh/docs/DatabaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md"
index 87f9b2191f28608f3c2518087aecec89711ce0d5..201e4fce3042ca090bcd53ff61e992ff49140c66 100644
--- "a/content/zh/docs/DataBaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md"
+++ "b/content/zh/docs/DatabaseReference/\345\237\272\344\272\216\345\274\200\351\224\200\347\232\204\346\270\205\347\220\206\345\273\266\350\277\237.md"
@@ -1,8 +1,8 @@
-# 基于开销的清理延迟
+# 基于开销的清理延迟
这个特性的目的是允许管理员减少VACUUM和ANALYZE语句在并发活动的数据库上的I/O影响。比如，像VACUUM和ANALYZE这样的维护语句并不需要迅速完成，并且不希望他们严重干扰系统执行其他的数据库操作。基于开销的清理延迟为管理员提供了一个实现这个目的手段。
-> **须知：**
+> **须知：**
>有些清理操作会持有关键的锁，这些操作应该尽快结束并释放锁。所以openGauss的机制是，在这类操作过程中，基于开销的清理延迟不会发生作用。为了避免在这种情况下的长延时，实际的开销限制取下面两者之间的较大值：
>- vacuum\_cost\_delay\*accumulated\_balance/vacuum\_cost\_limit
>
diff --git "a/content/zh/docs/DataBaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md" "b/content/zh/docs/DatabaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md"
similarity index 90%
rename from "content/zh/docs/DataBaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md"
rename to "content/zh/docs/DatabaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md"
index 20718dbcdcd2e0abe64e3ba2b2fa6d894ebbb3aa..667f3a54b826d7f6209168e015bbbd757e0212d4 100644
--- "a/content/zh/docs/DataBaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\237\272\345\233\240\346\237\245\350\257\242\344\274\230\345\214\226\345\231\250.md"
@@ -1,4 +1,4 @@
-# 基因查询优化器
+# 基因查询优化器
介绍基因查询优化器相关的参数。基因查询优化器（GEQO）是一种启发式的查询规划算法。这个算法减少了对复杂查询规划的时间，而且生成规划的开销有时也小于正常的详尽的查询算法。
@@ -8,7 +8,7 @@
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>通常情况下在执行过程中不要关闭，geqo\_threshold变量提供了更精细的控制GEQO的方法。
**取值范围**：布尔型
@@ -24,7 +24,7 @@
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>- 对于简单的查询，通常用详尽搜索方法，当涉及多个表的查询的时候，用GEQO可以更好的管理查询。
>- 一个FULL OUTER JOIN构造仅作为一个FROM项。
@@ -38,12 +38,12 @@
该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>geqo\_effort实际上并没有直接做任何事情，只是用于计算其他影响GEQO的变量的默认值。如果愿意，可以手工设置其他参数。
**取值范围**：整型，1～10。
-> **须知：**
+> **须知：**
>比默认值大的数值增加了查询规划的时间，但是也增加了选中有效查询的几率。
**默认值**：5
@@ -56,7 +56,7 @@
**取值范围**：整型，0～INT\_MAX。
-> **须知：**
+> **须知：**
>至少是2，且有用的值一般在100到1000之间。设置为0，表示使用系统自适应方式，openGauss会基于geqo\_effort和表的个数选取合适的值。
**默认值**：0
@@ -69,7 +69,7 @@
**取值范围**：整型，0～INT\_MAX。
-> **须知：**
+> **须知：**
>必须至少是1，且有用的值介于100和1000之间。如果设置为0，则基于geqo\_pool\_size选取合适的值。
**默认值**：0
@@ -92,7 +92,7 @@
**取值范围**：浮点型，0.0～1.0。
-> **须知：**
+> **须知：**
>不同的值会改变搜索的连接路径，从而影响了所找路径的优劣。
**默认值**：0
diff --git "a/content/zh/docs/DataBaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md" "b/content/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md"
similarity index 96%
rename from "content/zh/docs/DataBaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md"
rename to "content/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md"
index c815f3f86bca0c91ae9641a28b1671eab37efbac..f4459ad9f30d67ce04ab6b435d3dbe89327d98db 100644
--- "a/content/zh/docs/DataBaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md"
+++ "b/content/zh/docs/DatabaseReference/\345\244\207\344\273\275\346\201\242\345\244\215.md"
@@ -1,4 +1,4 @@
-# 备份恢复
+# 备份恢复
## operation\_mode
diff --git "a/content/zh/docs/DataBaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md" "b/content/zh/docs/DatabaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md"
similarity index 94%
rename from "content/zh/docs/DataBaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md"
rename to "content/zh/docs/DatabaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md"
index 3deedbbabead4e7f7b0fbb742bff40a1774cd061..8fab80d66636a916a25c8e2ee81de37cbdaf5026 100644
--- "a/content/zh/docs/DataBaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md"
+++ "b/content/zh/docs/DatabaseReference/\345\244\207\346\234\215\345\212\241\345\231\250.md"
@@ -1,4 +1,4 @@
-# 备服务器
+# 备服务器
## hot\_standby
@@ -6,7 +6,7 @@
该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>- 如果此参数设置为on，[wal\_level](设置.md#zh-cn_topic_0283137354_zh-cn_topic_0237124707_zh-cn_topic_0059778393_s2c76f5957066407a959191148f2c780f)必须设置为hot\_standby，否则将导致数据库无法启动。
>- 在双机环境中，因为会对双机其他一些功能产生影响，hot\_standby参数不能设置成off。
>- 如果hot\_standby参数曾经被关闭，且wal\_level参数曾被设置低于hot\_standby等级，那么，再次打开hot\_standby参数之前，为了确保主备环境下备机上待回放的日志都可以支持备机查询功能，需要进行如下操作：
@@ -27,7 +27,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>-1表示允许备机一直等待冲突的查询完成。
**取值范围：**整型，范围：-1\~INT\_MAX，单位为毫秒。
@@ -40,7 +40,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>-1表示允许备机一直等待冲突的查询完成。
**取值范围：**整型（毫秒），范围：-1\~INT\_MAX。
@@ -57,7 +57,7 @@
**默认值：**5s**（即**5000ms）
->  **须知：**
+>  **须知：**
> 当该参数设置为0时，表示关闭备机向主机反馈日志接收位置等信息，可能会导致主机事务提交阻塞、switchover操作失败等异常现象。正常业务场景，不建议将该参数设置为0。
## hot\_standby\_feedback
@@ -73,7 +73,7 @@
**默认值：**off
-> **须知：**
+> **须知：**
>当该参数为on时，主机的旧版本数据的清理会受限于备机正在读的事务，即主机只允许清理小于备机反馈回来的事务所作的更改。
>所以，若该参数开启时，会影响主机的性能。
diff --git "a/content/zh/docs/DataBaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md"
similarity index 88%
rename from "content/zh/docs/DataBaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md"
rename to "content/zh/docs/DatabaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md"
index 8ec5ed50a59785eb9b60d3d990025a153e3533b3..b2b6f34924464543a6f5562d8408276b763f12a5 100644
--- "a/content/zh/docs/DataBaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/DatabaseReference/\345\244\207\346\234\272\346\224\257\346\214\201\345\206\231\350\257\255\345\217\245\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# 备机支持写语句参数
+# 备机支持写语句参数
## enable\_remote\_excute
@@ -10,7 +10,7 @@
**默认值：**off
-> **说明：**
+> **说明：**
>- enable\_remote\_excute参数在单机模式下默认false。
>- 若开启备机允许执行写语句需要将此参数设置为true。
>- 开关打开后，允许备机执行写语句和DDL，支持简单查询和扩展查询；此状态下读语句仍然在备机执行，写语句会转发到主机执行。
diff --git "a/content/zh/docs/DataBaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md" "b/content/zh/docs/DatabaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md"
similarity index 97%
rename from "content/zh/docs/DataBaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md"
rename to "content/zh/docs/DatabaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md"
index c93d7041597d07eb860151de4928fe4a805d39e4..b7e62817021fd80f76a0f2b5c687c18c7f518f0f 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\211\345\205\250\345\222\214\350\256\244\350\257\201_postgresql-conf.md"
@@ -1,4 +1,4 @@
-# 安全和认证（postgresql.conf）
+# 安全和认证（postgresql.conf）
介绍设置客户端和服务器的安全认证方式的相关参数。
@@ -22,7 +22,7 @@
**默认值：**10000
-> **须知：**
+> **须知：**
>迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化，请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。
## session\_authorization
@@ -55,7 +55,7 @@
**默认值：**0
-> **须知：**
+> **须知：**
>openGauss gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。
## ssl
@@ -69,10 +69,10 @@
- on表示启用SSL连接。
- off表示不启用SSL连接。
-> **须知：**
+> **须知：**
>开启此参数需要同时配置ssl\_cert\_file、ssl\_key\_file和ssl\_ca\_file等参数及对应文件，不正确的配置可能会导致openGauss无法正常启动。
-**默认值：**on
+**默认值：**off
## require\_ssl
@@ -85,7 +85,7 @@
- on表示服务器端强制要求SSL连接。
- off表示服务器端对是否通过SSL连接不作强制要求。
-> **须知：**
+> **须知：**
>openGauss目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。
**默认值：**off
@@ -204,7 +204,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>从安全性考虑，请勿关闭密码复杂度策略。
**取值范围：**0、1
@@ -220,7 +220,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>修改密码时会检查配置参数[password\_reuse\_time](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s36625909efc14a42af3e142435ae9794)和[password\_reuse\_max](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_scad28ae18dfc4557b10f51bf147a9e53)。
>- 当[password\_reuse\_time](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s36625909efc14a42af3e142435ae9794)和[password\_reuse\_max](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_scad28ae18dfc4557b10f51bf147a9e53)都为正数时，只要满足其中任一个，即可认为密码可以重用。
@@ -241,7 +241,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>
>修改密码时会检查配置参数[password\_reuse\_time](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s36625909efc14a42af3e142435ae9794)和[password\_reuse\_max](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_scad28ae18dfc4557b10f51bf147a9e53)。
>- 当[password\_reuse\_time](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s36625909efc14a42af3e142435ae9794)和[password\_reuse\_max](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_scad28ae18dfc4557b10f51bf147a9e53)都为正数时，只要满足其中任一个，即可认为密码可以重用。
@@ -262,7 +262,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>password\_lock\_time和[failed\_login\_attempts](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_sc155ec2258b34e78a2ffcf797e66b959)必须都为正数时锁定和解锁功能才能生效。
**取值范围：**浮点型，最小值为0，最大值为365，单位为天。
@@ -278,7 +278,7 @@
该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
-> **须知：**
+> **须知：**
>failed\_login\_attempts和[password\_lock\_time](#zh-cn_topic_0237124696_zh-cn_topic_0059778664_s5e488e82235e4bd5b470b57a44a38c27)必须都为正数时锁定和解锁功能才能生效。
**取值范围：**整型，最小值为0，最大值为1000。
@@ -301,7 +301,7 @@
- 2表示采用sha256方式对密码加密。
- 3表示采用sm3方式对密码加密。
-> **须知：**
+> **须知：**
>md5加密算法安全性低，存在安全风险，不建议用户使用。
**默认值：**2
diff --git "a/content/zh/docs/DataBaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md" "b/content/zh/docs/DatabaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md"
similarity index 98%
rename from "content/zh/docs/DataBaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md"
rename to "content/zh/docs/DatabaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md"
index d48e0c65997abf11ce276bf4b6666ef84e8ef71e..005d3692a1af81a99a27f95a0859ed15a7cfb4fc 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\211\345\205\250\351\205\215\347\275\256.md"
@@ -1,4 +1,4 @@
-# 安全配置
+# 安全配置
## elastic\_search\_ip\_addr
diff --git "a/content/zh/docs/DataBaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md" "b/content/zh/docs/DatabaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md"
similarity index 97%
rename from "content/zh/docs/DataBaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md"
rename to "content/zh/docs/DatabaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md"
index 53b10bc41340a1e23ab8b1e99d80d35c85650521..620c2e49995e3fc43b81329a7ab56cd15148facc 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\232\346\227\266\344\273\273\345\212\241.md"
@@ -1,4 +1,4 @@
-# 定时任务
+# 定时任务
## job\_queue\_processes
diff --git "a/content/zh/docs/DataBaseReference/\345\256\241\350\256\241.md" "b/content/zh/docs/DatabaseReference/\345\256\241\350\256\241.md"
similarity index 76%
rename from "content/zh/docs/DataBaseReference/\345\256\241\350\256\241.md"
rename to "content/zh/docs/DatabaseReference/\345\256\241\350\256\241.md"
index dd0b7bcf3656430b95aa5818bdd1d39acff774a1..a04ea109e705e6d76e9655d463e8b9f2a0ef3d02 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\241\350\256\241.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\241\350\256\241.md"
@@ -1,4 +1,4 @@
-# 审计
+# 审计
- **[审计开关](审计开关.md)**
diff --git "a/content/zh/docs/DataBaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md" "b/content/zh/docs/DatabaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md"
similarity index 95%
rename from "content/zh/docs/DataBaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md"
rename to "content/zh/docs/DatabaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md"
index 317da539db16e48b6748522222b08d25974744f8..a37c42ba81c8fa2b6f6de7979768f3744d46fd35 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\241\350\256\241\345\274\200\345\205\263.md"
@@ -1,4 +1,4 @@
-# 审计开关
+# 审计开关
## audit\_enabled
@@ -23,7 +23,7 @@
**默认值：**pg\_audit。如果使用om工具部署openGauss，则审计日志路径为“$GAUSSLOG/pg\_audit/实例名称”。
->  **须知：**
+>  **须知：**
>
> - 不同的DN实例需要设置不同的审计文件存储目录，否则会导致审计日志异常。
> - 当配置文件中audit_directory的值为非法路径时，会导致审计功能无法使用。
@@ -51,7 +51,7 @@
**默认值**：1d
-> **须知：**
+> **须知：**
>请不要随意调整此参数，否则可能会导致audit\_resource\_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用[audit\_resource\_policy](#zh-cn_topic_0237124745_section939915522551)、[audit\_space\_limit](#zh-cn_topic_0237124745_zh-cn_topic_0059777744_s167d5900250946bca199444c0617c714)和[audit\_file\_remain\_time](#zh-cn_topic_0237124745_section149961828185211)参数进行控制。
## audit\_rotation\_size
@@ -64,7 +64,7 @@
**默认值**：10MB
-> **须知：**
+> **须知：**
>请不要随意调整此参数，否则可能会导致audit\_resource\_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit\_resource\_policy、audit\_space\_limit和audit\_file\_remain\_time参数进行控制。
## audit\_resource\_policy
@@ -110,7 +110,7 @@
**默认值：**1048576
-> **须知：**
+> **须知：**
>请尽量保证此参数为1048576，并不要随意调整此参数，否则可能会导致audit\_resource\_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit\_resource\_policy、audit\_space\_limit和audit\_file\_remain\_time参数进行控制。
## audit\_thread\_num
@@ -123,5 +123,5 @@
**默认值：**1
-> **须知：**
+> **须知：**
>当audit\_dml\_state开关打开且在高性能场景下，建议增大此参数保证审计消息可以被及时处理和记录。
\ No newline at end of file
diff --git "a/content/zh/docs/DataBaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md" "b/content/zh/docs/DatabaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md"
similarity index 68%
rename from "content/zh/docs/DataBaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md"
rename to "content/zh/docs/DatabaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md"
index 66d74d9078676dba0d0aee77c0fb916b5ac55ae1..2464b01fc0d85da7e98b5ace93817a6ea55d9318 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\242\346\210\267\347\253\257\350\277\236\346\216\245\347\274\272\347\234\201\350\256\276\347\275\256.md"
@@ -1,4 +1,4 @@
-# 客户端连接缺省设置
+# 客户端连接缺省设置
- **[语句行为](语句行为.md)**
diff --git "a/content/zh/docs/DataBaseReference/\345\256\271\351\224\231\346\200\247.md" "b/content/zh/docs/DatabaseReference/\345\256\271\351\224\231\346\200\247.md"
similarity index 97%
rename from "content/zh/docs/DataBaseReference/\345\256\271\351\224\231\346\200\247.md"
rename to "content/zh/docs/DatabaseReference/\345\256\271\351\224\231\346\200\247.md"
index 6c73da05172def513da0cdfb933e4d6e1508c842..b7a7fab6082cc25d934388a048c9011235552a08 100644
--- "a/content/zh/docs/DataBaseReference/\345\256\271\351\224\231\346\200\247.md"
+++ "b/content/zh/docs/DatabaseReference/\345\256\271\351\224\231\346\200\247.md"
@@ -1,4 +1,4 @@
-# 容错性
+# 容错性
当数据库系统发生错误时，以下参数控制服务器处理错误的方式。
diff --git "a/content/zh/docs/DataBaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md" "b/content/zh/docs/DatabaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md"
similarity index 89%
rename from "content/zh/docs/DataBaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md"
rename to "content/zh/docs/DatabaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md"
index e51c63206d6fad7db6ac55e5352ef5006ae69860..e3f56711d9c774a253f5e2f66a86d3a346e55c3c 100644
--- "a/content/zh/docs/DataBaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md"
+++ "b/content/zh/docs/DatabaseReference/\345\271\263\345\217\260\345\222\214\345\256\242\346\210\267\347\253\257\345\205\274\345\256\271\346\200\247.md"
@@ -1,4 +1,4 @@
-# 平台和客户端兼容性
+# 平台和客户端兼容性
很多平台都使用数据库系统，数据库系统的对外兼容性给平台提供了很大的方便。
@@ -15,7 +15,7 @@
**默认值**：on
-> **须知：**
+> **须知：**
>该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎操作。
## nls\_timestamp\_format
@@ -38,7 +38,7 @@
**默认值：**1024
-> **说明：**
+> **说明：**
>目前能返回的最大长度是1073741823，超出此长度后会有out of memory的报错。
## max\_function\_args
@@ -67,7 +67,7 @@
**默认值：**off
-> **说明：**
+> **说明：**
>新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。
## support\_extended\_features
@@ -98,9 +98,9 @@
**默认值：**A
-> **须知：**
+> **须知：**
>
->- 该参数只能在执行[CREATE DATABASE](../SQLReference/create-database.md)命令创建数据库时通过dbcompatibility设置。
+>- 该参数只能在执行[CREATE DATABASE](../SQLReference/CREATE-DATABASE.md)命令创建数据库时通过dbcompatibility设置。
>
>- 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。
@@ -114,7 +114,7 @@
**默认值：**""
-> **说明：**
+> **说明：**
>
>- 当前只支持[表1 兼容性B模式配置项](#table18793103274617)。
>- 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set b\_format\_behavior\_compat\_options='enable\_set\_variables,set\_session\_transaction';
@@ -177,7 +177,7 @@
**默认值：**空
-> **说明：**
+> **说明：**
>
>- 当前只支持[表1](#zh-cn_topic_0283137574_zh-cn_topic_0237124754_table182861153114812)。
>
@@ -234,7 +234,7 @@
|||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| + | ||||||||||||||||||
|
若设置此配置项，则不需要对除法结果做范围校验，例如，INT_MIN/(-1)可以得到输出结果为INT_MAX+1，反之，则会因为超过结果大于INT_MAX而报越界错误。 @@ -264,7 +264,7 @@ length | ||||||||||||||||||
| - | 控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考MERGE INTO）和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。 若设置此配置项，当存在上述场景时，该冲突行将会多次执行UPDATE；否则（默认）报错，即MERGE或INSERT操作失败。 + | 控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考MERGE INTO）和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。 若设置此配置项，当存在上述场景时，该冲突行将会多次执行UPDATE；否则（默认）报错，即MERGE或INSERT操作失败。 |
||||||||||||||||
| @@ -351,11 +351,6 @@ length | 控制substr(str, from, for)在不同场景下的表现。默认情况下，当from小于0时，substr将从字符串尾部开始计数；当for小于1时，substr将返回NULL。开启该参数后，当from小于0时，将从字符串的第一位的前(-from + 1)位开始计数；当for小于0时，substr将报错。该参数仅在sql_compatibility参数的值为PG时生效。 |
|||||||||||||||||
| - | -开启此参数后，创建函数，存储过程，包支持未定义的对象。可以新建成功。可以在GS_DEPENDENCIES和GS_DEPENDENCIES_OBJ查询对应的依赖关系。 开启此参数后，创建PLSQL对象时，会主动维护依赖于该PLSQL对象的OID，不再需要用户手动更新。 注意: 1.在并发创建PLSQL对象时，如果需要维护的对象间存在竞争关系，可能会造成死锁。 - |
-|||||||||||||||||
| allow_orderby_undistinct_column | SQL语法兼容B的情况下，开启此参数后，select语句支持order by后面的列不在distinct中。如: select distinct a from test order by b; 注意：该参数只支持distinct，不支持distinct on，且当 DOLPHIN 插件存在时不生效，转由 dolphin.sql_mode 参数控制。dolphin.sql_mode 未设置 sql_mode_full_group 选项时相当于打开此选项。 |
@@ -367,6 +362,42 @@ length
| + | ++ | +
|---|---|
| + | +控制存储过程中FOR_LOOP查询语句行为设置此项时，在FOR rec IN query LOOP语句中，若rec已经定义，不会复用已经定义的rec变量，而且重新建立一个新的变量。否则，会复用已经定义的rec变量，不会建立新的变量。(与proc_implicit_for_loop_variable相同，后续进性收编) + |
+
| + | ++ | +
| + | ++ | ++ | ++ | +
|---|---|---|---|
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
| + | ++ | ++ | ++ | +
使用ALTER SYSTEM SET修改数据库参数。
+使用ALTER SYSTEM SET修改数据库参数。
openGauss=# ALTER SYSTEM SET paraname TO value;
openGauss=# ALTER SYSTEM SET paraname TO value;@@ -146,7 +146,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# -> **注意：** +> **注意：** >使用方式一和方式二设置参数时，若所设参数不属于当前环境，数据库会提示参数不在支持范围内的相关信息。 ## 操作步骤 @@ -172,7 +172,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# gs_guc set -D /gaussdb/data/dbnode -c "archive_mode=off" ``` - > **说明：** + > **说明：** > >可以使用以下命令在数据库节点上设置archive\_mode参数为off。 >``` @@ -236,7 +236,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# Success to perform gs_guc! ``` - > **说明：** + > **说明：** > >可以使用以下命令在数据库节点上设置authentication\_timeout参数为59s。 >``` diff --git "a/content/zh/docs/DataBaseReference/\351\224\201\347\256\241\347\220\206.md" "b/content/zh/docs/DatabaseReference/\351\224\201\347\256\241\347\220\206.md" similarity index 94% rename from "content/zh/docs/DataBaseReference/\351\224\201\347\256\241\347\220\206.md" rename to "content/zh/docs/DatabaseReference/\351\224\201\347\256\241\347\220\206.md" index 7fe2b7ff03d7d5800f4a272800fc79e7347a1453..795dfcd22d3b5f59da14062f3d163ae155d5f598 100644 --- "a/content/zh/docs/DataBaseReference/\351\224\201\347\256\241\347\220\206.md" +++ "b/content/zh/docs/DatabaseReference/\351\224\201\347\256\241\347\220\206.md" @@ -1,4 +1,4 @@ -# 锁管理 +# 锁管理 在openGauss中，并发执行的事务由于竞争资源会导致死锁。本节介绍的参数主要管理事务锁的机制。 @@ -70,6 +70,7 @@ - 数据库连接异常终止时，通常会有临时表残留，此时需要对数据库中的临时表进行清理。 - 增大这个参数可能导致openGauss临时表清理时间延长。 +- 当设置为0时，会关闭自动清理临时表功能。不建议设置为0。 该参数属于SIGHUP类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。 @@ -81,9 +82,9 @@ **参数说明：**在执行某些查询语句的过程中，会需要将分区表上的锁级别由允许读的ExclusiveLock级别升级到读写阻塞的AccessExclusiveLock级别。如果此时已经存在并发的读事务，那么该锁升级操作将阻塞等待。partition\_lock\_upgrade\_timeout为尝试锁升级的等待超时时间。 -- 在分区表上进行MERGE PARTITION和CLUSTER PARTITION操作时，都利用了临时表进行数据重排和文件交换，为了最大程度提高分区上的操作并发度，在数据重排阶段给相关分区加锁ExclusiveLock，在文件交换阶段加锁AccessExclusiveLock。 +- 在分区表上进行CLUSTER PARTITION操作时，利用了临时表进行数据重排和文件交换，为了最大程度提高分区上的操作并发度，在数据重排阶段给相关分区加锁ExclusiveLock，在文件交换阶段加锁AccessExclusiveLock。 - 常规加锁方式是等待加锁，直到加锁成功，或者等待时间超过[lockwait\_timeout](#zh-cn_topic_0237124735_zh-cn_topic_0059778102_s6569557a768f4a80b5cade038eafb31b)发生超时失败。 -- 在分区表上进行MERGE PARTITION或CLUSTER PARTITION操作时，进入文件交换阶段需要申请加锁AccessExclusiveLock，加锁方式是尝试性加锁，加锁成功了则立即返回，不成功则等待50ms后继续下次尝试，加锁超时时间使用会话级设置参数partition\_lock\_upgrade\_timeout。 +- 在分区表上进行CLUSTER PARTITION操作时，进入文件交换阶段需要申请加锁AccessExclusiveLock，加锁方式是尝试性加锁，加锁成功了则立即返回，不成功则等待50ms后继续下次尝试，加锁超时时间使用会话级设置参数partition\_lock\_upgrade\_timeout。 - 特殊值：若partition\_lock\_upgrade\_timeout取值-1，表示无限等待，即不停的尝试锁升级，直到加锁成功。 该参数属于USERSET类型参数，请参考[表2](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中对应设置方法进行设置。 diff --git "a/content/zh/docs/DataBaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" "b/content/zh/docs/DatabaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" similarity index 80% rename from "content/zh/docs/DataBaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" rename to "content/zh/docs/DatabaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" index 5f915bdcd4aa750b823e35ee27a0c65adde25f80..a2083a7be705a17796cee8a67d2ec0d70e1936ca 100644 --- "a/content/zh/docs/DataBaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" +++ "b/content/zh/docs/DatabaseReference/\351\224\231\350\257\257\346\212\245\345\221\212\345\222\214\346\227\245\345\277\227.md" @@ -1,4 +1,4 @@ -# 错误报告和日志 +# 错误报告和日志 - **[记录日志的位置](记录日志的位置.md)** diff --git "a/content/zh/docs/DataBaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" "b/content/zh/docs/DatabaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" similarity index 99% rename from "content/zh/docs/DataBaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" rename to "content/zh/docs/DatabaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" index c5a9d963b99289f709698e0d01dab09339cdbf20..c2f32437f06ee26007a6f3896e131e225368a37a 100644 --- "a/content/zh/docs/DataBaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" +++ "b/content/zh/docs/DatabaseReference/\351\224\231\350\257\257\347\240\201\345\217\202\350\200\203.md" @@ -1,4 +1,4 @@ -# 错误码参考 +# 错误码参考 - **[SQL标准错误码说明](SQL标准错误码说明.md)** diff --git "a/content/zh/docs/DataBaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" similarity index 88% rename from "content/zh/docs/DataBaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" rename to "content/zh/docs/DatabaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" index 3e3fab6c09a87f4e053c62db61d402a03864b4d4..5895ae36eefdd8288e302149f242d2d3f1865f2f 100644 --- "a/content/zh/docs/DataBaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" +++ "b/content/zh/docs/DatabaseReference/\351\227\252\345\233\236\347\233\270\345\205\263\345\217\202\346\225\260.md" @@ -1,4 +1,4 @@ -# 闪回相关参数 +# 闪回相关参数 本章节介绍闪回功能相关参数。 @@ -12,12 +12,12 @@ **默认值**：off -> **注意：** +> **注意：** >recyclebin不支持Astore，只支持Ustore。 ## recyclebin\_retention\_time -参数说明：设置回收站对象保留时间，超过该时间的回收站对象将被自动清理。 +参数说明：设置回收站对象保留时间，超过该时间的回收站对象将被自动清理。在执行purge recyclebin或者后台回收站清理线程时，将会删除超过该时间的回收站对象。 该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 @@ -35,7 +35,7 @@ **默认值**：0 -> **注意：** +> **注意：** >该参数已弃用。 ## vacuum\_defer\_cleanup\_age @@ -48,7 +48,7 @@ **默认值**：0 ->  **注意：** +>  **注意：** > 在进行Ustore闪回时，无需关注该参数。其服务于之前版本的astore闪回功能，同时具有其他用途。本版本闪回功能已不使用。 ## undo\_retention\_time diff --git "a/content/zh/docs/DataBaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" "b/content/zh/docs/DatabaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" similarity index 72% rename from "content/zh/docs/DataBaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" rename to "content/zh/docs/DatabaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" index e5bbeb797a8ab1bb0724665e56e347b659fd2ff4..b74b2e8f60d076072b3b9a736ba291405ba67a3d 100644 --- "a/content/zh/docs/DataBaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" +++ "b/content/zh/docs/DatabaseReference/\351\242\204\345\206\231\345\274\217\346\227\245\345\277\227.md" @@ -1,4 +1,4 @@ -# 预写式日志 +# 预写式日志 - **[设置](设置.md)** diff --git "a/content/zh/docs/DataBaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" similarity index 74% rename from "content/zh/docs/DataBaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" rename to "content/zh/docs/DatabaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" index 425e53cee7eed4f68acee07f9e509bd905771850..5830624bd014340e766c15b288889d47e8cd6aa3 100644 --- "a/content/zh/docs/DataBaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" +++ "b/content/zh/docs/DatabaseReference/\351\242\204\347\225\231\345\217\202\346\225\260.md" @@ -1,6 +1,6 @@ -# 预留参数 +# 预留参数 -> **说明：** +> **说明：** >下列参数为预留参数，该版本不生效。 acce\_min\_datasize\_per\_thread diff --git "a/content/zh/docs/DataBaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" "b/content/zh/docs/DatabaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" similarity index 84% rename from "content/zh/docs/DataBaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" rename to "content/zh/docs/DatabaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" index 3064d1829dd6aac1a4e301dac2a727e9b08cdfd2..66492914fae0c95d0c1d2f11ed363d1e44cf9ef5 100644 --- "a/content/zh/docs/DataBaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" +++ "b/content/zh/docs/DatabaseReference/\351\253\230\346\225\210\346\225\260\346\215\256\345\216\213\347\274\251\347\256\227\346\263\225\347\233\270\345\205\263\345\217\202\346\225\260.md" @@ -1,4 +1,4 @@ -# 高效数据压缩算法相关参数 +# 高效数据压缩算法相关参数 ## pca\_shared\_buffers @@ -8,7 +8,7 @@ **取值范围：** 最小值64K，最大值16G。 -> **说明：** +> **说明：** >- 如果设置值小于64K，设置报错。 >- 如果设置值大于16G，参数可以设置成功，但实际运行时候，自动内存运行设置为16G。 >- 如果设置参数不带单位，默认是8K\(一个页面的大小是8K\)乘以设置的参数大小。 diff --git a/content/zh/docs/Developerguide/CopyManager.md b/content/zh/docs/DeveloperGuide/CopyManager.md similarity index 99% rename from content/zh/docs/Developerguide/CopyManager.md rename to content/zh/docs/DeveloperGuide/CopyManager.md index 020c2c0dd15d0e5254c3204c9ff08984080b3739..ac7918e1e5363b91fba1bd7a089bd689c3bdf4a5 100644 --- a/content/zh/docs/Developerguide/CopyManager.md +++ b/content/zh/docs/DeveloperGuide/CopyManager.md @@ -1,4 +1,4 @@ -# CopyManager +# CopyManager CopyManager是openGauss JDBC驱动中提供的一个API接口类，用于批量向openGauss中导入数据。 diff --git a/content/zh/docs/Developerguide/Database-Stat.md b/content/zh/docs/DeveloperGuide/Database-Stat.md similarity index 99% rename from content/zh/docs/Developerguide/Database-Stat.md rename to content/zh/docs/DeveloperGuide/Database-Stat.md index 5f32232abb7d2961bebdc3b7b4d2443d8dd23c0f..39403f368649e30dfb0d977b5019b4df024f073b 100644 --- a/content/zh/docs/Developerguide/Database-Stat.md +++ b/content/zh/docs/DeveloperGuide/Database-Stat.md @@ -1,4 +1,4 @@ -# Database Stat +# Database Stat Database Stat列名称及描述如下表所示。 diff --git "a/content/zh/docs/Developerguide/Database\345\222\214Schema\350\256\276\350\256\241.md" "b/content/zh/docs/DeveloperGuide/Database\345\222\214Schema\350\256\276\350\256\241.md" similarity index 96% rename from "content/zh/docs/Developerguide/Database\345\222\214Schema\350\256\276\350\256\241.md" rename to "content/zh/docs/DeveloperGuide/Database\345\222\214Schema\350\256\276\350\256\241.md" index e1e6b344e5938c67ef3c5b7b6cb580a79dc52b7a..e3f554a1aaba02c426c3435559c7001993b76f62 100644 --- "a/content/zh/docs/Developerguide/Database\345\222\214Schema\350\256\276\350\256\241.md" +++ "b/content/zh/docs/DeveloperGuide/Database\345\222\214Schema\350\256\276\350\256\241.md" @@ -1,4 +1,4 @@ -# Database和Schema设计 +# Database和Schema设计 openGauss中可以使用Database和Schema实现业务的隔离，区别在于Database的隔离更加彻底，各个Database之间共享资源极少，可实现连接隔离、权限隔离等，Database之间无法直接互访。Schema隔离的方式共用资源较多，可以通过grant与revoke语法便捷地控制不同用户对各Schema及其下属对象的权限。 diff --git "a/content/zh/docs/Developerguide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" "b/content/zh/docs/DeveloperGuide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" similarity index 98% rename from "content/zh/docs/Developerguide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" rename to "content/zh/docs/DeveloperGuide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" index d5f3136e334f1285ffabcd40356d505422421f8c..077344d069521fc5522d2eaa84a38befa3e78c08 100644 --- "a/content/zh/docs/Developerguide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" +++ "b/content/zh/docs/DeveloperGuide/JDBC\345\214\205-\351\251\261\345\212\250\347\261\273\345\222\214\347\216\257\345\242\203\347\261\273.md" @@ -1,4 +1,4 @@ -# JDBC包、驱动类和环境类 +# JDBC包、驱动类和环境类 ## JDBC包 @@ -10,7 +10,7 @@ openGauss提供两种JDBCjar包：postgresql.jar和openGauss-jdbc-x.x.x.jar， ## 驱动类 -> **说明：** +> **说明：** > >+ openGauss在JDBC的使用上与PG的使用方法保持兼容。在同一个JVM虚拟机里加载PostgreSQL和openGauss的JDBC同名驱动时，可能存在org.postgresql.Driver驱动类冲突问题。 > 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" similarity index 70% rename from "content/zh/docs/Developerguide/JDBC\345\270\270\347\224\250\345\217\202\346\225\260\345\217\202\350\200\203.md" rename to "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 c9b68c65f8683191ccf48aa31a8e0dc8ecf5eeab..e4e0e373b5a616ab4d5635a414f5a81b791c08e0 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" @@ -1,108 +1,108 @@ -# JDBC常用参数参考 +# JDBC常用参数参考 ## 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为主的情况下，无法连接。 -> **须知：** +> **须知**： >此参数设置后对于多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 ## -**作用：** 控制建连阶段套接字操作超时值，在建连阶段，如果从网络中读取数据流超过此阈值，则尝试查找下一个节点建连。 +**作用**： 控制建连阶段套接字操作超时值，在建连阶段，如果从网络中读取数据流超过此阈值，则尝试查找下一个节点建连。 -**建议：** 该参数仅影响建连阶段的socket超时时间，如果未配置，默认为5s。 +**建议**： 该参数仅影响建连阶段的socket超时时间，如果未配置，默认为5s。 ## 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/Developerguide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" "b/content/zh/docs/DeveloperGuide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" similarity index 95% rename from "content/zh/docs/Developerguide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" rename to "content/zh/docs/DeveloperGuide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" index 51bdafc5ec07c4e9b157170c6a8c7176d2822f3e..fc7fffc9acafc8ffa20665f779a06ae0be298b99 100644 --- "a/content/zh/docs/Developerguide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" +++ "b/content/zh/docs/DeveloperGuide/JDBC\346\216\245\345\217\243\345\217\202\350\200\203.md" @@ -1,4 +1,4 @@ -# JDBC接口参考 +# JDBC接口参考 JDBC接口是一套提供给用户的API方法，本节将对部分常用接口做具体描述，若涉及其他接口可参考JDK1.8（软件包）/JDBC4.0中相关内容。 diff --git "a/content/zh/docs/Developerguide/JDBC\351\205\215\347\275\256.md" "b/content/zh/docs/DeveloperGuide/JDBC\351\205\215\347\275\256.md" similarity index 96% rename from "content/zh/docs/Developerguide/JDBC\351\205\215\347\275\256.md" rename to "content/zh/docs/DeveloperGuide/JDBC\351\205\215\347\275\256.md" index dc7f3d52b97beec8e31b4ef419af7ab4d4ce3564..f866fe76f221ecc6b7cc67a11c28cf9e336ff4d0 100644 --- "a/content/zh/docs/Developerguide/JDBC\351\205\215\347\275\256.md" +++ "b/content/zh/docs/DeveloperGuide/JDBC\351\205\215\347\275\256.md" @@ -1,4 +1,4 @@ -# JDBC配置 +# JDBC配置 目前，openGauss相关的第三方工具都是通过JDBC进行连接的，此部分将介绍工具配置时的注意事项。 @@ -30,7 +30,7 @@ - openGauss数据库实例所在主机的时区。 - openGauss数据库实例配置过程中时区。 - > **说明：** + > **说明：** >时区设置相关的操作，请参考《安装指南》中“企业版安装>安装准备>准备软硬件安装环境> 同步系统时间”章节内容。 diff --git "a/content/zh/docs/DeveloperGuide/Linux\344\270\213\351\205\215\347\275\256\346\225\260\346\215\256\346\272\220.md" "b/content/zh/docs/DeveloperGuide/Linux\344\270\213\351\205\215\347\275\256\346\225\260\346\215\256\346\272\220.md" new file mode 100644 index 0000000000000000000000000000000000000000..c828ae0777515551e4b1f185ede17a32f32cbc3a --- /dev/null +++ "b/content/zh/docs/DeveloperGuide/Linux\344\270\213\351\205\215\347\275\256\346\225\260\346\215\256\346\272\220.md" @@ -0,0 +1,511 @@ +# Linux下配置数据源 + +将openGauss提供的ODBC DRIVER（psqlodbcw.so）配置到数据源中便可使用。配置数据源需要配置“odbc.ini”和“odbcinst.ini”两个文件（在编译安装unixODBC过程中生成且默认放在“/usr/local/etc”目录下），并在服务器端进行配置。 + +## 操作步骤 + +1. 获取unixODBC源码包。 + + 获取参考地址：https://sourceforge.net/projects/unixodbc/files/unixODBC + + 下载后请先按照社区提供的完整性校验算法进行完整性校验。 + +2. 安装unixODBC。如果机器上已经安装了其他版本的unixODBC，可以直接覆盖安装。 + + 目前不支持unixODBC-2.2.1版本。以unixODBC-2.3.0版本为例，在客户端执行如下命令安装unixODBC。默认安装到“/usr/local”目录下，生成数据源文件到 “/usr/local/etc”目录下，库文件生成在“/usr/local/lib”目录。 + + ``` + tar zxvf unixODBC-2.3.0.tar.gz + cd unixODBC-2.3.0 + #修改configure文件（如果不存在，那么请修改configure.ac），找到LIB_VERSION + #将它的值修改为"1:0:0"，这样将编译出*.so.1的动态库，与psqlodbcw.so的依赖关系相同。 + vim configure + + ./configure --enable-gui=no #如果要在ARM服务器上编译，请追加一个configure参数： --build=aarch64-unknown-linux-gnu + make + #安装可能需要root权限 + make install + ``` + +3. 替换客户端openGauss驱动程序。 + 1. 将openGauss-x.x.x-ODBC.tar.gz解压。解压后会得到两个文件夹：lib与odbc，在odbc文件夹中还会有一个lib文件夹。/odbc/lib中会有“psqlodbca.la”，“psqlodbca.so”，“psqlodbcw.la”和“psqlodbcw.so”四个文件，将这四个文件拷贝到“/usr/local/lib”目录下。 + 2. 将openGauss-x.x.x-ODBC.tar.gz解压后lib目录中的库拷贝到“/usr/local/lib”目录下。 + +4. 配置数据源。 + 1. 配置ODBC驱动文件。 + + 在“/usr/local/etc/odbcinst.ini”文件中追加以下内容。 + + ``` + [GaussMPP] + Driver64=/usr/local/lib/psqlodbcw.so + setup=/usr/local/lib/psqlodbcw.so + ``` + + odbcinst.ini文件中的配置参数说明如[表1](#zh-cn_topic_0283136654_zh-cn_topic_0237120407_zh-cn_topic_0059778464_td564f21e7c8e458bbd741b09896f5d91)所示。 + + **表 1** odbcinst.ini文件配置参数 + + +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ + | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ + | ++ | +
| + | +是否开启批量查询协议（打开可提高DML性能）；可选值0或者1，默认为1。 + + + |
+ + | +
| + | ++ | ++ | +
| + | +每次调用SQLFreeHandle释放Stmt时，ODBC都会向server端发送一个Deallocate plan_name语句，业务中存在大量这类语句。为了减少这类语句的发送，我们将 stmt->plan_name置空，从而使得数据库识别这个为unamed stmt。增加这个参数对unamed stmt的阈值进行控制。 + |
+ + | +
| + | +GUC参数connection_info（参见connection_info）中显示驱动部署路径和进程属主用户的开关。 + |
+
+ 说明：
+ 默认值为0。当设置为1时，ODBC驱动会将当前驱动的部署路径、进程属主用户上报到数据库中，记录在connection_info参数（参见connection_info）里；同时可以在PG_STAT_ACTIVITY中查询到。 + |
+
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | +必须使用SSL安全连接，在verify-ca的验证范围之外，同时验证数据库所在主机的主机名是否与证书内容一致。openGauss不支持此模式。 + |
+
链接字符串，字符串中的字段见链接字符章节。
+链接参数串，字符串中的字段见链接参数章节。
要链接的主机名，详见链接字符章节描述的host字段。
+要链接的主机名，详见链接参数章节描述的host字段。
主机服务器的端口号，详见链接字符描述的port字段。
+主机服务器的端口号，详见链接参数描述的port字段。
添加命令行选项以在运行时发送到服务器，详见链接字符描述的options字段。
+添加命令行选项以在运行时发送到服务器，详见链接参数描述的options字段。
要链接的数据库名，详见链接字符描述的dbname字段。
+要链接的数据库名，详见链接参数描述的dbname字段。
要链接的用户名，详见链接字符章节描述的user字段。
+要链接的用户名，详见链接参数章节描述的user字段。
如果服务器要求口令认证，所用的口令，详见链接字符描述的password字段。
+如果服务器要求口令认证，所用的口令，详见链接参数描述的password字段。
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | +输出参数：指向与列绑定的数据缓冲区的指针。SQLFetch函数返回这个缓冲区中的数据。如果此参数为一个空指针，则StrLen_or_IndPtr是一个有效值。 + |
+
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
|---|---|
| + | +SQLFreeHandle要释放的句柄类型。必须为下列值之一： +
|
+
| + | ++ | +
| + | ++ | ++ | +
|---|---|---|
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
|---|---|
| + | +SQLAllocHandle：申请句柄资源，可替代如下函数： +
|
+
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | ++ | +
| + | +SQLFreeHandle：释放句柄资源，可替代如下函数： +
|
+
**警告：**
+>
+> ODBC为应用程序与数据库的中心层，负责把应用程序发出的SQL指令传到数据库当中，自身并不解析SQL语法。故在应用程序中写入带有保密信息的SQL语句时（如明文密码），保密信息会被暴露在驱动日志中。
+
diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md" "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md"
similarity index 57%
rename from "content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md"
index 5ab7802a54507d39f2dd89fca4c26c03e8b07d11..926e3f9c582aa74833e3b82767337e608ae911a1 100644
--- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_Psycopg.md"
@@ -1,5 +1,5 @@
-# 开发流程
+# 开发流程
**图 1** 采用Psycopg2开发应用程序的流程
-
+
diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md" "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md"
similarity index 89%
rename from "content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md"
index b471baf8af92f643b925b6a475943a763969a08c..7dcb33080c4cc388cd822e8c60d492a7c41db1ec 100644
--- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\346\265\201\347\250\213_libpq.md"
@@ -1,10 +1,10 @@
-# 开发流程
+# 开发流程
编译并且链接一个libpq的源程序，需要做下面的一些事情：
1. 解压相应的发布包（如openGauss-\*.\*.0-\*\*\*-64bit-Libpq.tar.gz）文件，其中include文件夹下的头文件为所需的头文件，lib文件夹中为所需的libpq库文件。
- > **说明：**
+ > **说明：**
>除libpq-fe.h外，include文件夹下默认还存在头文件postgres\_ext.h，gs\_thread.h，gs\_threadlocal.h，这三个头文件是libpq-fe.h的依赖文件。
2. 包含libpq-fe.h头文件：
diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\247\204\350\214\203.md" "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\247\204\350\214\203.md"
similarity index 75%
rename from "content/zh/docs/Developerguide/\345\274\200\345\217\221\350\247\204\350\214\203.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\247\204\350\214\203.md"
index bbd4d4a43cfc72410af7b21df21ea3c73cac892c..09561c9f32fcc878a7370a7e5a7d24d69041c38b 100644
--- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\247\204\350\214\203.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\247\204\350\214\203.md"
@@ -1,4 +1,4 @@
-# 开发规范
+# 开发规范
如果用户在APP的开发中，使用了连接池机制，那么需要遵循如下规范：
@@ -9,4 +9,4 @@
兼容性原则：
-+ 新驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，必须升级数据库。
\ No newline at end of file
+新驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，必须升级数据库。
\ No newline at end of file
diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md" "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md"
similarity index 80%
rename from "content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md"
index 962582d22c9162b61d665b0e70800cc469e3e9e6..0f58ca23fcd26ad3c38f1a58b7e5e0173763c873 100644
--- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203.md"
@@ -1,4 +1,4 @@
-# 开发设计建议
+# 开发设计建议
- **[开发设计规范概述](开发设计规范概述.md)**
diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md" "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md"
similarity index 91%
rename from "content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md"
index 83b5854b7786dbb95518691884363fa08ffae173..108b60e57df0e43b4a8c3c8851f072423823e2ad 100644
--- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\200\345\217\221\350\256\276\350\256\241\350\247\204\350\214\203\346\246\202\350\277\260.md"
@@ -1,4 +1,4 @@
-# 开发设计建议概述
+# 开发设计建议概述
本开发设计建议约定数据库建模和数据库应用程序开发过程中，应当遵守的设计规范。依据这些规范进行建模，能够更好的契合openGauss的处理架构，输出更高效的业务SQL代码。
diff --git "a/content/zh/docs/Developerguide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md" "b/content/zh/docs/DeveloperGuide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md"
similarity index 95%
rename from "content/zh/docs/Developerguide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md"
rename to "content/zh/docs/DeveloperGuide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md"
index a105b1c1fdcd48ebb6f7badc01e56f36a7acfeb2..f13664f76721126987061d4d675ac5dab313d7d2 100644
--- "a/content/zh/docs/Developerguide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md"
+++ "b/content/zh/docs/DeveloperGuide/\345\274\202\346\255\245\345\221\275\344\273\244\345\244\204\347\220\206.md"
@@ -1,4 +1,4 @@
-# 异步命令处理
+# 异步命令处理
PQexec函数对普通的同步应用里提交命令已经足够使用。但是它却有几个缺陷，而这些缺陷可能对某些用户很重要：
diff --git "a/content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md" "b/content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md"
similarity index 96%
rename from "content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md"
rename to "content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md"
index d35aee39683efb206642c7eb5ea63a4c77ad4a64..8af4ec803dcb3a6f0953606d37089915b82bef6a 100644
--- "a/content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_JDBC.md"
@@ -1,4 +1,4 @@
-# 执行SQL语句
+# 执行SQL语句
## 执行普通SQL语句
@@ -17,7 +17,7 @@
int rc = stmt.executeUpdate("CREATE TABLE customer_t1(c_customer_sk INTEGER, c_customer_name VARCHAR(32));");
```
- > **说明：**
+ > **说明：**
>
>- 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，事务块中不支持vacuum操作。如果其中有一个语句失败，那么整个请求都将会被回滚。
>- 使用Statement执行多语句时应以“;”作为各语句间的分隔符，存储过程、函数、匿名块不支持多语句执行;当preferQueryMode=simple，语句执行不走解析逻辑，此场景下无法使用";"作为多语句间的分隔符。
@@ -120,14 +120,14 @@ openGauss支持通过JDBC直接调用事先创建的存储过程，步骤如下
cstmt.close();
```
- > **说明：**
+ > **说明：**
>
>- 很多的数据库类如Connection、Statement和ResultSet都有close\(\)方法，在使用完对象后应把它们关闭。要注意的是，Connection的关闭将间接关闭所有与它关联的Statement，Statement的关闭间接关闭了ResultSet。
>- 一些JDBC驱动程序还提供命名参数的方法来设置参数。命名参数的方法允许根据名称而不是顺序来设置参数，若参数有默认值，则可以不用指定参数值就可以使用此参数的默认值。即使存储过程中参数的顺序发生了变更，也不必修改应用程序。目前openGauss数据库的JDBC驱动程序不支持此方法。
>- openGauss数据库不支持带有输出参数的函数，也不支持存储过程和函数参数默认值。
>- myConn.prepareCall("{? = CALL TESTPROC(?,?,?)}")，执行存储过程绑定参数时，可以按照占位符的顺序绑定参数，注册第一个参数为出参，也可以按照存储过程中的参数顺序绑定参数，注册第四个参数为出参，上述用例为此场景，注册第四个参数为出参。
- > **须知：**
+ > **须知：**
>
>- 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。
>- 存储过程不能和普通SQL在同一条语句中执行。
@@ -182,7 +182,7 @@ openGauss支持通过JDBC直接调用事先创建的存储过程，步骤如下
cs.close();
```
- > **说明：**
+ > **说明：**
>
>- oracle兼容模式开启参数后，调用存储过程必须使用\{call proc\_name\(?,?,?\)\}形式调用，调用函数必须使用\{? = call func\_name\(?,?\)\}形式调用（等号左侧的“？”为函数返回值的占位符，用于注册函数返回值）。
>- 参数behavior\_compat\_options='proc\_outparam\_override'行为变更后，业务需要重新建立连接，否则无法正确调用存储过程和函数。
@@ -237,7 +237,7 @@ end;
pstmt.close();
```
- > **说明：**
+ > **说明：**
>在实际的批处理过程中，通常不终止批处理程序的执行，否则会降低数据库的性能。因此在批处理程序时，应该关闭自动提交功能，每几行提交一次。关闭自动提交功能的语句为： conn.setAutoCommit\(false\);
diff --git "a/content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md" "b/content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md"
similarity index 81%
rename from "content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md"
rename to "content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md"
index 61a45b8b4b312f080e537ad5fc4749106db29ba7..16e253232171429845be816fe9abb941316548d4 100644
--- "a/content/zh/docs/Developerguide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\211\247\350\241\214SQL\350\257\255\345\217\245_Psycopg.md"
@@ -1,4 +1,4 @@
-# 执行SQL语句
+# 执行SQL语句
1. 构造操作语句，使用%s作为占位符，执行时psycopg2会用参数值智能替换掉占位符。可以添加RETURNING子句，来得到自动生成的字段值。
2. 使用cursor.execute方法来操作一行，使用cursor.executemany方法来操作多行。
diff --git "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md" "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md"
similarity index 75%
rename from "content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md"
rename to "content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md"
index 6b4d9acf1efc51495fea04c2014782afabd7e8fc..ab757fd4c9b0d422115821ea4dbbd25ab32315f3 100644
--- "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\221\275\345\220\215.md"
@@ -1,10 +1,15 @@
-# 数据库对象命名
+# 数据库对象命名
-数据库对象命名需要满足约束：非时序表长度不超过63个字节，时序表长度不超过53个字符，以字母或下划线开头，中间字符可以是字母、数字、下划线、$、\#。
+数据库对象命名需要满足约束：
+
+- 标识符非时序表长度不超过63个字节，时序表（当前特性是实验室特性，使用时请联系华为工程师提供技术支持）长度不超过53个字符。
+- 标识符以字母或下划线开头，中间字符可以是字母、数字、下划线、$、#。
+- 若标识符被双引号（""）包含，则可以使用合法字符的任意组合，如"123gs_column"。
+- 标识符不区分大小写，只有被双引号包含才区分大小写。
- 【建议】避免使用保留或者非保留关键字命名数据库对象。
- > **说明：**
+ > **说明：**
>可以使用select \* from pg\_get\_keywords\(\)查询openGauss的关键字，或者在[关键字](../SQLReference/关键字.md)章节中查看。
- 【建议】避免使用双引号括起来的字符串来定义数据库对象名称，除非需要限制数据库对象名称的大小写。数据库对象名称大小写敏感会使定位问题难度增加。
diff --git "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md" "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md"
similarity index 79%
rename from "content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md"
rename to "content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md"
index 0bf6e00cbb737106db69cbb4e879737b6bb68cc4..599e47b503dfe38d92c89051fd6c05683d6d7bb9 100644
--- "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\350\256\276\350\256\241.md"
@@ -1,4 +1,4 @@
-# 数据库对象设计
+# 数据库对象设计
- **[Database和Schema设计](Database和Schema设计.md)**
diff --git "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md" "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md"
similarity index 89%
rename from "content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md"
rename to "content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md"
index 6955e54a569e23f5a6bd7717b18f6afcee393323..72df467e83872ceec760c33e9622611ba49e88f4 100644
--- "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\346\211\247\350\241\214\350\257\255\345\217\245\345\207\275\346\225\260.md"
@@ -1,4 +1,4 @@
-# **数据库执行语句函数**
+# **数据库执行语句函数**
与数据库服务器的连接成功建立，便可以使用这里描述的函数执行SQL查询和命令。
diff --git "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md" "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md"
similarity index 93%
rename from "content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md"
rename to "content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md"
index 44b84443dd0881595008be5282fc338ddd2ecf9f..ef5c7b7844044b5ec9988d46b9ab491d3e5674ba 100644
--- "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\216\247\345\210\266\345\207\275\346\225\260.md"
@@ -1,4 +1,4 @@
-# 数据库连接控制函数
+# 数据库连接控制函数
数据库连接控制函数控制与openGauss服务器链接的事情。一个应用程序一次可以与多个服务器建立链接，如一个客户端链接多个数据库的场景。每个链接都是用一个从函数PQconnectdb、PQconnectdbParams或PQsetdbLogin获得的PGconn对象表示。注意，这些函数总是返回一个非空的对象指针，除非内存分配失败，会返回一个空的指针。链接建立的接口保存在PGconn对象中，可以调用PQstatus函数来检查一下返回值看看连接是否成功。
diff --git "a/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\346\237\245\350\257\242\350\257\267\346\261\202\345\244\204\347\220\206\350\277\207\347\250\213.md" "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\346\237\245\350\257\242\350\257\267\346\261\202\345\244\204\347\220\206\350\277\207\347\250\213.md"
new file mode 100644
index 0000000000000000000000000000000000000000..6ffd6c8ffb9aff143f73b2f67a0de96bf80a7c5a
--- /dev/null
+++ "b/content/zh/docs/DeveloperGuide/\346\225\260\346\215\256\346\237\245\350\257\242\350\257\267\346\261\202\345\244\204\347\220\206\350\277\207\347\250\213.md"
@@ -0,0 +1,7 @@
+# 数据查询请求处理过程
+
+数据请求分为创建、删除、修改和查询，处理过程大致相同。以数据查询过程为例，展现客户端如何与openGauss sever进行交互。数据查询请求过程如[图1](#zh-cn_topic_0237120246_zh-cn_topic_0059778641_f8739a7e890f246bb9fb77f8a9b1c4105)所示所示，创建、删除和修改请求处理过程只在图中第7步有差异。
+
+**图 1** openGauss服务响应流程
+
+
diff --git "a/content/zh/docs/Developerguide/\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/content/zh/docs/DeveloperGuide/\346\227\245\345\277\227\347\256\241\347\220\206.md"
similarity index 98%
rename from "content/zh/docs/Developerguide/\346\227\245\345\277\227\347\256\241\347\220\206.md"
rename to "content/zh/docs/DeveloperGuide/\346\227\245\345\277\227\347\256\241\347\220\206.md"
index ed1ad25b730fff8d3810c84c5a5970ae4c4a31cf..c68f6620f7cc25273b8fb01a397cc7d15db5091e 100644
--- "a/content/zh/docs/Developerguide/\346\227\245\345\277\227\347\256\241\347\220\206.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\227\245\345\277\227\347\256\241\347\220\206.md"
@@ -1,4 +1,4 @@
-# 日志管理
+# 日志管理
openGauss JDBC驱动程序支持使用日志记录来帮助解决在应用程序中使用openGauss JDBC驱动程序时的问题。openGauss JDBC支持如下三种日志管理方式：
@@ -15,7 +15,7 @@ SLF4J和JdkLogger是业界Java应用程序日志管理的主流框架，描述
此方式支持日志管控。SLF4J可通过文件中的相关配置实现强大的日志管控功能，建议使用此方式进行日志管理。
-> **注意：**
+> **注意：**
>
>此方式依赖slf4j的通用API接口，如org.slf4j.LoggerFactory.getLogger\(String name\)、org.slf4j.Logger.debug\(String var1\)、org.slf4j.Logger.info\(String var1\)、org.slf4j.Logger.warn\(String warn\)、org.slf4j.Logger.warn\(String warn\)等，若以上接口发生变更，日志将无法打印。
diff --git "a/content/zh/docs/Developerguide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md" "b/content/zh/docs/DeveloperGuide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md"
similarity index 88%
rename from "content/zh/docs/Developerguide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md"
rename to "content/zh/docs/DeveloperGuide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md"
index 659936ea82b34ffcfd938afd45c745d2d854df32..c77d97cf883d4327c2686dc1e0d31cf2c319f1a7 100644
--- "a/content/zh/docs/Developerguide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md"
+++ "b/content/zh/docs/DeveloperGuide/\346\237\245\347\234\213WDR\346\212\245\345\221\212.md"
@@ -1,4 +1,4 @@
-# 查看WDR报告
+# 查看WDR报告
WDR报表主要内容如下表所示。
@@ -16,77 +16,77 @@ WDR报表主要内容如下表所示。
缺省时，连接日志只记录所连接主机的IP地址。打开这个选项会同时记录主机名。
-该参数同时影响 查看审计结果、GS_WLM_SESSION_HISTORY、PG_STAT_ACTIVITY和log_line_prefix参数。
+该参数同时影响 查看审计结果、GS_WLM_SESSION_HISTORY、PG_STAT_ACTIVITY和log_line_prefix参数。
| - | -- | -- | -
|---|---|---|
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
| - | -- | -- | -
使用ALTER SYSTEM SET修改数据库参数。
+使用ALTER SYSTEM SET修改数据库参数。
openGauss=# ALTER SYSTEM SET paraname TO value;
openGauss=# ALTER SYSTEM SET paraname TO value;@@ -213,6 +213,7 @@ openGauss提供了四种方式来修改GUC参数，具体操作请参考[表2](# ## 示例 +```sql --创建表test1。 openGauss=# CREATE TABLE test1 ( @@ -238,3 +239,4 @@ openGauss=# select a1,a2 from test1 group by a1; --删除表 openGauss=# DROP TABLE test1; +``` \ No newline at end of file diff --git "a/content/zh/docs/ExtensionReference/dolphin-\351\224\201.md" "b/content/zh/docs/ExtensionReference/dolphin-\351\224\201.md" index a8b83843644fb77a98c3330a8e7c51a8cce481f8..ff8646f5ce92cbe6c34b1c059f5fadd37749af73 100644 --- "a/content/zh/docs/ExtensionReference/dolphin-\351\224\201.md" +++ "b/content/zh/docs/ExtensionReference/dolphin-\351\224\201.md" @@ -1,4 +1,4 @@ -# B数据库锁 +# B数据库锁 如果需要保持数据库数据的一致性，可以使用LOCK TABLES来阻止其他用户修改表。 diff --git "a/content/zh/docs/ExtensionReference/dolphin\345\256\211\350\243\205.md" "b/content/zh/docs/ExtensionReference/dolphin\345\256\211\350\243\205.md" index d4717ac02ef1278958f39c0fc22f2e372970b9a1..ab96b8afdc0f7f4089e42a6e0a3e7272cad5521b 100644 --- "a/content/zh/docs/ExtensionReference/dolphin\345\256\211\350\243\205.md" +++ "b/content/zh/docs/ExtensionReference/dolphin\345\256\211\350\243\205.md" @@ -1,14 +1,14 @@ -# dolphin安装 +# dolphin安装 插件自动安装加载，无须手动安装加载。如果需要手动编译加载插件，步骤如下： ## 编译安装 -1. 编译安装openGauss。 +1. [编译安装openGauss](https://gitee.com/opengauss/openGauss-server/tree/5.0.0/#%E7%BC%96%E8%AF%91)。 -2. 将dolphin源码拷贝到openGauss源码contrib目录下。 +2. 将[dolphin源码](https://gitee.com/opengauss/Plugin/tree/5.0.0/contrib/dolphin)拷贝到openGauss-server源码的contrib目录下。 -3. 进去dolphin目录执行make install。 +3. 进入dolphin目录执行make install。 4. 创建B库并使用初始用户连接B库。 @@ -18,6 +18,6 @@ 2. 拷贝插件所需文件： dolphin.so 路径： app/lib/postgresql/。 - dolphin.control和dolphin--1.0.sql 路径 app/share/postgresql/ExtensionReference。 + dolphin.control和dolphin--1.0.sql 路径 app/share/postgresql/Extension。 3. 创建B库并使用初始用户连接B库。 \ No newline at end of file diff --git "a/content/zh/docs/ExtensionReference/dolphin\346\246\202\350\277\260.md" "b/content/zh/docs/ExtensionReference/dolphin\346\246\202\350\277\260.md" index b88eb62bf08598792a4ee8a279eafc71ebe02a7a..39eaffdb71330d0fa4e505e1aee4b84811ec7eeb 100644 --- "a/content/zh/docs/ExtensionReference/dolphin\346\246\202\350\277\260.md" +++ "b/content/zh/docs/ExtensionReference/dolphin\346\246\202\350\277\260.md" @@ -1,3 +1,3 @@ -# dolphin概述 +# dolphin概述 -openGauss提供dolphin ExtensionReference（版本为dolphin-1.0.0）。dolphin ExtensionReference是openGauss的MySQL兼容性数据库（dbcompatibility='B'）扩展，从关键字、数据类型、常量与宏、函数和操作符、表达式、类型转换、DDL/DML/DCL语法、存储过程/自定义函数、系统视图等方面兼容MySQL数据库。dolphin插件继承内核原有SQL语法，在[dolphin语法介绍](dolphin语法介绍.md)中，将主要介绍对于内核语法有新增、修改的内容，和内核保持一致的语法等将不再额外写出。 \ No newline at end of file +openGauss提供dolphin Extension（版本为dolphin-1.0.0）。dolphin Extension是openGauss的MySQL兼容性数据库（dbcompatibility='B'）扩展，从关键字、数据类型、常量与宏、函数和操作符、表达式、类型转换、DDL/DML/DCL语法、存储过程/自定义函数、系统视图等方面兼容MySQL数据库。dolphin插件继承内核原有SQL语法，在[dolphin语法介绍](dolphin语法介绍.md)中，将主要介绍对于内核语法有新增、修改的内容，和内核保持一致的语法等将不再额外写出。 \ No newline at end of file diff --git "a/content/zh/docs/ExtensionReference/dolphin\350\257\255\346\263\225\344\273\213\347\273\215.md" "b/content/zh/docs/ExtensionReference/dolphin\350\257\255\346\263\225\344\273\213\347\273\215.md" index 0a0c88320a9c475df0bcab1e206604ed06ae5a5d..bb15903f28091b43ff00b65178255b31b1c632b9 100644 --- "a/content/zh/docs/ExtensionReference/dolphin\350\257\255\346\263\225\344\273\213\347\273\215.md" +++ "b/content/zh/docs/ExtensionReference/dolphin\350\257\255\346\263\225\344\273\213\347\273\215.md" @@ -1,4 +1,4 @@ -# dolphin语法介绍 +# dolphin语法介绍 - **[SQL参考](dolphin-SQL参考.md)** diff --git "a/content/zh/docs/ExtensionReference/dolphin\351\231\220\345\210\266.md" "b/content/zh/docs/ExtensionReference/dolphin\351\231\220\345\210\266.md" index 2449359f58fec31d768770e32a8245e9fdfdab34..d17948a8500afaf75dcd0ddf64504ead99cd215c 100644 --- "a/content/zh/docs/ExtensionReference/dolphin\351\231\220\345\210\266.md" +++ "b/content/zh/docs/ExtensionReference/dolphin\351\231\220\345\210\266.md" @@ -1,10 +1,10 @@ -# dolphin限制 +# dolphin限制 - 不支持小型化版本。 - 不支持删除dolphin插件。 - dolphin插件只能在B兼容性数据库下创建。 -- dolphin插件需要在pg_catalog等schema下创建数据类型、函数等，所以加载dolphin插件需要初始用户权限。openGauss将在第一次通过初始用户或拥有初始用户权限的用户连接B数据库时自动加载dolphin插件。如果一个B兼容性数据库从来没有被初始用户或拥有初始用户权限的用户连接过，那么它也不会加载dolphin插件。 +- dolphin插件需要在pg_catalog等schema下创建数据类型、函数等，所以加载dolphin插件需要初始用户权限。B兼容性数据库必须加载dolphin插件才可被连接。openGauss将在第一次通过初始用户或拥有初始用户权限的用户连接B数据库时自动加载dolphin插件。 - dolphin中所有新增/修改的语法不支持在gsql客户端通过```\h```查看帮助说明，不支持在gsql客户端自动补齐。 - dolphin插件的创建会删除数据库存在的插件所需的同名函数和类型以及之前存在的与之依赖的对象。 - dolphin插件依赖于public schema，因此不支持使用drop schema的方式删除public schema。 -- 连接安装有dolphin插件的B兼容性数据库时，会默认修改GUC参数[behavior_compat_options](../DataBaseReference/平台和客户端兼容性.md#zh-cn_topic_0283137574_zh-cn_topic_0237124754_section1980124735516)，增加```display_leading_zero```和```select_into_return_null```选项，以保持兼容性。 \ No newline at end of file +- 连接安装有dolphin插件的B兼容性数据库时，会默认修改GUC参数[behavior_compat_options](../DatabaseReference/平台和客户端兼容性.md#zh-cn_topic_0283137574_zh-cn_topic_0237124754_section1980124735516)，增加```display_leading_zero```和```select_into_return_null```选项，以保持兼容性。 \ No newline at end of file diff --git a/content/zh/docs/ExtensionReference/figures/assignment_value.png b/content/zh/docs/ExtensionReference/figures/assignment_value.png new file mode 100644 index 0000000000000000000000000000000000000000..13c05e0886942c714f88dd0644e4432d232c62f7 Binary files /dev/null and b/content/zh/docs/ExtensionReference/figures/assignment_value.png differ diff --git a/content/zh/docs/ExtensionReference/figures/case.jpg b/content/zh/docs/ExtensionReference/figures/case.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a1c19617092c24a213aef5f0b06e7472ab9b3b42 Binary files /dev/null and b/content/zh/docs/ExtensionReference/figures/case.jpg differ diff --git a/content/zh/docs/ExtensionReference/figures/nvl.jpg b/content/zh/docs/ExtensionReference/figures/nvl.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9c378ec205db7c788fa900344dbcc2aecb25f120 Binary files /dev/null and b/content/zh/docs/ExtensionReference/figures/nvl.jpg differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.png new file mode 100644 index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-caution.png differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.png new file mode 100644 index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-danger.png differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.gif deleted file mode 100644 index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.png new file mode 100644 index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-note.png differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.gif deleted file mode 100644 index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.png new file mode 100644 index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-notice.png differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.gif deleted file mode 100644 index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.png new file mode 100644 index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-tip.png differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.gif b/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.gif and /dev/null differ diff --git a/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.png b/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.png new file mode 100644 index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8 Binary files /dev/null and b/content/zh/docs/ExtensionReference/public_sys-resources/icon-warning.png differ diff --git a/content/zh/docs/GettingStarted/.keep b/content/zh/docs/GettingStarted/.keep deleted file mode 100644 index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000 diff --git "a/content/zh/docs/GettingStarted/C-C++\350\257\255\350\250\200.md" "b/content/zh/docs/GettingStarted/C-C++\350\257\255\350\250\200.md" index f15b7af767e30a09bdb465a87d1a7362e5e0abdb..56989a5fbf0cc0b5a4bf7372a3ea7c8655cfeae5 100644 --- "a/content/zh/docs/GettingStarted/C-C++\350\257\255\350\250\200.md" +++ "b/content/zh/docs/GettingStarted/C-C++\350\257\255\350\250\200.md" @@ -1,4 +1,4 @@ -# C/C++语言 +# C/C++语言 - **[ODBC](ODBC.md)** diff --git a/content/zh/docs/GettingStarted/GettingStarted.md b/content/zh/docs/GettingStarted/GettingStarted.md index c2c530202af52544c90560fb5f0f1d25ab8c2748..1c432da70f38a2389d6d7937f56fc4d516263cc4 100644 --- a/content/zh/docs/GettingStarted/GettingStarted.md +++ b/content/zh/docs/GettingStarted/GettingStarted.md @@ -4,6 +4,6 @@ 例如， [安装指南](../InstallationGuide/InstallationGuide.md)提供有关安装要求和过程的信息，而 [数据库管理](../DatabaseAdministrationGuide/数据库管理指南.md)提供有关管理的信息。 - [应用开发指南](../DeveloperGuide/应用开发指南.md)介绍了openGauss的应用开发指导。 + [应用开发指南](../DeveloperGuide/应用开发指南.md)介绍了openGauss的应用开发指导。 -例如， [内存优化表MOT管理](../DatabaseAdministrationGuide/内存优化表MOT管理.md)部分详细介绍了内存优化表，这是一种与标准存储引擎并排嵌入的高性能存储引擎。其中包括MOT简介（包括性能基准），使用MOT部分为完整的手册指南，MOT概念部分作为总结，以便大家对MOT设计和技术有更深入的了解。 \ No newline at end of file + 例如， [内存优化表MOT管理](../DatabaseAdministrationGuide/内存优化表MOT管理.md)部分详细介绍了内存优化表，这是一种与标准存储引擎并排嵌入的高性能存储引擎。其中包括MOT简介（包括性能基准），使用MOT部分为完整的手册指南，MOT概念部分作为总结，以便大家对MOT设计和技术有更深入的了解。 \ No newline at end of file diff --git a/content/zh/docs/GettingStarted/Java.md b/content/zh/docs/GettingStarted/Java.md index 4794eb32282b166ccd57bf445f0e1d1b78536cf3..fe169c3f01802c5d85dd46e356ccf53461533a0e 100644 --- a/content/zh/docs/GettingStarted/Java.md +++ b/content/zh/docs/GettingStarted/Java.md @@ -1,4 +1,4 @@ -# Java +# Java JDBC（Java Database Connectivity，Java数据库连接）是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问接口，应用程序可基于它操作数据。openGauss库提供了对JDBC 4.0特性的支持，需要使用JDK1.8版本编译程序代码，不支持JDBC桥接ODBC方式。 @@ -33,7 +33,7 @@ JDBC提供了三个方法，用于创建数据库连接。 示例： -> **说明：** +> **说明：** >下面示例中黑体加下划线的字段需要替换成用户自己的信息，其中： > >- **127.0.0.1**：数据库所在的主机地址。 @@ -252,7 +252,7 @@ JDBC提供了三个方法，用于创建数据库连接。 ## 插入操作 -> **说明：** +> **说明：** >插入操作执行前需要确保执行了[创建表](#section1969315347146)操作，表名为test，表结构如下。 >``` >create table test (id int,name varchar (10)); @@ -348,7 +348,7 @@ JDBC提供了三个方法，用于创建数据库连接。 ## SELECT操作 -> **说明：** +> **说明：** >请先完成[创建表](#section1969315347146)和[插入操作](#section1603173921418)。 - 使用prepareStatement执行查询操作可以使用预编译，动态的添加参数也可以执行普通的SQL语句。 @@ -426,7 +426,7 @@ JDBC提供了三个方法，用于创建数据库连接。 ## 更新操作 -> **说明：** +> **说明：** >请先完成[创建表](#section1969315347146)和[插入操作](#section1603173921418)。 - 使用Statement执行更新操作，然后执行查询语句判断更新是否成功。 diff --git a/content/zh/docs/GettingStarted/ODBC.md b/content/zh/docs/GettingStarted/ODBC.md index 404d2aff779e5670f799dea3c8025d0ef8e45565..f2feb92473eef1b1941989b4a99b1d13e3c0d43e 100644 --- a/content/zh/docs/GettingStarted/ODBC.md +++ b/content/zh/docs/GettingStarted/ODBC.md @@ -1,11 +1,11 @@ -# ODBC +# ODBC ODBC（Open Database Connectivity，开放数据库互连）是由Microsoft公司基于X/OPEN CLI提出的用于访问数据库的应用程序编程接口。应用程序通过ODBC提供的API与数据库进行交互，增强了应用程序的可移植性、扩展性和可维护性。 ODBC的系统结构参见[图1](#zh-cn_topic_0283137057_fig1255101034110)。 **图 1** ODBC系统机构 - + openGauss目前在以下环境中提供对ODBC的支持。 @@ -234,11 +234,11 @@ openGauss目前在以下环境中提供对ODBC的支持。
SQLAllocHandle：申请句柄资源，可替代如下函数：
-SQLAllocHandle：申请句柄资源，可替代如下函数：
+SQLFreeHandle：释放句柄资源，可替代如下函数：
-SQLFreeHandle：释放句柄资源，可替代如下函数：
+openGauss安装前需要准备相应的软硬件环境以及完成相关配置。
本文档提供了openGauss安装所需的最低要求，实际安装中，请用户根据实际情况进行规划。
-更多信息，请参考安装准备。
+更多信息，请参考安装准备。
安装包需要在openGauss开源社区下载并且对安装包内容进行检查，详细请参见获取安装包。
+安装包需要在openGauss开源社区下载并且对安装包内容进行检查，详细请参见获取安装包。
| psutil | netifaces | cffi | pycparser | cryptography | pynacl | bcrypt | paramiko | +
rdma用户态poll占用起止cpu，ss_interconnect_type为RDMA时有效，形如"10 15"，中间以空格分隔。
例如，查看CREATE DATABASE命令的参数可使用下面的命令：
openGauss=# \help CREATE DATABASE Command: CREATE DATABASE - AboutopenGauss: create a new database + Description: create a new database Syntax: CREATE DATABASE database_name [ [ WITH ] {[ OWNER [=] user_name ]| @@ -1173,7 +1173,7 @@ omm@[local] openGauss=# 元命令的详细说明请参见[表11 一般的元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table23103470)、[表12 查询缓存区元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table8624338)、[表13 输入/输出元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table62130565)、[表14 显示信息元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table44907299)、[表16 格式化元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table53911699)、[表18 连接元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table37189353)、[表19 操作系统元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table32146234)、[表20 变量元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table50076468)和[表22 大对象元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table55465693)。 -> **须知：** +> **须知：** >以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 **表 11** 一般的元命令 @@ -1325,7 +1325,7 @@ omm@[local] openGauss=# -> **说明：** +> **说明：** >[表14 显示信息元命令](#zh-cn_topic_0237152146_zh-cn_topic_0059778645_zh-cn_topic_0058968158_table44907299)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 **表 14** 显示信息元命令 @@ -2262,7 +2262,7 @@ DELIMITER命令为为客户端设置一个分隔符。当用户设置分隔符 数据库由于安全问题，禁止远程登录时使用trust模式。这时需要修改pg\_hba.conf里的连接认证信息。具体的设置信息请参见：《数据库管理指南》中“管理数据库安全 \> 客户端接入认证 \> 配置文件参考”章节。 - > **说明：** + > **说明：** > >请不要修改pg\_hba.conf中openGauss主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在openGauss之外，而非openGauss内部。 @@ -2316,7 +2316,7 @@ DELIMITER命令为为客户端设置一个分隔符。当用户设置分隔符 GRANT CONNECT ON DATABASE postgres TO user1; - > **说明：** + > **说明：** >实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 > >``` @@ -2422,7 +2422,7 @@ DELIMITER命令为为客户端设置一个分隔符。当用户设置分隔符 目标数据库主节点的pg\_hba.conf里配置了当前客户端IP使用“gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到"sha256"后再试。配置方法见《开发者指南》中“管理数据库安全 \> 客户端接入认证 \> 配置文件参考”章节 。 - > **说明：** + > **说明：** > >- 请不要修改pg\_hba.conf中openGauss主机的相关设置，否则可能导致数据库功能故障。 >- 建议业务应用部署在openGauss之外，而非openGauss内部。 @@ -2437,7 +2437,7 @@ DELIMITER命令为为客户端设置一个分隔符。当用户设置分隔符 解决此问题，重试便可。同时请尽可能避免在升级等运维操作过程中，在openGauss内部运行业务程序，避免升级时因替换文件产生此问题。 - > **说明：** + > **说明：** > >此故障的core dump文件的可能堆栈是dl\_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 diff --git a/content/zh/docs/ToolandCommandReference/gstrace.md b/content/zh/docs/ToolandCommandReference/gstrace.md index c1dd7ef31e8fcad1b7f363c5a4bdfb747a5ffcec..27cd9aa144d44e3420aac40105802750be31c26d 100644 --- a/content/zh/docs/ToolandCommandReference/gstrace.md +++ b/content/zh/docs/ToolandCommandReference/gstrace.md @@ -1,10 +1,10 @@ -# gstrace +# gstrace ## 功能介绍 gstrace是openGauss提供的用来跟踪内核代码执行路径、记录内核数据结构、分析代码性能的工具。Trace的有限点位和数据在版本中被固化，无法动态添加和删除。 -> **警告：** +> **警告：** > >1. 对内核dump指定内存变量的数据用于诊断分析，不存在直接指定任意寄存器或者内存地址的行为。读取的内存地址均是在开发阶段硬编码，没有任意地读取或者修改寄存器或内存的操作。 >2. Trace点可能涉及敏感数据，收集trace信息前需要同用户协商，授权和许可后方可收集。 @@ -13,7 +13,7 @@ gstrace是openGauss提供的用来跟踪内核代码执行路径、记录内核 >5. Trace工具的权限为0700，仅限于数据库用户读、写和执行。 -> **说明：** +> **说明：** >如果进程异常终止，/dev/shm/ 目录下将会有gstrace\_trace\_cfg\_\*残留，可以手动清除。 ## 语法 diff --git a/content/zh/docs/ToolandCommandReference/kadmin-local.md b/content/zh/docs/ToolandCommandReference/kadmin-local.md index 36d561fc74c14ac370d368a483391788e59da93b..1e421a01d0c01af3f80addca17f30e7d49478904 100644 --- a/content/zh/docs/ToolandCommandReference/kadmin-local.md +++ b/content/zh/docs/ToolandCommandReference/kadmin-local.md @@ -1,4 +1,4 @@ -# kadmin.local +# kadmin.local ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/kdb5_util.md b/content/zh/docs/ToolandCommandReference/kdb5_util.md index aaef1078038a4a1fc1421f064a66dd7d89c28d9b..22fa6a7a99386ea69f5255b177d26e38716e0454 100644 --- a/content/zh/docs/ToolandCommandReference/kdb5_util.md +++ b/content/zh/docs/ToolandCommandReference/kdb5_util.md @@ -1,4 +1,4 @@ -# kdb5\_util +# kdb5\_util ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/kdestroy.md b/content/zh/docs/ToolandCommandReference/kdestroy.md index 59412789607e9d9f6b0ecbbe4e1d741faaf20c69..ff8400790a02035974600e1ad7bb278c620a492e 100644 --- a/content/zh/docs/ToolandCommandReference/kdestroy.md +++ b/content/zh/docs/ToolandCommandReference/kdestroy.md @@ -1,4 +1,4 @@ -# kdestroy +# kdestroy ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/kinit.md b/content/zh/docs/ToolandCommandReference/kinit.md index 5b5e30ff94a11982ae8224b58a36e19aecf84784..eb266f98b8591b434d97ce84453ed48bcef06790 100644 --- a/content/zh/docs/ToolandCommandReference/kinit.md +++ b/content/zh/docs/ToolandCommandReference/kinit.md @@ -1,4 +1,4 @@ -# kinit +# kinit ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/klist.md b/content/zh/docs/ToolandCommandReference/klist.md index be859181d379d71a2eddd3552412b648430245ef..4b7851376e7acdbeeebb8d7c3d3d516a30ba0809 100644 --- a/content/zh/docs/ToolandCommandReference/klist.md +++ b/content/zh/docs/ToolandCommandReference/klist.md @@ -1,4 +1,4 @@ -# klist +# klist ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/krb5kdc.md b/content/zh/docs/ToolandCommandReference/krb5kdc.md index 299371017bd8a33efc20fd372b7f88edcd6f6cef..b0ef5d5e883fa39cd92ec51b2ead97251cbe849a 100644 --- a/content/zh/docs/ToolandCommandReference/krb5kdc.md +++ b/content/zh/docs/ToolandCommandReference/krb5kdc.md @@ -1,4 +1,4 @@ -# krb5kdc +# krb5kdc ## 功能介绍 diff --git "a/content/zh/docs/ToolandCommandReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md" "b/content/zh/docs/ToolandCommandReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md" index 6a0b7726178d1b940f8c58327aa488a0c47312fb..2b82d47682c85b6dfe782c6c865a56842f54e49e 100644 --- "a/content/zh/docs/ToolandCommandReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md" +++ "b/content/zh/docs/ToolandCommandReference/openGauss\345\217\257\350\277\220\350\241\214\350\204\232\346\234\254\345\212\237\350\203\275\350\257\264\346\230\216.md" @@ -1,4 +1,4 @@ -# openGauss可运行脚本功能说明 +# openGauss可运行脚本功能说明 以下是openGauss常用可执行脚本，仅供openGauss接口使用。 diff --git a/content/zh/docs/ToolandCommandReference/pg_archivecleanup.md b/content/zh/docs/ToolandCommandReference/pg_archivecleanup.md index 156c722941c33d560e205cce6a759deeeaf3ec5d..4ec8f1ac62699d6b5b0d2ba2461a2ed3f59489e2 100644 --- a/content/zh/docs/ToolandCommandReference/pg_archivecleanup.md +++ b/content/zh/docs/ToolandCommandReference/pg_archivecleanup.md @@ -1,4 +1,4 @@ -# pg\_archivecleanup +# pg\_archivecleanup ## 功能介绍 @@ -24,7 +24,7 @@ pg_archivecleanup [OPTION]... ARCHIVELOCATION OLDESTKEPTWALFILE 打印pg\_archivecleanup的版本并退出。 -- -x ExtensionReference +- -x Extension 当该程序用作单独的工具时，提供一个扩展选项，只选择对应扩展名格式的文件。 diff --git a/content/zh/docs/ToolandCommandReference/pg_config.md b/content/zh/docs/ToolandCommandReference/pg_config.md index 66dd3a77c2af662127f9b80502fa44813d519db1..b84bee3d44e9eba41710edc05d1e8ca6e91e4e29 100644 --- a/content/zh/docs/ToolandCommandReference/pg_config.md +++ b/content/zh/docs/ToolandCommandReference/pg_config.md @@ -1,4 +1,4 @@ -# pg\_config +# pg\_config ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/pg_controldata.md b/content/zh/docs/ToolandCommandReference/pg_controldata.md index eb0eda9a7bad5369c67b446edde0331779bd3c9e..31d99283b389288949ef2543fb5528f23a566b67 100644 --- a/content/zh/docs/ToolandCommandReference/pg_controldata.md +++ b/content/zh/docs/ToolandCommandReference/pg_controldata.md @@ -1,4 +1,4 @@ -# pg\_controldata +# pg\_controldata ## 功能介绍 diff --git a/content/zh/docs/ToolandCommandReference/pg_recvlogical.md b/content/zh/docs/ToolandCommandReference/pg_recvlogical.md index 808d1792f32b2436f649aac52050e44aad5194f1..f9cc6bbc51c011c9912abca4eb78be0ff2845efb 100644 --- a/content/zh/docs/ToolandCommandReference/pg_recvlogical.md +++ b/content/zh/docs/ToolandCommandReference/pg_recvlogical.md @@ -1,4 +1,4 @@ -# pg\_recvlogical +# pg\_recvlogical ## 功能介绍 @@ -72,7 +72,7 @@ pg_recvlogical [OPTION]... 参数的取值为：include-xids、skip-empty-xacts、include-timestamp、only-local、force-binary、white-table-list、standby-connection、parallel-decode-num、decode-style、sending-batch、max-txn-in-memory、max-reorderbuffer-in-memory。 详细请参见《SQL参考》中“ 内置函数 \> 系统管理函数 \> 逻辑复制函数\> pg_logical_slot_peek_changes > options”以及 “应用开发 > openGauss JDBC 编程指南 > 示例：逻辑复制代码示例”章节。 - 链接：https://opengauss.org/zh/docs/latest/docs/DeveloperGuide/%E7%A4%BA%E4%BE%8B-%E9%80%BB%E8%BE%91%E5%A4%8D%E5%88%B6%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B.html + 链接：https://docs.opengauss.org/zh/docs/5.0.0/docs/DeveloperGuide/%E7%A4%BA%E4%BE%8B-%E9%80%BB%E8%BE%91%E5%A4%8D%E5%88%B6%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B.html - -P, --plugin=PLUGIN diff --git a/content/zh/docs/ToolandCommandReference/pg_resetxlog.md b/content/zh/docs/ToolandCommandReference/pg_resetxlog.md index a8789a93c6cf12693337f7e1bf1abc7cc01c3cdd..fab85ff8f673e8fb8abc1d748ab0ad29e5b17ae6 100644 --- a/content/zh/docs/ToolandCommandReference/pg_resetxlog.md +++ b/content/zh/docs/ToolandCommandReference/pg_resetxlog.md @@ -1,10 +1,10 @@ -# pg\_resetxlog +# pg\_resetxlog ## 功能介绍 pg\_resetxlog是一个重新设置数据库事务文件的工具。 -> **注意：** +> **注意：** >通过pg\_resetxlog重新设置之前，需要先停止数据库。 ## 前提条件 diff --git a/content/zh/docs/ToolandCommandReference/pscp.md b/content/zh/docs/ToolandCommandReference/pscp.md index ad0c78fe7adfbe31d9aa960bbb38bbbc05525515..1d476fbb760355b314fbf2dda02e27b7121a9188 100644 --- a/content/zh/docs/ToolandCommandReference/pscp.md +++ b/content/zh/docs/ToolandCommandReference/pscp.md @@ -1,4 +1,4 @@ -# pscp +# pscp ## 基本功能 diff --git a/content/zh/docs/ToolandCommandReference/pssh.md b/content/zh/docs/ToolandCommandReference/pssh.md index 2d5a0b46edab19cbe28e44bd9f4f78935f28251a..9c31bde78e5cf828017058609e6a4ff5f86b918f 100644 --- a/content/zh/docs/ToolandCommandReference/pssh.md +++ b/content/zh/docs/ToolandCommandReference/pssh.md @@ -1,4 +1,4 @@ -# pssh +# pssh ## 基本功能 diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.png new file mode 100644 index 0000000000000000000000000000000000000000..64225130e40623f9d66943cd01d9222145400010 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-caution.png differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.png new file mode 100644 index 0000000000000000000000000000000000000000..ddaf56a1d67c1a62fc17244eab421625d09b2929 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-danger.png differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.gif deleted file mode 100644 index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.png new file mode 100644 index 0000000000000000000000000000000000000000..789e42a8a4e810f4848631a7a64a8fe521ef0fe4 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-note.png differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.gif deleted file mode 100644 index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.png new file mode 100644 index 0000000000000000000000000000000000000000..21ce3f259efdaae743389e414434b864c69dd482 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-notice.png differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.gif deleted file mode 100644 index 93aa72053b510e456b149f36a0972703ea9999b7..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.png new file mode 100644 index 0000000000000000000000000000000000000000..88512187b1f94c2b41be2031edb52bd9220919b7 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-tip.png differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.gif b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.gif deleted file mode 100644 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 Binary files a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.gif and /dev/null differ diff --git a/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.png b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.png new file mode 100644 index 0000000000000000000000000000000000000000..7dd8edd5ee9c3519079786ba6fd2dd4f0801a5e8 Binary files /dev/null and b/content/zh/docs/ToolandCommandReference/public_sys-resources/icon-warning.png differ diff --git a/content/zh/docs/ToolandCommandReference/transfer-py.md b/content/zh/docs/ToolandCommandReference/transfer-py.md index e2e70176783b6657ff7502481230f8beea11afbb..795406118fcdc93526f4d3a0cdd368e1bfd64605 100644 --- a/content/zh/docs/ToolandCommandReference/transfer-py.md +++ b/content/zh/docs/ToolandCommandReference/transfer-py.md @@ -1,4 +1,4 @@ -# transfer.py +# transfer.py ## 功能介绍 diff --git "a/content/zh/docs/ToolandCommandReference/\345\256\211\345\205\250\350\256\276\350\256\241.md" "b/content/zh/docs/ToolandCommandReference/\345\256\211\345\205\250\350\256\276\350\256\241.md" index 86e57f9d04afec16e9df7445eaeb3b8f4062ce36..6e8c4cff4bab3cc802a751069e7670aa01dd3f42 100644 --- "a/content/zh/docs/ToolandCommandReference/\345\256\211\345\205\250\350\256\276\350\256\241.md" +++ "b/content/zh/docs/ToolandCommandReference/\345\256\211\345\205\250\350\256\276\350\256\241.md" @@ -1,4 +1,4 @@ -# 安全设计 +# 安全设计 ## 手动替换证书步骤 diff --git "a/content/zh/docs/ToolandCommandReference/\345\256\211\350\243\205\345\222\214\345\215\270\350\275\275\345\267\245\345\205\267\344\273\213\347\273\215.md" "b/content/zh/docs/ToolandCommandReference/\345\256\211\350\243\205\345\222\214\345\215\270\350\275\275\345\267\245\345\205\267\344\273\213\347\273\215.md" index 2cd9c370c316ab75e4fc38b304f7fa917cdbb142..9c69fe51977d973fc4cacc2d64a0a4ed0c4f02dd 100644 --- "a/content/zh/docs/ToolandCommandReference/\345\256\211\350\243\205\345\222\214\345\215\270\350\275\275\345\267\245\345\205\267\344\273\213\347\273\215.md" +++ "b/content/zh/docs/ToolandCommandReference/\345\256\211\350\243\205\345\222\214\345\215\270\350\275\275\345\267\245\345\205\267\344\273\213\347\273\215.md" @@ -1,4 +1,4 @@ -# 安装和卸载工具介绍 +# 安装和卸载工具介绍 使用cm_install工具可以在未部署CM的openGauss数据库集群上部署CM，cm_uninstall可以在已部署CM的openGauss集群上卸载掉CM，且不会影响DN集群。 diff --git "a/content/zh/docs/ToolandCommandReference/\345\256\242\346\210\267\347\253\257\345\267\245\345\205\267.md" "b/content/zh/docs/ToolandCommandReference/\345\256\242\346\210\267\347\253\257\345\267\245\345\205\267.md" index 4da262910fe2d5828c74ed30fe861470dbf35c0a..8cc2c1673dfd7c67cadf726901b950e6856d017a 100644 --- "a/content/zh/docs/ToolandCommandReference/\345\256\242\346\210\267\347\253\257\345\267\245\345\205\267.md" +++ "b/content/zh/docs/ToolandCommandReference/\345\256\242\346\210\267\347\253\257\345\267\245\345\205\267.md" @@ -1,3 +1,3 @@ -# 客户端工具 +# 客户端工具 数据库在部署成功后，需要通过一些工具来便捷地连接数据库，对数据库进行各种操作和调试。openGauss提供了一些数据库连接工具。通过这些工具可以方便地连接数据库并对数据库进行数据操作。 \ No newline at end of file diff --git "a/content/zh/docs/ToolandCommandReference/\345\267\245\345\205\267\344\270\200\350\247\210\350\241\250.md" "b/content/zh/docs/ToolandCommandReference/\345\267\245\345\205\267\344\270\200\350\247\210\350\241\250.md" index d5afce64577a8f84d71614aa46c74ab7ade8b8bd..c30c9b33930164a8e8cc1a6ecdc92f1d4de5d864 100644 --- "a/content/zh/docs/ToolandCommandReference/\345\267\245\345\205\267\344\270\200\350\247\210\350\241\250.md" +++ "b/content/zh/docs/ToolandCommandReference/\345\267\245\345\205\267\344\270\200\350\247\210\350\241\250.md" @@ -1,4 +1,4 @@ -# 工具一览表 +# 工具一览表 openGauss提供客户端和服务器端应用程序（工具），帮助用户更好地维护openGauss，提供的所有工具如[表1](#zh-cn_topic_0287276012_zh-cn_topic_0237152139_table11292939125111)所示。工具位于安装数据库服务器的$GPHOME/script和$GAUSSHOME/bin路径下。 diff --git "a/content/zh/docs/ToolandCommandReference/\346\234\215\345\212\241\347\253\257\345\267\245\345\205\267.md" "b/content/zh/docs/ToolandCommandReference/\346\234\215\345\212\241\347\253\257\345\267\245\345\205\267.md" index 7e0afb7a8f3ff37ed7fae6a87b09f2ec40973e47..adf9b99d2cfaadb3bab44ce6eb397fdec939cf9e 100644 --- "a/content/zh/docs/ToolandCommandReference/\346\234\215\345\212\241\347\253\257\345\267\245\345\205\267.md" +++ "b/content/zh/docs/ToolandCommandReference/\346\234\215\345\212\241\347\253\257\345\267\245\345\205\267.md" @@ -1,4 +1,4 @@ -# 服务端工具 +# 服务端工具 在使用openGauss过程中，经常需要对openGauss进行安装、卸载以及健康管理。为了简单、方便的维护openGauss，openGauss提供了一系列的管理工具。 diff --git "a/content/zh/docs/ToolandCommandReference/\347\211\271\346\200\247\344\273\213\347\273\215.md" "b/content/zh/docs/ToolandCommandReference/\347\211\271\346\200\247\344\273\213\347\273\215.md" index b3f96ba1711cd4a00e9268903ca220178603e2a5..48e795f9880788338fdfc93e98be2795ff8f6cd7 100644 --- "a/content/zh/docs/ToolandCommandReference/\347\211\271\346\200\247\344\273\213\347\273\215.md" +++ "b/content/zh/docs/ToolandCommandReference/\347\211\271\346\200\247\344\273\213\347\273\215.md" @@ -1,4 +1,4 @@ -# 特性介绍 +# 特性介绍 ## cm\_agent @@ -90,6 +90,43 @@ cm\_server是用来进行数据库实例管理和实例仲裁的组件。主要 +## CM支持日志管理 + +- 简介：CM支持对$GAUSSLOG下的日志进行压缩和删除。 + +- 管理对象：$GAUSSLOG路径下[表1 日志关键字](#table57617155518)中对应的日志。 + +- 压缩删除时机：enable\_log\_compress开启后，间隔log\_threshold\_check\_interval。 + +- 日志压缩： + + - 对于单个目录下相同工具名的日志，除时间戳最新的日志外，剩余日志全部压缩。 + - 日志压缩后与压缩前路径保持一致，压缩文件命名格式为"工具名-日志创建时间.log.gz"。 + +- 日志删除： + + - 当所有日志总大小超过（log\_max\_size\*95/100）MB时，根据压缩日志文件名时间，依次删除历史压缩日志，直到日志总大小小于（log\_max\_size\*95/100）MB。 + - 当所有日志总个数超过log\_max\_count，根据压缩日志文件名时间，依次删除超过保留天数log\_saved\_days的压缩日志，直到日志总个数小于log\_max\_count。 + - 日志压缩能力受内存限制，最多只能检测到30000个日志文件。总日志量超过30000个文件时，无法保证日志能被正常压缩及删除。可以通过调整log\_saved\_days和log\_threshold\_check\_interval快速清理已压缩日志文件。 + + **表 1** 日志关键字 + + + +
| + | +
|---|
"cm_client-", "cm_ctl-", "gs_clean-", "gs_ctl-", "gs_guc-", "gs_dump-", "gs_dumpall-", "gs_restore-", "gs_upgrade-", "gs_initcm-", "gs_initdb-", "gs_check-", +"cm_agent-", "system_call-", "cm_server-", "om_monitor-", "gs_local-", "gs_preinstall-", "gs_install-", "gs_replace-", "gs_uninstall-", "gs_om-", "pssh-", "pscp-", +"gs_upgradectl-", "gs_expand-", "gs_shrink-", "gs_postuninstall-", "gs_backup-", "gs_checkos-", "gs_collector-", "GaussReplace-", "GaussOM-", "gs_checkperf-", +"roach_agent-", "roach_controller-", "sync-", "postgresql-", "sessionstat-", "system_alarm-", "pg_perf-", "slow_query_log-", "asp-", "etcd-", "etcd_", "gs_cgroup-", +"gs_hotpatch-", "cmd_sender-", "uploader-", "checkRunStatus-", "ffic_gaussdb-", "key_event-", "gs_streaming_disaster_recovery-", "mem_log-", "remote_client-" + |
+
+ {{ i18n "catalog_text" }}
+ {{ range .Site.Data.docsversion }} +{{ i18n "other_text" }}
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+