diff --git a/README.md b/README.md index 0370e2b9d720a4d3ecf304cdbf049dc8bf977346..ef01ef1cc8d273ff0797e4ad06b323047adc515b 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ### 介绍 -欢迎来到openGauss官方文档的仓库。此仓库提供[openGauss社区网站](https://opengauss.org/zh)所呈现的所有文档，包括法律声明、发行说明、产品描述、技术白皮书、编译指导书、简易教程、安装指南、管理员指南、开发者指南、工具参考等内容。 +欢迎来到openGauss官方文档的仓库。此仓库提供[openGauss社区网站](https://opengauss.org/zh)所呈现的所有文档，包括法律声明、发行说明、产品描述、技术白皮书、编译指导书、简易教程、安装指南、管理员指南、应用开发指南、工具参考等内容。 ### 贡献 我们非常欢迎您贡献文档！如果想要参与，请阅读[贡献范围](contribute/贡献范围.md)，务必遵守文档写作规范，并按照流程规则提交。审核通过后，修改会在文档工程和官网中呈现。 @@ -49,6 +49,9 @@ Docs包含了如下7个分支： - master：开发分支，为默认分支。 +- 6.0.0：6.0.0版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 6.0.0"。 +- 6.0.0-RC1：6.0.0-RC1版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 6.0.0-RC1"。 +- 5.1.0：5.1.0版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 5.1.0"。 - 5.0.0：5.0.0版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 5.0.0"。 - 3.1.1：3.1.1版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 3.1.1"。 - 3.1.0：3.1.0版本分支，分支内容呈现在[openGauss社区网站](https://opengauss.org/zh)"文档 > 3.1.0"。 diff --git a/content/docs-lite/en/docs/AboutopenGauss/database-audit.md b/content/docs-lite/en/docs/AboutopenGauss/database-audit.md index 42d769bd2007457b0398a734250bf200928a7ded..f88eaaf14003bcc952a18b011c45abf0b7b513c8 100644 --- a/content/docs-lite/en/docs/AboutopenGauss/database-audit.md +++ b/content/docs-lite/en/docs/AboutopenGauss/database-audit.md @@ -18,7 +18,7 @@ Database security is essential for a database system. openGauss writes all user ## Enhancements -None. +version 6.0.0: Integrate tool audit log into databases to monitor activities such as backup, recovery, and other operations. ## Constraints diff --git a/content/docs-lite/en/docs/AboutopenGauss/pseudocolumn-rownum.md b/content/docs-lite/en/docs/AboutopenGauss/pseudocolumn-rownum.md index 87c02c9354ec1ab8d723451e5aa84edd75e42bda..cf5f5abc580a88376599f7d2729fc4d34cd87773 100644 --- a/content/docs-lite/en/docs/AboutopenGauss/pseudocolumn-rownum.md +++ b/content/docs-lite/en/docs/AboutopenGauss/pseudocolumn-rownum.md @@ -24,6 +24,8 @@ During internal execution, the optimizer rewrites ROWNUM into LIMIT to accelerat ## Constraints - Do not use the pseudocolumn ROWNUM as an alias to avoid ambiguity in SQL statements. +- Do not use ROWNUM as the column name when creating a table. Bad example: **create table table\_name\(rownum int\);** +- Do not use ROWNUM as the column name when creating a type. Bad example: **create type type\_name\(a int, rownum int\);** - Do not use ROWNUM when creating an index. Bad example: **create index index\_name on table\(rownum\);** - Do not use ROWNUM as the default value when creating a table. Bad example: **create table table\_name\(id int default rownum\);** - Do not use ROWNUM as an alias in the WHERE clause. Bad example: **select rownum rn from table where rn < 5;** diff --git a/content/docs-lite/en/docs/AboutopenGauss/support-for-functions-and-stored-procedures.md b/content/docs-lite/en/docs/AboutopenGauss/support-for-functions-and-stored-procedures.md index 7992b60bb0f9bc921481a85b997963ffcac23a22..80ae86b6b818f0c8af953c283febbef4fe0a7d6f 100644 --- a/content/docs-lite/en/docs/AboutopenGauss/support-for-functions-and-stored-procedures.md +++ b/content/docs-lite/en/docs/AboutopenGauss/support-for-functions-and-stored-procedures.md @@ -20,11 +20,19 @@ openGauss supports functions and stored procedures compliant with the SQL stand ## Enhancements -None. +Support for nested arrays in PL/SQL. + +Support for using default argument values for cursors in PL/SQL. + +Support for getting the type of a row of records in a table, view, or cursor by ROWTYPE in PL/SQL. ## Constraints -None. +Not supportted to call functions by a nested array's array-type element referred by suscripts. + +Not supportted to assign a nested array's array-type element directly. + +Can't get the type of a nested cursor by ROWTYPE. ## Dependencies diff --git a/content/docs-lite/en/docs/Appendix/glossary.md b/content/docs-lite/en/docs/Appendix/glossary.md index 3f6722430e6eba737cf814a85bc8dea2be3ef694..4e73d663bbd86f3ba6ed8a623fe7bbcab5b22a8b 100644 --- a/content/docs-lite/en/docs/Appendix/glossary.md +++ b/content/docs-lite/en/docs/Appendix/glossary.md @@ -355,7 +355,7 @@

logical replication slot

-

In a logical replication process, logic replication slots are used to prevent Xlogs from being reclaimed by the system or VACCUM. A logical replication slot in openGauss is an object that records logical decoding positions. It can be created, deleted, read, and pushed by invoking SQL functions.

+

In a logical replication process, logic replication slots are used to prevent Xlogs from being reclaimed by the system or VACUUM. A logical replication slot in openGauss is an object that records logical decoding positions. It can be created, deleted, read, and pushed by invoking SQL functions.

MVCC

diff --git a/content/docs-lite/en/docs/BriefTutorial/appendix-sql-syntax.md b/content/docs-lite/en/docs/BriefTutorial/appendix-sql-syntax.md index 8aad39f8cf09f85c71f1ccc504966bf2a2d65dd7..df5e47ac04793acb1a874af91a28f31f61406d80 100644 --- a/content/docs-lite/en/docs/BriefTutorial/appendix-sql-syntax.md +++ b/content/docs-lite/en/docs/BriefTutorial/appendix-sql-syntax.md @@ -620,6 +620,7 @@ where column_constraint can be: ENCRYPTED WITH ( COLUMN_ENCRYPTION_KEY = column_encryption_key, ENCRYPTION_TYPE = encryption_type_value ) | REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } + [ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where compress_mode can be: { DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS } @@ -631,6 +632,7 @@ where table_constraint can be: PARTIAL CLUSTER KEY ( column_name [, ... ] ) | FOREIGN KEY ( column_name [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } + [ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where index_parameters can be: [ WITH ( {storage_parameter = value} [, ... ] ) ] @@ -638,6 +640,7 @@ where index_parameters can be: where table_constraint_using_index can be: [ CONSTRAINT constraint_name ] { UNIQUE | PRIMARY KEY } USING INDEX index_name + [ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] ``` @@ -1544,7 +1547,7 @@ CREATE SERVER server_name Creates a synonym object. A synonym is an alias of a database object and is used to record the mapping between database object names. You can use synonyms to access associated database objects. ``` -CREATE [ OR REPLACE ] SYNONYM synonym_name +CREATE [ OR REPLACE ] [ PUBLIC ] SYNONYM synonym_name FOR object_name; ``` @@ -1575,6 +1578,7 @@ where column_constraint can be: ENCRYPTED WITH ( COLUMN_ENCRYPTION_KEY = column_encryption_key, ENCRYPTION_TYPE = encryption_type_value ) | REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } +[ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where table_constraint can be: [ CONSTRAINT constraint_name ] @@ -1584,6 +1588,7 @@ where table_constraint can be: PARTIAL CLUSTER KEY ( column_name [, ... ] ) | FOREIGN KEY ( column_name [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } +[ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where compress_mode can be: { DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS } @@ -1646,6 +1651,7 @@ where column_constraint can be: PRIMARY KEY index_parameters | REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } +[ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where table_constraint can be: [ CONSTRAINT constraint_name ] @@ -1654,6 +1660,7 @@ where table_constraint can be: PRIMARY KEY ( column_name [, ... ] ) index_parameters | FOREIGN KEY ( column_name [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } +[ ENABLE [VALIDATE | NOVALIDATE] | DISABLE [VALIDATE | NOVALIDATE] ] [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] where index_parameters can be: [ WITH ( {storage_parameter = value} [, ... ] ) ] @@ -2101,7 +2108,7 @@ DROP SERVER [ IF EXISTS ] server_name [ { CASCADE | RESTRICT } ] ; Deletes a synonym. ``` -DROP SYNONYM [ IF EXISTS ] synonym_name [ CASCADE | RESTRICT ]; +DROP [ PUBLIC ] SYNONYM [ IF EXISTS ] synonym_name [ CASCADE | RESTRICT ]; ``` ## DROP TABLE @@ -2638,7 +2645,7 @@ SELECT [/*+ plan_hint */] [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] [ ORDER BY {expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ]} [, ...] ] [ LIMIT { [offset,] count | ALL } ] [ OFFSET start [ ROW | ROWS ] ] - [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ] + [ FETCH { FIRST | NEXT } [ count ] [ PERCENT ] { ROW | ROWS } { ONLY | WITH TIES } ] [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; TABLE { ONLY {(table_name)| table_name} | table_name [ * ]}; @@ -2683,7 +2690,7 @@ SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] [ ORDER BY {expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ]} [, ...] ] [ LIMIT { count | ALL } ] [ OFFSET start [ ROW | ROWS ] ] - [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ] + [ FETCH { FIRST | NEXT } [ count ] [ PERCENT ] { ROW | ROWS } { ONLY | WITH TIES } ] [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` @@ -2807,6 +2814,6 @@ VALUES {( expression [, ...] )} [, ...] [ ORDER BY {sort_expression [ ASC | DESC | USING operator ]} [, ...] ] [ LIMIT { count | ALL } ] [ OFFSET start [ ROW | ROWS ] ] - [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]; + [ FETCH { FIRST | NEXT } [ count ] [ PERCENT ] { ROW | ROWS } { ONLY | WITH TIES } ]; ``` diff --git a/content/docs-lite/en/docs/BriefTutorial/functions.md b/content/docs-lite/en/docs/BriefTutorial/functions.md index 72f89e71e0986cd12effb90b6755599fbcb96a1b..26a650552684b7f34aeb97206ab3936b21c4f952 100644 --- a/content/docs-lite/en/docs/BriefTutorial/functions.md +++ b/content/docs-lite/en/docs/BriefTutorial/functions.md @@ -1099,9 +1099,19 @@ The common functions of openGauss are as follows: ``` -- to\_number\(text, text\) +- to\_number ( expr \[ DEFAULT return_value ON CONVERSION ERROR ] [, fmt]) - Description: Converts the values of the string type into the numbers in the specified format. + Description: Converts expr to a NUMERIC type value according to the specified format. If the expr conversion fails, it will attempt to convert the return_value after the keyword DEFAULT (the input format of return_value is constrained by fmt). + + * The length of the integer part in fmt must be greater than the length of the integer part in expr. If it is less, an error will be thrown. The length of the fractional part in fmt can be filled as needed, and the result will be truncated according to the length of the fractional part in fmt. + + * Both expr and the return_value after DEFAULT support implicit conversion. (Note: NULL plus any value equals NULL.) + + * Scientific notation is supported. + + * When converting a hexadecimal string to a decimal number, the function supports up to 16 bytes of hexadecimal string to be converted into an unsigned number. + + * When converting a hexadecimal string to a decimal number, the format string should not contain any characters other than 'x' or 'X', otherwise, an error will be thrown. Return type: numeric @@ -1109,44 +1119,136 @@ The common functions of openGauss are as follows: ``` openGauss=# SELECT to_number('12,454.8-', '99G999D9S'); - to_number + to_number ----------- -12454.8 (1 row) ``` + ``` + openGauss=# SELECT to_number('1234.123','999999.99'); + to_number + ----------- + 1234.12 + (1 row) + ``` + ``` + openGauss=# SELECT to_number('111111.111'+'1111','999999.99'); + to_number + ----------- + 112222.11 + (1 row) + ``` + ``` + openGauss=# SELECT to_number('1e5'+'1111','999999.99'); + to_number + ----------- + 101111 + (1 row) + ``` + ``` + openGauss=# SELECT to_number('111111.111'+'1111'+NULL,'999999. 99'); + to_number + ----------- + (1 row) + ``` + ``` + openGauss=# SELECT to_number('此参数错误' default 321456231 on conversion error ,'999,999,999,999.99'); + to_number + ----------- + 321456231 + (1 row) + ``` -- to\_timestamp\(text, text\) +- to\_timestamp(double precision\) - Description: Converts values of the string type into the timestamp of the specified type. + Description: Converts a UNIX century into a timestamp. - Return type: timestamp + Return type: timestamp with time zone Example: ``` - openGauss=# SELECT to_timestamp('05 Dec 2000', 'DD Mon YYYY'); - to_timestamp - --------------------- - 2000-12-05 00:00:00 + openGauss=# SELECT to_timestamp(1284352323); + to_timestamp + ------------------------ + 2010-09-13 12:32:03+08 (1 row) ``` +- to\_timestamp(string [ DEFAULT return_value ON CONVERSION ERROR ] \[ , fmt [, 'nlsparam' ] ]\) -- to\_timestamp\(double precision\) - - Description: Converts a UNIX century into a timestamp. + Description: Converts a string to a timestamp. The default input format is [DD-Mon-YYYY HH12:MI:SS.FF], which is a 12-hour AM format. If the input value string is not in the default format, the user needs to specify their own format in fmt. If the format description is incorrect, an error will be thrown. If part of the string conversion fails, it will attempt to convert the return_value after the keyword DEFAULT (the input format of return_value is constrained by fmt). If Mon is an abbreviation like Jan, the language for the month can be set in nlsparam (currently only supports American and English). + * If the input year YYYY=0, the system will throw an error. + * If the input year YYYY<0, and SYYYY is specified in fmt, it will correctly output the absolute value of the year BC. + * Parameters in fmt that are similar to MM cannot mix case. + * The delimiters in fmt and the time information in string can be replaced with other symbols. Example: SELECT to_timestamp('05*Dec^2000', 'DD Mon+YYYY'); + Return type: timestamp with time zone Example: ``` - openGauss=# SELECT to_timestamp(1284352323); + openGauss=# SHOW nls_timestamp_format; + nls_timestamp_format + ---------------------------- + DD-Mon-YYYY HH:MI:SS.FF AM + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp('12-sep-2014'); + to_timestamp + --------------------- + 2014-09-12 00:00:00 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp ('01-Jan-2002 10:10:10. 123000'); + to_timestamp + ------------------------- + 2002-01-01 10:10:10.123 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp ('2002-01-01 10:10:10.123000', 'YYYY-MM-DD HH24:MI:SS.FF'); + to_timestamp + ------------------------- + 2002-01-01 10:10:10.123 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp ('此为错误输入' DEFAULT '11-01-11 14:10:10.123000' ON CONVERSION ERROR,'DD-MM-RR HH24:MI:SS.FF'); + to_timestamp + ------------------------- + 2011-01-11 14:10:10.123 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp ('01-Jan-03 14:10:10.123000' DEFAULT '11-Jan-11 14:10:10.123000' ON CONVERSION ERROR, 'DD-Mon-RR HH24:MI:SS.FF','NLS_DATE_LANGUAGE = American'); + to_timestamp + ------------------------- + 2003-01-01 14:10:10.123 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp('-1','SYYYY'); to_timestamp ------------------------ - 2010-09-13 12:32:03+08 + 0001-01-01 00:00:00 BC + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp('05 Dec 2000', 'DD Mon YYYY'); + to_timestamp + --------------------- + 2000-12-05 00:00:00 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp('05*Dec^2000', 'DD Mon+YYYY'); + to_timestamp + --------------------- + 2000-12-05 00:00:00 (1 row) ``` - - diff --git a/content/docs-lite/en/docs/BriefTutorial/obtaining-and-verifying-an-installation-package.md b/content/docs-lite/en/docs/BriefTutorial/obtaining-and-verifying-an-installation-package.md index 49da897b6041fae6bb3296096d03b1f3e6386a4d..d9917cc27d7d55e80fb71781daa22a486c19247a 100644 --- a/content/docs-lite/en/docs/BriefTutorial/obtaining-and-verifying-an-installation-package.md +++ b/content/docs-lite/en/docs/BriefTutorial/obtaining-and-verifying-an-installation-package.md @@ -12,7 +12,7 @@ ``` mkdir openGauss - tar -jxf openGauss-x.x.x-openEuler-64bit.tar.bz2 –C openGauss + tar -jxf openGauss-Server-x.x.x-openEuler20.03-x86_64.tar.bz2 –C openGauss ls -lb openGauss/ ``` diff --git a/content/docs-lite/en/docs/BriefTutorial/operators.md b/content/docs-lite/en/docs/BriefTutorial/operators.md index e8d7e33e4a750fdde3e903ff3fe614ff901ceeca..cd964710d14bc86256be010bad30636479b1076d 100644 --- a/content/docs-lite/en/docs/BriefTutorial/operators.md +++ b/content/docs-lite/en/docs/BriefTutorial/operators.md @@ -156,6 +156,8 @@ An operator in openGauss is a reserved keyword or character, and it is generally Description: Factorial + WARNING: unsupported in b compatibility mode + Example: ``` @@ -170,6 +172,8 @@ An operator in openGauss is a reserved keyword or character, and it is generally Description: Factorial \(prefix operator\) + WARNING: unsupported in b compatibility mode + Example: ``` diff --git a/content/docs-lite/en/docs/BriefTutorial/stored-procedures.md b/content/docs-lite/en/docs/BriefTutorial/stored-procedures.md index b3114e2ce38634551785136ca28976188307328c..6d2558d42de7efa5d104151c68f71e9333ce3d0f 100644 --- a/content/docs-lite/en/docs/BriefTutorial/stored-procedures.md +++ b/content/docs-lite/en/docs/BriefTutorial/stored-procedures.md @@ -27,7 +27,8 @@ A stored procedure is a set of SQL statements that can implement a specific func - Delete a stored procedure. ``` - DROP PROCEDURE procedure_name ; + DROP PROCEDURE [ IF EXISTS ] procedure_name + [ ( [ {[ argname ] [ argmode ] argtype} [, ...] ] ) [ CASCADE | RESTRICT ] ]; ``` diff --git a/content/docs-lite/en/docs/BriefTutorial/type-conversion-functions.md b/content/docs-lite/en/docs/BriefTutorial/type-conversion-functions.md index b0bfb3b276b7ac2dbe17159718046a5818cb599d..c31c6387b65890a5a288a8bea0d9e90325178094 100644 --- a/content/docs-lite/en/docs/BriefTutorial/type-conversion-functions.md +++ b/content/docs-lite/en/docs/BriefTutorial/type-conversion-functions.md @@ -118,6 +118,7 @@ - The optional parameter **fmt** allows for the following types: date, time, week, quarter, and century. Each type has a unique template. The templates can be combined together. Common templates include HH, MI, SS, YYYY, MM, and DD. - A template may have a modification word. FM is a common modification word and is used to suppress the preceding zero or the following blank spaces. + - **Only on dbcompatibility = 'A'**，When the input is interval, the **fmt** will be ignored. If the interval only includes year and month, the output format will be SYYYY-MM. When the year is less than two digits, it will be padded with a leading zero. If the interval only includes day and time, the output format will be SDD HH:MI:SS. If the interval contains both, an error code will be returned. Return type: text @@ -139,6 +140,24 @@ (1 row) ``` +- to\_char\(datetime/interval, fmt, nls_language={american|english}\) + + Description: Similar to to\_char\(datetime/interval \[, fmt\]\)，, an additional parameter **nls_language**. The possible values for **nls_language** are **american** and **english**. + + - Templates like MON in fmt will be converted to the corresponding language expression based on nls_language. + + Return type: text + + Example: + + ``` + openGauss=# SELECT to_char(DATE '2024-08-05', 'DY, DD-MON-YYYY', 'NLS_DATE_LANGUAGE = ENGLISH') ; + to_char + ---------- + MON, 05-AUG-2024 + (1 row) + ``` + - to\_char\(double precision/real, text\) Description: Converts the values of the floating point type into the strings in the specified format. @@ -203,6 +222,8 @@ Description: Converts the values of the time interval type into the strings in the specified format. + - **Only on dbcompatibility = 'A'**，When the input is interval, the **fmt** will be ignored. If the interval only includes year and month, the output format will be SYYYY-MM. When the year is less than two digits, it will be padded with a leading zero. If the interval only includes day and time, the output format will be SDD HH:MI:SS. If the interval contains both, an error code will be returned. + Return type: text Example: @@ -215,6 +236,21 @@ (1 row) ``` + ``` + openGauss=# SELECT to_char(INTERVAL '123-2' YEAR(4) TO MONTH, 'YYY-MON'); + to_char + --------- + +123-02 + (1 row) + ``` + + ``` + openGauss=# SELECT to_char(INTERVAL '1 year 2 months 3 days', 'YYYY-MON-DD') ; + ERROR: Interval simultaneously includes 'year to month' and 'day to second' is not supported in A format + DETAIL: Not support the given interval data. + CONTEXT: referenced column: to_char + ``` + - to\_char\(int, text\) Description: Converts the values of the integer type into the strings in the specified format. @@ -281,6 +317,34 @@ (1 row) ``` +- to\_char\(blob, \[CSID\]\) + + Description: **Only on dbcompatibility = 'A'** support the function，convert blob type data to text by specified **CSID**. + + - **CSID** type is int，denote A format character ID. + - CSID equal to 0 or without CSID, use database's encoding. + + Return type: text + + Example: + + ``` + CREATE TABLE blob_table (c1 BLOB); + INSERT INTO blob_table (c1) VALUES ( (encode('Hello World!','hex'))::RAW ); + SELECT to_char(c1, 873) FROM blob_table ; + to_char + -------------- + Hello World! + (1 row) + + SELECT to_char(c1) FROM blob_table ; + to_char + -------------- + Hello World! + (1 row) + + ``` + - to\_clob\(char/nchar/varchar/varchar2/nvarchar/nvarchar2/text/raw\) Description: Converts the raw type or text character set type CHAR, NCHAR, VARCHAR, VARCHAR2, NVARCHAR, NVARCHAR2, or TEXT to the CLOB type. @@ -380,17 +444,23 @@ (1 row) ``` -- to\_number \( expr \[, fmt\]\) +- to\_number ( expr \[ DEFAULT return_value ON CONVERSION ERROR ] [, fmt]) + + Description: Converts expr to a NUMERIC type value according to the specified format. If the expr conversion fails, it will attempt to convert the return_value after the keyword DEFAULT (the input format of return_value is constrained by fmt). - Description: Converts **expr** into a value of the NUMBER type according to the specified format. + * Type Conversion Formats (fmt): Please refer to [Table 1](#en-us_topic_0283137417_en-us_topic_0237121973_en-us_topic_0059778246_t3987a5bb00154b0f9e55863b4ababd3d). + + * The length of the integer part in fmt must be greater than the length of the integer part in expr. If it is less, an error will be thrown. The length of the fractional part in fmt can be filled as needed, and the result will be truncated according to the length of the fractional part in fmt. - For details about the type conversion formats, see [Table 1](#en-us_topic_0283137417_en-us_topic_0237121973_en-us_topic_0059778246_t3987a5bb00154b0f9e55863b4ababd3d). + * Both expr and the return_value after DEFAULT support implicit conversion. (Note: NULL plus any value equals NULL.) - If a hexadecimal string is converted into a decimal number, the hexadecimal string can include a maximum of 16 bytes if it is to be converted into a sign-free number. + * Scientific notation is supported. - During the conversion from a hexadecimal string to a decimal digit, the format string cannot have a character other than x or X. Otherwise, an error is reported. + * When converting a hexadecimal string to a decimal number, the function supports up to 16 bytes of hexadecimal string to be converted into an unsigned number. - Return type: number + * When converting a hexadecimal string to a decimal number, the format string should not contain any characters other than 'x' or 'X'; otherwise, an error will be thrown. + + Return type: numeric Example: @@ -401,22 +471,40 @@ -12454.8 (1 row) ``` - -- to\_number\(text, text\) - - Description: Converts the values of the string type into the numbers in the specified format. - - Return type: numeric - - Example: - ``` - openGauss=# SELECT to_number('12,454.8-', '99G999D9S'); - to_number + openGauss=# SELECT to_number('1234.123','999999.99'); + to_number ----------- - -12454.8 + 1234.12 + (1 row) + ``` + ``` + openGauss=# SELECT to_number('111111.111'+'1111','999999.99'); + to_number + ----------- + 112222.11 + (1 row) + ``` + ``` + openGauss=# SELECT to_number('1e5'+'1111','999999.99'); + to_number + ----------- + 101111 (1 row) ``` + ``` + openGauss=# SELECT to_number('111111.111'+'1111'+NULL,'999999. 99'); + to_number + ----------- + (1 row) + ``` + ``` + openGauss=# SELECT to_number('此参数错误' default 321456231 on conversion error ,'999,999,999,999.99'); + to_number + ----------- + 321456231 + (1 row) + ``` - to\_timestamp\(double precision\) @@ -434,18 +522,16 @@ (1 row) ``` -- to\_timestamp\(string \[,fmt\]\) - - Description: Converts a string into a value of the timestamp type according to the format specified by **fmt**. When **fmt** is not specified, perform the conversion according to the format specified by **nls\_timestamp\_format**. - - In **to\_timestamp** in openGauss, +- to\_timestamp(string [ DEFAULT return_value ON CONVERSION ERROR ] \[ , fmt [, 'nlsparam' ] ]\) - - If the input year *YYYY* is 0, an error will be reported. - - If the input year *YYYY* is less than 0, specify *SYYYY* in **fmt**. The year with the value of n \(an absolute value\) BC will be output correctly. + Description: Converts a string to a timestamp. The default input format is [DD-Mon-YYYY HH12:MI:SS.FF], which is a 12-hour AM format. If the input value string is not in the default format, the user needs to specify their own format in fmt. If the format description is incorrect, an error will be thrown. If part of the string conversion fails, it will attempt to convert the return_value after the keyword DEFAULT (the input format of return_value is constrained by fmt). If Mon is an abbreviation like Jan, the language for the month can be set in nlsparam (currently only supports American and English). - Characters in the **fmt** must match the schema for formatting the data and time. Otherwise, an error is reported. - - Return type: timestamp without time zone + * If the input year YYYY=0, the system will throw an error. + * If the input year YYYY<0, and SYYYY is specified in fmt, it will correctly output the absolute value of the year BC. + * Parameters in fmt that are similar to MM cannot mix case. + * The delimiters in fmt and the time information in string can be replaced with other symbols. Example: SELECT to_timestamp('05*Dec^2000', 'DD Mon+YYYY'); + + Return type: timestamp with time zone Example: @@ -455,54 +541,49 @@ ---------------------------- DD-Mon-YYYY HH:MI:SS.FF AM (1 row) - + ``` + ``` openGauss=# SELECT to_timestamp('12-sep-2014'); to_timestamp --------------------- 2014-09-12 00:00:00 (1 row) ``` - ``` - openGauss=# SELECT to_timestamp('12-Sep-10 14:10:10.123000','DD-Mon-YY HH24:MI:SS.FF'); + openGauss=# SELECT to_timestamp ('01-Jan-2002 10:10:10. 123000'); + to_timestamp + ------------------------- + 2002-01-01 10:10:10.123 + (1 row) + ``` + ``` + openGauss=# SELECT to_timestamp ('2002-01-01 10:10:10.123000', 'YYYY-MM-DD HH24:MI:SS.FF'); to_timestamp ------------------------- - 2010-09-12 14:10:10.123 + 2002-01-01 10:10:10.123 (1 row) ``` - ``` - openGauss=# SELECT to_timestamp('-1','SYYYY'); - to_timestamp - ------------------------ - 0001-01-01 00:00:00 BC + openGauss=# SELECT to_timestamp ('此为错误输入' DEFAULT '11-01-11 14:10:10.123000' ON CONVERSION ERROR,'DD-MM-RR HH24:MI:SS.FF'); + to_timestamp + ------------------------- + 2011-01-11 14:10:10.123 (1 row) ``` - ``` - openGauss=# SELECT to_timestamp('98','RR'); - to_timestamp - --------------------- - 1998-01-01 00:00:00 + openGauss=# SELECT to_timestamp ('01-Jan-03 14:10:10.123000' DEFAULT '11-Jan-11 14:10:10.123000' ON CONVERSION ERROR, 'DD-Mon-RR HH24:MI:SS.FF','NLS_DATE_LANGUAGE = American'); + to_timestamp + ------------------------- + 2003-01-01 14:10:10.123 (1 row) ``` - ``` - openGauss=# SELECT to_timestamp('01','RR'); - to_timestamp - --------------------- - 2001-01-01 00:00:00 + openGauss=# SELECT to_timestamp('-1','SYYYY'); + to_timestamp + ------------------------ + 0001-01-01 00:00:00 BC (1 row) ``` - -- to\_timestamp\(text, text\) - - Description: Converts values of the string type into the timestamp of the specified type. - - Return type: timestamp - - Example: - ``` openGauss=# SELECT to_timestamp('05 Dec 2000', 'DD Mon YYYY'); to_timestamp @@ -510,6 +591,13 @@ 2000-12-05 00:00:00 (1 row) ``` + ``` + openGauss=# SELECT to_timestamp('05*Dec^2000', 'DD Mon+YYYY'); + to_timestamp + --------------------- + 2000-12-05 00:00:00 + (1 row) + ``` **Table 1** Template patterns for numeric formatting diff --git a/content/docs-lite/en/docs/DataBaseReference/flashback.md b/content/docs-lite/en/docs/DataBaseReference/flashback.md index a82ac23adc4fe18838f1c2ecdd4fb5eaee4b7b14..45be1566922d1b61a907dccd8c39b6358a7b0fa8 100644 --- a/content/docs-lite/en/docs/DataBaseReference/flashback.md +++ b/content/docs-lite/en/docs/DataBaseReference/flashback.md @@ -14,7 +14,8 @@ This parameter is a SIGHUP parameter. Set it based on instructions provided in ## recyclebin\_retention\_time -**Parameter description**: Specifies the retention period of objects in the recycle bin. The objects will be automatically deleted after the retention period expires. +**Parameter description**: Specifies the retention period of objects in the recycle bin. The objects will be automatically deleted after the retention period expires. The expired +objects cannot be used to do flashback operations. This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](../DatabaseAdministrationGuide/resetting-parameters.md#en-us_topic_0283137176_en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). diff --git a/content/docs-lite/en/docs/DataBaseReference/gs_wlm_user_resource_history.md b/content/docs-lite/en/docs/DataBaseReference/gs_wlm_user_resource_history.md index e1a0f2e90b0f5f55013fade1b80840f453212209..a1e73aed2e781972a9f530d04deefea09cf499c2 100644 --- a/content/docs-lite/en/docs/DataBaseReference/gs_wlm_user_resource_history.md +++ b/content/docs-lite/en/docs/DataBaseReference/gs_wlm_user_resource_history.md @@ -31,7 +31,7 @@

integer

-

Size of the memory being used, in MB

+

Size of the memory being used(The total size of memory used by the user's current active session. If no business is running or the session has ended, the dynamic memory will be automatically reclaimed, resulting in a size of 0.), in MB

total_memory

@@ -45,7 +45,7 @@

real

-

Number of CPU cores in use

+

Number of CPU cores in use. CPU usage data is collected only in complex jobs, and the value is the CPU usage of the related Cgroup.

total_cpu

@@ -73,70 +73,70 @@

bigint

-

Used temporary storage space, in KB

+

Used temporary storage space(Reserved field, not in use yet.),, in KB

total_temp_space

bigint

-

Available temporary storage space, in KB. The value –1 indicates that the maximum temporary storage space is not limited.

+

Available temporary storage space(Reserved field, not in use yet.),, in KB. The value –1 indicates that the maximum temporary storage space is not limited.

used_spill_space

bigint

-

Used space of operator flushing, in KB

+

Used space of operator flushing(Reserved field, not in use yet.),, in KB

total_spill_space

bigint

-

Available storage space for operator flushing, in KB. The value –1 indicates that the maximum operator flushing space is not limited.

+

Available storage space for operator flushing(Reserved field, not in use yet.),, in KB. The value –1 indicates that the maximum operator flushing space is not limited.

read_kbytes

bigint

-

Byte traffic of read operations in a monitoring period, in KB

+

Byte traffic of read operations in a monitoring period(Not supported currently, available only in distributed mode.), in KB

write_kbytes

bigint

-

Byte traffic of write operations in a monitoring period, in KB

+

Byte traffic of write operations in a monitoring period(Not supported currently, available only in distributed mode.), in KB

read_counts

bigint

-

Number of read operations in a monitoring period

+

Number of read operations in a monitoring period(Not supported currently, available only in distributed mode.)

write_counts

bigint

-

Number of write operations in a monitoring period

+

Number of write operations in a monitoring period(Not supported currently, available only in distributed mode.)

read_speed

real

-

Byte rate of read operations in a monitoring period, in KB/s

+

Byte rate of read operations in a monitoring period(Not supported currently, available only in distributed mode.), in KB/s

write_speed

real

-

Byte rate of write operations in a monitoring period, in KB/s

+

Byte rate of write operations in a monitoring period(Not supported currently, available only in distributed mode.), in KB/s

diff --git a/content/docs-lite/en/docs/DataBaseReference/pg_constraint.md b/content/docs-lite/en/docs/DataBaseReference/pg_constraint.md index 9b110e8cb80d08385690e69bf5bcd0a50d6ad232..938c24e1fc8d043e95fc209db3e3f3c9e6dc3e55 100644 --- a/content/docs-lite/en/docs/DataBaseReference/pg_constraint.md +++ b/content/docs-lite/en/docs/DataBaseReference/pg_constraint.md @@ -212,6 +212,13 @@

Not for constraint, but will be included in the attribute column of INDEX.

+

condisable

+ +

boolean

+ +

Whether the constraint is disable Currently, it can be set to true only for primary key, unique and check constraints.

+ + diff --git a/content/docs-lite/en/docs/DataBaseReference/pg_synonym.md b/content/docs-lite/en/docs/DataBaseReference/pg_synonym.md index cd12e66184a5e4bc79c4da279c47fb93ea54623f..f22221407e384fe92e7389dcca9b5338ffc45a70 100644 --- a/content/docs-lite/en/docs/DataBaseReference/pg_synonym.md +++ b/content/docs-lite/en/docs/DataBaseReference/pg_synonym.md @@ -31,7 +31,7 @@

oid

-

OID of the namespace that contains a synonym

+

OID of the namespace that contains a synonym. 0 if the synonym is a public synonym

synowner

diff --git a/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info.md b/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info.md index 5dbe0b92f1219d6b4755bd93e68a4095c2664e20..6356c671eea406447b11a8e8b263b9a4ba2e53b3 100644 --- a/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info.md +++ b/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info.md @@ -24,7 +24,7 @@

integer

-

Used memory, in MB

+

Used memory(The total size of memory used by the user's current active session. If no business is running or the session has ended, the dynamic memory will be automatically reclaimed, resulting in a size of 0.), in MB

total_memory

@@ -66,28 +66,28 @@

bigint

-

Used temporary space, in KB

+

Used temporary space(Reserved field, not in use yet.), in KB

total_temp_space

bigint

-

Total available temporary space, in KB (-1 if the temporary space is not limited)

+

Total available temporary space(Reserved field, not in use yet.), in KB (-1 if the temporary space is not limited)

used_spill_space

bigint

-

Size of the used operator flushing space, in KB

+

Size of the used operator flushing space(Reserved field, not in use yet.), in KB

total_spill_space

bigint

-

Total size of the available operator flushing space, in KB (-1 if the space is not limited)

+

Total size of the available operator flushing space(Reserved field, not in use yet.), in KB (-1 if the space is not limited)

read_kbytes

@@ -96,6 +96,7 @@

Primary database node: total bytes read by the user's complex jobs on all database nodes in the last 5 seconds, in KB

Database node: total bytes read by the user's complex jobs from the instance startup time to the current time, in KB

+

Not supported currently, available only in distributed mode.

write_kbytes

@@ -104,6 +105,7 @@

Primary database node: total bytes written by the user's complex jobs on all database nodes in the last 5 seconds, in KB

Database node: total bytes written by the user's complex jobs from the instance startup time to the current time, in KB

+

Not supported currently, available only in distributed mode.

read_counts

@@ -112,6 +114,7 @@

Primary database node: total number of read times of the user's complex jobs on all database nodes in the last 5 seconds

Database node: total number of read times of the user's complex jobs from the instance startup time to the current time

+

Not supported currently, available only in distributed mode.

write_counts

@@ -120,6 +123,7 @@

Primary database node: total number of write times of the user's complex jobs on all database nodes in the last 5 seconds

Database node: total number of write times of the user's complex jobs from the instance startup time to the current time

+

Not supported currently, available only in distributed mode.

read_speed

@@ -128,6 +132,7 @@

Primary database node: average read rate of the user's complex jobs on a single database node in the last 5 seconds, in KB/s

Database node: average read rate of the user's complex jobs on the database node in the last 5 seconds, in KB/s

+

Not supported currently, available only in distributed mode.

write_speed

@@ -136,6 +141,7 @@

Primary database node: average write rate of the user's complex jobs on a single database node in the last 5 seconds, in KB/s

Database node: average write rate of the user's complex jobs on the database node in the last 5 seconds, in KB/s

+

Not supported currently, available only in distributed mode.

diff --git a/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info_oid.md b/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info_oid.md index ace708cec0e67644fad8c62c8908d0a226133ae5..e5f000d45582ee274399b84a9569eb8a10f5256e 100644 --- a/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info_oid.md +++ b/content/docs-lite/en/docs/DataBaseReference/pg_total_user_resource_info_oid.md @@ -24,7 +24,7 @@

integer

-

Size of the memory being used, in MB.

+

Size of the memory being used(The total size of memory used by the user's current active session. If no business is running or the session has ended, the dynamic memory will be automatically reclaimed, resulting in a size of 0.), in MB.

total_memory

@@ -38,7 +38,7 @@

double precision

-

Number of CPU cores in use.

+

Number of CPU cores in use. CPU usage data is collected only in complex jobs, and the value is the CPU usage of the related Cgroup.

total_cpu

@@ -66,70 +66,70 @@

bigint

-

Used temporary storage space, in KB.

+

Used temporary storage space(Reserved field, not in use yet.), in KB.

total_temp_space

bigint

-

Total available temporary space, in KB (-1 if the temporary space is not limited).

+

Total available temporary space(Reserved field, not in use yet.), in KB (-1 if the temporary space is not limited).

used_spill_space

bigint

-

Used disk space for spilling, in KB.

+

Used disk space for spilling(Reserved field, not in use yet.), in KB.

total_spill_space

bigint

-

Total available disk space for spilling, in KB. The value -1 indicates that the space is not limited.

+

Total available disk space for spilling(Reserved field, not in use yet.), in KB. The value -1 indicates that the space is not limited.

read_kbytes

bigint

-

Amount of data read from the disk, in KB.

+

Amount of data read from the disk(Not supported currently, available only in distributed mode.), in KB.

write_kbytes

bigint

-

Amount of data written to the disk, in KB.

+

Amount of data written to the disk(Not supported currently, available only in distributed mode.), in KB.

read_counts

bigint

-

Number of disk read times.

+

Number of disk read times(Not supported currently, available only in distributed mode.).

write_counts

bigint

-

Number of disk write times.

+

Number of disk write times(Not supported currently, available only in distributed mode.).

read_speed

double precision

-

Disk read rate, in B/ms.

+

Disk read rate(Not supported currently, available only in distributed mode.), in B/ms.

write_speed

double precision

-

Disk write rate, in B/ms.

+

Disk write rate(Not supported currently, available only in distributed mode.), in B/ms.

diff --git a/content/docs-lite/en/docs/DataBaseReference/platform-and-client-compatibility.md b/content/docs-lite/en/docs/DataBaseReference/platform-and-client-compatibility.md index acfbcc124f5a151abe90467ec984ebf4c5722cb1..e439d610b1bd11ee738e921804e8150ed014a222 100644 --- a/content/docs-lite/en/docs/DataBaseReference/platform-and-client-compatibility.md +++ b/content/docs-lite/en/docs/DataBaseReference/platform-and-client-compatibility.md @@ -28,16 +28,6 @@ This parameter is a USERSET parameter. Set it based on instructions provided in **Default value**: **DD-Mon-YYYY HH:MI:SS.FF AM** -## nls\_length\_semantics - -**Parameter description:**：Set the default semantics of the string type, set it to BYTE, calculate the string length by bytes, and set it to CHAR, calculate the string length by characters. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](../DatabaseAdministrationGuide/resetting-parameters.md#en-us_topic_0283137176_en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**：a string - -**Default value**：BYTE - ## max\_function\_args **Parameter description**: Specifies the maximum number of parameters allowed for a function. @@ -272,6 +262,46 @@ numeric

Determines the behavior when char(n) types are converted to other variable-length string types. By default, spaces at the end are omitted when the char(n) type is converted to other variable-length string types. After this parameter is enabled, spaces at the end are not omitted during conversion. In addition, if the length of the char(n) type exceeds the length of other variable-length string types, an error is reported. This parameter is valid only when sql_compatibility is set to A.

+

disable_record_type_in_dml

+

Prohibit inserting virtual columns. After enabling this option will prohibit to use record type variables as insertion values in insert statements.

+

+create table t1(col1 varchar(10),col varchar(10));
+create table t2(col1 varchar(10),col varchar(10));
+set behavior_compat_options='disable_record_type_in_dml';
+insert into t1 values('one','two');
+declare
+  cursor cur1 is select * from t1;
+  source cur1%rowtype:=('ten','wtu');
+begin
+  for source in cur1
+  loop
+    raise notice '%',source;
+    insert into t2 values(source);
+  end loop; 
+end;
+/
+ERROR:  The record type variable cannot be used as an insertion value.
+CONTEXT:  SQL statement "insert into t2 values(source)"
+PL/pgSQL function inline_code_block line 7 at SQL statement
+
+set behavior_compat_options='';
+insert into t1 values('one','two');
+declare
+  cursor cur1 is select * from t1;
+  source cur1%rowtype:=('ten','wtu');
+begin
+  for source in cur1
+  loop
+    raise notice '%',source;
+    insert into t2 values(source);
+  end loop; 
+end;
+/
+NOTICE:  (one,two)
+NOTICE:  (one,two)
+
+
+
 
 
 
diff --git a/content/docs-lite/en/docs/DataBaseReference/statement-behavior.md b/content/docs-lite/en/docs/DataBaseReference/statement-behavior.md
index c26e6986412a56f45ece63af89876def6cdfb1f3..3eee6aae74454e1fed785db516270b5c8063443e 100644
--- a/content/docs-lite/en/docs/DataBaseReference/statement-behavior.md
+++ b/content/docs-lite/en/docs/DataBaseReference/statement-behavior.md
@@ -249,4 +249,18 @@ This parameter is a  **POSTMASTER**  parameter. Set it based on instructions pro
 -   **on**  indicates that case is ignored when double quotes are used.
 -   **off**  indicates that case is not ignored when double quotes are used.
 
+**Default value**:  **off**
+
+## enable\_pltype\_name\_check
+
+**Parameter description**: 
+Sets whether type name checking is performed when assigning a variable with a type name (including RECORD, VARRAY, TABLE OF types, and types created with CREATE TYPE).
+
+This parameter is a USERSET parameter. Set it based on instructions provided in  [Table 2](../DatabaseAdministrationGuide/resetting-parameters.md#en-us_topic_0283137176_en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d).
+
+**Value range**: Boolean
+
+-   **on**  Indicates check type names.
+-   **off**  Indicates do not check type names.
+
 **Default value**:  **off**
\ No newline at end of file
diff --git a/content/docs-lite/en/docs/DatabaseAdministrationGuide/querying-audit-results.md b/content/docs-lite/en/docs/DatabaseAdministrationGuide/querying-audit-results.md
index c6eb7b6f39fde0218c1d84ea9799781fd02915c7..14c8f39ed513823784f1ff56b79f806a0d8025c2 100644
--- a/content/docs-lite/en/docs/DatabaseAdministrationGuide/querying-audit-results.md
+++ b/content/docs-lite/en/docs/DatabaseAdministrationGuide/querying-audit-results.md
@@ -46,15 +46,15 @@
 3.  Run the following command to query the audit record:
 
     ```
-    openGauss=# select * from pg_query_audit('2021-03-04 08:00:00','2021-03-04 17:00:00');
+    openGauss=# select * from pg_query_audit('2024-07-12 08:00:00','2024-07-12 17:00:00');
     ```
 
     The command output is similar to the following:
 
     ```
-              time          |      type      | result | userid | username  | database  |     client_conninfo     |    object_name    |	detail_info	|     node_name     |            thread_id            | local_port | remote_port
+              time          |      type      | result | userid | username  | database  |     client_conninfo     |    object_name    |  detail_info |     node_name     |            thread_id            | local_port | remote_port | sha_code | verify_result
     ------------------------+----------------+--------+--------+-----------+-----------+-------------------------+-------------------+--------------+-------------------+---------------------------------+------------+-------------
-    2021-03-04 08:00:08+08 | login_success  | ok     | 10     | omm  | postgres | gsql@::1 | postgres    | login db(postgres) success, SSL=off | dn_6001_6002_6003 | 140477687527168@668131208211425 |17778      | 46946
+    2024-07-12 16:22:43+08 | login_success  | ok     | 10     | omm  | postgres | gsql@::1 | postgres    | login db(postgres) success,the current user is:omm, SSL=off | node1 | 139658603525888@774087763979298 |  5433      | 38964 | 73ead146da25a77ca01fc21204b74de99b55d499756438d0dc090e674d315bca | t
     ```
 
     This record indicates that user  **omm**  logs in to database  **postgres**  at the time specified by the  **time**  column. After the host specified by  **log\_hostname**  is started and a client is connected to its IP address, the host name found by reverse DNS resolution is displayed following the at sign \(@\) in the value of  **client\_conninfo**.
diff --git a/content/docs-lite/en/docs/DatabaseOMGuide/drop-truncate-flashback.md b/content/docs-lite/en/docs/DatabaseOMGuide/drop-truncate-flashback.md
index f2524215ef0adba8f7073b09adb96adbe671a941..b2ff7de864a12694a10ebd5245a6011f37120e5f 100644
--- a/content/docs-lite/en/docs/DatabaseOMGuide/drop-truncate-flashback.md
+++ b/content/docs-lite/en/docs/DatabaseOMGuide/drop-truncate-flashback.md
@@ -8,7 +8,8 @@
 ## Prerequisites
 
 -   The  **enable\_recyclebin**  parameter has been set for enabling the recycle bin.
--   The  **recyclebin\_retention\_time**  parameter has been set for specifying the retention period of objects in the recycle bin. The objects will be automatically deleted after the retention period expires.
+-   The  **recyclebin\_retention\_time**  parameter has been set for specifying the retention period of objects in the recycle bin. The objects will be automatically deleted after the retention period expires. The expired
+objects cannot be used to do flashback operations.
 
 ## Syntax
 
diff --git a/content/docs-lite/en/docs/GettingStarted/container-based-installation-on-a-single-node.md b/content/docs-lite/en/docs/GettingStarted/container-based-installation-on-a-single-node.md
index e96e4f56ef0b847864e4d79978a6c9dab66f8559..627a1d6e7dc021e6227211bca2d7f162cbae99f7 100644
--- a/content/docs-lite/en/docs/GettingStarted/container-based-installation-on-a-single-node.md
+++ b/content/docs-lite/en/docs/GettingStarted/container-based-installation-on-a-single-node.md
@@ -16,16 +16,16 @@ Use the  **buildDockerImage.sh**  script to build a Docker image. This script is
 
 >![](public_sys-resources/icon-note.gif) **NOTE:** 
 >
-> -   Before the installation, you need to provide the openGauss binary installation package. After decompressing the package, place the package \(**openGauss-***X.X.X***-CentOS-64bit.tar.bz2**\) in the  **dockerfiles/**<*version*\> folder. The binary package can be downloaded from  [https://opengauss.org/en/download/](https://opengauss.org/en/download/). Ensure that the correct yum source is available.
+> -   Before the installation, you need to provide the openGauss binary installation package. After decompressing the package, place the package \(**openGauss-Server-X.X.X-CentOS7-x86_64.tar.bz2**\) in the  **dockerfiles/**<*version*\> folder. The binary package can be downloaded from  [https://opengauss.org/en/download/](https://opengauss.org/en/download/). Ensure that the correct yum source is available.
 >
 > -   If the  **-i**  option is not specified when you run the  **buildDockerImage.sh**  script, the SHA-256 check is performed by default. You need to manually write the check result to the  **sha256\_file\_amd64**  file.
 >    ```
     ## Modify the SHA-256 verification file.
-    cd /soft/openGauss-server/docker/dockerfiles/3.0.0
-    sha256sum openGauss-3.0.0-CentOS-64bit.tar.bz2 > sha256_file_amd64 
+    cd /soft/openGauss-server/docker/dockerfiles/6.0.0
+    sha256sum openGauss-Server-X.X.X-CentOS7-x86_64.tar.bz2 > sha256_file_amd64 
 >   ```
 
-> -   Before the installation, obtain the  **openEuler\_aarch64.repo**  file from Huawei open-source image website and save it to the  **openGauss-server-master/docker/dockerfiles/3.0.0**  folder. Run the following command to obtain the  **openEuler\_aarch64.repo**  file.
+> -   Before the installation, obtain the  **openEuler\_aarch64.repo**  file from Huawei open-source image website and save it to the  **openGauss-server-master/docker/dockerfiles/6.0.0**  folder. Run the following command to obtain the  **openEuler\_aarch64.repo**  file.
 
 >    ```
    wget -O openEuler_aarch64.repo https://mirrors.huaweicloud.com/repository/conf/openeuler_aarch64.repo
@@ -39,7 +39,7 @@ Usage: buildDockerImage.sh -v [version] [-i] [Docker build option]
 Builds a Docker Image for openGauss
 Parameters:
    -v: version to build
-       Choose one of: 3.0.0
+       Choose one of: 6.0.0
    -i: ignores the SHA-256 checksums
 
 LICENSE UPL 1.0
@@ -74,26 +74,26 @@ Specifies the database port. The default value is  **5432**.
 ## Starting an Instance
 
 ```
-$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 opengauss:2.0.0
+$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 opengauss:6.0.0
 ```
 
 ## Connecting to the Database from the OS Layer
 
 ```
-$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -p8888:5432 opengauss:2.0.0
-$ gsql -d postgres -U gaussdb -W'Enmo@123' -h your-host-ip -p8888
+$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -p8888:5432 opengauss:6.0.0
+$ gsql -d postgres -U gaussdb -W'Enmo@123' -h your-host-ip -p8888  # OS need install gsql client
 ```
 
 ## Data Persistence
 
 ```
-$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss opengauss:2.0.0
+$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss opengauss:6.0.0
 ```
 
 >**Note**
 >
->1. For details about how to use a database of another version to build a container image, see the configuration file in `openGauss-server/docker/dockerfiles/3.0.0`. You only need to change the version number to the corresponding version number.
+>1. For details about how to use a database of another version to build a container image, see the configuration file in `openGauss-server/docker/dockerfiles/6.0.0`. You only need to change the version number to the corresponding version number.
 >
->2. If the `openeuler-20.03-lts:latest` image cannot be downloaded, download the container image package `openEuler-docker.aarch64.tar.xz` from the OpenEuler official website `http://121.36.97.194/openEuler-20.03-LTS/docker_img/aarch64/` and use `docker load -i openEuler-docker.aarch64.tar.xz` to import the package to the local image list.
+>2. If the `openeuler-20.03-lts:latest` image cannot be downloaded, download the container image package `openEuler-docker.aarch64.tar.xz` from the OpenEuler official website `https://repo.openeuler.org/openEuler-20.03-LTS/docker_img/aarch64/` and use `docker load -i openEuler-docker.aarch64.tar.xz` to import the package to the local image list.
 >
 >3. During the build, if the yum source download times out, check the proxy. You can also `--network host` to the end of the `docker build` command in the `buildDockerImage.sh` script to use the network of the host machine.
diff --git a/content/docs-lite/en/docs/GettingStarted/installation-on-a-single-node.md b/content/docs-lite/en/docs/GettingStarted/installation-on-a-single-node.md
index c045c63ba6d8b2d9411871318b0b54b542c33786..ed2fc8babad94bc94e1c53230e183e47bf1e9856 100644
--- a/content/docs-lite/en/docs/GettingStarted/installation-on-a-single-node.md
+++ b/content/docs-lite/en/docs/GettingStarted/installation-on-a-single-node.md
@@ -16,7 +16,7 @@
 3.  Log in to the host where the openGauss package is installed as user **omm** and decompress the openGauss package to the installation directory (for example, **/opt/software/openGauss**).
 
     ```
-    tar -jxf openGauss-x.x.x-openEuler-64bit.tar.bz2 -C /opt/software/openGauss
+    tar -jxf openGauss-Server-x.x.x-openEuler20.03-x86_64.tar.bz2 -C /opt/software/openGauss
     ```
 
 4.  Assume that the decompressed package is stored in the  **/opt/software/openGauss**  directory. Go to the  **simpleInstall**  directory.
diff --git a/content/docs-lite/en/docs/GettingStarted/obtaining-and-verifying-an-installation-package.md b/content/docs-lite/en/docs/GettingStarted/obtaining-and-verifying-an-installation-package.md
index ec7c5ec98bc79191f063fec569c4a32399b940fd..158b297cc15e93b0a1a89dbb3109de0fcf16c8c1 100644
--- a/content/docs-lite/en/docs/GettingStarted/obtaining-and-verifying-an-installation-package.md
+++ b/content/docs-lite/en/docs/GettingStarted/obtaining-and-verifying-an-installation-package.md
@@ -12,7 +12,7 @@
 
     ```
     mkdir openGauss
-    tar -jxf openGauss-x.x.x-openEuler-64bit.tar.bz2 –C openGauss
+    tar -jxf openGauss-Server-x.x.x-openEuler20.03-x86_64.tar.bz2 –C openGauss
     ls -lb openGauss/
     ```
 
diff --git a/content/docs-lite/en/docs/GettingStarted/preparing-the-software-and-hardware-installation-environment.md b/content/docs-lite/en/docs/GettingStarted/preparing-the-software-and-hardware-installation-environment.md
index d5dc946d1cc675087c485a8f03f5a36994cc9074..27128f447b3bf3b26876abc0585fbce0cf62b0b1 100644
--- a/content/docs-lite/en/docs/GettingStarted/preparing-the-software-and-hardware-installation-environment.md
+++ b/content/docs-lite/en/docs/GettingStarted/preparing-the-software-and-hardware-installation-environment.md
@@ -63,8 +63,8 @@ Both 
Linux OS

 
-