-
-
+
+
+
+
+数据库级导出 。
+纯文本格式 自定义归档格式 目录归档格式 tar归档格式 模式级导出 。
+导出模式的全量信息。 仅导出模式中数据。 仅导出对象的定义，包含表定义、存储过程定义和索引定义等。 表级导出 。
导出表的全量信息。 仅导出表中数据。 仅导出表的定义。
+
+数据库级导出 。
+
+使用gsql元命令导入数据 。
+
+
+
+
+gs\_dump和gs\_dumpall通过-U指定执行导出的用户帐户。如果当前使用的帐户不具备导出所要求的权限时，会无法导出数据。此时，可在导出命令中设置--role参数来指定具备权限的角色。在执行命令后，gs\_dump和gs\_dumpall会使用--role参数指定的角色，完成导出动作。可使用该功能的场景请参见[表1](#zh-cn_topic_0237121167_table08278213504)，详细操作请参见[无权限角色导出数据](无权限角色导出数据.md)。
+
+gs\_dump和gs\_dumpall通过对导出的数据文件加密，导入时对加密的数据文件进行解密，可以防止数据信息泄露，为数据库的安全提供保证。
+
+gs\_dump和gs\_dumpall工具在进行数据导出时，其他用户可以访问openGauss数据库（读或写）。
+
+gs\_dump和gs\_dumpall工具支持导出完整一致的数据。例如，T1时刻启动gs\_dump导出A数据库，或者启动gs\_dumpall导出openGauss数据库，那么导出数据结果将会是T1时刻A数据库或者该openGauss数据库的数据状态，T1时刻之后对A数据库或openGauss数据库的修改不会被导出。
+
+## 注意事项
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262.md" "b/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262.md"
new file mode 100644
index 0000000000000000000000000000000000000000..6d62887dc12fab44180c5ead77668a9935ed5d2c
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262.md"
@@ -0,0 +1,231 @@
+# 环境部署
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## 证书生成
+
+
+
+
+
+
+
on：服务器端强制要求SSL连接。 off：服务器端对是否通过SSL连接不作强制要求。 on：服务器端强制要求SSL连接。 off：服务器端对是否通过SSL连接不作强制要求。
+
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
表4 。
+表4 。
+#include
+#include
+#ifdef WIN32
+#include
+#endif
+SQLHENV V_OD_Env; // Handle ODBC environment
+SQLHSTMT V_OD_hstmt; // Handle statement
+SQLHDBC V_OD_hdbc; // Handle connection
+char typename[100];
+SQLINTEGER value = 100;
+SQLINTEGER V_OD_erg,V_OD_buffer,V_OD_err,V_OD_id;
+int main(int argc,char *argv[])
+{
+ // 1. 申请环境句柄
+ V_OD_erg = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&V_OD_Env);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ printf("Error AllocHandle\n");
+ exit(0);
+ }
+ // 2. 设置环境属性（版本信息）
+ SQLSetEnvAttr(V_OD_Env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);
+ // 3. 申请连接句柄
+ V_OD_erg = SQLAllocHandle(SQL_HANDLE_DBC, V_OD_Env, &V_OD_hdbc);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ exit(0);
+ }
+ // 4. 设置连接属性
+ SQLSetConnectAttr(V_OD_hdbc, SQL_ATTR_AUTOCOMMIT, SQL_AUTOCOMMIT_ON, 0);
+ // 5. 连接数据源，这里的“userName”与“password”分别表示连接数据库的用户名和用户密码，请根据实际情况修改。
+ // 如果odbc.ini文件中已经配置了用户名密码，那么这里可以留空（""）；但是不建议这么做，因为一旦odbc.ini权限管理不善，将导致数据库用户密码泄露。
+ V_OD_erg = SQLConnect(V_OD_hdbc, (SQLCHAR*) "gaussdb", SQL_NTS,
+ (SQLCHAR*) "userName", SQL_NTS, (SQLCHAR*) "password", SQL_NTS);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ printf("Error SQLConnect %d\n",V_OD_erg);
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ exit(0);
+ }
+ printf("Connected !\n");
+ // 6. 设置语句属性
+ SQLSetStmtAttr(V_OD_hstmt,SQL_ATTR_QUERY_TIMEOUT,(SQLPOINTER *)3,0);
+ // 7. 申请语句句柄
+ SQLAllocHandle(SQL_HANDLE_STMT, V_OD_hdbc, &V_OD_hstmt);
+ // 8. 直接执行SQL语句。
+ SQLExecDirect(V_OD_hstmt,"drop table IF EXISTS customer_t1",SQL_NTS);
+ SQLExecDirect(V_OD_hstmt,"CREATE TABLE customer_t1(c_customer_sk INTEGER, c_customer_name VARCHAR(32));",SQL_NTS);
+ SQLExecDirect(V_OD_hstmt,"insert into customer_t1 values(25,li)",SQL_NTS);
+ // 9. 准备执行
+ SQLPrepare(V_OD_hstmt,"insert into customer_t1 values(?)",SQL_NTS);
+ // 10. 绑定参数
+ SQLBindParameter(V_OD_hstmt,1,SQL_PARAM_INPUT,SQL_C_SLONG,SQL_INTEGER,0,0,
+ &value,0,NULL);
+ // 11. 执行准备好的语句
+ SQLExecute(V_OD_hstmt);
+ SQLExecDirect(V_OD_hstmt,"select id from testtable",SQL_NTS);
+ // 12. 获取结果集某一列的属性
+ SQLColAttribute(V_OD_hstmt,1,SQL_DESC_TYPE,typename,100,NULL,NULL);
+ printf("SQLColAtrribute %s\n",typename);
+ // 13. 绑定结果集
+ SQLBindCol(V_OD_hstmt,1,SQL_C_SLONG, (SQLPOINTER)&V_OD_buffer,150,
+ (SQLLEN *)&V_OD_err);
+ // 14. 通过SQLFetch取结果集中数据
+ V_OD_erg=SQLFetch(V_OD_hstmt);
+ // 15. 通过SQLGetData获取并返回数据。
+ while(V_OD_erg != SQL_NO_DATA)
+ {
+ SQLGetData(V_OD_hstmt,1,SQL_C_SLONG,(SQLPOINTER)&V_OD_id,0,NULL);
+ printf("SQLGetData ----ID = %d\n",V_OD_id);
+ V_OD_erg=SQLFetch(V_OD_hstmt);
+ };
+ printf("Done !\n");
+ // 16. 断开数据源连接并释放句柄资源
+ SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
+ SQLDisconnect(V_OD_hdbc);
+ SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ return(0);
+ }
+```
+
+## 批量绑定示例代码
+#include
+#include
+#include
+#include
+
+#include "util.c"
+
+void Exec(SQLHDBC hdbc, SQLCHAR* sql)
+{
+ SQLRETURN retcode; // Return status
+ SQLHSTMT hstmt = SQL_NULL_HSTMT; // Statement handle
+ SQLCHAR loginfo[2048];
+
+ // Allocate Statement Handle
+ retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_STMT)",
+ hstmt, SQL_HANDLE_STMT);
+
+ // Prepare Statement
+ retcode = SQLPrepare(hstmt, (SQLCHAR*) sql, SQL_NTS);
+ sprintf((char*)loginfo, "SQLPrepare log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+
+ // Execute Statement
+ retcode = SQLExecute(hstmt);
+ sprintf((char*)loginfo, "SQLExecute stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+
+ // Free Handle
+ retcode = SQLFreeHandle(SQL_HANDLE_STMT, hstmt);
+ sprintf((char*)loginfo, "SQLFreeHandle stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+}
+
+int main ()
+{
+ SQLHENV henv = SQL_NULL_HENV;
+ SQLHDBC hdbc = SQL_NULL_HDBC;
+ int batchCount = 1000;
+ SQLLEN rowsCount = 0;
+ int ignoreCount = 0;
+
+ SQLRETURN retcode;
+ SQLCHAR dsn[1024] = {'\0'};
+ SQLCHAR loginfo[2048];
+
+ // 交互获取数据源名称
+ getStr("Please input your DSN", (char*)dsn, sizeof(dsn), 'N');
+ // 交互获取批量绑定的数据量
+ getInt("batchCount", &batchCount, 'N', 1);
+ do
+ {
+ // 交互获取批量绑定的数据中，不要入库的数据量
+ getInt("ignoreCount", &ignoreCount, 'N', 1);
+ if (ignoreCount > batchCount)
+ {
+ printf("ignoreCount(%d) should be less than batchCount(%d)\n", ignoreCount, batchCount);
+ }
+ }while(ignoreCount > batchCount);
+
+ retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_ENV)",
+ henv, SQL_HANDLE_ENV);
+
+ // Set ODBC Verion
+ retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION,
+ (SQLPOINTER*)SQL_OV_ODBC3, 0);
+ CHECK_ERROR(retcode, "SQLSetEnvAttr(SQL_ATTR_ODBC_VERSION)",
+ henv, SQL_HANDLE_ENV);
+
+ // Allocate Connection
+ retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_DBC)",
+ henv, SQL_HANDLE_DBC);
+
+ // Set Login Timeout
+ retcode = SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);
+ CHECK_ERROR(retcode, "SQLSetConnectAttr(SQL_LOGIN_TIMEOUT)",
+ hdbc, SQL_HANDLE_DBC);
+
+ // Set Auto Commit
+ retcode = SQLSetConnectAttr(hdbc, SQL_ATTR_AUTOCOMMIT,
+ (SQLPOINTER)(1), 0);
+ CHECK_ERROR(retcode, "SQLSetConnectAttr(SQL_ATTR_AUTOCOMMIT)",
+ hdbc, SQL_HANDLE_DBC);
+
+ // Connect to DSN
+ sprintf(loginfo, "SQLConnect(DSN:%s)", dsn);
+ retcode = SQLConnect(hdbc, (SQLCHAR*) dsn, SQL_NTS,
+ (SQLCHAR*) NULL, 0, NULL, 0);
+ CHECK_ERROR(retcode, loginfo, hdbc, SQL_HANDLE_DBC);
+
+ // init table info.
+ Exec(hdbc, "drop table if exists test_odbc_batch_insert");
+ Exec(hdbc, "create table test_odbc_batch_insert(id int primary key, col varchar2(50))");
+
+ // 下面的代码根据用户输入的数据量，构造出将要入库的数据:
+ {
+ SQLRETURN retcode;
+ SQLHSTMT hstmtinesrt = SQL_NULL_HSTMT;
+ int i;
+ SQLCHAR *sql = NULL;
+ SQLINTEGER *ids = NULL;
+ SQLCHAR *cols = NULL;
+ SQLLEN *bufLenIds = NULL;
+ SQLLEN *bufLenCols = NULL;
+ SQLUSMALLINT *operptr = NULL;
+ SQLUSMALLINT *statusptr = NULL;
+ SQLULEN process = 0;
+
+ // 这里是按列构造，每个字段的内存连续存放在一起。
+ ids = (SQLINTEGER*)malloc(sizeof(ids[0]) * batchCount);
+ cols = (SQLCHAR*)malloc(sizeof(cols[0]) * batchCount * 50);
+ // 这里是每个字段中，每一行数据的内存长度。
+ bufLenIds = (SQLLEN*)malloc(sizeof(bufLenIds[0]) * batchCount);
+ bufLenCols = (SQLLEN*)malloc(sizeof(bufLenCols[0]) * batchCount);
+ // 该行是否需要被处理，SQL_PARAM_IGNORE 或 SQL_PARAM_PROCEED
+ operptr = (SQLUSMALLINT*)malloc(sizeof(operptr[0]) * batchCount);
+ memset(operptr, 0, sizeof(operptr[0]) * batchCount);
+ // 该行的处理结果。
+ // 注：由于数据库中处理方式是同一语句隶属同一事务中，所以如果出错，那么待处理数据都将是出错的，并不会部分入库。
+ statusptr = (SQLUSMALLINT*)malloc(sizeof(statusptr[0]) * batchCount);
+ memset(statusptr, 88, sizeof(statusptr[0]) * batchCount);
+
+ if (NULL == ids || NULL == cols || NULL == bufLenCols || NULL == bufLenIds)
+ {
+ fprintf(stderr, "FAILED:\tmalloc data memory failed\n");
+ goto exit;
+ }
+
+ for (int i = 0; i < batchCount; i++)
+ {
+ ids[i] = i;
+ sprintf(cols + 50 * i, "column test value %d", i);
+ bufLenIds[i] = sizeof(ids[i]);
+ bufLenCols[i] = strlen(cols + 50 * i);
+ operptr[i] = (i < ignoreCount) ? SQL_PARAM_IGNORE : SQL_PARAM_PROCEED;
+ }
+
+ // Allocate Statement Handle
+ retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmtinesrt);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_STMT)",
+ hstmtinesrt, SQL_HANDLE_STMT);
+
+ // Prepare Statement
+ sql = (SQLCHAR*)"insert into test_odbc_batch_insert values(?, ?)";
+ retcode = SQLPrepare(hstmtinesrt, (SQLCHAR*) sql, SQL_NTS);
+ sprintf((char*)loginfo, "SQLPrepare log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)batchCount, sizeof(batchCount));
+ CHECK_ERROR(retcode, "SQLSetStmtAttr", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLBindParameter(hstmtinesrt, 1, SQL_PARAM_INPUT, SQL_C_SLONG, SQL_INTEGER, sizeof(ids[0]), 0,&(ids[0]), 0, bufLenIds);
+ CHECK_ERROR(retcode, "SQLBindParameter for id", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLBindParameter(hstmtinesrt, 2, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 50, 50, cols, 50, bufLenCols);
+ CHECK_ERROR(retcode, "SQLBindParameter for cols", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAMS_PROCESSED_PTR, (SQLPOINTER)&process, sizeof(process));
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAMS_PROCESSED_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAM_STATUS_PTR, (SQLPOINTER)statusptr, sizeof(statusptr[0]) * batchCount);
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAM_STATUS_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAM_OPERATION_PTR, (SQLPOINTER)operptr, sizeof(operptr[0]) * batchCount);
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAM_OPERATION_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLExecute(hstmtinesrt);
+ sprintf((char*)loginfo, "SQLExecute stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLRowCount(hstmtinesrt, &rowsCount);
+ CHECK_ERROR(retcode, "SQLRowCount execution", hstmtinesrt, SQL_HANDLE_STMT);
+
+ if (rowsCount != (batchCount - ignoreCount))
+ {
+ sprintf(loginfo, "(batchCount - ignoreCount)(%d) != rowsCount(%d)", (batchCount - ignoreCount), rowsCount);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ else
+ {
+ sprintf(loginfo, "(batchCount - ignoreCount)(%d) == rowsCount(%d)", (batchCount - ignoreCount), rowsCount);
+ CHECK_ERROR(SQL_SUCCESS, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+
+ // check row number returned
+ if (rowsCount != process)
+ {
+ sprintf(loginfo, "process(%d) != rowsCount(%d)", process, rowsCount);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ else
+ {
+ sprintf(loginfo, "process(%d) == rowsCount(%d)", process, rowsCount);
+ CHECK_ERROR(SQL_SUCCESS, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+
+ for (int i = 0; i < batchCount; i++)
+ {
+ if (i < ignoreCount)
+ {
+ if (statusptr[i] != SQL_PARAM_UNUSED)
+ {
+ sprintf(loginfo, "statusptr[%d](%d) != SQL_PARAM_UNUSED", i, statusptr[i]);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ }
+ else if (statusptr[i] != SQL_PARAM_SUCCESS)
+ {
+ sprintf(loginfo, "statusptr[%d](%d) != SQL_PARAM_SUCCESS", i, statusptr[i]);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ }
+
+ retcode = SQLFreeHandle(SQL_HANDLE_STMT, hstmtinesrt);
+ sprintf((char*)loginfo, "SQLFreeHandle hstmtinesrt");
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+ }
+
+
+exit:
+ printf ("\nComplete.\n");
+
+ // Connection
+ if (hdbc != SQL_NULL_HDBC) {
+ SQLDisconnect(hdbc);
+ SQLFreeHandle(SQL_HANDLE_DBC, hdbc);
+ }
+
+ // Environment
+ if (henv != SQL_NULL_HENV)
+ SQLFreeHandle(SQL_HANDLE_ENV, henv);
+
+ return 0;
+}
+```
+
diff --git "a/content/zh/docs/Developerguide/\347\244\272\344\276\213-3.md" "b/content/zh/docs/Developerguide/\347\244\272\344\276\213-3.md"
new file mode 100644
index 0000000000000000000000000000000000000000..3d185d7384c14d0d93c4a09d3a336844af9cd152
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\347\244\272\344\276\213-3.md"
@@ -0,0 +1,446 @@
+# 示例
+#include
+#include
+#ifdef WIN32
+#include
+#endif
+SQLHENV V_OD_Env; // Handle ODBC environment
+SQLHSTMT V_OD_hstmt; // Handle statement
+SQLHDBC V_OD_hdbc; // Handle connection
+char typename[100];
+SQLINTEGER value = 100;
+SQLINTEGER V_OD_erg,V_OD_buffer,V_OD_err,V_OD_id;
+int main(int argc,char *argv[])
+{
+ // 1. 申请环境句柄
+ V_OD_erg = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&V_OD_Env);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ printf("Error AllocHandle\n");
+ exit(0);
+ }
+ // 2. 设置环境属性（版本信息）
+ SQLSetEnvAttr(V_OD_Env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);
+ // 3. 申请连接句柄
+ V_OD_erg = SQLAllocHandle(SQL_HANDLE_DBC, V_OD_Env, &V_OD_hdbc);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ exit(0);
+ }
+ // 4. 设置连接属性
+ SQLSetConnectAttr(V_OD_hdbc, SQL_ATTR_AUTOCOMMIT, SQL_AUTOCOMMIT_ON, 0);
+ // 5. 连接数据源，这里的“userName”与“password”分别表示连接数据库的用户名和用户密码，请根据实际情况修改。
+ // 如果odbc.ini文件中已经配置了用户名密码，那么这里可以留空（""）；但是不建议这么做，因为一旦odbc.ini权限管理不善，将导致数据库用户密码泄露。
+ V_OD_erg = SQLConnect(V_OD_hdbc, (SQLCHAR*) "gaussdb", SQL_NTS,
+ (SQLCHAR*) "userName", SQL_NTS, (SQLCHAR*) "password", SQL_NTS);
+ if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
+ {
+ printf("Error SQLConnect %d\n",V_OD_erg);
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ exit(0);
+ }
+ printf("Connected !\n");
+ // 6. 设置语句属性
+ SQLSetStmtAttr(V_OD_hstmt,SQL_ATTR_QUERY_TIMEOUT,(SQLPOINTER *)3,0);
+ // 7. 申请语句句柄
+ SQLAllocHandle(SQL_HANDLE_STMT, V_OD_hdbc, &V_OD_hstmt);
+ // 8. 直接执行SQL语句。
+ SQLExecDirect(V_OD_hstmt,"drop table IF EXISTS customer_t1",SQL_NTS);
+ SQLExecDirect(V_OD_hstmt,"CREATE TABLE customer_t1(c_customer_sk INTEGER, c_customer_name VARCHAR(32));",SQL_NTS);
+ SQLExecDirect(V_OD_hstmt,"insert into customer_t1 values(25,li)",SQL_NTS);
+ // 9. 准备执行
+ SQLPrepare(V_OD_hstmt,"insert into customer_t1 values(?)",SQL_NTS);
+ // 10. 绑定参数
+ SQLBindParameter(V_OD_hstmt,1,SQL_PARAM_INPUT,SQL_C_SLONG,SQL_INTEGER,0,0,
+ &value,0,NULL);
+ // 11. 执行准备好的语句
+ SQLExecute(V_OD_hstmt);
+ SQLExecDirect(V_OD_hstmt,"select id from testtable",SQL_NTS);
+ // 12. 获取结果集某一列的属性
+ SQLColAttribute(V_OD_hstmt,1,SQL_DESC_TYPE,typename,100,NULL,NULL);
+ printf("SQLColAtrribute %s\n",typename);
+ // 13. 绑定结果集
+ SQLBindCol(V_OD_hstmt,1,SQL_C_SLONG, (SQLPOINTER)&V_OD_buffer,150,
+ (SQLLEN *)&V_OD_err);
+ // 14. 通过SQLFetch取结果集中数据
+ V_OD_erg=SQLFetch(V_OD_hstmt);
+ // 15. 通过SQLGetData获取并返回数据。
+ while(V_OD_erg != SQL_NO_DATA)
+ {
+ SQLGetData(V_OD_hstmt,1,SQL_C_SLONG,(SQLPOINTER)&V_OD_id,0,NULL);
+ printf("SQLGetData ----ID = %d\n",V_OD_id);
+ V_OD_erg=SQLFetch(V_OD_hstmt);
+ };
+ printf("Done !\n");
+ // 16. 断开数据源连接并释放句柄资源
+ SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
+ SQLDisconnect(V_OD_hdbc);
+ SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
+ SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
+ return(0);
+ }
+```
+
+## 常用功能示例代码2
+#include
+#include
+
+static void exit_nicely(PGconn *conn)
+{
+ PQfinish(conn);
+ exit(1);
+}
+
+int main(int argc, char **argv)
+{
+ const char *conninfo;
+ PGconn *conn;
+ PGresult *res;
+ int nFields;
+ int i,j;
+
+ /*
+ * 如果用户在命令行上提供了一个参数，将它用作连接信息串。
+ * 否则默认用设置 dbname=postgres 并且为所有其他链接参数使用环境变量或默认值。
+ */
+ if (argc > 1)
+ conninfo = argv[1];
+ else
+ conninfo = "dbname = postgres";
+
+ /* 建立到数据库的一个连接 */
+ conn = PQconnectdb(conninfo);
+
+ /* 检查看后端连接是否成功建立 */
+ if (PQstatus(conn) != CONNECTION_OK)
+ {
+ fprintf(stderr, "Connection to database failed: %s",
+ PQerrorMessage(conn));
+ exit_nicely(conn);
+ }
+
+ /*
+ * 我们的测试案例这里涉及使用一个游标，对它我们必须用在一个事务块内。
+ * 我们可以在一个单一的 "select * from pg_database" 的 PQexec() 中做整个事情，
+ * 但是作为一个好的例子它太琐碎。
+ */
+
+ /* 开始一个事务块 */
+ res = PQexec(conn, "BEGIN");
+ if (PQresultStatus(res) != PGRES_COMMAND_OK)
+ {
+ fprintf(stderr, "BEGIN command failed: %s", PQerrorMessage(conn));
+ PQclear(res);
+ exit_nicely(conn);
+ }
+
+ /* 任何时候不再需要 PGresult 时，应该 PQclear 它来避免内存泄露 */
+ PQclear(res);
+
+ /* 从 pg_database 取得行，它是数据库的系统目录 */
+ res = PQexec(conn, "DECLARE myportal CURSOR FOR select * from pg_database");
+ if (PQresultStatus(res) != PGRES_COMMAND_OK)
+ {
+ fprintf(stderr, "DECLARE CURSOR failed: %s", PQerrorMessage(conn));
+ PQclear(res);
+ exit_nicely(conn);
+ }
+ PQclear(res);
+
+ res = PQexec(conn, "FETCH ALL in myportal");
+ if (PQresultStatus(res) != PGRES_TUPLES_OK)
+ {
+ fprintf(stderr, "FETCH ALL failed: %s", PQerrorMessage(conn));
+ PQclear(res);
+ exit_nicely(conn);
+ }
+
+ /* 首先，打印出属性名 */
+ nFields = PQnfields(res);
+ for (i = 0; i < nFields; i++)
+ printf("%-15s", PQfname(res, i));
+ printf("\n\n");
+
+ /* 接下来，打印出行 */
+ for (i = 0; i < PQntuples(res); i++)
+ {
+ for (j = 0; j < nFields; j++)
+ printf("%-15s", PQgetvalue(res, i, j));
+ printf("\n");
+ }
+
+ PQclear(res);
+
+ /* 关闭入口，我们不需要考虑检查错误 */
+ res = PQexec(conn, "CLOSE myportal");
+ PQclear(res);
+
+ /* 结束事务 */
+ res = PQexec(conn, "END");
+ PQclear(res);
+
+ /* 关闭到数据库的连接并且清理 */
+ PQfinish(conn);
+
+ return 0;
+}
+```
+
+## 批量绑定示例代码
+#include
+#include
+#include
+#include
+
+#include "util.c"
+
+void Exec(SQLHDBC hdbc, SQLCHAR* sql)
+{
+ SQLRETURN retcode; // Return status
+ SQLHSTMT hstmt = SQL_NULL_HSTMT; // Statement handle
+ SQLCHAR loginfo[2048];
+
+ // Allocate Statement Handle
+ retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_STMT)",
+ hstmt, SQL_HANDLE_STMT);
+
+ // Prepare Statement
+ retcode = SQLPrepare(hstmt, (SQLCHAR*) sql, SQL_NTS);
+ sprintf((char*)loginfo, "SQLPrepare log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+
+ // Execute Statement
+ retcode = SQLExecute(hstmt);
+ sprintf((char*)loginfo, "SQLExecute stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+
+ // Free Handle
+retcode = SQLFreeHandle(SQL_HANDLE_STMT, hstmt);
+ sprintf((char*)loginfo, "SQLFreeHandle stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmt, SQL_HANDLE_STMT);
+}
+
+int main ()
+{
+ SQLHENV henv = SQL_NULL_HENV;
+ SQLHDBC hdbc = SQL_NULL_HDBC;
+ int batchCount = 1000;
+ SQLLEN rowsCount = 0;
+ int ignoreCount = 0;
+
+ SQLRETURN retcode;
+ SQLCHAR dsn[1024] = {'\0'};
+ SQLCHAR loginfo[2048];
+
+ // 交互获取数据源名称
+ getStr("Please input your DSN", (char*)dsn, sizeof(dsn), 'N');
+ // 交互获取批量绑定的数据量
+ getInt("batchCount", &batchCount, 'N', 1);
+ do
+ {
+ // 交互获取批量绑定的数据中，不要入库的数据量
+ getInt("ignoreCount", &ignoreCount, 'N', 1);
+ if (ignoreCount > batchCount)
+ {
+ printf("ignoreCount(%d) should be less than batchCount(%d)\n", ignoreCount, batchCount);
+ }
+ }while(ignoreCount > batchCount);
+
+ retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_ENV)",
+ henv, SQL_HANDLE_ENV);
+
+ // Set ODBC Verion
+ retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION,
+ (SQLPOINTER*)SQL_OV_ODBC3, 0);
+ CHECK_ERROR(retcode, "SQLSetEnvAttr(SQL_ATTR_ODBC_VERSION)",
+ henv, SQL_HANDLE_ENV);
+
+ // Allocate Connection
+ retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_DBC)",
+ henv, SQL_HANDLE_DBC);
+
+ // Set Login Timeout
+ retcode = SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);
+ CHECK_ERROR(retcode, "SQLSetConnectAttr(SQL_LOGIN_TIMEOUT)",
+ hdbc, SQL_HANDLE_DBC);
+
+ // Set Auto Commit
+ retcode = SQLSetConnectAttr(hdbc, SQL_ATTR_AUTOCOMMIT,
+ (SQLPOINTER)(1), 0);
+ CHECK_ERROR(retcode, "SQLSetConnectAttr(SQL_ATTR_AUTOCOMMIT)",
+ hdbc, SQL_HANDLE_DBC);
+
+ // Connect to DSN
+ sprintf(loginfo, "SQLConnect(DSN:%s)", dsn);
+ retcode = SQLConnect(hdbc, (SQLCHAR*) dsn, SQL_NTS,
+ (SQLCHAR*) NULL, 0, NULL, 0);
+ CHECK_ERROR(retcode, loginfo, hdbc, SQL_HANDLE_DBC);
+
+ // init table info.
+ Exec(hdbc, "drop table if exists test_odbc_batch_insert");
+ Exec(hdbc, "create table test_odbc_batch_insert(id int primary key, col varchar2(50))");
+
+ // 下面的代码根据用户输入的数据量，构造出将要入库的数据:
+ {
+ SQLRETURN retcode;
+ SQLHSTMT hstmtinesrt = SQL_NULL_HSTMT;
+ int i;
+ SQLCHAR *sql = NULL;
+ SQLINTEGER *ids = NULL;
+ SQLCHAR *cols = NULL;
+ SQLLEN *bufLenIds = NULL;
+ SQLLEN *bufLenCols = NULL;
+ SQLUSMALLINT *operptr = NULL;
+ SQLUSMALLINT *statusptr = NULL;
+ SQLULEN process = 0;
+
+ // 这里是按列构造，每个字段的内存连续存放在一起。
+ ids = (SQLINTEGER*)malloc(sizeof(ids[0]) * batchCount);
+ cols = (SQLCHAR*)malloc(sizeof(cols[0]) * batchCount * 50);
+ // 这里是每个字段中，每一行数据的内存长度。
+ bufLenIds = (SQLLEN*)malloc(sizeof(bufLenIds[0]) * batchCount);
+ bufLenCols = (SQLLEN*)malloc(sizeof(bufLenCols[0]) * batchCount);
+ // 该行是否需要被处理，SQL_PARAM_IGNORE 或 SQL_PARAM_PROCEED
+ operptr = (SQLUSMALLINT*)malloc(sizeof(operptr[0]) * batchCount);
+ memset(operptr, 0, sizeof(operptr[0]) * batchCount);
+ // 该行的处理结果。
+ // 注：由于数据库中处理方式是同一语句隶属同一事务中，所以如果出错，那么待处理数据都将是出错的，并不会部分入库。
+ statusptr = (SQLUSMALLINT*)malloc(sizeof(statusptr[0]) * batchCount);
+ memset(statusptr, 88, sizeof(statusptr[0]) * batchCount);
+
+ if (NULL == ids || NULL == cols || NULL == bufLenCols || NULL == bufLenIds)
+ {
+ fprintf(stderr, "FAILED:\tmalloc data memory failed\n");
+ goto exit;
+ }
+
+ for (int i = 0; i < batchCount; i++)
+ {
+ ids[i] = i;
+ sprintf(cols + 50 * i, "column test value %d", i);
+ bufLenIds[i] = sizeof(ids[i]);
+ bufLenCols[i] = strlen(cols + 50 * i);
+ operptr[i] = (i < ignoreCount) ? SQL_PARAM_IGNORE : SQL_PARAM_PROCEED;
+ }
+
+ // Allocate Statement Handle
+ retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmtinesrt);
+ CHECK_ERROR(retcode, "SQLAllocHandle(SQL_HANDLE_STMT)",
+ hstmtinesrt, SQL_HANDLE_STMT);
+
+ // Prepare Statement
+ sql = (SQLCHAR*)"insert into test_odbc_batch_insert values(?, ?)";
+ retcode = SQLPrepare(hstmtinesrt, (SQLCHAR*) sql, SQL_NTS);
+ sprintf((char*)loginfo, "SQLPrepare log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)batchCount, sizeof(batchCount));
+ CHECK_ERROR(retcode, "SQLSetStmtAttr", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLBindParameter(hstmtinesrt, 1, SQL_PARAM_INPUT, SQL_C_SLONG, SQL_INTEGER, sizeof(ids[0]), 0,&(ids[0]), 0, bufLenIds);
+ CHECK_ERROR(retcode, "SQLBindParameter for id", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLBindParameter(hstmtinesrt, 2, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 50, 50, cols, 50, bufLenCols);
+ CHECK_ERROR(retcode, "SQLBindParameter for cols", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAMS_PROCESSED_PTR, (SQLPOINTER)&process, sizeof(process));
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAMS_PROCESSED_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAM_STATUS_PTR, (SQLPOINTER)statusptr, sizeof(statusptr[0]) * batchCount);
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAM_STATUS_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLSetStmtAttr(hstmtinesrt, SQL_ATTR_PARAM_OPERATION_PTR, (SQLPOINTER)operptr, sizeof(operptr[0]) * batchCount);
+ CHECK_ERROR(retcode, "SQLSetStmtAttr for SQL_ATTR_PARAM_OPERATION_PTR", hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLExecute(hstmtinesrt);
+ sprintf((char*)loginfo, "SQLExecute stmt log: %s", (char*)sql);
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+
+ retcode = SQLRowCount(hstmtinesrt, &rowsCount);
+ CHECK_ERROR(retcode, "SQLRowCount execution", hstmtinesrt, SQL_HANDLE_STMT);
+
+ if (rowsCount != (batchCount - ignoreCount))
+ {
+ sprintf(loginfo, "(batchCount - ignoreCount)(%d) != rowsCount(%d)", (batchCount - ignoreCount), rowsCount);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ else
+ {
+ sprintf(loginfo, "(batchCount - ignoreCount)(%d) == rowsCount(%d)", (batchCount - ignoreCount), rowsCount);
+ CHECK_ERROR(SQL_SUCCESS, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+
+ if (rowsCount != process)
+ {
+ sprintf(loginfo, "process(%d) != rowsCount(%d)", process, rowsCount);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ else
+ {
+ sprintf(loginfo, "process(%d) == rowsCount(%d)", process, rowsCount);
+ CHECK_ERROR(SQL_SUCCESS, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+
+ for (int i = 0; i < batchCount; i++)
+ {
+ if (i < ignoreCount)
+ {
+ if (statusptr[i] != SQL_PARAM_UNUSED)
+ {
+ sprintf(loginfo, "statusptr[%d](%d) != SQL_PARAM_UNUSED", i, statusptr[i]);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ }
+ else if (statusptr[i] != SQL_PARAM_SUCCESS)
+ {
+ sprintf(loginfo, "statusptr[%d](%d) != SQL_PARAM_SUCCESS", i, statusptr[i]);
+ CHECK_ERROR(SQL_ERROR, loginfo, NULL, SQL_HANDLE_STMT);
+ }
+ }
+
+ retcode = SQLFreeHandle(SQL_HANDLE_STMT, hstmtinesrt);
+ sprintf((char*)loginfo, "SQLFreeHandle hstmtinesrt");
+ CHECK_ERROR(retcode, loginfo, hstmtinesrt, SQL_HANDLE_STMT);
+ }
+
+
+exit:
+ printf ("\nComplete.\n");
+
+ // Connection
+ if (hdbc != SQL_NULL_HDBC) {
+ SQLDisconnect(hdbc);
+ SQLFreeHandle(SQL_HANDLE_DBC, hdbc);
+ }
+
+ // Environment
+ if (henv != SQL_NULL_HENV)
+ SQLFreeHandle(SQL_HANDLE_ENV, henv);
+
+ return 0;
+}
+```
+
diff --git "a/content/zh/docs/Developerguide/\347\244\272\344\276\213-\344\273\216MY\345\220\221openGauss\350\277\233\350\241\214\346\225\260\346\215\256\350\277\201\347\247\273.md" "b/content/zh/docs/Developerguide/\347\244\272\344\276\213-\344\273\216MY\345\220\221openGauss\350\277\233\350\241\214\346\225\260\346\215\256\350\277\201\347\247\273.md"
new file mode 100644
index 0000000000000000000000000000000000000000..9e986cc2a4a7e0dbbea82699a03c3ab7436f613a
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\347\244\272\344\276\213-\344\273\216MY\345\220\221openGauss\350\277\233\350\241\214\346\225\260\346\215\256\350\277\201\347\247\273.md"
@@ -0,0 +1,91 @@
+# 示例：从MY向openGauss进行数据迁移
+
+
+
+
@@ -925,7 +925,7 @@
-- DBMS\_PERF.get\_global\_instance\_time\(\)
+- DBE\_PERF.get\_global\_instance\_time\(\)
描述：提供openGauss各个关键阶段的时间消耗，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。
@@ -933,7 +933,7 @@
- get\_instr\_unique\_sql\(\)
- 描述：获取当前结点的执行语句（归一化SQL）信息，查询该函数必须具有sysadmin权限。
+ 描述：获取当前节点的执行语句（归一化SQL）信息，查询该函数必须具有sysadmin权限。
返回值类型：record
@@ -951,65 +951,53 @@
- get\_instr\_user\_login\(\)
- 描述：获取当前结点的用户登入登出次数信息，查询该函数必须具有sysadmin权限。
+ 描述：获取当前节点的用户登入登出次数信息，查询该函数必须具有sysadmin权限。
返回值类型：record
- get\_instr\_rt\_percentile\(\)
- 描述：获取CCN结点SQL 响应时间P80，P95分布信息，openGauss统一的信息在CCN节点上，其他节点查询为0。
+ 描述：获取CCN节点SQL 响应时间P80，P95分布信息，openGauss统一的信息在CCN节点上，其他节点查询为0。
返回值类型：record
- get\_node\_stat\_reset\_time\(\)
- 描述：获取当前结点的统计信息重置（重启，主备倒换，数据库删除）时间。
+ 描述：获取当前节点的统计信息重置（重启，主备倒换，数据库删除）时间。
返回值类型：record
-- dbms\_perf.get\_average\_value\(\)
-
- 描述：获取当前结点的统计信息重置（重启，主备倒换，数据库删除）时间。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_os\_runtime\(\)
+- DBE\_PERF.get\_global\_os\_runtime\(\)
描述：显示当前操作系统运行的状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_os\_threads\(\)
-
- 描述：提供openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_os\_threads\(\)
+- DBE\_PERF.get\_global\_os\_threads\(\)
描述：提供openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_workload\_sql\_count\(\)
+- DBE\_PERF.get\_summary\_workload\_sql\_count\(\)
描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，DDL， DML，DCL计数信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_workload\_sql\_elapse\_time\(\)
+- DBE\_PERF.get\_summary\_workload\_sql\_elapse\_time\(\)
描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_workload\_transaction\(\)
+- DBE\_PERF.get\_global\_workload\_transaction\(\)
描述：获取openGauss内所有节点上的事务量信息，事务时间信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_session\_stat\(\)
+- DBE\_PERF.get\_global\_session\_stat\(\)
描述：获取openGauss节点上的会话状态信息，查询该函数必须具有sysadmin权限。
@@ -1021,19 +1009,19 @@
>blocks\_read\_time,blocks\_write\_time,sort\_imemory,sort\_idisk,cu\_mem\_hit,
>cu\_hdd\_sync\_read,cu\_hdd\_asyread
-- DBMS\_PERF.get\_global\_session\_time\(\)
+- DBE\_PERF.get\_global\_session\_time\(\)
描述：提供openGauss各节点各个关键阶段的时间消耗，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_session\_memory\(\)
+- DBE\_PERF.get\_global\_session\_memory\(\)
描述：汇聚各节点的Session级别的内存使用情况，包含执行作业在数据节点上Postgres线程和Stream线程分配的所有内存，单位为MB，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_session\_memory\_detail\(\)
+- DBE\_PERF.get\_global\_session\_memory\_detail\(\)
描述：汇聚各节点的线程的内存使用情况，以MemoryContext节点来统计，查询该函数必须具有sysadmin权限。
@@ -1045,487 +1033,403 @@
返回值类型：record
-- DBMS\_PERF.get\_global\_session\_stat\_activity\(\)
+- DBE\_PERF.get\_global\_session\_stat\_activity\(\)
描述：汇聚openGauss内各节点上正在运行的线程相关的信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_thread\_wait\_status\(\)
+- DBE\_PERF.get\_global\_thread\_wait\_status\(\)
- 描述：汇聚所有结点上工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况，查询该函数必须具有sysadmin权限。
+ 描述：汇聚所有节点上工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_wlm\_controlgroup\_ng\_config\(\)
-
- 描述：数据库内所有的控制组信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_wlm\_user\_resource\_runtime\(\)
+- DBE\_PERF.get\_wlm\_user\_resource\_runtime\(\)
描述：显示所有用户资源使用情况，参数use\_workload\_manager为on时才有效，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_wlm\_workload\_runtime\(\)
-
- 描述：汇聚当前用户在数据库主节点上执行作业时在数据库主节点上的状态信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_operator\_ec\_history\(\)
-
- 描述：汇聚当前用户在数据库主节点上EC算子的历史状态信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_operator\_ec\_history\_table\(\)
-
- 描述：汇聚当前用户在数据库主节点上EC算子的历史状态信息（持久化），查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_operator\_ec\_runtime\(\)
-
- 描述：汇聚当前用户在数据库主节点上EC算子的实时状态信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_operator\_history\_table\(\)
+- DBE\_PERF.get\_global\_operator\_history\_table\(\)
描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录（持久化），查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_operator\_history\(\)
+- DBE\_PERF.get\_global\_operator\_history\(\)
描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_operator\_runtime\(\)
+- DBE\_PERF.get\_global\_operator\_runtime\(\)
描述：汇聚当前用户数据库主节点上执行作业实时的算子相关记录，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statement\_complex\_history\(\)
+- DBE\_PERF.get\_global\_statement\_complex\_history\(\)
描述：汇聚当前用户数据库主节点上复杂查询的历史记录，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statement\_complex\_history\_table\(\)
+- DBE\_PERF.get\_global\_statement\_complex\_history\_table\(\)
描述：汇聚当前用户数据库主节点上复杂查询的历史记录（持久化），查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statement\_complex\_runtime\(\)
+- DBE\_PERF.get\_global\_statement\_complex\_runtime\(\)
描述：汇聚当前用户数据库主节点上复杂查询的实时信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_memory\_node\_detail\(\)
+- DBE\_PERF.get\_global\_memory\_node\_detail\(\)
描述：汇聚所有节点某个数据库节点内存使用情况，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_shared\_memory\_detail\(\)
+- DBE\_PERF.get\_global\_shared\_memory\_detail\(\)
描述：汇聚所有节点已产生的共享内存上下文的使用信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_comm\_delay\(\)
-
- 描述：汇聚数据库节点的通信库时延状态，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_comm\_recv\_stream\(\)
-
- 描述：汇聚数据库节点的通信库接收流状态，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_comm\_send\_stream\(\)
-
- 描述：汇聚数据库节点的通信库发送流状态，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_comm\_status\(\)
-
- 描述：汇聚数据库节点的通信库状态，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_statio\_all\_indexes
+- DBE\_PERF.get\_global\_statio\_all\_indexes
描述：汇聚所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_local\_toastname\_and\_toastindexname\(\)
+- DBE\_PERF.get\_local\_toastname\_and\_toastindexname\(\)
描述：提供本地toast表的name和index和其关联表的对应关系。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_all\_indexes
+- DBE\_PERF.get\_summary\_statio\_all\_indexes\(\)
描述：统计所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_all\_sequences
+- DBE\_PERF.get\_global\_statio\_all\_sequences\(\)
描述：提供命名空间中所有sequences的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_all\_tables
+- DBE\_PERF.get\_global\_statio\_all\_tables\(\)
描述：汇聚各节点的数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_all\_tables
+- DBE\_PERF.get\_summary\_statio\_all\_tables\(\)
描述：统计openGauss内数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_local\_toast\_relation\(\)
+- DBE\_PERF.get\_local\_toast\_relation\(\)
- 描述：提供本地toast表的name和其关联表的对应关系。
+ 描述：提供本地toast表的name和其关联表的对应关系，查询该函数必须具有sysadmin权限
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_sys\_indexes\(\)
+- DBE\_PERF.get\_global\_statio\_sys\_indexes\(\)
描述：汇聚各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_sys\_indexes\(\)
+- DBE\_PERF.get\_summary\_statio\_sys\_indexes\(\)
描述：统计各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_sys\_sequences\(\)
+- DBE\_PERF.get\_global\_statio\_sys\_sequences\(\)
描述：提供命名空间中所有系统表为sequences的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_sys\_tables\(\)
+- DBE\_PERF.get\_global\_statio\_sys\_tables\(\)
描述：提供各节点的命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_sys\_tables\(\)
+- DBE\_PERF.get\_summary\_statio\_sys\_tables\(\)
描述：openGauss内汇聚命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_user\_indexes\(\)
+- DBE\_PERF.get\_global\_statio\_user\_indexes\(\)
描述：各节点的命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_user\_indexes\(\)
+- DBE\_PERF.get\_summary\_statio\_user\_indexes\(\)
描述：openGauss内汇聚命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_user\_sequences\(\)
+- DBE\_PERF.get\_global\_statio\_user\_sequences\(\)
描述：显示各节点的命名空间中所有用户的sequences的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statio\_user\_tables\(\)
+- DBE\_PERF.get\_global\_statio\_user\_tables\(\)
描述：显示各节点的命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statio\_user\_tables\(\)
+- DBE\_PERF.get\_summary\_statio\_user\_tables\(\)
描述：openGauss内汇聚命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_stat\_db\_cu\(\)
+- DBE\_PERF.get\_stat\_db\_cu\(\)
描述：视图查询openGauss各个节点，每个数据库的CU命中情况，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_dn\_stat\_all\_tables\(\)
-
- 描述：汇聚数据库节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_cn\_stat\_all\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_all\_indexes\(\)
- 描述：汇聚数据库主节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。
+ 描述：汇聚所有节点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_dn\_stat\_all\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_all\_indexes\(\)
- 描述：统计数据库节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。
+ 描述：统计所有节点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_cn\_stat\_all\_tables\(\)
-
- 描述：统计数据库主节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_stat\_all\_indexes\(\)
-
- 描述：汇聚所有结点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_summary\_stat\_all\_indexes\(\)
-
- 描述：统计所有结点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_stat\_sys\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_sys\_tables\(\)
描述：汇聚各节点pg\_catalog、information\_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_sys\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_sys\_tables\(\)
描述：统计各节点pg\_catalog、information\_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_sys\_indexes\(\)
+- DBE\_PERF.get\_global\_stat\_sys\_indexes\(\)
描述：汇聚各节点pg\_catalog、information\_schema模式中所有系统表的索引状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_sys\_indexes\(\)
+- DBE\_PERF.get\_summary\_stat\_sys\_indexes\(\)
描述：统计各节点pg\_catalog、information\_schema模式中所有系统表的索引状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_user\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_user\_tables\(\)
描述：汇聚所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_user\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_user\_tables\(\)
描述：统计所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_user\_indexes\(\)
+- DBE\_PERF.get\_global\_stat\_user\_indexes\(\)
描述：汇聚所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_user\_indexes\(\)
+- DBE\_PERF.get\_summary\_stat\_user\_indexes\(\)
描述：统计所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_database\(\)
+- DBE\_PERF.get\_global\_stat\_database\(\)
描述：汇聚所有节点数据库统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_database\_conflicts\(\)
+- DBE\_PERF.get\_global\_stat\_database\_conflicts\(\)
描述：统计所有节点数据库统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_xact\_all\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_xact\_all\_tables\(\)
描述：汇聚命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_xact\_all\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_xact\_all\_tables\(\)
描述：统计命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_xact\_sys\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_xact\_sys\_tables\(\)
描述：汇聚所有节点命名空间中系统表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_xact\_sys\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_xact\_sys\_tables\(\)
描述：统计所有节点命名空间中系统表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_xact\_user\_tables\(\)
+- DBE\_PERF.get\_global\_stat\_xact\_user\_tables\(\)
描述：汇聚所有节点命名空间中用户表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_stat\_xact\_user\_tables\(\)
+- DBE\_PERF.get\_summary\_stat\_xact\_user\_tables\(\)
描述：统计所有节点命名空间中用户表的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_user\_functions\(\)
+- DBE\_PERF.get\_global\_stat\_user\_functions\(\)
描述：汇聚所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_xact\_user\_functions\(\)
+- DBE\_PERF.get\_global\_stat\_xact\_user\_functions\(\)
描述：统计所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_stat\_bad\_block\(\)
+- DBE\_PERF.get\_global\_stat\_bad\_block\(\)
描述：汇聚所有节点表、索引等文件的读取失败信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_file\_redo\_iostat\(\)
+- DBE\_PERF.get\_global\_file\_redo\_iostat\(\)
描述：统计所有节点表、索引等文件的读取失败信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_file\_iostat\(\)
+- DBE\_PERF.get\_global\_file\_iostat\(\)
描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_locks\(\)
+- DBE\_PERF.get\_global\_locks\(\)
描述：汇聚所有节点的锁信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_replication\_slots\(\)
+- DBE\_PERF.get\_global\_replication\_slots\(\)
描述：汇聚所有节点上逻辑复制信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_bgwriter\_stat\(\)
+- DBE\_PERF.get\_global\_bgwriter\_stat\(\)
描述：汇聚所有节点后端写进程活动的统计信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_replication\_stat\(\)
+- DBE\_PERF.get\_global\_replication\_stat\(\)
描述：汇聚各节点日志同步状态信息，如发起端发送日志位置，收端接收日志位置等，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_pooler\_status\(\)
-
- 描述：汇聚数据库主节点的pooler中的缓存连接状态，查询该函数必须具有sysadmin权限。
-
- 返回值类型：record
-
-- DBMS\_PERF.get\_global\_transactions\_running\_xacts\(\)
+- DBE\_PERF.get\_global\_transactions\_running\_xacts\(\)
描述：汇聚各节点运行事务的信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_transactions\_running\_xacts\(\)
+- DBE\_PERF.get\_summary\_transactions\_running\_xacts\(\)
描述：统计各节点运行事务的信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_transactions\_prepared\_xacts\(\)
+- DBE\_PERF.get\_global\_transactions\_prepared\_xacts\(\)
描述：汇聚各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_transactions\_prepared\_xacts\(\)
+- DBE\_PERF.get\_summary\_transactions\_prepared\_xacts\(\)
描述：统计各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_statement\(\)
+- DBE\_PERF.get\_summary\_statement\(\)
描述：汇聚各节点历史执行语句状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_statement\_count\(\)
+- DBE\_PERF.get\_global\_statement\_count\(\)
描述：汇聚各节点SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_config\_settings\(\)
+- DBE\_PERF.get\_global\_config\_settings\(\)
描述：汇聚各节点GUC参数配置信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_wait\_events\(\)
+- DBE\_PERF.get\_global\_wait\_events\(\)
描述：汇聚各节点wait events状态信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_statement\_responsetime\_percentile\(\)
+- DBE\_PERF.get\_statement\_responsetime\_percentile\(\)
描述：获取openGaussSQL响应时间P80，P95分布信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_summary\_user\_login\(\)
+- DBE\_PERF.get\_summary\_user\_login\(\)
描述：统计openGauss各节点用户登入登出次数信息，查询该函数必须具有sysadmin权限。
返回值类型：record
-- DBMS\_PERF.get\_global\_record\_reset\_time\(\)
+- DBE\_PERF.get\_global\_record\_reset\_time\(\)
描述：汇聚openGauss统计信息重置（重启，主备倒换，数据库删除）时间，查询该函数必须具有sysadmin权限。
@@ -1543,70 +1447,12 @@
返回值类型：record
-- DBMS\_PERF.get\_global\_rel\_iostat\(\)
+- DBE\_PERF.get\_global\_rel\_iostat\(\)
描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有sysadmin权限。
返回值类型：record
-- 函数返回字段描述如下：
-
-**表 1** PGXC\_GTM\_SNAPSHOT\_STATUS返回参数说明
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
示例：
@@ -1630,5 +1476,3 @@ postgres=# SELECT pg_stat_get_backend_pid(1);
(1 row)
```
-> **须知：**
-
diff --git "a/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\350\260\203\344\274\230.md" "b/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\350\260\203\344\274\230.md"
new file mode 100644
index 0000000000000000000000000000000000000000..dbecdd2e0df1981a5bbcb4701ce86e0295041e53
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\350\260\203\344\274\230.md"
@@ -0,0 +1,93 @@
+# 统计信息调优18
- 如果设置为-1，表示wal\_buffers的大小随着参数shared\_buffers自动调整，为shared\_buffers的1/32，最小值为8个XLOG\_BLCKSZ，最大值为2048个XLOG\_BLCKSZ。
-- 如果设置为其他值，当小于8时，会被默认设置为8；当大于2048的时，会被强制设置为2048。
+- 如果设置为其他值，当小于4时，会被默认设置为4。
**默认值：**16MB
@@ -185,5 +186,5 @@
**取值范围**：整型，单位为8KB。
-**默认值：**16MB \(2048 \* 8KB\)
+**默认值：**16MB \(2048 \* 8KB\)
diff --git "a/content/zh/docs/Developerguide/\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/Developerguide/\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 edce2c41e0dd35a15f848425b6a43791b1d02829..44a1758d4be1a6160b1186b2f5eb4b158d77cc58 100644
--- "a/content/zh/docs/Developerguide/\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/Developerguide/\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"
@@ -20,7 +20,7 @@
连接成功后，系统显示类似如下信息：
```
- gsql ((openGauss 1.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
+ gsql ((openGauss 1.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
@@ -42,7 +42,7 @@
4. 执行如下命令将其设置为安全的加密算法。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_encryption_type=2"
+ gs_guc reload -N all -I all -c "password_encryption_type=2"
```
> **须知：**
@@ -92,7 +92,7 @@
3. 执行如下命令设置成默认值1。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_policy=1"
+ gs_guc reload -N all -I all -c "password_policy=1"
```
帐户密码的复杂度要求如下：
@@ -152,7 +152,7 @@
>不建议设置为0，即使需要设置也要将所有openGauss节点中的password\_reuse\_time都设置为0才能生效。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_reuse_time=60"
+ gs_guc reload -N all -I all -c "password_reuse_time=60"
```
配置password\_reuse\_max参数。
@@ -190,7 +190,7 @@
3. 执行如下命令设置成默认值0。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_reuse_max = 0"
+ gs_guc reload -N all -I all -c "password_reuse_max = 0"
```
- 密码有效期限
@@ -235,7 +235,7 @@
3. 执行如下命令设置成默认值90（不建议设置为0）。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_effect_time = 90"
+ gs_guc reload -N all -I all -c "password_effect_time = 90"
```
配置password\_notify\_time参数。
@@ -271,7 +271,7 @@
3. 如果显示结果不为7，执行如下命令设置成默认值7（不建议设置为0）。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_notify_time = 7"
+ gs_guc reload -N all -I all -c "password_notify_time = 7"
```
- 密码修改
diff --git "a/content/zh/docs/Developerguide/\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/Developerguide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md"
index c514fa9477f657215eee34a7ac11d128dc1eafa7..80e8451e8bc2801a0186372631ed3223b2cea193 100644
--- "a/content/zh/docs/Developerguide/\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/Developerguide/\350\256\276\347\275\256\345\270\220\345\217\267\346\234\211\346\225\210\346\234\237.md"
@@ -20,7 +20,7 @@
连接成功后，系统显示类似如下信息：
```
- gsql ((openGauss 1.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
+ gsql ((openGauss 1.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
diff --git "a/content/zh/docs/Developerguide/\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/Developerguide/\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 64d20584f22d33c338b86085fb7cf119b3810324..a8ae8cf34dd1137ba3a21601351adcc7beaee476 100644
--- "a/content/zh/docs/Developerguide/\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/Developerguide/\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"
@@ -51,7 +51,7 @@ openGauss为帐户提供了自动锁定和解锁帐户、手动锁定和解锁
4. 执行如下命令设置成默认值10。
```
- gs_guc reload -Z coordinator -D /gaussdb/data/dbnode -c "failed_login_attempts=10"
+ gs_guc reload -D /gaussdb/data/dbnode -c "failed_login_attempts=10"
```
@@ -91,7 +91,7 @@ openGauss为帐户提供了自动锁定和解锁帐户、手动锁定和解锁
4. 执行如下命令设置成默认值1。
```
- gs_guc reload -Z coordinator -Z datanode -N all -I all -c "password_lock_time=1"
+ gs_guc reload -N all -I all -c "password_lock_time=1"
```
diff --git "a/content/zh/docs/Developerguide/\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/Developerguide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md"
index 8702bd2b57226f6020051d314b4be5bb3ec931fd..85beaa6b217bdc947a4acc4ce241325ad8e6e0c7 100644
--- "a/content/zh/docs/Developerguide/\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/Developerguide/\350\256\276\347\275\256\346\225\260\346\215\256\345\272\223\345\256\241\350\256\241.md"
@@ -6,6 +6,6 @@
- **[维护审计日志](维护审计日志.md)**
-- **[设置文件权限安全策略](设置文件权限安全策略-9.md)**
+- **[设置文件权限安全策略](设置文件权限安全策略.md)**
diff --git "a/content/zh/docs/Developerguide/\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/Developerguide/\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 1f7742325339be12e2010768aa01661c5b8afc3a..97d72f9e35084671f0a14c9350107e5eebc10da8 100644
--- "a/content/zh/docs/Developerguide/\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/Developerguide/\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/Developerguide/\350\257\201\344\271\246\346\233\277\346\215\242.md" "b/content/zh/docs/Developerguide/\350\257\201\344\271\246\346\233\277\346\215\242.md"
index 3c90f8be8789af38d7d138a99ab2fe20b46fc637..fa0522f79830b82514d4791a9bb9f268f1cc0100 100644
--- "a/content/zh/docs/Developerguide/\350\257\201\344\271\246\346\233\277\346\215\242.md"
+++ "b/content/zh/docs/Developerguide/\350\257\201\344\271\246\346\233\277\346\215\242.md"
@@ -1,4 +1,4 @@
-# 证书替换
+
+
+
+
+
+DEBUG5 DEBUG4 DEBUG3 DEBUG2 DEBUG1 LOG NOTICE WARNING ERROR FATAL PANIC
+
+
+
+DEBUG5 DEBUG4 DEBUG3 DEBUG2 DEBUG1 INFO NOTICE WARNING ERROR LOG FATAL PANIC
+
+
+
+DEBUG5 DEBUG4 DEBUG3 DEBUG2 DEBUG1 INFO NOTICE WARNING ERROR FATAL PANIC
+
+
+
+
+
+
+
+
+
+
+
+on：每次会话连接或结束时向日志里打印一条信息。 off：每次会话连接或结束时不向日志里打印信息。
+
+
+
+on：记录每个已完成语句的持续时间。 off：不记录已完成语句的持续时间。
+
+
+
+none：不记录任何SQL语句。 ddl：记录数据定义语句。 mod：记录数据定义语句和数据操作语句。 all ：记录所有语句。
+
+
+
+
+
+查看审计结果 、GS_WLM_SESSION_HISTORY 、PG_STAT_ACTIVITY 和log_line_prefix 参数。
+
+
+上表有关参数级别的说明请参见[表2](#zh-cn_topic_0237120444_zh-cn_topic_0059779333_t3c729a4a94d145c7bdc4ca788236d8a7)。
+
+**表 2** 日志级别参数说明
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Developerguide/\350\264\237\350\275\275\347\256\241\347\220\206.md" "b/content/zh/docs/Developerguide/\350\264\237\350\275\275\347\256\241\347\220\206.md"
index 864cb5dc20513b89b790fe9fe2af69025f06edc5..218a295ffa7029e8e906ab844a5ad6aa90a23842 100644
--- "a/content/zh/docs/Developerguide/\350\264\237\350\275\275\347\256\241\347\220\206.md"
+++ "b/content/zh/docs/Developerguide/\350\264\237\350\275\275\347\256\241\347\220\206.md"
@@ -37,10 +37,7 @@
**取值范围**：字符串
-**默认值：**DefaultClass:Medium
-
-> **说明：**
->DefaultClass:Medium表示DefaultClass下Timeshare控制组中的Medium控制组。
+**默认值：**InvalidGroup
## cpu\_collect\_timer
+
+
+
+jdbc:postgresql:database jdbc:postgresql://host/database jdbc:postgresql://host:port/database jdbc:postgresql://host:port/database?param1=value1¶m2=value2 jdbc:postgresql://host1:port1,host2:port2/database?param1=value1¶m2=value2 说明： database为要连接的数据库名称。 host为数据库服务器名称或IP地址。
+
+
+
+ port为数据库服务器端口。
+ param为参数名称，即数据库连接属性。
+ value为参数值，即数据库连接属性值。
+
+
+PGDBNAME：String类型。表示数据库名称。（URL中无需配置该参数，自动从URL中解析） PGHOST：String类型。主机IP地址。详细示例见下。 PGPORT：Integer类型。主机端口号。详细示例见下。 user：String类型。表示创建连接的数据库用户。 password：String类型。表示数据库用户的密码。 loggerLevel：String类型。目前支持3种级别：OFF、DEBUG、TRACE。设置为OFF关闭日志，设置为DEBUG和TRACE记录的日志信息详细程度不同。 loggerFile：String类型。Logger输出的文件名。需要显示指定日志文件名，若未指定目录则生成在客户端运行程序目录。 allowEncodingChanges：Boolean类型。设置该参数值为“true”进行字符集类型更改，配合characterEncoding=CHARSET设置字符集，二者使用"&"分隔。 currentSchema：String类型。在search-path中指定要设置的schema。 hostRecheckSeconds：Integer类型。JDBC尝试连接主机后会保存主机状态：连接成功或连接失败。在hostRecheckSeconds时间内保持可信，超过则状态失效。缺省值是10秒。 ssl：Boolean类型。以SSL方式连接。
+
+
+ sslmode：String类型。SSL认证方式。取值范围为：require、verify-ca、verify-full。require只尝试SSL连接，如果存在CA文件，则应设置成verify-ca的方式验证。 verify-ca只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。 verify-full只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。 sslcert：String类型。提供证书文件的完整路径。客户端和服务端证书的类型为End Entity。 sslkey：String类型。提供密钥文件的完整路径。使用时将客户端证书转换为DER格式： sslrootcert：String类型。SSL根证书的文件名。根证书的类型为CA。 sslpassword：String类型。提供给ConsoleCallbackHandler使用。 sslpasswordcallback：String类型。SSL密码提供者的类名。缺省值：org.postgresql.ssl.jdbc4.LibPQFactory.ConsoleCallbackHandler。 sslfactory：String类型。提供的值是SSLSocketFactory在建立SSL连接时用的类名。 sslfactoryarg：String类型。此值是上面提供的sslfactory类的构造函数的可选参数（不推荐使用）。 sslhostnameverifier：String类型。主机名验证程序的类名。接口实现javax.net.ssl.HostnameVerifier，默认使用org.postgresql.ssl.PGjdbcHostnameVerifier。 loginTimeout：Integer类型。指建立数据库连接的等待时间。超时时间单位为秒。 connectTimeout：Integer类型。用于连接服务器操作的超时值。如果连接到服务器花费的时间超过此值，则连接断开。超时时间单位为秒，值为0时表示已禁用，timeout不发生。 socketTimeout：Integer类型。用于socket读取操作的超时值。如果从服务器读取所花费的时间超过此值，则连接关闭。超时时间单位为秒，值为0时表示已禁用，timeout不发生。 cancelSignalTimeout：Integer类型。发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒，默认值为10秒。 tcpKeepAlive：Boolean类型。启用或禁用TCP保活探测功能。默认为false。 logUnclosedConnections：Boolean类型。客户端可能由于未调用Connection对象的close()方法而泄漏Connection对象。最终这些对象将被垃圾回收，并且调用finalize()方法。如果调用者自己忽略了此操作，该方法将关闭Connection。 assumeMinServerVersion：String类型。客户端会发送请求进行float精度设置。该参数设置要连接的服务器版本，如assumeMinServerVersion=9.0，可以在建立时减少相关包的发送。 ApplicationName：String类型。设置正在使用连接的JDBC驱动的名称。通过在数据库主节点上查询pg_stat_activity表可以看到正在连接的客户端信息，JDBC驱动名称显示在application_name列。缺省值为PostgreSQL JDBC Driver。 connectionExtraInfo：Boolean类型。表示驱动是否上报当前驱动的部署路径、进程属主用户到数据库。
+ autosave：String类型。共有3种："always", "never", "conservative"。如果查询失败，指定驱动程序应该执行的操作。在autosave=always模式下，JDBC驱动程序在每次查询之前设置一个保存点，并在失败时回滚到该保存点。在autosave=never模式（默认）下，无保存点。在autosave=conservative模式下，每次查询都会设置保存点，但是只会在“statement XXX无效”等情况下回滚并重试。 protocolVersion：Integer类型。连接协议版本号，目前仅支持3。注意：设置该参数时将采用md5加密方式，需要同步修改数据库的加密方式：gs_guc set -N all -I all -c "password_encryption_type=1" ，重启 prepareThreshold：Integer类型。控制parse语句何时发送。默认值是5。第一次parse一个SQL比较慢，后面再parse就会比较快，因为有缓存了。如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令。 preparedStatementCacheQueries：Integer类型。确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement()调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。0表示禁用缓存。 preparedStatementCacheSizeMiB：Integer类型。确定每个连接可缓存的最大值（以兆字节为单位），默认情况下是5。若缓存了超过5MB的查询，则最近最少使用的查询缓存将被丢弃。0表示禁用缓存。 databaseMetadataCacheFields：Integer类型。默认值是65536。指定每个连接可缓存的最大值。“0”表示禁用缓存。 databaseMetadataCacheFieldsMiB：Integer类型。默认值是5。每个连接可缓存的最大值，单位是MB。“0”表示禁用缓存。 stringtype：String类型，可选字段为：false, "unspecified", "varchar"。设置通过setString()方法使用的PreparedStatement参数的类型，如果stringtype设置为VARCHAR（默认值），则这些参数将作为varchar参数发送给服务器。若stringtype设置为unspecified，则参数将作为untyped值发送到服务器，服务器将尝试推断适当的类型。 batchMode：Boolean类型。用于确定是否使用batch模式连接。 fetchsize：Integer类型。用于设置数据库连接所创建statement的默认fetchsize。 reWriteBatchedInserts：Boolean类型。批量导入时，该参数设置为on，可将N条插入语句合并为一条：insert into TABLE_NAME values(values1, ..., valuesN), ..., (values1, ..., valuesN);使用该参数时，需设置batchMode=off。 unknownLength：Integer类型，默认为Integer.MAX_VALUE。某些postgresql类型（例如TEXT）没有明确定义的长度，当通过ResultSetMetaData.getColumnDisplaySize和ResultSetMetaData.getPrecision等函数返回关于这些类型的数据时，此参数指定未知长度类型的长度。 defaultRowFetchSize：Integer类型。确定一次fetch在ResultSet中读取的行数。限制每次访问数据库时读取的行数可以避免不必要的内存消耗，从而避免OutOfMemoryException。缺省值是0，这意味着ResultSet中将一次获取所有行。没有负数。 binaryTransfer：Boolean类型。使用二进制格式发送和接收数据，默认值为“false”。 binaryTransferEnable：String类型。启用二进制传输的类型列表，以逗号分隔。OID编号和名称二选一，例如binaryTransferEnable=Integer4_ARRAY,Integer8_ARRAY。
+
+ binaryTransferDisEnable：String类型。禁用二进制传输的类型列表，以逗号分隔。OID编号和名称二选一。覆盖binaryTransferEnable的设置。 blobMode：String类型。用于设置setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。 socketFactory：String类型。用于创建与服务器socket连接的类的名称。该类必须实现了接口“javax.net.SocketFactory”，并定义无参或单String参数的构造函数。 socketFactoryArg：String类型。此值是上面提供的socketFactory类的构造函数的可选参数，不推荐使用。 receiveBufferSize：Integer类型。该值用于设置连接流上的SO_RCVBUF。 sendBufferSize：Integer类型。该值用于设置连接流上的SO_SNDBUF。 preferQueryMode：String类型。共有4种："extended", "extendedForPrepared", "extendedCacheEverything", "simple"。用于指定执行查询的模式，simple模式会excute，不parse和bind；extended模式会bind和excute；extendedForPrepared模式为prepared statement扩展使用；extendedCacheEverything模式会缓存每个statement。
+
+
+
+
+
+## 示例
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Developerguide/\351\200\211\346\213\251\346\225\260\346\215\256\347\261\273\345\236\213.md" "b/content/zh/docs/Developerguide/\351\200\211\346\213\251\346\225\260\346\215\256\347\261\273\345\236\213.md"
new file mode 100644
index 0000000000000000000000000000000000000000..2f4a77b99c6b14d352fca322150c91cfb268debc
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\351\200\211\346\213\251\346\225\260\346\215\256\347\261\273\345\236\213.md"
@@ -0,0 +1,17 @@
+# 选择数据类型
表2 ：
-
须知：
+
须知：
- 须知：
+
须知：
- 须知： 该认证方式依赖kerberos server等组件，仅支持 开启
+
须知： 该认证方式依赖kerberos server等组件，仅支持openGauss内部通信认证。当前版本暂不支持外部客户端通过kerberos认证连接。 开启openGauss内部kerberos认证会使增加内部节点建连时间，即影响首次涉及内部建连的SQL操作性能，内部连接建立好后， 后续操作不受影响。 使用如下命令修改参数。 说明：
-
+
重启数据库使参数生效。 说明：
@@ -106,7 +106,7 @@ openGauss提供了三种方式来修改GUC参数，具体操作请参考[表2](#
说明：
+
说明：
+
+
+
@@ -40,7 +45,7 @@
+
@@ -50,7 +55,7 @@
+
diff --git "a/content/zh/docs/Developerguide/\351\224\201\346\223\215\344\275\234.md" "b/content/zh/docs/Developerguide/\351\224\201\346\223\215\344\275\234.md"
new file mode 100644
index 0000000000000000000000000000000000000000..8e82b1560a9ac2e6089b3e3852ea936776c7d308
--- /dev/null
+++ "b/content/zh/docs/Developerguide/\351\224\201\346\223\215\344\275\234.md"
@@ -0,0 +1,4 @@
+# 锁操作>]
+[DECLARE
+ declarations]
+BEGIN
+ statements
+EXCEPTION
+ WHEN condition [OR condition ...] THEN
+ handler_statements
+ [WHEN condition [OR condition ...] THEN
+ handler_statements
+ ...]
+END;
+```
+
+如果没有发生错误，这种形式的块儿只是简单地执行所有语句，然后转到END之后的下一个语句。但是如果在执行的语句内部发生了一个错误，则这个语句将会回滚，然后转到EXCEPTION列表。寻找匹配错误的第一个条件。若找到匹配，则执行对应的handler\_statements，然后转到END之后的下一个语句。如果没有找到匹配，则会向事务的外层报告错误，和没有EXCEPTION子句一样。
+
+也就是说该错误可以被一个包围块用EXCEPTION捕获，如果没有包围块，则进行退出函数处理。
+
+condition的名称可以是SQL标准错误码编号说明的任意值。特殊的条件名OTHERS匹配除了QUERY\_CANCELED之外的所有错误类型。
+
+如果在选中的handler\_statements里发生了新错误，则不能被这个EXCEPTION子句捕获，而是向事务的外层报告错误。一个外层的EXCEPTION子句可以捕获它。
+
+如果一个错误被EXCEPTION捕获，PL/SQL函数的局部变量保持错误发生时的原值，但是所有该块中想写入数据库中的状态都回滚。
+
+示例：
+
+```
+CREATE TABLE mytab(id INT,firstname VARCHAR(20),lastname VARCHAR(20)) ;
+
+INSERT INTO mytab(firstname, lastname) VALUES('Tom', 'Jones');
+
+CREATE FUNCTION fun_exp() RETURNS INT
+AS $$
+DECLARE
+ x INT :=0;
+ y INT;
+BEGIN
+ UPDATE mytab SET firstname = 'Joe' WHERE lastname = 'Jones';
+ x := x + 1;
+ y := x / 0;
+EXCEPTION
+ WHEN division_by_zero THEN
+ RAISE NOTICE 'caught division_by_zero';
+ RETURN x;
+END;$$
+LANGUAGE plpgsql;
+
+call fun_exp();
+NOTICE: caught division_by_zero
+ fun_exp
+---------
+ 1
+(1 row)
+
+select * from mytab;
+ id | firstname | lastname
+----+-----------+----------
+ | Tom | Jones
+(1 row)
+
+DROP FUNCTION fun_exp();
+DROP TABLE mytab;
+```
+
+当控制到达给y赋值的地方时，会有一个division\_by\_zero错误失败。这个错误将被EXCEPTION子句捕获。而在RETURN语句里返回的数值将是x的增量值。
+
+> **说明：**
+>进入和退出一个包含EXCEPTION子句的块要比不包含的块开销大的多。因此，不必要的时候不要使用EXCEPTION。
+>在下列场景中，无法捕获处理异常，整个存储过程回滚：节点故障、网络故障引起的存储过程参与节点线程退出以及COPY FROM操作中源数据与目标表的表结构不一致造成的异常。
+
+示例 ：UPDATE/INSERT异常
+
+这个例子根据使用异常处理器执行恰当的UPDATE或INSERT 。
+
+```
+CREATE TABLE db (a INT, b TEXT);
+
+CREATE FUNCTION merge_db(key INT, data TEXT) RETURNS VOID AS
+$$
+BEGIN
+ LOOP
+
+--第一次尝试更新key
+ UPDATE db SET b = data WHERE a = key;
+ IF found THEN
+ RETURN;
+ END IF;
+--不存在，所以尝试插入key，如果其他人同时插入相同的key，我们可能得到唯一key失败。
+ BEGIN
+ INSERT INTO db(a,b) VALUES (key, data);
+ RETURN;
+ EXCEPTION WHEN unique_violation THEN
+ --什么也不做，并且循环尝试再次更新。
+ END;
+ END LOOP;
+END;
+$$
+LANGUAGE plpgsql;
+
+SELECT merge_db(1, 'david');
+SELECT merge_db(1, 'dennis');
+
+--删除FUNCTION和TABLE
+DROP FUNCTION merge_db;
+DROP TABLE db ;
+```
+
diff --git "a/content/zh/docs/Developerguide/\351\231\204\345\275\225.md" "b/content/zh/docs/Developerguide/\351\231\204\345\275\225.md"
index f6be15669defd940bea3c402f6b54249aed6be82..c4bc9532ae5881f8f500bad1c2b83bb27f34c5bc 100644
--- "a/content/zh/docs/Developerguide/\351\231\204\345\275\225.md"
+++ "b/content/zh/docs/Developerguide/\351\231\204\345\275\225.md"
@@ -1,7 +1,9 @@
-# 附录
+
+
+
+
+
+
+
+
+
+
+
+
+
+应用程序和用户交互的一种方式，完全基于文本输入和输出。命令通过键盘或类似装置输入，由程序编译并执行。结果是以文本或图形的方式呈现在终端界面。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-caution.gif b/content/zh/docs/Glossary/public_sys-resources/icon-caution.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-caution.gif differ
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-danger.gif b/content/zh/docs/Glossary/public_sys-resources/icon-danger.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-danger.gif differ
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-note.gif b/content/zh/docs/Glossary/public_sys-resources/icon-note.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6314297e45c1de184204098efd4814d6dc8b1cda
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-note.gif differ
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-notice.gif b/content/zh/docs/Glossary/public_sys-resources/icon-notice.gif
new file mode 100644
index 0000000000000000000000000000000000000000..86024f61b691400bea99e5b1f506d9d9aef36e27
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-notice.gif differ
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-tip.gif b/content/zh/docs/Glossary/public_sys-resources/icon-tip.gif
new file mode 100644
index 0000000000000000000000000000000000000000..93aa72053b510e456b149f36a0972703ea9999b7
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-tip.gif differ
diff --git a/content/zh/docs/Glossary/public_sys-resources/icon-warning.gif b/content/zh/docs/Glossary/public_sys-resources/icon-warning.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/content/zh/docs/Glossary/public_sys-resources/icon-warning.gif differ
diff --git "a/content/zh/docs/Quickstart/GUC\344\275\277\347\224\250\350\257\264\346\230\216.md" "b/content/zh/docs/Quickstart/GUC\344\275\277\347\224\250\350\257\264\346\230\216.md"
index 01d0c344e5a70778a51104a908fbbd270d50eedd..78fa4ecc25cb3ca8222a723fad7435e4f6b32951 100644
--- "a/content/zh/docs/Quickstart/GUC\344\275\277\347\224\250\350\257\264\346\230\216.md"
+++ "b/content/zh/docs/Quickstart/GUC\344\275\277\347\224\250\350\257\264\346\230\216.md"
@@ -1,4 +1,4 @@
-# GUC使用说明
+
+
+
-
-安装准备 。
+
+
+安装准备 。
+
获取并校验安装包 。
+获取并校验安装包 。
+
-创建XML配置文件 。
+
+创建XML配置文件 。
+
-初始化安装环境 。
+
+初始化安装环境 。
+
-执行安装 。
+
+执行安装 。
+
+
+
+
+
+
+
-初始化安装环境 时，由-G参数所指定的安装用户所属的用户组。该用户组如果不存在，则会自动创建，也可提前创建好用户组。在执行gs_preinstall脚本时会检查权限。gs_preinstall脚本会自动赋予此组中的用户对安装目录、数据目录的访问和执行权限。
-
-
+初始化安装环境 时，由-G参数所指定的安装用户所属的用户组。该用户组如果不存在，则会自动创建，也可提前创建好用户组。在执行gs_preinstall脚本时会检查权限。gs_preinstall脚本会自动赋予此组中的用户对安装目录、数据目录的访问和执行权限。
+
+
+
+
-初始化安装环境 时，由-U参数所指定和自动创建的操作系统用户，如果已经存在该用户，请清理该用户或更换初始化用户。从安全性考虑，对此用户的所属组规划如下：
-
+
+初始化安装环境 时，由-U参数所指定和自动创建的操作系统用户，如果已经存在该用户，请清理该用户或更换初始化用户。从安全性考虑，对此用户的所属组规划如下：
+
-在安装openGauss过程中运行“gs\_preinstall”时，会创建与安装用户同名的数据库用户，即数据库用户omm。此用户具备数据库的最高操作权限，openGauss为此用户设置的初始密码为GaussDB@2012。为了保证系统的安全性，请及时修改密码。或在安装后通过设置GUC参数modify\_initial\_password为on启用强制修改初始密码特性。启用后，使用此用户首次连接数据库时，系统会强制要求修改此密码。关于GUC参数的修改方法请参见《openGauss 开发者指南》中的“GUC参数说明“。
+在安装openGauss过程中运行“gs\_install”时，会创建与安装用户同名的数据库用户，即数据库用户omm。此用户具备数据库的最高操作权限，此用户初始密码由用户指定。
diff --git "a/content/zh/docs/Quickstart/\344\272\247\345\223\201\347\211\271\347\202\271.md" "b/content/zh/docs/Quickstart/\344\272\247\345\223\201\347\211\271\347\202\271.md"
index a196a5a2d61402b7e45126fde6d9101096a1660c..43c725096dba9eb89a499d685400e1fe68149056 100644
--- "a/content/zh/docs/Quickstart/\344\272\247\345\223\201\347\211\271\347\202\271.md"
+++ "b/content/zh/docs/Quickstart/\344\272\247\345\223\201\347\211\271\347\202\271.md"
@@ -1,6 +1,6 @@
# 产品特点
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
log_error_verbosity 的值设为verbose ）
+
+
+log_error_verbosity 的值设为verbose ）
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-## 操作步骤
-
+
@@ -264,7 +266,7 @@ add_months
-
+
@@ -276,7 +278,7 @@ add_months
-
+
@@ -299,12 +301,12 @@ length
-
+
MERGE INTO ） 和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT ）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。
+MERGE INTO ） 和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT ）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。
+4. 安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。
```
rm –rf ~/.ssh
```
-## 安装生成的目录
+
+
+
+
+
-
+
+
+
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-## 示例 目录下面，其中node\_name是由postgres.conf文件中的pgxc\_node\_name的值，不建议外部使用该参数。
diff --git "a/content/zh/docs/Quickstart/\350\256\276\347\275\256.md" "b/content/zh/docs/Quickstart/\350\256\276\347\275\256.md"
index 33545d5fc410729af6bf5cf9fc987621065414c6..9c8dcfa95e2335c57f5b5e873b46168821cc5730 100644
--- "a/content/zh/docs/Quickstart/\350\256\276\347\275\256.md"
+++ "b/content/zh/docs/Quickstart/\350\256\276\347\275\256.md"
@@ -1,4 +1,4 @@
-# 设置18
- 如果设置为-1，表示wal\_buffers的大小随着参数shared\_buffers自动调整，为shared\_buffers的1/32，最小值为8个XLOG\_BLCKSZ，最大值为2048个XLOG\_BLCKSZ。
-- 如果设置为其他值，当小于8时，会被默认设置为8；当大于2048的时，会被强制设置为2048。
+- 如果设置为其他值，当小于4时，会被默认设置为4。
**默认值：**16MB
@@ -185,5 +186,5 @@
**取值范围**：整型，单位为8KB。
-**默认值：**16MB \(2048 \* 8KB\)
+**默认值：**16MB \(2048 \* 8KB\)
diff --git "a/content/zh/docs/Quickstart/\350\256\276\347\275\256root\347\224\250\346\210\267\350\277\234\347\250\213\347\231\273\345\275\225.md" "b/content/zh/docs/Quickstart/\350\256\276\347\275\256root\347\224\250\346\210\267\350\277\234\347\250\213\347\231\273\345\275\225.md"
index 0582124839ec8dc9a20b4edccbd3959e2c1c6e25..b4bc34ad06c1daf5e2a3be5fb8705373cdb436ea 100644
--- "a/content/zh/docs/Quickstart/\350\256\276\347\275\256root\347\224\250\346\210\267\350\277\234\347\250\213\347\231\273\345\275\225.md"
+++ "b/content/zh/docs/Quickstart/\350\256\276\347\275\256root\347\224\250\346\210\267\350\277\234\347\250\213\347\231\273\345\275\225.md"
@@ -1,4 +1,4 @@
-# 设置root用户远程登录
-
+
+
diff --git "a/content/zh/docs/Quickstart/\350\275\257\347\241\254\344\273\266\347\216\257\345\242\203\350\246\201\346\261\202.md" "b/content/zh/docs/Quickstart/\350\275\257\347\241\254\344\273\266\347\216\257\345\242\203\350\246\201\346\261\202.md"
index 852b3a1678ac984f7f8c5ccc3f65565c6b997d8a..c43579c575befb973564f472ea6f1763031296c2 100644
--- "a/content/zh/docs/Quickstart/\350\275\257\347\241\254\344\273\266\347\216\257\345\242\203\350\246\201\346\261\202.md"
+++ "b/content/zh/docs/Quickstart/\350\275\257\347\241\254\344\273\266\347\216\257\345\242\203\350\246\201\346\261\202.md"
@@ -1,81 +1,134 @@
-# 软硬件环境要求
+
+
+
-
-
+
+
+
+
-
-
+
+
+
+
-至少1GB用于安装 每个主机需大约300MB用于元数据存储。 预留70%以上的磁盘剩余空间用于数据存储。
-
+
+至少1GB用于安装 每个主机需大约300MB用于元数据存储。 预留70%以上的磁盘剩余空间用于数据存储。
+
+
-
-
+
+
+
-## 软件环境要求
+
+
+
+
+
+
+
+
+
+openEuler：支持Python 3.7.X CentOS：支持Python 3.6.X
+
+## 软件依赖要求
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-jdbc:postgresql:database jdbc:postgresql://host/database jdbc:postgresql://host:port/database 说明：
-
-
+
+jdbc:postgresql:database jdbc:postgresql://host/database jdbc:postgresql://host:port/database jdbc:postgresql://host:port/database?param1=value1¶m2=value2 jdbc:postgresql://host1:port1,host2:port2/database?param1=value1¶m2=value2 说明： database为要连接的数据库名称。 host为数据库服务器名称或IP地址。
+
+
+
+ port为数据库服务器端口。
+ param为参数名称，即数据库连接属性。
+ value为参数值，即数据库连接属性值。
+
-user：String类型。表示创建连接的数据库用户。 password：String类型。表示数据库用户的密码。 ssl：Boolean类型。表示是否使用SSL连接。 loggerLevel：string类型。为LogStream或LogWriter设置记录进DriverManager当前值的日志信息量。目前支持"OFF"、"DEBUG"和"TRACE"。 值为"DEBUG"时，表示只打印DEBUG级别以上的日志，将记录非常少的信息。值等于TRACE时，表示打印DEBUG和TRACE级别的日志，将产生详细的日志信息。默认值为OFF，表示不打印日志。 prepareThreshold：integer类型。用于确定在转换为服务器端的预备语句之前，要求执行方法PreparedStatement的次数。缺省值是5。 batchMode : boolean类型，用于确定是否使用batch模式连接。 fetchsize ： integer类型，用于设置数据库链接所创建statement的默认fetchsize。 ApplicationName：string类型。应用名称，在不做设置时，缺省值为PostgreSQL JDBC Driver。 allowReadOnly:boolean类型，用于设置connection是否允许设置readonly模式，默认为false，若该参数不被设置为true，则执行connnection.setReadOnly不生效。 blobMode:string类型，用于设置setBinaryStream方法为不同的数据类型赋值，设置为on时表示为blob数据类型赋值，设置为off时表示为bytea数据类型赋值，默认为on。 connectionExtraInfo：Boolean类型。表示驱动是否上报当前驱动的部署路径、进程属主用户到数据库。 说明：
-
+PGDBNAME：String类型。表示数据库名称。（URL中无需配置该参数，自动从URL中解析） PGHOST：String类型。主机IP地址。详细示例见下。 PGPORT：Integer类型。主机端口号。详细示例见下。 user：String类型。表示创建连接的数据库用户。 password：String类型。表示数据库用户的密码。 loggerLevel：String类型。目前支持3种级别：OFF、DEBUG、TRACE。设置为OFF关闭日志，设置为DEBUG和TRACE记录的日志信息详细程度不同。 loggerFile：String类型。Logger输出的文件名。需要显示指定日志文件名，若未指定目录则生成在客户端运行程序目录。 allowEncodingChanges：Boolean类型。设置该参数值为“true”进行字符集类型更改，配合characterEncoding=CHARSET设置字符集，二者使用"&"分隔。 currentSchema：String类型。在search-path中指定要设置的schema。 hostRecheckSeconds：Integer类型。JDBC尝试连接主机后会保存主机状态：连接成功或连接失败。在hostRecheckSeconds时间内保持可信，超过则状态失效。缺省值是10秒。 ssl：Boolean类型。以SSL方式连接。
+
+
+ sslmode：String类型。SSL认证方式。取值范围为：require、verify-ca、verify-full。require只尝试SSL连接，如果存在CA文件，则应设置成verify-ca的方式验证。 verify-ca只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。 verify-full只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。 sslcert：String类型。提供证书文件的完整路径。客户端和服务端证书的类型为End Entity。 sslkey：String类型。提供密钥文件的完整路径。使用时将客户端证书转换为DER格式： sslrootcert：String类型。SSL根证书的文件名。根证书的类型为CA。 sslpassword：String类型。提供给ConsoleCallbackHandler使用。 sslpasswordcallback：String类型。SSL密码提供者的类名。缺省值：org.postgresql.ssl.jdbc4.LibPQFactory.ConsoleCallbackHandler。 sslfactory：String类型。提供的值是SSLSocketFactory在建立SSL连接时用的类名。 sslfactoryarg：String类型。此值是上面提供的sslfactory类的构造函数的可选参数（不推荐使用）。 sslhostnameverifier：String类型。主机名验证程序的类名。接口实现javax.net.ssl.HostnameVerifier，默认使用org.postgresql.ssl.PGjdbcHostnameVerifier。 loginTimeout：Integer类型。指建立数据库连接的等待时间。超时时间单位为秒。 connectTimeout：Integer类型。用于连接服务器操作的超时值。如果连接到服务器花费的时间超过此值，则连接断开。超时时间单位为秒，值为0时表示已禁用，timeout不发生。 socketTimeout：Integer类型。用于socket读取操作的超时值。如果从服务器读取所花费的时间超过此值，则连接关闭。超时时间单位为秒，值为0时表示已禁用，timeout不发生。 cancelSignalTimeout：Integer类型。发送取消消息本身可能会阻塞，此属性控制用于取消命令的“connect超时”和“socket超时”。超时时间单位为秒，默认值为10秒。 tcpKeepAlive：Boolean类型。启用或禁用TCP保活探测功能。默认为false。 logUnclosedConnections：Boolean类型。客户端可能由于未调用Connection对象的close()方法而泄漏Connection对象。最终这些对象将被垃圾回收，并且调用finalize()方法。如果调用者自己忽略了此操作，该方法将关闭Connection。 assumeMinServerVersion：String类型。客户端会发送请求进行float精度设置。该参数设置要连接的服务器版本，如assumeMinServerVersion=9.0，可以在建立时减少相关包的发送。 ApplicationName：String类型。设置正在使用连接的JDBC驱动的名称。通过在数据库主节点上查询pg_stat_activity表可以看到正在连接的客户端信息，JDBC驱动名称显示在application_name列。缺省值为PostgreSQL JDBC Driver。 connectionExtraInfo：Boolean类型。表示驱动是否上报当前驱动的部署路径、进程属主用户到数据库。
+ autosave：String类型。共有3种："always", "never", "conservative"。如果查询失败，指定驱动程序应该执行的操作。在autosave=always模式下，JDBC驱动程序在每次查询之前设置一个保存点，并在失败时回滚到该保存点。在autosave=never模式（默认）下，无保存点。在autosave=conservative模式下，每次查询都会设置保存点，但是只会在“statement XXX无效”等情况下回滚并重试。 protocolVersion：Integer类型。连接协议版本号，目前仅支持3。注意：设置该参数时将采用md5加密方式，需要同步修改数据库的加密方式：gs_guc set -N all -I all -c "password_encryption_type=1" ，重启 prepareThreshold：Integer类型。控制parse语句何时发送。默认值是5。第一次parse一个SQL比较慢，后面再parse就会比较快，因为有缓存了。如果一个会话连续多次执行同一个SQL，在达到prepareThreshold次数以上时，JDBC将不再对这个SQL发送parse命令。 preparedStatementCacheQueries：Integer类型。确定每个连接中缓存的查询数，默认情况下是256。若在prepareStatement()调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。0表示禁用缓存。 preparedStatementCacheSizeMiB：Integer类型。确定每个连接可缓存的最大值（以兆字节为单位），默认情况下是5。若缓存了超过5MB的查询，则最近最少使用的查询缓存将被丢弃。0表示禁用缓存。 databaseMetadataCacheFields：Integer类型。默认值是65536。指定每个连接可缓存的最大值。“0”表示禁用缓存。 databaseMetadataCacheFieldsMiB：Integer类型。默认值是5。每个连接可缓存的最大值，单位是MB。“0”表示禁用缓存。 stringtype：String类型，可选字段为：false, "unspecified", "varchar"。设置通过setString()方法使用的PreparedStatement参数的类型，如果stringtype设置为VARCHAR（默认值），则这些参数将作为varchar参数发送给服务器。若stringtype设置为unspecified，则参数将作为untyped值发送到服务器，服务器将尝试推断适当的类型。 batchMode：Boolean类型。用于确定是否使用batch模式连接。 fetchsize：Integer类型。用于设置数据库连接所创建statement的默认fetchsize。 reWriteBatchedInserts：Boolean类型。批量导入时，该参数设置为on，可将N条插入语句合并为一条：insert into TABLE_NAME values(values1, ..., valuesN), ..., (values1, ..., valuesN);使用该参数时，需设置batchMode=off。 unknownLength：Integer类型，默认为Integer.MAX_VALUE。某些postgresql类型（例如TEXT）没有明确定义的长度，当通过ResultSetMetaData.getColumnDisplaySize和ResultSetMetaData.getPrecision等函数返回关于这些类型的数据时，此参数指定未知长度类型的长度。 defaultRowFetchSize：Integer类型。确定一次fetch在ResultSet中读取的行数。限制每次访问数据库时读取的行数可以避免不必要的内存消耗，从而避免OutOfMemoryException。缺省值是0，这意味着ResultSet中将一次获取所有行。没有负数。 binaryTransfer：Boolean类型。使用二进制格式发送和接收数据，默认值为“false”。 binaryTransferEnable：String类型。启用二进制传输的类型列表，以逗号分隔。OID编号和名称二选一，例如binaryTransferEnable=Integer4_ARRAY,Integer8_ARRAY。
+
+ binaryTransferDisEnable：String类型。禁用二进制传输的类型列表，以逗号分隔。OID编号和名称二选一。覆盖binaryTransferEnable的设置。 blobMode：String类型。用于设置setBinaryStream方法为不同类型的数据赋值，设置为on时表示为blob类型数据赋值，设置为off时表示为bytea类型数据赋值，默认为on。 socketFactory：String类型。用于创建与服务器socket连接的类的名称。该类必须实现了接口“javax.net.SocketFactory”，并定义无参或单String参数的构造函数。 socketFactoryArg：String类型。此值是上面提供的socketFactory类的构造函数的可选参数，不推荐使用。 receiveBufferSize：Integer类型。该值用于设置连接流上的SO_RCVBUF。 sendBufferSize：Integer类型。该值用于设置连接流上的SO_SNDBUF。 preferQueryMode：String类型。共有4种："extended", "extendedForPrepared", "extendedCacheEverything", "simple"。用于指定执行查询的模式，simple模式会excute，不parse和bind；extended模式会bind和excute；extendedForPrepared模式为prepared statement扩展使用；extendedCacheEverything模式会缓存每个statement。
+
+
+
+
-## 示例
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 在安装数据库时指定初始化参数-E。 通过SQL语句创建数据库时指定ENCODING参数。 示例 。
+
+
+
+
+
+
+ > **说明：**
+ >- openGauss支持字符集的多种写法：gbk/GBK、UTF-8/UTF8/uft8/utf-8和Latine1/latine1。
+ >- 安装时若不指定字符集，默认字符集为SQL\_ASCII，若想指定，请在安装时指定，具体操作请参见[示例](#zh-cn_topic_0249784576_zh-cn_topic_0241805810_zh-cn_topic_0085434664_zh-cn_topic_0059782037_sa523d6a2a09c4cf29d503e2175747721)。
+
+- 规划区域。
+ 1. 检查与指定字符集（假设为UTF-8）匹配的区域。
+
+ ```
+ locale -a |grep utf8
+ ```
+
+ 显示类似如下信息，其中en\_US.utf8表示区域en\_US支持UTF-8编码。
+
+ ```
+ ......
+ en_SG.utf8
+ en_US.utf8
+ ......
+ ```
+
+ 2. 在初始化数据库时设置区域，设置方法请参见[示例](#zh-cn_topic_0249784576_zh-cn_topic_0241805810_zh-cn_topic_0085434664_zh-cn_topic_0059782037_sa523d6a2a09c4cf29d503e2175747721)。
+
+
+## 示例
+
+
+
+
+
+
+
-
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
+
+
-0：表示系统会尽量精确计算当前可用的内存。 1：表示不作检查直接返回成功。 2：内存总量×vm.overcommit_ratio/100＋SWAP的总量，如果申请空间超过此数值则返回失败。
+
+0：表示系统会尽量精确计算当前可用的内存。 1：表示不作检查直接返回成功。 2：内存总量×vm.overcommit_ratio/100＋SWAP的总量，如果申请空间超过此数值则返回失败。
+
+
-
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-0表示关闭SYN Cookies。 1表示开启SYN Cookies。
+0表示关闭SYN Cookies。 1表示开启SYN Cookies。
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-## 文件系统参数
+
+
+
+
+
+
+
+
+
+
+
+
-## 系统支持的最大进程数设置
+
+
+
+
+
+
+
+
-## 网卡参数配置
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
+
-
+
+dataNode1_syncNum
+
+
+
+
-
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-磁盘空间>1GB 与数据库所需其它路径相互独立，没有包含关系。
+磁盘空间>1GB 与数据库所需其它路径相互独立，没有包含关系。
+
-磁盘空间建议根据主机上的数据库节点数规划。数据库节点预留1GB空间的基础上，再适当预留冗余空间。 与
+
+磁盘空间建议根据主机上的数据库节点数规划。数据库节点预留1GB空间的基础上，再适当预留冗余空间。 与
+
-
+
+
+
-磁盘空间>100MB 固定目录，与数据库所需其它目录相互独立，没有包含关系。
+
+磁盘空间>100MB 固定目录，与数据库所需其它目录相互独立，没有包含关系。
+
+
+
-
+
+
使用如下命令修改参数。 说明：
-
+
重启数据库使参数生效。 说明：
@@ -106,7 +106,7 @@ openGauss提供了三种方式来修改GUC参数，具体操作请参考[表2](#
说明：
+
说明：
+
+
+
+
+
+
+
+该典型组网有如下优点：
+
+- 业务网络与数据库管理存储网络的隔离，有效保护了后端存储数据的安全。
+- 业务网络和数据库管理存储网络的隔离，可以防止攻击者通过互联网试图对数据库服务器进行管理操作，增加了系统安全性。
+
+网络独占性及1:1的带宽收敛比是openGauss数据库网络性能的基本要求。因此，在生产系统中，对[图1](#zh-cn_concept_0238166305_fig7654172218145)中的后端存储网络，需满足独占性及至少1:1收敛比的要求。例如，[图2](#zh-cn_concept_0238166305_zh-cn_topic_0085434654_zh-cn_topic_0059782024_fig397545395542)中，其本质是Fattree组网方式。为实现收敛比1：1，交换网络层级每提高一层，带宽增加一倍。图中每根加粗连接线代表80GE带宽，即8台物理机带宽上限之和。接入层每单台交换机下行带宽160GE，上行带宽160GE，收敛比1:1；汇聚层每单台交换机接入带宽320GE。
+
+对于测试系统，上述要求可以适当降低。
+
+**图 2** 数据库管理存储网络组网示例
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\346\212\200\346\234\257\347\211\271\347\202\271.md" "b/content/zh/docs/Technicalwhitepaper/\346\212\200\346\234\257\347\211\271\347\202\271.md"
new file mode 100644
index 0000000000000000000000000000000000000000..700d5546ff57dbe0e172af5706fd76530ecbf1b9
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\346\212\200\346\234\257\347\211\271\347\202\271.md"
@@ -0,0 +1,20 @@
+# 技术特点
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+**表 2** DETAIL 级别诊断报告
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+应用价值：
+
+- WDR报表是长期性能问题最主要的诊断手段。基于SNAPSHOT的性能基线，从多维度做性能分析，能帮助DBA 掌握系统负载繁忙程度，各个组件的性能表现，性能瓶颈。
+- SNAPSHOT也是后续性能问题自诊断和自优化建议的重要数据来源。
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\346\224\257\346\214\201\344\270\200\351\224\256\345\274\217\346\224\266\351\233\206\350\257\212\346\226\255\344\277\241\346\201\257.md" "b/content/zh/docs/Technicalwhitepaper/\346\224\257\346\214\201\344\270\200\351\224\256\345\274\217\346\224\266\351\233\206\350\257\212\346\226\255\344\277\241\346\201\257.md"
new file mode 100644
index 0000000000000000000000000000000000000000..d0dac31a0f4fef8718927e2c6c06a0e9564de656
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\346\224\257\346\214\201\344\270\200\351\224\256\345\274\217\346\224\266\351\233\206\350\257\212\346\226\255\344\277\241\346\201\257.md"
@@ -0,0 +1,16 @@
+# 支持一键式收集诊断信息
+
+
+
+
+
+
+
+
+
+
+
+
+
+应用程序和用户交互的一种方式，完全基于文本输入和输出。命令通过键盘或类似装置输入，由程序编译并执行。结果是以文本或图形的方式呈现在终端界面。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\347\211\251\347\220\206\345\244\207\344\273\275.md" "b/content/zh/docs/Technicalwhitepaper/\347\211\251\347\220\206\345\244\207\344\273\275.md"
new file mode 100644
index 0000000000000000000000000000000000000000..e7132fb987d3a1b9203843dcf6631a7f8a9c430d
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\347\211\251\347\220\206\345\244\207\344\273\275.md"
@@ -0,0 +1,6 @@
+# 物理备份
+
+
+
+
+
+
+
+
+
+
+
+至少1GB用于安装实例的应用程序包。 每个主机需大约300MB用于元数据存储。 预留70%以上的磁盘剩余空间用于数据存储。
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\347\272\277\347\250\213\346\261\240\351\253\230\345\271\266\345\217\221.md" "b/content/zh/docs/Technicalwhitepaper/\347\272\277\347\250\213\346\261\240\351\253\230\345\271\266\345\217\221.md"
new file mode 100644
index 0000000000000000000000000000000000000000..a02cacc0f4ef302f01d8443ede7d1771c8959897
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\347\272\277\347\250\213\346\261\240\351\253\230\345\271\266\345\217\221.md"
@@ -0,0 +1,8 @@
+# 线程池高并发
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\350\207\252\351\200\202\345\272\224\345\216\213\347\274\251.md" "b/content/zh/docs/Technicalwhitepaper/\350\207\252\351\200\202\345\272\224\345\216\213\347\274\251.md"
new file mode 100644
index 0000000000000000000000000000000000000000..e0779ac0cdb0ad2732e773757d1417ffa5068e02
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\350\207\252\351\200\202\345\272\224\345\216\213\347\274\251.md"
@@ -0,0 +1,79 @@
+# 自适应压缩
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+具体场景如：支持类手机号字符串的大整数压缩、支持numeric类型的大整数压缩、支持对压缩算法进行不同压缩水平的调整。
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\350\241\214\345\210\227\346\267\267\345\220\210\345\255\230\345\202\250.md" "b/content/zh/docs/Technicalwhitepaper/\350\241\214\345\210\227\346\267\267\345\220\210\345\255\230\345\202\250.md"
new file mode 100644
index 0000000000000000000000000000000000000000..3db58f24273b386c3cd9aab647719210cc856f68
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\350\241\214\345\210\227\346\267\267\345\220\210\345\255\230\345\202\250.md"
@@ -0,0 +1,47 @@
+# 行列混合存储
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\350\275\257\344\273\266\350\246\201\346\261\202.md" "b/content/zh/docs/Technicalwhitepaper/\350\275\257\344\273\266\350\246\201\346\261\202.md"
new file mode 100644
index 0000000000000000000000000000000000000000..5707f9435c1d05e29826ae241e15fa440aead81f
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\350\275\257\344\273\266\350\246\201\346\261\202.md"
@@ -0,0 +1,35 @@
+# 软件要求
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\350\275\257\347\241\254\344\273\266\351\205\215\347\275\256\350\246\201\346\261\202.md" "b/content/zh/docs/Technicalwhitepaper/\350\275\257\347\241\254\344\273\266\351\205\215\347\275\256\350\246\201\346\261\202.md"
new file mode 100644
index 0000000000000000000000000000000000000000..c2d99ab989a5de9d4632ecb874e061d3a4c26a5b
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\350\275\257\347\241\254\344\273\266\351\205\215\347\275\256\350\246\201\346\261\202.md"
@@ -0,0 +1,7 @@
+# 软硬件配置要求
+
+
+
+
+
+
+
+
+
+
+
+对系统的可靠性和可用性无任何要求 主要用于体验试用以及调测场景 系统RTO和RPO不可控 无实例级容灾能力，一旦出现实例故障，系统不可用 一旦实例级数据丢失，则数据永久丢失，无法恢复
+
+
+
+
+节点间无网络延迟 要求承受集群内实例级故障 适用于对系统可靠性要求不高的场景 RPO=0 实例故障RTO<10s 无AZ级容灾能力 推荐主备最大可用模式
+
+
+
+
+RPO=0 实例故障RTO<10s 无AZ级容灾能力 推荐主备同步模式 最少2个副本，最多4个副本
+
+## 软硬件规格
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Technicalwhitepaper/\351\203\250\347\275\262\346\226\271\346\241\210.md" "b/content/zh/docs/Technicalwhitepaper/\351\203\250\347\275\262\346\226\271\346\241\210.md"
new file mode 100644
index 0000000000000000000000000000000000000000..aefdafc55cfb4f7cc591dbd81c61a148c6b8dcaf
--- /dev/null
+++ "b/content/zh/docs/Technicalwhitepaper/\351\203\250\347\275\262\346\226\271\346\241\210.md"
@@ -0,0 +1,11 @@
+# 部署方案
+
-
-
-
-
@@ -181,20 +174,6 @@ gaussdb接受[表1](#zh-cn_topic_0237152404_zh-cn_topic_0059777816_zh-cn_topic_0
-
-
-
-
-
-
-
-
@@ -379,7 +358,7 @@ gaussdb接受[表1](#zh-cn_topic_0237152404_zh-cn_topic_0059777816_zh-cn_topic_0
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
-
+
@@ -497,7 +493,7 @@ gs\_check改进增强，统一化当前系统中存在的各种检查工具，
+
+
+
+
+
+
+
+
+
-
-
-
@@ -695,14 +684,14 @@ gs\_check改进增强，统一化当前系统中存在的各种检查工具，
+
+
+
-
-
-
@@ -788,9 +773,9 @@ gs\_check改进增强，统一化当前系统中存在的各种检查工具，
+
+
@@ -865,11 +850,11 @@ gs\_check改进增强，统一化当前系统中存在的各种检查工具，
+
+
+
+
+
+
diff --git a/content/zh/docs/Toolreference/gs_checkperf.md b/content/zh/docs/Toolreference/gs_checkperf.md
index a404255a5b64a6dd1909033ec8249967c4be2a78..e4960314e18a7ea40accc9093da37784f8868c85 100644
--- a/content/zh/docs/Toolreference/gs_checkperf.md
+++ b/content/zh/docs/Toolreference/gs_checkperf.md
@@ -1,4 +1,4 @@
-# gs\_checkperf
-
+
-
+
-
+
+
-
-
-
-
+
注意：
+
+
@@ -20,10 +20,10 @@
+
+
@@ -32,19 +32,19 @@
+
+
+
+
@@ -151,15 +151,15 @@
+
+
+
diff --git "a/content/zh/docs/Toolreference/gs_ctl-\351\207\215\345\273\272\345\244\207\345\256\236\344\276\213\350\277\207\347\250\213\350\242\253\344\270\255\346\226\255\345\257\274\350\207\264\347\247\230\351\222\245\346\226\207\344\273\266\344\270\215\345\256\214\346\225\264\346\201\242\345\244\215\346\226\271\346\263\225.md" "b/content/zh/docs/Toolreference/gs_ctl-\351\207\215\345\273\272\345\244\207\345\256\236\344\276\213\350\277\207\347\250\213\350\242\253\344\270\255\346\226\255\345\257\274\350\207\264\347\247\230\351\222\245\346\226\207\344\273\266\344\270\215\345\256\214\346\225\264\346\201\242\345\244\215\346\226\271\346\263\225.md"
new file mode 100644
index 0000000000000000000000000000000000000000..56ca332926feb8454e07d9b7a27143b010ae1b36
--- /dev/null
+++ "b/content/zh/docs/Toolreference/gs_ctl-\351\207\215\345\273\272\345\244\207\345\256\236\344\276\213\350\277\207\347\250\213\350\242\253\344\270\255\346\226\255\345\257\274\350\207\264\347\247\230\351\222\245\346\226\207\344\273\266\344\270\215\345\256\214\346\225\264\346\201\242\345\244\215\346\226\271\346\263\225.md"
@@ -0,0 +1,47 @@
+# gs\_ctl 重建备实例过程被中断导致秘钥文件不完整恢复方法
+
-
+
+
@@ -170,6 +172,8 @@ gs\_ctl参数可分为如下几类：
+ 说明：
+
primary：本端以主机模式启动。 standby：本端以备机模式启动。 pending：本端处于等待状态，等待提升为主机或者备机。
+
+
+
@@ -196,7 +207,7 @@ gs\_ctl参数可分为如下几类：
+
+
gaussdb 支持的参数。
@@ -270,7 +281,7 @@ gs\_ctl参数可分为如下几类：
-smart：等待所有客户端中断连接后才关闭。如果服务器处于紧迫等待，一旦所有的客户断开连接，恢复和复制流将会中断。 fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被关闭。 immediate：强行关闭，在下次重新启动的时候将导致故障恢复。 smart：单机模式下主机立即断开，同fast。 fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被关闭。 immediate：强行关闭，在下次重新启动的时候将导致故障恢复。
-smart：等待所有客户端中断连接后才切换。如果服务器处于紧迫等待，一旦所有的客户断开连接，恢复和复制流将会中断。 fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被切换。 fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被切换。 smart：本版本暂不支持该模式 immediate：本版本暂不支持该模式
+
+
-
-
+
+
+
@@ -332,13 +344,13 @@ gs\_ctl参数可分为如下几类：
+
+
+
+**表 8** query参数
+
+
+
+
+
+
+
+
+
diff --git a/content/zh/docs/Toolreference/gs_dump.md b/content/zh/docs/Toolreference/gs_dump.md
index aff2c6b99868cf1bdf5bec22a7661c47e2101bf2..040c89e1dfa27df5acc35b3c978c1c49800c6045 100644
--- a/content/zh/docs/Toolreference/gs_dump.md
+++ b/content/zh/docs/Toolreference/gs_dump.md
@@ -1,4 +1,4 @@
-# gs\_dump选项。如果未输入，用户会收到错误信息。
>应该输入转储时所输入的相同的key。
+ >转储格式为c或t时，转储内容已被处理，因此转储格式为c或t是输入不受加密限制。
> **须知：**
@@ -294,7 +296,7 @@ gs_restore [OPTION]... FILE
特例：执行gsql程序，使用如下选项导入由gs\_dump/gs\_dumpall生成导出文件夹（纯文本格式）的MPPDB\_backup.sql文件到postgres数据库。
```
-gsql -d postgres -p 8000 -W Bigdata@123 -f /home/omm/test/MPPDB_backup.sql
+gsql -d postgres -p 5432 -W Bigdata@123 -f /home/omm/test/MPPDB_backup.sql
SET
SET
SET
@@ -322,7 +324,7 @@ gs\_restore用来导入由gs\_dump生成的导出文件。
示例1：执行gs\_restore，将导出的MPPDB\_backup.dmp文件（自定义归档格式）导入到postgres数据库。
```
-gs_restore -W Bigdata@123 backup/MPPDB_backup.dmp -p 8000 -d postgres
+gs_restore -W Bigdata@123 backup/MPPDB_backup.dmp -p 5432 -d postgres
gs_restore: restore operation successful
gs_restore: total time: 13053 ms
```
@@ -330,7 +332,7 @@ gs_restore: total time: 13053 ms
示例2：执行gs\_restore，将导出的MPPDB\_backup.tar文件（tar格式）导入到postgres数据库。
```
-gs_restore backup/MPPDB_backup.tar -p 8000 -d postgres
+gs_restore backup/MPPDB_backup.tar -p 5432 -d postgres
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21203 ms
```
@@ -338,7 +340,7 @@ gs_restore[2017-07-21 19:16:26]: total time: 21203 ms
示例3：执行gs\_restore，将导出的MPPDB\_backup文件（目录格式）导入到postgres数据库。
```
-gs_restore backup/MPPDB_backup -p 8000 -d postgres
+gs_restore backup/MPPDB_backup -p 5432 -d postgres
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21003 ms
```
@@ -346,7 +348,7 @@ gs_restore[2017-07-21 19:16:26]: total time: 21003 ms
示例4：执行gs\_restore，使用自定义归档格式的MPPDB\_backup.dmp文件来进行如下导入操作。 导入PUBLIC模式下所有对象的定义和数据。在导入时会先删除已经存在的对象，如果原对象存在跨模式的依赖则需手工强制干预。
```
-gs_restore backup/MPPDB_backup.dmp -p 8000 -d postgres -e -c -n PUBLIC
+gs_restore backup/MPPDB_backup.dmp -p 5432 -d postgres -e -c -n PUBLIC
gs_restore: [archiver (db)] Error while PROCESSING TOC:
gs_restore: [archiver (db)] Error from TOC entry 313; 1259 337399 TABLE table1 gaussdba
gs_restore: [archiver (db)] could not execute query: ERROR: cannot drop table table1 because other objects depend on it
@@ -358,7 +360,7 @@ HINT: Use DROP ... CASCADE to drop the dependent objects too.
手工删除依赖，导入完成后再重新创建。
```
-gs_restore backup/MPPDB_backup.dmp -p 8000 -d postgres -e -c -n PUBLIC
+gs_restore backup/MPPDB_backup.dmp -p 5432 -d postgres -e -c -n PUBLIC
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 2203 ms
```
@@ -366,7 +368,7 @@ gs_restore[2017-07-21 19:16:26]: total time: 2203 ms
示例5：执行gs\_restore，使用自定义归档格式的MPPDB\_backup.dmp文件来进行如下导入操作。只导入PUBLIC模式下表table1的定义。
```
-gs_restore backup/MPPDB_backup.dmp -p 8000 -d postgres -e -c -s -n PUBLIC -t table1
+gs_restore backup/MPPDB_backup.dmp -p 5432 -d postgres -e -c -s -n PUBLIC -t table1
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 21000 ms
```
@@ -374,7 +376,7 @@ gs_restore[2017-07-21 19:16:26]: total time: 21000 ms
示例6：执行gs\_restore，使用自定义归档格式的MPPDB\_backup.dmp文件来进行如下导入操作。只导入PUBLIC模式下表table1的数据。
```
-gs_restore backup/MPPDB_backup.dmp -p 8000 -d postgres -e -a -n PUBLIC -t table1
+gs_restore backup/MPPDB_backup.dmp -p 5432 -d postgres -e -a -n PUBLIC -t table1
gs_restore[2017-07-21 19:16:26]: restore operation successful
gs_restore[2017-07-21 19:16:26]: total time: 20203 ms
```
diff --git a/content/zh/docs/Toolreference/gs_ssh.md b/content/zh/docs/Toolreference/gs_ssh.md
index f0594f32c4bb46440aa02fbf6c28510a94bb3cd4..1f000b26909e59d065e1ffb381d50fe0cd7e6516 100644
--- a/content/zh/docs/Toolreference/gs_ssh.md
+++ b/content/zh/docs/Toolreference/gs_ssh.md
@@ -1,4 +1,4 @@
-# gs\_ssh若设置此变量为数值，假设为10，则在gsql中输入的前9次EOF字符（通常是Ctrl+C组合键）都会被忽略，在第10次按Ctrl+C才能退出gsql程序。 若设置此变量为非数值，则缺省为10。 若删除此变量，则向交互的gsql会话发送一个EOF终止应用。 若设置此变量为数值，假设为10，则在gsql中输入的前9次EOF字符（通常是Ctrl+D组合键）都会被忽略，在第10次按Ctrl+D才能退出gsql程序。 若设置此变量为非数值，则缺省为10。 若删除此变量，则向交互的gsql会话发送一个EOF终止应用。
diff --git a/content/zh/docs/Toolreference/gstrace.md b/content/zh/docs/Toolreference/gstrace.md
index f9352e3222ec4e8ba6f706899a1c69343e57e71a..2d883a6603b14abf0ea8b9b7eb3de58fe006ac5d 100644
--- a/content/zh/docs/Toolreference/gstrace.md
+++ b/content/zh/docs/Toolreference/gstrace.md
@@ -1,4 +1,4 @@
-# gstrace] [-m ] [-s ] [-f ] [-o ] [-t ]
+gstrace [start|stop|config|dump|detailcodepath|analyze] [-p ][-s ] [-f ] [-o ] [-t ]
```
## 参数说明] [-m ] [
-
-
-
-comp 是模块列表，使用‘,’分隔，例如：executer, func 是function列表，使用‘,’ 分隔。 例如：sql_execute_ddl, sql_execute_dcl。也可以使用序号指代模块中第几个function，例如：2 设置成ALL表示所有模块或所有function被trace。
-executer, executer, executer,
-
+
@@ -116,7 +105,7 @@ gstrace [start|stop|config|dump|detailcodepath|analyze] [-p
] [-m ] [
2. 停止trace
```
- gstarce stop -p 207787
+ gstrace stop -p 207787
```
3. 查看trace配置
diff --git a/content/zh/docs/Toolreference/kadmin-local.md b/content/zh/docs/Toolreference/kadmin-local.md
index 75232cad0933ae522656c4937c79ce181f36abee..20382a47f684659095d083e05d4b8adff39e4720 100644
--- a/content/zh/docs/Toolreference/kadmin-local.md
+++ b/content/zh/docs/Toolreference/kadmin-local.md
@@ -1,4 +1,4 @@
-# kadmin.local
+
+
@@ -938,8 +938,8 @@
-
-YY001：TCP通信错误，Connection reset by peer YY002：TCP通信错误，Connection reset by peer YY003：锁超时，Lock wait timeout.../wait transaction xxx sync time exceed xxx YY004：TCP通信错误，Connection timed out YY005：SET命令发送失败，ERROR SET query YY006：内存申请失败，memory is temporarily unavailable YY007：通信库错误，Memory allocate error YY008：通信库错误，No data in buffer YY009：通信库错误，Close because release memory YY010：通信库错误，TCP disconnect YY011：通信库错误，SCTP disconnect YY012：通信库错误，Stream closed by remote YY013：通信库错误，Wait poll unknown error
+YY001：TCP通信错误，Connection reset by peer YY002：TCP通信错误，Connection reset by peer YY003：锁超时，Lock wait timeout.../wait transaction xxx sync time exceed xxx YY004：TCP通信错误，Connection timed out YY005：SET命令发送失败，ERROR SET query YY006：内存申请失败，memory is temporarily unavailable YY007：通信库错误，Memory allocate error YY008：通信库错误，No data in buffer YY009：通信库错误，Close because release memory YY010：通信库错误，TCP disconnect YY011：通信库错误，SCTP disconnect YY012：通信库错误，Stream closed by remote YY013：通信库错误，Wait poll unknown error YY014,YY015,53200,08006,08000,57P01,XX003,XX009等
说明： 不支持事务块中的语句错误重试； 不支持通过ODBC、JDBC接口查询的出错重试； 含有unlogged表的sql语句，不支持节点故障后的出错重试； gsql客户端本身出现的错误，不在重跑考虑范围之内；
+
-## **PATTERN**
+
+
+
+
+
+
+ 须知：
+
+
+trust reject md5（不安全的算法，为了兼容老版本而存在） sha256
+
+
+
+
+trust reject md5（不安全的算法，为了兼容老版本而存在） sha256
+
+
+
+
+trust reject md5（不安全的算法，为了兼容老版本而存在） sha256
+
+
+
+
+
+
+
+
+
+
+ 须知：
+
+用locale -a |grep gbk命令查看系统支持gbk编码的区域，如下：~ > locale -a|grep gbk
+zh_CN.gbk
+zh_SG.gbk
+ 初始化数据库时加入--locale=zh_CN.gbk选项。
+
+
+
+
+
+
+
+
+
+
+ 说明：
+
+
+
+
+
+
+
+
+
+pg_catalog.english全文搜索 pg_catalog.simple普通文本搜索
+
+
+
+
+
+
+
+
+
+
+最少包含8个字符； 不能和用户名和当前密码（ALTER）相同，或和当前密码反序； 至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+\|[{}];:,<.>/?）四类字符中的三类字符。
+
+ 说明： 加密密码文件需使用gs_guc工具生成：gs_guc encrypt -K Gauss@123 -D Dir。 如果用户指定多个-w和-C参数，gs_initdb会将用户输入的最后一个-w或-C参数作为用户的需求，即输入密码的明文或经过AES128加密后的密码。
+
+
+
+
+
+
+
+
+
+
+**表 2** 不常用参数说明
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/content/zh/docs/Toolreference/\345\221\275\344\273\244\345\217\202\350\200\203.md" "b/content/zh/docs/Toolreference/\345\221\275\344\273\244\345\217\202\350\200\203.md"
index 7f025e6a615c9d27060ae0c220fffb3646d578f0..940ea3cd23731038c27115553811981d18828f1e 100644
--- "a/content/zh/docs/Toolreference/\345\221\275\344\273\244\345\217\202\350\200\203.md"
+++ "b/content/zh/docs/Toolreference/\345\221\275\344\273\244\345\217\202\350\200\203.md"
@@ -1,4 +1,4 @@
-# 命令参考
+ 说明：
+
+
+
+
+
+
+
+
注意：
+
+
注意：
+
+
+
+
须知：
+
+
注意： 使用此参数可能会暴露部分SQL语句中的敏感信息，如创建用户语句中的password信息等，请谨慎使用。 此参数只保留查询结果到相应文件中，主要目标是为了查询结果能够更好更准确地被其他调用者（例如自动化运维脚本）解析；而不是保留gsql运行过程中的相关日志信息。
+
+
说明：
+
+
+
+
+
+
+
+
注意：
+
+
+
@@ -320,8 +325,8 @@
- 说明：
+
+ 说明：
gsql
-
高级特性 ，便于用户使用。
+高级特性 ，便于用户使用。
服务端工具
gs_check
gs_check gs_checkos
+gs_check ，gs_checkos 等，帮助用户在openGauss运行过程中，全量的检查openGauss运行环境，操作系统环境，网络环境及数据库执行环境，也有助于在openGauss重大操作之前对各类环境进行全面检查，有效保证操作执行成功。
gs_checkos
+
gs_checkperf
+
gs_collector
+
gs_dump
@@ -54,22 +54,22 @@ openGauss提供客户端和服务器端应用程序（工具），帮助用户
gs_guc
+
gs_om
+
gs_restore
+
gs_ssh
+
+
-
+
+
@@ -107,9 +106,10 @@
-在安装openGauss过程中运行“gs\_preinstall”时，会创建与安装用户同名的数据库用户，即数据库用户omm。此用户具备数据库的最高操作权限，openGauss为此用户设置的初始密码为GaussDB@2012。为了保证系统的安全性，请及时修改密码。或在安装后通过设置GUC参数modify\_initial\_password为on启用强制修改初始密码特性。启用后，使用此用户首次连接数据库时，系统会强制要求修改此密码。关于GUC参数的修改方法请参见《openGauss 开发者指南》中的“GUC参数说明“。
+在安装openGauss过程中运行“gs\_install”时，会创建与安装用户同名的数据库用户，即数据库用户omm。此用户具备数据库的最高操作权限，此用户初始密码由用户指定。
diff --git "a/content/zh/docs/installation/\344\277\256\346\224\271\346\223\215\344\275\234\347\263\273\347\273\237\351\205\215\347\275\256.md" "b/content/zh/docs/installation/\344\277\256\346\224\271\346\223\215\344\275\234\347\263\273\347\273\237\351\205\215\347\275\256.md"
index e86b97972fcc31ab1dd7b40555c82b5574ce203c..f1a91eb0ee89ed2a90cc1db9e97cb5411fd45266 100644
--- "a/content/zh/docs/installation/\344\277\256\346\224\271\346\223\215\344\275\234\347\263\273\347\273\237\351\205\215\347\275\256.md"
+++ "b/content/zh/docs/installation/\344\277\256\346\224\271\346\223\215\344\275\234\347\263\273\347\273\237\351\205\215\347\275\256.md"
@@ -1,4 +1,4 @@
-# 修改操作系统配置
+
+
+
+
+
+
安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。
+4. 安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。
```
rm –rf ~/.ssh
@@ -67,11 +77,11 @@
+
+
+
-
-
-
-
@@ -112,7 +112,7 @@
+
+
+
至少1GB用于安装 每个主机需大约300MB用于元数据存储。 预留70%以上的磁盘剩余空间用于数据存储。
-
+
@@ -52,30 +52,83 @@
**表 2** 软件环境要求
+
+
+
+
+
+
+
+
+
+openEuler：支持Python 3.7.X CentOS：支持Python 3.6.X
+
+## 软件依赖要求
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
在安装数据库时指定初始化参数-E。 通过SQL语句创建数据库时指定ENCODING参数。 示例 。
@@ -39,7 +39,7 @@
+
diff --git "a/content/zh/docs/installation/\351\205\215\347\275\256\346\223\215\344\275\234\347\263\273\347\273\237\345\217\202\346\225\260.md" "b/content/zh/docs/installation/\351\205\215\347\275\256\346\223\215\344\275\234\347\263\273\347\273\237\345\217\202\346\225\260.md"
index debed9990068f2f50bea09df4837fb19e302aa69..cfb977316b7c383ea34bf6e25bbd350d62f2129c 100644
--- "a/content/zh/docs/installation/\351\205\215\347\275\256\346\223\215\344\275\234\347\263\273\347\273\237\345\217\202\346\225\260.md"
+++ "b/content/zh/docs/installation/\351\205\215\347\275\256\346\223\215\344\275\234\347\263\273\347\273\237\345\217\202\346\225\260.md"
@@ -1,4 +1,4 @@
-# 配置操作系统参数
+
+
+
+
+
+
dataNode1_syncNum
+
+
@@ -68,13 +74,13 @@
+
+
