diff --git a/content/en/docs/Developerguide/binary-string-functions-and-operators.md b/content/en/docs/Developerguide/binary-string-functions-and-operators.md index ba11f0bc38426a45ab4082e48d3dab920fcd729a..b4da05f276ea6097d87ab74735011d87a3af169d 100644 --- a/content/en/docs/Developerguide/binary-string-functions-and-operators.md +++ b/content/en/docs/Developerguide/binary-string-functions-and-operators.md @@ -52,7 +52,23 @@ SQL defines some string functions that use keywords, rather than commas, to sepa (1 row) ``` -- substring\(string, from int \[,for int\]\) +- substring\(string [from int] \[for int\]\) + + Description: Truncates substring. + + Return type: bytea + + For example: + + ``` + postgres=# SELECT substring(E'Th\\000omas'::bytea from 2 for 3) AS RESULT; + result + ---------- + \x68006f + (1 row) + ``` + +- substr\(string, from int \[,for int\]\) Description: Truncates substring. diff --git a/content/en/docs/Developerguide/log-replay.md b/content/en/docs/Developerguide/log-replay.md index 388913c1d678c808ef6956647bfc19c1461b40ba..60cbb5d25b58e2f7dfe26a3be5a02f9a9b72aa8a 100644 --- a/content/en/docs/Developerguide/log-replay.md +++ b/content/en/docs/Developerguide/log-replay.md @@ -50,8 +50,6 @@ This parameter must be used together with **recovery\_parse\_workers**, and it **Parameter description**: Specifies the actual number of replay threads. This parameter is read-only. -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - **Value range**: an integer ranging from 1 to 2147483647 This parameter is affected by the parameter: recovery_max_workers and parameter: recovery_parse_workers. When any of the above parameters is greater than 0, the parameter value will be recalculated. diff --git a/content/en/docs/Developerguide/parallel-data-import.md b/content/en/docs/Developerguide/parallel-data-import.md deleted file mode 100644 index 90b3ebeda20b0713037276fbc1b143dff88e7ace..0000000000000000000000000000000000000000 --- a/content/en/docs/Developerguide/parallel-data-import.md +++ /dev/null @@ -1,52 +0,0 @@ -# Parallel Data Import - -openGauss provides a parallel data import function that enables a large amount of data to be imported in a fast and efficient manner. This section describes parameters for importing data in parallel. - -## raise\_errors\_if\_no\_files - -**Parameter description**: Specifies whether to distinguish between the problems "the number of imported file records is empty" and "the imported file does not exist". If this parameter is set to **on** and the problem "the imported file does not exist" occurs, openGauss will report the error message "file does not exist". - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the messages of "the number of imported file records is empty" and "the imported file does not exist" are distinguished when files are imported. -- **off** indicates that the messages of "the number of imported file records is empty" and "the imported file does not exist" are the same when files are imported. - -**Default value**: **off** - -## partition\_mem\_batch - -**Parameter description**: In order to optimize the inserting of column-store partitioned tables in batches, the data is buffered during the inserting process and then written in the disk. You can specify the number of caches through **partition\_mem\_batch**. If the value is too large, much memory will be consumed. If it is too small, the performance of inserting column-store partitioned tables in batches will deteriorate. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: 1 to 65535 - -**Default value**: **256** - -## partition\_max\_cache\_size - -**Parameter description**: In order to optimize the inserting of column-store partitioned tables in batches, the data is buffered during the inserting process and then written in the disk. You can specify the data buffer cache size through **partition\_max\_cache\_size**. If the value is too large, much memory will be consumed. If it is too small, the performance of inserting column-store partitioned tables in batches will deteriorate. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: - -4096 to _INT\_MAX_/2. The unit is KB. - -**Default value**: **2GB** - -## enable\_delta\_store - -**Parameter description**: Specifies whether to enable delta tables for column-store tables. Delta tables will improve the performance of importing a single piece of data to a column-store table and prevent table bloating. If this parameter is set to **on**, data to be imported to a column-store table will be stored in the delta table when the data volume is less than **[DELTAROW\_THRESHOLD](create-table.md#en-us_topic_0237122117_en-us_topic_0059778169_lb0b5377e83534b3eac0e425f44b60166)** specified in table definition and otherwise will be stored in CUs of the main table. This parameter affects all operations involving data transfer of column-store tables, including **INSERT**, **COPY**, **VACUUM**, **VACUUM FULL**, **VACUUM DELTAMERGE**, and data redistribution. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: - -- **on** indicates that delta tables are enabled. -- **off** indicates that delta tables are disabled. - -**Default value**: **off** - diff --git a/content/en/docs/Toolreference/gs_ctl.md b/content/en/docs/Toolreference/gs_ctl.md index 73bd8e129570361cf85f964568f592b0ef103a4b..b3eaac137f1ae824fea9726c2ebf1aa4e31ed6e0 100644 --- a/content/en/docs/Toolreference/gs_ctl.md +++ b/content/en/docs/Toolreference/gs_ctl.md @@ -134,12 +134,10 @@ The **gs\_ctl** tool can use the following types of parameters:

-t, --timeout=SECS

-

This parameter controls the following functions:

- +

Maximum seconds for waiting the completion of database startup， shutdown or switchover.

Value range: an integer (second).

-

Default

- +

Default: Maximum seconds for waiting the completion of database startup, shutdown or switchover: 60s.

-V , --version

@@ -202,11 +200,11 @@ The **gs\_ctl** tool can use the following types of parameters: - + **Table 3** Common parameters for **start** and **restart** -

Parameter

+ @@ -246,11 +244,11 @@ The **gs\_ctl** tool can use the following types of parameters:

Parameter

Description

- + **Table 4** Common parameters for **stop** and **restart** -

Parameter

+ @@ -269,11 +267,11 @@ The **gs\_ctl** tool can use the following types of parameters:

Parameter

Description

- + **Table 5** **switchover** parameters -

Parameter

+ @@ -292,11 +290,11 @@ The **gs\_ctl** tool can use the following types of parameters:

Parameter

Description

- + **Table 6** **build** parameters -

Parameter

+ @@ -337,11 +335,11 @@ The **gs\_ctl** tool can use the following types of parameters:

Parameter

Description

- + **Table 7** **restore** parameters -

Parameter

+ @@ -358,11 +356,11 @@ The **gs\_ctl** tool can use the following types of parameters:

Parameter

Description

- + **Table 8** **query** parameters - + + +

Parameter

+ diff --git a/content/en/docs/Toolreference/gs_postuninstall.md b/content/en/docs/Toolreference/gs_postuninstall.md index 1807a96784112b827c7171ae2d4e5f86a81e7b5c..e7dafa1e1a4eafa64bd6666803ae451c719ea143 100644 --- a/content/en/docs/Toolreference/gs_postuninstall.md +++ b/content/en/docs/Toolreference/gs_postuninstall.md @@ -61,15 +61,14 @@ Deletes the user group where the OS user belongs to \(the **--delete-user** parameter must be specified when selecting this option\). -- -l +- -l - Specifies a log file name and its path. A timestamp will be added automatically to the log file name. + Specifies a log file name and its path. A timestamp will be added automatically to the log file name. - - When **-l** is not specified and **gaussdbLogPath** is not set in the XML file, the default value of the **-l** parameter is **$GAUSSLOG/om/gs\_postuninstall-YYYY-MMDD\_hhmmss.log**. - - If **-l** is not specified and **gaussdbLogPath** is set in the XML file, the default value of the **-l** parameter is **gaussdbLogPath/**_Username_**/om/gs\_postuninstall-YYYY-MMDD\_hhmmss.log**. + When **-l** is not specified and **gaussdbLogPath** is not set in the XML file, the default value of the **-l** parameter is **/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log**. - >![](public_sys-resources/icon-note.gif) **NOTE:** - >After executing gs\_postuninstall, the system will automatically delete the directories related to openGauss \(including $GAUSSLOG\). You are advised to set the log file path to a path outside the openGauss database. + >![](public_sys-resources/icon-note.gif) **NOTE:** + >After executing gs\_postuninstall, the system will automatically delete the directories related to openGauss \(including $GAUSSLOG\). You are advised to set the log file path to a path outside the openGauss database. - -?, --help diff --git a/content/en/docs/installation/Developerguide/Developerguide.md b/content/en/docs/installation/Developerguide/Developerguide.md deleted file mode 100644 index 5d32a126b5c607ca7d2328de574c73fcb1a888a5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/Developerguide.md +++ /dev/null @@ -1,80 +0,0 @@ -# About This Document - -## Overview - -This section describes how to design, create, query, and maintain a database, including the SQL statements, stored procedures, system catalogs, and views. - -## Intended Audience - -This document is intended for developers on C/Java application based on openGauss, providing necessary references. - -As an application developer, you need to be familiar with: - -- Knowledge about OSs. This is the foundation of everything. -- C/Java programming language through which you can develop applications. -- An IDE of the C/Java language, which is the prerequisite for efficient application development. -- SQL syntax, using which you can operate databases. - -## Symbol Conventions - -The symbols that may be found in this document are defined as follows: - - -

Parameter

Description

- - - - - - - - - - - - - - - - - - - -

Symbol

-

Description

-

-

Indicates a hazard with a high level of risk which, if not avoided, will result in death or serious injury.

-

-

Indicates a hazard with a medium level of risk which, if not avoided, could result in death or serious injury.

-

-

Indicates a hazard with a low level of risk which, if not avoided, could result in minor or moderate injury.

-

-

Indicates a potentially hazardous situation which, if not avoided, could result in equipment damage, data loss, performance deterioration, or unanticipated results.

-

NOTICE is used to address practices not related to personal injury.

-

-

Supplements the important information in the main text.

-

NOTE is used to address information not related to personal injury, equipment damage, and environment deterioration.

-
- - -## Change History - - - - - - - - - - - - -

Issue

-

Date

-

Description

-

01

-

2020-05-12

-

This issue is the first official release.

-
- diff --git a/content/en/docs/installation/Developerguide/MOT-Sample-PGBench-benchmark.md b/content/en/docs/installation/Developerguide/MOT-Sample-PGBench-benchmark.md deleted file mode 100644 index 140d2f3cb92f78c4925017cb77789bc399ded022..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/MOT-Sample-PGBench-benchmark.md +++ /dev/null @@ -1,29 +0,0 @@ -# MOT Sample PGBench benchmark - -**pgbench** is a simple program for running benchmark tests on PostgreSQL. It runs the same sequence of SQL commands over and over, possibly in multiple concurrent database sessions, and then calculates the average transaction rate (transactions per second or TPS). By default, pgbench tests a scenario that is loosely based on TPC-B, involving five SELECT, UPDATE, and INSERT commands per transaction. - -To support the optimistic concurrency control (OCC) of the openGauss MOT several minor changes were applied to the standard **pgbench**. The enhanced utility is released as part of the openGauss code under the **contrib** folder. - -A pgbench benchmark (26/08/2020) showed that MOT engine outperforms the Disk-engine by factor of x2.4-2.8 times, both higher TPS and lower Latency. - -+ Hardware tested: 2-socket 72 cores x86 server (Intel Xeon Gold 6154 CPU @ 3GHz) -+ Test Parameters: Transaction=TPCB; Scaling Factor = 100 ;Query Protocol=Prepared - -## How to run pgbench with MOT: - -1. To load data into MOT you need to use the “–m” flag like in the following example - - ``` - ./pgbench -h -p -U -W -i –m -s 100 - ``` - - - -2. To utilize maximum performance of MOT JIT capabilities it is recommended to use the prepared mode like in the following example - - ``` - ./pgbench -h -p -U -W -c 30 -j 30 -T 10 -M prepared - ``` - - - diff --git a/content/en/docs/installation/Developerguide/abort.md b/content/en/docs/installation/Developerguide/abort.md deleted file mode 100644 index 09804c4905126f42f1ab850874ee548829d546ce..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/abort.md +++ /dev/null @@ -1,70 +0,0 @@ -# ABORT - -## Function - -**ABORT** rolls back the current transaction and cancels the changes in the transaction. - -This command is equivalent to [ROLLBACK](rollback.md), and is present only for historical reasons. Now **ROLLBACK** is recommended. - -## Precautions - -**ABORT** has no impact outside a transaction, but will provoke a notice. - -## Syntax - -``` -ABORT [ WORK | TRANSACTION ] ; -``` - -## Parameter Description - -**WORK | TRANSACTION** - -Specifies an optional keyword, which has no effect except increasing readability. - -## Examples - -``` --- Create the customer_demographics_t1 table. -postgres=# CREATE TABLE customer_demographics_t1 -( - CD_DEMO_SK INTEGER NOT NULL, - CD_GENDER CHAR(1) , - CD_MARITAL_STATUS CHAR(1) , - CD_EDUCATION_STATUS CHAR(20) , - CD_PURCHASE_ESTIMATE INTEGER , - CD_CREDIT_RATING CHAR(10) , - CD_DEP_COUNT INTEGER , - CD_DEP_EMPLOYED_COUNT INTEGER , - CD_DEP_COLLEGE_COUNT INTEGER -) -WITH (ORIENTATION = COLUMN,COMPRESSION=MIDDLE) -; - --- Insert data. -postgres=# INSERT INTO customer_demographics_t1 VALUES(1920801,'M', 'U', 'DOCTOR DEGREE', 200, 'GOOD', 1, 0,0); - --- Start a transaction. -postgres=# START TRANSACTION; - --- Update the column. -postgres=# UPDATE customer_demographics_t1 SET cd_education_status= 'Unknown'; - --- Abort the transaction. All updates are rolled back. -postgres=# ABORT; - --- Query data. -postgres=# SELECT * FROM customer_demographics_t1 WHERE cd_demo_sk = 1920801; -cd_demo_sk | cd_gender | cd_marital_status | cd_education_status | cd_purchase_estimate | cd_credit_rating | cd_dep_count | cd_dep_employed_count | cd_dep_college_count -------------+-----------+-------------------+----------------------+----------------------+------------------+--------------+-----------------------+---------------------- - 1920801 | M | U | DOCTOR DEGREE | 200 | GOOD | 1 | 0 | 0 -(1 row) - --- Delete the table. -postgres=# DROP TABLE customer_demographics_t1; -``` - -## Helpful Links - -[SET TRANSACTION](set-transaction.md), [COMMIT | END](commit-end.md), and [ROLLBACK](rollback.md) - diff --git a/content/en/docs/installation/Developerguide/additional-features.md b/content/en/docs/installation/Developerguide/additional-features.md deleted file mode 100644 index df2a2120cbdcd9d0350e10a8a4586fa8a4439ba9..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/additional-features.md +++ /dev/null @@ -1,11 +0,0 @@ -# Additional Features - -- **[Manipulating tsvector](manipulating-tsvector.md)** - -- **[Manipulating Queries](manipulating-queries.md)** - -- **[Rewriting Queries](rewriting-queries.md)** - -- **[Gathering Document Statistics](gathering-document-statistics.md)** - - diff --git a/content/en/docs/installation/Developerguide/administrators.md b/content/en/docs/installation/Developerguide/administrators.md deleted file mode 100644 index bb683f486cc2e002b5aff90187a10f5333e893d4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/administrators.md +++ /dev/null @@ -1,28 +0,0 @@ -# Administrators - -## Initial Users - -The account automatically generated during openGauss installation is called an initial user. An initial user is the system, monitoring, O&M, and security policy administrator who has the highest-level permissions in the system and can perform all operations. This account has the same name as the OS user used for openGauss installation. You need to manually set the password during the installation. After the first login, change the initial user's password in time. - -An initial user bypasses all permission checks. You are advised to use an initial user as a database administrator only for database management other than service running. - -## System Administrators - -A system administrator is an account with the **SYSADMIN** attribute. By default, a database system administrator has the same permissions as object owners but does not have the object permissions in **dbe\_perf** mode. - -To create a system administrator, connect to the database as the initial user or a system administrator and run the **[CREATE USER](create-user.md)** or **[ALTER USER](alter-user.md)** statement with **SYSADMIN** specified. - -``` -CREATE USER sysadmin WITH SYSADMIN password "Bigdata@123"; -``` - -or - -``` -ALTER USER joe SYSADMIN; -``` - -To run the **ALTER USER** statement, the user must exist. - - - diff --git a/content/en/docs/installation/Developerguide/advisory-lock-functions.md b/content/en/docs/installation/Developerguide/advisory-lock-functions.md deleted file mode 100644 index fec47572ff06265fb8a108d3314d46ce25ff529f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/advisory-lock-functions.md +++ /dev/null @@ -1,171 +0,0 @@ -# Advisory Lock Functions - -Advisory lock functions manage advisory locks. - -- pg\_advisory\_lock\(key bigint\) - - Description: Obtains an exclusive session-level advisory lock. - - Return type: void - - Note: **pg\_advisory\_lock** locks resources defined by an application. The resources can be identified using a 64-bit or two nonoverlapped 32-bit key values. If another session locks the resources, the function blocks the resources until they can be used. The lock is exclusive. Multiple locking requests are pushed into the stack. Therefore, if the same resource is locked three times, it must be unlocked three times so that it is released to another session. - -- pg\_advisory\_lock\(key1 int, key2 int\) - - Description: Obtains an exclusive session-level advisory lock. - - Return type: void - - Note: Only users with the **sysadmin** permission can add session-level exclusive advisory locks to the key-value pair \(65535, 65535\). - -- pg\_advisory\_lock\_shared\(key bigint\) - - Description: Obtains a shared session-level advisory lock. - - Return type: void - -- pg\_advisory\_lock\_shared\(key1 int, key2 int\) - - Description: Obtains a shared session-level advisory lock. - - Return type: void - - Note: **pg\_advisory\_lock\_shared** works in the same way as **pg\_advisory\_lock**, except the lock can be shared with other sessions requesting shared locks. Only would-be exclusive lockers are locked out. - -- pg\_advisory\_unlock\(key bigint\) - - Description: Releases an exclusive session-level advisory lock. - - Return type: Boolean - -- pg\_advisory\_unlock\(key1 int, key2 int\) - - Description: Releases an exclusive session-level advisory lock. - - Return type: Boolean - - Note: **pg\_advisory\_unlock** releases the obtained exclusive advisory lock. If the release is successful, the function returns **true**. If the lock was not held, it will return **false**. In addition, a SQL warning will be reported by the server. - -- pg\_advisory\_unlock\_shared\(key bigint\) - - Description: Releases a shared session-level advisory lock. - - Return type: Boolean - -- pg\_advisory\_unlock\_shared\(key1 int, key2 int\) - - Description: Releases a shared session-level advisory lock. - - Return type: Boolean - - Note: **pg\_advisory\_unlock\_shared** works in the same way as **pg\_advisory\_unlock**, except it releases a shared session-level advisory lock. - -- pg\_advisory\_unlock\_all\(\) - - Description: Releases all advisory locks owned by the current session. - - Return type: void - - Note: **pg\_advisory\_unlock\_all** releases all advisory locks owned by the current session. The function is implicitly invoked when the session ends even if the client is abnormally disconnected. - -- pg\_advisory\_xact\_lock\(key bigint\) - - Description: Obtains an exclusive transaction-level advisory lock. - - Return type: void - -- pg\_advisory\_xact\_lock\(key1 int, key2 int\) - - Description: Obtains an exclusive transaction-level advisory lock. - - Return type: void - - Note: **pg\_advisory\_xact\_lock** works in the same way as **pg\_advisory\_lock**, except the lock is automatically released at the end of the current transaction and cannot be released explicitly. Only users with the **sysadmin** permission can add transaction-level exclusive advisory locks to the key-value pair \(65535, 65535\). - -- pg\_advisory\_xact\_lock\_shared\(key bigint\) - - Description: Obtains a shared transaction-level advisory lock. - - Return type: void - -- pg\_advisory\_xact\_lock\_shared\(key1 int, key2 int\) - - Description: Obtains a shared transaction-level advisory lock. - - Return type: void - - Note: **pg\_advisory\_xact\_lock\_shared** works in the same way as **pg\_advisory\_lock\_shared**, except the lock is automatically released at the end of the current transaction and cannot be released explicitly. - -- pg\_try\_advisory\_lock\(key bigint\) - - Description: Obtains an exclusive session-level advisory lock if available. - - Return type: Boolean - - Note: **pg\_try\_advisory\_lock** is similar to **pg\_advisory\_lock**, except **pg\_try\_advisory\_lock** does not block the resource until the resource is released. **pg\_try\_advisory\_lock** either immediately obtains the lock and returns **true** or returns **false**, which indicates the lock cannot be performed currently. - -- pg\_try\_advisory\_lock\(key1 int, key2 int\) - - Description: Obtains an exclusive session-level advisory lock if available. - - Return type: Boolean - - Note: Only users with the **sysadmin** permission can add session-level exclusive advisory locks to the key-value pair \(65535, 65535\). - -- pg\_try\_advisory\_lock\_shared\(key bigint\) - - Description: Obtains a shared session-level advisory lock if available. - - Return type: Boolean - -- pg\_try\_advisory\_lock\_shared\(key1 int, key2 int\) - - Description: Obtains a shared session-level advisory lock if available. - - Return type: Boolean - - Note: **pg\_try\_advisory\_lock\_shared** is similar to **pg\_try\_advisory\_lock**, except **pg\_try\_advisory\_lock\_shared** attempts to obtain a shared lock instead of an exclusive lock. - -- pg\_try\_advisory\_xact\_lock\(key bigint\) - - Description: Obtains an exclusive transaction-level advisory lock if available. - - Return type: Boolean - -- pg\_try\_advisory\_xact\_lock\(key1 int, key2 int\) - - Description: Obtains an exclusive transaction-level advisory lock if available. - - Return type: Boolean - - Note: **pg\_try\_advisory\_xact\_lock** works in the same way as **pg\_try\_advisory\_lock**, except the lock, if acquired, is automatically released at the end of the current transaction and cannot be released explicitly. Note: Only users with the **sysadmin** permission can add transaction-level exclusive advisory locks to the key-value pair \(65535, 65535\). - -- pg\_try\_advisory\_xact\_lock\_shared\(key bigint\) - - Description: Obtains a shared transaction-level advisory lock if available. - - Return type: Boolean - -- pg\_try\_advisory\_xact\_lock\_shared\(key1 int, key2 int\) - - Description: Obtains a shared transaction-level advisory lock if available. - - Return type: Boolean - - Note: **pg\_try\_advisory\_xact\_lock\_shared** works in the same way as **pg\_try\_advisory\_lock\_shared**, except the lock, if acquired, is automatically released at the end of the current transaction and cannot be released explicitly. - -- lock\_cluster\_ddl\(\) - - Description: Attempts to obtain a session-level exclusive advisory lock for all active primary database nodes in openGauss. - - Return type: Boolean - - Note: Only users with the **sysadmin** permission can call this function. - -- unlock\_cluster\_ddl\(\) - - Description: Attempts to add a session-level exclusive advisory lock on the primary database node. - - Return type: Boolean - - diff --git a/content/en/docs/installation/Developerguide/aggregate-functions.md b/content/en/docs/installation/Developerguide/aggregate-functions.md deleted file mode 100644 index 466080ce86433365728d405e02bf65e307e2164d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/aggregate-functions.md +++ /dev/null @@ -1,689 +0,0 @@ -# Aggregate Functions - -## Aggregate Functions - -- sum\(expression\) - - Description: Sum of expression across all input values - - Return type: - - Generally, same as the argument data type. In the following cases, type conversion occurs: - - - **BIGINT** for **SMALLINT** or **INT** arguments - - **NUMBER** for **BIGINT** arguments - - **DOUBLE PRECISION** for floating-point arguments - - Example: - - ``` - postgres=# SELECT SUM(ss_ext_tax) FROM tpcds.STORE_SALES; - sum - -------------- - 213267594.69 - (1 row) - ``` - -- max\(expression\) - - Description: maximum value of expression across all input values - - Argument types: any array, numeric, string, or date/time type - - Return type: same as the argument type - - Example: - - ``` - postgres=# SELECT MAX(inv_quantity_on_hand) FROM tpcds.inventory; - ``` - -- min\(expression\) - - Description: minimum value of expression across all input values - - Argument types: any array, numeric, string, or date/time type - - Return type: same as the argument type - - Example: - - ``` - postgres=# SELECT MIN(inv_quantity_on_hand) FROM tpcds.inventory; - min - ----- - 0 - (1 row) - ``` - -- avg\(expression\) - - Description: Average \(arithmetic mean\) of all input values - - Return type: - - **NUMBER** for any integer-type argument. - - **DOUBLE PRECISION** for a floating-point argument, - - otherwise the same as the argument data type. - - Example: - - ``` - postgres=# SELECT AVG(inv_quantity_on_hand) FROM tpcds.inventory; - avg - ---------------------- - 500.0387129084044604 - (1 row) - ``` - -- count\(expression\) - - Description: number of input rows for which the value of expression is not null - - Return type: bigint - - Example: - - ``` - postgres=# SELECT COUNT(inv_quantity_on_hand) FROM tpcds.inventory; - count - ---------- - 11158087 - (1 row) - ``` - -- count\(\*\) - - Description: number of input rows - - Return type: bigint - - Example: - - ``` - postgres=# SELECT COUNT(*) FROM tpcds.inventory; - count - ---------- - 11745000 - (1 row) - ``` - -- median\(expression\) \[over \(query partition clause\)\] - - Description: Returns the median of an expression. **NULL** will be ignored by the median function during calculation. The **DISTINCT** keyword can be used to exclude duplicate records in an expression. The data type of the input expression can be numeric \(including integer, double, and bigint\) or interval. For other data types, the median cannot be calculated. - - Return type: double or interval - - Example: - - ``` - select median(id) from (values(1), (2), (3), (4), (null)) test(id); - median - -------- - 2.5 - (1 row) - ``` - -- array\_agg\(expression\) - - Description: input values, including nulls, concatenated into an array - - Return type: array of the argument type - - Example: - - ``` - postgres=# SELECT ARRAY_AGG(sr_fee) FROM tpcds.store_returns WHERE sr_customer_sk = 2; - array_agg - --------------- - {22.18,63.21} - (1 row) - ``` - -- string\_agg\(expression, delimiter\) - - Description: input values concatenated into a string, separated by delimiter - - Return type: same as the argument type - - Example: - - ``` - postgres=# SELECT string_agg(sr_item_sk, ',') FROM tpcds.store_returns where sr_item_sk < 3; - string_agg - --------------------------------------------------------------------------------- - ------------------------------ - 1,2,1,2,2,1,1,2,2,1,2,1,2,1,1,1,2,1,1,1,1,1,2,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,2, - 2,1,1,1,1,1,1,2,2,1,1,2,1,1,1 - (1 row) - ``` - -- listagg\(expression \[, delimiter\]\) WITHIN GROUP\(ORDER BY order-list\) - - Description: aggregation column data sorted according to the mode specified by **WITHIN GROUP**, and concatenated to a string using the specified delimiter - - - **expression**: Mandatory. It specifies an aggregation column name or a column-based, valid expression. It does not support the **DISTINCT** keyword and the **VARIADIC** parameter. - - **delimiter**: Optional. It specifies a delimiter, which can be a string constant or a deterministic expression based on a group of columns. The default value is empty. - - **order-list**: Mandatory. It specifies the sorting mode in a group. - - Return type: text - - Example: - - The aggregation column is of the text character set type. - - ``` - postgres=# SELECT deptno, listagg(ename, ',') WITHIN GROUP(ORDER BY ename) AS employees FROM emp GROUP BY deptno; - deptno | employees - --------+-------------------------------------- - 10 | CLARK,KING,MILLER - 20 | ADAMS,FORD,JONES,SCOTT,SMITH - 30 | ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD - (3 rows) - ``` - - The aggregation column is of the integer type. - - ``` - postgres=# SELECT deptno, listagg(mgrno, ',') WITHIN GROUP(ORDER BY mgrno NULLS FIRST) AS mgrnos FROM emp GROUP BY deptno; - deptno | mgrnos - --------+------------------------------- - 10 | 7782,7839 - 20 | 7566,7566,7788,7839,7902 - 30 | 7698,7698,7698,7698,7698,7839 - (3 rows) - ``` - - The aggregation column is of the floating point type. - - ``` - postgres=# SELECT job, listagg(bonus, '($); ') WITHIN GROUP(ORDER BY bonus DESC) || '($)' AS bonus FROM emp GROUP BY job; - job | bonus - ------------+------------------------------------------------- - CLERK | 10234.21($); 2000.80($); 1100.00($); 1000.22($) - PRESIDENT | 23011.88($) - ANALYST | 2002.12($); 1001.01($) - MANAGER | 10000.01($); 2399.50($); 999.10($) - SALESMAN | 1000.01($); 899.00($); 99.99($); 9.00($) - (5 rows) - ``` - - The aggregation column is of the time type. - - ``` - postgres=# SELECT deptno, listagg(hiredate, ', ') WITHIN GROUP(ORDER BY hiredate DESC) AS hiredates FROM emp GROUP BY deptno; - deptno | hiredates - --------+------------------------------------------------------------------------------------------------------------------------------ - 10 | 1982-01-23 00:00:00, 1981-11-17 00:00:00, 1981-06-09 00:00:00 - 20 | 2001-04-02 00:00:00, 1999-12-17 00:00:00, 1987-05-23 00:00:00, 1987-04-19 00:00:00, 1981-12-03 00:00:00 - 30 | 2015-02-20 00:00:00, 2010-02-22 00:00:00, 1997-09-28 00:00:00, 1981-12-03 00:00:00, 1981-09-08 00:00:00, 1981-05-01 00:00:00 - (3 rows) - ``` - - The aggregation column is of the time interval type. - - ``` - postgres=# SELECT deptno, listagg(vacationTime, '; ') WITHIN GROUP(ORDER BY vacationTime DESC) AS vacationTime FROM emp GROUP BY deptno; - deptno | vacationtime - --------+------------------------------------------------------------------------------------ - 10 | 1 year 30 days; 40 days; 10 days - 20 | 70 days; 36 days; 9 days; 5 days - 30 | 1 year 1 mon; 2 mons 10 days; 30 days; 12 days 12:00:00; 4 days 06:00:00; 24:00:00 - (3 rows) - ``` - - By default, the delimiter is empty. - - ``` - postgres=# SELECT deptno, listagg(job) WITHIN GROUP(ORDER BY job) AS jobs FROM emp GROUP BY deptno; - deptno | jobs - --------+---------------------------------------------- - 10 | CLERKMANAGERPRESIDENT - 20 | ANALYSTANALYSTCLERKCLERKMANAGER - 30 | CLERKMANAGERSALESMANSALESMANSALESMANSALESMAN - (3 rows) - ``` - - When **listagg** is used as a window function, the **OVER** clause does not support the window sorting of **ORDER BY**, and the **listagg** column is an ordered aggregation of the corresponding groups. - - ``` - postgres=# SELECT deptno, mgrno, bonus, listagg(ename,'; ') WITHIN GROUP(ORDER BY hiredate) OVER(PARTITION BY deptno) AS employees FROM emp; - deptno | mgrno | bonus | employees - --------+-------+----------+------------------------------------------- - 10 | 7839 | 10000.01 | CLARK; KING; MILLER - 10 | | 23011.88 | CLARK; KING; MILLER - 10 | 7782 | 10234.21 | CLARK; KING; MILLER - 20 | 7566 | 2002.12 | FORD; SCOTT; ADAMS; SMITH; JONES - 20 | 7566 | 1001.01 | FORD; SCOTT; ADAMS; SMITH; JONES - 20 | 7788 | 1100.00 | FORD; SCOTT; ADAMS; SMITH; JONES - 20 | 7902 | 2000.80 | FORD; SCOTT; ADAMS; SMITH; JONES - 20 | 7839 | 999.10 | FORD; SCOTT; ADAMS; SMITH; JONES - 30 | 7839 | 2399.50 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - 30 | 7698 | 9.00 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - 30 | 7698 | 1000.22 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - 30 | 7698 | 99.99 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - 30 | 7698 | 1000.01 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - 30 | 7698 | 899.00 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN - (14 rows) - ``` - -- covar\_pop\(Y, X\) - - Description: overall covariance - - Return type: double precision - - Example: - - ``` - postgres=# SELECT COVAR_POP(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - covar_pop - ------------------ - 829.749627587403 - (1 row) - ``` - -- covar\_samp\(Y, X\) - - Description: sample covariance - - Return type: double precision - - Example: - - ``` - postgres=# SELECT COVAR_SAMP(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - covar_samp - ------------------ - 830.052235037289 - (1 row) - ``` - -- stddev\_pop\(expression\) - - Description: overall standard difference - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT STDDEV_POP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - stddev_pop - ------------------ - 289.224294957556 - (1 row) - ``` - -- stddev\_samp\(expression\) - - Description: sample standard deviation of the input values - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT STDDEV_SAMP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - stddev_samp - ------------------ - 289.224359757315 - (1 row) - ``` - -- var\_pop\(expression\) - - Description: population variance of the input values \(square of the population standard deviation\) - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT VAR_POP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - var_pop - -------------------- - 83650.692793695475 - (1 row) - ``` - -- var\_samp\(expression\) - - Description: sample variance of the input values \(square of the sample standard deviation\) - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT VAR_SAMP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - var_samp - -------------------- - 83650.730277028768 - (1 row) - ``` - -- bit\_and\(expression\) - - Description: the bitwise AND of all non-null input values, or null if none - - Return type: same as the argument type - - Example: - - ``` - postgres=# SELECT BIT_AND(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - bit_and - --------- - 0 - (1 row) - ``` - -- bit\_or\(expression\) - - Description: the bitwise OR of all non-null input values, or null if none - - Return type: same as the argument type - - Example: - - ``` - postgres=# SELECT BIT_OR(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - bit_or - -------- - 1023 - (1 row) - ``` - -- bool\_and\(expression\) - - Description: Its value is **true** if all input values are **true**, otherwise **false**. - - Return type: bool - - Example: - - ``` - postgres=# SELECT bool_and(100 <2500); - bool_and - ---------- - t - (1 row) - ``` - -- bool\_or\(expression\) - - Description: Its value is **true** if at least one input value is **true**, otherwise **false**. - - Return type: bool - - Example: - - ``` - postgres=# SELECT bool_or(100 <2500); - bool_or - ---------- - t - (1 row) - ``` - -- corr\(Y, X\) - - Description: correlation coefficient - - Return type: double precision - - Example: - - ``` - postgres=# SELECT CORR(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - corr - ------------------- - .0381383624904186 - (1 row) - ``` - -- every\(expression\) - - Description: equivalent to **bool\_and** - - Return type: bool - - Example: - - ``` - postgres=# SELECT every(100 <2500); - every - ------- - t - (1 row) - ``` - -- regr\_avgx\(Y, X\) - - Description: average of the independent variable \(**sum\(X\)/N**\) - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_AVGX(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_avgx - ------------------ - 578.606576740795 - (1 row) - ``` - -- regr\_avgy\(Y, X\) - - Description: average of the dependent variable \(**sum\(Y\)/N**\) - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_AVGY(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_avgy - ------------------ - 50.0136711629602 - (1 row) - ``` - -- regr\_count\(Y, X\) - - Description: number of input rows in which both expressions are non-null - - Return type: bigint - - Example: - - ``` - postgres=# SELECT REGR_COUNT(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_count - ------------ - 2743 - (1 row) - ``` - -- regr\_intercept\(Y, X\) - - Description: y-intercept of the least-squares-fit linear equation determined by the \(X, Y\) pairs - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_INTERCEPT(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_intercept - ------------------ - 49.2040847848607 - (1 row) - ``` - -- regr\_r2\(Y, X\) - - Description: square of the correlation coefficient - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_R2(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_r2 - -------------------- - .00145453469345058 - (1 row) - ``` - -- regr\_slope\(Y, X\) - - Description: slope of the least-squares-fit linear equation determined by the \(X, Y\) pairs - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_SLOPE(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_slope - -------------------- - .00139920009665259 - (1 row) - ``` - -- regr\_sxx\(Y, X\) - - Description: **sum\(X^2\) - sum\(X\)^2/N **\(sum of squares of the independent variables\) - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_SXX(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_sxx - ------------------ - 1626645991.46135 - (1 row) - ``` - -- regr\_sxy\(Y, X\) - - Description: **sum\(X\*Y\) - sum\(X\) \* sum\(Y\)/N** \("sum of products" of independent times dependent variable\) - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_SXY(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_sxy - ------------------ - 2276003.22847225 - (1 row) - ``` - -- regr\_syy\(Y, X\) - - Description: **sum\(Y^2\) - sum\(Y\)^2/N** \("sum of squares" of the dependent variable\) - - Return type: double precision - - Example: - - ``` - postgres=# SELECT REGR_SYY(sr_fee, sr_net_loss) FROM tpcds.store_returns WHERE sr_customer_sk < 1000; - regr_syy - ----------------- - 2189417.6547314 - (1 row) - ``` - -- stddev\(expression\) - - Description: alias of **stddev\_samp** - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT STDDEV(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - stddev - ------------------ - 289.224359757315 - (1 row) - ``` - -- variance\(expexpression,ression\) - - Description: alias of **var\_samp** - - Return type: **double precision** for floating-point arguments, otherwise **numeric** - - Example: - - ``` - postgres=# SELECT VARIANCE(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; - variance - -------------------- - 83650.730277028768 - (1 row) - ``` - -- checksum\(expression\) - - Description: Returns the CHECKSUM value of all input values. This function can be used to check whether the data in the tables is the same before and after the backup, restoration, or migration of the openGauss database \(databases other than openGauss are not supported\). Before and after database backup, database restoration, or data migration, you need to manually run SQL commands to obtain the execution results. Compare the obtained execution results to check whether the data in the tables before and after the backup or migration is the same. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- For large tables, the execution of CHECKSUM function may take a long time. - >- If the CHECKSUM values of two tables are different, it indicates that the contents of the two tables are different. Using the hash function in the CHECKSUM function may incur conflicts. There is low possibility that two tables with different contents may have the same CHECKSUM value. The same problem may occur when CHECKSUM is used for columns. - >- If the time type is timestamp, timestamptz, or smalldatetime, ensure that the time zone settings are the same when calculating the CHECKSUM value. - - - If the CHECKSUM value of a column is calculated and the column type can be changed to TEXT by default, set _expression_ to the column name. - - If the CHECKSUM value of a column is calculated and the column type cannot be converted to TEXT by default, set _expression_ to _Column name_**::TEXT**. - - If the CHECKSUM value of all columns is calculated, set _expression_ to _Table name_**::TEXT**. - - The following types of data can be converted into TEXT types by default: char, name, int8, int2, int1, int4, raw, pg\_node\_tree, float4, float8, bpchar, varchar, nvarchar2, date, timestamp, timestamptz, numeric, and smalldatetime. Other types need to be forcibly converted to TEXT. - - Return type: numeric - - Example: - - The following shows the CHECKSUM value of a column that can be converted to the TEXT type by default: - - ``` - postgres=# SELECT CHECKSUM(inv_quantity_on_hand) FROM tpcds.inventory; - checksum - ------------------- - 24417258945265247 - (1 row) - ``` - - The following shows the CHECKSUM value of a column that cannot be converted to the TEXT type by default. Note that the CHECKSUM parameter is set to _Column name_**::TEXT**. - - ``` - postgres=# SELECT CHECKSUM(inv_quantity_on_hand::TEXT) FROM tpcds.inventory; - checksum - ------------------- - 24417258945265247 - (1 row) - ``` - - The following shows the CHECKSUM value of all columns in a table. Note that the CHECKSUM parameter is set to _Table name_**::TEXT**. The table name is not modified by its schema. - - ``` - postgres=# SELECT CHECKSUM(inventory::TEXT) FROM tpcds.inventory; - checksum - ------------------- - 25223696246875800 - (1 row) - ``` - - diff --git a/content/en/docs/installation/Developerguide/ai-features.md b/content/en/docs/installation/Developerguide/ai-features.md deleted file mode 100644 index 7d5c36dac551f0f4a0c32d3df7f4c0385a3044b8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/ai-features.md +++ /dev/null @@ -1,9 +0,0 @@ -# AI Features - -- **[Predictor](predictor.md)** - -- **[X-Tuner](x-tuner.md)** - -- **[SQLdiag](sqldiag.md)** - - diff --git a/content/en/docs/installation/Developerguide/alarm-detection.md b/content/en/docs/installation/Developerguide/alarm-detection.md deleted file mode 100644 index c948b7d34b06e81ba8b6c45bd3b4efd60594a943..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alarm-detection.md +++ /dev/null @@ -1,47 +0,0 @@ -# Alarm Detection - -During the running of the openGauss, error scenarios can be detected and informed to users in time. - -## enable\_alarm - -**Parameter description**: Specifies whether to enable the alarm detection thread to detect fault scenarios that may occur in the database. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the alarm detection thread is enabled. -- **off** indicates that the alarm detection thread is disabled. - -**Default value**: **on** - -## connection\_alarm\_rate - -**Parameter description**: Specifies the ratio restriction on the maximum number of allowed parallel connections to the database. The maximum number of concurrent connections to the database is [max\_connections](connection-settings.md#en-us_topic_0237124695_en-us_topic_0059777636_sa723b719fa70453bb7ec27f323d41c79) x **connection\_alarm\_rate**. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range:** a floating point number ranging from 0.0 to 1.0 - -**Default value**: **0.9** - -## alarm\_report\_interval - -**Parameter description**: specifies the interval at which an alarm is reported. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer. The unit is s. - -**Default value:** **10** - -## alarm\_component - -**Parameter description**: Certain alarms are suppressed during alarm reporting. That is, the same alarm will not be repeatedly reported by an instance within the period specified by **alarm\_report\_interval**. Its default value is **10s**. In this case, the parameter specifies the location of the alarm component that is used to process alarm information. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -**Default value**: **/opt/huawei/snas/bin/snas\_cm\_cmd** - diff --git a/content/en/docs/installation/Developerguide/alter-data-source.md b/content/en/docs/installation/Developerguide/alter-data-source.md deleted file mode 100644 index 26df4f0a7f5059485075f9029764c32fd733fa1d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-data-source.md +++ /dev/null @@ -1,103 +0,0 @@ -# ALTER DATA SOURCE - -## Function - -**ALTER DATA SOURCE** modifies the attributes and content of the data source. - -The attributes include the name and owner. The content includes the type, version, and connection options. - -## Precautions - -- Only the initial user, system administrator, and owner have the permission to modify data sources. -- To change the owner, the new owner must be the initial user or a system administrator. -- If the **password** option is displayed, ensure that the **datasource.key.cipher** and **datasource.key.rand** files exist in the _$GAUSSHOME_**/bin** directory of each node in openGauss. If the two files do not exist, use the **gs\_guc** tool to generate them and use the **gs\_ssh** tool to release them to the _$GAUSSHOME_**/bin** directory on each node in openGauss. - -## Syntax - -``` -ALTER DATA SOURCE src_name - [TYPE 'type_str'] - [VERSION {'version_str' | NULL}] - [OPTIONS ( {[ ADD | SET | DROP ] optname ['optvalue']} [, ...] )]; -ALTER DATA SOURCE src_name RENAME TO src_new_name; -ALTER DATA SOURCE src_name OWNER TO new_owner; -``` - -## Parameter Description - -- **src\_name** - - Specifies the data source name to be modified. - - Value range: a string. It must comply with the naming convention rule. - -- **TYPE** - - Changes the original **TYPE** value of the data source to the specified value. - - Value range: an empty string or a non-empty string - -- **VERSION** - - Changes the original **VERSION** value of the data source to the specified value. - - Value range: an empty string, a non-empty string, or null - -- **OPTIONS** - - Specifies the column to be added, modified, or deleted. The value of optname should be unique. Comply with the following rules to set this parameter: - - To add a column, you can omit **ADD** and simply specify the column name, which cannot be an existing column name. - - To modify a column, specify **SET** and an existing column name. - - To delete a column, specify **DROP** and an existing column name. Do not set **optvalue**. - -- **src\_new\_name** - - Specifies the new data source name. - - Value range: a string. It must comply with the naming convention rule. - -- **new\_user** - - Specifies the new owner of an object. - - Value range: a string. It must be a valid username. - - -## Examples - -``` --- Create an empty data source. -postgres=# CREATE DATA SOURCE ds_test1; - --- Rename the data source. -postgres=# ALTER DATA SOURCE ds_test1 RENAME TO ds_test; - --- Change the owner. -postgres=# CREATE USER user_test1 IDENTIFIED BY 'Gs@123456'; -postgres=# ALTER USER user_test1 WITH SYSADMIN; -postgres=# ALTER DATA SOURCE ds_test OWNER TO user_test1; - --- Modify TYPE and VERSION. -postgres=# ALTER DATA SOURCE ds_test TYPE 'MPPDB_TYPE' VERSION 'XXX'; - --- Add a column. -postgres=# ALTER DATA SOURCE ds_test OPTIONS (add dsn 'gaussdb', username 'test_user'); - --- Modify a column. -postgres=# ALTER DATA SOURCE ds_test OPTIONS (set dsn 'unknown'); - --- Delete a column. -postgres=# ALTER DATA SOURCE ds_test OPTIONS (drop username); - --- Delete the data source and user objects. -postgres=# DROP DATA SOURCE ds_test; -postgres=# DROP USER user_test1; -``` - -## Helpful Links - -[CREATE DATA SOURCE](create-data-source.md) and [DROP DATA SOURCE](drop-data-source.md) - diff --git a/content/en/docs/installation/Developerguide/alter-database.md b/content/en/docs/installation/Developerguide/alter-database.md deleted file mode 100644 index 77a76473c5d1958bbb272c2f75a19b5ae38c4a0e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-database.md +++ /dev/null @@ -1,142 +0,0 @@ -# ALTER DATABASE - -## Function - -**ALTER DATABASE** modifies a database, including its name, owner, connection limitation, and object isolation. - -## Precautions - -- Only the owner of a database or a system administrator has the permission to run the **ALTER DATABASE** statement. Users other than system administrators may have the following permission constraints depending on the attributes to be modified: - - To modify the database name, you must have the **CREATEDB** permission. - - To modify a database owner, you must be a database owner and a member of the new owner, and have the **CREATEDB** permission. - - To change the default tablespace, you must be a database owner or a system administrator, and must have the **CREATE** permission on the new tablespace. This statement physically migrates tables and indexes in a default tablespace to a new tablespace. Note that tables and indexes outside the default tablespace are not affected. - - Only a database owner or a system administrator can modify GUC parameters for the database. - - Only database owners and system administrators can modify the object isolation attribute of a database. - -- You are not allowed to rename a database in use. To rename it, connect to another database. - -## Syntax - -- Modify the maximum number of connections to the database. - - ``` - ALTER DATABASE database_name - [ [ WITH ] CONNECTION LIMIT connlimit ]; - ``` - -- Rename the database. - - ``` - ALTER DATABASE database_name - RENAME TO new_name; - ``` - -- Change the database owner. - - ``` - ALTER DATABASE database_name - OWNER TO new_owner; - ``` - -- Change the default tablespace of the database. - - ``` - ALTER DATABASE database_name - SET TABLESPACE new_tablespace; - ``` - -- Modify the session parameter value of the database. - - ``` - ALTER DATABASE database_name - SET configuration_parameter { { TO | = } { value | DEFAULT } | FROM CURRENT }; - ``` - -- Reset the database configuration parameter. - - ``` - ALTER DATABASE database_name RESET - { configuration_parameter | ALL }; - ``` - - -- Modify the object isolation attribute of the database. - - ``` - ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- To modify the object isolation attribute of a database, the database must be connected. Otherwise, the modification will fail. - >- For a new database, the object isolation attribute is disabled by default. After this attribute is enabled, common users can view only the objects \(such as tables, functions, views, and columns\) that they have the permission to access. This attribute does not take effect for administrators. After this attribute is enabled, administrators can still view all database objects. - - -## Parameter Description - -- **database\_name** - - Specifies the name of the database whose attributes are to be modified. - - Value range: a string. It must comply with the naming convention rule. - -- **connlimit** - - Specifies the maximum number of concurrent connections that can be made to this database \(excluding administrators' connections\). - - Value range: The value must be an integer, preferably from 1 to 50. The default value **-1** indicates that there is no restriction on the number of concurrent connections. - -- **new\_name** - - Specifies the new name of a database. - - Value range: a string. It must comply with the naming convention rule. - -- **new\_owner** - - Specifies the new owner of a database. - - Value range: a string. It must be a valid username. - -- **new\_tablespace** - - Specifies the new default tablespace of a database. The tablespace exists in the database. The default tablespace is **pg\_default**. - - Value range: a string. It must be a valid tablespace name. - -- **configuration\_parameter** - - **value** - - Sets a specified database session parameter to a specified value. If the value is **DEFAULT** or **RESET**, the default setting is used in the new session. **OFF** closes the setting. - - Value range: a string - - - DEFAULT - - OFF - - RESET - -- **FROM CURRENT** - - Sets the value of the database based on the current connected session. - -- **RESET configuration\_parameter** - - Resets the specified database session parameter. - -- **RESET ALL** - - Resets all database session parameters. - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- Modify the default tablespace of a database by moving the table or index in the old tablespace into the new tablespace. This operation does not affect the tables or indexes in other non-default tablespaces. ->- The modified database session parameter values will take effect in the next session. - -## Examples - -See [Examples](create-database.md#en-us_topic_0237122099_en-us_topic_0059778277_s6be7b8abbb4b4aceb9dae686434d672c) in **CREATE DATABASE**. - -## Helpful Links - -[CREATE DATABASE](create-database.md) and [DROP DATABASE](drop-database.md) - diff --git a/content/en/docs/installation/Developerguide/alter-default-privileges.md b/content/en/docs/installation/Developerguide/alter-default-privileges.md deleted file mode 100644 index 1c7205175faf25828d72a55c4f47dd59b3bb4680..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-default-privileges.md +++ /dev/null @@ -1,141 +0,0 @@ -# ALTER DEFAULT PRIVILEGES - -## Function - -**ALTER DEFAULT PRIVILEGES** allows you to set the permissions that will be applied to objects created in the future. \(It does not affect permissions granted to existing objects.\) - -## Precautions - -Only the permissions for tables \(including views\), functions, and types \(including domains\) can be altered. - -## Syntax - -``` -ALTER DEFAULT PRIVILEGES - [ FOR { ROLE | USER } target_role [, ...] ] - [ IN SCHEMA schema_name [, ...] ] - abbreviated_grant_or_revoke; -``` - -- **abbreviated\_grant\_or\_revoke** grants or revokes permissions on some objects. - - ``` - grant_on_tables_clause - | grant_on_functions_clause - | grant_on_types_clause - | revoke_on_tables_clause - | revoke_on_functions_clause - | revoke_on_types_clause - ``` - - -- **grant\_on\_tables\_clause** grants permissions on tables. - - ``` - GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES } - [, ...] | ALL [ PRIVILEGES ] } - ON TABLES - TO { [ GROUP ] role_name | PUBLIC } [, ...] - [ WITH GRANT OPTION ] - ``` - -- **grant\_on\_functions\_clause** grants permissions on functions. - - ``` - GRANT { EXECUTE | ALL [ PRIVILEGES ] } - ON FUNCTIONS - TO { [ GROUP ] role_name | PUBLIC } [, ...] - [ WITH GRANT OPTION ] - ``` - -- **grant\_on\_types\_clause** grants permissions on types. - - ``` - GRANT { USAGE | ALL [ PRIVILEGES ] } - ON TYPES - TO { [ GROUP ] role_name | PUBLIC } [, ...] - [ WITH GRANT OPTION ] - ``` - -- **revoke\_on\_tables\_clause** revokes permissions on tables. - - ``` - REVOKE [ GRANT OPTION FOR ] - { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES } - [, ...] | ALL [ PRIVILEGES ] } - ON TABLES - FROM { [ GROUP ] role_name | PUBLIC } [, ...] - [ CASCADE | RESTRICT | CASCADE CONSTRAINTS ] - ``` - -- **revoke\_on\_functions\_clause** revokes permissions on functions. - - ``` - REVOKE [ GRANT OPTION FOR ] - { EXECUTE | ALL [ PRIVILEGES ] } - ON FUNCTIONS - FROM { [ GROUP ] role_name | PUBLIC } [, ...] - [ CASCADE | RESTRICT | CASCADE CONSTRAINTS ] - ``` - -- **revoke\_on\_types\_clause** revokes permissions on types. - - ``` - REVOKE [ GRANT OPTION FOR ] - { USAGE | ALL [ PRIVILEGES ] } - ON TYPES - FROM { [ GROUP ] role_name | PUBLIC } [, ...] - [ CASCADE | RESTRICT | CASCADE CONSTRAINTS ] - ``` - - -## Parameter Description - -- **target\_role** - - Specifies the name of an existing role. If **FOR ROLE/USER** is omitted, the current role is assumed. - - Value range: an existing role name - -- **schema\_name** - - Specifies the name of an existing schema. - - **target\_role** must have the **CREATE** permission for **schema\_name**. - - Value range: an existing schema name - -- **role\_name** - - Specifies the name of an existing role to grant or revoke permissions for. - - Value range: an existing role name - - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->To drop a role for which the default permissions have been granted, reverse the changes in its default permissions or use **DROP OWNED BY** to get rid of the default permission entry for the role. - -## Example - -``` --- Grant the SELECT permission on all the tables (and views) in tpcds to every user. -postgres=# ALTER DEFAULT PRIVILEGES IN SCHEMA tpcds GRANT SELECT ON TABLES TO PUBLIC; - --- Create a common user jack. -postgres=# CREATE USER jack PASSWORD 'Bigdata@123'; - --- Grant the INSERT permission on all the tables in tpcds to the user jack. -postgres=# ALTER DEFAULT PRIVILEGES IN SCHEMA tpcds GRANT INSERT ON TABLES TO jack; - --- Revoke the preceding permissions. -postgres=# ALTER DEFAULT PRIVILEGES IN SCHEMA tpcds REVOKE SELECT ON TABLES FROM PUBLIC; -postgres=# ALTER DEFAULT PRIVILEGES IN SCHEMA tpcds REVOKE INSERT ON TABLES FROM jack; - --- Delete user jack. -postgres=# DROP USER jack; -``` - -## Helpful Links - -[GRANT](grant.md) and [REVOKE](revoke.md) - diff --git a/content/en/docs/installation/Developerguide/alter-directory.md b/content/en/docs/installation/Developerguide/alter-directory.md deleted file mode 100644 index 7ccf160704c19ffe456143f469c6885bc20d3302..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-directory.md +++ /dev/null @@ -1,41 +0,0 @@ -# ALTER DIRECTORY - -## Function - -**ALTER DIRECTORY** modifies a directory. - -## Precautions - -- Currently, only the directory owner can be changed. -- The owner can only be a user with the **sysadmin** permission. - -## Syntax - -``` -ALTER DIRECTORY directory_name - OWNER TO new_owner; -``` - -## Parameter Description - -**directory\_name** - -Specifies the name of a directory to be modified. The value must be an existing directory name. - -## Examples - -``` --- Create a directory. -postgres=# CREATE OR REPLACE DIRECTORY dir as '/tmp/'; - --- Change the owner of the directory. -postgres=# ALTER DIRECTORY dir OWNER TO system; - --- Delete the foreign table. -postgres=# DROP DIRECTORY dir; -``` - -## Helpful Links - -[CREATE DIRECTORY](create-directory.md) and [DROP DIRECTORY](drop-directory.md) - diff --git a/content/en/docs/installation/Developerguide/alter-foreign-table.md b/content/en/docs/installation/Developerguide/alter-foreign-table.md deleted file mode 100644 index a328f5e98a92637ac4a00de63ef2aee7c9e76bb5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-foreign-table.md +++ /dev/null @@ -1,67 +0,0 @@ -# ALTER FOREIGN TABLE - -## Function - -**ALTER FOREIGN TABLE** modifies a foreign table. - -## Syntax - -``` -ALTER FOREIGN TABLE [ IF EXISTS ] table_name - OPTIONS ( {[ ADD | SET | DROP ] option ['value']}[, ... ]); -``` - -## Parameter Description - -- **table\_name** - - Specifies the name of an existing foreign table to be modified. - - Value range: an existing foreign table name. - -- **option** - - Specifies the option of a foreign table or foreign table column to be modified. **ADD**, **SET**, and **DROP** are operations to be performed. If no operation is set explicitly, the default value **ADD** is used. The option name must be unique \(although table options and table column options can share the same name\). The name and value of the option are also validated by a class library of a foreign data wrapper. - - - Options supported by oracle\_fdw are as follows: - - **table** - - Name of a table on the Oracle server. The value must be the same as the table name recorded in the Oracle system catalog. Generally, the value consists of uppercase letters. - - - **schema** - - Schema \(or owner\) corresponding to the table. The value must be the same as the table name recorded in the Oracle system catalog. Generally, the value consists of uppercase letters. - - - Options supported by mysql\_fdw are as follows: - - **dbname** - - Name of the MySQL database. - - - **table\_name** - - Name of a table in the MySQL database. - - - Options supported by postgres\_fdw are as follows: - - **schema\_name** - - Schema name of a remote server. If this option is not specified, the schema name of the foreign table is used as the schema name of the remote server. - - - **table\_name** - - Table name of a remote server. If this option is not specified, the name of the foreign table is used as the table name of the remote server. - - - **column\_name** - - Column name of a table on a remote server. If this option is not specified, the column name of the foreign table is used as the column name of a table on a remote server. - - - -- **value** - - Specifies the new value of **option**. - - -## Helpful Links - -[CREATE FOREIGN TABLE](create-foreign-table.md) and [CREATE FOREIGN TABLE](drop-foreign-table.md) - diff --git a/content/en/docs/installation/Developerguide/alter-function.md b/content/en/docs/installation/Developerguide/alter-function.md deleted file mode 100644 index b01ae836cf8d06c172af0f87faaa6ca9c106c7d9..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-function.md +++ /dev/null @@ -1,190 +0,0 @@ -# ALTER FUNCTION - -## Function - -**ALTER FUNCTION** modifies the attributes of a customized function. - -## Precautions - -Only the owner of the function or a system administrator has the permission to run this statement. If a function involves operations on temporary tables, **ALTER FUNCTION** cannot be used. - -## Syntax - -- Modify the additional parameters of the customized function. - - ``` - ALTER FUNCTION function_name ( [ { [ argmode ] [ argname ] argtype} [, ...] ] ) - action [ ... ] [ RESTRICT ]; - ``` - - The syntax of the **action** clause is as follows: - - ``` - {CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT} - | {IMMUTABLE | STABLE | VOLATILE} - | {SHIPPABLE | NOT SHIPPABLE} - | {NOT FENCED | FENCED} - | [ NOT ] LEAKPROOF - | { [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER } - | AUTHID { DEFINER | CURRENT_USER } - | COST execution_cost - | ROWS result_rows - | SET configuration_parameter { { TO | = } { value | DEFAULT }| FROM CURRENT} - | RESET {configuration_parameter | ALL} - ``` - -- Rename the customized function. - - ``` - ALTER FUNCTION funname ( [ { [ argmode ] [ argname ] argtype} [, ...] ] ) - RENAME TO new_name; - ``` - -- Change the owner of the customized function. - - ``` - ALTER FUNCTION funname ( [ { [ argmode ] [ argname ] argtype} [, ...] ] ) - OWNER TO new_owner; - ``` - -- Modify the schema of the customized function. - - ``` - ALTER FUNCTION funname ( [ { [ argmode ] [ argname ] argtype} [, ...] ] ) - SET SCHEMA new_schema; - ``` - - -## Parameter Description - -- **function\_name** - - Specifies the name of the function to be modified. - - Value range: an existing function name - -- **argmode** - - Specifies whether a parameter is an input or output parameter. - - Value range: **IN**, **OUT**, **INOUT** and **VARIDIC** - -- **argname** - - Parameter name. - - Value range: a string. It must comply with the naming convention rule. - -- **argtype** - - Parameter type. - - Value range: a valid type. For details, see [Data Types](data-types.md). - -- **CALLED ON NULL INPUT** - - Declares that some parameters of the function can be invoked in normal mode if the parameter values are null. Omitting this parameter is the same as specifying it. - -- **RETURNS NULL ON NULL INPUT** - - **STRICT** - - Specifies that the function always returns null whenever any of its parameters is null. If **STRICT** is specified, the function will not be executed when there are null parameters; instead a null result is assumed automatically. - - **RETURNS NULL ON NULL INPUT** and **STRICT** have the same functions. - -- **IMMUTABLE** - - Specifies that the function always returns the same result if the parameter values are the same. - -- **STABLE** - - Specifies that the function cannot modify the database, and that within a single table scan it will consistently return the same result for the same parameter value, but its result varies by SQL statements. - -- **VOLATILE** - - Specifies that the function value can change in a single table scan and no optimization is performed. - -- **LEAKPROOF** - - Specifies that the function has no side effect and the parameter contains only the return value. **LEAKROOF** can be set only by a system administrator. - -- **EXTERNAL** - - \(Optional\) The purpose is to be compatible with SQL. This feature applies to all functions, not only external functions. - -- **SECURITY INVOKER** - - **AUTHID CURRENT\_USER** - - Specifies that the function will be executed with the permissions of the user who invokes it. Omitting this parameter is the same as specifying it. - - **SECURITY INVOKER** and **AUTHID CURRENT\_USER** have the same functions. - -- **SECURITY DEFINER** - - **AUTHID DEFINER** - - Specifies that the function will be executed with the permissions of the user who created it. - - **AUTHID DEFINER** and **SECURITY DEFINER** have the same function. - -- **COST execution\_cost** - - Estimates the execution cost of a function. - - The unit of **execution\_cost** is **cpu\_operator\_cost**. - - Value range: a positive integer - -- **ROWS result\_rows** - - Estimates the number of rows returned by the function. This is only allowed when the function is declared to return a set. - - Value range: a positive number. The default value is **1000**. - -- **configuration\_parameter** - - **value** - - Sets a specified database session parameter to a specified value. If the value is **DEFAULT** or **RESET**, the default setting is used in the new session. **OFF** closes the setting. - - Value range: a string - - - DEFAULT - - OFF - - RESET - - Specifies the default value. - - - **from current** - - Uses the value of **configuration\_parameter** of the current session. - - -- **new\_name** - - Specifies the new name of a function. To change the schema of a function, you must have the **CREATE** permission on the new schema. - - Value range: a string. It must comply with the naming convention rule. - -- **new\_owner** - - Specifies the new owner of a function. To change the owner of a function, the new owner must have the **CREATE** permission on the schema to which the function belongs. - - Value range: an existing user role - -- **new\_schema** - - Specifies the new schema of a function. - - Value range: an existing schema - - -## Examples - -See [Examples](create-function.md#en-us_topic_0237122104_en-us_topic_0059778837_scc61c5d3cc3e48c1a1ef323652dda821) in **CREATE FUNCTION**. - -## Helpful Links - -[CREATE FUNCTION](create-function.md) and [DROP FUNCTION](drop-function.md) - diff --git a/content/en/docs/installation/Developerguide/alter-group.md b/content/en/docs/installation/Developerguide/alter-group.md deleted file mode 100644 index 0fa17ac90840228d7a704e60705d5b0a0952a78a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-group.md +++ /dev/null @@ -1,56 +0,0 @@ -# ALTER GROUP - -## Function - -**ALTER GROUP** modifies the attributes of a user group. - -## Precautions - -**ALTER GROUP** is an alias for **ALTER ROLE**, and it is not a standard SQL syntax and not recommended. Users can use **ALTER ROLE** directly. - -## Syntax - -- Add users to a group. - - ``` - ALTER GROUP group_name - ADD USER user_name [, ... ]; - ``` - - -- Remove users from a group. - - ``` - ALTER GROUP group_name - DROP USER user_name [, ... ]; - ``` - -- Change the name of the group. - - ``` - ALTER GROUP group_name - RENAME TO new_name; - ``` - - -## Parameter Description - -See [Parameter Description](alter-role.md#en-us_topic_0237122068_en-us_topic_0059778744_s50961af6143d4aafaf8fa02febbbf331) in **ALTER ROLE**. - -## Example - -``` --- Add users to a group. -postgres=# ALTER GROUP super_users ADD USER lche, jim; - --- Remove users from a group. -postgres=# ALTER GROUP super_users DROP USER jim; - --- Change the name of the group. -postgres=# ALTER GROUP super_users RENAME TO normal_users; -``` - -## Helpful Links - -[ALTER GROUP](alter-group.md), [DROP GROUP](drop-group.md), and [ALTER ROLE](alter-role.md) - diff --git a/content/en/docs/installation/Developerguide/alter-index.md b/content/en/docs/installation/Developerguide/alter-index.md deleted file mode 100644 index c405496afcfed6ab7af15e5c61c53fd4d579f3dd..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-index.md +++ /dev/null @@ -1,165 +0,0 @@ -# ALTER INDEX - -## Function - -**ALTER INDEX** modifies the definition of an existing index. - -It has the following forms: - -- IF EXISTS - - Sends a notice instead of an error if the specified index does not exist. - -- RENAME TO - - Changes only the name of the index. The stored data is not affected. - -- SET TABLESPACE - - This option changes the index tablespace to the specified tablespace and moves index-related data files to the new tablespace. - -- SET \( \{ STORAGE\_PARAMETER = value \} \[, ...\] \) - - Changes one or more index-method-specific storage parameters of an index. Note that the index content will not be modified immediately by this statement. You may need to use **REINDEX** to recreate the index based on different parameters to achieve the expected effect. - -- RESET \( \{ storage\_parameter \} \[, ...\] \) - - Resets one or more index-method-specific storage parameters of an index to the default value. Similar to the **SET** statement, **REINDEX** may be used to completely update the index. - -- \[ MODIFY PARTITION index\_partition\_name \] UNUSABLE - - Sets the indexes on a table or index partition to be unavailable. - -- REBUILD \[ PARTITION index\_partition\_name \] - - Rebuilds indexes on a table or an index partition. - -- RENAME PARTITION - - Renames an index partition. - -- MOVE PARTITION - - Modifies the tablespace to which an index partition belongs. - - -## Precautions - -Only the index owner or a system administrator can run this statement. - -## Syntax - -- Rename a table index. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - RENAME TO new_name; - ``` - - -- Change the tablespace to which a table index belongs. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - SET TABLESPACE tablespace_name; - ``` - - -- Modify the storage parameter of a table index. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - SET ( {storage_parameter = value} [, ... ] ); - ``` - - -- Reset the storage parameter of a table index. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - RESET ( storage_parameter [, ... ] ) ; - ``` - - -- Set a table index or an index partition to be unavailable. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - [ MODIFY PARTITION index_partition_name ] UNUSABLE; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The syntax cannot be used for column-store tables. - - -- Rebuild a table index or index partition. - - ``` - ALTER INDEX index_name - REBUILD [ PARTITION index_partition_name ]; - ``` - - -- Rename an index partition. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - RENAME PARTITION index_partition_name TO new_index_partition_name; - ``` - - -- Modify the tablespace to which an index partition belongs. - - ``` - ALTER INDEX [ IF EXISTS ] index_name - MOVE PARTITION index_partition_name TABLESPACE new_tablespace; - ``` - - -## Parameter Description - -- **index\_name** - - Specifies the index name to be modified. - -- **new\_name** - - Specifies the new name of the index. - - Value range: a string. It must comply with the naming convention rule. - -- **tablespace\_name** - - Specifies the tablespace name. - - Value range: an existing tablespace name - -- **storage\_parameter** - - Specifies the name of an index-method-specific parameter. - -- **value** - - Specifies the new value for an index-method-specific storage parameter. This might be a number or a word depending on the parameter. - -- **new\_index\_partition\_name** - - Specifies the new name of the index partition. - -- **index\_partition\_name** - - Specifies the name of an index partition. - -- **new\_tablespace** - - Specifies a new tablespace. - - -## Examples - -See [Examples](create-index.md#en-us_topic_0237122106_en-us_topic_0059777455_s985289833081489e9d77c485755bd362) in **CREATE INDEX**. - -## Helpful Links - -[CREATE INDEX](create-index.md), [DROP INDEX](drop-index.md), and [REINDEX](reindex.md) - diff --git a/content/en/docs/installation/Developerguide/alter-large-object.md b/content/en/docs/installation/Developerguide/alter-large-object.md deleted file mode 100644 index 8a099797562a07e22d8bb7ede2d533e92db7a6d4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-large-object.md +++ /dev/null @@ -1,36 +0,0 @@ -# ALTER LARGE OBJECT - -## Function - -**ALTER LARGE OBJECT** changes the owner of a large object. - -## Precautions - -Only a system administrator or the owner of the to-be-modified large object can run **ALTER LARGE OBJECT**. - -## Syntax - -``` -ALTER LARGE OBJECT large_object_oid - OWNER TO new_owner; -``` - -## Parameter Description - -- **large\_object\_oid** - - Specifies the OID of the large object to be modified. - - Value range: an existing large object name - -- **OWNER TO new\_owner** - - Specifies the new owner of an object. - - Value range: an existing username or role name - - -## Examples - -None - diff --git a/content/en/docs/installation/Developerguide/alter-materialized-view.md b/content/en/docs/installation/Developerguide/alter-materialized-view.md deleted file mode 100644 index 700d1940c78b546cb7454380eaa9447484ecf8bf..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-materialized-view.md +++ /dev/null @@ -1,115 +0,0 @@ -# ALTER MATERIALIZED VIEW - -## Function - -**ALTER MATERIALIZED VIEW** changes multiple auxiliary attributes of an existing materialized view. - -Statements and actions that can be used for ALTER MATERIALIZED VIEW are a subset of ALTER TABLE and have the same meaning when used for materialized views. For details, see [ALTER TABLE](ALTER-TABLE.md). - -## Precautions - -- Only the owner of a materialized view or a system administrator has the **ALTER TMATERIALIZED VIEW** permission. -- The materialized view structure cannot be modified. - -## Syntax - -- Modify the definition of the materialized view. - - ``` - ALTER - MATERIALIZED VIEW - [ IF EXISTS ] mv_name - action [, ... ]; - ; - ``` - -- Modify the column of a materialized view. - - ``` - ALTER MATERIALIZED VIEW [ IF EXISTS ] mv_name - RENAME [ COLUMN ] column_name TO new_column_name; - ``` - -- Rename a materialized view. - - ``` - ALTER MATERIALIZED VIEW [ IF EXISTS ] mv_name - - RENAME TO new_name; - ``` - -- Set the schema of a materialized view. - - ``` - ALTER MATERIALIZED VIEW [ IF EXISTS ] mv_name - SET SCHEMA new_schema; - ``` - -- Set the tablespace of a materialized view. - - ``` - ALTER MATERIALIZED VIEW [ IF EXISTS ] mv_name - SET TABLESPACE new_tablespace; - ``` - -- There are several clauses of **action**: - - ``` - ALTER [ COLUMN ] column_name - - SET STATISTICS integer - ALTER [ COLUMN ] column_name - RESET ( attribute_option [, ... ] ) - ALTER [ COLUMN ] column_name - SET ( attribute_option = value [, ... ] ) - ALTER [ COLUMN ] column_name - SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } - CLUSTER ON index_name - SET WITHOUT CLUSTER - SET ( storage_parameter = value [, ... ] ) - RESET ( storage_parameter [, ... ] ) - ``` - - -## Parameter Description - -- **mv\_name** - - Specifies the name of an existing materialized view, which can be schema-qualified. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies the name of a new or existing column. - - Value range: a string. It must comply with the naming convention. - -- **new\_column\_name** - - Specifies the new name of an existing column. - -- **new\_owner** - - Specifies the user name of the new owner of a materialized view. - -- **new\_name** - - Specifies the new name of a materialized view. - -- **new\_schema** - - Specifies the new schema of a materialized view. - - -## Examples - -``` --- Rename the materialized view foo to bar. -postgres=# ALTER MATERIALIZED VIEW foo RENAME TO bar; -``` - -## Helpful Links - -[CREATE VIEW](CREATE-VIEW.md), [DROP VIEW](drop-view.md), [CREATE MATERIALIZED VIEW](create-materialized-view.md), [DROP MATERIALIZED VIEW](drop-materialized-view.md), [REFRESH MATERIALIZED VIEW](refresh-materialized-view.md), and [ALTER TABLE](alter-table.md) - diff --git a/content/en/docs/installation/Developerguide/alter-role.md b/content/en/docs/installation/Developerguide/alter-role.md deleted file mode 100644 index 5048ae0e2e1c46a4b343db8a9555b38343be5abc..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-role.md +++ /dev/null @@ -1,115 +0,0 @@ -# ALTER ROLE - -## Function - -**ALTER ROLE** modifies role attributes. - -## Precautions - -None - -## Syntax - -- Modify the permissions of a role. - - ``` - ALTER ROLE role_name [ [ WITH ] option [ ... ] ]; - ``` - - The **option** clause for granting permissions is as follows: - - ``` - {CREATEDB | NOCREATEDB} - | {CREATEROLE | NOCREATEROLE} - | {INHERIT | NOINHERIT} - | {AUDITADMIN | NOAUDITADMIN} - | {SYSADMIN | NOSYSADMIN} - | {USEFT | NOUSEFT} - | {LOGIN | NOLOGIN} - | {REPLICATION | NOREPLICATION} - | {INDEPENDENT | NOINDEPENDENT} - | {VCADMIN | NOVCADMIN} - | CONNECTION LIMIT connlimit - | [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password' - | [ ENCRYPTED | UNENCRYPTED ] IDENTIFIED BY 'password' [ REPLACE 'old_password' ] - | [ ENCRYPTED | UNENCRYPTED ] PASSWORD { 'password' | DISABLE } - | [ ENCRYPTED | UNENCRYPTED ] IDENTIFIED BY { 'password' [ REPLACE 'old_password' ] | DISABLE } - | VALID BEGIN 'timestamp' - | VALID UNTIL 'timestamp' - | RESOURCE POOL 'respool' - | PERM SPACE 'spacelimit' - | ACCOUNT { LOCK | UNLOCK } - | PGUSER - ``` - -- Rename a role. - - ``` - ALTER ROLE role_name - RENAME TO new_name; - ``` - -- Set parameters for a role. - - ``` - ALTER ROLE role_name [ IN DATABASE database_name ] - SET configuration_parameter {{ TO | = } { value | DEFAULT } | FROM CURRENT}; - ``` - -- Reset parameters for a role. - - ``` - ALTER ROLE role_name - [ IN DATABASE database_name ] RESET {configuration_parameter|ALL}; - ``` - - -## Parameter Description - -- **role\_name** - - Specifies a role name. - - Value range: an existing username - -- **IN DATABASE database\_name** - - Modifies the parameters of a role in a specified database. - -- **SET configuration\_parameter** - - Sets parameters for a role. Session parameters modified by **ALTER ROLE** apply to a specified role and take effect in the next session triggered by the role. - - Value range: - - For details about the values of **configuration\_parameter** and **value**, see [SET](set.md). - - **DEFAULT**: clears the value of **configuration\_parameter**. **configuration\_parameter** will inherit the default value of the new session generated for the role. - - **FROM CURRENT**: uses the value of **configuration\_parameter** of the current session. - -- **RESET configuration\_parameter/ALL** - - Clears the value of **configuration\_parameter**. The statement has the same effect as that of **SET configuration\_parameter TO DEFAULT**. - - Value range: **ALL** indicates that the values of all parameters are cleared. - -- **ACCOUNT LOCK | ACCOUNT UNLOCK** - - **ACCOUNT LOCK**: locks an account to forbid login to databases. - - **ACCOUNT UNLOCK**: unlocks an account to allow login to databases. - -- **PGUSER** - - In the current version, the **PGUSER** attribute of a role cannot be modified. - - -For details about other parameters, see [Parameter Description](create-role.md#en-us_topic_0237122112_en-us_topic_0059778189_s5a43ec5742a742089e2c302063de7fe4) in **CREATE ROLE**. - -## Example - -See [Example:](create-role.md#en-us_topic_0237122112_en-us_topic_0059778189_s0dea2f90b8474387aff0ab3f366a611e) in **CREATE ROLE**. - -## Helpful Links - -[CREATE ROLE](create-role.md), [DROP ROLE](drop-role.md), and [SET](set.md) - diff --git a/content/en/docs/installation/Developerguide/alter-row-level-security-policy.md b/content/en/docs/installation/Developerguide/alter-row-level-security-policy.md deleted file mode 100644 index 19ad4db920a297f636d2d8893b55b1fc81208453..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-row-level-security-policy.md +++ /dev/null @@ -1,107 +0,0 @@ -# ALTER ROW LEVEL SECURITY POLICY - -## Function - -**ALTER ROW LEVEL SECURITY POLICY** modifies an existing row-level access control policy, including the policy name and the users and expressions affected by the policy. - -## Precautions - -Only the table owner or a system administrator can perform this operation. - -## Syntax - -``` -ALTER [ ROW LEVEL SECURITY ] POLICY [ IF EXISTS ] policy_name ON table_name RENAME TO new_policy_name; - -ALTER [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name - [ TO { role_name | PUBLIC } [, ...] ] - [ USING ( using_expression ) ]; -``` - -## Parameter Description - -- policy\_name - - Specifies the name of a row-level access control policy. - -- table\_name - - Specifies the name of a table to which a row-level access control policy is applied. - -- new\_policy\_name - - Specifies the new name of a row-level access control policy. - -- role\_name - - Specifies names of users affected by a row-level access control policy. PUBLIC indicates that the row-level access control policy will affect all users. - -- using\_expression - - Specifies an expression defined for a row-level access control policy. The return value is of the boolean type. - - -## Examples - -``` --- Create the data table all_data. -postgres=# CREATE TABLE all_data(id int, role varchar(100), data varchar(100)); - ---Create a row-level access control policy to specify that the current user can view only their own data. -postgres=# CREATE ROW LEVEL SECURITY POLICY all_data_rls ON all_data USING(role = CURRENT_USER); -postgres=# \d+ all_data - Table "public.all_data" - Column | Type | Modifiers | Storage | Stats target | Description ---------+------------------------+-----------+----------+--------------+------------- - id | integer | | plain | | - role | character varying(100) | | extended | | - data | character varying(100) | | extended | | -Row Level Security Policies: - POLICY "all_data_rls" - USING (((role)::name = "current_user"())) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: orientation=row, compression=no - --- Change the name of the all_data_rls policy. -postgres=# ALTER ROW LEVEL SECURITY POLICY all_data_rls ON all_data RENAME TO all_data_new_rls; - --- Change the users affected by the row-level access control policy. -postgres=# ALTER ROW LEVEL SECURITY POLICY all_data_new_rls ON all_data TO alice, bob; -postgres=# \d+ all_data - Table "public.all_data" - Column | Type | Modifiers | Storage | Stats target | Description ---------+------------------------+-----------+----------+--------------+------------- - id | integer | | plain | | - role | character varying(100) | | extended | | - data | character varying(100) | | extended | | -Row Level Security Policies: - POLICY "all_data_new_rls" - TO alice,bob - USING (((role)::name = "current_user"())) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: orientation=row, compression=no, enable_rowsecurity=true - --- Modify the expression defined for the access control policy. -postgres=# ALTER ROW LEVEL SECURITY POLICY all_data_new_rls ON all_data USING (id > 100 AND role = current_user); -postgres=# \d+ all_data - Table "public.all_data" - Column | Type | Modifiers | Storage | Stats target | Description ---------+------------------------+-----------+----------+--------------+------------- - id | integer | | plain | | - role | character varying(100) | | extended | | - data | character varying(100) | | extended | | -Row Level Security Policies: - POLICY "all_data_new_rls" - TO alice,bob - USING (((id > 100) AND ((role)::name = "current_user"()))) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: orientation=row, compression=no, enable_rowsecurity=true -``` - -## Helpful Links - -[CREATE ROW LEVEL SECURITY POLICY](create-row-level-security-policy.md) and [DROP ROW LEVEL SECURITY POLICY](drop-row-level-security-policy.md) - diff --git a/content/en/docs/installation/Developerguide/alter-schema.md b/content/en/docs/installation/Developerguide/alter-schema.md deleted file mode 100644 index fc9db0aac9a740a5ae5d0648b8b1e4d54916c8e1..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-schema.md +++ /dev/null @@ -1,76 +0,0 @@ -# ALTER SCHEMA - -## Function - -**ALTER SCHEMA** modifies schema properties. - -## Precautions - -Only the owner of a schema or a system administrator has the permission to run the **ALTER SCHEMA** statement. - -## Syntax - -- Rename a schema. - - ``` - ALTER SCHEMA schema_name - RENAME TO new_name; - ``` - -- Change the owner of a schema. - - ``` - ALTER SCHEMA schema_name - OWNER TO new_owner; - ``` - - -## Parameter Description - -- **schema\_name** - - Specifies the name of an existing schema. - - Value range: an existing schema name - -- **RENAME TO new\_name** - - Renames a schema. - - **new\_name**: new name of the schema. - - Value range: a string. It must comply with the naming convention rule. - -- **OWNER TO new\_owner** - - Changes the owner of a schema. To do this as a non-administrator, you must be a direct or indirect member of the new owning role, and that role must have **CREATE** permission in the database. - - **new\_owner**: new owner of the schema. - - Value range: an existing username or role name - - -## Examples - -``` --- Create the ds schema. -postgres=# CREATE SCHEMA ds; - --- Rename the current schema ds to ds_new. -postgres=# ALTER SCHEMA ds RENAME TO ds_new; - --- Create user jack. -postgres=# CREATE USER jack PASSWORD 'Bigdata@123'; - --- Change the owner of ds_new to jack. -postgres=# ALTER SCHEMA ds_new OWNER TO jack; - --- Delete user jack and schema ds_new. -postgres=# DROP SCHEMA ds_new; -postgres=# DROP USER jack; -``` - -## Helpful Links - -[CREATE SCHEMA](create-schema.md) and [DROP SCHEMA](drop-schema.md) - diff --git a/content/en/docs/installation/Developerguide/alter-sequence.md b/content/en/docs/installation/Developerguide/alter-sequence.md deleted file mode 100644 index f0c4449924edc637eb0567dfcf836bc8dab138aa..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-sequence.md +++ /dev/null @@ -1,76 +0,0 @@ -# ALTER SEQUENCE - -## Function - -**ALTER SEQUENCE** modifies the parameters of an existing sequence. - -## Precautions - -- You must be the owner of the sequence to use **ALTER SEQUENCE**. -- In the current version, you can modify only the owner, owning column, and maximum value. To modify other parameters, delete the sequence and create it again. Then, use the **Setval** function to restore parameter values. -- **ALTER SEQUENCE MAXVALUE** cannot be used in transactions, functions, and stored procedures. -- After the maximum value of a sequence is changed, the cache of the sequence in all sessions is cleared. -- The **ALTER SEQUENCE** statement blocks the invoking of **nextval**, **setval**, **currval**, and **lastval**. - -## Syntax - -Change the owning column of a sequence. - -``` -ALTER SEQUENCE [ IF EXISTS ] name - [MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE] - [ OWNED BY { table_name.column_name | NONE } ] ; -``` - -Change the owner of a sequence. - -``` -ALTER SEQUENCE [ IF EXISTS ] name OWNER TO new_owner; -``` - -## Parameter Description - -- name - - Specifies the name of the sequence to be modified. - -- IF EXISTS - - Sends a notice instead of an error when you are modifying a nonexisting sequence. - -- OWNED BY - - Associates a sequence with a specified column included in a table. In this way, the sequence will be deleted when you delete its associated column or the table where the column belongs to. - - If the sequence has been associated with another table before you use this option, the new association will overwrite the old one. - - The associated table and sequence must be owned by the same user and in the same schema. - - If **OWNED BY NONE** is used, all existing associations will be deleted. - -- new\_owner - - Specifies the username of the new owner of the sequence. To change the owner, you must also be a direct or indirect member of the new role, and this role must have **CREATE** permission on the sequence's schema. - - -## Examples - -``` --- Create an ascending sequence named serial, which starts from 101. -postgres=# CREATE SEQUENCE serial START 101; - --- Create a table and specify default values for the sequence. -postgres=# CREATE TABLE T1(C1 bigint default nextval('serial')); - --- Change the owning column of serial to T1.C1. -postgres=# ALTER SEQUENCE serial OWNED BY T1.C1; - --- Delete the sequence. -postgres=# DROP SEQUENCE serial cascade; -postgres=# DROP TABLE T1; -``` - -## Helpful Links - -[CREATE SEQUENCE](create-sequence.md) and [DROP SEQUENCE](drop-sequence.md) - diff --git a/content/en/docs/installation/Developerguide/alter-server.md b/content/en/docs/installation/Developerguide/alter-server.md deleted file mode 100644 index 3f5cfcf85d245ba76db6bd2da1c57c09d8470396..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-server.md +++ /dev/null @@ -1,103 +0,0 @@ -# ALTER SERVER - -## Function - -**ALTER SERVER** adds, modifies, or deletes the parameters of an existing server. You can query existing servers from the **pg\_foreign\_server** system catalog. - -## Precautions - -Only the owner of a server or a system administrator can run this statement. - -## Syntax - -- Change the parameters for a foreign server. - -``` - ALTER SERVER server_name [ VERSION 'new_version' ] - [ OPTIONS ( {[ ADD | SET | DROP ] option ['value']} [, ... ] ) ]; -``` - - In **OPTIONS**, **ADD**, **SET**, and **DROP** are operations to be performed. If these operations are not specified, **ADD** operations will be performed by default. **option** and **value** are the parameters of the corresponding operation. - - -- Change the name of a foreign server. - - ``` - ALTER SERVER server_name - RENAME TO new_name; - ``` - - -## Parameter Description - -- **server\_name** - - Specifies the name of the server to be modified. - -- **new\_version** - - Specifies the new version of the server. - -- **OPTIONS** - - Change options of the server. **ADD**, **SET**, and **DROP** are operations to be performed. If the operation is not set explicitly, **ADD** is used. The option name must be unique, and the name and value are also validated with the foreign data wrapper library of the server. - - - Options supported by oracle\_fdw are as follows: - - **dbserver** - - Connection string of the remote Oracle database. - - - **isolation\_level** \(default value: **serializable**\) - - Oracle database transaction isolation level. - - Value range: serializable, read\_committed, read\_only - - - Options supported by mysql\_fdw are as follows: - - **host** \(default value: **127.0.0.1**\) - - IP address of the MySQL server or MariaDB. - - - **port** \(default value: **3306**\) - - Listening port number of the MySQL server or MariaDB. - - - The options supported by postgres\_fdw are the same as those supported by libpq. For details, see [Connection Characters](en-us_topic_0242848655.md). Note that the following options cannot be modified: - - **user** and **password** - - The user name and password are specified when the user mapping is created. - - - **client\_encoding** - - The encoding mode of the local server is automatically obtained and set. - - - **application\_name** - - This option is always set to **postgres\_fdw**. - - - In addition to the connection parameters supported by libpq, the following options are provided: - - - **use\_remote\_estimate** - - Controls whether postgres\_fdw issues the EXPLAIN command to obtain the estimated run time. The default value is **false**. - - - **fdw\_startup\_cost** - - Estimates the startup time required for a foreign table scan, including the time to establish a connection, analyze the request at the remote server, and generate a plan. The default value is **100**. - - - **fdw\_typle\_cost** - - Specifies the additional consumption when each tuple is scanned on a remote server. The value specifies the extra consumption of data transmission between servers. The default value is **0.01**. - - - -- **new\_name** - - Specifies the new name of the server. - - -## Helpful Links - -[CREATE SERVER ](create-server.md) and [CREATE SERVER](drop-server.md) - diff --git a/content/en/docs/installation/Developerguide/alter-session.md b/content/en/docs/installation/Developerguide/alter-session.md deleted file mode 100644 index 9f1cdab92edc02e33b6df24839680efbfb75afec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-session.md +++ /dev/null @@ -1,85 +0,0 @@ -# ALTER SESSION - -## Function - -**ALTER SESSION** defines or modifies the conditions or parameters that affect the current session. Modified session parameters are kept until the current session is disconnected. - -## Precautions - -- If the **START TRANSACTION** statement is not executed before the **SET TRANSACTION** statement, the transaction is ended instantly and the statement does not take effect. -- You can use the **transaction\_mode\(s\)** method declared in the **START TRANSACTION** statement to avoid using the **SET TRANSACTION** statement. - -## Syntax - -- Set transaction parameters of a session. - - ``` - ALTER SESSION SET [ SESSION CHARACTERISTICS AS ] TRANSACTION - { ISOLATION LEVEL { READ COMMITTED } | { READ ONLY | READ WRITE } } [, ...] ; - ``` - -- Set other running parameters of a session. - - ``` - ALTER SESSION SET - {{config_parameter { { TO | = } { value | DEFAULT } - | FROM CURRENT }} - | TIME ZONE time_zone - | CURRENT_SCHEMA schema - | NAMES encoding_name - | ROLE role_name PASSWORD 'password' - | SESSION AUTHORIZATION { role_name PASSWORD 'password' | DEFAULT } - | XML OPTION { DOCUMENT | CONTENT } - } ; - ``` - - -## Parameter Description - -For details about the descriptions of parameters related to **ALTER SESSION**, see [Parameter Description](set.md#en-us_topic_0237122186_en-us_topic_0059779029_s39823c7ebd854a9f9c761b3a32b1c3c3) of the SET syntax. - -## Examples - -``` --- Create the ds schema. -postgres=# CREATE SCHEMA ds; - --- Set the search path of the schema. -postgres=# SET SEARCH_PATH TO ds, public; - --- Set the time/date type to the traditional postgres format (date before month). -postgres=# SET DATESTYLE TO postgres, dmy; - --- Set the character code of the current session to UTF8. -postgres=# ALTER SESSION SET NAMES 'UTF8'; - --- Set the time zone to Berkeley of California. -postgres=# SET TIME ZONE 'PST8PDT'; - --- Set the time zone to Italy. -postgres=# SET TIME ZONE 'Europe/Rome'; - --- Set the current schema. -postgres=# ALTER SESSION SET CURRENT_SCHEMA TO tpcds; - --- Set XML OPTION to DOCUMENT. -postgres=# ALTER SESSION SET XML OPTION DOCUMENT; - --- Create the role joe and set it as the session role. -postgres=# CREATE ROLE joe WITH PASSWORD 'Bigdata@123'; -postgres=# ALTER SESSION SET SESSION AUTHORIZATION joe PASSWORD 'Bigdata@123'; - --- Switch to the default user. -postgres=> ALTER SESSION SET SESSION AUTHORIZATION default; - --- Delete the ds schema. -postgres=# DROP SCHEMA ds; - --- Delete the role joe. -postgres=# DROP ROLE joe; -``` - -## Helpful Links - -[SET](set.md) - diff --git a/content/en/docs/installation/Developerguide/alter-synonym.md b/content/en/docs/installation/Developerguide/alter-synonym.md deleted file mode 100644 index 0dcf779e758d459fea56760876d82bedc680771c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-synonym.md +++ /dev/null @@ -1,58 +0,0 @@ -# ALTER SYNONYM - -## Function - -**ALTER SYNONYM** modifies the attributes of the **SYNONYM** object. - -## Precautions - -- Currently, only the owner of the **SYNONYM** object can be changed. -- Only the system administrator has the permission to modify the owner of the **SYNONYM** object. -- The new owner must have the **CREATE** permission on the schema where the **SYNONYM** object resides. - -## Syntax - -``` -ALTER SYNONYM synonym_name - OWNER TO new_owner; -``` - -## Parameter Description - -- **synonym** - - Specifies the name of the synonym to be modified, which can contain the schema name. - - Value range: a string. It must comply with the naming convention rule. - - -- **new\_owner** - - Specifies the new owner of the **SYNONYM** object. - - Value range: a string. It must be a valid username. - - -## Examples - -``` --- Create synonym t1. -postgres=# CREATE OR REPLACE SYNONYM t1 FOR ot.t1; - --- Create a user u1. -postgres=# CREATE USER u1 PASSWORD 'user@111'; - --- Change the owner of synonym t1 to u1. -postgres=# ALTER SYNONYM t1 OWNER TO u1; - --- Delete synonym t1. -postgres=# DROP SYNONYM t1; - --- Delete user u1. -postgres=# DROP USER u1; -``` - -## Helpful Links - -[CREATE DATA SOURCE](create-data-source.md) and [DROP DATA SOURCE](drop-data-source.md) - diff --git a/content/en/docs/installation/Developerguide/alter-system-kill-session.md b/content/en/docs/installation/Developerguide/alter-system-kill-session.md deleted file mode 100644 index d092da95cff7eb1ac55f226a6de83861a0cd230d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-system-kill-session.md +++ /dev/null @@ -1,50 +0,0 @@ -# ALTER SYSTEM KILL SESSION - -## Function - -**ALTER SYSTEM KILL SESSION** ends a session. - -## Precautions - -None - -## Syntax - -``` -ALTER SYSTEM KILL SESSION 'session_sid, serial' [ IMMEDIATE ]; -``` - -## Parameter Description - -- **session\_sid, serial** - - Specifies the SID and SERIAL of a session \(To obtain the values, see the example.\) - -- **IMMEDIATE** - - Specifies that a session will be ended instantly after the statement is executed. - - -## Example - -``` --- Query session information. -postgres=# -SELECT sa.sessionid AS sid,0::integer AS serial#,ad.rolname AS username FROM pg_stat_get_activity(NULL) AS sa -LEFT JOIN pg_authid ad ON(sa.usesysid = ad.oid)WHERE sa.application_name <> 'JobScheduler'; - sid | serial# | username ------------------+---------+---------- - 140131075880720 | 0 | omm - 140131025549072 | 0 | omm - 140131073779472 | 0 | omm - 140131071678224 | 0 | omm - 140131125774096 | 0 | - 140131127875344 | 0 | - 140131113629456 | 0 | - 140131094742800 | 0 | -(8 rows) - --- End the session whose SID is 140131075880720. -postgres=# ALTER SYSTEM KILL SESSION '140131075880720,0' IMMEDIATE; -``` - diff --git a/content/en/docs/installation/Developerguide/alter-table-partition.md b/content/en/docs/installation/Developerguide/alter-table-partition.md deleted file mode 100644 index 4658e06b6b842b399c1981852601f5cf1ac2c520..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-table-partition.md +++ /dev/null @@ -1,248 +0,0 @@ -# ALTER TABLE PARTITION - -## Function - -**ALTER TABLE PARTITION** modifies table partition, including adding, deleting, splitting, merging partitions, and modifying partition attributes. - -## Precautions - -- The tablespace for the added partition cannot be **PG\_GLOBAL**. -- The name of the added partition must be different from names of existing partitions in the partition table. -- The partition key of the added partition must be the same type as that of the partition table. The key value of the added partition must exceed the upper limit of the last partition range. -- If the number of partitions in the target partition table has reached the maximum \(32767\), partitions cannot be added. - -- If a partition table has only one partition, the partition cannot be deleted. -- Use **PARTITION FOR\(\)** to choose partitions. The number of specified values in the brackets should be the same as the column number in customized partition, and they must be consistent. -- The **Value** partition table does not support the **Alter Partition** operation. -- Column-store tables and row-store tables cannot be partitioned. -- Partitions cannot be added to an interval partitioned table. - -## Syntax - -- Modify the syntax of the table partition. - - ``` - ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} - action [, ... ]; - ``` - - **action** indicates the following clauses for maintaining partitions. For the partition continuity when multiple clauses are used for partition maintenance, openGauss does **DROP PARTITION** and then **ADD PARTITION**, and finally runs the rest clauses in sequence. - - ``` - move_clause | - exchange_clause | - row_clause | - merge_clause | - modify_clause | - split_clause | - add_clause | - drop_clause - ``` - - - The **move\_clause** syntax is used to move the partition to a new tablespace. - - ``` - MOVE PARTITION { partion_name | FOR ( partition_value [, ...] ) } TABLESPACE tablespacename - ``` - - - The **exchange\_clause** syntax is used to move the data from a general table to a specified partition. - - ``` - EXCHANGE PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } - WITH TABLE {[ ONLY ] ordinary_table_name | ordinary_table_name * | ONLY ( ordinary_table_name )} - [ { WITH | WITHOUT } VALIDATION ] [ VERBOSE ] - ``` - - The ordinary table and partition whose data is to be exchanged must meet the following requirements: - - - The number of columns of the ordinary table is the same as that of the partition, and their information should be consistent, including: column name, data type, constraint, collation information, storage parameter, and compression information. - - The compression information of the ordinary table and partition should be consistent. - - The distribution key information of the ordinary table and partition should be consistent. - - The number and information of indexes of the ordinary table and partition should be consistent. - - The number and information of constraints of the ordinary table and partition should be consistent. - - The ordinary table cannot be a temporary table. - - When the exchange is done, the data and tablespace of the ordinary table and partition are exchanged. The statistics of the ordinary table and partition are no longer inaccurate after the exchange, and they should be analyzed again. - - - The **row\_clause** syntax is used to set row movement of a partitioned table. - - ``` - { ENABLE | DISABLE } ROW MOVEMENT - ``` - - - The **merge\_clause** syntax is used to merge partitions into one. - - ``` - MERGE PARTITIONS { partition_name } [, ...] INTO PARTITION partition_name - [ TABLESPACE tablespacename ] - ``` - - - The **modify\_clause** syntax is used to set whether a partition index is usable. - - ``` - MODIFY PARTITION partition_name { UNUSABLE LOCAL INDEXES | REBUILD UNUSABLE LOCAL INDEXES } - ``` - - - The **split\_clause** syntax is used to split one partition into partitions. - - ``` - SPLIT PARTITION { partition_name | FOR ( partition_value [, ...] ) } { split_point_clause | no_split_point_clause } - ``` - - - The **split\_point\_clause** syntax is used to specify a split point. - - ``` - AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) - ``` - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- Column-store tables and row-store tables cannot be partitioned. - >- The size of the split point should be in the range of partition keys of the partition to be split. The split point can only split one partition into two new partitions. - - - The **no\_split\_point\_clause** syntax does not specify a split point. - - ``` - INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } - ``` - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- The first new partition key specified by **partition\_less\_than\_item** should be greater than that of the previously split partition \(if any\), and the last partition key specified by **partition\_item\_clause** should equal that of the partition being split. - >- The first new partition key specified by **partition\_start\_end\_item** should equal that of the former partition \(if any\), and the last partition key specified by **partition\_start\_end\_item** should equal that of the partition being split. - >- **partition\_less\_than\_item** supports a maximum of 4 partition keys, while **partition\_start\_end\_item** supports only one partition key. For details about the supported data types, see [PARTITION BY RANGE\(parti...](create-table-partition.md#en-us_topic_0237122119_en-us_topic_0059777586_l00efc30fe63048ffa2ef68c5b18bb455). - >- **partition\_less\_than\_item** and **partition\_start\_end\_item** cannot be used in the same statement. - - - - The syntax of **partition\_less\_than\_item** is as follows: - - ``` - PARTITION partition_name VALUES LESS THAN ( { partition_value | MAXVALUE } [, ...] ) - [ TABLESPACE tablespacename ] - ``` - - - The syntax of **partition\_start\_end\_item** is as follows. For details about the constraints, see [partition\_start\_end\_item syntax](create-table-partition.md#en-us_topic_0237122119_li2094151861116). - - ``` - PARTITION partition_name { - {START(partition_value) END (partition_value) EVERY (interval_value)} | - {START(partition_value) END ({partition_value | MAXVALUE})} | - {START(partition_value)} | - {END({partition_value | MAXVALUE})} - } [TABLESPACE tablespace_name] - - ``` - - - - The **add\_clause** syntax is used to add one or more partitions to a specified partitioned table. - - ``` - ADD {partition_less_than_item | partition_start_end_item} - ``` - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- Partitions cannot be added to an interval partitioned table. - - - The **drop\_clause** syntax is used to remove a partition from a specified partitioned table. - - ``` - DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } - ``` - - -- The syntax for modifying the name of a partition is as follows: - - ``` - ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} - RENAME PARTITION { partion_name | FOR ( partition_value [, ...] ) } TO partition_new_name; - ``` - - -## Parameter Description - -- **table\_name** - - Specifies the name of a partitioned table. - - Value range: an existing table name - -- **partition\_name** - - Specifies the name of a partition. - - Value range: an existing table name - -- **tablespacename** - - Specifies which tablespace the partition moves to. - - Value range: an existing table name - -- **partition\_value** - - Specifies the key value of a partition. - - The value specified by **PARTITION FOR \( partition\_value \[, ...\] \)** can uniquely identify a partition. - - Value range: partition keys for the partition to be renamed - -- **UNUSABLE LOCAL INDEXES** - - Sets all the indexes unusable in the partition. - -- **REBUILD UNUSABLE LOCAL INDEXES** - - Rebuilds all the indexes in the partition. - -- **ENABLE/DISABLE ROW MOVEMET** - - Sets row movement. - - If the tuple value is updated on the partition key during the **UPDATE** action, the partition where the tuple is located is altered. Setting this parameter enables error messages to be reported or movement of the tuple between partitions. - - Value range: - - - **ENABLE**: Row movement is enabled. - - **DISABLE**: Row movement is disabled. - - The default value is **ENABLE**. - -- **ordinary\_table\_name** - - Specifies the name of the ordinary table whose data is to be migrated. - - Value range: an existing table name - -- **\{ WITH | WITHOUT \} VALIDATION** - - Checks whether the ordinary table data meets the specified partition key range of the partition to be migrated. - - Value range: - - - **WITH**: checks whether the ordinary table data meets the partition key range of the partition to be migrated. If any data does not meet the required range, an error is reported. - - **WITHOUT**: does not check whether the ordinary table data meets the partition key range of the partition to be migrated. - - The default value is **WITH**. - - The check is time consuming, especially when the data volume is large. Therefore, use **WITHOUT** when you are sure that the current ordinary table data meets the partition key range of the partition to be migrated. - -- **VERBOSE** - - When **VALIDATION** is **WITH**, if the ordinary table contains data that is out of the partition key range, insert the data to the correct partition. If there is no correct partition where the data can be inserted to, an error is reported. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >Only when **VALIDATION** is **WITH**, **VERBOSE** can be specified. - -- **partition\_new\_name** - - Specifies the new name of a partition. - - Value range: a string. It must comply with the naming convention. - - -## Example - -See [Examples](create-table-partition.md#en-us_topic_0237122119_en-us_topic_0059777586_s43dd49de892344bf89e6f56f17404842) in **CREATE TABLE PARTITION**. - -## Helpful Links - -[CREATE TABLE PARTITION](create-table-partition.md), and [DROP TABLE](en-us_topic_0242370616.md) - diff --git a/content/en/docs/installation/Developerguide/alter-table.md b/content/en/docs/installation/Developerguide/alter-table.md deleted file mode 100644 index 0d12e3f86b3676e93aed2f8087cf4d0465c5eb9f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-table.md +++ /dev/null @@ -1,431 +0,0 @@ -# ALTER TABLE - -## Function - -**ALTER TABLE** modifies tables, including modifying table definitions, renaming tables, renaming specified columns in tables, renaming table constraints, setting table schemas, enabling or disabling row-level access control, and adding or updating multiple columns. - -## Precautions - -- Only the table owner or a system administrator has the permission to run the **ALTER TABLE** statement. -- The tablespace of a partitioned table cannot be modified, but the tablespace of the partition can be modified. -- The storage parameter **ORIENTATION** cannot be modified. -- Currently, **SET SCHEMA** can only set schemas to user schemas. It cannot set a schema to a system internal schema. -- Column-store tables support only **PARTIAL CLUSTER KEY** table-level constraints, but do not support primary and foreign key table-level constraints. -- In a column-store table, you can perform **ADD COLUMN**, **ALTER TYPE**, **SET STATISTICS**, **DROP COLUMN** operations, and change table name and space. The types of new and modified columns should be the [Data Types](data-types.md) supported by column-store. The **USING** option of **ALTER TYPE** only supports constant expression and expression involved in the column. -- The column constraints supported by column-store tables include **NULL**, **NOT NULL**, and **DEFAULT** constant values. Only the **DEFAULT** value can be modified \(by using **SET DEFAULT** and **DROP DEFAULT**\). Currently, **NULL** and **NOT NULL** constraints cannot be modified. - -- Auto-increment columns cannot be added, or a column whose **DEFAULT** value contains the **nextval\(\)** expression cannot be added. -- Row-access control cannot be enabled for foreign tables and temporary tables. -- When you delete a **PRIMARY KEY** constraint by constraint name, the **NOT NULL** constraint is not deleted. If necessary, manually delete the **NOT NULL** constraint. -- When JDBC is used, the **DEFAULT** value can be set through **PrepareStatement**. - -## Syntax - -- Modify the definition of a table. - - ``` - ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name ) } - action [, ... ]; - ``` - - There are several clauses of **action**: - - ``` - column_clause - | ADD table_constraint [ NOT VALID ] - | ADD table_constraint_using_index - | VALIDATE CONSTRAINT constraint_name - | DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] - | CLUSTER ON index_name - | SET WITHOUT CLUSTER - | SET ( {storage_parameter = value} [, ... ] ) - | RESET ( storage_parameter [, ... ] ) - | OWNER TO new_owner - | SET TABLESPACE new_tablespace - | SET {COMPRESS|NOCOMPRESS} - | TO { GROUP groupname | NODE ( nodename [, ... ] ) } - | ADD NODE ( nodename [, ... ] ) - | DELETE NODE ( nodename [, ... ] ) - | DISABLE TRIGGER [ trigger_name | ALL | USER ] - | ENABLE TRIGGER [ trigger_name | ALL | USER ] - | ENABLE REPLICA TRIGGER trigger_name - | ENABLE ALWAYS TRIGGER trigger_name - | DISABLE ROW LEVEL SECURITY - | ENABLE ROW LEVEL SECURITY - | FORCE ROW LEVEL SECURITY - | NO FORCE ROW LEVEL SECURITY - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- **ADD table\_constraint \[ NOT VALID \]** - > Adds a table constraint. - >- **ADD table\_constraint\_using\_index** - > Adds a primary key constraint or unique constraint to a table based on the existing unique index. - >- **VALIDATE CONSTRAINT constraint\_name** - > Validates a check-class constraint created with the **NOT VALID** option, and scans the entire table to ensure that all rows meet the constraint. Nothing happens if the constraint is already marked valid. - >- **DROP CONSTRAINT \[ IF EXISTS \] constraint\_name \[ RESTRICT | CASCADE \]** - > Drops a table constraint. - >- **CLUSTER ON index\_name** - > Selects the default index for future CLUSTER operations. Actually, the table is not re-clustered. - >- **SET WITHOUT CLUSTER** - > Deletes the most recently used **CLUSTER** index from the table. This affects future **CLUSTER** operations that do not specify an index. - >- **SET \( \{storage\_parameter = value\} \[, ... \] \)** - > Changes one or more storage parameters for the table. - >- **RESET \( storage\_parameter \[, ... \] \)** - > Resets one or more storage parameters to their defaults. As with **SET**, a table rewrite might be needed to update the table entirely. - >- **OWNER TO new\_owner** - > Changes the owner of a table, sequence, or view to the specified user. - >- **SET TABLESPACE new\_tablespace** - > Changes the table's tablespace to the specified tablespace and moves the data files associated with the table to the new tablespace. Indexes on the table, if any, are not moved; but they can be moved separately with additional **SET TABLESPACE** option in **ALTER INDEX**. - >- **SET \{COMPRESS|NOCOMPRESS\}** - > Sets the compression feature of a table. The table compression feature affects only the storage mode of data inserted in a batch subsequently and does not affect storage of existing data. Setting the table compression feature will result in the fact that there are both compressed and uncompressed data in the table. - >- **TO \{ GROUP groupname | NODE \( nodename \[, ... \] \) \}** - > The syntax is only available in extended mode \(when GUC parameter **support\_extended\_features** is **on**\). Exercise caution when enabling the mode. It is mainly used for tools like internal scale-out tools. Common users should not use the mode. - >- **ADD NODE \( nodename \[, ... \] \)** - > It is only available for internal scale-out tools. Common users should not use the syntax. - >- **DELETE NODE \( nodename \[, ... \] \)** - > It is only available for internal scale-in tools. Common users should not use the syntax. - >- **DISABLE TRIGGER \[ trigger\_name | ALL | USER \]** - > Disables a single trigger specified by **trigger\_name**, disables all triggers, or disables only user triggers \(excluding internally generated constraint triggers, for example, deferrable unique constraint triggers and exclusion constraint triggers\). - >![](public_sys-resources/icon-note.gif) **NOTE:** - >Exercise caution when using this function because data integrity cannot be ensured as expected if the triggers are not executed. - - - **| ENABLE TRIGGER \[ trigger\_name | ALL | USER \]** - - Enables a single trigger specified by **trigger\_name**, enables all triggers, or enables only user triggers. - - - **| ENABLE REPLICA TRIGGER trigger\_name** - - Determines that the trigger firing mechanism is affected by the configuration variable [session\_replication\_role](statement-behavior.md#en-us_topic_0237124732_en-us_topic_0059779117_sffbd1c48d86b4c3fa3287167a7810216). When the replication role is **origin** \(default value\) or **local**, a simple trigger is fired. - - When **ENABLE REPLICA** is configured for a trigger, it is fired only when the session is in replica mode. - - - **| ENABLE ALWAYS TRIGGER trigger\_name** - - Determines that all triggers are fired regardless of the current replication mode. - - - **| DISABLE/ENABLE ROW LEVEL SECURITY** - - Enables or disables row-level access control for a table. - - If row-level access control is enabled for a data table but no row-level access control policy is defined, the row-level access to the data table is not affected. If row-level access control for a table is disabled, the row-level access to the table is not affected even if a row-level access control policy has been defined. For details, see [CREATE ROW LEVEL SECURITY POLICY](create-row-level-security-policy.md). - - - **| NO FORCE/FORCE ROW LEVEL SECURITY** - - Forcibly enables or disables row-level access control for a table. - - By default, the table owner is not affected by the row-level access control feature. However, if row-level access control is forcibly enabled, the table owner \(excluding system administrators\) wil be affected. System administrators are not affected by any row-level access control policies. - - - - - There are several clauses of **column\_clause**: - - ``` - ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ] - | MODIFY column_name data_type - | MODIFY column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ] - | MODIFY column_name [ CONSTRAINT constraint_name ] NULL - | DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ] - | ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ USING expression ] - | ALTER [ COLUMN ] column_name { SET DEFAULT expression | DROP DEFAULT } - | ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL - | ALTER [ COLUMN ] column_name SET STATISTICS [PERCENT] integer - | ADD STATISTICS (( column_1_name, column_2_name [, ...] )) - | DELETE STATISTICS (( column_1_name, column_2_name [, ...] )) - | ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, ... ] ) - | ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) - | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- **ADD \[ COLUMN \] column\_name data\_type \[ compress\_mode \] \[ COLLATE collation \] \[ column\_constraint \[ ... \] \]** - > Adds a column to a table. If a column is added with **ADD COLUMN**, all existing rows in the table are initialized with the column's default value \(**NULL** if no **DEFAULT** clause is specified\). - >- **ADD \( \{ column\_name data\_type \[ compress\_mode \] \} \[, ...\] \)** - > Adds columns in the table. - >- **MODIFY \( \{ column\_name data\_type | column\_name \[ CONSTRAINT constraint\_name \] NOT NULL \[ ENABLE \] | column\_name \[ CONSTRAINT constraint\_name \] NULL \} \[, ...\] \)** - > Modifies the data type of an existing column in the table. - >- **DROP \[ COLUMN \] \[ IF EXISTS \] column\_name \[ RESTRICT | CASCADE \]** - > Drops a column from a table. Indexes and constraints related to the column are automatically dropped. If an object not belonging to the table depends on the column, **CASCADE** must be specified, such as a view. - > The **DROP COLUMN** statement does not physically remove the column, but simply makes it invisible to SQL operations. Subsequent **INSERT** and **UPDATE** operations in the table will store a **NULL** value for the column. Therefore, column deletion takes a short period of time but does not immediately release the tablespace on the disks, because the space occupied by the deleted column is not reclaimed. The space will be reclaimed when **VACUUM** is executed. - >- **ALTER \[ COLUMN \] column\_name \[ SET DATA \] TYPE data\_type \[ COLLATE collation \] \[ USING expression \]** - > Modifies the type of a column in a table. Indexes and simple table constraints on the column will automatically use the new data type by reparsing the originally supplied expression. - > **ALTER TYPE** requires an entire table be rewritten. This is an advantage sometimes, because it frees up unnecessary space from a table. For example, to reclaim the space occupied by a deleted column, the fastest method is to use the following statement. - > ``` - > ALTER TABLE table ALTER COLUMN anycol TYPE anytype; - > ``` - > In this statement, **anycol** indicates any column existing in the table and **anytype** indicates the type of the prototype of the column. **ALTER TYPE** does not change the table except that the table is forcibly rewritten. In this way, the data that is no longer used is deleted. - >- **ALTER \[ COLUMN \] column\_name \{ SET DEFAULT expression | DROP DEFAULT \}** - > Sets or removes the default value for a column. The default values only apply to subsequent **INSERT** operations; they do not cause rows already in the table to change. Defaults can also be created for views, in which case they are inserted into **INSERT** statements on the view before the view's **ON INSERT** rule is applied. - >- **ALTER \[ COLUMN \] column\_name \{ SET | DROP \} NOT NULL** - > Changes whether a column is marked to allow null values or to reject null values. You can only use **SET NOT NULL** when the column contains no null values. - >- **ALTER \[ COLUMN \] column\_name SET STATISTICS \[PERCENT\] integer** - > Specifies the per-column statistics-gathering target for subsequent **ANALYZE** operations. The target can be set in the range from 0 to 10000. Set it to **-1** to revert to using the default system statistics target. - >- **\{ADD | DELETE\} STATISTICS \(\(column\_1\_name, column\_2\_name \[, ...\]\)\)** - > Adds or deletes the declaration of collecting multi-column statistics to collect multi-column statistics as needed when **ANALYZE** is performed for a table or a database. The statistics about a maximum of 32 columns can be collected at a time. You are not allowed to add or delete such declaration for system catalogs or foreign tables. - >- **ALTER \[ COLUMN \] column\_name SET \( \{attribute\_option = value\} \[, ... \] \)** - > **ALTER \[ COLUMN \] column\_name RESET \( attribute\_option \[, ... \] \)** - > Sets or resets per-attribute options. - > Currently, the only defined per-attribute options are **n\_distinct** and **n\_distinct\_inherited**. **n\_distinct** affects statistics of a table, while **n\_distinct\_inherited** affects the statistics of the table and its subtables. Currently, only **SET/RESET n\_distinct** is supported, and **SET/RESET n\_distinct\_inherited** is forbidden. - >- **ALTER \[ COLUMN \] column\_name SET STORAGE \{ PLAIN | EXTERNAL | EXTENDED | MAIN \}** - > Sets the storage mode for a column. This clause specifies whether this column is held inline or in a secondary TOAST table, and whether the data should be compressed. It is set only for row-store tables and is invalid for column-store tables. If it is set for column-store tables, an error will be displayed when the statement is executed. **SET STORAGE** itself does not change anything in the table. It sets the strategy to be pursued during future table updates. - - - **column\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { NOT NULL | - NULL | - CHECK ( expression ) | - DEFAULT default_expr | - UNIQUE index_parameters | - PRIMARY KEY index_parameters } - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - - **compress\_mode** of a column is as follows: - - ``` - [ DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS ] - ``` - - - - **table\_constraint\_using\_index** used to add the primary key constraint or unique constraint based on the unique index is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { UNIQUE | PRIMARY KEY } USING INDEX index_name - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - - **table\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { CHECK ( expression ) | - UNIQUE ( column_name [, ... ] ) index_parameters | - PRIMARY KEY ( column_name [, ... ] ) index_parameters | - PARTIAL CLUSTER KEY ( column_name [, ... ] } - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - **index\_parameters** is as follows: - - ``` - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ USING INDEX TABLESPACE tablespace_name ] - ``` - - - -- Rename a table. The renaming does not affect stored data. - - ``` - ALTER TABLE [ IF EXISTS ] table_name - RENAME TO new_table_name; - ``` - -- Rename the specified column in the table. - - ``` - ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} - RENAME [ COLUMN ] column_name TO new_column_name; - ``` - -- Rename the constraint of the table. - - ``` - ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name ) } - RENAME CONSTRAINT constraint_name TO new_constraint_name; - ``` - -- Set the schema of the table. - - ``` - ALTER TABLE [ IF EXISTS ] table_name - SET SCHEMA new_schema; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The schema setting moves the table into another schema. Associated indexes and constraints owned by table columns are migrated as well. Currently, the schema for sequences cannot be changed. If the table has sequences, delete the sequences, and create them again or delete the ownership between the table and sequences. In this way, the table schema can be changed. - >- To change the schema of a table, you must also have the **CREATE** permission on the new schema. To add the table as a new child of a parent table, you must own the parent table as well. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have the **CREATE** permission on the table's schema. These restrictions enforce that the user can only recreate and delete the table. However, a system administrator can alter the ownership of any table anyway. - >- All the actions except for **RENAME** and **SET SCHEMA** can be combined into a list of multiple alterations to apply in parallel. For example, it is possible to add several columns or alter the type of several columns in a single statement. This is useful with large tables, since only one pass over the tables needs to be made. - >- Adding a **CHECK** or **NOT NULL** constraint will scan the table to validate that existing rows meet the constraint. - >- Adding a column with a non-**NULL** default or changing the type of an existing column will rewrite the entire table. Rewriting a large table may take much time and temporarily needs doubled disk space. - -- Add columns. - - ``` - ALTER TABLE [ IF EXISTS ] table_name - ADD ( { column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ]} [, ...] ); - ``` - -- Update columns. - - ``` - ALTER TABLE [ IF EXISTS ] table_name - MODIFY ( { column_name data_type | column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAINT constraint_name ] NULL } [, ...] ); - ``` - - -## Parameter Description - -- **IF EXISTS** - - Sends a notice instead of an error if no tables have identical names. The notice prompts that the table you are querying does not exist. - -- **table\_name \[\*\] | ONLY table\_name | ONLY \( table\_name \)** - - **table\_name** is the name of the table that you need to modify. - - If **ONLY** is specified, only the table is modified. If **ONLY** is not specified, the table and all subtables will be modified. You can add the asterisk \(\*\) option following the table name to specify that all subtables are scanned, which is the default operation. - -- **constraint\_name** - - Specifies the name of an existing constraint to drop. - -- **index\_name** - - Specifies the name of this index. - -- **storage\_parameter** - - Specifies the name of a storage parameter. - -- **new\_owner** - - Specifies the name of the new table owner. - -- **new\_tablespace** - - Specifies the new name of the tablespace to which the table belongs. - -- **column\_name**, **column\_1\_name**, **column\_2\_name** - - Specifies the name of a new or existing column. - -- **data\_type** - - Specifies the type of a new column or a new type of an existing column. - -- **compress\_mode** - - Specifies the compression option of the table, which is only available for row-store tables. The clause specifies the compression algorithm preferentially used by the column. - -- **collation** - - Specifies the collation rule name of a column. The optional **COLLATE** clause specifies a collation for the new column; if omitted, the collation is the default for the new column. - -- **USING expression** - - Specifies how to compute the new column value from the old; if omitted, the default conversion is an assignment cast from old data type to new. A **USING** clause must be provided if there is no implicit or assignment cast from the old to new type. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >**USING** in **ALTER TYPE** can specify any expression involving the old values of the row; that is, it can refer to any columns other than the one being cast. This allows general casting to be done with the **ALTER TYPE** syntax. Because of this flexibility, the **USING** expression is not applied to the column's default value \(if any\); the result might not be a constant expression as required for a default. This means that when there is no implicit or assignment cast from old to new type, **ALTER TYPE** might fail to convert the default even though a **USING** clause is supplied. In such cases, drop the default with **DROP DEFAULT**, perform the **ALTER TYPE**, and then use **SET DEFAULT** to add a suitable new default. Similar considerations apply to indexes and constraints involving the column. - -- **NOT NULL | NULL** - - Sets whether the column allows null values. - -- **integer** - - Specifies the constant value of a signed integer. When using **PERCENT**, the range of **integer** is from 0 to 100. - -- **attribute\_option** - - Specifies an attribute option. - -- **PLAIN | EXTERNAL | EXTENDED | MAIN** - - Specifies a column storage mode. - - - **PLAIN** must be used for fixed-length values \(such as integers\). It must be inline and uncompressed. - - **MAIN** is for inline, compressible data. - - **EXTERNAL** is for external, uncompressed data. Use of **EXTERNAL** will make substring operations on **text** and **bytea** values run faster, at the penalty of increased storage space. - - **EXTENDED** is for external, compressed data. **EXTENDED** is the default for most data types that support non-**PLAIN** storage. - -- **CHECK \( expression \)** - - New rows or rows to be updated must satisfy for an expression to be true. If any row produces a false result, an error is raised and the database is not modified. - - A check constraint specified as a column constraint should reference only the column's values, while an expression appearing in a table constraint can reference multiple columns. - - Currently, **CHECK \( expression \)** does not include subqueries and cannot use variables apart from the current column. - -- **DEFAULT default\_expr** - - Assigns a default data value for a column. - - The data type of the default expression must match the data type of the column. - - The default expression will be used in any insert operation that does not specify a value for the column. If there is no default value for a column, then the default value is null. - -- **UNIQUE index\_parameters** - - **UNIQUE \( column\_name \[, ... \] \) index\_parameters** - - Specifies that a group of one or more columns of a table can contain only unique values. - -- **PRIMARY KEY index\_parameters** - - **PRIMARY KEY \( column\_name \[, ... \] \) index\_parameters** - - The primary key constraint specifies that a column or columns of a table can contain only unique \(non-duplicate\) and non-null values. - -- **DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE** - - Sets whether the constraint can be deferrable. - - - **DEFERRABLE**: deferrable to the end of the transaction and checks using **SET CONSTRAINTS**. - - **NOT DEFERRABLE**: checks immediately after the execution of each command. - - **INITIALLY IMMEDIATE**: checks immediately after the execution of each statement. - - **INITIALLY DEFERRED**: checks when the transaction ends. - -- **WITH \( \{storage\_parameter = value\} \[, ... \] \)** - - Specifies an optional storage parameter for a table or an index. - -- **tablespace\_name** - - Specifies the name of the tablespace where the index locates. - -- **COMPRESS|NOCOMPRESS** - - **NOCOMPRESS**: If the **NOCOMPRESS** keyword is specified, the existing compression feature of the table will not be changed. - - **COMPRESS**: If the **COMPRESS** keyword is specified, the table compression feature will be triggered by batch tuple insertion. - -- **new\_table\_name** - - Specifies the new table name. - -- **new\_column\_name** - - Specifies the new name of a specific column in a table. - -- **new\_constraint\_name** - - Specifies the new name of a table constraint. - -- **new\_schema** - - Specifies the new schema name. - -- **CASCADE** - - Automatically drops objects that depend on the dropped column or constraint \(for example, views referencing the column\). - -- **RESTRICT** - - Refuses to drop the column or constraint if there are any dependent objects. This is the default behavior. - -- **schema\_name** - - Specifies the schema name of a table. - - -## Examples - -See [Example:](create-table.md#en-us_topic_0237122117_en-us_topic_0059778169_s86758dcf05d442d2a9ebd272e76ed1b8) in **CREATE TABLE**. - -## Helpful Links - -[CREATE TABLE](create-table.md) and [DROP TABLE](drop-table.md) - diff --git a/content/en/docs/installation/Developerguide/alter-tablespace.md b/content/en/docs/installation/Developerguide/alter-tablespace.md deleted file mode 100644 index 17160e3117e51b285201a1cc145b5bd094ee646d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-tablespace.md +++ /dev/null @@ -1,119 +0,0 @@ -# ALTER TABLESPACE - -## Function - -**ALTER TABLESPACE** modifies the attributes of a tablespace. - -## Precautions - -- Only the owner of a tablespace or a system administrator can execute the **ALTER TABLESPACE** statement. -- To change the owner, you must also be a direct or indirect member of the new owning role. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >If **new\_owner** is the same as **old\_owner**, the current user will not be verified. A message indicating successful **ALTER** execution is displayed. - - -## Syntax - -- The syntax of renaming a tablespace is as follows: - - ``` - ALTER TABLESPACE tablespace_name - RENAME TO new_tablespace_name; - ``` - -- The syntax of setting the owner of a tablespace is as follows: - - ``` - ALTER TABLESPACE tablespace_name - OWNER TO new_owner; - ``` - -- The syntax of setting the attributes of a tablespace is as follows: - - ``` - ALTER TABLESPACE tablespace_name - SET ( {tablespace_option = value} [, ... ] ); - ``` - -- The syntax of resetting the attributes of a tablespace is as follows: - - ``` - ALTER TABLESPACE tablespace_name - RESET ( { tablespace_option } [, ...] ); - ``` - -- The syntax of setting the quota of a tablespace is as follows: - - ``` - ALTER TABLESPACE tablespace_name - RESIZE MAXSIZE { UNLIMITED | 'space_size'}; - ``` - - -## Parameter Description - -- **tablespace\_name** - - Specifies the tablespace to be modified. - - Value range: an existing table name - -- **new\_tablespace\_name** - - Specifies the new name of a tablespace. - - The new name cannot start with **PG\_**. - - Value range: a string. It must comply with the naming convention rule. - -- **new\_owner** - - Specifies the new owner of the tablespace. - - Value range: an existing username - -- **tablespace\_option** - - Sets or resets the parameters of a tablespace. - - Value range: - - - seq\_page\_cost: sets the optimizer to calculate the cost of obtaining disk pages in sequence. The default value is **1.0**. - - **random\_page\_cost**: sets the optimizer to calculate the cost of obtaining disk pages in a non-sequential manner. The default value is **4.0**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The value of **random\_page\_cost** is relative to that of **seq\_page\_cost**. It is meaningless when the value is equal to or less than the value of **seq\_page\_cost**. - >- The prerequisite for the default value **4.0** is that the optimizer uses indexes to scan table data and the hit ratio of table data in the cache is about 90%. - >- If the size of the table data space is smaller than that of the physical memory, decrease the value to a proper level. On the contrary, if the hit ratio of table data in the cache is lower than 90%, increase the value. - >- If random-access memory like SSD is adopted, the value can be decreased to a certain degree to reflect the cost of true random scan. - - - Value range: a positive floating point number - -- **RESIZE MAXSIZE** - - Resets the maximum size of tablespace. - - Value range: - - - **UNLIMITED**: No limit is set for this tablespace. - - Determined by **space\_size**. For details about the format, see [CREATE TABLESPACE](create-tablespace.md). - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >You can also use the following statement to change the value of **MAXSIZE**: - >``` - >ALTER TABLESPACE tablespace_name RESIZE MAXSIZE - > { 'UNLIMITED' | 'space_size'}; - >``` - - - -## Examples - -See [Examples](create-tablespace.md#en-us_topic_0237122120_en-us_topic_0059777670_s4e5e97caa377440d87fad0d49b56323e) in **CREATE TABLESPACE**. - -## Helpful Links - -[CREATE TABLESPACE](create-tablespace.md) and [DROP TABLESPACE](drop-tablespace.md) - diff --git a/content/en/docs/installation/Developerguide/alter-text-search-configuration.md b/content/en/docs/installation/Developerguide/alter-text-search-configuration.md deleted file mode 100644 index c07e5438aed3fddbdca1f67b53f6a72349d461f6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-text-search-configuration.md +++ /dev/null @@ -1,175 +0,0 @@ -# ALTER TEXT SEARCH CONFIGURATION - -## Function - -**ALTER TEXT SEARCH CONFIGURATION** modifies the definition of a text search configuration. You can modify its mappings from token types to dictionaries, change the configuration's name or owner, or modify the parameters. - -The **ADD MAPPING FOR** form installs a list of dictionaries to be consulted for the specified token types; an error will be generated if there is already a mapping for any of the token types. - -The **ALTER MAPPING FOR** form removes existing mapping for those token types and then adds specified mappings. - -**ALTER MAPPING REPLACE ... ** **WITH ... ** and **ALTER MAPPING FOR...** **REPLACE ... ** **WITH ...** options replace **old\_dictionary** with **new\_dictionary**. Note that only when **pg\_ts\_config\_map** has tuples corresponding to **maptokentype** and **old\_dictionary**, the update will succeed. If the update fails, no messages are returned. - -The **DROP MAPPING FOR** form deletes all dictionaries for the specified token types in the text search configuration. If **IF EXISTS** is not specified and the string type mapping specified by **DROP MAPPING FOR** does not exist in text search configuration, an error will occur in the database. - -## Precautions - -- If a search configuration is referenced \(to create indexes\), users are not allowed to modify the text search configuration. -- To use **ALTER TEXT SEARCH CONFIGURATION**, you must be the owner of the configuration. - -## Syntax - -- Add text search configuration string mapping. - -``` -ALTER TEXT SEARCH CONFIGURATION name - ADD MAPPING FOR token_type [, ... ] WITH dictionary_name [, ... ]; -``` - -- Modify the text search configuration dictionary syntax. - -``` -ALTER TEXT SEARCH CONFIGURATION name - ALTER MAPPING FOR token_type [, ... ] REPLACE old_dictionary WITH new_dictionary; -``` - -- Modify the text search configuration string. - -``` -ALTER TEXT SEARCH CONFIGURATION name - ALTER MAPPING FOR token_type [, ... ] WITH dictionary_name [, ... ]; -``` - -- Change the text search configuration dictionary. - -``` -ALTER TEXT SEARCH CONFIGURATION name - ALTER MAPPING REPLACE old_dictionary WITH new_dictionary; -``` - -- Remove text search configuration string mapping. - -``` -ALTER TEXT SEARCH CONFIGURATION name - DROP MAPPING [ IF EXISTS ] FOR token_type [, ... ]; -``` - -- Rename the owner of text search configuration. - -``` -ALTER TEXT SEARCH CONFIGURATION name OWNER TO new_owner; -``` - -- Rename the text search configuration. - -``` -ALTER TEXT SEARCH CONFIGURATION name RENAME TO new_name; -``` - -- Rename the namespace of text search configuration. - -``` -ALTER TEXT SEARCH CONFIGURATION name SET SCHEMA new_schema; -``` - -- Modify the attributes of the text search configuration. - -``` -ALTER TEXT SEARCH CONFIGURATION name SET ( { configuration_option = value } [, ...] ); -``` - -- Reset the attributes of text search configuration. - -``` -ALTER TEXT SEARCH CONFIGURATION name RESET ( {configuration_option} [, ...] ); -``` - -## Parameter Description - -- **name** - - Specifies the name \(optionally schema-qualified\) of an existing text search configuration. - -- **token\_type** - - Specifies the name of a token type that is emitted by the configuration's parser. For details, see [Parser](parser.md). - -- **dictionary\_name** - - Specifies the name of a text search dictionary. If multiple dictionaries are listed, they are searched in the specified order. - -- **old\_dictionary** - - Specifies the name of a text search dictionary to be replaced in the mapping. - -- **new\_dictionary** - - Specifies the name of a text search dictionary to be substituted for **old\_dictionary**. - -- **new\_owner** - - Specifies the new owner of the text search configuration. - -- **new\_name** - - Specifies the new name of the text search configuration. - -- **new\_schema** - - Specifies the new schema for the text search configuration. - -- **configuration\_option** - - Specifies the text search configuration option. For details, see [CREATE TEXT SEARCH CONFIGURATION](create-text-search-configuration.md). - -- **value** - - Specifies the value of text search configuration option. - - -## Examples - -``` --- Create a text search configuration. -postgres=# CREATE TEXT SEARCH CONFIGURATION english_1 (parser=default); -CREATE TEXT SEARCH CONFIGURATION - --- Add text search configuration string mapping. -postgres=# ALTER TEXT SEARCH CONFIGURATION english_1 ADD MAPPING FOR word WITH simple,english_stem; -ALTER TEXT SEARCH CONFIGURATION - --- Add text search configuration string mapping. -postgres=# ALTER TEXT SEARCH CONFIGURATION english_1 ADD MAPPING FOR email WITH english_stem, french_stem; -ALTER TEXT SEARCH CONFIGURATION - --- Query information about the text search configuration. -postgres=# SELECT b.cfgname,a.maptokentype,a.mapseqno,a.mapdict,c.dictname FROM pg_ts_config_map a,pg_ts_config b, pg_ts_dict c WHERE a.mapcfg=b.oid AND a.mapdict=c.oid AND b.cfgname='english_1' ORDER BY 1,2,3,4,5; - cfgname | maptokentype | mapseqno | mapdict | dictname ------------+--------------+----------+---------+-------------- - english_1 | 2 | 1 | 3765 | simple - english_1 | 2 | 2 | 12960 | english_stem - english_1 | 4 | 1 | 12960 | english_stem - english_1 | 4 | 2 | 12964 | french_stem -(4 rows) - --- Add text search configuration string mapping. -postgres=# ALTER TEXT SEARCH CONFIGURATION english_1 ALTER MAPPING REPLACE french_stem with german_stem; -ALTER TEXT SEARCH CONFIGURATION - --- Query information about the text search configuration. -postgres=# SELECT b.cfgname,a.maptokentype,a.mapseqno,a.mapdict,c.dictname FROM pg_ts_config_map a,pg_ts_config b, pg_ts_dict c WHERE a.mapcfg=b.oid AND a.mapdict=c.oid AND b.cfgname='english_1' ORDER BY 1,2,3,4,5; - cfgname | maptokentype | mapseqno | mapdict | dictname ------------+--------------+----------+---------+-------------- - english_1 | 2 | 1 | 3765 | simple - english_1 | 2 | 2 | 12960 | english_stem - english_1 | 4 | 1 | 12960 | english_stem - english_1 | 4 | 2 | 12966 | german_stem -(4 rows) -``` - -See [Examples](create-text-search-configuration.md#en-us_topic_0237122121_en-us_topic_0059777835_sc3a4aef5c0c0420eaf5a2e67097004a2) in **CREATE TEXT SEARCH CONFIGURATION**. - -## Helpful Links - -[CREATE TEXT SEARCH CONFIGURATION](create-text-search-configuration.md) and [DROP TEXT SEARCH CONFIGURATION](drop-text-search-configuration.md) - diff --git a/content/en/docs/installation/Developerguide/alter-text-search-dictionary.md b/content/en/docs/installation/Developerguide/alter-text-search-dictionary.md deleted file mode 100644 index 9a2ca627ce664a073231ab1b356599175e325ff6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-text-search-dictionary.md +++ /dev/null @@ -1,101 +0,0 @@ -# ALTER TEXT SEARCH DICTIONARY - -## Function - -**ALTER TEXT SEARCH DICTIONARY** modifies the definition of a full-text search dictionary, including its parameters, name, owner, and schema. - -## Precautions - -- Predefined dictionaries do not support the **ALTER** operations. -- Only the owner of a dictionary or a system administrator can perform the **ALTER** operations. -- After a dictionary is created or modified, any modification to the customized dictionary definition file in the **filepath** directory does not affect the dictionary in the database. To use these modifications in the database, run the **ALTER TEXT SEARCH DICTIONARY** statement to update the definition file of the corresponding dictionary. - -## Syntax - -- Modify the dictionary definition. - - ``` - ALTER TEXT SEARCH DICTIONARY name ( - option [ = value ] [, ... ] - ); - ``` - - -- Rename a dictionary. - - ``` - ALTER TEXT SEARCH DICTIONARY name RENAME TO new_name; - ``` - -- Set the schema of the dictionary. - - ``` - ALTER TEXT SEARCH DICTIONARY name SET SCHEMA new_schema; - ``` - -- Change the owner of the dictionary. - - ``` - ALTER TEXT SEARCH DICTIONARY name OWNER TO new_owner; - ``` - - -## Parameter Description - -- **name** - - Specifies the name of an existing dictionary. \(If you do not specify a schema name, the dictionary in the current schema will be used.\) - - Value range: an existing dictionary name - -- **option** - - Specifies the parameter name to be modified. Each type of dictionaries has a template containing their custom parameters. Parameters function in a way irrelevant to their setting sequence. For details about the parameters, see [option](create-text-search-dictionary.md#en-us_topic_0237122122_li1286812455448). - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The value of **TEMPLATE** in the dictionary cannot be changed. - >- To specify a dictionary, specify both the dictionary definition file path \(**FILEPATH**\) and the file name. - >- The name of a dictionary definition file can contain only lowercase letters, digits, and underscores \(\_\). - -- **value** - - Specifies the new value of a parameter. If the equal sign \(=\) and _value_ are omitted, the previous settings of the option are deleted and the default value is used. - - Value range: valid values defined by **option**. - -- **new\_name** - - Specifies the new name of a dictionary. - - Value range: a string, which complies with the identifier naming convention. A value can contain a maximum of 63 characters. - -- **new\_owner** - - Specifies the new owner of a dictionary. - - Value range: an existing username - -- **new\_schema** - - Specifies the new schema of a dictionary. - - Value range: an existing schema - - -## Examples - -``` --- Modify the definition of stop words in Snowball dictionaries. Retain the values of other parameters. -postgres=# ALTER TEXT SEARCH DICTIONARY my_dict ( StopWords = newrussian, FilePath = 'file:///home/dicts' ); - --- Modify the Language parameter in Snowball dictionaries and delete the definition of stop words. -postgres=# ALTER TEXT SEARCH DICTIONARY my_dict (Language = dutch, StopWords); - --- Update the dictionary definition and do not change any other content. -postgres=# ALTER TEXT SEARCH DICTIONARY my_dict ( dummy ); -``` - -## Helpful Links - -[CREATE TEXT SEARCH DICTIONARY](create-text-search-dictionary.md) and [DROP TEXT SEARCH DICTIONARY](drop-text-search-dictionary.md) - diff --git a/content/en/docs/installation/Developerguide/alter-trigger.md b/content/en/docs/installation/Developerguide/alter-trigger.md deleted file mode 100644 index e929c09d8c40b962e8c6142c8fe12c7ca7350ee0..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-trigger.md +++ /dev/null @@ -1,45 +0,0 @@ -# ALTER TRIGGER - -## Function - -**ALTER TRIGGER** modifies the definition of a trigger. - -## Precautions - -Only the owner of a table where the trigger is created and a system administrator can run the **ALTER TRIGGER** statement. - -## Syntax - -``` -ALTER TRIGGER trigger_name ON table_name RENAME TO new_name; -``` - -## Parameter Description - -- **trigger\_name** - - Specifies the name of the trigger to be modified. - - Value range: an existing trigger - -- **table\_name** - - Specifies the name of the table where the trigger to be modified is located. - - Value range: an existing table having a trigger - -- **new\_name** - - Specifies the new name after modification. - - Value range: a string, which complies with the identifier naming convention. A value contains a maximum of 63 characters and cannot be the same as other triggers on the same table. - - -## Examples - -See examples in [CREATE TRIGGER](create-trigger.md). - -## Helpful Links - -[CREATE TRIGGER](create-trigger.md), [DROP TRIGGER](drop-trigger.md), and [ALTER TABLE](alter-table.md) - diff --git a/content/en/docs/installation/Developerguide/alter-type.md b/content/en/docs/installation/Developerguide/alter-type.md deleted file mode 100644 index f8e01cde644552e47f86eba7164b239aa2cf5668..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-type.md +++ /dev/null @@ -1,152 +0,0 @@ -# ALTER TYPE - -## Function - -**ALTER TYPE** modifies the definition of a type. - -## Syntax - -- Modify a type. - - ``` - ALTER TYPE name action [, ... ] - ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } - ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ] - ALTER TYPE name RENAME TO new_name - ALTER TYPE name SET SCHEMA new_schema - ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ] - ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value - - where action is one of: - ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] - DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ] - ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] - ``` - -- Add a new attribute to a composite type. - - ``` - ALTER TYPE name ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] - ``` - - -- Delete an attribute from a composite type. - - ``` - ALTER TYPE name DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ] - ``` - - -- Change the type of an attribute in a composite type. - - ``` - ALTER TYPE name ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] - ``` - - -- Change the owner of a type. - - ``` - ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } - ``` - - -- Change the name of a type or the name of an attribute in a composite type. - - ``` - ALTER TYPE name RENAME TO new_name - ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ] - ``` - - -- Move a type to a new schema. - - ``` - ALTER TYPE name SET SCHEMA new_schema - ``` - - -- Add a new value to an enumerated type. - - ``` - ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ] - ``` - - -- Change an enumerated value in the value list. - - ``` - ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value - ``` - - -## Parameter Description - -- **name** - - Specifies the name of an existing type that needs to be modified \(optionally schema-qualified\). - - -- **new\_name** - - Specifies the new name of the type. - - -- **new\_owner** - - Specifies the new owner of the type. - - -- **new\_schema** - - Specifies the new schema of the type. - - -- **attribute\_name** - - Specifies the name of the attribute to be added, modified, or deleted. - - -- **new\_attribute\_name** - - Specifies the new name of the attribute to be renamed. - - -- **data\_type** - - Specifies the data type of the attribute to be added, or the new type of the attribute to be modified. - -- **new\_enum\_value** - - Specifies a new enumerated value. It is a non-null string with a maximum length of 64 bytes. - -- **neighbor\_enum\_value** - - Specifies an existing enumerated value before or after which a new enumerated value will be added. - -- **existing\_enum\_value** - - Specifies an enumerated value to be changed. It is a non-null string with a maximum length of 64 bytes. - - -- **CASCADE** - - Determines that the type to be modified, its associated records, and subtables that inherit the type will all be updated. - -- **RESTRICT** - - Refuses to update the associated records of the modified type. This is the default action. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- **ADD ATTRIBUTE**, **DROP ATTRIBUTE**, and **ALTER ATTRIBUTE** can be combined for processing. For example, it is possible to add several attributes or change the types of several attributes at the same time in one command. - >- To use **ALTER TYPE**, you must be the owner of the type. To modify a schema of a type, you must also have the **CREATE** permission on the new schema. To change the owner, you must be a direct or indirect member of the new owning role, and the member must have the **CREATE** permission on the schema of this type. \(These restrictions enforce that the user can only recreate and delete the type. However, the system administrator can change ownership of any type in any way.\) To add an attribute or modify the type of an attribute, you must also have the **USAGE** permission of this type. - - -## Example - -See [Examples](create-type.md#en-us_topic_0237122124_en-us_topic_0059779377_s66a0b4a6a1df4ba4a116c6c565a0fe9d) in **CREATE TYPE**. - -## Helpful Links - -[CREATE TYPE](create-type.md) and [DROP TYPE](drop-type.md) - diff --git a/content/en/docs/installation/Developerguide/alter-user-mapping.md b/content/en/docs/installation/Developerguide/alter-user-mapping.md deleted file mode 100644 index 28e1311c487f88eda60dd534a26e904a9e078103..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-user-mapping.md +++ /dev/null @@ -1,66 +0,0 @@ -# ALTER USER MAPPING - -## Function - -**ALTER USER MAPPING** changes the definition of a user mapping. - -## Syntax - -``` -ALTER USER MAPPING FOR { user_name | USER | CURRENT_USER | PUBLIC } - SERVER server_name - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) -``` - -In **OPTIONS**, **ADD**, **SET**, and **DROP** are operations to be performed. If these operations are not specified, **ADD** operations will be performed by default. **option** and **value** are the parameters and values of the corresponding operation. - -## Parameter Description - -- **user\_name** - - Specifies user name of the mapping. - - CURRENT\_USER and USER match the name of the current user. PUBLIC is used to match all current and future user names in the system. - -- **server\_name** - - Specifies name of the server to which the user is mapped. - -- **OPTIONS** - - Changes an option for the user mapping. The new option overwrites any previously specified option. **ADD**, **SET**, and **DROP** are operations to be performed. If the operation is not set explicitly, **ADD** is used. The option name must be unique and will be validated with the foreign data wrapper of the server. - - - Options supported by oracle\_fdw are as follows: - - **user** - - Oracle server user name. - - - **password** - - Password of the Oracle user. - - - Options supported by mysql\_fdw are as follows: - - **username** - - User name of the MySQL server or MariaDB. - - - **password** - - User password of the MySQL server or MariaDB. - - - Options supported by postgres\_fdw are as follows: - - **user** - - User name of the remote openGauss database. - - - **password** - - User password of the remote openGauss database. - - - - -## Helpful Links - -[CREATE USER MAPPING](create-user-mapping.md) and [DROP USER MAPPING](drop-user-mapping.md) - diff --git a/content/en/docs/installation/Developerguide/alter-user.md b/content/en/docs/installation/Developerguide/alter-user.md deleted file mode 100644 index a2e55f686224004643d9112b33ac5b6fcc99023f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-user.md +++ /dev/null @@ -1,108 +0,0 @@ -# ALTER USER - -## Function - -**ALTER USER** modifies the attributes of a database user. - -## Precautions - -Session parameters modified by **ALTER USER** apply to a specified user and take effect in the next session. - -## Syntax - -- Modify user permissions or other information. - - ``` - ALTER USER user_name [ [ WITH ] option [ ... ] ]; - ``` - - The **option** clause is as follows: - - ``` - { CREATEDB | NOCREATEDB } - | { CREATEROLE | NOCREATEROLE } - | { INHERIT | NOINHERIT } - | { AUDITADMIN | NOAUDITADMIN } - | { SYSADMIN | NOSYSADMIN } - | { USEFT | NOUSEFT } - | { LOGIN | NOLOGIN } - | { REPLICATION | NOREPLICATION } - | {INDEPENDENT | NOINDEPENDENT} - | {VCADMIN | NOVCADMIN} - | CONNECTION LIMIT connlimit - | [ ENCRYPTED | UNENCRYPTED ] PASSWORD { 'password' | DISABLE } - | [ ENCRYPTED | UNENCRYPTED ] IDENTIFIED BY { 'password' [ REPLACE 'old_password' ] | DISABLE } - | VALID BEGIN 'timestamp' - | VALID UNTIL 'timestamp' - | RESOURCE POOL 'respool' - | PERM SPACE 'spacelimit' - | ACCOUNT { LOCK | UNLOCK } - | PGUSER - ``` - -- Change the username. - - ``` - ALTER USER user_name - RENAME TO new_name; - ``` - -- Change the value of a specified parameter associated with the user. - - ``` - ALTER USER user_name - SET configuration_parameter { { TO | = } { value | DEFAULT } | FROM CURRENT }; - ``` - -- Reset the value of a specified parameter associated with the user. - - ``` - ALTER USER user_name - RESET { configuration_parameter | ALL }; - ``` - - -## Parameter Description - -- **user\_name** - - Specifies the current username. - - Value range: an existing username - -- **new\_password** - - Specifies a new password. - - The new password must: - - - Differ from the old password. - - Contain at least eight characters. This is the default length. - - Differ from the username or the username spelled backward. - - Contain at least three types of the following four types of characters: uppercase characters \(A to Z\), lowercase characters \(a to z\), digits \(0 to 9\), and special characters, including: \~!@\#$%^&\*\(\)-\_=+\\|\[\{\}\];:,<.\>/? - - Value range: a string - -- **old\_password** - - Specifies the old password. - -- **ACCOUNT LOCK | ACCOUNT UNLOCK** - - **ACCOUNT LOCK**: locks an account to forbid login to databases. - - **ACCOUNT UNLOCK**: unlocks an account to allow login to databases. - -- **PGUSER** - - In the current version, the **PGUSER** attribute of a user cannot be modified. - - -For details about other parameters, see "Parameter Description" in [CREATE ROLE](create-role.md) and [ALTER ROLE](alter-role.md). - -## Example - -See [Example](create-user.md#en-us_topic_0237122125_en-us_topic_0059778166_sfbca773f5bcd4799b3ea668b3eb074fa) in **CREATE USER**. - -## Helpful Links - -[CREATE ROLE](create-role.md), [CREATE USER](create-user.md), and [DROP USER](drop-user.md) - diff --git a/content/en/docs/installation/Developerguide/alter-view.md b/content/en/docs/installation/Developerguide/alter-view.md deleted file mode 100644 index 685c5683aeb8a10aac53f8e7958517acd04a319e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/alter-view.md +++ /dev/null @@ -1,130 +0,0 @@ -# ALTER VIEW - -## Function - -**ALTER VIEW** modifies all auxiliary attributes of a view. \(To modify the query definition of a view, use **CREATE OR REPLACE VIEW**.\) - -## Precautions - -- Only the owner of a view can use **ALTER VIEW**. -- To change the schema of a view, you must have the **CREATE** permission on the new schema. -- To change the owner of a view, you must be a direct or indirect member of the new owning role, and the member must have the **CREATE** permission on the view's schema. -- An administrator can change the owner relationship of any view. - -## Syntax - -- Set the default value of a view column. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - ALTER [ COLUMN ] column_name SET DEFAULT expression; - ``` - -- Remove the default value of a view column. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - ALTER [ COLUMN ] column_name DROP DEFAULT; - ``` - -- Change the owner of a view. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - OWNER TO new_owner; - ``` - -- Rename a view. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - RENAME TO new_name; - ``` - -- Set the schema of a view. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - SET SCHEMA new_schema; - ``` - -- Set the options of a view. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - SET ( { view_option_name [ = view_option_value ] } [, ... ] ); - ``` - -- Reset the options of a view. - - ``` - ALTER VIEW [ IF EXISTS ] view_name - RESET ( view_option_name [, ... ] ); - ``` - - -## Parameter Description - -- **IF EXISTS** - - If this option is used, no error is generated when the view does not exist, and only a message is displayed. - -- **view\_name** - - Specifies the view name, which can be schema-qualified. - - Value range: a string. It must comply with the naming convention rule. - -- **column\_name** - - Specifies an optional list of names to be used for columns of the view. If not given, the column names are deduced from the query. - - Value range: a string. It must comply with the naming convention rule. - -- **SET/DROP DEFAULT** - - Sets or deletes the default value of a column. this parameter does not take effect. - -- **new\_owner** - - Specifies the new owner of a view. - -- **new\_name** - - Specifies the new view name. - -- **new\_schema** - - Specifies the new schema of the view. - -- **view\_option\_name \[ = view\_option\_value \]** - - Specifies an optional parameter for a view. - - Currently, **view\_option\_name** supports only the **security\_barrier** parameter. This parameter is used when the view attempts to provide row-level security. - - Value range: Boolean type, **TRUE**, and **FALSE**. - - -## Examples - -``` --- Create a view consisting of rows with c_customer_sk less than 150. -postgres=# CREATE VIEW tpcds.customer_details_view_v1 AS - SELECT * FROM tpcds.customer - WHERE c_customer_sk < 150; - --- Rename a view. -postgres=# ALTER VIEW tpcds.customer_details_view_v1 RENAME TO customer_details_view_v2; - --- Change the schema of a view. -postgres=# ALTER VIEW tpcds.customer_details_view_v2 SET schema public; - --- Delete a view. -postgres=# DROP VIEW public.customer_details_view_v2; -``` - -## Helpful Links - -[CREATE VIEW](create-view.md) and [DROP VIEW](drop-view.md) - diff --git a/content/en/docs/installation/Developerguide/analyze-analyse.md b/content/en/docs/installation/Developerguide/analyze-analyse.md deleted file mode 100644 index ebe5e080575169bc00bf601915dab2e5177b7caf..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/analyze-analyse.md +++ /dev/null @@ -1,193 +0,0 @@ -# ANALYZE | ANALYSE - -## Function - -**ANALYZE** collects statistics about ordinary tables in a database, and stores the results in the **PG\_STATISTIC** system catalog. The execution plan generator uses these statistics to determine which one is the most effective execution plan. - -If no parameter is specified, **ANALYZE** analyzes each table and partitioned table in the current database. You can also specify the **table\_name**, **column**, and **partition\_name** parameters to restrict the analysis to a specific table, column, or partitioned table. - -**ANALYZE | ANALYSE VERIFY** is used to check whether data files of common tables \(row-store and column-store tables\) in a database are damaged. - -## Precautions - -Non-temporary tables cannot be analyzed in an anonymous block, transaction block, function, or stored procedure. Temporary tables in a stored procedure can be analyzed but their statistics updates cannot be rolled back. - -The **ANALYZE VERIFY** operation is used to detect abnormal scenarios. The **RELEASE** version is required. In the **ANALYZE VERIFY** scenario, remote read is not triggered. Therefore, the remote read parameter does not take effect. If the system detects that a page is damaged due to an error in a key system table, the system directly reports an error and does not continue the detection. - -## Syntax - -- Collect statistics information about a table. - - ``` - { ANALYZE | ANALYSE } [ VERBOSE ] - [ table_name [ ( column_name [, ...] ) ] ]; - ``` - - -- Collect statistics about a partitioned table. - - ``` - { ANALYZE | ANALYSE } [ VERBOSE ] - [ table_name [ ( column_name [, ...] ) ] ] - PARTITION ( patrition_name ) ; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >An ordinary partitioned table supports the syntax but not the function of collecting statistics about specified partitions. - - -- Collect statistics about multiple columns. - - ``` - {ANALYZE | ANALYSE} [ VERBOSE ] - table_name (( column_1_name, column_2_name [, ...] )); - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- When collecting statistics about multiple columns, set GUC parameter [default\_statistics\_target](other-optimizer-options.md#en-us_topic_0237124719_en-us_topic_0059779049_se18c86fcdf5e4a22870f71187436d815) to a negative value to sample data in percentage. - >- The statistics about a maximum of 32 columns can be collected at a time. - >- You are not allowed to collect statistics about multiple columns in system catalogs. - - -- Check the data files in the current database. - - ``` - {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- In fast mode, DML operations need to be performed on the tables to be verified concurrently. As a result, an error is reported during the verification. In the current fast mode, data is directly read from the disk. When other threads modify files concurrently, the obtained data is incorrect. Therefore, you are advised to perform the verification offline. - >- You can perform operations on the entire database. Because a large number of tables are involved, you are advised to save the result **gsql -d database -p port -f "verify.sql"\> verify\_warning.txt 2\>&1** in redirection mode. - >- NOTICE is used to check only tables that are visible to external systems. The detection of internal tables is included in the external tables on which NOTICE depends and is not displayed externally. - >- This statement can be executed with error tolerance. The **Assert** of the debug version may cause the core to fail to execute commands. Therefore, you are advised to perform the operations in release mode. - >- If a key system table is damaged during a full database operation, an error is reported and the operation stops. - -- Check data files of tables and indexes. - - ``` - {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- Operations on ordinary tables and index tables are supported, but **CASCADE** operations on indexes of index tables are not supported. The **CASCADE** mode is used to process all index tables of the primary table. When the index tables are checked separately, the **CASCADE** mode is not required. - >- Temporary tables and unlogged tables are not supported. - >- When the primary table is checked, the internal tables of the primary table, such as the toast table and cudesc table, are also checked. - >- When the system displays a message indicating that the index table is damaged, you are advised to run the **reindex** command to recreate the index. - -- Check the data files of the table partition. - - ``` - {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; - ``` - - ![](public_sys-resources/icon-note.gif) **NOTE:** - - >- You can check a single partition of a table, but cannot perform the **CASCADE** operation on the indexes of an index table. - >- Temporary tables and unlogged tables are not supported. - -## Parameter Description - -- **VERBOSE** - - Enables the display of progress messages. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >If **VERBOSE** is specified, **ANALYZE** displays the progress information, indicating the table that is being processed. Statistics about tables are also displayed. - -- **table\_name** - - Specifies the name \(possibly schema-qualified\) of a specific table to analyze. If omitted, all regular tables \(but not foreign tables\) in the current database are analyzed. - - Currently, you can use **ANALYZE** to collect statistics only from row-store tables and column-store tables. - - Value range: an existing table name - -- **column\_name**, column\_1\_name, column\_2\_name - - Specifies the name of a specific column to analyze. All columns are analyzed by default. - - Value range: an existing column name - -- **partition\_name** - - Assumes the table is a partitioned table. You can specify **partition\_name** following the keyword **PARTITION** to analyze the statistics of this table. Currently, **ANALYZE** can be performed on partitioned tables, but statistics of specified partitions cannot be analyzed. - - Value range: a partition name of a table - -- **index\_name** - - Specifies the name of the specific index table to be analyzed \(possibly schema-qualified\). - - Value range: an existing table name - -- **FAST|COMPLETE** - - For a row-store table, the **FAST** mode verifies the CRC and page header of the row-store table. If the verification fails, an alarm is generated. In **COMPLETE** mode, the pointer and tuple of the row-store table are parsed and verified. For a column-store table, the **FAST** mode verifies the CRC and magic of the column-store table. If the verification fails, an alarm is generated. In **COMPLETE** mode, the CU of the column-store table is parsed and verified. - -- **CASCADE** - - In **CASCADE** mode, all indexes of the current table are verified. - - -## Examples - --- Create a table. - -``` -postgres=# CREATE TABLE customer_info -( -WR_RETURNED_DATE_SK INTEGER , -WR_RETURNED_TIME_SK INTEGER , -WR_ITEM_SK INTEGER NOT NULL, -WR_REFUNDED_CUSTOMER_SK INTEGER -) -; -``` - --- Create a partitioned table. - -``` -postgres=# CREATE TABLE customer_par -( -WR_RETURNED_DATE_SK INTEGER , -WR_RETURNED_TIME_SK INTEGER , -WR_ITEM_SK INTEGER NOT NULL, -WR_REFUNDED_CUSTOMER_SK INTEGER -) -PARTITION BY RANGE(WR_RETURNED_DATE_SK) -( -PARTITION P1 VALUES LESS THAN(2452275), -PARTITION P2 VALUES LESS THAN(2452640), -PARTITION P3 VALUES LESS THAN(2453000), -PARTITION P4 VALUES LESS THAN(MAXVALUE) -) -ENABLE ROW MOVEMENT; -``` - --- Run **ANALYZE** to update statistics. - -``` -postgres=# ANALYZE customer_info; -postgres=# ANALYZE customer_par; -``` - --- Run **ANALYZE VERBOSE** statement to update statistics and display table information. - -``` -postgres=# ANALYZE VERBOSE customer_info; -INFO: analyzing "cstore.pg_delta_3394584009"(cn_5002 pid=53078) -INFO: analyzing "public.customer_info"(cn_5002 pid=53078) -INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) -ANALYZE -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If any environment-related fault occurs, check the logs of the primary node of the database. - --- Delete the table. - -``` -postgres=# DROP TABLE customer_info; -postgres=# DROP TABLE customer_par; -``` - diff --git a/content/en/docs/installation/Developerguide/analyze-table.md b/content/en/docs/installation/Developerguide/analyze-table.md deleted file mode 100644 index f05a76aacc219c46edada280064e2d15c2168489..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/analyze-table.md +++ /dev/null @@ -1,40 +0,0 @@ -# ANALYZE Table - -The execution plan generator needs to use table statistics to generate the most effective query execution plan to improve query performance. After data is imported, you are advised to run the **ANALYZE** statement to update table statistics. The statistics are stored in the system catalog **PG\_STATISTIC**. - -## ANALYZE Table - -**ANALYZE** supports row-store and column-store tables. **ANALYZE** can also collect statistics about specified columns of a local table. For details on **ANALYZE**, see [ANALYZE | ANALYSE](analyze-analyse.md). - -1. Update table statistics. - - Do **ANALYZE** to the **product\_info** table. - - ``` - ANALYZE product_info; - ``` - - ``` - ANALYZE - ``` - - -## autoanalyze - -openGauss provides the GUC parameter [autovacuum](automatic-vacuuming.md#en-us_topic_0237124730_en-us_topic_0059778244_s995913ca9df54ae5bb488d1e810bd824) to specify whether to enable the autovacuum function of the database. - -If **autovacuum** is set to **on**, the system will start the autovacuum thread to automatically analyze tables when the data volume in the table reaches the threshold. This is the autoanalyze function. - -- For an empty table, when the number of rows inserted to it is greater than 50, **ANALYZE** is automatically triggered. -- For a table containing data, the threshold is 50 + 10% x **reltuples**, where **reltuples** indicates the total number of rows in the table. - -The autovacuum function also depends on the following two GUC parameters in addition to **autovacuum**: - -- [track\_counts](query-and-index-statistics-collector.md#en-us_topic_0237124727_en-us_topic_0059779313_s3f4fb0b1004041f69e1454c701952411): This parameter must be set to **on** to enable statistics collection about the database. -- [autovacuum\_max\_workers](automatic-vacuuming.md#en-us_topic_0237124730_en-us_topic_0059778244_s76932f79410248ba8923017d19982673): This parameter must be set to a value greater than **0** to specify the maximum number of concurrent autovacuum threads. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- The autoanalyze function supports the default sampling mode but not percentage sampling. ->- The autoanalyze function does not collect multi-column statistics, which only supports percentage sampling. ->- The autoanalyze function supports row-store and column-store tables and does not support foreign tables, temporary tables, unlogged tables, and TOAST tables. - diff --git a/content/en/docs/installation/Developerguide/analyzing-hardware-bottlenecks.md b/content/en/docs/installation/Developerguide/analyzing-hardware-bottlenecks.md deleted file mode 100644 index 89f46103219b69802ab0d998be2f00c0bfc1b8f2..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/analyzing-hardware-bottlenecks.md +++ /dev/null @@ -1,13 +0,0 @@ -# Analyzing Hardware Bottlenecks - -The CPU, memory, I/O, and network resource usage of each node in openGauss are obtained to check whether these resources are fully used and whether any bottleneck exists. - -- **[CPU](cpu.md)** -You can run the **top** command to check the CPU usage of each node in openGauss and analyze whether performance bottleneck caused by heavy CPU load exists. -- **[Memory](memory.md)** -Run the **top** command to check the memory usage of each node in openGauss and analyze whether a performance bottleneck occurs due to high memory usage. -- **[I/O](i-o.md)** -You can run the **iostat** or **pidstat** command, or use openGauss heath check tools to check the I/O usage and throughput on each node in openGauss and analyze whether performance bottleneck caused by I/O exists. -- **[Network](network.md)** -You can run the **sar** or **ifconfig** command to check the network status on each node in openGauss and analyze whether performance bottlenecks caused by network faults occur. - diff --git a/content/en/docs/installation/Developerguide/anonymous-blocks.md b/content/en/docs/installation/Developerguide/anonymous-blocks.md deleted file mode 100644 index 9eb9cb9a9c22d2813392ca5dedf0f6289f9978ab..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/anonymous-blocks.md +++ /dev/null @@ -1,21 +0,0 @@ -# Anonymous Blocks - -An anonymous block applies to a script infrequently executed or a one-off activity. An anonymous block is executed in a session and is not stored. - -## Syntax - -[Figure 1](#en-us_topic_0237122218_en-us_topic_0059779171_f19ed9f384e0646f29744951d7eec8c3b) shows the syntax diagrams for an anonymous block. - -**Figure 1** anonymous\_block::= -![](figures/anonymous_block.png "anonymous_block") - -Details about the syntax diagram are as follows: - -- The execute part of an anonymous block starts with a **BEGIN** statement, has a break with an **END** statement, and ends with a semicolon \(;\). Type a slash \(/\) and press **Enter** to execute the statement. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >The terminator "/" must be written in an independent row. - -- The declaration section includes the variable definition, type, and cursor definition. -- A simplest anonymous block does not execute any commands. At least one statement, even a **NULL** statement, must be presented in any implementation blocks. - diff --git a/content/en/docs/installation/Developerguide/api-reference.md b/content/en/docs/installation/Developerguide/api-reference.md deleted file mode 100644 index 153cde565fdf7779c72115a24f7f5d0df363f29d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/api-reference.md +++ /dev/null @@ -1,9 +0,0 @@ -# API Reference - -- **[JDBC](jdbc.md)** - -- **[ODBC](odbc.md)** - -- **[libpq](libpq.md)** - - diff --git a/content/en/docs/installation/Developerguide/apis.md b/content/en/docs/installation/Developerguide/apis.md deleted file mode 100644 index e41a9216829af3a2294df51ae290428b63110429..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/apis.md +++ /dev/null @@ -1,36 +0,0 @@ -# APIs - -You can use standard database APIs, such as **ODBC** and **JDBC**, to develop openGauss-based applications. - -## Supported APIs - -Each application is an independent openGauss development project. APIs alleviate applications from directly operating in databases, and enhance the database portability, extensibility, and maintainability. [Table 1](#en-us_topic_0237120293_en-us_topic_0059777757_tc44f4815cb564ea182d5864daa2709b4) lists the APIs supported by openGauss and the download addresses. - -**Table 1** Database APIs - - - - - - - - - - - - - -

API

-

How to Obtain

-

ODBC

-		 -

JDBC

-
  • Driver: openGauss-x.x-EULER-64bit-Jdbc.tar.gz
  • Driver: org.postgresql.Driver
-
- -You can use **JDBC** and **ODBC** to connect to the database. Therefore, you need to [configure a remote connection](configuring-a-remote-connection.md) in openGauss. - -For details about more APIs, see [Application Development Guide](application-development-guide.md). - diff --git a/content/en/docs/installation/Developerguide/appendix.md b/content/en/docs/installation/Developerguide/appendix.md deleted file mode 100644 index 2a6ddaa087e44fe15ff6a386d0f10b5ffe92a08a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/appendix.md +++ /dev/null @@ -1,9 +0,0 @@ -# Appendix - -- **[GIN Indexes](gin-indexes.md)** - -- **[Extended Functions](extended-functions.md)** - -- **[Extended Syntax](extended-syntax.md)** - - diff --git a/content/en/docs/installation/Developerguide/application-development-guide.md b/content/en/docs/installation/Developerguide/application-development-guide.md deleted file mode 100644 index 3465e8acd278d3d721dc398f791d46c21874c10b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/application-development-guide.md +++ /dev/null @@ -1,13 +0,0 @@ -# Application Development Guide - -- **[Development Specifications](development-specifications.md)** - -- **[Development Based on JDBC](development-based-on-jdbc.md)** - -- **[Development Based on ODBC](development-based-on-odbc.md)** - -- **[Development Based on libpq](development-based-on-libpq.md)** - -- **[Commissioning](commissioning.md)** - - diff --git a/content/en/docs/installation/Developerguide/archiving.md b/content/en/docs/installation/Developerguide/archiving.md deleted file mode 100644 index a1d85836e59ac7f24b9f1cc5ee8ff00389e8a478..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/archiving.md +++ /dev/null @@ -1,50 +0,0 @@ -# Archiving - -## archive\_mode - -**Parameter description**: Specifies whether to archive WALs. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->When **[wal\_level](settings.md#en-us_topic_0237124707_en-us_topic_0059778393_s2c76f5957066407a959191148f2c780f)** is set to **minimal**, the **archive\_mode** parameter is unavailable. - -**Value range**: Boolean - -- **on** indicates that the archiving is enabled. -- **off** indicates that the archiving is disabled. - -**Default value**: **off** - -## archive\_command - -**Parameter description:** Specifies the command set by the administrator to archive WALs. You are advised to set the archive log path to an absolute path. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- Any **%p** in the string is replaced by the absolute path of the file to archive, and any **%f** is replaced by only the file name. \(The relative path is relative to the data directory.\) Use **%%** to embed an actual **%** character in the command. ->- This command returns zero only if it succeeds. The following shows the command: -> ``` -> archive_command = 'cp --remove-destination %p /mnt/server/archivedir/%f' -> ``` ->- **--remove-destination** indicates that files will be overwritten during the archiving. - -**Value range**: a string - -**Default value:** **\(disabled\)** - -## archive\_timeout - -**Parameter description**: Specifies the archiving period. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- The server is forced to switch to a new WAL segment file when the period specified by this parameter has elapsed since the last file switch. ->- Archived files that are closed early due to a forced switch are still of the same length as full files. Therefore, a very short **archive\_timeout** will bloat the archive storage. You are advised to set **archive\_timeout** to **60s**. - -**Value range**: an integer ranging from 0 to _INT\_MAX_. The unit is second. **0** indicates that archiving timeout is disabled. - -**Default value**: **0** - diff --git a/content/en/docs/installation/Developerguide/arm-kunpeng-2-socket-128-cores.md b/content/en/docs/installation/Developerguide/arm-kunpeng-2-socket-128-cores.md deleted file mode 100644 index 5f1d67b33de1a426226b2a9a3dffb47f10156169..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/arm-kunpeng-2-socket-128-cores.md +++ /dev/null @@ -1,15 +0,0 @@ -# ARM/Kunpeng 2-Socket 128 Cores - -Two types of tests were performed – Single Node \(without HA\) and Primary/Secondary \(with HA\). - -- Performance - -![](figures/en-us_image_0260488263.png) - -As seen in the Figure above, in MOT the replication overhead of a Primary/Secondary High Availability scenario is 7% on ARM/Kunpeng and 2% on x86 servers, as opposed to the overhead in Disk-tables of 20% on ARM/Kunpeng and 15% on x86 servers. - -- Performance per CPU core - -**Figure 1** ARM/Kunpeng 2-Socket 128 Cores – Performance Benchmarks -![](figures/arm-kunpeng-2-socket-128-cores-performance-benchmarks.png "arm-kunpeng-2-socket-128-cores-performance-benchmarks") - diff --git a/content/en/docs/installation/Developerguide/arm-kunpeng-4-socket-256-cores.md b/content/en/docs/installation/Developerguide/arm-kunpeng-4-socket-256-cores.md deleted file mode 100644 index 8f35cdd29e7caf6cefd9d7a6d84f5c92b0900112..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/arm-kunpeng-4-socket-256-cores.md +++ /dev/null @@ -1,7 +0,0 @@ -# ARM/Kunpeng 4-Socket 256 Cores - -The following demonstrates MOT's excellent concurrency control performance. - -**Figure 1** ARM/Kunpeng 4-Socket 256 Cores – Performance Benchmarks -![](figures/arm-kunpeng-4-socket-256-cores-performance-benchmarks.png "arm-kunpeng-4-socket-256-cores-performance-benchmarks") - diff --git a/content/en/docs/installation/Developerguide/array-expressions.md b/content/en/docs/installation/Developerguide/array-expressions.md deleted file mode 100644 index b1d103a324d3316ad6f18076309c083105cace58..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/array-expressions.md +++ /dev/null @@ -1,94 +0,0 @@ -# Array Expressions - -## IN - -_expression _**IN **_\(value \[, ...\]\)_ - -The parentheses on the right contain an expression list. The expression result on the left is compared with the content in the expression list. If the content in the list meets the expression result on the left, the result of **IN** is **true**. If no result meets the requirements, the result of **IN** is **false**. - -For example: - -``` -postgres=# SELECT 8000+500 IN (10000, 9000) AS RESULT; - result ----------- - f -(1 row) -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If the expression result is null or the expression list does not meet the expression conditions and at least one empty value is returned for the expression list on the right, the result of **IN** is **null** rather than **false**. This method is consistent with the Boolean rules used when SQL statements return empty values. - -## NOT IN - -_expression _**NOT IN**_ \(value \[, ...\]\)_ - -The parentheses on the right contain an expression list. The expression result on the left is compared with the content in the expression list. If the content in the list does not meet the expression result on the left, the result of **NOT IN** is **true**. If any content meets the expression result, the result of **NOT IN** is **false**. - -For example: - -``` -postgres=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; - result ----------- - t -(1 row) -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If the query statement result is null or the expression list does not meet the expression conditions and at least one empty value is returned for the expression list on the right, the result of **NOT IN** is **null** rather than **false**. This method is consistent with the Boolean rules used when SQL statements return empty values. - -In all situations, **X NOT IN Y** equals to **NOT\(X IN Y\)**. - -## ANY/SOME \(array\) - -_expression operator _**ANY **_\(array expression\)_ - -_expression operator _**SOME **_\(array expression\)_ - -``` -postgres=# SELECT 8000+500 < SOME (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) - -``` - -``` -postgres=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) -``` - -The right-hand side is a parenthesized expression, which must yield an array value. The result of the expression on the left uses operators to compute and compare the results in each row of the array expression. The comparison result must be a Boolean value. - -- If at least one comparison result is true, the result of **ANY** is **true**. -- If no comparison result is true, the result of ANY is false. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If no comparison result is true and the array expression generates at least one null value, the value of ANY is NULL, rather than false. This method is consistent with the Boolean rules used when SQL statements return empty values. - -**SOME** is a synonym of **ANY**. - -## ALL \(array\) - -_expression operator _**ALL **_\(array expression\)_ - -The right-hand side is a parenthesized expression, which must yield an array value. The result of the expression on the left uses operators to compute and compare the results in each row of the array expression. The comparison result must be a Boolean value. - -- The result of **ALL** is **true** if all comparisons yield **true** \(including the case where the array has zero elements\). -- The result of **ALL** is **false** if one or multiple comparisons yield **false**. - -If the array expression yields a null array, the result of **ALL** will be null. If the left-hand expression yields null, the result of **ALL** is ordinarily null \(though a non-strict comparison operator could possibly yield a different result\). Also, if the right-hand array contains any null elements and no false comparison result is obtained, the result of **ALL** will be null, not true \(again, assuming a strict comparison operator\). This method is consistent with the Boolean rules used when SQL statements return empty values. - -``` -postgres=# SELECT 8000+500 < ALL (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) -``` - diff --git a/content/en/docs/installation/Developerguide/array-functions-and-operators.md b/content/en/docs/installation/Developerguide/array-functions-and-operators.md deleted file mode 100644 index 7c7f20603cb274567b67cdc95e938b5ccb72dbcf..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/array-functions-and-operators.md +++ /dev/null @@ -1,386 +0,0 @@ -# Array Functions and Operators - -## Array Operators - -- = - - Description: Specifies whether two arrays are equal. - - For example: - - ``` - postgres=# SELECT ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3] AS RESULT ; - result - -------- - t - (1 row) - ``` - -- <\> - - Description: Specifies whether two arrays are not equal. - - For example: - - ``` - postgres=# SELECT ARRAY[1,2,3] <> ARRAY[1,2,4] AS RESULT; - result - -------- - t - (1 row) - ``` - -- < - - Description: Specifies whether an array is less than another. - - For example: - - ``` - postgres=# SELECT ARRAY[1,2,3] < ARRAY[1,2,4] AS RESULT; - result - -------- - t - (1 row) - ``` - -- \> - - Description: Specifies whether an array is greater than another. - - For example: - - ``` - postgres=# SELECT ARRAY[1,4,3] > ARRAY[1,2,4] AS RESULT; - result - -------- - t - (1 row) - ``` - -- <= - - Description: Specifies whether an array is less than another. - - For example: - - ``` - postgres=# SELECT ARRAY[1,2,3] <= ARRAY[1,2,3] AS RESULT; - result - -------- - t - (1 row) - ``` - -- \>= - - Description: Specifies whether an array is greater than or equal to another. - - For example: - - ``` - postgres=# SELECT ARRAY[1,4,3] >= ARRAY[1,4,3] AS RESULT; - result - -------- - t - (1 row) - ``` - -- @\> - - Description: Specifies whether an array contains another. - - For example: - - ``` - postgres=# SELECT ARRAY[1,4,3] @> ARRAY[3,1] AS RESULT; - result - -------- - t - (1 row) - ``` - -- <@ - - Description: Specifies whether an array is contained in another. - - For example: - - ``` - postgres=# SELECT ARRAY[2,7] <@ ARRAY[1,7,4,2,6] AS RESULT; - result - -------- - t - (1 row) - ``` - -- && - - Description: Specifies whether an array overlaps another \(have common elements\). - - For example: - - ``` - postgres=# SELECT ARRAY[1,4,3] && ARRAY[2,1] AS RESULT; - result - -------- - t - (1 row) - ``` - -- || - - Description: Array-to-array concatenation - - For example: - - ``` - postgres=# SELECT ARRAY[1,2,3] || ARRAY[4,5,6] AS RESULT; - result - --------------- - {1,2,3,4,5,6} - (1 row) - ``` - - ``` - postgres=# SELECT ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]] AS RESULT; - result - --------------------------- - {{1,2,3},{4,5,6},{7,8,9}} - (1 row) - ``` - -- || - - Description: Element-to-array concatenation - - For example: - - ``` - postgres=# SELECT 3 || ARRAY[4,5,6] AS RESULT; - result - ----------- - {3,4,5,6} - (1 row) - ``` - -- || - - Description: Array-to-element concatenation - - For example: - - ``` - postgres=# SELECT ARRAY[4,5,6] || 7 AS RESULT; - result - ----------- - {4,5,6,7} - (1 row) - ``` - - -Array comparisons compare the array contents element-by-element, using the default B-tree comparison function for the element data type. In multidimensional arrays, the elements are accessed in row-major order. If the contents of two arrays are equal but the dimensionality is different, the first difference in the dimensionality information determines the sort order. - -## Array Functions - -- array\_append\(anyarray, anyelement\) - - Description: Appends an element to the end of an array, and only supports dimension-1 arrays. - - Return type: anyarray - - For example: - - ``` - postgres=# SELECT array_append(ARRAY[1,2], 3) AS RESULT; - result - --------- - {1,2,3} - (1 row) - ``` - -- array\_prepend\(anyelement, anyarray\) - - Description: Appends an element to the beginning of an array, and only supports dimension-1 arrays. - - Return type: anyarray - - For example: - - ``` - postgres=# SELECT array_prepend(1, ARRAY[2,3]) AS RESULT; - result - --------- - {1,2,3} - (1 row) - ``` - -- array\_cat\(anyarray, anyarray\) - - Description: Concatenates two arrays, and supports multi-dimensional arrays. - - Return type: anyarray - - For example: - - ``` - postgres=# SELECT array_cat(ARRAY[1,2,3], ARRAY[4,5]) AS RESULT; - result - ------------- - {1,2,3,4,5} - (1 row) - - postgres=# SELECT array_cat(ARRAY[[1,2],[4,5]], ARRAY[6,7]) AS RESULT; - result - --------------------- - {{1,2},{4,5},{6,7}} - (1 row) - ``` - -- array\_ndims\(anyarray\) - - Description: Returns the number of dimensions of the array. - - Return type: int - - For example: - - ``` - postgres=# SELECT array_ndims(ARRAY[[1,2,3], [4,5,6]]) AS RESULT; - result - -------- - 2 - (1 row) - ``` - -- array\_dims\(anyarray\) - - Description: Returns the low-order flag bits and high-order flag bits of each dimension in an array. - - Return type: text - - For example: - - ``` - postgres=# SELECT array_dims(ARRAY[[1,2,3], [4,5,6]]) AS RESULT; - result - ------------ - [1:2][1:3] - (1 row) - ``` - -- array\_length\(anyarray, int\) - - Description: Returns the length of the requested array dimension. **int** is the requested array dimension. - - Return type: int - - For example: - - ``` - postgres=# SELECT array_length(array[1,2,3], 1) AS RESULT; - result - -------- - 3 - (1 row) - - postgres=# SELECT array_length(array[[1,2,3],[4,5,6]], 2) AS RESULT; - result - -------- - 3 - (1 row) - ``` - -- array\_lower\(anyarray, int\) - - Description: Returns lower bound of the requested array dimension. **int** is the requested array dimension. - - Return type: int - - For example: - - ``` - postgres=# SELECT array_lower('[0:2]={1,2,3}'::int[], 1) AS RESULT; - result - -------- - 0 - (1 row) - ``` - -- array\_upper\(anyarray, int\) - - Description: Returns upper bound of the requested array dimension. **int** is the requested array dimension. - - Return type: int - - For example: - - ``` - postgres=# SELECT array_upper(ARRAY[1,8,3,7], 1) AS RESULT; - result - -------- - 4 - (1 row) - ``` - -- array\_to\_string\(anyarray, text \[, text\]\) - - Description: Uses the first **text** as the new delimiter and the second **text** to replace **NULL** values. - - Return type: text - - For example: - - ``` - postgres=# SELECT array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*') AS RESULT; - result - ----------- - 1,2,3,*,5 - (1 row) - ``` - -- string\_to\_array\(text, text \[, text\]\) - - Description: Uses the second **text** as the new delimiter and the third **text** as the substring to be replaced by **NULL** values. A substring can be replaced by **NULL** values only when it is the same as the third **text**. - - Return type: text\[\] - - For example: - - ``` - postgres=# SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'yy') AS RESULT; - result - -------------- - {xx,NULL,zz} - (1 row) - postgres=# SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'y') AS RESULT; - result - ------------ - {xx,yy,zz} - (1 row) - ``` - -- unnest\(anyarray\) - - Description: Expands an array to a set of rows. - - Return type: setof anyelement - - For example: - - ``` - postgres=# SELECT unnest(ARRAY[1,2]) AS RESULT; - result - -------- - 1 - 2 - (2 rows) - ``` - - -In **string\_to\_array**, if the delimiter parameter is NULL, each character in the input string will become a separate element in the resulting array. If the delimiter is an empty string, then the entire input string is returned as a one-element array. Otherwise the input string is split at each occurrence of the delimiter string. - -In **string\_to\_array**, if the null-string parameter is omitted or NULL, none of the substrings of the input will be replaced by NULL. - -In **array\_to\_string**, if the null-string parameter is omitted or NULL, any null elements in the array are simply skipped and not represented in the output string. - diff --git a/content/en/docs/installation/Developerguide/arrays-and-records.md b/content/en/docs/installation/Developerguide/arrays-and-records.md deleted file mode 100644 index f7bf3c14be64091687072d9e5494ef6ed553a780..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/arrays-and-records.md +++ /dev/null @@ -1,7 +0,0 @@ -# Arrays and Records - -- **[Arrays](arrays.md)** - -- **[record](record.md)** - - diff --git a/content/en/docs/installation/Developerguide/arrays.md b/content/en/docs/installation/Developerguide/arrays.md deleted file mode 100644 index 6a83265638714a62e0fe458216df0da2859eec73..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/arrays.md +++ /dev/null @@ -1,29 +0,0 @@ -# Arrays - -## Use of Array Types - -Before the use of arrays, an array type needs to be defined: - -Define an array type immediately after the **AS** keyword in a stored procedure. The method is as follows: - -``` -TYPE array_type IS VARRAY(size) OF data_type; -``` - -In the preceding information: - -- **array\_type**: indicates the name of the array type to be defined. -- **VARRAY**: indicates the array type to be defined. -- **size**: indicates the maximum number of members in the array type to be defined. The value is a positive integer. -- **data\_type**: indicates the types of members in the array type to be created. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- In openGauss, an array automatically increases. If an access violation occurs, a null value is returned, and no error message is reported. ->- The scope of an array type defined in a stored procedure takes effect only in this storage process. ->- It is recommended that you use one of the preceding methods to define an array type. If both methods are used to define the same array type, openGauss prefers the array type defined in a stored procedure to declare array variables. - -openGauss supports the access of contents in an array by using parentheses, and the **extend**, **count**, **first**, and **last** functions. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If the stored procedure contains the DML statement \(SELECT, UPDATE, INSERT, or DELETE\), DML statements can access array elements only using brackets. In this way, it may be separated from the function expression area. - diff --git a/content/en/docs/installation/Developerguide/assignment-statements.md b/content/en/docs/installation/Developerguide/assignment-statements.md deleted file mode 100644 index a916f6090a7d5ef3b3c834f4e309e981a287b3b7..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/assignment-statements.md +++ /dev/null @@ -1,26 +0,0 @@ -# Assignment Statements - -## Syntax - -[Figure 1](#en-us_topic_0237122222_en-us_topic_0059778597_f1087f61f4ec24addbb3b79a2ccf21917) shows the syntax diagram for assigning a value to a variable. - -**Figure 1** assignment\_value::= -![](figures/assignment_value.png "assignment_value") - -The above syntax diagram is explained as follows: - -- **variable\_name** indicates the name of a variable. -- **value** can be a value or an expression. The type of **value** must be compatible with the type of **variable\_name**. - -## Example - -``` -postgres=# DECLARE - emp_id INTEGER := 7788; --Assignment -BEGIN - emp_id := 5; --Assignment - emp_id := 5*7784; -END; -/ -``` - diff --git a/content/en/docs/installation/Developerguide/asynchronous-i-o-operations.md b/content/en/docs/installation/Developerguide/asynchronous-i-o-operations.md deleted file mode 100644 index 0935ebd0bd05986a25aceac1e2ed5e07f3ab1d65..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/asynchronous-i-o-operations.md +++ /dev/null @@ -1,111 +0,0 @@ -# Asynchronous I/O Operations - -## enable\_adio\_debug - -**Parameter description**: Specifies whether O&M personnel are allowed to generate some ADIO logs to locate ADIO issues. This parameter is used only by developers. Common users are advised not to use it. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** or **true** indicates that generation of ADIO logs is allowed. -- **off** or **false** indicates that generation of ADIO logs is disallowed. - -**Default value**: **off** - -## enable\_adio\_function - -**Parameter description**: Specifies whether to enable the ADIO function. - -The current version does not support enabling the asynchronous IO function. By default, this function is disabled. Please do not modify it yourself. - -**Value range**: Boolean - -- **on** or **true** indicates that the function is enabled. -- **off** or **false** indicates that the function is disabled. - -**Default value**: **off** - -## enable\_fast\_allocate - -**Parameter description**: Specifies whether the quick disk space allocation is enabled. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). This function can be enabled only in the XFS file system. - -**Value range**: Boolean - -- **on** or **true** indicates that the function is enabled. -- **off** or **false** indicates that the function is disabled. - -**Default value**: **off** - -## prefetch\_quantity - -**Parameter description**: Specifies the amount of the I/O that the row-store prefetches using the ADIO. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 128 to 131072. The unit is 8 KB. - -**Default value**: **32MB** \(4096 x 8 KB\) - -## backwrite\_quantity - -**Parameter description**: Specifies the amount of I/O that the row-store writes using the ADIO. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 128 to 131072. The unit is 8 KB. - -**Default value**: **8MB** \(1024 x 8 KB\) - -## cstore\_prefetch\_quantity - -**Parameter description**: Specifies the amount of I/O that the column-store prefetches using the ADIO. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1024 to 1048576. The unit is KB. - -**Default value**: **32MB** - -## cstore\_backwrite\_quantity - -**Parameter description**: Specifies the amount of I/O that the column-store writes using the ADIO. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1024 to 1048576. The unit is KB. - -**Default value**: **8MB** - -## cstore\_backwrite\_max\_threshold - -**Parameter description**: Specifies the maximum amount of buffer I/O that the column-store writes in the database using the ADIO. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 4096 to _INT\_MAX_/2. The unit is KB. - -**Default value**: **2GB** - -## fast\_extend\_file\_size - -**Parameter description**: Specifies the disk size that the row-store pre-scales using the ADIO. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1024 to 1048576. The unit is KB. - -**Default value**: **8MB** - -## effective\_io\_concurrency - -**Parameter description**: Specifies the number of requests that can be simultaneously processed by a disk subsystem. For the RAID array, the parameter value must be the number of disk drive spindles in the array. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 1000 - -**Default value**: **1** - diff --git a/content/en/docs/installation/Developerguide/asynchronous-redo-logging.md b/content/en/docs/installation/Developerguide/asynchronous-redo-logging.md deleted file mode 100644 index f09b5d0ce991d88d6fe9e9ef5e8b6ab2dd43cc98..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/asynchronous-redo-logging.md +++ /dev/null @@ -1,30 +0,0 @@ -# Asynchronous Redo Logging - -The **Asynchronous Redo Logging** option is the fastest logging method, However, it does not ensure no data loss, meaning that some data that is still in the buffer and was not yet written to disk may get lost upon a power failure or database crash. When a transaction is committed by a client application, the transaction redo entries are recorded in internal buffers and written to disk at preconfigured intervals. The client application does not wait for the data being written to disk. It continues to the next transaction. This is what makes asynchronous redo logging the fastest logging method. - -When a transaction is committed by a client application, the transaction redo entries are recorded in the WAL Redo Log, as follows – - -1. While a transaction is in progress, it is stored in the MOT's memory. -2. After a transaction finishes and the client application sends a Commit command, the transaction redo entries are written to internal buffers, but are not yet written to disk. Then changes to the MOT data memory take place and the client application is notified that the transaction is committed. -3. At a preconfigured interval, a redo log thread running in the background collects all the buffered redo log entries and writes them to disk. - -## **Technical Description** - -Upon transaction commit, the transaction buffer is moved \(pointer assignment – not a data copy\) to a centralized buffer and a new transaction buffer is allocated for the transaction. The transaction is released as soon as its buffer is moved to the centralized buffer and the transaction thread is not blocked. The actual write to the log uses the Postgres walwriter thread. When the walwriter timer elapses, it first calls the AsynchronousRedoLogHandler \(via registered callback\) to write its buffers and then continues with its logic and flushes the data to the XLOG. - -**Figure 1** Asynchronous Logging![](figures/asynchronous-logging.png) - -## **Summary** - -The Asynchronous Redo Logging option is the fastest logging option because it does not require the client application to wait for data being written to disk. In addition, it groups many transactions redo entries and writes them together, thus reducing the amount of disk I/Os that slow down the MOT engine. - -The downside of the Asynchronous Redo Logging option is that it does not ensure that data will not get lost upon a crash or failure. Data that was committed, but was not yet written to disk, is not durable on commit and thus cannot be recovered in case of a failure. The Asynchronous Redo Logging option is most relevant for applications that are willing to sacrifice data recovery \(consistency\) over performance. - -Logging Design Details - -The following describes the design details of each persistence-related component in the In-Memory Engine Module. - -**Figure 2** Three Logging Options![](figures/three-logging-options.png) - -The RedoLog component is used by both by backend threads that use the In-Memory Engine and by the WAL writer in order to persist their data. Checkpoints are performed using the Checkpoint Manager, which is triggered by the Postgres checkpointer. - diff --git a/content/en/docs/installation/Developerguide/audit-switch.md b/content/en/docs/installation/Developerguide/audit-switch.md deleted file mode 100644 index f377d32216a6e36f6fa439fc0a7a58bdedf9e246..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/audit-switch.md +++ /dev/null @@ -1,107 +0,0 @@ -# Audit Switch - -## audit\_enabled - -**Parameter description**: Specifies whether to enable or disable the audit process. After the audit process is enabled, the auditing information written by the background process can be read from the pipe and written into audit files. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the auditing function is enabled. -- **off** indicates that the auditing function is disabled. - -**Default value**: **on** - -## audit\_directory - -**Parameter description**: Specifies the storage directory of audit files. It is a customizable path related to the data directory. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -**Default value:** **pg\_audit** If **om** is used for openGauss deployment, audit logs are stored in **$GAUSSLOG/pg\_audit/_Instance name_**. - -## audit\_data\_format - -**Parameter description**: Audits the format of log files. Currently, only the binary format is supported. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -**Default value**: **binary** - -## audit\_rotation\_interval - -**Parameter description**: Specifies the interval of creating an audit log file. If the difference between the current time and the time when the previous audit log file is created is greater than the value of **audit\_rotation\_interval**, a new audit log file will be generated. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to _INT\_MAX_/60. The unit is min. - -**Default value:** **1d** - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Adjust this parameter only when required. Otherwise, **audit\_resource\_policy** may fail to take effect. To control the storage space and time of audit logs, set the [audit\_resource\_policy](#en-us_topic_0237124745_section939915522551), [audit\_space\_limit](#en-us_topic_0237124745_en-us_topic_0059777744_s167d5900250946bca199444c0617c714), and [audit\_file\_remain\_time](#en-us_topic_0237124745_section149961828185211) parameters. - -## audit\_rotation\_size - -**Parameter description**: Specifies the maximum capacity of an audit log file. If the total number of messages in an audit log exceeds the value of **audit\_rotation\_size**, the server will generate a new audit log file. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1024 to 1048576. The unit is KB. - -**Default value**: **10 MB** - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Adjust this parameter only when required. Otherwise, **audit\_resource\_policy** may fail to take effect. To control the storage space and time of audit logs, set the **audit\_resource\_policy**, **audit\_space\_limit**, and **audit\_file\_remain\_time** parameters. - -## audit\_resource\_policy - -**Parameter description**: Specifies the policy for determining whether audit logs are preferentially stored by space or time. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that audit logs are preferentially stored by space. A maximum of [audit\_space\_limit](#en-us_topic_0237124745_en-us_topic_0059777744_s167d5900250946bca199444c0617c714) logs can be stored. -- **off** indicates that audit logs are preferentially stored by time. A minimum duration of [audit\_file\_remain\_time](#en-us_topic_0237124745_section149961828185211) logs must be stored. - -**Default value**: **on** - -## audit\_file\_remain\_time - -**Parameter description**: Specifies the minimum duration required for recording audit logs. This parameter is valid only when [audit\_resource\_policy](#en-us_topic_0237124745_section939915522551) is set to **off**. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 730. The unit is day. **0** indicates that the storage duration is not limited. - -**Default value**: **90** - -## audit\_space\_limit - -**Parameter description**: Specifies the total disk space occupied by audit files. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1024 KB to 1024 GB. The unit is KB. - -**Default value**: **1GB** - -## audit\_file\_remain\_threshold - -**Parameter description**: Specifies the maximum number of audit files in the audit directory. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to 1048576 - -**Default value**: **1048576** - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Ensure that this parameter is set to **1048576**. Adjust this parameter only when required. Otherwise, **audit\_resource\_policy** may fail to take effect. To control the storage space and time of audit logs, set the **audit\_resource\_policy**, **audit\_space\_limit**, and **audit\_file\_remain\_time** parameters. - diff --git a/content/en/docs/installation/Developerguide/auditing.md b/content/en/docs/installation/Developerguide/auditing.md deleted file mode 100644 index c6c789964bd34b164efbc63151558d57c22a497a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/auditing.md +++ /dev/null @@ -1,9 +0,0 @@ -# Auditing - -- **[Audit Switch](audit-switch.md)** - -- **[User and Permission Audit](user-and-permission-audit.md)** - -- **[Operation Auditing](operation-auditing.md)** - - diff --git a/content/en/docs/installation/Developerguide/automatic-vacuuming.md b/content/en/docs/installation/Developerguide/automatic-vacuuming.md deleted file mode 100644 index 3d6a900c5f919e9794083c5bf380b8811ad81fd5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/automatic-vacuuming.md +++ /dev/null @@ -1,192 +0,0 @@ -# Automatic Vacuuming - -The autovacuum process automatically runs the **VACUUM** and **ANALYZE** statements to reclaim the record space marked as deleted and update statistics about the table. - -## autovacuum - -**Parameter description**: Specifies whether to enable the autovacuum process in the database. Ensure that the [track\_counts](query-and-index-statistics-collector.md#en-us_topic_0237124727_en-us_topic_0059779313_s3f4fb0b1004041f69e1454c701952411) parameter is set to **on** before enabling the automatic cleanup process. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- Set the **autovacuum** parameter to **on** if you want to enable the automatic cleanup of abnormal two-phase transactions when the system recovers from faults. ->- If **autovacuum** is set to **on** and **[autovacuum\_max\_workers](#en-us_topic_0237124730_en-us_topic_0059778244_s76932f79410248ba8923017d19982673)** to **0**, the autovacuum process is enabled only when the system recovers from faults to clean up abnormal two-phase transactions. ->- If **autovacuum** is set to **on** and **[autovacuum\_max\_workers](#en-us_topic_0237124730_en-us_topic_0059778244_s76932f79410248ba8923017d19982673)** to a value greater than **0**, the autovacuum process is enabled to clean up bloated tables during daily operations and abnormal two-phase transactions when the system recovers from faults. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Even if the **autovacuum** parameter is set to **off**, the autovacuum process will be enabled automatically when a transaction ID wraparound is about to occur. When a CREATE DATABASE or DROP DATABASE operation fails, it is possible that the transaction has been committed or rolled back on some nodes whereas some nodes are still in the prepared status. In this case, manual operation as follows is required to restore the nodes: ->1. Use the gs\_clean tool \(setting the **option** parameter to -N\) to query the xid of the abnormal two-phase transaction and nodes in the prepared status. ->2. Log in to the nodes in the prepared status. Administrators connect to an available database such as **postgres** and run the **set xc\_maintenance\_mode = on** statement. ->3. Commit or roll back the two-phase transaction based on the global transaction status. - -**Value range**: Boolean - -- **on** indicates that the autovacuum process is enabled. -- **off** indicates that the autovacuum process is disabled. - -**Default value**: **on** - -## autovacuum\_mode - -**Parameter description**: Specifies whether the autoanalyze or autovacuum function is enabled. This parameter is valid only when **autovacuum** is set to **on**. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Valid value**: enumerated values - -- **analyze** indicates that only autoanalyze is performed. -- **vacuum** indicates that only autovacuum is performed. -- **mix** indicates that both autoanalyze and autovacuum are performed. -- **none** indicates that neither of them is performed. - -**Default value**: **mix** - -## autoanalyze\_timeout - -**Parameter description**: Specifies the timeout period of autoanalyze. If the duration of autoanalyze on a table exceeds the value of **autoanalyze\_timeout**, the autoanalyze is automatically canceled. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 0 to 2147483. The unit is s. - -**Default value**: **5min** \(300s\) - -## autovacuum\_io\_limits - -**Parameter description**: Specifies the upper limit of I/Os triggered by the autovacuum process per second. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer. The value can be **–1** or a number ranging from 0 to 1073741823. **–1** indicates that the default cgroup is used. - -**Default value**: **–1** - -## log\_autovacuum\_min\_duration - -**Parameter description**: Records each step performed by the autovacuum process to the server log when the execution time of the autovacuum process is greater than or equal to a certain value. This parameter helps track the autovacuum behavior. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -A setting example is as follows: - -Set the **log\_autovacuum\_min\_duration** parameter to 250 ms to record the actions of autovacuum if it runs for 250 ms or longer. - -**Value range**: an integer ranging from –1 to 2147483647. The unit is ms. - -- **0** indicates that all autovacuum actions are recorded in the log. -- **–1** indicates that all autovacuum actions are not recorded in the log. -- A value other than **–1** indicates that a message is recorded when an autovacuum action is skipped due to a lock conflict. - -**Default value**: **–1** - -## autovacuum\_max\_workers - -**Parameter description**: Specifies the maximum number of autovacuum worker threads that can run at the same time. The upper limit of this parameter is related to the values of **max\_connections** and **job\_queue\_processes**. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer. The minimum value is **0**, indicating that autovacuum is not enabled. The theoretical maximum value is **262143**, but the actual maximum value is a dynamic value calculated by the following formula: 262143 - **max\_connections** - **job\_queue\_processes** - Number of auxiliary threads - Number of autovacuum launcher threads - 1. The number of auxiliary threads and the number of autovacuum launcher threads are specified by two macros. Their default values are **20** and **2** respectively. - -**Default value**: **3** - -## autovacuum\_naptime - -**Parameter description**: Specifies the interval between activity rounds for the autovacuum process. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 1 to 2147483. The unit is s. - -**Default value**: **10min** \(600s\) - -## autovacuum\_vacuum\_threshold - -**Parameter description**: Specifies the threshold for triggering the **VACUUM** operation. When the number of deleted or updated records in a table exceeds the specified threshold, the **VACUUM** operation is executed on this table. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 0 to 2147483647. - -**Default value**: **50** - -## autovacuum\_analyze\_threshold - -**Parameter description**: Specifies the threshold for triggering the **ANALYZE** operation. When the number of deleted, inserted, or updated records in a table exceeds the specified threshold, the **ANALYZE** operation is executed on this table. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 0 to 2147483647 - -**Default value**: **50** - -## autovacuum\_vacuum\_scale\_factor - -**Parameter description**: Specifies a fraction of the table size added to the **autovacuum\_vacuum\_threshold** parameter when deciding whether to vacuum a table. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: a floating point number ranging from 0.0 to 100.0 - -**Default value**: **0.2** - -## autovacuum\_analyze\_scale\_factor - -**Parameter description**: Specifies a fraction of the table size added to the **autovacuum\_analyze\_threshold** parameter when deciding whether to analyze a table. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: a floating point number ranging from 0.0 to 100.0 - -**Default value**: **0.1** - -## autovacuum\_freeze\_max\_age - -**Parameter description**: Specifies the maximum age \(in transactions\) that a table's **pg\_class.relfrozenxid** field can attain before a VACUUM operation is performed. - -- The old files under the subdirectory of **pg\_clog/** can also be deleted by the **VACUUM** operation. -- Even if the autovacuum process is disabled, the system will invoke the process to prevent transaction ID wraparound. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer from 100000 to 576460752303423487 - -**Default value**: **20000000000** - -## autovacuum\_vacuum\_cost\_delay - -**Parameter description**: Specifies the value of the cost delay used in the autovacuum operation. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from –1 to 100. The unit is ms. **–1** indicates that the normal vacuum cost delay is used. - -**Default value**: **20ms** - -## autovacuum\_vacuum\_cost\_limit - -**Parameter description**: Specifies the value of the cost limit used in the autovacuum operation. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from –1 to 10000 **–1** indicates that the normal vacuum cost limit is used. - -**Default value**: **–1** - -## twophase\_clean\_workers - -**Parameter description**: Specifies the maximum number of concurrent cleanup operations that can be performed by the gs\_clean tool. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 1 to 10 - -**Default value**: **3** - -## defer\_csn\_cleanup\_time - -**Parameter description**: Specifies the interval of recycling transaction IDs. - -**Value range**: an integer ranging from 0 to _INT\_MAX_. The unit is ms. - -**Default value**: **5s** \(5000 ms\) - diff --git a/content/en/docs/installation/Developerguide/autonomous-transaction.md b/content/en/docs/installation/Developerguide/autonomous-transaction.md deleted file mode 100644 index 0bebe4b2f3af4aca6beb732cdeed567b20c51ec5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/autonomous-transaction.md +++ /dev/null @@ -1,13 +0,0 @@ -# Autonomous Transaction - -An autonomous transaction divides a main transaction into several sub-transactions. The main transaction is executed only after the sub-transactions are executed. Sub-transactions are independent of the main transaction. The **ROLLBACK** and **COMMIT** operations in a sub-transaction affect only the DML operations in the sub-transaction. Similarly, the **ROLLBACK** and **COMMIT** operations in the main transaction affect only the DML operations in the main transaction, and do not affect the DML operations in the sub-transactions. A **COMMIT** operation in a sub-transaction will not be undone by the **ROLLBACK** operation in the main transaction. - -An autonomous transaction is defined in a function or stored procedure and specified by the **PRAGMA AUTONOMOUS\_TRANSACTION** keyword. - -- **[User-defined Function Supporting Autonomous Transaction](user-defined-function-supporting-autonomous-transaction.md)** - -- **[Stored Procedure Supporting Autonomous Transaction](stored-procedure-supporting-autonomous-transaction.md)** - -- **[Restrictions](restrictions.md)** - - diff --git a/content/en/docs/installation/Developerguide/background-writer.md b/content/en/docs/installation/Developerguide/background-writer.md deleted file mode 100644 index e0ed2f02f14e76f7cac57c4719ad6711186904bf..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/background-writer.md +++ /dev/null @@ -1,49 +0,0 @@ -# Background Writer - -This section describes background writer parameters. The background writer process is used to write dirty data \(new or modified data\) in shared buffers to disks. This mechanism ensures that database processes seldom or never need to wait for a write action to occur when handling user queries. - -It also mitigates performance deterioration caused by checkpoints because only a few of dirty pages need to be flushed to the disk when the checkpoints arrive. This mechanism, however, increases the overall net I/O load because while a repeatedly-dirtied page may otherwise be written only once per checkpoint interval, the background writer may write it several times as it is dirtied in the same interval. In most cases, continuous light loads are preferred, instead of periodical load peaks. The parameters discussed in this section can be set based on actual requirements. - -## bgwriter\_delay - -**Parameter description**: Specifies the interval at which the background writer writes dirty shared buffers. The background writer initiates write operations for some dirty shared buffers \(the volume of data to be written is specified by the **bgwriter\_lru\_maxpages** parameter\), sleep for the milliseconds specified by **bgwriter\_delay**, and then restarts. - -In many systems, the effective resolution of sleep delays is 10 milliseconds. Therefore, setting this parameter to a value that is not a multiple of 10 has the same effect as setting it to the next higher multiple of 10. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 10 to 10000. The unit is millisecond. - -**Default value**: **2s** - -**Setting suggestion:** Reduce this value in slow data writing scenarios to reduce the checkpoint load. - -## bgwriter\_lru\_maxpages - -**Parameter description**: Specifies the number of dirty buffers the background writer can write in each round. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 1000 - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->When this parameter is set to **0**, the background writer is disabled. This setting does not affect checkpoints. - -**Default value**: **100** - -## bgwriter\_lru\_multiplier - -**Parameter description**: Specifies the coefficient used to estimate the number of dirty buffers the background writer can write in the next round. - -The number of dirty buffers written in each round depends on the number of buffers used by server processes during recent rounds. The estimated number of buffers required in the next round is calculated using the following formula: Average number of recently used buffers x **bgwriter\_lru\_multiplier**. The background writer writes dirty buffers until sufficient clean and reusable buffers are available. The number of buffers the background writer writes in each round is always equal to or less than **bgwriter\_lru\_maxpages**. - -Therefore, the value **1.0** represents a just-in-time policy of writing exactly the number of dirty buffers predicted to be required. Larger values provide some cushion against spikes in demand, whereas smaller values intentionally leave more writes to be done by server processes. - -Smaller values of **bgwriter\_lru\_maxpages** and **bgwriter\_lru\_multiplier** reduce the extra I/O load caused by the background writer, but make it more likely that server processes will have to issue writes for themselves, delaying interactive queries. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a floating point number ranging from 0 to 10 - -**Default value:** **2** - diff --git a/content/en/docs/installation/Developerguide/backup-and-restoration-control-functions.md b/content/en/docs/installation/Developerguide/backup-and-restoration-control-functions.md deleted file mode 100644 index b9cd5114a8b14512642d0332e8ab81f4bc9342f9..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/backup-and-restoration-control-functions.md +++ /dev/null @@ -1,205 +0,0 @@ -# Backup and Restoration Control Functions - -## Backup Control Functions - -Backup control functions help with online backup. - -- pg\_create\_restore\_point\(name text\) - - Description: Creates a named point for performing the restore operation \(restricted to system administrators\). - - Return type: text - - Note: **pg\_create\_restore\_point** creates a named transaction log record that can be used as a restoration target, and returns the corresponding transaction log location. The given name can then be used with **recovery\_target\_name** to specify the point up to which restoration will proceed. Avoid creating multiple restoration points with the same name, since restoration will stop at the first one whose name matches the restoration target. - -- pg\_current\_xlog\_location\(\) - - Description: Obtains the write position of the current transaction log. - - Return type: text - - Note: **pg\_current\_xlog\_location** displays the write position of the current transaction log in the same format as those of the previous functions. Read-only operations do not require rights of the system administrator. - -- pg\_current\_xlog\_insert\_location\(\) - - Description: Obtains the insert position of the current transaction log. - - Return type: text - - Note: **pg\_current\_xlog\_insert\_location** displays the insert position of the current transaction log. The insertion point is the logical end of the transaction log at any instant, while the write location is the end of what has been written out from the server's internal buffers. The write position is the end that can be detected externally from the server. This operation can be performed to archive only some of completed transaction log files. The insert position is used for commissioning the server. Read-only operations do not require rights of the system administrator. - -- pg\_start\_backup\(label text \[, fast boolean \]\) - - Description: Starts executing online backup \(restricted to system administrators or replication roles\). - - Return type: text - - Note: **pg\_start\_backup** receives a user-defined backup label \(usually the name of the position where the backup dump file is stored\). This function writes a backup label file to the data directory of openGauss and then returns the starting position of backed up transaction logs in text mode. - - ``` - postgres=# SELECT pg_start_backup('label_goes_here'); - pg_start_backup - ----------------- - 0/3000020 - (1 row) - ``` - -- pg\_stop\_backup\(\) - - Description: Completes online backup \(restricted to system administrators or replication roles\). - - Return type: text - - Note: **pg\_stop\_backup** deletes the label file created by **pg\_start\_backup** and creates a backup history file in the transaction log archive area. The history file includes the label given to **pg\_start\_backup**, the starting and ending transaction log locations for the backup, and the starting and ending times of the backup. The return value is the backup's ending transaction log location. After the ending position is calculated, the insert position of the current transaction log automatically goes ahead to the next transaction log file. This way, the ended transaction log file can be immediately archived so that backup is complete. - -- pg\_switch\_xlog\(\) - - Description: Switches to a new transaction log file \(restricted to system administrators\). - - Return type: text - - Note: **pg\_switch\_xlog** moves to the next transaction log file so that the current log file can be archived \(if continuous archive is used\). The return value is the ending transaction log location + 1 within the just-completed transaction log file. If there has been no transaction log activity since the last transaction log switchover, **pg\_switch\_xlog** will do nothing but return the start location of the transaction log file currently in use. - -- pg\_xlogfile\_name\(location text\) - - Description: Converts the position string in a transaction log to a file name. - - Return type: text - - Note: **pg\_xlogfile\_name** extracts only the transaction log file name. If the given transaction log position is the transaction log file border, a transaction log file name will be returned for both the two functions. This is usually the desired behavior for managing transaction log archiving, since the preceding file is the last one that currently needs to be archived. - -- pg\_xlogfile\_name\_offset\(location text\) - - Description: Converts the position string in a transaction log to a file name and returns the byte offset in the file. - - Return type: text, integer - - Note: **pg\_xlogfile\_name\_offset** can extract transaction log file names and byte offsets from the returned results of the preceding functions. Example: - - ``` - postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup()); - NOTICE: pg_stop_backup cleanup done, waiting for required WAL segments to be archived - NOTICE: pg_stop_backup complete, all required WAL segments have been archived - file_name | file_offset - --------------------------+------------- - 000000010000000000000003 | 272 - (1 row) - ``` - -- pg\_xlog\_location\_diff\(location text, location text\) - - Description: **pg\_xlog\_location\_diff** calculates the difference in bytes between two transaction log locations. - - Return type: numeric - -- pg\_cbm\_tracked\_location\(\) - - Description: Queries for the LSN location parsed by CBM. - - Return type: text - -- pg\_cbm\_get\_merged\_file\(startLSNArg text, endLSNArg text\) - - Description: Combines CBM files within the specified LSN range into one and returns the name of the combined file. - - Return type: text - -- pg\_cbm\_get\_changed\_block\(startLSNArg text, endLSNArg text\) - - Description: Combines CBM files within the specified LSN range into a table and return records of this table. - - Return type: record - - Note: The table columns include the start LSN, end LSN, tablespace OID, database OID, table relfilenode, table fork number, whether the table is deleted, whether the table is created, whether the table is truncated, number of pages in the truncated table, number of modified pages, and list of No. of modified pages. - -- pg\_cbm\_recycle\_file\(targetLSNArg text\) - - Description: Deletes the CBM files that are no longer used and returns the first LSN after the deletion. - - Return type: text - -- pg\_cbm\_force\_track\(targetLSNArg text,timeOut int\) - - Description: Forcibly executes the CBM trace to the specified Xlog position and returns the Xlog position of the actual trace end point. - - Return type: text - -- pg\_enable\_delay\_ddl\_recycle\(is\_full\_backup boolean, backup\_key text\) - - Description: Enables DDL delay and returns the Xlog position of the enabling point. - - Return type: text - -- pg\_disable\_delay\_ddl\_recycle\(barrierLSNArg text, isForce bool, is\_full\_backup boolean, backup\_key text\) - - Description: Disables DDL delay and returns the Xlog range where DDL delay takes effect. - - Return type: record - -- pg\_enable\_delay\_xlog\_recycle\(\) - - Description: Enables Xlog recycle delay. This function is used in primary database node restoration. - - Return type: void - -- pg\_disable\_delay\_xlog\_recycle\(\) - - Description: Disables Xlog recycle delay. This function is used in primary database node restoration. - - Return type: void - - -## Restoration Control Functions - -Restoration control functions provide information about the status of standby nodes. These functions may be executed both during restoration and in normal running. - -- pg\_is\_in\_recovery\(\) - - Description: Returns **true** if restoration is still in progress. - - Return type: bool - -- pg\_last\_xlog\_receive\_location\(\) - - Description: Gets the last transaction log location received and synchronized to disk by streaming replication. While streaming replication is in progress, this will increase monotonically. If restoration has completed, this value will remain static at the value of the last WAL record received and synchronized to disk during restoration. If streaming replication is disabled or if it has not yet started, the function returns **NULL**. - - Return type: text - -- pg\_last\_xlog\_replay\_location\(\) - - Description: Gets last transaction log location replayed during restoration. If restoration is still in progress, this will increase monotonically. If restoration has completed, then this value will remain static at the value of the last WAL record received during that restoration. When the server has been started normally without restoration, the function returns **NULL**. - - Return type: text - -- pg\_last\_xact\_replay\_timestamp\(\) - - Description: Gets the timestamp of last transaction replayed during restoration. This is the time to commit a transaction or abort a WAL record on the primary node. If no transactions have been replayed during restoration, this function will return **NULL**. If restoration is still in progress, this will increase monotonically. If restoration has completed, then this value will remain static at the value of the last WAL record received during that restoration. If the server normally starts without manual intervention, this function will return **NULL**. - - Return type: timestamp with time zone - - -Restoration control functions control restoration processes. These functions may be executed only during restoration. - -- pg\_is\_xlog\_replay\_paused\(\) - - Description: Returns **true** if restoration is paused. - - Return type: bool - -- pg\_xlog\_replay\_pause\(\) - - Description: Pauses restoration immediately. - - Return type: void - -- pg\_xlog\_replay\_resume\(\) - - Description: Restarts restoration if it was paused. - - Return type: void - - -While restoration is paused, no further database changes are applied. In hot standby mode, all new queries will see the same consistent snapshot of the database, and no further query conflicts will be generated until restoration is resumed. - -If streaming replication is disabled, the paused state may continue indefinitely without problem. While streaming replication is in progress, WAL records will continue to be received, which will eventually fill available disk space. This progress depends on the duration of the pause, the rate of WAL generation, and available disk space. - diff --git a/content/en/docs/installation/Developerguide/basic-statements.md b/content/en/docs/installation/Developerguide/basic-statements.md deleted file mode 100644 index 9f978d08c4a5684f8668b789ded593c786b85466..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/basic-statements.md +++ /dev/null @@ -1,14 +0,0 @@ -# Basic Statements - -During PL/SQL programming, you may define some variables, assign values to variables, and call other stored procedures. This chapter describes basic PL/SQL statements, including variable definition statements, value assignment statements, call statements, and return statements. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->You are advised not to call the SQL statements containing passwords in the stored procedures because authorized users may view the stored procedure file in the database and password information is leaked. If a stored procedure contains other sensitive information, permission to access this procedure must be configured, preventing information leakage. - -- **[Define Variable](define-variable.md)** - -- **[Assignment Statements](assignment-statements.md)** - -- **[Call Statement](call-statement.md)** - - diff --git a/content/en/docs/installation/Developerguide/basic-structure.md b/content/en/docs/installation/Developerguide/basic-structure.md deleted file mode 100644 index b792f786803ce7f1cab2a201aad2b1674eaabda3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/basic-structure.md +++ /dev/null @@ -1,47 +0,0 @@ -# Basic Structure - -## Structure - -A PL/SQL block can contain a sub-block which can be placed in any section. The following describes the architecture of a PL/SQL block: - -- **DECLARE**: declares variables, types, cursors, and regional stored procedures and functions used in the PL/SQL block. - - ``` - DECLARE - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >This part is optional if no variable needs to be declared. - >- An anonymous block may omit the **DECLARE** keyword if no variable needs to be declared. - >- For a stored procedure, **AS** is used, which is equivalent to **DECLARE**. The **AS** keyword must be reserved even if there is no variable declaration part. - -- **EXECUTION**: specifies procedure and SQL statements. It is the main part of a program. Mandatory. - - ``` - BEGIN - ``` - -- Exception part: processes errors. Optional. - - ``` - EXCEPTION - ``` - -- End - - ``` - END; - / - ``` - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >You are not allowed to use consecutive tabs in the PL/SQL block because they may result in an exception when the **gsql** tool is executed with the **-r** parameter specified. - - -## Category - -PL/SQL blocks are classified into the following types: - -- Anonymous block: a dynamic block that can be executed only for once. For details about the syntax, see [Figure 1](anonymous-blocks.md#en-us_topic_0237122218_en-us_topic_0059779171_f19ed9f384e0646f29744951d7eec8c3b). -- Subprogram: a stored procedure, function, operator, or packages stored in a database. A subprogram created in a database can be called by other programs. - diff --git a/content/en/docs/installation/Developerguide/basic-text-matching.md b/content/en/docs/installation/Developerguide/basic-text-matching.md deleted file mode 100644 index 18120c6e4ca5f391812a399be0caddeb491f06bc..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/basic-text-matching.md +++ /dev/null @@ -1,53 +0,0 @@ -# Basic Text Matching - -Full text search in openGauss is based on the match operator **@@**, which returns **true** if a **tsvector** \(document\) matches a **tsquery** \(query\). It does not matter which data type is written first: - -``` -postgres=# SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector @@ 'cat & rat'::tsquery AS RESULT; - result ----------- - t -(1 row) -``` - -``` -postgres=# SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::tsvector AS RESULT; - result ----------- - f -(1 row) -``` - -As the above example suggests, a **tsquery** is not raw text, any more than a **tsvector** is. A tsquery contains search terms, which must be already-normalized lexemes, and may combine multiple terms using **AND**, **OR**, and **NOT** operators. For details, see [Text Search Types](text-search-types.md). There are functions **to\_tsquery** and **plainto\_tsquery** that are helpful in converting user-written text into a proper tsquery, for example by normalizing words appearing in the text. Similarly, **to\_tsvector** is used to parse and normalize a document string. So in practice a text search match would look more like this: - -``` -postgres=# SELECT to_tsvector('fat cats ate fat rats') @@ to_tsquery('fat & rat') AS RESULT; -result ----------- - t -(1 row) -``` - -Observe that this match would not succeed if written as follows: - -``` -postgres=# SELECT 'fat cats ate fat rats'::tsvector @@ to_tsquery('fat & rat')AS RESULT; -result ----------- - f -(1 row) -``` - -In the preceding match, no normalization of the word **rats** will occur. Therefore, **rats** does not match **rat**. - -The **@@** operator also supports text input, allowing explicit conversion of a text string to **tsvector** or **tsquery** to be skipped in simple cases. The variants available are: - -``` -tsvector @@ tsquery -tsquery @@ tsvector -text @@ tsquery -text @@ text -``` - -We already saw the first two of these. The form **text @@ tsquery** is equivalent to **to\_tsvector\(text\) @@ tsquery**. The form **text @@ text** is equivalent to **to\_tsvector\(text\) @@ plainto\_tsquery\(text\)**. - diff --git a/content/en/docs/installation/Developerguide/before-you-start.md b/content/en/docs/installation/Developerguide/before-you-start.md deleted file mode 100644 index c9be679d0eee3e99e02ac4f057ece16b64395b0e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/before-you-start.md +++ /dev/null @@ -1,146 +0,0 @@ -# Before You Start - -This section explains how to use databases, including creating databases and tables, inserting data to tables, and querying data in tables. - -## Prerequisites - -openGauss is running properly. - -## Procedure - -1. Log in as the OS user **omm** to the primary node of the database. - - If you are not sure which server the primary node of the database is deployed on, see [Confirming Connection Information](confirming-connection-information.md). - -2. Connect to a database. - - ``` - gsql -d postgres -p 8000 - ``` - - If the following information is displayed, the connection has been established: - - ``` - gsql ((openGauss 1.0.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. - - postgres=# - ``` - - **postgres** is the database generated by default after openGauss installation is complete. You can connect to this database to create a database. **8000** is the port number of the database primary node, and you can change it as needed. You can obtain the port number by following the instructions provided in [Confirming Connection Information](confirming-connection-information.md). - - **Note:** - - - You need to use a client program or tool to connect to the database and to deliver SQL statements - - **gsql** is a command-line interface \(CLI\) tool provided for connecting to a database. For more database connection methods, see [Connecting to a Database](connecting-to-a-database.md). - -3. Create a database user. - - Only administrators that are created during openGauss installation can access the initial database by default. You can also create other database users. - - ``` - CREATE USER joe WITH PASSWORD "Bigdata@123"; - ``` - - If the following information is displayed, the user has been created: - - ``` - CREATE ROLE - ``` - - In this case, you have created a user named **joe**, and the user password is **Bigdata@123**. - - **Note**: For details about how to create users, see [Managing Users and Their Permissions](managing-users-and-their-permissions.md). - -4. Create a database. - - ``` - CREATE DATABASE db_tpcc OWNER joe; - ``` - - If the following information is displayed, the database has been created: - - ``` - CREATE DATABASE - ``` - - After creating the **db\_tpcc** database, you can run the following command to exit the **postgres** database and log in to the **db\_tpcc** database as the user you created for more operations. You can also continue using the default **postgres** database. - - ``` - postgres=# \q - gsql -d db_tpcc -p 8000 -U joe -W Bigdata@123 - gsql ((openGauss 1.0.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. - - db_tpcc=> - ``` - - Create a schema. - - ``` - db_tpcc=> CREATE SCHEMA joe AUTHORIZATION joe; - ``` - - If the following information is displayed, the schema has been created: - - ``` - CREATE SCHEMA - ``` - - **Note:** - - New databases are created in the **pg\_default** tablespace by default. To specify another tablespace, run the following statement: - - ``` - postgres=# CREATE DATABASE db_tpcc WITH TABLESPACE = hr_local; - CREATE DATABASE - ``` - - _hr\_local_ indicates the tablespace name. For details about how to create a tablespace, see [Creating and Managing Tablespaces](creating-and-managing-tablespaces.md). - -5. Create a table. - - - Create a table named **mytable** that has only one column. The column name is **firstcol** and the column type is **integer**. - - ``` - db_tpcc=> CREATE TABLE mytable (firstcol int); - ``` - - ``` - CREATE TABLE - ``` - - - Run the following command to insert data to the table: - - ``` - db_tpcc=> INSERT INTO mytable values (100); - ``` - - If the following information is displayed, the data has been inserted: - - ``` - INSERT 0 1 - ``` - - - Run the following command to view data in the table: - - ``` - db_tpcc=> SELECT * from mytable; - firstcol - ---------- - 100 - (1 row) - ``` - - **Note:** - - - By default, new database objects, such as the **mytable** table, are created in the _$user_ schema. For more details about schemas, see [Creating and Managing Schemas](creating-and-managing-schemas.md). - - For more details about how to create a table, see [Creating and Managing Tables](creating-and-managing-tables.md). - - In addition to the created tables, a database contains many system catalogs. These system catalogs contain openGauss installation information and information about various queries and processes in openGauss. You can collect information about the database by querying system catalogs. For details, see [Querying System Catalogs](querying-system-catalogs.md). - - openGauss supports row and column storage, providing high query performance for interaction analysis in complex scenarios. For details about how to select a storage model, see [Planning a Storage Model](planning-a-storage-model.md). - - - diff --git a/content/en/docs/installation/Developerguide/begin.md b/content/en/docs/installation/Developerguide/begin.md deleted file mode 100644 index 4da755d83438dedd3a6fc4082d658c7d484d538a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/begin.md +++ /dev/null @@ -1,58 +0,0 @@ -# BEGIN - -## Function - -**BEGIN** may be used to initiate an anonymous block or a single transaction. This section describes the syntax of **BEGIN** used to initiate an anonymous block. For details about the **BEGIN** syntax that initiates transactions, see [START TRANSACTION](start-transaction.md). - -An anonymous block is a structure that can dynamically create and execute stored procedure code instead of permanently storing code as a database object in the database. - -## Precautions - -None - -## Syntax - -- Enable an anonymous block. - - ``` - [DECLARE [declare_statements]] - BEGIN - execution_statements - END; - / - ``` - -- Start a transaction. - - ``` - BEGIN [ WORK | TRANSACTION ] - [ - { - ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE | REPEATABLE READ } - | { READ WRITE | READ ONLY } - } [, ...] - ]; - ``` - - -## Parameter Description - -- **declare\_statements** - - Declares a variable, including its name and type, for example, **sales\_cnt int**. - -- **execution\_statements** - - Specifies the statement to be executed in an anonymous block. - - Value range: DML operations (such as select, insert, delete, update) or registered functions in the system catalog. - - -## Examples - -None - -## Helpful Links - -[START TRANSACTION](start-transaction.md) - diff --git a/content/en/docs/installation/Developerguide/best-practices.md b/content/en/docs/installation/Developerguide/best-practices.md deleted file mode 100644 index 093d57ec35bb1bfb6f7ebc21ccc8035c8663733e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/best-practices.md +++ /dev/null @@ -1,79 +0,0 @@ -# Best Practices - -For details about the parameters, see [GS\_OPT\_MODEL](gs_opt_model.md). - -**Table 1** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Model Parameter

-

Recommended Value

-

template_name

-

rlstm

-

model_name

-

The value can be customized, for example, open_ai. The value must meet the unique constraint.

-

datname

-

Name of the database to be served, for example, postgres.

-

ip

-

IP address of the AI Engine, for example, 127.0.0.1.

-

port

-

AI Engine listening port number, for example, 5000.

-

max_epoch

-

Iteration times. A large value is recommended to ensure the convergence effect, for example, 2000.

-

learning_rate

-

(0, 1] is a floating-point number. A large learning rate is recommended to accelerate convergence.

-

dim_red

-

Number of feature values to be reduced.

-

-1: Do not use PCA for dimension reduction. All features are supported.

-

Floating point number in the range of (0, 1]: A smaller value indicates a smaller training dimension and a faster convergence speed, but affects the training accuracy.

-

hidden_units

-

If the feature value dimension is high, you are advised to increase the value of this parameter to increase the model complexity. For example, set this parameter to 64, 128, and so on.

-

batch_size

-

You are advised to increase the value of this parameter based on the amount of encoded data to accelerate model convergence. For example, set this parameter to 256, 512, and so on.

-

Other parameters

-

See GS_OPT_MODEL.

-
- -Recommended parameter settings: - -``` -INSERT INTO gs_opt_model values('rlstm', 'open_ai', 'postgres', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0, false, false, '{S, T}', '{0,0}', '{0,0}', 'Text'); -``` - diff --git a/content/en/docs/installation/Developerguide/bgwriter_stat.md b/content/en/docs/installation/Developerguide/bgwriter_stat.md deleted file mode 100644 index 6072d9e57c1367a094286912ddeccd8e4fa263fb..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/bgwriter_stat.md +++ /dev/null @@ -1,95 +0,0 @@ -# BGWRITER\_STAT - -**BGWRITER\_STAT** displays statistics about the background writer process's activities. - -**Table 1** BGWRITER\_STAT columns - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Name

-

Type

-

Description

-

checkpoints_timed

-

bigint

-

Number of scheduled checkpoints that have been performed

-

checkpoints_req

-

bigint

-

Number of requested checkpoints that have been performed

-

checkpoint_write_time

-

double precision

-

Total time that has been spent in the portion of checkpoint processing where files are written to disk (unit: ms)

-

checkpoint_sync_time

-

double precision

-

Total time that has been spent in the portion of checkpoint processing where files are synchronized to disk (unit: ms)

-

buffers_checkpoint

-

bigint

-

Number of buffers written during checkpoints

-

buffers_clean

-

bigint

-

Number of buffers written by the background writer

-

maxwritten_clean

-

bigint

-

Number of times the background writer stopped a cleaning scan because it had written too many buffers

-

buffers_backend

-

bigint

-

Number of buffers written directly by a backend

-

buffers_backend_fsync

-

bigint

-

Number of times a backend had to execute its own fsync call (normally the background writer handles those even when the backend does its own write)

-

buffers_alloc

-

bigint

-

Number of buffers allocated

-

stats_reset

-

timestamp with time zone

-

Time at which these statistics were last reset

-
- diff --git a/content/en/docs/installation/Developerguide/binary-data-types.md b/content/en/docs/installation/Developerguide/binary-data-types.md deleted file mode 100644 index d8f170b430b6708551c2792d487786c4fa94f3cb..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/binary-data-types.md +++ /dev/null @@ -1,74 +0,0 @@ -# Binary Data Types - -[Table 1](#en-us_topic_0237121951_en-us_topic_0059778141_t910f42f45b374d94afe2798c42fc5ef6) lists the binary data types supported by openGauss. - -**Table 1** Binary data types - - - - - - - - - - - - - - - - - - - - -

Name

-

Description

-

Storage Space

-

BLOB

-

Binary large object

-

-
NOTE:

Column storage cannot be used for the BLOB type.

-
-

The maximum size is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes.

-

RAW

-

Variable-length hexadecimal string

-
NOTE:

Column storage cannot be used for the raw type.

-
-

4 bytes plus the actual hexadecimal string. The maximum size is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes.

-

BYTEA

-

Variable-length binary string

-

4 bytes plus the actual binary string. The maximum size is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes.

-
- ->![](public_sys-resources/icon-note.gif) **NOTE:** ->In addition to the size limitation on each column, the total size of each tuple is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes. - -An example is provided as follows: - -``` --- Create a table. -postgres=# CREATE TABLE blob_type_t1 -( - BT_COL1 INTEGER, - BT_COL2 BLOB, - BT_COL3 RAW, - BT_COL4 BYTEA -) ; - --- Insert data. -postgres=# INSERT INTO blob_type_t1 VALUES(10,empty_blob(), -HEXTORAW('DEADBEEF'),E'\\xDEADBEEF'); - --- Query data in the table. -postgres=# SELECT * FROM blob_type_t1; - bt_col1 | bt_col2 | bt_col3 | bt_col4 ----------+---------+----------+------------ - 10 | | DEADBEEF | \xdeadbeef -(1 row) - --- Delete the table. -postgres=# DROP TABLE blob_type_t1; -``` - diff --git a/content/en/docs/installation/Developerguide/binary-string-functions-and-operators.md b/content/en/docs/installation/Developerguide/binary-string-functions-and-operators.md deleted file mode 100644 index fd12ec6716394edd21f19c3c87afceff92f5d466..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/binary-string-functions-and-operators.md +++ /dev/null @@ -1,172 +0,0 @@ -# Binary String Functions and Operators - -## String Operators - -SQL defines some string functions that use keywords, rather than commas, to separate arguments. - -- octet\_length\(string\) - - Description: Number of bytes in binary string - - Return type: int - - For example: - - ``` - postgres=# SELECT octet_length(E'jo\\000se'::bytea) AS RESULT; - result - -------- - 5 - (1 row) - ``` - -- overlay\(string placing string from int \[for int\]\) - - Description: Replaces substring. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3) AS RESULT; - result - ---------------- - \x5402036d6173 - (1 row) - ``` - -- position\(substring in string\) - - Description: Location of specified substring - - Return type: int - - For example: - - ``` - postgres=# SELECT position(E'\\000om'::bytea in E'Th\\000omas'::bytea) AS RESULT; - result - -------- - 3 - (1 row) - ``` - -- substring\(string \[from int\] \[for int\]\) - - Description: Truncates substring. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT substring(E'Th\\000omas'::bytea from 2 for 3) AS RESULT; - result - ---------- - \x68006f - (1 row) - ``` - -- trim\(\[both\] bytes from string\) - - Description: Removes the longest string containing only bytes from **bytes** from the start and end of **string**. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT trim(E'\\000'::bytea from E'\\000Tom\\000'::bytea) AS RESULT; - result - ---------- - \x546f6d - (1 row) - ``` - - -## Other Binary String Functions - -openGauss provides common syntax used for calling functions. - -- btrim\(string bytea,bytes bytea\) - - Description: Removes the longest string containing only bytes from **bytes** from the start and end of **string**. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT btrim(E'\\000trim\\000'::bytea, E'\\000'::bytea) AS RESULT; - result - ------------ - \x7472696d - (1 row) - ``` - -- get\_bit\(string, offset\) - - Description: Extracts bit from string. - - Return type: int - - For example: - - ``` - postgres=# SELECT get_bit(E'Th\\000omas'::bytea, 45) AS RESULT; - result - -------- - 1 - (1 row) - ``` - -- get\_byte\(string, offset\) - - Description: Extracts byte from string. - - Return type: int - - For example: - - ``` - postgres=# SELECT get_byte(E'Th\\000omas'::bytea, 4) AS RESULT; - result - -------- - 109 - (1 row) - ``` - -- set\_bit\(string,offset, newvalue\) - - Description: Sets bit in string. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT set_bit(E'Th\\000omas'::bytea, 45, 0) AS RESULT; - result - ------------------ - \x5468006f6d4173 - (1 row) - ``` - -- set\_byte\(string,offset, newvalue\) - - Description: Sets byte in string. - - Return type: bytea - - For example: - - ``` - postgres=# SELECT set_byte(E'Th\\000omas'::bytea, 4, 64) AS RESULT; - result - ------------------ - \x5468006f406173 - (1 row) - ``` - - diff --git a/content/en/docs/installation/Developerguide/bios-16.md b/content/en/docs/installation/Developerguide/bios-16.md deleted file mode 100644 index 26cc21db2abc0bfd1e739f9efa6a8f61afa4cbf3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/bios-16.md +++ /dev/null @@ -1,17 +0,0 @@ -# BIOS - -Modify related BIOS settings, as follows: - -1. Select **BIOS** è **Advanced** è **MISC Config**. Set** Support Smmu **to **Disabled**. -2. Select **BIOS** è **Advanced** è **MISC Config**. Set **CPU Prefetching Configuration** to **Disabled**. - - ![](figures/en-us_image_0257713415.png) - -3. Select **BIOS** è **Advanced** è **Memory Config**. Set **Die Interleaving** to **Disabled**. - - ![](figures/en-us_image_0257713417.png) - -4. Select **BIOS** è **Advanced** è **Performance Config**. Set **Power Policy** to **Performance**. - -![](figures/en-us_image_0257713419.png) - diff --git a/content/en/docs/installation/Developerguide/bios.md b/content/en/docs/installation/Developerguide/bios.md deleted file mode 100644 index 706b3856f27f7c5545a6b7ae3e77d24cefb24a8a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/bios.md +++ /dev/null @@ -1,2 +0,0 @@ -# BIOS - diff --git a/content/en/docs/installation/Developerguide/bit-string-functions-and-operators.md b/content/en/docs/installation/Developerguide/bit-string-functions-and-operators.md deleted file mode 100644 index 36bb153e251d29a281d57bcbef23a12edfb9b54c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/bit-string-functions-and-operators.md +++ /dev/null @@ -1,144 +0,0 @@ -# Bit String Functions and Operators - -## Bit String Operators - -Aside from the usual comparison operators, the following operators can be used. Bit string operands of **&**, **|**, and **\#** must be of equal length. When bit shifting, the original length of the string is preserved by zero padding \(if necessary\). - -- || - - Description: Connects bit strings. - - For example: - - ``` - postgres=# SELECT B'10001' || B'011' AS RESULT; - result - ---------- - 10001011 - (1 row) - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >A column can have a maximum of 180 consecutive internal joins. A column with excessive joins will be split into joined consecutive strings. - >Example: **str1||str2||str3||str4** is split into **\(str1||str2\)||\(str3||str4\)**. - -- & - - Description: AND operation between bit strings - - For example: - - ``` - postgres=# SELECT B'10001' & B'01101' AS RESULT; - result - -------- - 00001 - (1 row) - ``` - -- | - - Description: OR operation between bit strings - - For example: - - ``` - postgres=# SELECT B'10001' | B'01101' AS RESULT; - result - -------- - 11101 - (1 row) - ``` - -- \# - - Description: OR operation between bit strings if they are inconsistent. If the same positions in the two bit strings are both 1 or 0, the position returns **0**. - - For example: - - ``` - postgres=# SELECT B'10001' # B'01101' AS RESULT; - result - -------- - 11100 - (1 row) - ``` - -- \~ - - Description: NOT operation between bit strings - - For example: - - ``` - postgres=# SELECT ~B'10001'AS RESULT; - result - ---------- - 01110 - (1 row) - ``` - -- << - - Description: Shifts left in a bit string. - - For example: - - ``` - postgres=# SELECT B'10001' << 3 AS RESULT; - result - ---------- - 01000 - (1 row) - ``` - -- \>\> - - Description: Shifts right in a bit string. - - For example: - - ``` - postgres=# SELECT B'10001' >> 2 AS RESULT; - result - ---------- - 00100 - (1 row) - ``` - - -The following SQL-standard functions work on bit strings as well as strings: **length**, **bit\_length**, **octet\_length**, **position**, **substring**, and **overlay**. - -The following functions work on bit strings as well as binary strings: **get\_bit** and **set\_bit**. When working with a bit string, these functions number the first \(leftmost\) bit of the string as bit 0. - -In addition, it is possible to convert between integral values and type **bit**. For example: - -``` -postgres=# SELECT 44::bit(10) AS RESULT; - result ------------- - 0000101100 -(1 row) - -postgres=# SELECT 44::bit(3) AS RESULT; - result --------- - 100 -(1 row) - -postgres=# SELECT cast(-44 as bit(12)) AS RESULT; - result --------------- - 111111010100 -(1 row) - -postgres=# SELECT '1110'::bit(4)::integer AS RESULT; - result --------- - 14 -(1 row) -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->Casting to just "bit" means casting to bit\(1\), and so will deliver only the least significant bit of the integer. - diff --git a/content/en/docs/installation/Developerguide/bit-string-types.md b/content/en/docs/installation/Developerguide/bit-string-types.md deleted file mode 100644 index 151c7a4c692870c7a193299516f3cb83f631c701..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/bit-string-types.md +++ /dev/null @@ -1,44 +0,0 @@ -# Bit String Types - -Bit strings are strings of 1's and 0's. They can be used to store bit masks. - -openGauss supports two bit string types: bit\(n\) and bit varying\(n\), in which **n** is a positive integer. - -The **bit** type data must match the length **n** exactly. It is an error to attempt to store shorter or longer bit strings. The **bit varying** data is of variable length up to the maximum length **n**; longer strings will be rejected. Writing **bit** without a length is equivalent to **bit\(1\)**, while **bit varying** without a length specification means unlimited length. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If one explicitly casts a bit-string value to **bit\(n\)**, it will be truncated or zero-padded on the right to be exactly **n** bits, without raising an error. ->Similarly, if one explicitly casts a bit-string value to **bit varying\(n\)**, it will be truncated on the right if it is more than **n** bits. - -``` --- Create a table. -postgres=# CREATE TABLE bit_type_t1 -( - BT_COL1 INTEGER, - BT_COL2 BIT(3), - BT_COL3 BIT VARYING(5) -) ; - --- Insert data. -postgres=# INSERT INTO bit_type_t1 VALUES(1, B'101', B'00'); - --- Specify the type length. An error is reported if an inserted string exceeds this length. -postgres=# INSERT INTO bit_type_t1 VALUES(2, B'10', B'101'); -ERROR: bit string length 2 does not match type bit(3) -CONTEXT: referenced column: bt_col2 - --- Specify the type length. Data is converted if it exceeds this length. -postgres=# INSERT INTO bit_type_t1 VALUES(2, B'10'::bit(3), B'101'); - --- View data. -postgres=# SELECT * FROM bit_type_t1; - bt_col1 | bt_col2 | bt_col3 ----------+---------+--------- - 1 | 101 | 00 - 2 | 100 | 101 -(2 rows) - --- Delete the table. -postgres=# DROP TABLE bit_type_t1; -``` - diff --git a/content/en/docs/installation/Developerguide/boolean-data-types.md b/content/en/docs/installation/Developerguide/boolean-data-types.md deleted file mode 100644 index 7420df88711da1d93a69d5aa8d2fdb459fb97350..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/boolean-data-types.md +++ /dev/null @@ -1,72 +0,0 @@ -# Boolean Data Types - -**Table 1** Boolean types - - - - - - - - - - - - - - -

Name

-

Description

-

Storage Space

-

Value

-

BOOLEAN

-

Boolean type

-

1 byte

-
  • true
  • false
  • null (unknown)
-
- -Valid literal values for the "true" state include: - -TRUE, 't', 'true', 'y', 'yes', '1', 'TRUE',true, and an integer ranging from 1 to 2^63-1 or from -1 to -2^63. - -Valid literal values for the "false" state include: - -FALSE, 'f', 'false', 'n', 'no', '0', 'FALSE', false, 0 - -**TRUE** and **FALSE** are standard expressions, compatible with SQL statements. - -## Example - -Boolean values are displayed using the letters t and f. - -``` --- Create a table. -postgres=# CREATE TABLE bool_type_t1 -( - BT_COL1 BOOLEAN, - BT_COL2 TEXT -); - --- Insert data. -postgres=# INSERT INTO bool_type_t1 VALUES (TRUE, 'sic est'); - -postgres=# INSERT INTO bool_type_t1 VALUES (FALSE, 'non est'); - --- View data. -postgres=# SELECT * FROM bool_type_t1; - bt_col1 | bt_col2 ----------+--------- - t | sic est - f | non est -(2 rows) - -postgres=# SELECT * FROM bool_type_t1 WHERE bt_col1 = 't'; - bt_col1 | bt_col2 ----------+--------- - t | sic est -(1 row) - --- Delete the table. -postgres=# DROP TABLE bool_type_t1; -``` - diff --git a/content/en/docs/installation/Developerguide/branch-statements.md b/content/en/docs/installation/Developerguide/branch-statements.md deleted file mode 100644 index 457b378607417a9816bf81eb3a67fb82d107f0b6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/branch-statements.md +++ /dev/null @@ -1,56 +0,0 @@ -# Branch Statements - -## Syntax - -[Figure 1](#en-us_topic_0237122235_en-us_topic_0059779327_fe2376535378e44c78c4e70078d0fb779) shows the syntax diagram for a branch statement. - -**Figure 1** case\_when::= -![](figures/case_when.png "case_when") - -[Figure 2](#en-us_topic_0237122235_en-us_topic_0059779327_f0b6779d008024e8fb5c2267d8d3bff14) shows the syntax diagram for **when\_clause**. - -**Figure 2** when\_clause::= -![](figures/when_clause.png "when_clause") - -Parameter description: - -- _case\_expression_: specifies the variable or expression. -- _when\_expression_: specifies the constant or conditional expression. -- _statement_: specifies the statement to be executed. - -## Examples - -``` -CREATE OR REPLACE PROCEDURE proc_case_branch(pi_result in integer, pi_return out integer) -AS - BEGIN - CASE pi_result - WHEN 1 THEN - pi_return := 111; - WHEN 2 THEN - pi_return := 222; - WHEN 3 THEN - pi_return := 333; - WHEN 6 THEN - pi_return := 444; - WHEN 7 THEN - pi_return := 555; - WHEN 8 THEN - pi_return := 666; - WHEN 9 THEN - pi_return := 777; - WHEN 10 THEN - pi_return := 888; - ELSE - pi_return := 999; - END CASE; - raise info 'pi_return : %',pi_return ; -END; -/ - -CALL proc_case_branch(3,0); - --- Delete the stored procedure. -DROP PROCEDURE proc_case_branch; -``` - diff --git a/content/en/docs/installation/Developerguide/cache-io.md b/content/en/docs/installation/Developerguide/cache-io.md deleted file mode 100644 index 856121a7b5ec42dfa59cb088ef28d77e417c9ec3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cache-io.md +++ /dev/null @@ -1,61 +0,0 @@ -# Cache/IO - -- **[STATIO\_USER\_TABLES](statio_user_tables.md)** - -- **[SUMMARY\_STATIO\_USER\_TABLES](summary_statio_user_tables.md)** - -- **[GLOBAL\_STATIO\_USER\_TABLES](global_statio_user_tables.md)** - -- **[STATIO\_USER\_INDEXES](statio_user_indexes.md)** - -- **[SUMMARY\_STATIO\_USER\_INDEXES](summary_statio_user_indexes.md)** - -- **[GLOBAL\_STATIO\_USER\_INDEXES](global_statio_user_indexes.md)** - -- **[STATIO\_USER\_SEQUENCES](statio_user_sequences.md)** - -- **[SUMMARY\_STATIO\_USER\_SEQUENCES](summary_statio_user_sequences.md)** - -- **[GLOBAL\_STATIO\_USER\_SEQUENCES](global_statio_user_sequences.md)** - -- **[STATIO\_SYS\_TABLES](statio_sys_tables.md)** - -- **[SUMMARY\_STATIO\_SYS\_TABLES](summary_statio_sys_tables.md)** - -- **[GLOBAL\_STATIO\_SYS\_TABLES](global_statio_sys_tables.md)** - -- **[STATIO\_SYS\_INDEXES](statio_sys_indexes.md)** - -- **[SUMMARY\_STATIO\_SYS\_INDEXES](summary_statio_sys_indexes.md)** - -- **[GLOBAL\_STATIO\_SYS\_INDEXES](global_statio_sys_indexes.md)** - -- **[STATIO\_SYS\_SEQUENCES](statio_sys_sequences.md)** - -- **[SUMMARY\_STATIO\_SYS\_SEQUENCES](summary_statio_sys_sequences.md)** - -- **[GLOBAL\_STATIO\_SYS\_SEQUENCES](global_statio_sys_sequences.md)** - -- **[STATIO\_ALL\_TABLES](statio_all_tables.md)** - -- **[SUMMARY\_STATIO\_ALL\_TABLES](summary_statio_all_tables.md)** - -- **[GLOBAL\_STATIO\_ALL\_TABLES](global_statio_all_tables.md)** - -- **[STATIO\_ALL\_INDEXES](statio_all_indexes.md)** - -- **[SUMMARY\_STATIO\_ALL\_INDEXES](summary_statio_all_indexes.md)** - -- **[GLOBAL\_STATIO\_ALL\_INDEXES](global_statio_all_indexes.md)** - -- **[STATIO\_ALL\_SEQUENCES](statio_all_sequences.md)** - -- **[SUMMARY\_STATIO\_ALL\_SEQUENCES](summary_statio_all_sequences.md)** - -- **[GLOBAL\_STATIO\_ALL\_SEQUENCES](global_statio_all_sequences.md)** - -- **[GLOBAL\_STAT\_DB\_CU](global_stat_db_cu.md)** - -- **[GLOBAL\_STAT\_SESSION\_CU](global_stat_session_cu.md)** - - diff --git a/content/en/docs/installation/Developerguide/call-statement.md b/content/en/docs/installation/Developerguide/call-statement.md deleted file mode 100644 index 7bbf249032d6aef95f54555b86e810a9fed370b4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/call-statement.md +++ /dev/null @@ -1,38 +0,0 @@ -# Call Statement - -## Syntax - -[Figure 1](#en-us_topic_0237122223_en-us_topic_0059778001_fa4de2ab1dc7e4c04b4997c6238ee1861) shows the syntax diagram for calling a clause. - -**Figure 1** call\_clause::= -![](figures/call_clause.png "call_clause") - -The above syntax diagram is explained as follows: - -- **procedure\_name** specifies the name of a stored procedure. -- **parameter** specifies the parameters for the stored procedure. You can set no parameter or multiple parameters. - -## Example - -``` --- Create the stored procedure proc_staffs: -postgres=# CREATE OR REPLACE PROCEDURE proc_staffs -( -section NUMBER(6), -salary_sum out NUMBER(8,2), -staffs_count out INTEGER -) -IS -BEGIN -SELECT sum(salary), count(*) INTO salary_sum, staffs_count FROM hr.staffs where section_id = section; -END; -/ - --- Invoke a stored procedure proc_return: -postgres=# CALL proc_staffs(2,8,6); - --- Delete a stored procedure: -postgres=# DROP PROCEDURE proc_staffs; - -``` - diff --git a/content/en/docs/installation/Developerguide/call.md b/content/en/docs/installation/Developerguide/call.md deleted file mode 100644 index 19c747a76eb60cec502054781f6916c5ca3aaf8a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/call.md +++ /dev/null @@ -1,75 +0,0 @@ -# CALL - -## Function - -**CALL** can be used to call defined functions and stored procedures. - -## Precautions - -None - -## Syntax - -``` -CALL [schema.] {func_name| procedure_name} ( param_expr ); -``` - -## Parameter Description - -- **schema** - - Specifies the name of the schema where a function or stored procedure is located. - -- **func\_name** - - Specifies the name of the function or stored procedure to be called. - - Value range: an existing function name - -- **param\_expr** - - Specifies a list of parameters in the function. Use := or =\> to separate a parameter name and its value. This method allows parameters to be placed in any order. If only parameter values are in the list, the value order must be the same as that defined in the function or stored procedure. - - Value range: an existing function parameter name or stored procedure parameter name - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The parameters include input parameters \(whose name and type are separated by IN\) and output parameters \(whose name and type are separated by OUT\). When you run the **CALL** statement to call a function or stored procedure, the parameter list must contain an output parameter for non-overloaded functions. You can set the output parameter to a variable or any constant. For details, see [Examples](#en-us_topic_0237122088_en-us_topic_0059778236_s299dc001fa4b48cd9b56412a73db23c0). For an overloaded package function, the parameter list can have no output parameter, but the function may not be found. If an output parameter is contained, it must be a constant. - - -## Examples - -``` --- Create a function func_add_sql, calculate the sum of two integers, and return the result. -postgres=# CREATE FUNCTION func_add_sql(num1 integer, num2 integer) RETURN integer -AS -BEGIN -RETURN num1 + num2; -END; -/ - --- Transfer by parameter value. -postgres=# CALL func_add_sql(1, 3); - --- Transfer by naming tag method. -postgres=# CALL func_add_sql(num1 => 1,num2 => 3); -postgres=# CALL func_add_sql(num2 := 2, num1 := 3); - --- Delete the function. -postgres=# DROP FUNCTION func_add_sql; - --- Create a function with output parameters. -postgres=# CREATE FUNCTION func_increment_sql(num1 IN integer, num2 IN integer, res OUT integer) -RETURN integer -AS -BEGIN -res := num1 + num2; -END; -/ - --- Transfer a constant as an output parameter. -postgres=# CALL func_increment_sql(1,2,1); - --- Delete the function. -postgres=# DROP FUNCTION func_increment_sql; -``` - diff --git a/content/en/docs/installation/Developerguide/character-data-types.md b/content/en/docs/installation/Developerguide/character-data-types.md deleted file mode 100644 index 02d8d27d81311a2f40374ac4cfba2b466c7f6b80..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/character-data-types.md +++ /dev/null @@ -1,152 +0,0 @@ -# Character Data Types - -[Table 1](#en-us_topic_0237121950_en-us_topic_0059777889_en-us_topic_0058966269_table29186418) lists the character data types supported by openGauss. For string operators and related built-in functions, see [Character Processing Functions and Operators](character-processing-functions-and-operators.md). - -**Table 1** Character data types - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Name

-

Description

-

Storage Space

-

CHAR(n)

-

CHARACTER(n)

-

NCHAR(n)

-

Fixed-length character string, blank padded. n indicates the string length. If it is not specified, the default precision 1 is used.

-

The maximum size is 10 MB.

-

VARCHAR(n)

-

CHARACTER VARYING(n)

-

Variable-length string n indicates the string length.

-

The maximum size is 10 MB.

-

VARCHAR2(n)

-

Variable-length string Alias of the VARCHAR(n) type. n indicates the string length.

-

The maximum size is 10 MB.

-

NVARCHAR2(n)

-

Variable-length string. n indicates the string length.

-

The maximum size is 10 MB.

-

CLOB

-

A big text object. Alias of the TEXT type.

-

The maximum size is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes.

-

TEXT

-

Variable-length string

-

The maximum size is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes.

-
- ->![](public_sys-resources/icon-note.gif) **NOTE:** ->In addition to the size limitation on each column, the total size of each tuple is 8,203 bytes less than 1 GB, namely, 1,073,733,621 bytes. - -In openGauss, there are two other fixed-length character types, as shown in [Table 2](#en-us_topic_0237121950_en-us_topic_0059777889_tf74658686f5e4d979adf0ac04769ea16). The **name** type exists only for the storage of identifiers in the internal system catalogs and is not intended for use by general users. Its length is currently defined as 64 bytes \(63 usable characters plus terminator\). The type **"char"** only uses one byte of storage. It is internally used in the system catalogs as a simplistic enumeration type. - -**Table 2** Special character types - - - - - - - - - - - - - - - - -

Name

-

Description

-

Storage Space

-

name

-

Internal type for object names

-

64 bytes

-

"char"

-

Single-byte internal type

-

1 byte

-
- -## Example - -``` --- Create a table. -postgres=# CREATE TABLE char_type_t1 -( - CT_COL1 CHARACTER(4) -); - --- Insert data. -postgres=# INSERT INTO char_type_t1 VALUES ('ok'); - --- Query data in the table. -postgres=# SELECT ct_col1, char_length(ct_col1) FROM char_type_t1; - ct_col1 | char_length ----------+------------- - ok | 4 -(1 row) - --- Delete the table. -postgres=# DROP TABLE char_type_t1; -``` - -``` --- Create a table. -postgres=# CREATE TABLE char_type_t2 -( - CT_COL1 VARCHAR(5) -); - --- Insert data. -postgres=# INSERT INTO char_type_t2 VALUES ('ok'); - -postgres=# INSERT INTO char_type_t2 VALUES ('good'); - --- Specify the type length. An error is reported if an inserted string exceeds this length. -postgres=# INSERT INTO char_type_t2 VALUES ('too long'); -ERROR: value too long for type character varying(4) -CONTEXT: referenced column: ct_col1 - --- Specify the type length. A string exceeding this length is truncated. -postgres=# INSERT INTO char_type_t2 VALUES ('too long'::varchar(5)); - --- Query data. -postgres=# SELECT ct_col1, char_length(ct_col1) FROM char_type_t2; - ct_col1 | char_length ----------+------------- - ok | 2 - good | 4 - too l | 5 -(3 rows) - --- Delete data. -postgres=# DROP TABLE char_type_t2; -``` - diff --git a/content/en/docs/installation/Developerguide/character-processing-functions-and-operators.md b/content/en/docs/installation/Developerguide/character-processing-functions-and-operators.md deleted file mode 100644 index ea908fd0f50e3546a4ba88fbb94182498975e543..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/character-processing-functions-and-operators.md +++ /dev/null @@ -1,1509 +0,0 @@ -# Character Processing Functions and Operators - -String functions and operators provided by openGauss are for concatenating strings with each other, concatenating strings with non-strings, and matching the patterns of strings. - -- bit\_length\(string\) - - Description: Specifies the number of bits occupied by a string. - - Return type: int - - Example: - - ``` - postgres=# SELECT bit_length('world'); - bit_length - ------------ - 40 - (1 row) - ``` - -- btrim\(string text \[, characters text\]\) - - Description: Removes the longest string consisting only of characters in **characters** \(a space by default\) from the start and end of **string**. - - Return type: text - - Example: - - ``` - postgres=# SELECT btrim('sring' , 'ing'); - btrim - ------- - sr - (1 row) - ``` - -- char\_length\(string\) or character\_length\(string\) - - Description: Number of characters in a string - - Return type: int - - Example: - - ``` - postgres=# SELECT char_length('hello'); - char_length - ------------- - 5 - (1 row) - ``` - -- instr\(text,text,int,int\) - - Description: instr\(string1,string2,int1,int2\) returns the position where _string2_ has been matched for _int2_ times starting from _int1_ in _string1_. _int1_ indicates the starting position for matching, and _int2_ indicates the number of matching times. - - Return type: int - - Example: - - ``` - postgres=# SELECT instr( 'abcdabcdabcd', 'bcd', 2, 2 ); - instr - ------- - 6 - (1 row) - ``` - -- lengthb\(text/bpchar\) - - Description: Obtains the number of bytes of a specified string. - - Return type: int - - Example: - - ``` - postgres=# SELECT lengthb('hello'); - lengthb - --------- - 5 - (1 row) - ``` - -- left\(str text, n int\) - - Description: Returns first **n** characters in the string. When **n** is negative, return all but the last **|n|** characters. - - Return type: text - - Example: - - ``` - postgres=# SELECT left('abcde', 2); - left - ------ - ab - (1 row) - ``` - -- length\(string bytea, encoding name \) - - Description: Number of characters in **string** in the given **encoding**. The **string** must be valid in this encoding. - - Return type: int - - Example: - - ``` - postgres=# SELECT length('jose', 'UTF8'); - length - -------- - 4 - (1 row) - ``` - -- lpad\(string text, length int \[, fill text\]\) - - Description: Fills up the string to length **length** by prepending the characters **fill** \(a space by default\). If the **string** is already longer than **length** then it is truncated \(on the right\). - - Return type: text - - Example: - - ``` - postgres=# SELECT lpad('hi', 5, 'xyza'); - lpad - ------- - xyzhi - (1 row) - ``` - -- octet\_length\(string\) - - Description: Number of bytes in a string - - Return type: int - - Example: - - ``` - postgres=# SELECT octet_length('jose'); - octet_length - -------------- - 4 - (1 row) - ``` - -- overlay\(string placing string FROM int \[for int\]\) - - Description: Replaces substring. **FROM int** indicates the start position of the replacement in the first string. **for int** indicates the number of characters replaced in the first string. - - Return type: text - - Example: - - ``` - postgres=# SELECT overlay('hello' placing 'world' from 2 for 3 ); - overlay - --------- - hworldo - (1 row) - ``` - -- position\(substring in string\) - - Description: Specifies the position of a substring. The string is case sensitive. - - Return type: int, 0 is returned when the string does not exist. - - Example: - - ``` - postgres=# SELECT position('ing' in 'string'); - position - ---------- - 4 - (1 row) - ``` - -- pg\_client\_encoding\(\) - - Description: Current client encoding name - - Return type: name - - Example: - - ``` - postgres=# SELECT pg_client_encoding(); - pg_client_encoding - -------------------- - UTF8 - (1 row) - ``` - -- quote\_ident\(string text\) - - Description: Returns the given string suitably quoted to be used as an identifier in an SQL statement string \(quotation marks are used as required\). Quotes are added only if necessary \(that is, if the string contains non-identifier characters or would be case-folded\). Embedded quotes are properly doubled. - - Return type: text - - Example: - - ``` - postgres=# SELECT quote_ident('hello world'); - quote_ident - -------------- - "hello world" - (1 row) - ``` - -- quote\_literal\(string text\) - - Description: Returns the given string suitably quoted to be used as a string literal in an SQL statement string \(quotation marks are used as required\). - - Return type: text - - Example: - - ``` - postgres=# SELECT quote_literal('hello'); - quote_literal - --------------- - 'hello' - (1 row) - ``` - - If command similar to the following exists, text will be escaped. - - ``` - postgres=# SELECT quote_literal(E'O\'hello'); - quote_literal - --------------- - 'O''hello' - (1 row) - ``` - - If command similar to the following exists, backslash will be properly doubled. - - ``` - postgres=# SELECT quote_literal('O\hello'); - quote_literal - --------------- - E'O\\hello' - (1 row) - ``` - - If the parameter is null, return **NULL**. If the parameter may be null, you are advised to use **quote\_nullable**. - - ``` - postgres=# SELECT quote_literal(NULL); - quote_literal - --------------- - - (1 row) - ``` - -- quote\_literal\(value anyelement\) - - Description: Converts the given value to text and then quotes it as a literal. - - Return type: text - - Example: - - ``` - postgres=# SELECT quote_literal(42.5); - quote_literal - --------------- - '42.5' - (1 row) - ``` - - If command similar to the following exists, the given value will be escaped. - - ``` - postgres=# SELECT quote_literal(E'O\'42.5'); - quote_literal - --------------- - '0''42.5' - (1 row) - ``` - - If command similar to the following exists, backslash will be properly doubled. - - ``` - postgres=# SELECT quote_literal('O\42.5'); - quote_literal - --------------- - E'O\\42.5' - (1 row) - ``` - -- quote\_nullable\(string text\) - - Description: Returns the given string suitably quoted to be used as a string literal in an SQL statement string \(quotation marks are used as required\). - - Return type: text - - Example: - - ``` - postgres=# SELECT quote_nullable('hello'); - quote_nullable - ---------------- - 'hello' - (1 row) - ``` - - If command similar to the following exists, text will be escaped. - - ``` - postgres=# SELECT quote_nullable(E'O\'hello'); - quote_nullable - ---------------- - 'O''hello' - (1 row) - ``` - - If command similar to the following exists, backslash will be properly doubled. - - ``` - postgres=# SELECT quote_nullable('O\hello'); - quote_nullable - ---------------- - E'O\\hello' - (1 row) - ``` - - If the parameter is null, return **NULL**. - - ``` - postgres=# SELECT quote_nullable(NULL); - quote_nullable - ---------------- - NULL - (1 row) - ``` - -- quote\_nullable\(value anyelement\) - - Description: Converts the given value to text and then quotes it as a literal. - - Return type: text - - Example: - - ``` - postgres=# SELECT quote_nullable(42.5); - quote_nullable - ---------------- - '42.5' - (1 row) - ``` - - If command similar to the following exists, the given value will be escaped. - - ``` - postgres=# SELECT quote_nullable(E'O\'42.5'); - quote_nullable - ---------------- - 'O''42.5' - (1 row) - ``` - - If command similar to the following exists, backslash will be properly doubled. - - ``` - postgres=# SELECT quote_nullable('O\42.5'); - quote_nullable - ---------------- - E'O\\42.5' - (1 row) - ``` - - If the parameter is null, return **NULL**. - - ``` - postgres=# SELECT quote_nullable(NULL); - quote_nullable - ---------------- - NULL - (1 row) - ``` - -- substring\(string \[from int\] \[for int\]\) - - Description: Extracts a substring. **from int** indicates the start position of the truncation. **for int** indicates the number of characters truncated. - - Return type: text - - Example: - - ``` - postgres=# SELECT substring('Thomas' from 2 for 3); - substring - ----------- - hom - (1 row) - ``` - -- substring\(string from _pattern_\) - - Description: Extracts substring matching POSIX regular expression. It returns the text that matches the pattern. If no match record is found, a null value is returned. - - Return type: text - - Example: - - ``` - postgres=# SELECT substring('Thomas' from '...$'); - substring - ----------- - mas - (1 row) - postgres=# SELECT substring('foobar' from 'o(.)b'); - result - -------- - o - (1 row) - postgres=# SELECT substring('foobar' from '(o(.)b)'); - result - -------- - oob - (1 row) - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >If the POSIX pattern contains any parentheses, the portion of the text that matched the first parenthesized sub-expression \(the one whose left parenthesis comes first\) is returned. You can put parentheses around the whole expression if you want to use parentheses within it without triggering this exception. - -- substring\(string from _pattern_ for _escape_\) - - Description: Extracts substring matching SQL regular expression. The declared schema must match the entire data string; otherwise, the function fails and returns a null value. To indicate the part of the pattern that should be returned on success, the pattern must contain two occurrences of the escape character followed by a double quote \("\). The text matching the portion of the pattern between these markers is returned. - - Return type: text - - Example: - - ``` - postgres=# SELECT substring('Thomas' from '%#"o_a#"_' for '#'); - substring - ----------- - oma - (1 row) - ``` - -- rawcat\(raw,raw\) - - Description: Indicates the string concatenation functions. - - Return type: raw - - Example: - - ``` - postgres=# SELECT rawcat('ab','cd'); - rawcat - -------- - ABCD - (1 row) - ``` - -- regexp\_like\(text,text,text\) - - Description: Indicates the mode matching function of a regular expression. - - Return type: bool - - Example: - - ``` - postgres=# SELECT regexp_like('str','[ac]'); - regexp_like - ------------- - f - (1 row) - ``` - -- regexp\_substr\(text,text\) - - Description: Extracts substrings from a regular expression. Its function is similar to **substr**. When a regular expression contains multiple parallel brackets, it also needs to be processed. - - Return type: text - - Example: - - ``` - postgres=# SELECT regexp_substr('str','[ac]'); - regexp_substr - --------------- - - (1 row) - ``` - -- regexp\_matches\(string text, pattern text \[, flags text\]\) - - Description: Returns all captured substrings resulting from matching a POSIX regular expression against the **string**. If the pattern does not match, the function returns no rows. If the pattern contains no parenthesized sub-expressions, then each row returned is a single-element text array containing the substring matching the whole pattern. If the pattern contains parenthesized sub-expressions, the function returns a text array whose _n_th element is the substring matching the _n_th parenthesized sub-expression of the pattern. - - The optional **flags** argument contains zero or multiple single-letter flags that change function behavior. **i** indicates that the matching is not related to uppercase and lowercase. **g** indicates that each matching substring is replaced, instead of replacing only the first one. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >If the last parameter is provided but the parameter value is an empty string \(''\) and the SQL compatibility mode of the database is set to ORA, the returned result is an empty set. This is because the ORA compatible mode treats the empty string \(''\) as **NULL**. To resolve this problem, you can: - >- Change the database SQL compatibility mode to TD. - >- Do not provide the last parameter or do not set the last parameter to an empty string. - - Return type: setof text\[\] - - Example: - - ``` - postgres=# SELECT regexp_matches('foobarbequebaz', '(bar)(beque)'); - regexp_matches - ---------------- - {bar,beque} - (1 row) - postgres=# SELECT regexp_matches('foobarbequebaz', 'barbeque'); - regexp_matches - ---------------- - {barbeque} - (1 row) - postgres=# SELECT regexp_matches('foobarbequebazilbarfbonk', '(b[^b]+)(b[^b]+)', 'g'); - result - -------------- - {bar,beque} - {bazil,barf} - (2 rows) - ``` - -- regexp\_split\_to\_array\(string text, pattern text \[, flags text \]\) - - Description: Splits **string** using a POSIX regular expression as the delimiter. The regexp\_split\_to\_array function behaves the same as regexp\_split\_to\_table, except that regexp\_split\_to\_array returns its result as an array of text. - - Return type: text\[\] - - Example: - - ``` - postgres=# SELECT regexp_split_to_array('hello world', E'\\s+'); - regexp_split_to_array - ----------------------- - {hello,world} - (1 row) - ``` - -- regexp\_split\_to\_table\(string text, pattern text \[, flags text\]\) - - Description: Splits **string** using a POSIX regular expression as the delimiter. If there is no match to the pattern, the function returns the string. If there is at least one match, for each match it returns the text from the end of the last match \(or the beginning of the string\) to the beginning of the match. When there are no more matches, it returns the text from the end of the last match to the end of the string. - - The **flags** parameter is a text string containing zero or more single-letter flags that change the function's behavior. **i** indicates that the matching is not related to uppercase and lowercase. **g** indicates that each matching substring is replaced, instead of replacing only the first one. - - Return type: setof text - - Example: - - ``` - postgres=# SELECT regexp_split_to_table('hello world', E'\\s+'); - regexp_split_to_table - ----------------------- - hello - world - (2 rows) - ``` - -- repeat\(string text, number int \) - - Description: Repeats **string** the specified number of times. - - Return type: text - - Example: - - ``` - postgres=# SELECT repeat('Pg', 4); - repeat - ---------- - PgPgPgPg - (1 row) - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The maximum size of memory allocated at a time cannot exceed 1 GB due to the memory allocation mechanism of the database. Therefore, the maximum value of **number** cannot exceed \(1 GB - **x**\)/**lengthb** \(**string**\) - 1. **x** indicates the header length, which is usually greater than 4 bytes. The value varies in different scenarios. - -- replace\(string text, from text, to text\) - - Description: Replaces all occurrences in **string** of substring **from** with substring **to**. - - Return type: text - - Example: - - ``` - postgres=# SELECT replace('abcdefabcdef', 'cd', 'XXX'); - replace - ---------------- - abXXXefabXXXef - (1 row) - ``` - - -- reverse\(str\) - - Description: Returns reversed string. - - Return type: text - - Example: - - ``` - postgres=# SELECT reverse('abcde'); - reverse - --------- - edcba - (1 row) - ``` - -- right\(str text, n int\) - - Description: Returns the last **n** characters in a string. When **n** is negative, return all but first **|n|** characters. - - Return type: text - - Example: - - ``` - postgres=# SELECT right('abcde', 2); - right - ------- - de - (1 row) - - postgres=# SELECT right('abcde', -2); - right - ------- - cde - (1 row) - ``` - -- rpad\(string text, length int \[, fill text\]\) - - Description: Fills up the string to length **length** by prepending the characters **fill** \(a space by default\). If the string is already longer than length then it is truncated. - - Return type: text - - Example: - - ``` - postgres=# SELECT rpad('hi', 5, 'xy'); - rpad - ------- - hixyx - (1 row) - ``` - -- rtrim\(string text \[, characters text\]\) - - Description: Removes the longest string containing only characters from characters \(a space by default\) from the end of string. - - Return type: text - - Example: - - ``` - postgres=# SELECT rtrim('trimxxxx', 'x'); - rtrim - ------- - trim - (1 row) - ``` - -- substrb\(text,int,int\) - - Description: Extracts a substring. The first **int **indicates the start position of the subtraction. The second **int** indicates the number of characters subtracted. - - Return type: text - - Example: - - ``` - postgres=# SELECT substrb('string',2,3); - substrb - --------- - tri - (1 row) - ``` - -- substrb\(text,int\) - - Description: Extracts a substring. **int** indicates the start position of the subtraction. - - Return type: text - - Example: - - ``` - postgres=# SELECT substrb('string',2); - substrb - --------- - tring - (1 row) - ``` - -- substr\(bytea,from,count\) - - Description: Extracts a substring from **bytea**. **from** specifies the position where the extraction starts. **count** specifies the length of the extracted substring. - - Return type: text - - Example: - - ``` - postgres=# SELECT substr('string',2,3); - substr - -------- - tri - (1 row) - ``` - -- string || string - - Description: Concatenates strings. - - Return type: text - - Example: - - ``` - postgres=# SELECT 'MPP'||'DB' AS RESULT; - result - -------- - MPPDB - (1 row) - ``` - -- string || non-string or non-string || string - - Description: Concatenates strings and non-strings. - - Return type: text - - Example: - - ``` - postgres=# SELECT 'Value: '||42 AS RESULT; - result - ----------- - Value: 42 - (1 row) - ``` - -- split\_part\(string text, delimiter text, field int\) - - Description: Splits **string** on **delimiter** and returns the **field**th column \(counting from text of the first appeared delimiter\). - - Return type: text - - Example: - - ``` - postgres=# SELECT split_part('abc~@~def~@~ghi', '~@~', 2); - split_part - ------------ - def - (1 row) - ``` - -- strpos\(string, substring\) - - Description: Specifies the position of a substring. It is the same as **position\(substring in string\)**. However, the parameter sequences of them are reversed. - - Return type: int - - Example: - - ``` - postgres=# SELECT strpos('source', 'rc'); - strpos - -------- - 4 - (1 row) - ``` - -- to\_hex\(number int or bigint\) - - Description: Converts number to a hexadecimal expression. - - Return type: text - - Example: - - ``` - postgres=# SELECT to_hex(2147483647); - to_hex - ---------- - 7fffffff - (1 row) - ``` - -- translate\(string text, from text, to text\) - - Description: Any character in **string** that matches a character in the **from** set is replaced by the corresponding character in the **to** set. If **from** is longer than **to**, extra characters occurred in **from** are removed. - - Return type: text - - Example: - - ``` - postgres=# SELECT translate('12345', '143', 'ax'); - translate - ----------- - a2x5 - (1 row) - ``` - - -- length\(string\) - - Description: Obtains the number of characters in a string. - - Return type: integer - - Example: - - ``` - postgres=# SELECT length('abcd'); - length - -------- - 4 - (1 row) - ``` - -- lengthb\(string\) - - Description: Obtains the number of characters in a string. The value depends on character sets \(GBK and UTF8\). - - Return type: integer - - Example: - - ``` - postgres=# SELECT lengthb('Chinese'); - lengthb - --------- - 7 - (1 row) - ``` - -- substr\(string,from\) - - Description: - - Extracts substrings from a string. - - **from** indicates the start position of the extraction. - - - If **from** starts at 0, the value **1** is used. - - If the value of **from** is positive, all characters from **from** to the end are extracted. - - If the value of **from** is negative, the last n characters in the string are extracted, in which n indicates the absolute value of **from**. - - Return type: varchar - - Example: - - If the value of **from** is positive: - - ``` - postgres=# SELECT substr('ABCDEF',2); - substr - -------- - BCDEF - (1 row) - ``` - - If the value of **from** is negative: - - ``` - postgres=# SELECT substr('ABCDEF',-2); - substr - -------- - EF - (1 row) - ``` - -- substr\(string,from,count\) - - Description: - - Extracts substrings from a string. - - **from** indicates the start position of the extraction. - - **count** indicates the length of the extracted sub-string. - - - If **from** starts at 0, the value **1** is used. - - If the value of **from** is positive, extract **count** characters starting from **from**. - - If the value of **from** is negative, extract the last **n** **count** characters in the string, in which **n** indicates the absolute value of **from**. - - If the value of **count** is smaller than **1**, **null** is returned. - - Return type: varchar - - Example: - - If the value of **from** is positive: - - ``` - postgres=# SELECT substr('ABCDEF',2,2); - substr - -------- - BC - (1 row) - ``` - - If the value of **from** is negative: - - ``` - postgres=# SELECT substr('ABCDEF',-3,2); - substr - -------- - DE - (1 row) - ``` - -- substrb\(string,from\) - - Description: The functionality of this function is the same as that of **SUBSTR\(string,from\)**. However, the calculation unit is byte. - - Return type: bytea - - Example: - - ``` - postgres=# SELECT substrb('ABCDEF',-2); - substrb - --------- - EF - (1 row) - ``` - -- substrb\(string,from,count\) - - Description: The functionality of this function is the same as that of **SUBSTR\(string,from,count\)**. However, the calculation unit is byte. - - Return type: bytea - - Example: - - ``` - postgres=# SELECT substrb('ABCDEF',2,2); - substrb - --------- - BC - (1 row) - ``` - -- trim\(\[leading |trailing |both\] \[characters\] from string\) - - Description: Removes the longest string containing only the characters \(a space by default\) from the start/end/both ends of the string. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT trim(BOTH 'x' FROM 'xTomxx'); - btrim - ------- - Tom - (1 row) - ``` - - ``` - postgres=# SELECT trim(LEADING 'x' FROM 'xTomxx'); - ltrim - ------- - Tomxx - (1 row) - ``` - - ``` - postgres=# SELECT trim(TRAILING 'x' FROM 'xTomxx'); - rtrim - ------- - xTom - (1 row) - ``` - -- rtrim\(string \[, characters\]\) - - Description: Removes the longest string containing only characters from characters \(a space by default\) from the end of string. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT rtrim('TRIMxxxx','x'); - rtrim - ------- - TRIM - (1 row) - ``` - -- ltrim\(string \[, characters\]\) - - Description: Removes the longest string containing only characters from characters \(a space by default\) from the start of string. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT ltrim('xxxxTRIM','x'); - ltrim - ------- - TRIM - (1 row) - ``` - -- upper\(string\) - - Description: Converts the string into the uppercase. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT upper('tom'); - upper - ------- - TOM - (1 row) - ``` - -- lower\(string\) - - Description: Converts the string into the lowercase. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT lower('TOM'); - lower - ------- - tom - (1 row) - ``` - -- rpad\(string varchar, length int \[, fill varchar\]\) - - Description: Fills up the string to length **length** by prepending the characters **fill** \(a space by default\). If the string is already longer than length then it is truncated. - - **length** in openGauss indicates the character length. One Chinese character is counted as one character. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT rpad('hi',5,'xyza'); - rpad - ------- - hixyz - (1 row) - ``` - - ``` - postgres=# SELECT rpad('hi',5,'abcdefg'); - rpad - ------- - hiabc - (1 row) - ``` - -- instr\(string,substring\[,position,occurrence\]\) - - Description: Queries and returns the value of the substring position that occurs the occurrence \(first by default\) times from the position \(1 by default\) in the string. - - - If the value of **position** is **0**, **0** is returned. - - If the value of position is negative, searches backwards from the last _n_th character in the string, in which _n_ indicates the absolute value of position. - - In this function, the calculation unit is character. One Chinese character is one character. - - Return type: integer - - Example: - - ``` - postgres=# SELECT instr('corporate floor','or', 3); - instr - ------- - 5 - (1 row) - ``` - - ``` - postgres=# SELECT instr('corporate floor','or',-3,2); - instr - ------- - 2 - (1 row) - ``` - -- initcap\(string\) - - Description: The first letter of each word in the string is converted into the uppercase and the other letters are converted into the lowercase. - - Return type: text - - Example: - - ``` - postgres=# SELECT initcap('hi THOMAS'); - initcap - ----------- - Hi Thomas - (1 row) - ``` - -- ascii\(string\) - - Description: Indicates the ASCII code of the first character in the string. - - Return type: integer - - Example: - - ``` - postgres=# SELECT ascii('xyz'); - ascii - ------- - 120 - (1 row) - ``` - -- replace\(string varchar, search\_string varchar, replacement\_string varchar\) - - Description: Replaces all **search-string** in the string with **replacement\_string**. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT replace('jack and jue','j','bl'); - replace - ---------------- - black and blue - (1 row) - ``` - -- lpad\(string varchar, length int\[, repeat\_string varchar\]\) - - Description: Adds a series of **repeat\_string** \(a space by default\) on the left of the string to generate a new string with the total length of n. - - If the length of the string is longer than the specified length, the function truncates the string and returns the substrings with the specified length. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT lpad('PAGE 1',15,'*.'); - lpad - ----------------- - *.*.*.*.*PAGE 1 - (1 row) - ``` - - ``` - postgres=# SELECT lpad('hello world',5,'abcd'); - lpad - ------- - hello - (1 row) - ``` - -- concat\(str1,str2\) - - Description: Connects str1 and str2 and returns the string. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT concat('Hello', ' World!'); - concat - -------------- - Hello World! - (1 row) - postgres=# SELECT concat('Hello', NULL); - concat - -------- - Hello - (1 row) - ``` - -- chr\(integer\) - - Description: Specifies the character of the ASCII code. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT chr(65); - chr - ----- - A - (1 row) - ``` - -- regexp\_substr\(source\_char, pattern\) - - Description: Extracts substrings from a regular expression. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT regexp_substr('500 Hello World, Redwood Shores, CA', ',[^,]+,') "REGEXPR_SUBSTR"; - REGEXPR_SUBSTR - ------------------- - , Redwood Shores, - (1 row) - ``` - -- regexp\_replace\(string, pattern, replacement \[,flags \]\) - - Description: Replaces substring matching POSIX regular expression. The source string is returned unchanged if there is no match to the pattern. If there is a match, the source string is returned with the replacement string substituted for the matching substring. - - The replacement string can contain \\n, where n is 1 through 9, to indicate that the source substring matching the _n_th parenthesized sub-expression of the pattern should be inserted, and it can contain \\& to indicate that the substring matching the entire pattern should be inserted. - - The optional **flags** argument contains zero or multiple single-letter flags that change function behavior. **i** indicates that the matching is not related to uppercase and lowercase. **g** indicates that each matching substring is replaced, instead of replacing only the first one. - - Return type: varchar - - Example: - - ``` - postgres=# SELECT regexp_replace('Thomas', '.[mN]a.', 'M'); - regexp_replace - ---------------- - ThM - (1 row) - postgres=# SELECT regexp_replace('foobarbaz','b(..)', E'X\\1Y', 'g') AS RESULT; - result - ------------- - fooXarYXazY - (1 row) - ``` - -- concat\_ws\(sep text, str"any" \[, str"any" \[, ...\] \]\) - - Description: The first parameter is used as the separator, which is associated with all following parameters. - - Return type: text - - Example: - - ``` - postgres=# SELECT concat_ws(',', 'ABCDE', 2, NULL, 22); - concat_ws - ------------ - ABCDE,2,22 - (1 row) - ``` - -- convert\(string bytea, src\_encoding name, dest\_encoding name\) - - Description: Converts the bytea string to **dest\_encoding**. **src\_encoding** specifies the source code encoding. The string must be valid in this encoding. - - Return type: bytea - - Example: - - ``` - postgres=# SELECT convert('text_in_utf8', 'UTF8', 'GBK'); - convert - ---------------------------- - \x746578745f696e5f75746638 - (1 row) - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >If the rule for converting between source to target encoding \(for example, GBK and LATIN1\) does not exist, the string is returned without conversion. See the **pg\_conversion** system catalog for details. - >Example: - >``` - >postgres=# show server_encoding; - > server_encoding - >----------------- - > LATIN1 - >(1 row) - >postgres=# SELECT convert_from('some text', 'GBK'); - > convert_from - >-------------- - > some text - >(1 row) - >db_latin1=# SELECT convert_to('some text', 'GBK'); - > convert_to - >---------------------- - > \x736f6d652074657874 - >(1 row) - >db_latin1=# SELECT convert('some text', 'GBK', 'LATIN1'); - > convert - >---------------------- - > \x736f6d652074657874 - >(1 row) - >``` - -- convert\_from\(string bytea, src\_encoding name\) - - Description: Converts the long bytea using the coding mode of the database. - - **src\_encoding** specifies the source code encoding. The string must be valid in this encoding. - - Return type: text - - Example: - - ``` - postgres=# SELECT convert_from('text_in_utf8', 'UTF8'); - convert_from - -------------- - text_in_utf8 - (1 row) - ``` - -- convert\_to\(string text, dest\_encoding name\) - - Description: Converts string to **dest\_encoding**. - - Return type: bytea - - Example: - - ``` - postgres=# SELECT convert_to('some text', 'UTF8'); - convert_to - ---------------------- - \x736f6d652074657874 - (1 row) - ``` - -- string \[NOT\] LIKE pattern \[ESCAPE escape-character\] - - Description: Pattern matching function - - If the pattern does not include a percentage sign \(%\) or an underscore \(\_\), this mode represents itself only. In this case, the behavior of LIKE is the same as the equal operator. The underscore \(\_\) in the pattern matches any single character while one percentage sign \(%\) matches no or multiple characters. - - To match with underscores \(\_\) or percent signs \(%\), corresponding characters in pattern must lead escape characters. The default escape character is a backward slash \(\\\) and can be specified using the **ESCAPE** clause. To match with escape characters, enter two escape characters. - - Return type: Boolean - - Example: - - ``` - postgres=# SELECT 'AA_BBCC' LIKE '%A@_B%' ESCAPE '@' AS RESULT; - result - -------- - t - (1 row) - ``` - - ``` - postgres=# SELECT 'AA_BBCC' LIKE '%A@_B%' AS RESULT; - result - -------- - f - (1 row) - ``` - - ``` - postgres=# SELECT 'AA@_BBCC' LIKE '%A@_B%' AS RESULT; - result - -------- - t - (1 row) - ``` - -- REGEXP\_LIKE\(source\_string, pattern \[, match\_parameter\]\) - - Description: Indicates the mode matching function of a regular expression. - - **source\_string** indicates the source string and **pattern** indicates the matching pattern of the regular expression. **match\_parameter** indicates the matching items and the values are as follows: - - - 'i': case-insensitive - - "c": case-sensitive - - "n": allowing the metacharacter "." in a regular expression to be matched with a linefeed. - - "m": allows **source\_string** to be regarded as multiple rows. - - If **match\_parameter** is ignored, **case-sensitive** is enabled by default, "." is not matched with a linefeed, and **source\_string** is regarded as a single row. - - Return type: Boolean - - Example: - - ``` - postgres=# SELECT regexp_like('ABC', '[A-Z]'); - regexp_like - ------------- - t - (1 row) - ``` - - ``` - postgres=# SELECT regexp_like('ABC', '[D-Z]'); - regexp_like - ------------- - f - (1 row) - ``` - - ``` - postgres=# SELECT regexp_like('ABC', '[a-z]','i'); - regexp_like - ------------- - t - (1 row) - ``` - -- format\(formatstr text \[, str"any" \[, ...\] \]\) - - Description: Formats a string. - - Return type: text - - Example: - - ``` - postgres=# SELECT format('Hello %s, %1$s', 'World'); - format - -------------------- - Hello World, World - (1 row) - ``` - -- md5\(string\) - - Description: Encrypts a string in MD5 mode and returns a value in hexadecimal form. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >MD5 is insecure and is not recommended. - - Return type: text - - Example: - - ``` - postgres=# SELECT md5('ABC'); - md5 - ---------------------------------- - 902fbdd2b1df0c4f70b4a5d23525e932 - (1 row) - ``` - -- decode\(string text, format text\) - - Description: Decodes binary data from textual representation. - - Return type: bytea - - Example: - - ``` - postgres=# SELECT decode('MTIzAAE=', 'base64'); - decode - -------------- - \x3132330001 - (1 row) - ``` - -- encode\(data bytea, format text\) - - Description: Encodes binary data into a textual representation. - - Return type: text - - Example: - - ``` - postgres=# SELECT encode(E'123\\000\\001', 'base64'); - encode - ---------- - MTIzAAE= - (1 row) - ``` - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- For a string containing newline characters, for example, a string consisting of a newline character and a space, the value of **length** and **lengthb** in openGauss is 2. ->- In openGauss, _n_ in the CHAR\(n\) type indicates the number of characters. Therefore, for multiple-octet coded character sets, the length returned by the LENGTHB function may be longer than n. ->- OpenGauss supports four types of databases: A, B, C, and PG. If the database type is not specified, the database type is A by default. The lexical analyzer of A is different from the other three types. In A, a null character string is regarded as NULL. Therefore, when the database of type A is used, if the preceding character operation function has an empter string as a parameter, no output is displayed.For example: -> -> ``` -> postgres=# SELECT translate('12345','123',''); -> translate -> ----------- -> -> (1 row) -> ``` -> -> This is because the kernel will determine whether the input parameter contains NULL before calling the corresponding function for processing. If so, the corresponding function will not be called, so there will be no output.In PG type, strings are handled in the same way as PostgresQL, so you won't have this problem。 - diff --git a/content/en/docs/installation/Developerguide/checking-blocked-statements.md b/content/en/docs/installation/Developerguide/checking-blocked-statements.md deleted file mode 100644 index e37c7c47ed13a595873b7de8cb81193c86b4ac80..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/checking-blocked-statements.md +++ /dev/null @@ -1,70 +0,0 @@ -# Checking Blocked Statements - -During database running, query statements are blocked in some service scenarios and run for an excessively long time. In this case, you can forcibly terminate the faulty session. - -## Procedure - -1. Log in as the OS user **omm** to a database node. -2. Run the following command to connect to the database: - - ``` - gsql -d postgres -p 8000 - ``` - - **postgres** is the name of the database to be connected, and **8000** is the port number of the database node. - - If information similar to the following is displayed, the connection succeeds: - - ``` - 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. - - postgres=# - ``` - -3. View blocked query statements and details about the tables and schemas that block the query statements. - - ``` - SELECT w.query as waiting_query, - w.pid as w_pid, - w.usename as w_user, - l.query as locking_query, - l.pid as l_pid, - l.usename as l_user, - t.schemaname || '.' || t.relname as tablename - from pg_stat_activity w join pg_locks l1 on w.pid = l1.pid - and not l1.granted join pg_locks l2 on l1.relation = l2.relation - and l2.granted join pg_stat_activity l on l2.pid = l.pid join pg_stat_user_tables t on l1.relation = t.relid - where w.waiting; - ``` - - The thread ID, user details, query status, as well as details about the tables and schemas that block the query statements are returned. - -4. Run the following command to terminate the required session, where **139834762094352** is the thread ID: - - ``` - SELECT PG_TERMINATE_BACKEND(139834762094352); - ``` - - If information similar to the following is displayed, the session is successfully terminated: - - ``` - PG_TERMINATE_BACKEND - ---------------------- - t - (1 row) - ``` - - If information similar to the following is displayed, a user is attempting to terminate the session, and the session will be reconnected rather than being terminated. - - ``` - FATAL: terminating connection due to administrator command - FATAL: terminating connection due to administrator command - The connection to the server was lost. Attempting reset: Succeeded. - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >If the **PG\_TERMINATE\_BACKEND** function is used to terminate the background threads of the session, the **gsql** client will be reconnected rather than be logged out. - - diff --git a/content/en/docs/installation/Developerguide/checking-the-number-of-database-connections.md b/content/en/docs/installation/Developerguide/checking-the-number-of-database-connections.md deleted file mode 100644 index 7de6a4e709d7a3ff2cd72de2c805aaa7614cdd74..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/checking-the-number-of-database-connections.md +++ /dev/null @@ -1,135 +0,0 @@ -# Checking the Number of Database Connections - -## Background - -If the number of connections reaches its upper limit, new connections cannot be created. Therefore, if a user fails to connect a database, the administrator must check whether the number of connections has reached the upper limit. The following are details about database connections: - -- The maximum number of global connections is specified by the **max\_connections** parameter. Its default value is **5000**. -- The number of a user's connections is specified by **CONNECTION LIMIT connlimit** in the **CREATE ROLE** statement and can be changed using **CONNECTION LIMIT connlimit** in the **ALTER ROLE** statement. -- The number of a database's connections is specified by the **CONNECTION LIMIT connlimit** parameter in the **CREATE DATABASE** statement. - -## Procedure - -1. Log in as the OS user **omm** to the primary node of the database. - -2. Run the following command to connect to the database: - - ``` - gsql -d postgres -p 8000 - ``` - - **postgres** is the name of the database to be connected, and **8000** is the port number of the database primary node. - - If information similar to the following is displayed, the connection succeeds: - - ``` - 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. - - postgres=# - ``` - -3. View the upper limit of the number of global connections. - - ``` - postgres=# SHOW max_connections; - max_connections - ----------------- - 800 - (1 row) - ``` - - **800** is the maximum number of session connections. - -4. View the number of connections that have been used. - - For details, see [Table 1](#en-us_topic_0237121094_en-us_topic_0059779140_t608a1965463e41f1b6eacd02f97a65ba). - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >Except for database and usernames that are enclosed in double quotation marks \("\) during creation, uppercase letters are not allowed in the database and usernames in the commands in the following table. - - **Table 1** Viewing the number of session connections - - - - - - - - - - - - - - - - - - - - - - -

Description

-

Command

-

View the maximum number of sessions connected to a specific user.

-

Run the following commands to view the upper limit of the number of omm's session connections. -1 indicates that no upper limit is set for the number of omm's session connections.

- 
postgres=# SELECT ROLNAME,ROLCONNLIMIT FROM PG_ROLES WHERE ROLNAME='omm';
-     rolname  | rolconnlimit
-    ----------+--------------
-     omm |          -1
-    (1 row)
-

View the number of session connections that have been used by a user.

-

Run the following commands to view the number of session connections that have been used by omm. 1 indicates the number of session connections that have been used by omm.

- 
postgres=# CREATE OR REPLACE VIEW DV_SESSIONS AS
-    	       SELECT
-    		    sa.sessionid AS SID,
-    		    0::integer AS SERIAL#,
-    		    sa.usesysid AS USER#,
-    		    ad.rolname AS USERNAME
-    	        FROM pg_stat_get_activity(NULL) AS sa
-    	        LEFT JOIN pg_authid ad ON(sa.usesysid = ad.oid)
-    	        WHERE sa.application_name <> 'JobScheduler';
-    postgres=# SELECT COUNT(*) FROM DV_SESSIONS WHERE USERNAME='omm'; 
-    count
-    -------
-    1
-    (1 row)
-

View the maximum number of sessions connected to a specific database.

-

Run the following commands to view the upper limit of the number of postgres's session connections. -1 indicates that no upper limit is set for the number of postgres's session connections.

- 
postgres=# SELECT DATNAME,DATCONNLIMIT FROM PG_DATABASE WHERE DATNAME='postgres'; 
-    datname  | datconnlimit
-    ----------+--------------
-     postgres |           -1
-    (1 row)
-

View the number of session connections that have been used by a specific database.

-

Run the following commands to view the number of session connections that have been used by postgres. 1 indicates the number of session connections that have been used by postgres.

- 
postgres=# SELECT COUNT(*) FROM PG_STAT_ACTIVITY WHERE DATNAME='postgres'; 
-    count
-    --------
-    1
-    (1 row)
-

View the number of session connections that have been used by all users.

-

Run the following commands to view the number of session connections that have been used by all users:

- 
postgres=# CREATE OR REPLACE VIEW DV_SESSIONS AS
-    	       SELECT
-    		    sa.sessionid AS SID,
-    		    0::integer AS SERIAL#,
-    		    sa.usesysid AS USER#,
-    		    ad.rolname AS USERNAME
-    	        FROM pg_stat_get_activity(NULL) AS sa
-    	        LEFT JOIN pg_authid ad ON(sa.usesysid = ad.oid)
-    	        WHERE sa.application_name <> 'JobScheduler';
-    postgres=# SELECT COUNT(*) FROM DV_SESSIONS; 
-    count
-    -------
-    10
-    (1 row)
-
-
- - - - diff --git a/content/en/docs/installation/Developerguide/checkpoint-22.md b/content/en/docs/installation/Developerguide/checkpoint-22.md deleted file mode 100644 index 95d05edd3aa6f551ed823df8e82aebb2a962dde8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/checkpoint-22.md +++ /dev/null @@ -1,30 +0,0 @@ -# Checkpoint - -ELI–OK - -In openGauss/GaussDB the Checkpoints are points in the sequence of transactions at which it is guaranteed that the heap and index data files have been updated with all information written before the checkpoint. - -At checkpoint time, all dirty data pages are flushed to disk and a special checkpoint record is written to the log file. - -The MOT does not store its data like openGauss/GaussDB does and there is no dirty pages concept. The data is stored directly in memory. - -For this reason we have researched and implemented the CALC algorithm described in the paper Low-Overhead Asynchronous Checkpointing in Main-Memory Database Systems, SIGMOND 2016 from Yale University. - -Reference to footnote: - -K. Ren, T. Diamond, D. J. Abadi, and A. Thomson. Low-overhead asynchronous checkpointing in main-memory database systems. In Proceedings of the 2016 ACM SIGMOD International Conference on Management of Data, 2016. - -## CALC Checkpoint algorithm: low overhead in memory and compute - -The checkpoint algorithm provides the following benefits – - -- Reduced memory usage: At most two copies of each record are stored at any time. Memory usage is minimized by only storing one physical copy of a record when its live and stable versions are equal or when no checkpoint is actively being recorded. -- Low overhead. CALC's overhead is smaller than other asynchronous checkpointing algorithms. -- Uses virtual points of consistency. CALC does not require quiescing of the database in order to achieve a physical point of consistency. - -How to activate manually the checkpoint? - -MOT checkpoints are integrated into the envelope’s checkpoint mechanism. The process can be triggered manually by executing “**CHECKPOINT;**” command or by automatically considering the envelope’s triggering settings \(time/size\). - -Checkpoint configuration is done in the mot.conf file – see the relevant [Default MOT.conf](default-mot-conf.md#EN-US_TOPIC_0257867375). - diff --git a/content/en/docs/installation/Developerguide/checkpoint-32.md b/content/en/docs/installation/Developerguide/checkpoint-32.md deleted file mode 100644 index 1322fb1a8b4b5eebabf872dfb5667a6c0bac5dad..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/checkpoint-32.md +++ /dev/null @@ -1,30 +0,0 @@ -# CHECKPOINT - -## Function - -A checkpoint is a point in the transaction log sequence at which all data files have been updated to reflect the information in the log. All data files will be flushed to a disk. - -**CHECKPOINT** forces a transaction log checkpoint. By default, WALs periodically specify checkpoints in a transaction log. You may use **gs\_guc** to specify run-time parameters **checkpoint\_segments** and **checkpoint\_timeout** to adjust the atomized checkpoint intervals. - -## Precautions - -- Only a system administrator has the permission to call **CHECKPOINT**. -- **CHECKPOINT** forces an immediate checkpoint when the related command is issued, without waiting for a regular checkpoint scheduled by the system. - -## Syntax - -``` -CHECKPOINT; -``` - -## Parameter Description - -None - -## Examples - -``` --- Set a checkpoint. -postgres=# CHECKPOINT; -``` - diff --git a/content/en/docs/installation/Developerguide/checkpoints-41.md b/content/en/docs/installation/Developerguide/checkpoints-41.md deleted file mode 100644 index b4ed6e8d0c18156401e007b2b22b60a2488632d2..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/checkpoints-41.md +++ /dev/null @@ -1,116 +0,0 @@ -# Checkpoints - -## checkpoint\_segments - -**Parameter description**: Specifies the minimum number of WAL segment files in the period specified by **[checkpoint\_timeout](#en-us_topic_0237124708_en-us_topic_0059778936_s880baa9f9b594980afbbe95fb8a77182)**. The size of each log file is 16 MB. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer. The minimum value is **1**. - -Increasing the value of this parameter speeds up the export of a large amount of data. Set this parameter based on **[checkpoint\_timeout](#en-us_topic_0237124708_en-us_topic_0059778936_s880baa9f9b594980afbbe95fb8a77182)** and **[shared\_buffers](memory-40.md#en-us_topic_0237124699_en-us_topic_0059777577_s55a43fb6d0464430a59031671b37cd07)**. This parameter affects the number of WAL segment files that can be reused. Generally, the maximum number of reused files in the **pg\_xlog** folder is twice the number of **checkpoint\_segments**. The reused files are not deleted and are renamed to the WAL segment files which will be later used. - -**Default value**: **64** - -## checkpoint\_timeout - -**Parameter description**: Specifies the maximum time between automatic WAL checkpoints. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range:** an integer ranging from 30 to 3600. The unit is second. - -If the value of **[checkpoint\_segments](#en-us_topic_0237124708_en-us_topic_0059778936_sbadc77895e6643b882a5e7557e405373)** is increased, you need to increase the value of this parameter. The increase of these two parameters further requires the increase of **[shared\_buffers](memory-40.md#en-us_topic_0237124699_en-us_topic_0059777577_s55a43fb6d0464430a59031671b37cd07)**. Consider all these parameters during setting. - -**Default value**: **15min** - -## checkpoint\_completion\_target - -**Parameter description**: Specifies the completion target of each checkpoint, as a fraction of total time between checkpoints. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a floating point number ranging from 0.0 to 1.0 - -**Default value**: **0.5** - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->**0.5** indicates that each checkpoint should be complete within 50% of the interval between checkpoints. - -## checkpoint\_warning - -**Parameter description**: Specifies a time in seconds. If the checkpoint interval is close to this time due to filling of checkpoint segment files, a message is sent to the server log to suggest an increase in the **[checkpoint\_segments](#en-us_topic_0237124708_en-us_topic_0059778936_sbadc77895e6643b882a5e7557e405373)** value. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to _INT\_MAX_. The unit is second. **0** indicates that the warning is disabled. - -**Default value**: **5min** - -**Recommended value**: **5min** - -## checkpoint\_wait\_timeout - -**Parameter description**: Sets the longest time that the checkpoint waits for the checkpointer thread to start. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 2 to 3600. The unit is second. - -**Default value**: **1min** - -## enable\_incremental\_checkpoint - -**Parameter description**: Specifies whether to enable incremental checkpointing. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -**Default value**: **on** - -## enable\_double\_write - -**Parameter description**: Specifies whether to enable the doublewrite buffer. When the incremental checkpointing is enabled, the doublewrite buffer instead of **full\_page\_writes** is used to prevent partial page writes. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -**Default value**: **on** - -## incremental\_checkpoint\_timeout - -**Parameter description**: Specifies the maximum interval between automatic WAL checkpoints when the incremental checkpointing is enabled. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range:** an integer ranging from 1 to 3600. The unit is second. - -**Default value**: **1min** - -## enable\_xlog\_prune - -**Parameter description**: Specifies whether the primary server reclaims logs when any standby server is disconnected. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -+ When set to on, the host will not reclaim logs when any of the standby machines is disconnected. -+ When set to off, the host will reclaim the log when any of the standby machines is disconnected. - -**Default value**: **on** - - - -## max_redo_log_size - -**Parameter description**: Specifies the size of logs before the recovery point and the current log location. You are advised not to set this parameter to a large value if the RTO is concerned. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 163840 to 2147483647. The unit is KB. - -**Default value**: **1GB** - diff --git a/content/en/docs/installation/Developerguide/class_vital_info.md b/content/en/docs/installation/Developerguide/class_vital_info.md deleted file mode 100644 index a3a254976028d43e812282cb54d3fcdb37d44e8d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/class_vital_info.md +++ /dev/null @@ -1,47 +0,0 @@ -# CLASS\_VITAL\_INFO - -**CLASS\_VITAL\_INFO** is used to check whether the OIDs of the same table or index are consistent for WDR snapshots. - -**Table 1** CLASS\_VITAL\_INFO columns - - - - - - - - - - - - - - - - - - - - - - - - -

Name

-

Type

-

Description

-

relid

-

oid

-

Table OID

-

schemaname

-

name

-

Schema name

-

relname

-

name

-

Table name

-

relkind

-

"char"

-
Object type. Its value can be:
  • r: ordinary table
  • t: TOAST table
  • i: index
-
-
- diff --git a/content/en/docs/installation/Developerguide/client-access-authentication.md b/content/en/docs/installation/Developerguide/client-access-authentication.md deleted file mode 100644 index 3a56f3585040703dde56cf6a5b3cbb9ba1b6c0e8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/client-access-authentication.md +++ /dev/null @@ -1,15 +0,0 @@ -# Client Access Authentication - -- **[Configuring Client Access Authentication](configuring-client-access-authentication.md)** - -- **[Configuration File Reference](configuration-file-reference.md)** - -- **[Establishing Secure TCP/IP Connections in SSL Mode](establishing-secure-tcp-ip-connections-in-ssl-mode.md)** - -- **[Establishing Secure TCP/IP Connections in SSH Tunnel Mode](establishing-secure-tcp-ip-connections-in-ssh-tunnel-mode.md)** - -- **[Checking the Number of Database Connections](checking-the-number-of-database-connections.md)** - -- **[Managing SSL Certificates](managing-ssl-certificates.md)** - - diff --git a/content/en/docs/installation/Developerguide/close.md b/content/en/docs/installation/Developerguide/close.md deleted file mode 100644 index 39f1ff6fe4e0e1bb96bf75c3b33e6b3db33c8df0..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/close.md +++ /dev/null @@ -1,40 +0,0 @@ -# CLOSE - -## Function - -**CLOSE** frees the resources associated with an open cursor. - -## Precautions - -- After a cursor is closed, no subsequent operations are allowed on it. -- A cursor should be closed when it is no longer needed. -- Every non-holdable open cursor is implicitly closed when a transaction is terminated by **COMMIT** or **ROLLBACK**. -- A holdable cursor is implicitly closed if the transaction that created it aborts by **ROLLBACK**. -- If the cursor creation transaction is successfully committed, the holdable cursor remains open until an explicit **CLOSE** operation is executed, or the client disconnects. -- openGauss does not have an explicit **OPEN** cursor statement. A cursor is considered open when it is declared. You can view all available cursors by querying the **pg\_cursors** system view. - -## Syntax - -``` -CLOSE { cursor_name | ALL } ; -``` - -## Parameter Description - -- **cursor\_name** - - Specifies the name of a cursor to be closed. - -- **ALL** - - Closes all open cursors. - - -## Examples - -See [Examples](fetch.md#en-us_topic_0237122165_en-us_topic_0059778422_s1ee72832a27547e4949061a010e24578) in **FETCH**. - -## Helpful Links - -[FETCH](fetch.md) and [MOVE](move.md) - diff --git a/content/en/docs/installation/Developerguide/closing-a-connection.md b/content/en/docs/installation/Developerguide/closing-a-connection.md deleted file mode 100644 index 5b4ec92c535ed981a60c1c412214307ef6953d8e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/closing-a-connection.md +++ /dev/null @@ -1,6 +0,0 @@ -# Closing a Connection - -After you complete required data operations in the database, close the database connection. - -Call the close method to close the connection, for example, **Connection conn = null; conn.close\(\)**. - diff --git a/content/en/docs/installation/Developerguide/cluster.md b/content/en/docs/installation/Developerguide/cluster.md deleted file mode 100644 index ec33da096c533df9a0c2b07d4dcadc08cf9cf748..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cluster.md +++ /dev/null @@ -1,124 +0,0 @@ -# CLUSTER - -## Function - -**CLUSTER** is used to cluster a table based on an index. - -**CLUSTER** instructs openGauss to cluster the table specified by **table\_name** based on the index specified by **index\_name**. The index must have been defined by **table\_name**. - -When a table is clustered, it is physically reordered based on the index information. Clustering is a one-time operation. When the table is subsequently updated, the changes are not clustered. That is, no attempt is made to store new or updated rows according to their index order. - -When a table is clustered, openGauss records which index the table was clustered by. The form **CLUSTER table\_name** reclusters the table using the same index as before. You can also use the **CLUSTER** or **SET WITHOUT CLUSTER** form of **ALTER TABLE** to set the index to be used for future cluster operations, or to clear any previous settings. - -**CLUSTER** without any parameter reclusters all the previously-clustered tables in the current database that the calling user owns, or all such tables if called by an administrator. - -When a table is being clustered, an **ACCESS EXCLUSIVE** lock is acquired on it. This prevents any other database operations \(both read and write\) from being performed on the table until the **CLUSTER** is finished. - -## Precautions - -Only row-store B-tree indexes support **CLUSTER**. - -In the case where you are accessing single rows randomly within a table, the actual order of the data in the table is unimportant. However, if you tend to access some data more than others, and there is an index that groups them together, it is helpful by using **CLUSTER**. If you are requesting a range of indexed values from a table, or a single indexed value that has multiple rows that match, **CLUSTER** will help because once the index identifies the table page for the first row that matches, all other rows that match are probably already on the same table page, and so you save disk accesses and speed up the query. - -When an index scan is used, a temporary copy of the table is created that contains the table data in the index order. Temporary copies of each index on the table are created as well. Therefore, you need free space on disk at least equal to the sum of the table size and the total index size. - -Because **CLUSTER** remembers which indexes are clustered, one can cluster the tables manually the first time, then set up a time like **VACUUM** without any parameters, so that the desired tables are periodically reclustered. - -Because the optimizer records statistics about the ordering of tables, it is advisable to run **ANALYZE** on the newly clustered table. Otherwise, the optimizer might make poor choices of query plans. - -**CLUSTER** cannot be executed in transactions. - -## Syntax - -- Cluster a table. - - ``` - CLUSTER [ VERBOSE ] table_name [ USING index_name ]; - ``` - -- Cluster a partition. - - ``` - CLUSTER [ VERBOSE ] table_name PARTITION ( partition_name ) [ USING index_name ]; - ``` - -- Recluster a table. - - ``` - CLUSTER [ VERBOSE ]; - ``` - - -## Parameter Description - -- **VERBOSE** - - Enables the display of progress messages. - -- **table\_name** - - Specifies the table name. - - Value range: an existing table name - -- **index\_name** - - Specifies the index name. - - Value range: an existing index name - -- **partition\_name** - - Specifies the partition name. - - Value range: an existing partition name - - -## Examples - -``` --- Create a partitioned table. -postgres=# CREATE TABLE tpcds.inventory_p1 -( - INV_DATE_SK INTEGER NOT NULL, - INV_ITEM_SK INTEGER NOT NULL, - INV_WAREHOUSE_SK INTEGER NOT NULL, - INV_QUANTITY_ON_HAND INTEGER -) -PARTITION BY RANGE(INV_DATE_SK) -( - PARTITION P1 VALUES LESS THAN(2451179), - PARTITION P2 VALUES LESS THAN(2451544), - PARTITION P3 VALUES LESS THAN(2451910), - PARTITION P4 VALUES LESS THAN(2452275), - PARTITION P5 VALUES LESS THAN(2452640), - PARTITION P6 VALUES LESS THAN(2453005), - PARTITION P7 VALUES LESS THAN(MAXVALUE) -); - --- Create an index named ds_inventory_p1_index1. -postgres=# CREATE INDEX ds_inventory_p1_index1 ON tpcds.inventory_p1 (INV_ITEM_SK) LOCAL; - --- Cluster the tpcds.inventory_p1 table. -postgres=# CLUSTER tpcds.inventory_p1 USING ds_inventory_p1_index1; - --- Cluster the p3 partition. -postgres=# CLUSTER tpcds.inventory_p1 PARTITION (p3) USING ds_inventory_p1_index1; - --- Cluster the tables that can be clustered in the database. -postgres=# CLUSTER; - --- Delete the index. -postgres=# DROP INDEX tpcds.ds_inventory_p1_index1; - --- Drop the partitioned table. -postgres=# DROP TABLE tpcds.inventory_p1; -``` - -## Suggestions - -- cluster - - It is recommended that you run **ANALYZE** on a newly clustered table. Otherwise, the optimizer might make poor choices of query plans. - - **CLUSTER** cannot be executed in transactions. - - diff --git a/content/en/docs/installation/Developerguide/command-reference-13.md b/content/en/docs/installation/Developerguide/command-reference-13.md deleted file mode 100644 index d2f1f737c6f752c970c4550bde6506cd796f1334..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/command-reference-13.md +++ /dev/null @@ -1,44 +0,0 @@ -# Command Reference - -**Table 1** Common parameters - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Value Range

-

--train

-

Specifies the path of historical logs used for training.

-

-

-

--model

-

Indicates the path for storing the model and intermediate file generated during training and the model path specified during prediction.

-

-

-

--predict

-

Specifies the path of the load file to be predicted.

-

-

-

--ratio

-

Specifies the recommended retraining threshold ratio. This parameter is optional.

-

-

-
- diff --git a/content/en/docs/installation/Developerguide/command-reference.md b/content/en/docs/installation/Developerguide/command-reference.md deleted file mode 100644 index 2db25e908903524c02c500e73a14a2ffec728587..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/command-reference.md +++ /dev/null @@ -1,100 +0,0 @@ -# Command Reference - -**Table 1** Common parameters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Value Range

-

--mode, -m

-

Specifies the running mode of the tuning program.

-

train, tune

-

--config-file, -f

-

Specifies the configuration file of the tuning program. This parameter is optional.

-

-

-

--db-name

-

Specifies the database to be tuned.

-

-

-

--db-user

-

Specifies the username of the database to be tuned.

-

-

-

--port

-

Specifies the database listening port.

-

-

-

--host

-

Specifies host IP address of the database instance.

-

-

-

--host-user

-

Specifies the username of the database administrator during database installation.

-

-

-

--host-ssh-port

-

Specifies the SSH port number of the host where the database instance is located. This parameter is optional.

-

-

-

--scenario

-

Specifies the tuning mode, which corresponds to three tuning lists. You can modify the lists.

-

ap, htap, tp

-

--benchmark

-

Specifies the name of the benchmark script file.

-

-

-

--model-path

-

Specifies the path for storing or loading tuning (enhanced learning) models.

-

-

-

--version, -v

-

Returns the current tool version.

-

-

-
- diff --git a/content/en/docs/installation/Developerguide/comment.md b/content/en/docs/installation/Developerguide/comment.md deleted file mode 100644 index 6756b1a5b3267f306b45b2e751fc2c099a2f913e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/comment.md +++ /dev/null @@ -1,149 +0,0 @@ -# COMMENT - -## Function - -**COMMENT** defines or changes the comment of an object. - -## Precautions - -- Each object stores only one comment. Therefore, you need to modify a comment and issue a new **COMMENT** command to the same object. To delete the comment, write **NULL** at the position of the text string. When an object is deleted, the comment is automatically deleted. -- Currently, there is no security protection for viewing comments. Any user connected to a database can view all the comments for objects in the database. For shared objects such as databases, roles, and tablespaces, comments are stored globally so any user connected to any database in the cluster can see all the comments for shared objects. Therefore, do not put security-critical information in comments. -- For most objects, only the owner of the object can set comments. Roles do not have owners, so the rule for **COMMENT ON ROLE** is that you must be an administrator to comment on an administrator role, or have the **CREATEROLE** permission to comment on non-administrator roles. A system administrator can comment on all objects. - -## Syntax - -``` -COMMENT ON -{ - AGGREGATE agg_name (agg_type [, ...] ) | - CAST (source_type AS target_type) | - COLLATION object_name | - COLUMN { table_name.column_name | view_name.column_name } | - CONSTRAINT constraint_name ON table_name | - CONVERSION object_name | - DATABASE object_name | - DOMAIN object_name | - EXTENSION object_name | - FOREIGN DATA WRAPPER object_name | - FOREIGN TABLE object_name | - FUNCTION function_name ( [ {[ argmode ] [ argname ] argtype} [, ...] ] ) | - INDEX object_name | - LARGE OBJECT large_object_oid | - OPERATOR operator_name (left_type, right_type) | - OPERATOR CLASS object_name USING index_method | - OPERATOR FAMILY object_name USING index_method | - [ PROCEDURAL ] LANGUAGE object_name | - ROLE object_name | - SCHEMA object_name | - SERVER object_name | - TABLE object_name | - TABLESPACE object_name | - TEXT SEARCH CONFIGURATION object_name | - TEXT SEARCH DICTIONARY object_name | - TEXT SEARCH PARSER object_name | - TEXT SEARCH TEMPLATE object_name | - TYPE object_name | - VIEW object_name | - TRIGGER trigger_name ON table_name -} - IS 'text'; -``` - -## Parameter Description - -- **agg\_name** - - Specifies the new name of an aggregation function. - -- **agg\_type** - - Specifies the data type of the aggregation function parameters. - -- **source\_type** - - Specifies the source data type of the cast. - -- **target\_type** - - Specifies the target data type of the cast. - -- **object\_name** - - Specifies the name of an object. - -- **table\_name.column\_name** - - **view\_name.column\_name** - - Specifies the column whose comment is defined or modified. You can add the table name or view name as the prefix. - -- **constraint\_name** - - Specifies the table constraint whose comment is defined or modified. - -- **table\_name** - - Specifies the name of a table. - -- **function\_name** - - Specifies the function whose comment is defined or modified. - -- **argmode,argname,argtype** - - Specifies the schema, name, and type of the function parameters. - -- **large\_object\_oid** - - Specifies the OID of the large object whose comment is defined or modified. - -- **operator\_name** - - Specifies the name of the operator. - -- **left\_type,right\_type** - - Specifies the data type of the operator parameters \(optionally schema-qualified\). If the prefix or suffix operator does not exist, the **NONE** option can be added. - -- **text** - - Specifies the comment content. - - -## Examples - -``` -postgres=# CREATE TABLE tpcds.customer_demographics_t2 -( - CD_DEMO_SK INTEGER NOT NULL, - CD_GENDER CHAR(1) , - CD_MARITAL_STATUS CHAR(1) , - CD_EDUCATION_STATUS CHAR(20) , - CD_PURCHASE_ESTIMATE INTEGER , - CD_CREDIT_RATING CHAR(10) , - CD_DEP_COUNT INTEGER , - CD_DEP_EMPLOYED_COUNT INTEGER , - CD_DEP_COLLEGE_COUNT INTEGER -) -WITH (ORIENTATION = COLUMN,COMPRESSION=MIDDLE) -; - --- Comment out the tpcds.customer_demographics_t2.cd_demo_sk column. -postgres=# COMMENT ON COLUMN tpcds.customer_demographics_t2.cd_demo_sk IS 'Primary key of customer demographics table.'; - --- Create a view consisting of rows with c_customer_sk less than 150. -postgres=# CREATE VIEW tpcds.customer_details_view_v2 AS - SELECT * - FROM tpcds.customer - WHERE c_customer_sk < 150; - --- Comment out the tpcds.customer_details_view_v2 view. -postgres=# COMMENT ON VIEW tpcds.customer_details_view_v2 IS 'View of customer detail'; - --- Delete the view. -postgres=# DROP VIEW tpcds.customer_details_view_v2; - --- Delete the tpcds.customer_demographics_t2 table. -postgres=# DROP TABLE tpcds.customer_demographics_t2; -``` - diff --git a/content/en/docs/installation/Developerguide/commissioning.md b/content/en/docs/installation/Developerguide/commissioning.md deleted file mode 100644 index 572985913a87fef6a32bc762f7007e9a80b25a0c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/commissioning.md +++ /dev/null @@ -1,160 +0,0 @@ -# Commissioning - -To control the output of log files and better understand the operating status of the database, modify specific configuration parameters in the **postgresql.conf** file in the instance data directory. - -[Table 1](#en-us_topic_0237120444_en-us_topic_0059779333_tec23904511dd4695b8b01f8c7c04563a) describes the adjustable configuration parameters. - -**Table 1** Configuration parameters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Value Range

-

Remarks

-

client_min_messages

-

Level of messages to be sent to clients.

-
  • DEBUG5
  • DEBUG4
  • DEBUG3
  • DEBUG2
  • DEBUG1
  • LOG
  • NOTICE
  • WARNING
  • ERROR
  • FATAL
  • PANIC
-

Default value: NOTICE

-

Messages of the set level or lower will be sent to clients. The lower the level is, the fewer the messages will be sent.

-

log_min_messages

-

Level of messages to be recorded in server logs.

-
  • DEBUG5
  • DEBUG4
  • DEBUG3
  • DEBUG2
  • DEBUG1
  • INFO
  • NOTICE
  • WARNING
  • ERROR
  • LOG
  • FATAL
  • PANIC
-

Default value: WARNING

-

Messages higher than the set level will be recorded in logs. The higher the level is, the fewer the server logs will be recorded.

-

log_min_error_statement

-

Level of SQL error statements to be recorded in server logs.

-
  • DEBUG5
  • DEBUG4
  • DEBUG3
  • DEBUG2
  • DEBUG1
  • INFO
  • NOTICE
  • WARNING
  • ERROR
  • FATAL
  • PANIC
-

Default value: ERROR

-

SQL error statements of the set level or higher will be recorded in server logs.

-

Only a system administrator is allowed to modify this parameter.

-

log_min_duration_statement

-

Minimum execution duration of a statement. If the execution duration of a statement is equal to or longer than the set milliseconds, the statement and its duration will be recorded in logs. Enabling this function can help you track the query attempts to be optimized.

-

INT type

-

Default value: 30min

-

Unit: millisecond

-

The default value (-1) indicates that the function is disabled.

-

Only a system administrator is allowed to modify this parameter.

-

log_connections/log_disconnections

-

Whether to record a server log message when each session is connected or disconnected.

-
  • on: The system records a log server when each session is connected or disconnected.
  • off: The system does not record a log server when each session is connected or disconnected.
-

Default value: off

-

-

-

log_duration

-

Whether to record the duration of each executed statement.

-
  • on: The system records the duration of each executed statement.
  • off: The system does not record the duration of each executed statement.
-

Default value: on

-

Only a system administrator is allowed to modify this parameter.

-

log_statement

-

SQL statements to be recorded in logs.

-
  • none: The system does not record any SQL statements.
  • ddl: The system records data definition statements.
  • mod: The system records data definition statements and data operation statements.
  • all: The system records all statements.
-

Default value: none

-

Only a system administrator is allowed to modify this parameter.

-

log_hostname

-

Whether to record host names.

-
  • on: The system records host names.
  • off: The system does not record host names.
-

Default value: on

-

By default, connection logs only record the IP addresses of connected hosts. With this function, the host names will also be recorded.

-

This parameter affects parameters in Querying Audit Results, GS_WLM_SESSION_HISTORY, PG_STAT_ACTIVITY, and log_line_prefix.

-
- -[Table 2](#en-us_topic_0237120444_en-us_topic_0059779333_t3c729a4a94d145c7bdc4ca788236d8a7) describes the preceding parameter levels. - -**Table 2** Description of log level parameters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Level

-

Description

-

DEBUG[1-5]

-

Provides information that can be used by developers. Level 1 is the lowest level whereas level 5 is the highest level.

-

INFO

-

Provides information about users' hidden requests, for example, information about the VACUUM VERBOSE process.

-

NOTICE

-

Provides information that may be important to users, for example, truncations of long identifiers or indexes created as a part of a primary key.

-

WARNING

-

Provides warning information for users, for example, COMMIT out of transaction blocks.

-

ERROR

-

Reports an error that causes a command to terminate.

-

LOG

-

Reports information that administrators may be interested in, for example, the activity levels of check points.

-

FATAL

-

Reports the reason that causes a session to terminate.

-

PANIC

-

Reports the reason that causes all sessions to terminate.

-
- diff --git a/content/en/docs/installation/Developerguide/commit-end.md b/content/en/docs/installation/Developerguide/commit-end.md deleted file mode 100644 index 37c8f5810b9b8ddd4dc130cfd97fbbc9cbdea2c8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/commit-end.md +++ /dev/null @@ -1,67 +0,0 @@ -# COMMIT | END - -## Function - -**COMMIT** or **END** commits all operations of a transaction. - -## Precautions - -Only the creator of a transaction or a system administrator can run the **COMMIT** command. The creation and commit operations must be in different sessions. - -## Syntax - -``` -{ COMMIT | END } [ WORK | TRANSACTION ] ; -``` - -## Parameter Description - -- **COMMIT | END** - - Commits the current transaction and makes all changes made by the transaction become visible to others. - -- **WORK | TRANSACTION** - - Specifies an optional keyword, which has no effect except increasing readability. - - -## Examples - -``` --- Create a table. -postgres=# CREATE TABLE tpcds.customer_demographics_t2 -( - CD_DEMO_SK INTEGER NOT NULL, - CD_GENDER CHAR(1) , - CD_MARITAL_STATUS CHAR(1) , - CD_EDUCATION_STATUS CHAR(20) , - CD_PURCHASE_ESTIMATE INTEGER , - CD_CREDIT_RATING CHAR(10) , - CD_DEP_COUNT INTEGER , - CD_DEP_EMPLOYED_COUNT INTEGER , - CD_DEP_COLLEGE_COUNT INTEGER -) -WITH (ORIENTATION = COLUMN,COMPRESSION=MIDDLE) -; - --- Start a transaction. -postgres=# START TRANSACTION; - --- Insert data. -postgres=# INSERT INTO tpcds.customer_demographics_t2 VALUES(1,'M', 'U', 'DOCTOR DEGREE', 1200, 'GOOD', 1, 0, 0); -postgres=# INSERT INTO tpcds.customer_demographics_t2 VALUES(2,'F', 'U', 'MASTER DEGREE', 300, 'BAD', 1, 0, 0); - --- Commit the transaction to make all changes permanent. -postgres=# COMMIT; - --- Query data. -postgres=# SELECT * FROM tpcds.customer_demographics_t2; - --- Delete the tpcds.customer_demographics_t2 table. -postgres=# DROP TABLE tpcds.customer_demographics_t2; -``` - -## Helpful Links - -[ROLLBACK](rollback.md) - diff --git a/content/en/docs/installation/Developerguide/commit-prepared.md b/content/en/docs/installation/Developerguide/commit-prepared.md deleted file mode 100644 index decebe63d8bdb0f42ccc84a4dd7c2684662fd64f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/commit-prepared.md +++ /dev/null @@ -1,42 +0,0 @@ -# COMMIT PREPARED - -## Function - -**COMMIT PREPARED** commits a prepared two-phase transaction. - -## Precautions - -- The function is only available in maintenance mode \(when GUC parameter **xc\_maintenance\_mode** is **on**\). Exercise caution when enabling the mode. It is used by maintenance engineers for troubleshooting. Common users should not use the mode. -- Only the transaction creators or system administrators can run the **COMMIT PREPARED** command. The creation and commit operations must be in different sessions. -- The transaction function is maintained automatically by the database, and should be not visible to users. - -## Syntax - -``` -COMMIT PREPARED transaction_id ; -COMMIT PREPARED transaction_id WITH CSN; -``` - -## Parameter Description - -- **transaction\_id** - - Specifies the identifier of the transaction to be committed. The identifier must be different from those for current prepared transactions. - - -- **CSN\(commit sequence number\)** - - Specifies the sequence number of the transaction to be committed. It is a 64-bit, incremental, unsigned number. - - -## Example - -``` -COMMIT PREPARED commits a transaction whose identifier is trans_test. -postgres=# COMMIT PREPARED 'trans_test'; -``` - -## Helpful Links - -[PREPARE TRANSACTION](prepare-transaction.md) and [ROLLBACK PREPARED](rollback-prepared.md) - diff --git a/content/en/docs/installation/Developerguide/common-faults-and-identification.md b/content/en/docs/installation/Developerguide/common-faults-and-identification.md deleted file mode 100644 index 5daadb10d439ce8175317c3fd9a2188c5fd9ac24..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/common-faults-and-identification.md +++ /dev/null @@ -1,9 +0,0 @@ -# Common Faults and Identification - -- **[Core Fault Locating](core-fault-locating.md)** - -- **[When the TPC-C is running and a disk to be injected is full, the TPC-C stops responding.](when-the-tpc-c-is-running-and-a-disk-to-be-injected-is-full-the-tpc-c-stops-responding.md)** - -- **[Standby Node in the Need Repair \(WAL\) State](standby-node-in-the-need-repair-(wal)-state.md)** - - diff --git a/content/en/docs/installation/Developerguide/communication-library-parameters.md b/content/en/docs/installation/Developerguide/communication-library-parameters.md deleted file mode 100644 index c9614df6b549318db1ea30a196f135bc699cae75..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/communication-library-parameters.md +++ /dev/null @@ -1,215 +0,0 @@ -# Communication Library Parameters - -This section describes parameter settings and value ranges for communication libraries. - -## tcp\_keepalives\_idle - -**Parameter description**: Specifies the interval for transmitting keepalive signals on an OS that supports the **TCP\_KEEPIDLE** socket option. If no keepalive signal is transmitted, the connection is in idle mode. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- If the OS does not support **TCP\_KEEPIDLE**, set this parameter to **0**. ->- The parameter is ignored on an OS where connections are established using the Unix domain socket. - -**Value range:** 0 to 3600. The unit is s. - -**Default value**: **60** - -## tcp\_keepalives\_interval - -**Parameter description**: Specifies the response time before retransmission on an OS that supports the **TCP\_KEEPINTVL** socket option. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: 0 to 180. The unit is s. - -**Default value**: **30** - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- If the OS does not support **TCP\_KEEPINTVL**, set this parameter to **0**. ->- The parameter is ignored on an OS where connections are established using the Unix domain socket. - -## tcp\_keepalives\_count - -**Parameter description**: Specifies the number of keepalive signals that can be waited before the openGauss server is disconnected from the client on an OS that supports the **TCP\_KEEPCNT** socket option. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->- If the OS does not support **TCP\_KEEPCNT**, set this parameter to **0**. ->- The parameter is ignored on an OS where connections are established using the Unix domain socket. - -**Value range**: 0 to 100. **0** indicates that the connection is immediately broken if openGauss does not receive a keepalived signal from the client. - -**Default value:** **20** - -## comm\_tcp\_mode - -**Parameter description**: Specifies whether the communication library uses the TCP or SCTP protocol to set up a data channel. The parameter setting takes effect after you restart openGauss. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->SCTP is no longer supported. This parameter is provided for compatibility, but its value is fixed at **on**. - -**Value range**: Boolean. If this parameter is set to **on**, TCP is used to connect to database nodes. - -**Default value**: **on** - -## comm\_sctp\_port - -**Parameter description**: Specifies the TCP or SCTP port used to listen for data packet channels by the TCP proxy communication library or SCTP communication library. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->This port number is automatically allocated during openGauss deployment. Do not change the parameter value. If the port number is incorrectly configured, the database communication fails. - -**Value range**: an integer ranging from 0 to 65535 - -**Default value**: **7000** - -## comm\_control\_port - -**Parameter description**: Specifies the TCP listening port used by the TCP proxy communication library or SCTP communication library. - -This parameter is a fixed INTERNAL parameter and cannot be modified. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->This port number is automatically allocated during openGauss deployment. Do not change the parameter value. If the port number is incorrectly configured, the database communication fails. - -**Value range**: an integer ranging from 0 to 65535 - -**Default value**: **7001** - -## comm\_max\_receiver - -**Parameter description**: Specifies the maximum number of receiving threads for the TCP proxy communication library or SCTP communication library. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to 50 - -**Default value:** **4** - -## comm\_quota\_size - -**Parameter description**: Specifies the maximum size of packets that can be consecutively sent by the TCP proxy communication library or SCTP communication library. When you use a 1GE NIC, a small value ranging from 20 KB to 40 KB is recommended. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 2048000. The default unit is KB. - -**Default value**: **1MB** - -## comm\_usable\_memory - -**Parameter description**: Specifies the maximum memory available for buffering on the TCP proxy communication library or SCTP communication library on a database node. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->This parameter must be set based on environment memory and the deployment method. If it is too large, an out-of-memory \(OOM\) exception may occur. If it is too small, the performance of the TCP proxy communication library or SCTP communication library may deteriorate. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 100 x 1024 to _INT\_MAX_/2. The default unit is KB. - -**Default value**: **4000MB** - -## comm\_memory\_pool - -**Parameter description**: Specifies the size of the memory pool resources that can be used by the TCP proxy communication library or SCTP communication library on a database node. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If the memory used by the communication library is small, set this parameter to a small value. Otherwise, set it to a large value. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 100 x 1024 to _INT\_MAX_/2. The default unit is KB. - -**Default value**: **2000MB** - -## comm\_memory\_pool\_percent - -**Parameter description**: Specifies the percentage of the memory pool resources that can be used by the TCP proxy communication library or SCTP communication library on a database node. This parameter is used to adaptively reserve memory used by the communication library. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If the memory used by the communication library is small, set this parameter to a small value. Otherwise, set it to a large value. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 100 - -**Default value**: **0** - -## comm\_no\_delay - -**Parameter description**: Specifies whether to use the **NO\_DELAY** attribute of the communication library connection. Restart openGauss for the setting to take effect. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If packet loss occurs in openGauss because a large number of packets are received per second, set this parameter to **off** so that small packets are combined into large packets for transmission to reduce the total number of packets. - -**Default value**: **off** - -## comm\_debug\_mode - -**Parameter description**: Specifies whether to enable the debug mode of the TCP proxy communication library or SCTP communication library, that is, whether to print logs about the communication layer. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If this parameter is set to **on**, a huge number of logs will be printed, adding extra overhead and reducing database performance. Therefore, set it to **on** only in debugging scenarios. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the debug logs of the communication library are printed. -- **off** indicates that the debug logs of the communication library are not printed. - -**Default value**: **off** - -## comm\_ackchk\_time - -**Parameter description**: Specifies the duration after which the communication library server automatically triggers ACK when no data packet is received. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 20000. The unit is ms. **0** indicates that automatic ACK triggering is disabled. - -**Default value**: **2000** - -## comm\_timer\_mode - -**Parameter description**: Specifies whether to enable the timer mode of the TCP proxy communication library or SCTP communication library, that is, whether to print timer logs in each phase of the communication layer. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If this parameter is set to **on**, a huge number of logs will be printed, adding extra overhead and reducing database performance. Therefore, set it to **on** only in debugging scenarios. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the timer logs of the communication library are printed. -- **off** indicates that the timer logs of the communication library are not printed. - -**Default value**: **off** - -## comm\_stat\_mode - -**Parameter description**: Specifies whether to enable the statistics mode of the TCP proxy communication library or SCTP communication library, that is, whether to print statistics about the communication layer. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If this parameter is set to **on**, a huge number of logs will be printed, adding extra overhead and reducing database performance. Therefore, set it to **on** only in debugging scenarios. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the statistics logs of the communication library are printed. -- **off** indicates that the statistics logs of the communication library are not printed. - -**Default value**: **off** - diff --git a/content/en/docs/installation/Developerguide/comparison-disk-vs-mot.md b/content/en/docs/installation/Developerguide/comparison-disk-vs-mot.md deleted file mode 100644 index 2233bf8cedf1891644e5ced018219cd02c6634c3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/comparison-disk-vs-mot.md +++ /dev/null @@ -1,399 +0,0 @@ -# Comparison – Disk vs. MOT - -The following table briefly compares the various features of the openGauss disk-based storage engine and the MOT storage engine. - -**Table 1** Comparison – Disk-based vs. MOT - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Feature

-

openGauss

-

Disk Store

-

openGauss

-

MOT Engine

-

Intel x86 + Kunpeng ARM

-

Yes

-

Yes

-

SQL and Feature-set Coverage

-

100%

-

98%

-

Scale-up (Many-cores, NUMA)

-

Low Efficiency

-

High Efficiency

-

Throughput

-

High

-

Extremely High

-

Latency

-

Low

-

Extremely Low

-

Distributed (Cluster Mode)

-

Yes

-

Yes

-

Isolation Levels

-
  • RC+SI
  • RR
  • Serializable
-
  • RC
  • RR
  • RC+SI (in V2 release)
-

Concurrency Control

-

Pessimistic

-

Optimistic

-

Data Capacity (Data + Index)

-

Unlimited

-

Limited to DRAM

-

Native Compilation

-

No

-

Yes

-

Replication, Recovery

-

Yes

-

Yes

-

Replication Options

-

2 (sync, async)

-

3 (sync, async, group-commit)

-
- -**Legend –** - -- RR = Repeatable Reads -- RC = Read Committed -- SI = Snapshot Isolation - -# Appendices - -## References - -\[1\] Y. Mao, E. Kohler, and R. T. Morris. Cache craftiness for fast multicore key-value storage. In Proc. 7th ACM European Conference on Computer Systems \(EuroSys\), Apr. 2012. - -\[2\] K. Ren, T. Diamond, D. J. Abadi, and A. Thomson. Low-overhead asynchronous checkpointing in main-memory database systems. In Proceedings of the 2016 ACM SIGMOD International Conference on Management of Data, 2016. - -\[3\] https://e.huawei.com/en/products/servers/taishan-server/taishan-2280-v2. - -\[4\] [https://e.huawei.com/en/products/servers/taishan-server/taishan-2480-v2](https://e.huawei.com/en/products/servers/taishan-server/taishan-2480-v2). - -\[5\] Tu, S., Zheng, W., Kohler, E., Liskov, B., and Madden, S. Speedy transactions in multicore in-memory databases. In Proceedings of the Twenty-Fourth ACM Symposium on Operating Systems Principles \(New York, NY, USA, 2013\), SOSP ’13, ACM, pp. 18–32. - -\[6\] H. Avni at al. Industrial-Strength OLTP Using Main Memory and Many-cores, VLDB 2020. - -\[7\] Bernstein, P. A., and Goodman, N. Concurrency control in distributed database systems. ACM Comput. Surv. 13, 2 \(1981\), 185–221. - -\[8\] Felber, P., Fetzer, C., and Riegel, T. Dynamic performance tuning of word-based software transactional memory. In Proceedings of the 13th ACM SIGPLAN Symposium on Principles and Practice of Parallel Programming, PPOPP 2008, Salt Lake City, UT, USA, February 20-23, 2008 \(2008\), - -pp. 237–246. - -\[9\] Appuswamy, R., Anadiotis, A., Porobic, D., Iman, M., and Ailamaki, A. Analyzing the impact of system architecture on the scalability of OLTP engines for high-contention workloads. PVLDB 11, 2 \(2017\), - -121–134. - -\[10\] R. Sherkat, C. Florendo, M. Andrei, R. Blanco, A. Dragusanu, A. Pathak, P. Khadilkar, N. Kulkarni, C. Lemke, S. Seifert, S. Iyer, S. Gottapu, R. Schulze, C. Gottipati, N. Basak, Y. Wang, V. Kandiyanallur, S. Pendap, D. Gala, R. Almeida, and P. Ghosh. Native store extension for SAP HANA. PVLDB, 12\(12\): - -2047–2058, 2019. - -\[11\] X. Yu, A. Pavlo, D. Sanchez, and S. Devadas. Tictoc: Time traveling optimistic concurrency control. In Proceedings of the 2016 International Conference on Management of Data, SIGMOD Conference 2016, San Francisco, CA, USA, June 26 - July 01, 2016, pages 1629–1642, 2016. - -\[12\] V. Leis, A. Kemper, and T. Neumann. The adaptive radix tree: Artful indexing for main-memory databases. In C. S. Jensen, C. M. Jermaine, and X. Zhou, editors, 29th IEEE International Conference on Data Engineering, ICDE 2013, Brisbane, Australia, April 8-12, 2013, pages 38–49. IEEE Computer Society, 2013. - -\[13\] S. K. Cha, S. Hwang, K. Kim, and K. Kwon. Cache-conscious concurrency control of main-memory indexes on shared-memory multiprocessor systems. In P. M. G. Apers, P. Atzeni, S. Ceri, S. Paraboschi, K. Ramamohanarao, and R. T. Snodgrass, editors, VLDB 2001, Proceedings of 27th International Conference on Very Large Data Bases, September 11-14, 2001, Roma, Italy, pages 181–190. Morga Kaufmann, 2001. - -## Glossary - -**Table 2** Glossary - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Acronym

-

Definition/Description

-

2PL

-

2-Phase Locking

-

ACID

-

Atomicity, Consistency, Isolation, Durability

-

AP

-

Analytical Processing

-

ARM

-

Advanced RISC Machine, a hardware architecture alternative to x86

-

CC

-

Concurrency Control

-

CPU

-

Central Processing Unit

-

DB

-

Database

-

DBA

-

Database Administrator

-

DBMS

-

Database Management System

-

DDL

-

Data Definition Language. Database Schema management language

-

DML

-

Data Modification Language

-

ETL

-

Extract, Transform, Load or Encounter Time Locking

-

FDW

-

Foreign Data Wrapper

-

GC

-

Garbage Collector

-

HA

-

High Availability

-

HTAP

-

Hybrid Transactional-Analytical Processing

-

IoT

-

Internet of Things

-

IM

-

In-Memory

-

IMDB

-

In-Memory Database

-

IR

-

Intermediate Representation of a source code, used in compilation and optimization

-

JIT

-

Just In Time

-

JSON

-

JavaScript Object Notation

-

KV

-

Key Value

-

LLVM

-

Low-Level Virtual Machine, refers to a compilation code or queries to IR

-

M2M

-

Machine-to-Machine

-

ML

-

Machine Learning

-

MM

-

Main Memory

-

MO

-

Memory Optimized

-

MOT

-

Memory Optimized Tables storage engine (SE), pronounced as /em/ /oh/ /tee/

-

MVCC

-

Multi-Version Concurrency Control

-

NUMA

-

Non-Uniform Memory Access

-

OCC

-

Optimistic Concurrency Control

-

OLTP

-

Online Transaction Processing

-

PG

-

PostgreSQL

-

RAW

-

Reads-After-Writes

-

RC

-

Return Code

-

RTO

-

Recovery Time Objective

-

SE

-

Storage Engine

-

SQL

-

Structured Query Language

-

TCO

-

Total Cost of Ownership

-

TP

-

Transactional Processing

-

TPC-C

-

An On-Line Transaction Processing Benchmark

-

Tpm-C

-

Transactions-per-minute-C. A performance metric for TPC-C benchmark that counts new-order transactions.

-

TVM

-

Tiny Virtual Machine

-

TSO

-

Time Sharing Option

-

UDT

-

User-Defined Type

-

WAL

-

Write Ahead Log

-

XLOG

-

A PostgreSQL implementation of transaction logging (WAL - described above)

-
- diff --git a/content/en/docs/installation/Developerguide/comparison-operators.md b/content/en/docs/installation/Developerguide/comparison-operators.md deleted file mode 100644 index 8bc07e2602b8f2f2aa3ab7276bd7e1352ccc0a17..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/comparison-operators.md +++ /dev/null @@ -1,50 +0,0 @@ -# Comparison Operators - -Comparison operators are available for most data types and return Boolean values. - -All comparison operators are binary operators. Only data types that are the same or can be implicitly converted can be compared using comparison operators. - -[Table 1](#en-us_topic_0237121966_en-us_topic_0059777421_en-us_topic_0058965550_table65067702) describes comparison operators provided by openGauss. - -**Table 1** Comparison operations - - - - - - - - - - - - - - - - - - - - - - - - - -

Operator

-

Description

-

<

-

Less than

-

>

-

Greater than

-

<=

-

Less than or equal to

-

>=

-

Greater than or equal to

-

=

-

Equality

-

<> or !=

-

Inequality

-
-Comparison operators are available for all relevant data types. All comparison operators are binary operators that returned values of Boolean type. The calculation priority of the inequality sign is higher than that of the equality sign. If the entered data is different and cannot be implicitly converted, the comparison fails. For example, an expression such as 1<2<3 is invalid because the less than sign (<) cannot be used to compare Boolean values and 3. \ No newline at end of file diff --git a/content/en/docs/installation/Developerguide/compatibility-with-earlier-versions.md b/content/en/docs/installation/Developerguide/compatibility-with-earlier-versions.md deleted file mode 100644 index 092bdaafed91178ec7581c639e1fc658208d2c11..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/compatibility-with-earlier-versions.md +++ /dev/null @@ -1,127 +0,0 @@ -# Compatibility with Earlier Versions - -This section describes the parameter control of the downward compatibility and external compatibility features of the openGauss database. A backward compatible database supports applications of earlier versions. This section describes parameters used for controlling backward compatibility of a database. - -## array\_nulls - -**Parameter description**: controls whether the array input parser recognizes unquoted NULL as a null array element. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that null values can be entered in arrays. -- **off** indicates backward compatibility with the old behavior. Arrays containing **NULL** values can still be created when this parameter is set to **off**. - -**Default value**: **on** - -## backslash\_quote - -**Parameter description**: controls whether a single quotation mark can be represented by \\' in a string text. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->When the string text meets the SQL standards, \\ has no other meanings. This parameter only affects the handling of non-standard-conforming string texts, including escape string syntax \(E'...'\). - -**Value range**: enumerated values - -- **on** indicates that the use of \\' is always allowed. -- **off** indicates that the use of \\' is rejected. -- **safe\_encoding** indicates that the use of \\' is allowed only when client encoding does not allow ASCII \\ within a multibyte character. - -**Default value**: **safe\_encoding** - -## escape\_string\_warning - -**Parameter description**: specifies a warning on directly using a backslash \(\\\) as an escape in an ordinary string. - -- Applications that wish to use a backslash \(\\\) as an escape need to be modified to use escape string syntax \(E'...'\). This is because the default behavior of ordinary strings is now to treat the backslash as an ordinary character in each SQL standard. -- This variable can be enabled to help locate codes that need to be changed. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -**Default value**: **on** - -## lo\_compat\_privileges - -**Parameter description**: Specifies whether to enable backward compatibility for the privilege check of large objects. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -**on** indicates that the privilege check is disabled when users read or modify large objects. This setting is compatible with versions earlier than PostgreSQL 9.0. - -**Default value**: **off** - -## quote\_all\_identifiers - -**Parameter description:** When the database generates SQL, this parameter forcibly quotes all identifiers even if they are not keywords. This will affect the output of EXPLAIN as well as the results of functions, such as pg\_get\_viewdef. For details, see the **--quote-all-identifiers** parameter of **gs\_dump**. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates the forcible quotation function is enabled. -- **off** indicates the forcible quotation function is disabled. - -**Default value**: **off** - -## sql\_inheritance - -**Parameter description**: Specifies whether to inherit semantics. This parameter specifies the access policy of descendant tables. **off** indicates that subtables cannot be accessed by commands. That is, the ONLY keyword is used by default. This setting is compatible with earlier versions. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that the subtable can be accessed. -- **off** indicates that the subtable cannot be accessed. - -**Default value**: **on** - -## standard\_conforming\_strings - -**Parameter description**: Specifies whether ordinary string texts \('...'\) treat backslashes as ordinary texts as specified in the SQL standard. - -- Applications can check this parameter to determine how string texts will be processed. -- It is recommended that characters be escaped by using the escape string syntax \(E'...'\). - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that the function is enabled. -- **off** indicates that the function is disabled. - -**Default value**: **on** - -## synchronize\_seqscans - -**Parameter description**: Specifies sequential scans of tables to synchronize with each other. Concurrent scans read the same data block about at the same time and share the I/O workload. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that a scan may start in the middle of the table and then "wrap around" the end to cover all rows to synchronize with the activity of scans already in progress. This may result in unpredictable changes in the row ordering returned by queries that have no ORDER BY clause. -- **off** indicates that the scan always starts from the table heading. - -**Default value**: **on** - -## enable\_beta\_features - -**Parameter description**: Specifies whether to enable some features that are not officially released and are used only for POC verification. Exercise caution when enabling these extended features because they may cause errors in some scenarios. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that the features are enabled and forward compatible, but may incur errors in certain scenarios. -- **off** indicates that the features are disabled. - -**Default value**: **off** - diff --git a/content/en/docs/installation/Developerguide/concepts-of-mot.md b/content/en/docs/installation/Developerguide/concepts-of-mot.md deleted file mode 100644 index 19db35a2550ccc306424519b8fc3e4b37f818fa3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concepts-of-mot.md +++ /dev/null @@ -1,23 +0,0 @@ -# Concepts of MOT - -This chapter describes how openGauss MOT is designed and how it works. It also sheds light on its advanced features and capabilities and how to use them. This chapter serves to educate the reader about various technical details of how MOT operates, details of important MOT features and innovative differentiators. The content of this chapter may be useful for decision-making regarding MOT's suitability to specific application requirements and for using and managing it most efficiently. - -- **[MOT Scale-up Architecture](mot-scale-up-architecture.md)** - -- **[MOT Concurrency Control Mechanism](mot-concurrency-control-mechanism.md)** - -- **[Extended FDW and Other openGauss Features](extended-fdw-and-other-opengauss-features.md)** - -- **[NUMA Awareness Allocation and Affinity](numa-awareness-allocation-and-affinity.md)** - -- **[MOT Indexes](mot-indexes.md)** - -- **[MOT Durability Concepts](mot-durability-concepts.md)** - -- **[MOT Recovery Concepts](mot-recovery-concepts.md)** - -- **[MOT Query Native Compilation \(JIT\)](mot-query-native-compilation-(jit).md)** - -- **[Comparison – Disk vs. MOT](comparison-disk-vs-mot.md)** - - diff --git a/content/en/docs/installation/Developerguide/concepts.md b/content/en/docs/installation/Developerguide/concepts.md deleted file mode 100644 index ad658908bec8a0678041bf55da12ec702532bc5e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concepts.md +++ /dev/null @@ -1,22 +0,0 @@ -# Concepts - -## Database - -Databases manage various data objects and are isolated from each other. While creating a database, you can specify a tablespace. If you do not specify it, the object will be saved to the **PG\_DEFAULT** tablespace by default. Objects managed by a database can be distributed to multiple tablespaces. - -## Tablespace - -In openGauss, a tablespace is a directory storing physical files of the databases the tablespace contains. Multiple tablespaces can coexist. Files are physically isolated using tablespaces and managed by a file system. - -## Schema - -openGauss schemas logically separate databases. All database objects are created under certain schemas. In openGauss, schemas and users are loosely bound. When you create a user, a schema with the same name as the user will be created automatically. You can also create a schema or specify another schema. - -## User and Role - -openGauss uses users and roles to control the access to databases. A role can be a database user or a group of database users, depending on role settings. In openGauss, the difference between roles and users is that a role does not have the **LOGIN** permission by default. In openGauss, one user can have only one role, but you can put a user's role under a parent role to grant multiple permissions to the user. - -## Transaction - -In openGauss, transactions are managed by multi-version concurrency control \(MVCC\) and two-phase locking \(2PL\). It enables smooth data reads and writes. openGauss stores them together with the version of the current tuple. A VACUUM thread is introduced to periodically clear historical version data. Unless in performance optimization, you do not need to pay attention to the **VACUUM** process. In addition, openGauss automatically commits transactions. - diff --git a/content/en/docs/installation/Developerguide/concurrent-data-import-and-queries.md b/content/en/docs/installation/Developerguide/concurrent-data-import-and-queries.md deleted file mode 100644 index dc0efc9a3f000d191947ce1514c39f77c6727bec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concurrent-data-import-and-queries.md +++ /dev/null @@ -1,33 +0,0 @@ -# Concurrent Data Import and Queries - -Transaction T1: - -``` -START TRANSACTION; -COPY test FROM '...'; -COMMIT; -``` - -Transaction T2: - -``` -START TRANSACTION; -SELECT * FROM test; -COMMIT; -``` - -Scenario 1: - -T1 is started but not committed. At this time, T2 is started. **COPY** of T1 and then **SELECT** of T2 starts, and both of them succeed. In this case, T2 cannot see the data added by **COPY** of T1. - -Scenario 2: - -- **READ COMMITTED** level - - T1 is started but not committed. At this time, T2 is started. **COPY** of T1 is complete and T1 is committed. In this case, T2 can see the data added by **COPY** of T1. - -- **REPEATABLE READ** level - - T1 is started but not committed. At this time, T2 is started. **COPY** of T1 is complete and T1 is committed. In this case, T2 cannot see the data added by **COPY** of T1. - - diff --git a/content/en/docs/installation/Developerguide/concurrent-insert-and-delete-in-the-same-table.md b/content/en/docs/installation/Developerguide/concurrent-insert-and-delete-in-the-same-table.md deleted file mode 100644 index 396278243627d9c3686e084788137d0b308f5af6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concurrent-insert-and-delete-in-the-same-table.md +++ /dev/null @@ -1,33 +0,0 @@ -# Concurrent INSERT and DELETE in the Same Table - -Transaction T1: - -``` -START TRANSACTION; -INSERT INTO test VALUES(1,'test1','test123'); -COMMIT; -``` - -Transaction T2: - -``` -START TRANSACTION; -DELETE test WHERE NAME='test1'; -COMMIT; -``` - -Scenario 1: - -T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, **DELETE** of T2 is performed. In this case, **DELETE 0** is displayed, because T1 is not committed and T2 cannot see the data inserted by T1. - -Scenario 2: - -- **READ COMMITTED** level - - T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, T1 is committed and **DELETE** of T2 is executed. In this case, **DELETE 1** is displayed, because T2 can see the data inserted by T1. - -- **REPEATABLE READ** level - - T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, T1 is committed and **DELETE** of T2 is executed. In this case, **DELETE 0** is displayed, because the data obtained in queries is consistent in a transaction. - - diff --git a/content/en/docs/installation/Developerguide/concurrent-insert-in-the-same-table.md b/content/en/docs/installation/Developerguide/concurrent-insert-in-the-same-table.md deleted file mode 100644 index 06e8e5662f3170daef7ce3c0be867ae1f138aa00..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concurrent-insert-in-the-same-table.md +++ /dev/null @@ -1,33 +0,0 @@ -# Concurrent INSERT in the Same table - -Transaction T1: - -``` -START TRANSACTION; -INSERT INTO test VALUES(2,'test2','test123'); -COMMIT; -``` - -Transaction T2: - -``` -START TRANSACTION; -INSERT INTO test VALUES(3,'test3','test123'); -COMMIT; -``` - -Scenario 1: - -T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, **INSERT** of T2 is executed and succeeds. At the **READ COMMITTED** and **REPEATABLE READ** levels, the **SELECT** statement of T1 cannot see data inserted by T2, and a query in T2 cannot see data inserted by T1. - -Scenario 2: - -- **READ COMMITTED** level - - T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, T1 is committed. In T2, a query executed after **INSERT** can see the data inserted by T1. - -- **REPEATABLE READ** level - - T1 is started but not committed. At this time, T2 is started. After **INSERT** of T1 is complete, T1 is committed. In T2, a query executed after **INSERT** cannot see the data inserted by T1. - - diff --git a/content/en/docs/installation/Developerguide/concurrent-update-in-the-same-table.md b/content/en/docs/installation/Developerguide/concurrent-update-in-the-same-table.md deleted file mode 100644 index 8352a593f0e6e9db1faa72143eafdcc6589f5a13..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concurrent-update-in-the-same-table.md +++ /dev/null @@ -1,34 +0,0 @@ -# Concurrent UPDATE in the Same Table - -Transaction T1: - -``` -START TRANSACTION; -UPDATE test SET address='test1234' WHERE name='test1'; -COMMIT; -``` - -Transaction T2: - -``` -START TRANSACTION; -UPDATE test SET address='test1234' WHERE name='test2'; -COMMIT; -``` - -Transaction T3: - -``` -START TRANSACTION; -UPDATE test SET address='test1234' WHERE name='test1'; -COMMIT; -``` - -Scenario 1: - -T1 is started but not committed. At this time, T2 is started. **UPDATE** of T1 and then T2 starts, and both of them succeed. This is because the **UPDATE** operations use row-level locks and do not conflict when they update different rows. - -Scenario 2: - -T1 is started but not committed. At this time, T3 is started. **UPDATE** of T1 and then T3 starts, and **UPDATE** of T1 succeeds. **UPDATE** of T3 times out. This is because T1 and T3 update the same row and the lock is held by T1 at the time of the update. - diff --git a/content/en/docs/installation/Developerguide/concurrent-write-examples.md b/content/en/docs/installation/Developerguide/concurrent-write-examples.md deleted file mode 100644 index abc7baa223ffc89671dc6e5a10985ecbc3453a18..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/concurrent-write-examples.md +++ /dev/null @@ -1,17 +0,0 @@ -# Concurrent Write Examples - -This section uses the **test** table as an example to describe how to perform concurrent **INSERT** and **DELETE** in the same table, concurrent **INSERT** in the same table, concurrent **UPDATE** in the same table, and concurrent import and queries. - -``` -CREATE TABLE test(id int, name char(50), address varchar(255)); -``` - -- **[Concurrent INSERT and DELETE in the Same Table](concurrent-insert-and-delete-in-the-same-table.md)** - -- **[Concurrent INSERT in the Same table](concurrent-insert-in-the-same-table.md)** - -- **[Concurrent UPDATE in the Same Table](concurrent-update-in-the-same-table.md)** - -- **[Concurrent Data Import and Queries](concurrent-data-import-and-queries.md)** - - diff --git a/content/en/docs/installation/Developerguide/condition-expressions.md b/content/en/docs/installation/Developerguide/condition-expressions.md deleted file mode 100644 index b8a3190266a31a67b3dc99ce6195d093301cdea2..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/condition-expressions.md +++ /dev/null @@ -1,214 +0,0 @@ -# Condition Expressions - -Data that meets the requirements specified by conditional expressions are filtered during SQL statement execution. - -Conditional expressions include the following types: - -- CASE - - **CASE** expressions are similar to the **CASE** statements in other coding languages. - - [Figure 1](#en-us_topic_0237122002_en-us_topic_0059777797_f6defc8307fd0434380b6ba22838ed5f1) shows the syntax of a **CASE** expression. - - **Figure 1** case::= - ![](figures/case.jpg "case") - - A **CASE** clause can be used in a valid expression. **condition** is an expression that returns a value of Boolean type. - - - If the result is **true**, the result of the **CASE** expression is the required result. - - If the result is false, the following **WHEN** or **ELSE** clauses are processed in the same way. - - If every **WHEN condition** is false, the result of the expression is the result of the **ELSE** clause. If the **ELSE** clause is omitted and has no match condition, the result is NULL. - - Example: - - ``` - postgres=# CREATE TABLE tpcds.case_when_t1(CW_COL1 INT); - - postgres=# INSERT INTO tpcds.case_when_t1 VALUES (1), (2), (3); - - postgres=# SELECT * FROM tpcds.case_when_t1; - cw_col1 - ------ - 1 - 2 - 3 - (3 rows) - - postgres=# SELECT CW_COL1, CASE WHEN CW_COL1=1 THEN 'one' WHEN CW_COL1=2 THEN 'two' ELSE 'other' END FROM tpcds.case_when_t1 ORDER BY 1; - cw_col1 | case - ---------+------- - 1 | one - 2 | two - 3 | other - (3 rows) - - postgres=# DROP TABLE tpcds.case_when_t1; - ``` - -- DECODE - - [Figure 2](#en-us_topic_0237122002_en-us_topic_0059777797_f8e62b15fa92349339fcdb77fcc5fef4d) shows the syntax of a **DECODE** expression. - - **Figure 2** decode::= - ![](figures/decode.png "decode") - - Compare each following **compare\(n\)** with **base\_expr**, **value\(n\)** is returned if a **compare\(n\)** matches the **base\_expr** expression. If base\_expr does not match each **compare\(n\)**, the default value is returned. - - [Conditional Expression Functions](conditional-expression-functions.md) describes the examples. - - ``` - postgres=# SELECT DECODE('A','A',1,'B',2,0); - case - ------ - 1 - (1 row) - ``` - -- COALESCE - - [Figure 3](#en-us_topic_0237122002_en-us_topic_0059777797_f1877c9f8d2ac4964828a6eaaddf5f35f) shows the syntax of a **COALESCE** expression. - - **Figure 3** coalesce::= - ![](figures/coalesce.png "coalesce") - - **COALESCE** returns its first not-**NULL** value. If all the parameters are **NULL**, **COALESCE** will return **NULL**. This value is replaced by the default value when data is displayed. Like a **CASE** expression, **COALESCE** only evaluates the parameters that are needed to determine the result. That is, parameters to the right of the first not-**NULL** parameter are not evaluated. - - Example - - ``` - postgres=# CREATE TABLE tpcds.c_tabl(description varchar(10), short_description varchar(10), last_value varchar(10)) - ; - - postgres=# INSERT INTO tpcds.c_tabl VALUES('abc', 'efg', '123'); - postgres=# INSERT INTO tpcds.c_tabl VALUES(NULL, 'efg', '123'); - - postgres=# INSERT INTO tpcds.c_tabl VALUES(NULL, NULL, '123'); - - postgres=# SELECT description, short_description, last_value, COALESCE(description, short_description, last_value) FROM tpcds.c_tabl ORDER BY 1, 2, 3, 4; - description | short_description | last_value | coalesce - -------------+-------------------+------------+---------- - abc | efg | 123 | abc - | efg | 123 | efg - | | 123 | 123 - (3 rows) - - postgres=# DROP TABLE tpcds.c_tabl; - ``` - - If **description** is not **NULL**, the value of **description** is returned. Otherwise, parameter **short\_description** is calculated. If **short\_description** is not **NULL**, the value of **short\_description** is returned. Otherwise, parameter **last\_value** is calculated. If **last\_value** is not **NULL**, the value of **last\_value** is returned. Otherwise, **none** is returned. - - ``` - postgres=# SELECT COALESCE(NULL,'Hello World'); - coalesce - --------------- - Hello World - (1 row) - ``` - -- NULLIF - - [Figure 4](#en-us_topic_0237122002_en-us_topic_0059777797_f6c5bc64bf5de4b728ed1d73d97768e6e) shows the syntax of a **NULLIF** expression. - - **Figure 4** nullif::= - ![](figures/nullif.png "nullif") - - Only if **value1** is equal to **value2** can **NULLIF** return the **NULL** value. Otherwise, **value1** is returned. - - Example: - - ``` - postgres=# CREATE TABLE tpcds.null_if_t1 ( - NI_VALUE1 VARCHAR(10), - NI_VALUE2 VARCHAR(10) - ); - - postgres=# INSERT INTO tpcds.null_if_t1 VALUES('abc', 'abc'); - postgres=# INSERT INTO tpcds.null_if_t1 VALUES('abc', 'efg'); - - postgres=# SELECT NI_VALUE1, NI_VALUE2, NULLIF(NI_VALUE1, NI_VALUE2) FROM tpcds.null_if_t1 ORDER BY 1, 2, 3; - - ni_value1 | ni_value2 | nullif - -----------+-----------+-------- - abc | abc | - abc | efg | abc - (2 rows) - postgres=# DROP TABLE tpcds.null_if_t1; - ``` - - If **value1** is equal to **value2**, **NULL** is returned. Otherwise, **value1** is returned. - - ``` - postgres=# SELECT NULLIF('Hello','Hello World'); - nullif - -------- - Hello - (1 row) - ``` - -- GREATEST \(maximum value\) and LEAST \(minimum value\) - - [Figure 5](#en-us_topic_0237122002_en-us_topic_0059777797_f23a83b0f987a49e0b6890280568afbd2) shows the syntax of a **GREATEST** expression. - - **Figure 5** greatest::= - ![](figures/greatest.png "greatest") - - You can select the maximum value from any numerical expression list. - - ``` - postgres=# SELECT greatest(9000,155555,2.01); - greatest - ---------- - 155555 - (1 row) - ``` - - [Figure 6](#en-us_topic_0237122002_en-us_topic_0059777797_f30a16b0edbde4750a42053619840b384) shows the syntax of a **LEAST** expression. - - **Figure 6** least::= - ![](figures/least.png "least") - - You can select the minimum value from any numerical expression list. - - Each of the preceding numeric expressions can be converted into a common data type, which will be the data type of the result. - - The NULL values in the list will be ignored. The result is **NULL** only if the results of all expressions are **NULL**. - - ``` - postgres=# SELECT least(9000,2); - least - ------- - 2 - (1 row) - ``` - - [Conditional Expression Functions](conditional-expression-functions.md) describes the examples. - -- NVL - - [Figure 7](#en-us_topic_0237122002_en-us_topic_0059777797_f69cd4e01dd6e4280b756eb98d3c77c91) shows the syntax of an **NVL** expression. - - **Figure 7** nvl::= - ![](figures/nvl.jpg "nvl") - - If the value of **value1** is **NULL**, **value2** is returned. Otherwise, **value1** is returned. - - Example: - - ``` - postgres=# SELECT nvl(null,1); - NVL - ----- - 1 - (1 row) - - ``` - - ``` - postgres=# SELECT nvl ('Hello World' ,1); - nvl - --------------- - Hello World - (1 row) - ``` - - diff --git a/content/en/docs/installation/Developerguide/conditional-expression-functions.md b/content/en/docs/installation/Developerguide/conditional-expression-functions.md deleted file mode 100644 index 2df27f43a0348518af26df0c2f91e5049a1f3062..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/conditional-expression-functions.md +++ /dev/null @@ -1,171 +0,0 @@ -# Conditional Expression Functions - -## Conditional Expression Functions - -- coalesce\(expr1, expr2, ..., exprn\) - - Description: - - Returns the first of its arguments that are not null. - - **COALESCE\(expr1, expr2\)** is equivalent to **CASE WHEN expr1 IS NOT NULL THEN expr1 ELSE expr2 END**. - - Example: - - ``` - postgres=# SELECT coalesce(NULL,'hello'); - coalesce - ---------- - hello - (1 row) - ``` - - Note: - - - Null is returned only if all parameters are null. - - This value is replaced by the default value when data is displayed. - - Like a **CASE** expression, **COALESCE** only evaluates the parameters that are needed to determine the result. That is, parameters to the right of the first not-**NULL** parameter are not evaluated. - -- decode\(base\_expr, compare1, value1, Compare2,value2, ... default\) - - Description: Compares **base\_expr** with each **compare\(n\)** and **returns value\(n\)** if they are matched. If **base\_expr** does not match each **compare\(n\)**, the default value is returned. - - Example: - - ``` - postgres=# SELECT decode('A','A',1,'B',2,0); - case - ------ - 1 - (1 row) - ``` - -- nullif\(expr1, expr2\) - - Description: Returns **NULL** only when **expr1** is equal to **expr2**. Otherwise, **expr1** is returned. - - **nullif\(expr1, expr2\)** is equivalent to **CASE WHEN expr1 = expr2 THEN NULL ELSE expr1 END**. - - Example: - - ``` - postgres=# SELECT nullif('hello','world'); - nullif - -------- - hello - (1 row) - ``` - - Note: - - Assume the two parameter data types are different: - - - If implicit conversion exists between the two data types, implicitly convert the parameter of lower priority to this data type using the data type of higher priority. If the conversion succeeds, computation is performed. Otherwise, an error is returned. For example: - - ``` - postgres=# SELECT nullif('1234'::VARCHAR,123::INT4); - nullif - -------- - 1234 - (1 row) - ``` - - ``` - postgres=# SELECT nullif('1234'::VARCHAR,'2012-12-24'::DATE); - ERROR: invalid input syntax for type timestamp: "1234" - ``` - - - If implicit conversion is not applied between two data types, an error is displayed. For example: - - ``` - postgres=# SELECT nullif(TRUE::BOOLEAN,'2012-12-24'::DATE); - ERROR: operator does not exist: boolean = timestamp without time zone - LINE 1: SELECT nullif(TRUE::BOOLEAN,'2012-12-24'::DATE) FROM DUAL; - ^ - HINT: No operator matches the given name and argument type(s). You might need to add explicit type casts. - ``` - - -- nvl\( expr1 , expr2 \) - - Description: - - - If **expr1** is **NULL**, **expr2** is returned. - - If **expr1** is not **NULL**, **expr1** is returned. - - Example: - - ``` - postgres=# SELECT nvl('hello','world'); - nvl - ------- - hello - (1 row) - ``` - - Parameters **expr1** and **expr2** can be of any data type. If **expr1** and **expr2** are of different data types, NVL checks whether **expr2** can be implicitly converted to **expr1**. If it can, the **expr1** data type is returned. If **epr2** cannot be implicitly converted to **expr1** but **epr1** can be implicitly converted to **expr2**, the **expr2** data type is returned. If no implicit type conversion exists between the two parameters and the parameters are different data types, an error is reported. - -- greatest\(expr1 \[, ...\]\) - - Description: Selects the largest value from a list of any number of expressions. - - Return type: - - Example: - - ``` - postgres=# SELECT greatest(1*2,2-3,4-1); - greatest - ---------- - 3 - (1 row) - ``` - - ``` - postgres=# SELECT greatest('HARRY', 'HARRIOT', 'HAROLD'); - greatest - ---------- - HARRY - (1 row) - ``` - -- least\(expr1 \[, ...\]\) - - Description: Selects the smallest value from a list of any number of expressions. - - Example: - - ``` - postgres=# SELECT least(1*2,2-3,4-1); - least - ------- - -1 - (1 row) - ``` - - ``` - postgres=# SELECT least('HARRY','HARRIOT','HAROLD'); - least - -------- - HAROLD - (1 row) - ``` - -- EMPTY\_BLOB\(\) - - Description: Initiates a BLOB variable in an **INSERT** or an **UPDATE** statement to a **NULL** value. - - Return type: BLOB - - Example: - - ``` - -- Create a table. - postgres=# CREATE TABLE blob_tb(b blob,id int); - -- Insert data. - postgres=# INSERT INTO blob_tb VALUES (empty_blob(),1); - --Delete the table. - postgres=# DROP TABLE blob_tb; - ``` - - diff --git a/content/en/docs/installation/Developerguide/conditional-statements.md b/content/en/docs/installation/Developerguide/conditional-statements.md deleted file mode 100644 index 3993932dc165c053672d5405ba6c9cc1f1d334ae..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/conditional-statements.md +++ /dev/null @@ -1,102 +0,0 @@ -# Conditional Statements - -Conditional statements are used to decide whether given conditions are met. Operations are executed based on the decisions made. - -openGauss supports five usages of **IF**: - -- IF\_THEN - - **Figure 1** IF\_THEN::= - ![](figures/if_then.jpg "if_then") - - **IF\_THEN** is the simplest form of **IF**. If the condition is true, statements are executed. If it is false, they are skipped. - - Example: - - ``` - postgres=# IF v_user_id <> 0 THEN - UPDATE users SET email = v_email WHERE user_id = v_user_id; - END IF; - ``` - -- IF\_THEN\_ELSE - - **Figure 2** IF\_THEN\_ELSE::= - ![](figures/if_then_else.jpg "if_then_else") - - **IF-THEN-ELSE** statements add **ELSE** branches and can be executed if the condition is false. - - Example: - - ``` - postgres=# IF parentid IS NULL OR parentid = '' - THEN - RETURN; - ELSE - hp_true_filename(parentid); -- Call the stored procedure. - END IF; - ``` - -- IF\_THEN\_ELSE IF - - **IF** statements can be nested in the following way: - - ``` - postgres=# IF sex = 'm' THEN - pretty_sex := 'man'; - ELSE - IF sex = 'f' THEN - pretty_sex := 'woman'; - END IF; - END IF; - ``` - - Actually, this is a way of an **IF** statement nesting in the **ELSE** part of another **IF** statement. Therefore, an **END IF** statement is required for each nesting **IF** statement and another **END IF** statement is required to end the parent **IF-ELSE** statement. To set multiple options, use the following form: - -- IF\_THEN\_ELSIF\_ELSE - - **Figure 3** IF\_THEN\_ELSIF\_ELSE::= - ![](figures/if_then_elsif_else.png "if_then_elsif_else") - - Example: - - ``` - IF number_tmp = 0 THEN - result := 'zero'; - ELSIF number_tmp > 0 THEN - result := 'positive'; - ELSIF number_tmp < 0 THEN - result := 'negative'; - ELSE - result := 'NULL'; - END IF; - ``` - -- IF\_THEN\_ELSEIF\_ELSE - - **ELSEIF** is an alias of **ELSIF**. - - Example: - - ``` - CREATE OR REPLACE PROCEDURE proc_control_structure(i in integer) - AS - BEGIN - IF i > 0 THEN - raise info 'i:% is greater than 0. ',i; - ELSIF i < 0 THEN - raise info 'i:% is smaller than 0. ',i; - ELSE - raise info 'i:% is equal to 0. ',i; - END IF; - RETURN; - END; - / - - CALL proc_control_structure(3); - - -- Delete the stored procedure. - DROP PROCEDURE proc_control_structure; - ``` - - diff --git a/content/en/docs/installation/Developerguide/config_settings.md b/content/en/docs/installation/Developerguide/config_settings.md deleted file mode 100644 index fcaefd1a203df8d8eb8a165a5eb70e1235aefd81..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/config_settings.md +++ /dev/null @@ -1,130 +0,0 @@ -# CONFIG\_SETTINGS - -**CONFIG\_SETTINGS** displays information about parameters of the running database. - -**Table 1** CONFIG\_SETTINGS columns - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Name

-

Type

-

Description

-

name

-

text

-

Parameter name

-

setting

-

text

-

Current parameter value

-

unit

-

text

-

Implicit unit of the parameter

-

category

-

text

-

Logical group of the parameter

-

short_desc

-

text

-

Brief description of the parameter

-

extra_desc

-

text

-

Detailed description of the parameter

-

context

-

text

-

Context required to set the parameter value, including internal, postmaster, sighup, backend, superuser, and user

-

vartype

-

text

-

Parameter type, including bool, enum, integer, real, or string

-

source

-

text

-

Method of assigning the parameter value

-

min_val

-

text

-

Maximum value of the parameter. If the parameter type is not numeric, the value of this column is null.

-

max_val

-

text

-

Minimum value of the parameter. If the parameter type is not numeric, the value of this column is null.

-

enumvals

-

text[]

-

Valid values of an enum-type parameter. If the parameter type is not enum, the value of this column is null.

-

boot_val

-

text

-

Default parameter value used upon the database startup

-

reset_val

-

text

-

Default parameter value used upon the database reset

-

sourcefile

-

text

-

Configuration file used to set parameter values. If parameter values are not configured using the configuration file, the value of this column is null.

-

sourceline

-

integer

-

Row number in the configuration file for setting parameter values. If parameter values are not configured using the configuration file, the value of this column is null.

-
- diff --git a/content/en/docs/installation/Developerguide/configuration-examples.md b/content/en/docs/installation/Developerguide/configuration-examples.md deleted file mode 100644 index c2f1ddc54dcf829aba82dc977f467cde26241fdd..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuration-examples.md +++ /dev/null @@ -1,111 +0,0 @@ -# Configuration Examples - -Text search configuration specifies the following components required for converting a document into a **tsvector**: - -- A parser, decomposes a text into tokens. -- Dictionary list, converts each token into a lexeme. - -Each time when the **to\_tsvector** or **to\_tsquery** function is invoked, a text search configuration is required to specify a processing procedure. The GUC parameter [default\_text\_search\_config](zone-and-formatting.md#en-us_topic_0237124733_en-us_topic_0059778109_sd9a07d429cd4498383931c621742b816) specifies the default text search configuration, which will be used if the text search function does not explicitly specify a text search configuration. - -openGauss provides some predefined text search configurations. You can also create user-defined text search configurations. In addition, to facilitate the management of text search objects, multiple **gsql** meta-commands are provided to display information about text search objects. For details, see "Client Tool \> Meta-Command Reference" in _Tool Reference_. - -## Procedure - -1. Create a text search configuration **ts\_conf** by copying the predefined text search configuration **english**. - - ``` - postgres=# CREATE TEXT SEARCH CONFIGURATION ts_conf ( COPY = pg_catalog.english ); - CREATE TEXT SEARCH CONFIGURATION - ``` - -2. Create a **Synonym** dictionary. - - Assume that the definition file **pg\_dict.syn** of the **Synonym** dictionary contains the following contents: - - ``` - postgres pg - pgsql pg - postgresql pg - ``` - - Run the following statement to create the **Synonym** dictionary: - - ``` - postgres=# CREATE TEXT SEARCH DICTIONARY pg_dict ( - TEMPLATE = synonym, - SYNONYMS = pg_dict, - FILEPATH = 'file:///home/dicts' - ); - ``` - -3. Create an **Ispell** dictionary **english\_ispell** \(the dictionary definition file is from the open source dictionary\). - - ``` - postgres=# CREATE TEXT SEARCH DICTIONARY english_ispell ( - TEMPLATE = ispell, - DictFile = english, - AffFile = english, - StopWords = english, - FILEPATH = 'file:///home/dicts' - ); - ``` - -4. Modify the text search configuration **ts\_conf** and change the dictionary list for tokens of certain types. For details about token types, see [Parser](parser.md). - - ``` - postgres=# ALTER TEXT SEARCH CONFIGURATION ts_conf - ALTER MAPPING FOR asciiword, asciihword, hword_asciipart, - word, hword, hword_part - WITH pg_dict, english_ispell, english_stem; - ``` - -5. In the text search configuration, set non-index or set the search for tokens of certain types. - - ``` - postgres=# ALTER TEXT SEARCH CONFIGURATION ts_conf - DROP MAPPING FOR email, url, url_path, sfloat, float; - ``` - -6. Use the text retrieval commissioning function ts\_debug\(\) to test the text search configuration **ts\_conf**. - - ``` - postgres=# SELECT * FROM ts_debug('ts_conf', ' - PostgreSQL, the highly scalable, SQL compliant, open source object-relational - database management system, is now undergoing beta testing of the next - version of our software. - '); - ``` - -7. You can set the default text search configuration of the current session to **ts\_conf**. This setting is valid only for the current session. - - ``` - postgres=# \dF+ ts_conf - Text search configuration "public.ts_conf" - Parser: "pg_catalog.default" - Token | Dictionaries - -----------------+------------------------------------- - asciihword | pg_dict,english_ispell,english_stem - asciiword | pg_dict,english_ispell,english_stem - file | simple - host | simple - hword | pg_dict,english_ispell,english_stem - hword_asciipart | pg_dict,english_ispell,english_stem - hword_numpart | simple - hword_part | pg_dict,english_ispell,english_stem - int | simple - numhword | simple - numword | simple - uint | simple - version | simple - word | pg_dict,english_ispell,english_stem - - postgres=# SET default_text_search_config = 'public.ts_conf'; - SET - postgres=# SHOW default_text_search_config; - default_text_search_config - ---------------------------- - public.ts_conf - (1 row) - ``` - - diff --git a/content/en/docs/installation/Developerguide/configuration-file-reference.md b/content/en/docs/installation/Developerguide/configuration-file-reference.md deleted file mode 100644 index 3d50bbdf5bf161e408227bbc9984e080f4c2251b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuration-file-reference.md +++ /dev/null @@ -1,133 +0,0 @@ -# Configuration File Reference - -**Table 1** Parameter description - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Value Range

-

local

-

Indicates that this record accepts only the Unix-domain-socket connection. If no such type of record exists, Unix-domain-socket connections are not allowed.

-

When gsql is used to initiate a connection from a local server and the -U parameter is not specified, a Unix-domain-socket connection is established.

-

-

-

host

-

Indicates that this record accepts either a common TCP/IP-socket connection or a TCP/IP-socket connection encrypted through SSL.

-

-

-

hostssl

-

Indicates that this record accepts only a TCP/IP socket connection encrypted through SSL.

-

For the connection encrypted through SSL, you need to apply for a digital certificate and configure related parameters. For details, see Establishing Secure TCP/IP Connections in SSL Mode.

-

hostnossl

-

Indicates that this record accepts only a common TCP/IP socket connection.

-

-

-

DATABASEGUC

-

Database that a record matches and can access

-
  • all: indicates that this record matches all databases.
  • sameuser: indicates that the database must have the same name as the user who requests database access.
  • samerole: indicates that this record matches a database if the user who requests the database is a member of a role having the same name as the database.
  • samegroup: is the same as that of samerole and indicates that this record matches a database if the user who requests the database is a member of a role having the same name as the database.
  • A file containing database names with an at sign (@) added before the file name, or a database list in a file using commas (,) or line feeds to separate databases
  • A specific database name or a list of databases separated by commas (,)
    NOTE:

    replication indicates that if a replication link is requested, the records match the link. But this does not mean the record matches any specific database. To use a database named replication, specify it in the database column.

    -
    -
-

USER

-

Users who match the record and are allowed to access databases

-
  • all: indicates that this record matches all users.
  • +User role: indicates that this record matches all members that directly or indirectly belong to the role.
    NOTE:

    + is a prefix character.

    -
    -
  • A file containing usernames, with an at sign (@) added before the file name. Users in the file are separated by commas (,) or line feeds.
  • A specific database username or a list of users separated by commas (,)
-

ADDRESS

-

Range of IP addresses that match the record and can be visited

-

IPv4 and IPv6 are supported. The IP address range can be expressed in the following two formats:

-
  • IP address/mask length Example: 10.10.0.0/24
  • IP address Subnet mask Example: 10.10.0.0 255.255.255.0
-
NOTE:

An IPv4 address matches the IPv6 connection with the corresponding address. For example, 127.0.0.1 matches IPv6 address ::ffff:127.0.0.1.

-
-

METHOD

-

Authentication method used for connection

-

The following authentication modes are supported. For details, see Table 2.

-
  • trust
  • reject
  • md5 (not recommended and not supported by default. This authentication mode can be configured using the password_encryption_type parameter.)
  • sha256
  • cert
  • gss (only for authentication within openGauss)
-
- -**Table 2** Authentication modes - - - - - - - - - - - - - - - - - - - - - - - - - -

Authentication Mode

-

Remarks

-

trust

-

In trust mode, only the connection initiated from the local server using gsql with the -U parameter not specified is trusted. In this case, no password is required.

-

The trust authentication mode applies to local connection of a single-user workstation, but not of a multi-user workstation. To use the trust authentication, you can use the file system permissions to control the access to the Unix-domain socket file on the server. You can use either of the following methods to control the access:

- -
NOTICE:

Setting the file system permission imposes restrictions on only Unix-domain socket connections, and does not affect local TCP/IP connections. To ensure local TCP/IP security, openGauss does not allow the trust authentication for remote connection.

-
-

reject

-

Rejects connection unconditionally. This authentication mode is usually used for filtering certain hosts.

-

md5

-

Requires that the client must provide an MD5-encrypted password for authentication.

-
NOTICE:

This authentication method is not recommended because MD5 is not a secure encryption algorithm and may cause network risks. openGauss retains MD5 authentication and password storage to facilitate use of third-party tools (such as the TPCC test tool).

-
-

sha256

-

Requires that the client must provide a sha256-encrypted password for authentication. The password is encrypted based on the unidirectional sha256 of salt (a random number sent from the server to the client) when being transmitted, enhancing the security.

-

cert

-

Client certificate authentication mode. In this mode, the SSL connection must be configured and the client must provide a valid SSL certificate. The user password is not required.

-
NOTICE:

This authentication mode supports only hostssl rules.

-
-

gss

-

Uses the GSSAPI-based Kerberos authentication.

-
NOTICE:
  • This authentication mode depends on components such as the Kerberos server. It supports only authentication for communication within openGauss. In the current version, Kerberos authentication cannot be used to connect to external clients.
  • Enabling Kerberos authentication within openGauss slows down the connection setup among nodes in openGauss. The performance of SQL operations during the setup is affected, but later operations are not.
-
-
- diff --git a/content/en/docs/installation/Developerguide/configuration-settings-functions.md b/content/en/docs/installation/Developerguide/configuration-settings-functions.md deleted file mode 100644 index cf760c95e5d38414ffa1e54594113cde4e318132..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuration-settings-functions.md +++ /dev/null @@ -1,39 +0,0 @@ -# Configuration Settings Functions - -Configuration setting functions are used for querying and modifying configuration parameters during running. - -- current\_setting\(setting\_name\) - - Description: Specifies the current setting. - - Return type: text - - Note: **current\_setting** obtains the current setting of **setting\_name** by query. It is equivalent to the **SHOW** statement. For example: - - ``` - postgres=# SELECT current_setting('datestyle'); - - current_setting - ----------------- - ISO, MDY - (1 row) - ``` - -- set\_config\(setting\_name, new\_value, is\_local\) - - Description: Sets the parameter and returns a new value. - - Return type: text - - Note: **set\_config** sets the parameter **setting\_name** to **new\_value**. If **is\_local** is **true**, the new value will only apply to the current transaction. If you want the new value to apply for the current session, use **false** instead. The function corresponds to the **SET** statement. For example: - - ``` - postgres=# SELECT set_config('log_statement_stats', 'off', false); - - set_config - ------------ - off - (1 row) - ``` - - diff --git a/content/en/docs/installation/Developerguide/configuration.md b/content/en/docs/installation/Developerguide/configuration.md deleted file mode 100644 index 92fc3738bcfa238af014eccfbede74d629fc3186..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuration.md +++ /dev/null @@ -1,7 +0,0 @@ -# Configuration - -- **[CONFIG\_SETTINGS](config_settings.md)** - -- **[GLOBAL\_CONFIG\_SETTINGS](global_config_settings.md)** - - diff --git a/content/en/docs/installation/Developerguide/configurations.md b/content/en/docs/installation/Developerguide/configurations.md deleted file mode 100644 index e88b4d8a3903c85adf4e7da3fec05e8bc0167241..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configurations.md +++ /dev/null @@ -1,15 +0,0 @@ -# Configurations - -Full text search functionality includes the ability to do many more things: skip indexing certain words \(stop words\), process synonyms, and use sophisticated parsing, for example, parse based on more than just white space. This functionality is controlled by text search configurations. openGauss comes with predefined configurations for many languages, and you can easily create your own configurations. \(The **\\dF** command of **gsql** shows all available configurations.\) - -During installation an appropriate configuration is selected and **default\_text\_search\_config** is set accordingly in **postgresql.conf**. If you are using the same text search configuration for openGauss, you can use the value in **postgresql.conf**. To use different configurations throughout openGauss but the same configuration within any one database, use ALTER DATABASE ... SET. Otherwise, you can set **default\_text\_search\_config** in each session. - -Each text search function that depends on a configuration has an optional argument, so that the configuration to use can be specified explicitly. **default\_text\_search\_config** is used only when this argument is omitted. - -To make it easier to build custom text search configurations, a configuration is built up from simpler database objects. openGauss's text search facility provides the following types of configuration-related database objects: - -- Text search parsers break documents into tokens and classify each token \(for example, as words or numbers\). -- Text search dictionaries convert tokens to normalized form and reject stop words. -- Text search templates provide the functions underlying dictionaries. \(A dictionary simply specifies a template and a set of parameters for the template.\) -- Text search configurations select a parser and a set of dictionaries to use to normalize the tokens produced by the parser. - diff --git a/content/en/docs/installation/Developerguide/configuring-a-data-source-in-the-linux-os.md b/content/en/docs/installation/Developerguide/configuring-a-data-source-in-the-linux-os.md deleted file mode 100644 index 5676f0ca66fe7c00e6495ff7c604d4e886043cb2..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-a-data-source-in-the-linux-os.md +++ /dev/null @@ -1,444 +0,0 @@ -# Configuring a Data Source in the Linux OS - -The ODBC driver \(psqlodbcw.so\) provided by openGauss can be used after it has been configured in a data source. To configure a data source, you must configure the **odbc.ini** and **odbcinst.ini** files on the server. The two files are generated during the unixODBC compilation and installation, and are saved in the **/usr/local/etc** directory by default. - -## Procedure - -1. Obtain the source code package of [unixODBC](http://sourceforge.net/projects/unixodbc/files/unixODBC/2.3.0/unixODBC-2.3.0.tar.gz/download). - -2. Install unixODBC. It does not matter if unixODBC of another version has been installed. - - Currently, unixODBC-2.2.1 is not supported. For example, to install unixODBC-2.3.0, run the commands below. unixODBC is installed in the **/usr/local** directory by default. The data source file is generated in the **/usr/local/etc** directory, and the library file is generated in the **/usr/local/lib** directory. - - ``` - tar zxvf unixODBC-2.3.0.tar.gz - cd unixODBC-2.3.0 - #Open the configure file. If it does not exist, open the configure.ac file. Find LIB_VERSION. - #Change the value of LIB_VERSION to 1:0:0 to compile a *.so.1 dynamic library with the same dependency on psqlodbcw.so. - vim configure - - ./configure --enable-gui=no #To perform compilation on a Kunpeng server, add the configure parameter --build=aarch64-unknown-linux-gnu. - make - #The installation may require root permissions. - make install - ``` - -3. Replace the openGauss driver on the client. - 1. Decompress **openGauss-**_1.0.0_**-ODBC.tar.gz** to the **/usr/local/lib** directory. **psqlodbcw.la** and **psqlodbcw.so** files are obtained. - 2. Copy the library in the **lib** directory obtained after decompressing **openGauss-**_1.0.0_**-ODBC.tar.gz** to the **/usr/local/lib** directory. - -4. Configure a data source. - 1. Configure the ODBC driver file. - - Add the following content to the end of the **/usr/local/etc/odbcinst.ini** file: - - ``` - [GaussMPP] - Driver64=/usr/local/lib/psqlodbcw.so - setup=/usr/local/lib/psqlodbcw.so - ``` - - For descriptions of the parameters in the **odbcinst.ini** file, see [Table 1](#en-us_topic_0237120407_en-us_topic_0059778464_td564f21e7c8e458bbd741b09896f5d91). - - **Table 1** odbcinst.ini configuration parameters - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Example

-

[DriverName]

-

Driver name, corresponding to the driver in DSN.

-

[DRIVER_N]

-

Driver64

-

Path of the dynamic driver library.

-

Driver64=/xxx/odbc/lib/psqlodbcw.so

-

setup

-

Driver installation path, which is the same as the dynamic library path in Driver64.

-

setup=/xxx/odbc/lib/psqlodbcw.so

-
- - 2. Configure the data source file. - - Add the following content to the end of the **/usr/local/etc/odbc.ini** file: - - ``` - [MPPODBC] - Driver=GaussMPP - Servername=10.10.0.13 (database server IP address) - Database=postgres (database name) - Username=omm (database username) - Password= (database user password) - Port=8000 (database listening port) - Sslmode=allow - ``` - - For descriptions of the parameters in the **odbc.ini** file, see [Table 2](#en-us_topic_0237120407_en-us_topic_0059778464_t55845a6555f2454297b64ce47ad3d648). - - **Table 2** odbc.ini configuration parameters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Example

-

[DSN]

-

Data source name

-

[MPPODBC]

-

Driver

-

Driver name, corresponding to DriverName in odbcinst.ini

-

Driver=DRIVER_N

-

Servername

-

Server IP address

-

Servername=10.145.130.26

-

Database

-

Name of the database to connect

-

Database=postgres

-

Username

-

Database username

-

Username=omm

-

Password

-

Database user password

-

Password=

-
NOTE:

After a user established a connection, the ODBC driver automatically clears their password stored in memory.

-

However, if this parameter is configured, UnixODBC will cache data source files, which may cause the password to be stored in the memory for a long time.

-

When you connect to an application, you are advised to send your password through an API instead of writing it in a data source configuration file. After the connection has been established, immediately clear the memory segment where your password is stored.

-
-

Port

-

Port number of the server

-

Port=8000

-

Sslmode

-

Whether to enable SSL

-

Sslmode=allow

-

UseServerSidePrepare

-

Whether to enable the extended query protocol for the database.

-

The value can be 0 or 1. The default value is 1, indicating that the extended query protocol is enabled.

-

UseServerSidePrepare=1

-

UseBatchProtocol

-

Whether to enable the batch query protocol. If it is enabled, DML performance can be improved. The value can be 0 or 1. The default value is 1.

-

If this parameter is set to 0, the batch query protocol is disabled (mainly for communication with earlier database versions).

-

If this parameter is set to 1 and support_batch_bind is set to on, the batch query protocol is enabled.

-

UseBatchProtocol=1

-

ConnectionExtraInfo

-

Whether to display the driver deployment path and process owner in the connection_info parameter mentioned in connection_info.

-

ConnectionExtraInfo=1

-
NOTE:

The default value is 0. If this parameter is set to 1, the ODBC driver reports the driver deployment path and process owner to the database and displays the information in the connection_info parameter (see connection_info). In this case, you can query the information from PG_STAT_ACTIVITY.

-
-
- - The valid values of **sslmode** are as follows: - - **Table 3** sslmode options and description - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

sslmode

-

Whether SSL Encryption Is Enabled

-

Description

-

disable

-

No

-

SSL connection is not enabled.

-

allow

-

Possible

-

If the database server requires SSL connection, SSL connection can be enabled. However, authenticity of the database server will not be verified.

-

prefer

-

Possible

-

If the database supports SSL connection, SSL connection is recommended. However, authenticity of the database server will not be verified.

-

require

-

Yes

-

SSL connection is required and data is encrypted. However, authenticity of the database server will not be verified.

-

verify-ca

-

Yes

-

SSL connection is required and whether the database has a trusted certificate will be verified.

-

verify-full

-

Yes

-

SSL connection is required. In addition to the check scope specified by verify-ca, the system checks whether the name of the host where the database resides is the same as that in the certificate. openGauss does not support this mode.

-
- -5. Generate an SSL certificate. For details, see [Generating Certificates](generating-certificates.md). -6. Replace an SSL certificate. For details, see [Replacing Certificates](replacing-certificates.md). -7. Configure the database server. - 1. Log in as the OS user **omm** to the primary node of the database. - 2. Run the following command to add NIC IP addresses or host names, with values separated by commas \(,\). The NICs and hosts are used to provide external services. In the following command, _NodeName_ specifies the name of the current node. - - ``` - gs_guc reload -N NodeName -I all -c "listen_addresses='localhost,192.168.0.100,10.11.12.13'" - ``` - - If direct routing of LVS is used, add the virtual IP address \(10.11.12.13\) of LVS to the server listening list. - - You can also set **listen\_addresses** to **\*** or **0.0.0.0** to listen to all NICs, but this incurs security risks and is not recommended. - - 3. Run the following command to add an authentication rule to the configuration file of the primary database node. In this example, the IP address \(10.11.12.13\) of the client is the remote host IP address. - - ``` - gs_guc reload -N all -I all -h "host all jack 10.11.12.13/32 sha256" - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- **-N all** indicates all hosts in openGauss. - >- **-I all** indicates all instances of the host. - >- **-h** specifies statements that need to be added in the **pg\_hba.conf** file. - >- **all** indicates that a client can connect to any database. - >- **jack** indicates the user that accesses the database. - >- **_10.11.12.13/__32_** indicates hosts whose IP address is 10.11.12.13 can be connected. Configure the parameter based on your network conditions. **32** indicates that there are 32 bits whose value is 1 in the subnet mask. That is, the subnet mask is 255.255.255.255. - >- **sha256** indicates that the password of user **jack** is encrypted using the SHA-256 algorithm. - - If the ODBC client and the primary database node to connect are deployed on the same machine, you can use the local trust authentication mode. Run the following command: - - ``` - local all all xxx.xxx.xxx.xxx/32 trust - ``` - - If the ODBC client and the primary database node to connect are deployed on different machines, use the SHA-256 authentication mode. Run the following command: - - ``` - host all all xxx.xxx.xxx.xxx/32 sha256 - ``` - - 4. Restart openGauss. - - ``` - gs_om -t stop - gs_om -t start - ``` - -8. Configure environment variables. - - ``` - vim ~/.bashrc - ``` - - Add the following information to the configuration file: - - ``` - export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH - export ODBCSYSINI=/usr/local/etc - export ODBCINI=/usr/local/etc/odbc.ini - ``` - -9. Run the following command to validate the addition: - - ``` - source ~/.bashrc - ``` - - -## Verifying the Data Source Configuration - -Run the **isql-v** _GaussODBC_ command \(**_GaussODBC_** is the data source name\). - -- If the following information is displayed, the configuration is correct and the connection succeeds. - - ``` - +---------------------------------------+ - | Connected! | - | | - | sql-statement | - | help [tablename] | - | quit | - | | - +---------------------------------------+ - SQL> - ``` - -- If error information is displayed, the configuration is incorrect. Check the configuration. - -## FAQs - -- \[UnixODBC\]\[Driver Manager\]Can't open lib 'xxx/xxx/psqlodbcw.so' : file not found. - - Possible causes: - - - The path configured in the **odbcinst.ini** file is incorrect. - - Run **ls** to check the path in the error information, and ensure that the **psqlodbcw.so** file exists and you have execute permissions on it. - - - The dependent library of **psqlodbcw.so** does not exist or is not in system environment variables. - - Run **ldd** to check the path in the error information. If **libodbc.so.1** or other UnixODBC libraries do not exist, configure UnixODBC again following the procedure provided in this section, and add the **lib** directory under its installation directory to **LD\_LIBRARY\_PATH**. If other libraries do not exist, add the **lib** directory under the ODBC driver package to **LD\_LIBRARY\_PATH**. - - -- \[UnixODBC\]connect to server failed: no such file or directory - - Possible causes: - - - An incorrect or unreachable database IP address or port number was configured. - - Check the **Servername** and **Port** configuration items in data sources. - - - Server monitoring is improper. - - If **Servername** and **Port** are correctly configured, ensure the proper network adapter and port are monitored by following the database server configurations in the procedure in this section. - - - Firewall and network gatekeeper settings are improper. - - Check firewall settings, and ensure that the database communication port is trusted. - - Check to ensure network gatekeeper settings are proper \(if any\). - - -- \[unixODBC\]The password-stored method is not supported. - - Possible causes: - - The **sslmode** configuration item is not configured in the data sources. - - Solution: - - Set the configuration item to **allow** or a higher level. For details, see [Table 3](#en-us_topic_0237120407_en-us_topic_0059778464_table22136585143846). - -- Server common name "xxxx" does not match host name "xxxxx" - - Possible causes: - - When **verify-full** is used for SSL encryption, the driver checks whether the host name in certificates is the same as the actual one. - - Solution: - - To solve this problem, use **verify-ca** to stop checking host names, or generate a set of CA certificates containing the actual host names. - -- Driver's SQLAllocHandle on SQL\_HANDLE\_DBC failed - - Possible causes: - - The executable file \(such as the **isql** tool of unixODBC\) and the database driver \(**psqlodbcw.so**\) depend on different library versions of ODBC, such as **libodbc.so.1** and **libodbc.so.2**. You can verify this problem by using the following method: - - ``` - ldd `which isql` | grep odbc - ldd psqlodbcw.so | grep odbc - ``` - - If the suffix digits of the outputs **libodbc.so** are different or indicate different physical disk files, this problem exists. Both **isql** and **psqlodbcw.so** load **libodbc.so**. If different physical files are loaded, different ODBC libraries with the same function list conflict with each other in a visible domain. As a result, the database driver cannot be loaded. - - Solution: - - Uninstall the unnecessary unixODBC, such as libodbc.so.2, and create a soft link with the same name and the .so.2 suffix for the remaining libodbc.so.1 library. - -- FATAL: Forbid remote connection with trust method! - - For security purposes, the primary database node forbids access from other nodes in openGauss without authentication. - - To access the primary database node from inside openGauss, deploy the ODBC program on the host where the primary database node is located and set the server address to **127.0.0.1**. It is recommended that the service system be deployed outside openGauss. If it is deployed inside, database performance may be affected. - -- \[unixODBC\]\[Driver Manager\]Invalid attribute value - - This problem occurs when you use SQL on other GaussDB. The possible cause is that the unixODBC version is not the recommended one. You are advised to run the **odbcinst --version** command to check the unixODBC version. - -- authentication method 10 not supported. - - If this error occurs on an open-source client, the cause may be: - - The database stores only the SHA-256 hash of the password, but the open-source client supports only MD5 hashes. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The database stores the hashes of user passwords instead of actual passwords. - >- If a password is updated or a user is created, both types of hashes will be stored, compatible with open-source authentication protocols. - >- An MD5 hash can only be generated using the original password, but the password cannot be obtained by reversing its SHA-256 hash. Passwords in the old version will only have SHA-256 hashes and not support MD5 authentication. - - To solve this problem, you can update the user password \(see [ALTER USER](alter-user.md)\) or create a user \(see [CREATE USER](create-user.md)\) having the same permissions as the faulty user. - -- unsupported frontend protocol 3.51: server supports 1.0 to 3.0 - - The database version is too early or the database is an open-source database. Use the driver of the required version to connect to the database. - -- FATAL: GSS authentication method is not allowed because XXXX user password is not disabled. - - In **pg\_hba.conf** of the target primary database node, the authentication mode is set to **gss** for authenticating the IP address of the current client. However, this authentication algorithm cannot authenticate clients. Change the authentication algorithm to **sha256** and try again. For details, see [7](#en-us_topic_0237120407_en-us_topic_0059778464_l4c0173b8af93447e91aba24005e368e5). - - diff --git a/content/en/docs/installation/Developerguide/configuring-a-remote-connection.md b/content/en/docs/installation/Developerguide/configuring-a-remote-connection.md deleted file mode 100644 index f211475904f6093fb9264a92a6ce2317c4e9d90d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-a-remote-connection.md +++ /dev/null @@ -1,41 +0,0 @@ -# Configuring a Remote Connection - -Before the remote connection, you need to enable the client to access the database and configure the remote connection on the server where the database primary node is deployed. - -## Procedure - -Perform the following steps on the host where openGauss resides. - -1. Log in as the OS user **omm** to the primary node of the database. -2. Configure the client authentication mode. For details, see [Configuring Client Access Authentication](configuring-client-access-authentication.md). -3. Configure **[listen\_addresses](connection-settings.md#en-us_topic_0237124695_en-us_topic_0059777636_sed0adde99a3f47669f5d4ab557b36b35)**. **listen\_addresses** indicates the IP address or host name of the database primary node used for remote client connection. - 1. Run the following command to check the **listen\_addresses** value of the database primary node: - - ``` - gs_guc check -I all -c "listen_addresses" - ``` - - Information similar to the following is displayed: - - ``` - expected guc information: plat1: listen_addresses=NULL: [/gaussdb/data/data_cn/postgresql.conf] - gs_guc check: plat1: listen_addresses='localhost, 192.168.0.100': [/gaussdb/data/data_cn/postgresql.conf] - - Total GUC values: 1. Failed GUC values: 0. - The value of parameter listen_addresses is same on all instances. - listen_addresses='localhost, 192.168.0.100' - ``` - - 2. Run the following command to append the IP addresses to be added to **listen\_addresses**. Use commas \(,\) to separate multiple IP addresses. For example, add the IP address 10.11.12.13. - - ``` - gs_guc set -I all -c "listen_addresses='localhost,192.168.0.100,10.11.12.13'" - ``` - -4. Run the following command to restart the openGauss: - - ``` - gs_om -t stop && gs_om -t start - ``` - - diff --git a/content/en/docs/installation/Developerguide/configuring-client-access-authentication.md b/content/en/docs/installation/Developerguide/configuring-client-access-authentication.md deleted file mode 100644 index 9c46bd6dd36d2c05d72b7609c4676b9947a7be86..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-client-access-authentication.md +++ /dev/null @@ -1,116 +0,0 @@ -# Configuring Client Access Authentication - -## Background - -If a host needs to connect to a database remotely, you need to add information about the host in configuration file of the database system and perform client access authentication. The configuration file \(**pg\_hba.conf** by default\) is stored in the data directory of the database. HBA is short for host-based authentication. - -- The system supports the following three authentication methods, which all require the **pg\_hba.conf** file. - - Host-based authentication: A server checks the configuration file based on the IP address, username, and target database of the client to determine whether the user can be authenticated. - - Password authentication: A password can be an encrypted password for remote connection or a non-encrypted password for local connection. - - SSL encryption: The OpenSSL is used to provide a secure connection between the server and the client. - -- In the **pg\_hba.conf** file, each record occupies one row and specifies an authentication rule. An empty row or a row started with a number sign \(\#\) is neglected. -- Each authentication rule consists of multiple columns separated by spaces and forward slashes \(/\), or spaces and tab characters. If a field is enclosed with quotation marks \("\), it can contain spaces. One record cannot span different rows. - -## Procedure - -1. Log in as the OS user **omm** to the primary node of the database. -2. Configure the client authentication mode and enable the client to connect to the host as user **jack**. User **omm** cannot be used for remote connection. - - Assume you are to allow the client whose IP address is **10.10.0.30** to access the current host. - - ``` - gs_guc set -N all -I all -h "host all jack 10.10.0.30/32 sha256" - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- Before using user **jack**, connect to the database locally and run the following command in the database to create user **jack**: - > ``` - > postgres=# CREATE USER jack PASSWORD 'Test@123'; - > ``` - >- **-N all** indicates all hosts in openGauss. - >- **-I all** indicates all instances on the host. - >- **-h** specifies statements that need to be added in the **pg\_hba.conf** file. - >- **all** indicates that a client can connect to any database. - >- **jack** indicates the user that accesses the database. - >- _10.10.0.30_/_32_ indicates that only the client whose IP address is **10.10.0.30** can connect to the host. The specified IP address must be different from those used in openGauss. **32** indicates that there are 32 bits whose value is 1 in the subnet mask. That is, the subnet mask is 255.255.255.255. - >- **sha256** indicates that the password of user **jack** is encrypted using the SHA-256 algorithm. - - -This command adds a rule to the **pg\_hba.conf** file corresponds to the primary node of the database. The rule is used to authenticate clients that access primary node. - -Each record in the **pg\_hba.conf** file can be in one of the following four formats. For parameter description of the four formats, see [Configuration File Reference](configuration-file-reference.md). - -``` -local DATABASE USER METHOD [OPTIONS] -host DATABASE USER ADDRESS METHOD [OPTIONS] -hostssl DATABASE USER ADDRESS METHOD [OPTIONS] -hostnossl DATABASE USER ADDRESS METHOD [OPTIONS] -``` - -During authentication, the system checks records in the **pg\_hba.conf** file in sequence for connection requests, so the record sequence is vital. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->Configure records in the **pg\_hba.conf** file from top to bottom based on communication and format requirements in the descending order of priorities. The IP addresses of the openGauss cluster and added hosts are of the highest priority and should be configured prior to those manually configured by users. If the IP addresses manually configured by users and those of added hosts are in the same network segment, delete the manually configured IP addresses before the scale-out and configure them after the scale-out. - -The suggestions on configuring authentication rules are as follows: - -- Records placed at the front have strict connection parameters but weak authentication methods. -- Records placed at the end have weak connection parameters but strict authentication methods. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- If a user wants to connect to a specified database, the user must be authenticated by the rules in the **pg\_hba.conf** file and have the **CONNECT** permission for the database. If you want to restrict a user from connecting to certain databases, you can grant or revoke the user's **CONNECT** permission, which is easier than setting rules in the **pg\_hba.conf** file. ->- The **trust** authentication mode is insecure for a connection between the openGauss and a client outside the cluster. In this case, set the authentication mode to **sha256**. - - -## Exception Handling - -There are many reasons for a user authentication failure. You can view an error message returned from a server to a client to determine the exact cause. [Table 1](#en-us_topic_0237121090_en-us_topic_0059778856_t451d737a3917467b9691ba1306766cdb) lists common error messages and solutions to these errors. - -**Table 1** Error messages - - - - - - - - - - - - - - - - -

Symptom

-

Solution

-

The username or password is incorrect.

-
FATAL: invalid username/password,login denied
-

Retry the authentication with the correct username and password.

-

The database to connect does not exist.

-
FATAL: database "TESTDB" does not exist
-

Retry the authentication with the correct database name.

-

No matched client record is found.

-
FATAL: no pg_hba.conf entry for host "10.10.0.60", user "ANDYM", database "TESTDB"
-

This message indicates that the server is connected but denies the connection request, because it does not find a matched record in pg_hba.conf. Contact the database administrator to add user information to the pg_hba.conf file.

-
- -## Example - -``` -TYPE DATABASE USER ADDRESS METHOD - -"local" is for Unix domain socket connections only -#Allow only the user specified by the -U parameter during installation to establish a connection from the local server. -local all all trust -IPv4 local connections: -#User omm is allowed to connect to any database from the 10.10.0.50 host. The SHA-256 algorithm is used to encrypt the password. -host all omm 10.10.0.50/32 sha256 -#Any user is allowed to connect to any database from a host on the 10.10.0.0/24 network segment. The SHA-256 algorithm is used to encrypt the password and SSL transmission is used. -hostssl all all 10.10.0.0/24 sha256 -#Any user is allowed to connect to any database from a host on the 10.10.0.0/24 network segment. The Kerberos authentication is used. In the current version, Kerberos authentication cannot be used to connect to external clients. -host all all 10.10.0.0/24 gss include_realm=1 krb_realm=HADOOP.COM -``` - diff --git a/content/en/docs/installation/Developerguide/configuring-database-audit.md b/content/en/docs/installation/Developerguide/configuring-database-audit.md deleted file mode 100644 index e34c367f27dbb79e1ff8a954617fbe29bd72da23..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-database-audit.md +++ /dev/null @@ -1,11 +0,0 @@ -# Configuring Database Audit - -- **[Overview](overview-2.md)** - -- **[Querying Audit Results](querying-audit-results.md)** - -- **[Maintaining Audit Logs](maintaining-audit-logs.md)** - -- **[Configuring File Permission Security Policies](configuring-file-permission-security-policies.md)** - - diff --git a/content/en/docs/installation/Developerguide/configuring-file-permission-security-policies.md b/content/en/docs/installation/Developerguide/configuring-file-permission-security-policies.md deleted file mode 100644 index 4d4a909cda2bdde8ed3469f90d41b12f0216a61d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-file-permission-security-policies.md +++ /dev/null @@ -1,176 +0,0 @@ -# Configuring File Permission Security Policies - -## Background - -During its installation, the database sets permissions for its files, including files \(such as log files\) generated during the running process. File permissions are set as follows: - -- The permission of program directories in the database is set to **0750**. -- The permission for data file directories in the database is set to **0700**. - - During openGauss deployment, the directory specified by the **tmpMppdbPath** parameter in the XML configuration file is created for storing **.s.PGSQL.\*** files. If the parameter is not specified, the **/tmp/**_$USER_**\_mppdb** directory is created. The directory and file permission is set to **0700**. - -- The permissions of data files and audit logs of the database, as well as data files generated by other database programs, are set to **0600**. The permission of run logs is equal to or lower than **0640** by default. -- Common OS users are not allowed to modify or delete database files and log files. - -## Directory and File Permissions of Database Programs - -[Table 1](#en-us_topic_0237121115_en-us_topic_0059779254_t0da233846f2544f39362bcf53de94799) lists some of program directories and file permissions of the installed database. - -**Table 1** Program directories and file permissions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

File or Directory

-

Parent Contents

-

Permissions

-

bin

-

-

-

0700

-

lib

-

-

-

0700

-

share

-

-

-

0700

-

data (database node/primary database node)

-

-

-

0700

-

base

-

Instance data directory

-

0700

-

global

-

Instance data directory

-

0700

-

pg_audit

-

Instance data directory (configurable)

-

0700

-

pg_log

-

Instance data directory (configurable)

-

0700

-

pg_xlog

-

Instance data directory

-

0700

-

postgresql.conf

-

Instance data directory

-

0600

-

pg_hba.conf

-

Instance data directory

-

0600

-

postmaster.opts

-

Instance data directory

-

0600

-

pg_ident.conf

-

Instance data directory

-

0600

-

gs_initdb

-

bin

-

0700

-

gs_dump

-

bin

-

0700

-

gs_ctl

-

bin

-

0700

-

gs_guc

-

bin

-

0700

-

gsql

-

bin

-

0700

-

archive_status

-

pg_xlog

-

0700

-

libpq.so.5.5

-

lib

-

0600

-
- -## Suggestion - -During the installation, the database automatically sets permissions for its files, including files \(such as log files\) generated during the running process. The specified permissions meet permission requirements in most scenarios. If you have any special requirements for the related permissions, you are advised to periodically check the permission settings to ensure that the permissions meet the product requirements. - diff --git a/content/en/docs/installation/Developerguide/configuring-llvm.md b/content/en/docs/installation/Developerguide/configuring-llvm.md deleted file mode 100644 index 69dedaa9f6c98ed60414b4dd7f5332bdc102c266..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-llvm.md +++ /dev/null @@ -1,13 +0,0 @@ -# Configuring LLVM - -Low Level Virtual Machine \(LLVM\) dynamic compilation can be used to generate customized machine code for each query to replace original common functions. Query performance is improved by reducing redundant judgment conditions and virtual function calls, and by making local data more accurate during actual queries. - -LLVM needs to consume extra time to pre-generate intermediate representation \(IR\) and compile it into codes. Therefore, if the data volume is small or if a query itself consumes less time, the performance deteriorates. - -- **[LLVM Application Scenarios and Restrictions](llvm-application-scenarios-and-restrictions.md)** - -- **[Other Factors Affecting LLVM Performance](other-factors-affecting-llvm-performance.md)** - -- **[Recommended Suggestions for LLVM](recommended-suggestions-for-llvm.md)** - - diff --git a/content/en/docs/installation/Developerguide/configuring-running-parameters.md b/content/en/docs/installation/Developerguide/configuring-running-parameters.md deleted file mode 100644 index bd57385926e1360ad69881196a7a171ef06970db..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/configuring-running-parameters.md +++ /dev/null @@ -1,7 +0,0 @@ -# Configuring Running Parameters - -- **[Viewing Parameter Values](viewing-parameter-values.md)** - -- **[Resetting Parameters](resetting-parameters.md)** - - diff --git a/content/en/docs/installation/Developerguide/confirming-connection-information.md b/content/en/docs/installation/Developerguide/confirming-connection-information.md deleted file mode 100644 index 3a959fe9cb6ff0a18df240dd8295954cf610acf3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/confirming-connection-information.md +++ /dev/null @@ -1,46 +0,0 @@ -# Confirming Connection Information - -You can use a client tool to connect to a database through the primary node of the database. Before the connection, obtain the IP address of the primary node of the database and the port number of the server where the primary node of the database is deployed. - -## Procedure - -1. Log in as the OS user **omm** to the primary node of the database. -2. Run the **gs\_om-t status--detail** command to query instances in the openGauss cluster. - - ``` - gs_om -t status --detail - ``` - - ``` - [ DBnode State ] - - node node_ip instance state - ----------------------------------------------------------------------------- - 1 plat1 192.168.0.11 5001 /srv/BigData/gaussdb/data1/dbnode Normal - ``` - - For example, the server IP addresses where the primary node of the database is deployed are 192.168.10.11. The data path of the primary node of the database is **/srv/BigData/gaussdb/data1/dbnode**. - -3. Confirm the port number of the primary node of the database. - - View the port number in the **postgresql.conf** file in the data path of the database primary node obtained in [2](#en-us_topic_0237120290_en-us_topic_0062129725_li736435692628). The command is as follows: - - ``` - cat /srv/BigData/gaussdb/data1/dbnode/postgresql.conf | grep port - ``` - - ``` - port = 8000 # (change requires restart) - #comm_sctp_port = 1024 # Assigned by installation (change requires restart) - #comm_control_port = 10001 # Assigned by installation (change requires restart) - # supported by the operating system: - # e.g. 'localhost=10.145.130.2 localport=12211 remotehost=10.145.130.3 remoteport=12212, localhost=10.145.133.2 localport=12213 remotehost=10.145.133.3 remoteport=12214' - # e.g. 'localhost=10.145.130.2 localport=12311 remotehost=10.145.130.4 remoteport=12312, localhost=10.145.133.2 localport=12313 remotehost=10.145.133.4 remoteport=12314' - # %r = remote host and port - alarm_report_interval = 10 - support_extended_features=true - ``` - - **8000** is the port number of the database primary node. - - diff --git a/content/en/docs/installation/Developerguide/connecting-to-a-database-0.md b/content/en/docs/installation/Developerguide/connecting-to-a-database-0.md deleted file mode 100644 index bd70d965e24f0e3b57505d7b7acfdc27317d682c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connecting-to-a-database-0.md +++ /dev/null @@ -1,140 +0,0 @@ -# Connecting to a Database - -After a database is connected, you can use JDBC to run SQL statements to operate data. - -## Function Prototype - -JDBC provides the following three database connection methods: - -- DriverManager.getConnection\(String url\); -- DriverManager.getConnection\(String url, Properties info\); -- DriverManager.getConnection\(String url, String user, String password\); - -## Parameter - -**Table 1** Database connection parameters - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

url

-

postgresql.jar database connection descriptor. The format is as follows:

-
  • jdbc:postgresql:database
  • jdbc:postgresql://host/database
  • jdbc:postgresql://host:port/database
  • jdbc:postgresql://host:port/database?param1=value1&param2=value2
  • jdbc:postgresql://host1:port1,host2:port2/database?param1=value1&param2=value2
-
NOTE:
  • database indicates the name of the database to connect.
  • host indicates the name or IP address of the database server.

    If a machine connected to openGauss is not in the same network segment as openGauss, the IP address specified by host should be the value of coo.cooListenIp2 (application access IP address) set in Manager.

    -

    For security purposes, the primary database node forbids access from other nodes in openGauss without authentication. To access the primary database node from inside openGauss, deploy the JDBC program on the host where the primary database node is located and set host to 127.0.0.1. Otherwise, the error message "FATAL: Forbid remote connection with trust method!" may be displayed.

    -

    It is recommended that the service system be deployed outside openGauss. If it is deployed inside, database performance may be affected.

    -

    By default, the local host is used to connect to the server.

    -
  • port indicates the port number of the database server.

    By default, the database on port 5431 of the local host is connected.

    -
  • param indicates a database connection attribute.

    The parameter can be configured in the URL. The URL starts with a question mark (?), uses an equal sign (=) to assign a value to the parameter, and uses an ampersand (&) to separate parameters. You can also use the attributes of the info object for configuration. For details, see the example below.

    -
  • value indicates the database connection attribute values.
-
-

info

-

Database connection attributes. Common attributes are described as follows:

-
  • PGDBNAME: string type. This parameter specifies the database name. (This parameter does not need to be set in the URL. The system automatically parses the URL to obtain its value.)
  • PGHOST: string type. This parameter specifies the host IP address. For details, see the example below.
  • PGPORT: integer type. This parameter specifies the host port number. For details, see the example below.
  • user: string type. This parameter specifies the database user who creates the connection.
  • password: string type. This parameter specifies the password of the database user.
  • loggerLevel: string type. The following log levels are supported: OFF, DEBUG, and TRACE. The value OFF indicates that the log function is disabled. DEBUG and TRACE logs record information of different levels.
  • loggerFile: string type. This parameter specifies the name of a log file. You can specify a directory for storing logs. If no directory is specified, logs are stored in the directory where the client program is running.
  • allowEncodingChanges: Boolean type. If this parameter is set to true, the character set type can be changed. This parameter is used together with characterEncoding=CHARSET to set the character set. The two parameters are separated by ampersands (&).
  • currentSchema: string type. This parameter specifies the schema to be set in search-path.
  • hostRecheckSeconds: integer type. After JDBC attempts to connect to a host, the host status is saved: connection success or connection failure. This status is trusted within the duration specified by hostRecheckSeconds. After the duration expires, the status becomes invalid. The default value is 10 seconds.
  • ssl: Boolean type. This parameter specifies a connection in SSL mode.

    When this parameter is set to true, the NonValidatingFactory channel and certificate mode are supported.

    -

    For the NonValidatingFactory channel, configure the username and password and set SSL to true.

    -

    In certification mode, configure the client certificate, key, and root certificate, and set SSL to true.

    -
  • sslmode: string type. This parameter specifies the SSL authentication mode. The value can be require, verify-ca, or verify-full.
    • require: The system attempts to set up an SSL connection. If there is a CA file, the system performs verification as if the parameter was set to verify-ca.
    • verify-ca: The system attempts to set up an SSL connection and checks whether the server certificate is issued by a trusted CA.
    • verify-full: The system attempts to set up an SSL connection, checks whether the server certificate is issued by a trusted CA, and checks whether the host name of the server is the same as that in the certificate.
    -
  • sslcert: string type. This parameter specifies the complete path of the certificate file. The type of the client and server certificates is End Entity.
  • sslkey: string type. This parameter specifies the complete path of the key file. You must run the following command to convert the client certificate to the DER format:
    openssl pkcs8 -topk8 -outform DER -in client.key -out client.key.pk8 -nocrypt
    -
  • sslrootcert: string type. This parameter specifies the name of the SSL root certificate. The root certificate type is CA.
  • sslpassword: string type. This parameter is provided for ConsoleCallbackHandler.
  • sslpasswordcallback: string type. This parameter specifies the class name of the SSL password provider. The default value is org.postgresql.ssl.jdbc4.LibPQFactory.ConsoleCallbackHandler.
  • sslfactory: string type. This parameter specifies the class name used by SSLSocketFactory to establish an SSL connection.
  • sslfactoryarg: string type. The value is an optional parameter of the constructor function of the sslfactory class and is not recommended.
  • sslhostnameverifier: string type. This parameter specifies the class name of the host name verifier. The interface must implement javax.net.ssl.HostnameVerifier. The default value is org.postgresql.ssl.PGjdbcHostnameVerifier.
  • loginTimeout: integer type. This parameter specifies the waiting time for establishing the database connection, in seconds.
  • connectTimeout: integer type. This parameter specifies the timeout duration for connecting to a server, in seconds. If the time taken to connect to a server exceeds the value specified, the connection is interrupted. If the value is 0, the timeout mechanism is disabled.
  • socketTimeout: integer type. This parameter specifies the timeout duration for a socket read operation, in seconds. If the time taken to read data from a server exceeds the value specified, the connection is closed. If the value is 0, the timeout mechanism is disabled.
  • cancelSignalTimeout: integer type. Cancel messages may cause a block. This parameter controls connectTimeout and socketTimeout in a cancel message, in seconds. The default value is 10 seconds.
  • tcpKeepAlive: Boolean type. This parameter is used to enable or disable TCP keepalive detection. The default value is false.
  • logUnclosedConnections: Boolean type. The client may leak a connection object because it does not call the connection object's close() method. These objects will be collected as garbage and finalized using the finalize() method. If the caller ignores this operation, this method closes the connection.
  • assumeMinServerVersion: string type. The client sends a request to set a floating point. This parameter specifies the version of the server to connect, for example, assumeMinServerVersion=9.0. This parameter can reduce the number of packets to send during connection setup.
  • ApplicationName: string type. This parameter specifies the name of the JDBC driver that is being connected. You can query the pg_stat_activity table on the primary database node to view information about the client that is being connected. The JDBC driver name is displayed in the application_name column. The default value is PostgreSQL JDBC Driver.
  • connectionExtraInfo: Boolean type. This parameter specifies whether the JDBC driver reports the driver deployment path and process owner to the database.

    The value can be true or false. The default value is false. If connectionExtraInfo is set to true, the JDBC driver reports the driver deployment path and process owner to the database and displays the information in the connection_info parameter. In this case, you can query the information from PG_STAT_ACTIVITY.

    -
  • autosave: string type. The value can be always, never, or conservative. The default value is never. This parameter specifies the action that the driver should perform upon a query failure. If autosave is set to always, the JDBC driver sets a savepoint before each query and rolls back to the savepoint if the query fails. If autosave is set to never, there is no savepoint. If autosave is set to conservative, a savepoint is set for each query. However, the system rolls back and retries only when there is an invalid statement.
  • protocolVersion: integer type. This parameter specifies the connection protocol version. Only version 3 is supported. Note: MD5 encryption is used when this parameter is set. You must use the following command to change the database encryption mode: gs_guc set -N all -I all -c "password_encryption_type=1". After openGauss is restarted, create a user that uses MD5 encryption to encrypt passwords. You must also change the client connection mode to md5 in the pg_hba.conf file. Log in as the new user (not recommended).
  • prepareThreshold: integer type. This parameter specifies the time when the parse statement is sent. The default value is 5. It takes a long time to parse an SQL statement for the first time, but a short time to parse SQL statements later because of cache. If a session runs an SQL statement multiple consecutive times and the number of execution times exceeds the value of prepareThreshold, JDBC does not send the parse command to the SQL statement.
  • preparedStatementCacheQueries: integer type. This parameter specifies the number of queries cached in each connection. The default value is 256. If more than 256 different queries are used in the prepareStatement() call, the least recently used query cache will be discarded. The value 0 indicates that the cache function is disabled.
  • preparedStatementCacheSizeMiB: integer type. This parameter specifies the maximum cache size of each connection, in MB. The default value is 5. If the size of the cached queries exceeds 5 MB, the least recently used query cache will be discarded. The value 0 indicates that the cache function is disabled.
  • databaseMetadataCacheFields: integer type. The default value is 65536. This parameter specifies the maximum cache size of each connection. The value 0 indicates that the cache function is disabled.
  • databaseMetadataCacheFieldsMiB: integer type. The default value is 5. This parameter specifies the maximum cache size of each connection, in MB. The value 0 indicates that the cache function is disabled.
  • stringtype: string type. The value can be false, unspecified, or varchar. The default value is varchar. This parameter specifies the type of the PreparedStatement parameter used by the setString() method. If stringtype is set to varchar, these parameters are sent to the server as varchar parameters. If stringtype is set to unspecified, these parameters are sent to the server as an untyped value, and the server attempts to infer their appropriate type.
  • batchMode: Boolean type. This parameter specifies whether to connect the database in batch mode.
  • fetchsize: integer type. This parameter specifies the default fetchsize for statements in the created connection.
  • reWriteBatchedInserts: Boolean type. During batch import, this parameter, if set to on, can combine N insertion statements into one: insert into TABLE_NAME values(values1, ..., valuesN), ..., (values1, ..., valuesN). To use this parameter, set batchMode to off.
  • unknownLength: integer type. The default value is Integer.MAX_VALUE. This parameter specifies the length of the unknown length type when the data of some postgresql types (such as TEXT) is returned by functions such as ResultSetMetaData.getColumnDisplaySize and ResultSetMetaData.getPrecision.
  • defaultRowFetchSize: integer type. This parameter specifies the number of rows read by fetch in ResultSet at a time. Limiting the number of rows read each time in a database access request can avoid unnecessary memory consumption, thereby avoiding out of memory exception. The default value is 0, indicating that all rows are obtained at a time in ResultSet. There is no negative value.
  • binaryTransfer: Boolean type. This parameter specifies whether data is sent and received in binary format. The default value is false.
  • binaryTransferEnable: string type. This parameter specifies the type for which binary transmission is enabled. Every two types are separated by commas (,). You can select either the OID or name, for example, binaryTransferEnable=Integer4_ARRAY,Integer8_ARRAY.

    For example, if the OID name is BLOB and the OID number is 88, you can configure the OID as follows:

    -

    binaryTransferEnable=BLOB or binaryTransferEnable=88

    -
  • binaryTransferDisEnable: string type. This parameter specifies the type for which binary transmission is disabled. Every two types are separated by commas (,). You can select either the OID or name. The value of this parameter overwrites the value of binaryTransferEnable.
  • blobMode: string type. This parameter sets the setBinaryStream method to assign values to different types of data. The value on indicates that values are assigned to blob data. The value off indicates that values are assigned to bytea data. The default value is on.
  • socketFactory: string type. This parameter specifies the name of the class used to create a socket connection with the server. This class must implement the javax.net.SocketFactory interface and define a constructor with no parameter or a single string parameter.
  • socketFactoryArg: string type. The value is an optional parameter of the constructor function of the socketFactory class and is not recommended.
  • receiveBufferSize: integer type. This parameter is used to set SO_RCVBUF on the connection stream.
  • sendBufferSize: integer type. This parameter is used to set SO_SNDBUF on the connection stream.
  • preferQueryMode: string type. The value can be extended, extendedForPrepared, extendedCacheEverything, or simple. This parameter specifies the query mode. In simple mode, the query is executed without parsing or binding. In extended mode, the query is executed and bound. The extendedForPrepared mode is used for prepared statement extension. In extendedCacheEverything mode, each statement is cached.
-

user

-

Database user.

-

password

-

Password of the database user.

-
- -## Examples - -``` -// The following code encapsulates database connection operations into an interface. The database can then be connected using an authorized username and a password. -public static Connection getConnect(String username, String passwd) - { - // Driver class. - String driver = "org.postgresql.Driver"; - // Database connection descriptor. - String sourceURL = "jdbc:postgresql://10.10.0.13:8000/postgres"; - Connection conn = null; - - try - { - // Load the driver. - Class.forName(driver); - } - catch( Exception e ) - { - e.printStackTrace(); - return null; - } - - try - { - // Create a connection. - conn = DriverManager.getConnection(sourceURL, username, passwd); - System.out.println("Connection succeed!"); - } - catch(Exception e) - { - e.printStackTrace(); - return null; - } - - return conn; - }; -// The following code uses the Properties object as a parameter to establish a connection. -public static Connection getConnectUseProp(String username, String passwd) - { - // Driver class. - String driver = "org.postgresql.Driver"; - // Database connection descriptor. - String sourceURL = "jdbc:postgresql://10.10.0.13:8000/postgres?"; - Connection conn = null; - Properties info = new Properties(); - - try - { - // Load the driver. - Class.forName(driver); - } - catch( Exception e ) - { - e.printStackTrace(); - return null; - } - - try - { - info.setProperty("user", username); - info.setProperty("password", passwd); - // Create a connection. - conn = DriverManager.getConnection(sourceURL, info); - System.out.println("Connection succeed!"); - } - catch(Exception e) - { - e.printStackTrace(); - return null; - } - - return conn; - }; -``` - diff --git a/content/en/docs/installation/Developerguide/connecting-to-a-database.md b/content/en/docs/installation/Developerguide/connecting-to-a-database.md deleted file mode 100644 index 2528c7b9c3e5a928b704f44e9ebcbec515e08eec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connecting-to-a-database.md +++ /dev/null @@ -1,16 +0,0 @@ -# Connecting to a Database - -Client tools used for connecting to a database include **gsql** and APIs \(such as **ODBC** and **JDBC**\). - -- **gsql** is a client tool provided by openGauss. As described in [Using gsql to Connect to a Database](using-gsql-to-connect-to-a-database.md), edit, and run SQL statements in an interactive manner. -- As described in [APIs](apis.md), standard databases, such as **ODBC** and **JDBC**, can be used to develop openGauss-based applications. - -- **[Confirming Connection Information](confirming-connection-information.md)** - -- **[Configuring a Remote Connection](configuring-a-remote-connection.md)** - -- **[Using gsql to Connect to a Database](using-gsql-to-connect-to-a-database.md)** - -- **[APIs](apis.md)** - - diff --git a/content/en/docs/installation/Developerguide/connecting-to-the-database-(using-ssl).md b/content/en/docs/installation/Developerguide/connecting-to-the-database-(using-ssl).md deleted file mode 100644 index 464b4116c00710734110045e0d66ebcb57a5a230..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connecting-to-the-database-(using-ssl).md +++ /dev/null @@ -1,136 +0,0 @@ -# Connecting to the Database \(Using SSL\) - -When establishing connections to the openGauss server using JDBC, you can enable SSL connections to encrypt client and server communications for security of sensitive data transmission on the Internet. This section describes how applications establish an SSL connection to openGauss using JDBC. To start the SSL mode, you must have the server certificate, client certificate, and private key files. For details on how to obtain these files, see related documents and commands of OpenSSL. - -## Configuring the Server - -The SSL mode requires a root certificate, a server certificate, and a private key. - -Perform the following operations \(assuming that the license files are saved in the data directory **/gaussdb/data/datanode** and the default file names are used\): - -1. Log in as the OS user **omm** to the primary node of the database. -2. Generate and import a certificate. - - Generate an SSL certificate. For details, see [Generating Certificates](generating-certificates.md). Copy the generated **server.crt**, **server.key**, and **cacert.pem** files to the data directory on the server. - - Run the following command to query the data directory of the database node. The instance column indicates the data directory. - - ``` - gs_om -t status --detail - ``` - - In the Unix OS, **server.crt** and **server.key** must deny the access from the external or any group. Run the following command to set this permission: - - ``` - chmod 0600 server.key - ``` - -3. Enable the SSL authentication mode. - - ``` - gs_guc set -D /gaussdb/data/datanode -c "ssl=on" - ``` - -4. Set client access authentication parameters. The IP address is the IP address of the host to be connected. - - ``` - gs_guc reload -D /gaussdb/data/datanode -h "hostssl all all 127.0.0.1/32 cert" - gs_guc reload -D /gaussdb/data/datanode -h "hostssl all all IP/32 cert" - ``` - - Clients on the **127.0.0.1/32** network segment can connect to openGauss servers in SSL mode. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >If **METHOD** is set to **cert** in the **pg\_hba.conf** file of the server, the client must use the username \(common name\) configured in the license file \(**client.crt**\) for the database connection. If **METHOD** is set to **md5** or **sha256**, there is no such a restriction. - -5. Configure the digital certificate parameters related to SSL authentication. - - The information following each command indicates operation success. - - ``` - gs_guc set -D /gaussdb/data/datanode -c "ssl_cert_file='server.crt'" - gs_guc set: ssl_cert_file='server.crt' - ``` - - ``` - gs_guc set -D /gaussdb/data/datanode -c "ssl_key_file='server.key'" - gs_guc set: ssl_key_file='server.key' - ``` - - ``` - gs_guc set -D /gaussdb/data/datanode -c "ssl_ca_file='cacert.pem'" - gs_guc set: ssl_ca_file='cacert.pem' - ``` - -6. Restart the database. - - ``` - gs_om -t stop && gs_om -t start - ``` - -7. Generate and upload a certificate file. - -## Configuring the Client - -To configure the client, perform the following steps: - -Upload the certificate files **client.key.pk8**, **client.crt**, and **cacert.pem** generated in [Configuring the Server](#en-us_topic_0237120382_en-us_topic_0213179127_en-us_topic_0189251215_en-us_topic_0059777633_s513e457bfaa24ce4b1a20a1f2322f9ae) to the client. - -## Example - -``` -import java.sql.Connection; -import java.util.Properties; -import java.sql.DriverManager; -import java.sql.Statement; -import java.sql.ResultSet; - -public class SSL{ - public static void main(String[] args) { - Properties urlProps = new Properties(); - String urls = "jdbc:postgresql://10.29.37.136:8000/postgres"; - - /** -* ================== Example 1: The NonValidatingFactory channel is used, and MTETHOD in the pg_hba.conf file is not cert. - */ -/* - urlProps.setProperty("sslfactory","org.postgresql.ssl.NonValidatingFactory"); - urlProps.setProperty("user", "world"); -//test@123 is the password specified when user CREATE USER world WITH PASSWORD 'test123@' is created. - urlProps.setProperty("password", "test@123"); - urlProps.setProperty("ssl", "true"); -*/ - /** -* ================== Example 2 - 5: Use a certificate. In the pg_hba.conf file, MTETHOD is cert. - */ - urlProps.setProperty("sslcert", "client.crt"); -// Client key in DER format - urlProps.setProperty("sslkey", "client.key.pk8"); - urlProps.setProperty("sslrootcert", "cacert.pem"); - urlProps.setProperty("user", "world"); - /* ================== Example 2: Set ssl to true to use the certificate for authentication.*/ - urlProps.setProperty("ssl", "true"); - /* ================== Example 3: Set sslmode to require to use the certificate for authentication. */ -// urlProps.setProperty("sslmode", "require"); - /* ================== Example 4: Set sslmode to verify-ca to use the certificate for authentication. */ -// urlProps.setProperty("sslmode", "verify-ca"); - /* ================== Example 5: Set sslmode to verify-full to use the certificate (in the Linux OS) for authentication. */ -// urls = "jdbc:postgresql://world:8000/postgres"; -// urlProps.setProperty("sslmode", "verify-full"); - - try { - Class.forName("org.postgresql.Driver").newInstance(); - } catch (Exception e) { - e.printStackTrace(); - } - try { - Connection conn; - conn = DriverManager.getConnection(urls,urlProps); - conn.close(); - } catch (Exception e) { - e.printStackTrace(); - } - } -} -``` - diff --git a/content/en/docs/installation/Developerguide/connection-and-authentication.md b/content/en/docs/installation/Developerguide/connection-and-authentication.md deleted file mode 100644 index a14aa0d1eebe7970a2109ad1662a1886a042f1da..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connection-and-authentication.md +++ /dev/null @@ -1,7 +0,0 @@ -# Connection and Authentication - -- **[Connection Settings](connection-settings.md)** - -- **[Security and Authentication \(postgresql.conf\)](security-and-authentication_postgresql-conf.md)** - -- **[Communication Library Parameters](communication-library-parameters.md)** diff --git a/content/en/docs/installation/Developerguide/connection-characters.md b/content/en/docs/installation/Developerguide/connection-characters.md deleted file mode 100644 index 37ae9ef4758c59b9597afda94a590502f1329152..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connection-characters.md +++ /dev/null @@ -1,88 +0,0 @@ -# Connection Characters - -**Table 1** Connection strings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Character String

-

Description

-

host

-

Name of the host to connect to. If the host name starts with a slash (/), Unix-domain socket communications instead of TCP/IP communications are used. The value is the directory where the socket file is stored. If host is not specified, the default behavior is to connect to the Unix-domain socket in the /tmp directory (or the socket directory specified during GaussDB installation). On a machine without a Unix-domain socket, the default behavior is to connect to localhost.

-

hostaddr

-

IP address of the host to connect to. The value is in standard IPv4 address format, for example, 172.28.40.9. If your machine supports IPv6, IPv6 address can also be used. If a non-null string is specified, TCP/IP communications are used.

-

Replacing host with hostaddr can prevent applications from querying host names, which may be important for applications with time constraints. However, a host name is required for GSSAPI or SSPI authentication methods. Therefore, the following rules are used:

-
  1. If host is specified but hostaddr is not, a query for the host name will be executed.
  2. If hostaddr is specified but host is not, the value of hostaddr is the server network address. If the host name is required by authentication, the connection attempt fails.
  3. If both host and hostaddr are specified, the value of hostaddr is the server network address. The value of host is ignored unless it is required by authentication, in which case it is used as the host name.
    NOTICE:
    • If host is not the server name in the network address specified by hostaddr, the authentication may fail.
    • If neither host nor hostaddr is specified, libpq will use a local Unix-domain socket for connection. If the machine does not have a Unix-domain socket, it will attempt to connect to localhost.
    -
    -
-

port

-

Port number of the host server, or the socket file name extension for Unix-domain connections.

-

user

-

Name of the user to connect as. By default, the username is the same as the operating system name of the user running the application.

-

dbname

-

Database name. The default value is the same as the username.

-

password

-

Password to be used if the server requires password authentication.

-

connect_timeout

-

Maximum timeout period of the connection, in seconds (in decimal integer string). The value 0 or null indicates infinity. You are not advised to set the connection timeout period to a value less than 2 seconds.

-

client_encoding

-

Client encoding for the connection. In addition to the values accepted by the corresponding server options, you can use auto to determine the correct encoding from the current environment in the client (the LC_CTYPE environment variable in the Unix system).

-

options

-

Adds command-line options to send to the server at runtime.

-

application_name

-

Current user identity.

-

keepalives

-

Whether TCP keepalive is enabled on the client side. The default value is 1, indicating that the function is enabled. The value 0 indicates that the function is disabled. Ignore this parameter for Unix-domain connections.

-

keepalives_idle

-

The number of seconds of inactivity after which TCP should send a keepalive message to the server. The value 0 indicates that the default value is used. Ignore this parameter for Unix-domain connections or if keep-alive is disabled.

-

keepalives_interval

-

The number of seconds after which a TCP keepalive message that is not acknowledged by the server should be retransmitted. The value 0 indicates that the default value is used. Ignore this parameter for Unix-domain connections or if keep-alive is disabled.

-

keepalives_count

-

Adds command-line options to send to the server at runtime. For example, adding -c comm_debug_mode=off to set the value of the GUC parameter comm_debug_mode to off.

-
- diff --git a/content/en/docs/installation/Developerguide/connection-pool-parameters.md b/content/en/docs/installation/Developerguide/connection-pool-parameters.md deleted file mode 100644 index 43930af86ac3dac6e64f3a944f10235965edf254..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connection-pool-parameters.md +++ /dev/null @@ -1,37 +0,0 @@ -# Connection Pool Parameters - -When a connection pool is used to access the database, database connections are established and then stored in the memory as objects during system running. When you need to access the database, no new connection is established. Instead, an existing idle connection is selected from the connection pool. After you finish accessing the database, the database does not disable the connection but puts it back into the connection pool. The connection can be used for the next access request. - -## pooler\_maximum\_idle\_time - -**Parameter description**: Specifies the maximum amount of time that the connections can remain idle in a pool before being removed. After that, the automatic connection clearing mechanism is triggered to reduce the number of connections on each node to the value of **minimum\_pool\_size**. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 0 to _INT\_MAX_. The smallest unit is m. - -**Default value**: **1h** \(60 minutes\) - -## minimum\_pool\_size - -**Parameter description**: Specifies the minimum number of remaining connections in the pool on each node after the automatic connection clearing is triggered. If this parameter is set to **0**, the automatic connection clearing is disabled. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: an integer ranging from 1 to 65535 - -**Default value**: **200** - -## cache\_connection - -**Parameter description**: Specifies whether to reclaim the connections of a connection pool. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 2](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t290c8f15953843db8d8e53d867cd893d). - -**Value range**: Boolean - -- **on** indicates that the connections of a connection pool will be reclaimed. -- **off** indicates that the connections of a connection pool will not be reclaimed. - -**Default value**: **on** - diff --git a/content/en/docs/installation/Developerguide/connection-settings.md b/content/en/docs/installation/Developerguide/connection-settings.md deleted file mode 100644 index cb4b00d00eb66eb74119cdaa2e72669959dbe78e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/connection-settings.md +++ /dev/null @@ -1,143 +0,0 @@ -# Connection Settings - -This section describes parameters related to client-server connection modes. - -## listen\_addresses - -**Parameter description**: Specifies the TCP/IP addresses that a server listens to for connections from the client. This parameter specifies the IP address used by the openGauss server to listen on, such as IPv4 address or IPv6 address(if supported). A server may have multiple NICs, and each NIC can be bound with multiple IP address. This parameter specifies the IP addresses which the openGauss server is bound. And the client can use the IP address specified in this parameter to connect to openGauss or send requests to openGauss. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: - -- Host name or IP address. Multiple values are separated with commas \(,\). -- Asterisk \(\*\) or **0.0.0.0**, indicating that all IP addresses will be listened to, which is not recommended due to potential security risks. This parameter must be used together with valid addresses \(for example, the local IP address\). Otherwise, the build may fail. -- If the parameter is not specified, the server does not listen to any IP address. In this case, only Unix domain sockets can be used for database connections. - -**Default value**: **localhost** - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->**localhost** indicates that only local loopback is allowed. - -## local\_bind\_address - -**Parameter description**: Specifies the host IP address bound to the current node for connecting to other nodes in openGauss. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Default value**: **0.0.0.0** \(The actual value is specified in the configuration file during installation.\) - -## port - -**Parameter description**: Specifies the TCP port listened to by openGauss. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to 65535 - -**Default value**: **5432** \(The actual value is specified in the configuration file during installation.\) - -## max\_connections - -**Parameter description**: Specifies the maximum number of concurrent connections to the database. This parameter influences the concurrent processing capability of openGauss. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to 262143 - -**Default value**: **5000** for each database node If the default value is greater than the maximum number supported by the kernel \(determined when the **gs\_initdb** command is executed\), an error message is displayed. - -**Setting suggestions**: - -Retain the default value of this parameter on the primary node of the database. - -If this parameter is set to a large value, openGauss requires more System V shared memories or semaphores, which may exceed the default maximum configuration of the OS. In this case, modify the value as needed. - -## sysadmin\_reserved\_connections - -**Parameter description**: Specifies the minimum number of connections reserved for administrators. You are advised not to set this parameter to a large value. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to _MIN_ \(which takes the smaller value between **262143** and **max\_connections**\) - -**Default value**: **3** - -## unix\_socket\_directory - -**Parameter description**: Specifies the Unix domain socket directory that the openGauss server listens to for connections from the client. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -The parameter length limit varies by OS. If the length is exceeded, the error "Unix-domain socket path xxx is too long" will be reported. - -**Value range**: a string - -**Default value**: empty. The actual value is specified by the configuration file during installation. - -## unix\_socket\_group - -**Parameter description**: Specifies the group of the Unix domain socket \(the user of a socket is the user that starts the server\). This parameter can work with **[unix\_socket\_permissions](#en-us_topic_0237124695_en-us_topic_0059777636_s09d0cf55124b4f1aa3d401d18b9b4151)** to control socket access. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string. If this parameter is set to an empty string, the default group of the current user is used. - -**Default value**: empty - -## unix\_socket\_permissions - -**Parameter description**: Specifies access permissions for the Unix domain socket. - -The Unix domain socket uses the usual permission set of the Unix file system. The value of this parameter should be a number \(acceptable for the **chmod** and **umask** commands\). If a user-defined octal format is used, the number must start with 0. - -You are advised to set it to **0770** \(only allowing access from users connecting to the database and users in the same group as them\) or **0700** \(only allowing access from users connecting to the database\). - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: 0000 to 0777 - -**Default value**: **0700** - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->In the Linux OS, a document has one document attribute and nine permission attributes, which consists of the read \(r\), write \(w\), and execute \(x\) permissions of the Owner, Group, and Others groups. ->The r, w, and x permissions are represented by the following numbers: ->r: 4 ->w: 2 ->x: 1 ->-: 0 ->The three attributes in a group are accumulative. ->For example, **-rwxrwx---** indicates the following permissions: ->owner = rwx = 4+2+1 = 7 ->group = rwx = 4+2+1 = 7 ->others = --- = 0+0+0 = 0 ->The permission of the file is 0770. - -## application\_name - -**Parameter description**: Specifies the client name used in the current connection request. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -**Default value**: empty \(The actual value is the name of the application connected to the backend.\) - -## connection\_info - -**Parameter description**: Specifies the database connection information, including the driver type, driver version, driver deployment path, and process owner. - -This parameter is a USERSET parameter used for O&M. You are advised not to change the parameter value. - -**Value range**: a string - -**Default value**: empty - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- An empty string indicates that the driver connected to the database does not support automatic setting of the **connection\_info** parameter or the parameter is not set by users in applications. ->- The following is an example of the concatenated value of **connection\_info**: -> ``` -> {"driver_name":"ODBC","driver_version": "(GaussDB Kernel V500R001C00 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131 debug","driver_path":"/usr/local/lib/psqlodbcw.so","os_user":"omm"} -> ``` -> **driver\_name** and **driver\_version** are displayed by default. Whether **driver\_path** and **os\_user** are displayed is determined by users. For details, see [Connecting to a Database](connecting-to-a-database-0.md) and [Configuring a Data Source in the Linux OS](configuring-a-data-source-in-the-linux-os.md). - diff --git a/content/en/docs/installation/Developerguide/constant-and-macro.md b/content/en/docs/installation/Developerguide/constant-and-macro.md deleted file mode 100644 index 1975af63547f35e631b2a987a710ae3617d69472..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/constant-and-macro.md +++ /dev/null @@ -1,113 +0,0 @@ -# Constant and Macro - -[Table 1](#en-us_topic_0237121963_en-us_topic_0059778360_en-us_topic_0058965862_table49126904) lists the constants and macros that can be used in openGauss. - -**Table 1** Constant and macro - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Example

-

CURRENT_CATALOG

-

Specifies the current database.

-
postgres=# SELECT CURRENT_CATALOG;
-current_database
-------------------
-postgres
-(1 row)
-

CURRENT_ROLE

-

Specifies the current user.

-
postgres=# SELECT CURRENT_ROLE;
-current_user
---------------
-omm
-(1 row)
-

CURRENT_SCHEMA

-

Specifies the current database mode.

-
postgres=# SELECT CURRENT_SCHEMA;
-current_schema
-----------------
-public
-(1 row)
-

CURRENT_USER

-

Specifies the current user.

-
postgres=# SELECT CURRENT_USER;
-current_user
---------------
-omm
-(1 row)
-

LOCALTIMESTAMP

-

Specifies the current session time (without time zone).

-
postgres=# SELECT LOCALTIMESTAMP;
-         timestamp
-----------------------------
-2015-10-10 15:37:30.968538
-(1 row)
-

NULL

-

This parameter is left blank.

-

N/A

-

SESSION_USER

-

Specifies the current system user.

-
postgres=# SELECT SESSION_USER;
-session_user
---------------
-omm
-(1 row)
-

SYSDATE

-

Specifies the current system date.

-
postgres=# SELECT SYSDATE;
-sysdate
----------------------
-2015-10-10 15:48:53
-(1 row)
-

USER

-

Specifies the current user, also called CURRENT_USER.

-
postgres=# SELECT USER;
-current_user
---------------
-omm
-(1 row)
-
- diff --git a/content/en/docs/installation/Developerguide/constraints-on-index-use.md b/content/en/docs/installation/Developerguide/constraints-on-index-use.md deleted file mode 100644 index a684bbf7e9d8d90f3b7d2b08a6ecfd25e0d502db..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/constraints-on-index-use.md +++ /dev/null @@ -1,37 +0,0 @@ -# Constraints on Index Use - -The following is an example of index use: - -``` -postgres=# create table table1 (c_int int,c_bigint bigint,c_varchar varchar,c_text text) with(orientation=row); - -postgres=# create text search configuration ts_conf_1(parser=POUND); -postgres=# create text search configuration ts_conf_2(parser=POUND) with(split_flag='%'); - -postgres=# set default_text_search_config='ts_conf_1'; -postgres=# create index idx1 on table1 using gin(to_tsvector(c_text)); - -postgres=# set default_text_search_config='ts_conf_2'; -postgres=# create index idx2 on table1 using gin(to_tsvector(c_text)); - -postgres=# select c_varchar,to_tsvector(c_varchar) from table1 where to_tsvector(c_text) @@ plainto_tsquery('¥#@...&**') and to_tsvector(c_text) @@ plainto_tsquery('Company ') and c_varchar is not null order by 1 desc limit 3; -``` - -In this example, **table1** has two GIN indexes created on the same column **c\_text**, **idx1** and **idx2**, but these two indexes are created under different settings of [default\_text\_search\_config](zone-and-formatting.md#en-us_topic_0237124733_en-us_topic_0059778109_sd9a07d429cd4498383931c621742b816). Differences between this example and the scenario where one table has common indexes created on the same column are as follows: - -- GIN indexes use different parsers \(that is, different delimiters\). In this case, the index data of **idx1** is different from that of **idx2**. -- In the specified scenario, the index data of multiple common indexes created on the same column is the same. - -As a result, using **idx1** and **idx2** for the same query returns different results. - -## Constraints - -Still use the above example. When: - -- Multiple GIN indexes are created on the same column of the same table. -- The GIN indexes use different parsers \(that is, different delimiters\). -- The column is used in a query, and an index scan is used in the execution plan. - - To avoid different query results caused by different GIN indexes, ensure that only one GIN index is available on a column of the physical table. - - diff --git a/content/en/docs/installation/Developerguide/control-statements.md b/content/en/docs/installation/Developerguide/control-statements.md deleted file mode 100644 index e22f2e0ac7a810fdacdb61435818a69c0a553f95..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/control-statements.md +++ /dev/null @@ -1,17 +0,0 @@ -# Control Statements - -- **[RETURN Statements](return-statements.md)** - -- **[Conditional Statements](conditional-statements.md)** - -- **[Loop Statements](loop-statements.md)** - -- **[Branch Statements](branch-statements.md)** - -- **[NULL Statements](null-statements.md)** - -- **[Error Trapping Statements](error-trapping-statements.md)** - -- **[GOTO Statements](goto-statements.md)** - - diff --git a/content/en/docs/installation/Developerguide/controlling-text-search.md b/content/en/docs/installation/Developerguide/controlling-text-search.md deleted file mode 100644 index 6c1a7aaeac00503f486b0bfb58f63f5af0df8496..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/controlling-text-search.md +++ /dev/null @@ -1,11 +0,0 @@ -# Controlling Text Search - -- **[Parsing Documents](parsing-documents.md)** - -- **[Parsing Queries](parsing-queries.md)** - -- **[Ranking Search Results](ranking-search-results.md)** - -- **[Highlighting Results](highlighting-results.md)** - - diff --git a/content/en/docs/installation/Developerguide/controlling-transactions.md b/content/en/docs/installation/Developerguide/controlling-transactions.md deleted file mode 100644 index 44b97d3621771a4b82b2af93db095a0fc3abdc5a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/controlling-transactions.md +++ /dev/null @@ -1,23 +0,0 @@ -# Controlling Transactions - -A transaction is a user-defined sequence of database operations, which form an integral unit of work. - -## Starting a Transaction - -openGauss starts a transaction using **START TRANSACTION** and **BEGIN**. For details, see [START TRANSACTION](start-transaction.md) and [BEGIN](begin.md). - -## Setting a Transaction - -openGauss sets a transaction using **SET TRANSACTION** or **SET LOCAL TRANSACTION**. For details, see [SET TRANSACTION](set-transaction.md). - -## Committing a Transaction - -openGauss commits all operations of a transaction using **COMMIT** or **END**. For details, see [COMMIT | END](commit-end.md). - -## Rolling Back a Transaction - -If a fault occurs during a transaction and the transaction cannot proceed, the system performs rollback to cancel all the completed database operations related to the transaction. See [ROLLBACK](rollback.md). - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If an execution request \(not in a transaction block\) received in the database contains multiple statements, the request is packed into a transaction. If one of the statements fails, the entire request will be rolled back. - diff --git a/content/en/docs/installation/Developerguide/converting-a-disk-table-into-an-mot-table.md b/content/en/docs/installation/Developerguide/converting-a-disk-table-into-an-mot-table.md deleted file mode 100644 index ab0560c86775c89a1f38d1eb77d1d5e92ad5dbfc..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/converting-a-disk-table-into-an-mot-table.md +++ /dev/null @@ -1,110 +0,0 @@ -# Converting a Disk Table into an MOT Table - -The direct conversion of disk tables into MOT tables is not yet possible, meaning that no ALTER TABLE statement yet exists that converts a disk-based table into an MOT table. - -The following describes how to manually perform a few steps in order to convert a disk-based table into an MOT table, as well as how the **gs\_dump** tool is used to export data and the **gs\_restore** tool is used to import data. - -## Prerequisite Check - -Check that the schema of the disk table to be converted into an MOT table contains all required columns. - -Check whether the schema contains any unsupported column data types, as described in the Unsupported Data Types_ _section. - -If a specific column is not supported, then it is recommended to first create a secondary disk table with an updated schema. This schema is the same as the original table, except that all the unsupported types have been converted into supported types. - -Afterwards, use the following script to export this secondary disk table and then import it into an MOT table. - -## Converting - -To covert a disk-based table into an MOT table, perform the following – - -1. Suspend application activity. -2. Use **gs\_dump** tool to dump the table’s data into a physical file on disk. Make sure to use the **data only**. -3. Rename your original disk-based table. -4. Create an MOT table with the same table name and schema. Make sure to use the create FOREIGN keyword to specify that it will be an MOT table. -5. Use **gs\_restore** to load/restore data from the disk file into the database table. -6. Visually/manually verify that all the original data was imported correctly into the new MOT table. An example is provided below. -7. Resume application activity. - -**IMPORTANT Note** **–** In this way, since the table name remains the same, application queries and relevant database stored-procedures will be able to access the new MOT table seamlessly without code changes. Please note that MOT does not currently support cross-engine multi-table queries \(such as by using Join, Union and sub-query\) and cross-engine multi-table transactions. Therefore, if an original table is accessed somewhere in a multi-table query, stored procedure or transaction, you must either convert all related disk-tables into MOT tables or alter the relevant code in the application or the database. - -## Conversion Example - -Let's say that you have a database name **benchmarksql** and a table named **customer** \(which is a disk-based table\) to be migrated it into an MOT table. - -To migrate the customer table into an MOT table, perform the following – - -1. Check your source table column types. Verify that all types are supported by MOT, refer to section _Unsupported Data Types_. - - ``` - benchmarksql-# \d+ customer - Table "public.customer" - Column | Type | Modifiers | Storage | Stats target | Description - --------+---------+-----------+---------+--------------+------------- - x | integer | | plain | | - y | integer | | plain | | - Has OIDs: no - Options: orientation=row, compression=no - ``` - -2. Check your source table data. - - ``` - benchmarksql=# select * from customer; - x | y - ---+--- - 1 | 2 - 3 | 4 - (2 rows) - ``` - -3. Dump table data only by using **gs\_dump**. - - ``` - $ gs_dump -Fc benchmarksql -a --table customer -f customer.dump - gs_dump[port='15500'][benchmarksql][2020-06-04 16:45:38]: dump database benchmarksql successfully - gs_dump[port='15500'][benchmarksql][2020-06-04 16:45:38]: total time: 332 ms - ``` - -4. Rename the source table name. - - ``` - benchmarksql=# alter table customer rename to customer_bk; - ALTER TABLE - ``` - -5. Create the MOT table to be exactly the same as the source table. - - ``` - benchmarksql=# create foreign table customer (x int, y int); - CREATE FOREIGN TABLE - benchmarksql=# select * from customer; - x | y - ---+--- - (0 rows) - ``` - -6. Import the source dump data into the new MOT table. - - ``` - $ gs_restore -C -d benchmarksql customer.dump - restore operation successful - total time: 24 ms - Check that the data was imported successfully. - benchmarksql=# select * from customer; - x | y - ---+--- - 1 | 2 - 3 | 4 - (2 rows) - - benchmarksql=# \d - List of relations - Schema | Name | Type | Owner | Storage - --------+-------------+---------------+--------+---------------------------------- - public | customer | foreign table | aharon | - public | customer_bk | table | aharon | {orientation=row,compression=no} - (2 rows) - ``` - - diff --git a/content/en/docs/installation/Developerguide/copy.md b/content/en/docs/installation/Developerguide/copy.md deleted file mode 100644 index 2da5b6c3b7b38164f004d697584941a4b1a9f69a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/copy.md +++ /dev/null @@ -1,615 +0,0 @@ -# COPY - -## Function - -**COPY** copies data between tables and files. - -**COPY FROM** copies data from a file to a table, and **COPY TO** copies data from a table to a file. - -## Precautions - -- To run the **COPY FROM FILENAME** or **COPY TO FILENAME** statement, you must have the **SYSADMIN** permission. By default, user **SYSADMIN** is not allowed to run the **COPY FROM FILENAME** or **COPY TO FILENAME** statement on database configuration files, key files, certificate files, and audit logs, preventing user **SYSADMIN** from viewing or modifying sensitive files without authorization. To grant the permission, you need to change the setting of **enable\_copy\_server\_files**. -- **COPY** applies only to tables but not views. -- To insert data to a table, you must have the permission to insert data. -- If a list of columns is specified, **COPY** copies only the data of the specified columns between the file and the table. If a table has any columns that are not in the column list, **COPY FROM** inserts default values for those columns. -- If a data source file is specified, the server must be able to access the file. If **STDIN** is specified, data flows between the client and the server. When entering data, use the **TAB** key to separate the columns of the table and use a backslash and a period \(\\.\) in a new row to indicate the end of the input. -- **COPY FROM** throws an error if any row in the data file contains more or fewer columns than expected. -- The end of the data can be represented by a line that contains only a backslash and a period \(\\.\). If data is read from a file, the end flag is unnecessary. If data is copied between client applications, an end tag must be provided. -- In **COPY FROM**, **\\N** is an empty string. To enter the actual value **\\N**, use **\\\\N**. - -- **COPY FROM** does not support data preprocessing during data import, such as expression operation and default value filling. If you need to preprocess data during the import, you need to import the data to a temporary table and then run SQL statements to insert the data to the table through operations. However, this method causes I/O expansion and reduces the import performance. -- When a data format error occurs during **COPY FROM** execution, the transaction is rolled back. However, the error information is insufficient, making it difficult to locate the error data from a large amount of raw data. -- **COPY FROM** and **COPY TO** apply to low concurrency and local import and export of a small amount of data. - -## Syntax - -- Copy data from a file to a table. - - ``` - COPY table_name [ ( column_name [, ...] ) ] - FROM { 'filename' | STDIN } - [ [ USING ] DELIMITERS 'delimiters' ] - [ WITHOUT ESCAPING ] - [ LOG ERRORS ] - [ REJECT LIMIT 'limit' ] - [ WITH ( option [, ...] ) ] - | copy_option - | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ]; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >In the syntax, **FIXED FORMATTER \(\{column\_name\(offset, length\)\} \[, ...\]\)** and **\[\(option \[, ...\]\) | copy\_option \[...\]\]** can be in any sequence. - -- Copy data from a table to a file. - - ``` - COPY table_name [ ( column_name [, ...] ) ] - TO { 'filename' | STDOUT } - [ [ USING ] DELIMITERS 'delimiters' ] - [ WITHOUT ESCAPING ] - [ WITH ( option [, ...] ) ] - | copy_option - | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ]; - - COPY query - TO { 'filename' | STDOUT } - [ WITHOUT ESCAPING ] - [ WITH ( option [, ...] ) ] - | copy_option - | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ]; - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >1. The syntax constraints of **COPY TO** are as follows: - > **\(query\)** is incompatible with **\[USING\] DELIMITER**. If the data comes from a query result, **COPY TO** cannot specify **\[USING\] DELIMITERS**. - >2. Use spaces to separate **copy\_option** following **FIXED FORMATTTER**. - >3. **copy\_option** is the native parameter, while **option** is the parameter imported by a compatible foreign table. - >4. In the syntax, **FIXED FORMATTER \(\{column\_name\(offset, length\)\} \[, ...\]\)** and **\[\(option \[, ...\]\) | copy\_option \[...\]\]** can be in any sequence. - - The syntax of the optional parameter **option** is as follows: - - ``` - FORMAT 'format_name' - | OIDS [ boolean ] - | DELIMITER 'delimiter_character' - | NULL 'null_string' - | HEADER [ boolean ] - | FILEHEADER 'header_file_string' - | FREEZE [ boolean ] - | QUOTE 'quote_character' - | ESCAPE 'escape_character' - | EOL 'newline_character' - | NOESCAPING [ boolean ] - | FORCE_QUOTE { ( column_name [, ...] ) | * } - | FORCE_NOT_NULL ( column_name [, ...] ) - | ENCODING 'encoding_name' - | IGNORE_EXTRA_DATA [ boolean ] - | FILL_MISSING_FIELDS [ boolean ] - | COMPATIBLE_ILLEGAL_CHARS [ boolean ] - | DATE_FORMAT 'date_format_string' - | TIME_FORMAT 'time_format_string' - | TIMESTAMP_FORMAT 'timestamp_format_string' - | SMALLDATETIME_FORMAT 'smalldatetime_format_string' - ``` - - The syntax of the optional parameter **copy\_option** is as follows: - - ``` - OIDS - | NULL 'null_string' - | HEADER - | FILEHEADER 'header_file_string' - | FREEZE - | FORCE_NOT_NULL column_name [, ...] - | FORCE_QUOTE { column_name [, ...] | * } - | BINARY - | CSV - | QUOTE [ AS ] 'quote_character' - | ESCAPE [ AS ] 'escape_character' - | EOL 'newline_character' - | ENCODING 'encoding_name' - | IGNORE_EXTRA_DATA - | FILL_MISSING_FIELDS - | COMPATIBLE_ILLEGAL_CHARS - | DATE_FORMAT 'date_format_string' - | TIME_FORMAT 'time_format_string' - | TIMESTAMP_FORMAT 'timestamp_format_string' - | SMALLDATETIME_FORMAT 'smalldatetime_format_string' - ``` - - -## Parameter Description - -- **query** - - Specifies that the results are to be copied. - - Value range: a **SELECT** or **VALUES** command in parentheses - -- **table\_name** - - Specifies the name \(possibly schema-qualified\) of an existing table. - - Value range: an existing table name - -- **column\_name** - - Specifies an optional list of columns to be copied. - - Value range: any columns. All columns will be copied if no column list is specified. - -- **STDIN** - - Specifies that input comes from the standard input. - -- **STDOUT** - - Specifies that output goes to the standard output. - -- **FIXED** - - Fixes column length. When the column length is fixed, **DELIMITER**, **NULL**, and **CSV** cannot be specified. When **FIXED** is specified, **BINARY**, **CSV**, and **TEXT** cannot be specified by **option** or **copy\_option**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The definition of fixed length is as follows: - >1. The column length of each record is the same. - >2. Spaces are used for column padding. Columns of the numeric type are left-aligned and columns of the string type are right-aligned. - >3. No delimiters are used between columns. - -- **\[USING\] DELIMITER 'delimiters'** - - The string that separates columns within each row \(line\) of the file, and it cannot be larger than 10 bytes. - - Value range: The delimiter cannot include any of the following characters: \\.abcdefghijklmnopqrstuvwxyz0123456789 - - The default value is a tab character in text format and a comma in CSV format. - -- **WITHOUT ESCAPING** - - Specifies, in text format, whether to escape the backslash \(\\\) and its following characters. - - Value range: text only - -- **LOG ERRORS** - - If this parameter is specified, the error tolerance mechanism for data type errors in the **COPY FROM** statement is enabled. Row errors are recorded in the **public.pgxc\_copy\_error\_log** table in the database for future reference. - - Value range: a value set while data is imported using **COPY FROM**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The restrictions of this error tolerance parameter are as follows: - >- This error tolerance mechanism captures only the data type errors \(DATA\_EXCEPTION\) that occur during data parsing of **COPY FROM** on the primary node of the database. - >- Before enabling error tolerance for **COPY FROM** for the first time in a database, check whether the **public.pgxc\_copy\_error\_log** table exists. If not, call the **copy\_error\_log\_create\(\)** function to create it. If it does, copy its data elsewhere, delete it, and call the **copy\_error\_log\_create\(\)** function to create the table. For details about columns in the **public.pgxc\_copy\_error\_log** table, see [Table 1](other-functions.md#en-us_topic_0237121997_table138318280213). - >- While a **COPY FROM** statement with specified **LOG ERRORS** is being executed, if **public.pgxc\_copy\_error\_log** does not exist or does not have the table definitions compliant with those predefined in **copy\_error\_log\_create\(\)**, an error will be reported. Ensure that the error table is created using the **copy\_error\_log\_create\(\)** function. Otherwise, **COPY FROM** statements with error tolerance may fail to be run. - >- If existing error tolerance parameters \(for example, **IGNORE\_EXTRA\_DATA**\) of the **COPY** statement are enabled, the error of the corresponding type will be processed as specified by the parameters and no error will be reported. Therefore, the error table does not contain such error data. - -- **LOG ERRORS DATA** - - The differences between **LOG ERRORS DATA** and **LOG ERRORS** are as follows: - - 1. **LOG ERRORS DATA** fills the **rawrecord** field in the error tolerance table. - 2. Only users with the super permission can use the **LOG ERRORS DATA** parameter. - - >![](public_sys-resources/icon-caution.gif) **CAUTION:** - >If error content is too complex, it may fail to be written to the error tolerance table by using **LOG ERRORS DATA**, causing a task failure. - - -- **REJECT LIMIT **'**limit'** - - Used with the **LOG ERROR** parameter to set the upper limit of the tolerated errors in the **COPY FROM** statement. If the number of errors exceeds the limit, later errors will be reported based on the original mechanism. - - Value range: a positive integer \(1 to _INTMAX_\) or **unlimited** - - Default value: If **LOG ERRORS** is not specified, an error will be reported. If **LOG ERRORS** is specified, the default value is **0**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >In the error tolerance mechanism described in the description of **LOG ERRORS**, the count of **REJECT LIMIT** is calculated based on the number of data parsing errors on the primary node of the database where the **COPY FROM** statement is executed, not based on the number of all errors on the primary node. - -- **FORMATTER** - - Defines the place of each column in the data file in fixed length mode. Defines the place of each column in the data file in the **column\(**_offset_,_length_**\)** format. - - Value range: - - - The value of **offset** must be larger than 0. The unit is byte. - - The value of **length** must be larger than 0. The unit is byte. - - The total length of all columns must be less than 1 GB. - - Replace columns that are not in the file with null. - -- **OPTION \{ option\_name ' value ' \}** - - Specifies all types of parameters of a compatible foreign table. - - - FORMAT - - Specifies the format of the source data file in the foreign table. - - Value range: **CSV**, **TEXT**, **FIXED**, and **BINARY** - - - The CSV file can process newline characters efficiently, but cannot process certain special characters well. - - The TEXT file can process certain special characters efficiently, but cannot process newline characters well. - - In FIXED files, the column length of each record is the same. Spaces are used for padding, and the excessive part will be truncated. - - All data in the BINARY file is stored/read as binary format rather than as text. It is faster than the text and CSV formats, but a binary-format file is less portable. - - Default value: **TEXT** - - - DELIMITER - - Specifies the character that separates columns within each row \(line\) of the file. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The value of **DELIMITER** cannot be **\\r** or **\\n**. - >- A delimiter cannot be the same as the null value. The delimiter for the CSV format cannot be same as the **quote** value. - >- The delimiter for the TEXT format data cannot contain lowercase letters, digits, or special characters \(.\\\). - >- The data length of a single row should be less than 1 GB. A row that has many columns using long delimiters cannot contain much valid data. - >- You are advised to use multi-character delimiters or invisible delimiters. For example, you can use multi-characters \(such as $^&\) and invisible characters \(such as 0x07, 0x08, and 0x1b\). - - Value range: a multi-character delimiter within 10 bytes - - Default value: - - - A tab character in TEXT format - - A comma \(,\) in CSV format - - No delimiter in FIXED format - - - NULL - - Specifies the string that represents a null value. - - Value range: - - - A null value cannot be **\\r** or **\\n**. The maximum length is 100 characters. - - A null value cannot be the same as the **DELIMITER** or **QUOTE** value. - - Default value: - - - The default value for the CSV format is an empty string without quotation marks. - - The default value for the TEXT format is **\\N**. - - - HEADER - - Specifies whether a file contains a header with the names of each column in the file. **header** is available only for CSV and FIXED files. - - When data is imported, if **header** is **on**, the first row of the data file will be identified as the header and ignored. If **header** is **off**, the first row will be identified as a data row. - - When data is exported, if **header** is **on**, **fileheader** must be specified. If **header** is **off**, an exported file does not contain a header. - - Value range: **true/on** and **false/off** - - Default value: **false** - - - QUOTE - - Specifies a quoted character string for a CSV file. - - Default value: single quotation marks \(''\) - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The value of **QUOTE** cannot be the same as that of **DELIMITER** or **NULL**. - >- The value of **QUOTE** must be a single-byte character. - >- Invisible characters are recommended, such as 0x07, 0x08, and 0x1b. - - - ESCAPE - - Specifies an escape character for a CSV file. The value must be a single-byte character. - - Default value: single quotation marks \(''\) If the value is the same as that of **QUOTE**, it will be replaced by **\\0**. - - - EOL 'newline\_character' - - Specifies the newline character style of the imported or exported data file. - - Value range: multi-character newline characters within 10 bytes Common newline characters include **\\r** \(0x0D\), **\\n** \(0x0A\), and **\\r\\n **\(0x0D0A\). Special newline characters include **$** and **\#**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The EOL parameter supports only the TEXT format for data import and export and does not support the CSV or FIXED format for data import. For forward compatibility, the EOL parameter can be set to **0x0D** or **0x0D0A** for data export in the CSV or FIXED format. - >- The value of **EOL** cannot be the same as that of **DELIMITER** or **NULL**. - >- The EOL parameter value cannot contain the following characters: .abcdefghijklmnopqrstuvwxyz0123456789. - - - FORCE\_QUOTE \{ \( column\_name \[, ...\] \) | \* \} - - Forces quotation marks to be used for all non-null values in each specified column, in **CSV COPY TO** mode. Null values are not quoted. - - Value range: an existing column name - - - FORCE\_NOT\_NULL \( column\_name \[, ...\] \) - - Assigns a value to a specified column in **CSV COPY FROM** mode. - - Value range: an existing column name - - - ENCODING - - Specifies that the file is encoded in the **encoding\_name**. If this option is omitted, the current encoding format is used by default. - - - IGNORE\_EXTRA\_DATA - - Specifies whether to ignore excessive columns when the number of data source files exceeds the number of foreign table columns. This parameter is used only during data import. - - Value range: **true/on** and **false/off** - - - **true/on**: If the number of columns in a data source file is greater than that defined by the foreign table, the extra columns at the end of a row are ignored. - - **false/off**: If the number of columns in a data source file is greater than that defined by the foreign table, the following error message is reported: - - ``` - extra data after last expected column - ``` - - Default value: **false** - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >If a newline character at the end of a row is missing and the row and another row are integrated into one, data in another row is ignored after the parameter is set to **true**. - - - COMPATIBLE\_ILLEGAL\_CHARS - - Specifies whether to tolerate invalid characters during data import. The parameter is valid only for data import using **COPY FROM**. - - Value range: **true/on** and **false/off** - - - **true/on**: No error message is reported and data import is not interrupted when there are invalid characters. Invalid characters are converted into valid ones, and then imported to the database. - - **false/off**: An error occurs when there are invalid characters, and the import stops. - - Default value: **false/off** - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The rules for converting invalid characters are as follows: - >1. **\\0** is converted to a space. - >2. Other invalid characters are converted to question marks. - >3. When **compatible\_illegal\_chars** is set to **true/on**, after invalid characters such as **NULL**, **DELIMITER**, **QUOTE**, and **ESCAPE** are converted to spaces or question marks, an error message stating "illegal chars conversion may confuse COPY escape 0x20" will be displayed to remind you of possible parameter confusion caused by the conversion. - - - FILL\_MISSING\_FIELDS - - Specifies how to handle the problem that the last column of a row in a source data file is lost during data import. - - Value range: **true/on** and **false/off** - - Default value: **false/off** - - - DATE\_FORMAT - - Specifies the DATE format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid DATE value For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >You can use the **TIMESTAMP\_FORMAT** parameter to set the DATE format to **TIMESTAMP** for data import. For details, see **TIMESTAMP\_FORMAT** below. - - - TIME\_FORMAT - - Specifies the TIME format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid TIME value. Time zones are not supported. For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - - TIMESTAMP\_FORMAT - - Specifies the TIMESTAMP format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid TIMESTAMP value. Time zones cannot be used. For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - - SMALLDATETIME\_FORMAT - - Specifies the SMALLDATETIME format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid SMALLDATETIME value For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - -- **COPY\_OPTION \{ option\_name ' value ' \}** - - Specifies all types of native parameters of **COPY**. - - - NULL null\_string - - Specifies the string that represents a null value. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >When using **COPY FROM**, any data item that matches this string will be stored as a null value, so make sure that you use the same string as you used with **COPY TO**. - - Value range: - - - A null value cannot be **\\r** or **\\n**. The maximum length is 100 characters. - - A null value cannot be the same as the **DELIMITER** or **QUOTE** value. - - Default value: - - - The default value for the TEXT format is **\\N**. - - The default value for the CSV format is an empty string without quotation marks. - - - HEADER - - Specifies whether a file contains a header with the names of each column in the file. **header** is available only for CSV and FIXED files. - - When data is imported, if **header** is **on**, the first row of the data file will be identified as the header and ignored. If **header** is **off**, the first row will be identified as a data row. - - When data is exported, if **header** is **on**, **fileheader** must be specified. If **header** is **off**, an exported file does not contain a header. - - - FILEHEADER - - Specifies a file that defines the content in the header for exported data. The file contains data description of each column. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- This parameter is available only when **header** is **on** or **true**. - >- **fileheader** specifies an absolute path. - >- The file can contain only one row of header information, and ends with a newline character. Excess rows will be discarded. \(Header information cannot contain newline characters.\) - >- The length of the file including the newline character cannot exceed 1 MB. - - - FREEZE - - Sets the **COPY** loaded data row as **frozen**, like these data have executed **VACUUM FREEZE**. - - This is a performance option of initial data loading. The data will be frozen only when the following three requirements are met: - - - The table being loaded has been created or truncated in the current subtransaction before copying. - - There are no cursors open in the current transaction. - - There are no original snapshots in the current transaction. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >When **COPY** is completed, all the other sessions will see the data immediately. However, this violates the general principle of MVCC visibility, and users should understand that this may cause potential risks. - - - FORCE NOT NULL column\_name \[, ...\] - - In **CSV COPY FROM** mode, the specified column is not null. If the column is null, its value is regarded as a string of 0 characters. - - Value range: an existing column name - - - FORCE QUOTE \{ column\_name \[, ...\] | \* \} - - Forces quotation marks to be used for all non-null values in each specified column, in **CSV COPY TO** mode. Null values are not quoted. - - Value range: an existing column name - - - BINARY - - Specifies that data is stored and read in binary mode instead of text mode. In binary mode, you cannot declare **DELIMITER**, **NULL**, or **CSV**. When **BINARY** is specified, **CSV**, **FIXED**, and **TEXT** cannot be specified through **option** or **copy\_option**. - - - CSV - - Enables the CSV mode. When **CSV** is specified, **BINARY**, **FIXED**, and **TEXT** cannot be specified through **option** or **copy\_option**. - - - QUOTE \[AS\] 'quote\_character' - - Specifies a quoted character string for a CSV file. - - Default value: single quotation marks \(''\) - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The value of **QUOTE** cannot be the same as that of **DELIMITER** or **NULL**. - >- The value of **QUOTE** must be a single-byte character. - >- Invisible characters are recommended, such as 0x07, 0x08, and 0x1b. - - - ESCAPE \[AS\] 'escape\_character' - - Specifies an escape character for a CSV file. The value must be a single-byte character. - - The default value is single quotation marks \(''\). If the value is the same as that of **QUOTE**, it will be replaced by **\\0**. - - - EOL 'newline\_character' - - Specifies the newline character style of the imported or exported data file. - - Value range: multi-character newline characters within 10 bytes Common newline characters include **\\r** \(0x0D\), **\\n** \(0x0A\), and **\\r\\n **\(0x0D0A\). Special newline characters include **$** and **\#**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- The **EOL** parameter supports only the TEXT format for data import and export and does not support the CSV or FIXED format. For forward compatibility, the EOL parameter can be set to **0x0D** or **0x0D0A** for data export in the CSV or FIXED format. - >- The value of **EOL** cannot be the same as that of **DELIMITER** or **NULL**. - >- The EOL parameter value cannot contain the following characters: .abcdefghijklmnopqrstuvwxyz0123456789. - - - ENCODING 'encoding\_name' - - Specifies the name of a file encoding format. - - Value range: a valid encoding format - - Default value: current encoding format - - - IGNORE\_EXTRA\_DATA - - If the number of columns in a data source file is greater than that defined by the foreign table, the extra columns at the end of a row are ignored. This parameter is used only during data import. - - If this parameter is not used and the number of columns in the data source file is greater than that defined in the foreign table, the following error information is displayed: - - ``` - extra data after last expected column - ``` - - - COMPATIBLE\_ILLEGAL\_CHARS - - Specifies that invalid characters are tolerated during data import. Invalid characters are converted and then imported to the database. No error is reported and the import is not interrupted. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - If this parameter is not used, an error is reported when invalid characters are encountered during the import, and the import is interrupted. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The rules for converting invalid characters are as follows: - >1. **\\0** is converted to a space. - >2. Other invalid characters are converted to question marks. - >3. When **compatible\_illegal\_chars** is set to **true/on**, after invalid characters such as **NULL**, **DELIMITER**, **QUOTE**, and **ESCAPE** are converted to spaces or question marks, an error message stating "illegal chars conversion may confuse COPY escape 0x20" will be displayed to remind you of possible parameter confusion caused by the conversion. - - - FILL\_MISSING\_FIELDS - - Specifies how to handle the problem that the last column of a row in a source data file is lost during data import. - - Value range: **true/on** and **false/off** - - Default value: **false/off** - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >Do not specify this option. Currently, it does not enable error tolerance, but will make the parser ignore the said errors during data parsing on the primary node of the database. Such errors will not be recorded in the COPY error table \(enabled using **LOG ERRORS REJECT LIMIT**\) but will be reported later by the database node. Therefore, do not specify this option. - - - DATE\_FORMAT 'date\_format\_string' - - Specifies the DATE format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid DATE value For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >You can use the **TIMESTAMP\_FORMAT** parameter to set the DATE format to **TIMESTAMP** for data import. For details, see **TIMESTAMP\_FORMAT** below. - - - TIME\_FORMAT 'time\_format\_string' - - Specifies the TIME format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid TIME value. Time zones are not supported. For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - - TIMESTAMP\_FORMAT 'timestamp\_format\_string' - - Specifies the TIMESTAMP format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid TIMESTAMP value. Time zones cannot be used. For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - - SMALLDATETIME\_FORMAT 'smalldatetime\_format\_string' - - Specifies the SMALLDATETIME format for data import. The BINARY format is not supported. When data of such format is imported, error "cannot specify bulkload compatibility options in BINARY mode" will occur. The parameter is valid only for data import using **COPY FROM**. - - Value range: a valid SMALLDATETIME value For details, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - - The following special backslash sequences are recognized by **COPY FROM**: - - - **\\b**: Backslash \(ASCII 8\) - - **\\f**: Form feed \(ASCII 12\) - - **\\n**: Newline character \(ASCII 10\) - - **\\r**: Carriage return character \(ASCII 13\) - - **\\t**: Tab \(ASCII 9\) - - **\\v**: Vertical tab \(ASCII 11\) - - **\\digits**: Backslash followed by one to three octal digits specifies that the ASCII value is the character with that numeric code. - - **\\xdigits**: Backslash followed by an x and one or two hex digits specifies the character with that numeric code. - - -## Examples - -``` --- Copy data from the tpcds.ship_mode file to the /home/omm/ds_ship_mode.dat file: -postgres=# COPY tpcds.ship_mode TO '/home/omm/ds_ship_mode.dat'; - --- Output tpcds.ship_mode to stdout. -postgres=# COPY tpcds.ship_mode TO stdout; - --- Create the tpcds.ship_mode_t1 table. -postgres=# CREATE TABLE tpcds.ship_mode_t1 -( - SM_SHIP_MODE_SK INTEGER NOT NULL, - SM_SHIP_MODE_ID CHAR(16) NOT NULL, - SM_TYPE CHAR(30) , - SM_CODE CHAR(10) , - SM_CARRIER CHAR(20) , - SM_CONTRACT CHAR(20) -) -WITH (ORIENTATION = COLUMN,COMPRESSION=MIDDLE) -; - --- Copy data from stdin to the tpcds.ship_mode_t1 table. -postgres=# COPY tpcds.ship_mode_t1 FROM stdin; - --- Copy data from the /home/omm/ds_ship_mode.dat file to the tpcds.ship_mode_t1 table. -postgres=# COPY tpcds.ship_mode_t1 FROM '/home/omm/ds_ship_mode.dat'; - --- Copy data from the /home/omm/ds_ship_mode.dat file to the tpcds.ship_mode_t1 table, with the import format set to TEXT (format 'text'), the delimiter set to \t' (delimiter E'\t'), excessive columns ignored (ignore_extra_data 'true'), and characters not escaped (noescaping 'true'). -postgres=# COPY tpcds.ship_mode_t1 FROM '/home/omm/ds_ship_mode.dat' WITH(format 'text', delimiter E'\t', ignore_extra_data 'true', noescaping 'true'); - --- Copy data from the /home/omm/ds_ship_mode.dat file to the tpcds.ship_mode_t1 table, with the import format set to FIXED, fixed-length format specified (FORMATTER(SM_SHIP_MODE_SK(0, 2), SM_SHIP_MODE_ID(2,16), SM_TYPE(18,30), SM_CODE(50,10), SM_CARRIER(61,20), SM_CONTRACT(82,20))), excessive columns ignored (ignore_extra_data), and headers included (header). -postgres=# COPY tpcds.ship_mode_t1 FROM '/home/omm/ds_ship_mode.dat' FIXED FORMATTER(SM_SHIP_MODE_SK(0, 2), SM_SHIP_MODE_ID(2,16), SM_TYPE(18,30), SM_CODE(50,10), SM_CARRIER(61,20), SM_CONTRACT(82,20)) header ignore_extra_data; - --- Delete the tpcds.ship_mode_t1 table: -postgres=# DROP TABLE tpcds.ship_mode_t1; -``` - diff --git a/content/en/docs/installation/Developerguide/copymanager.md b/content/en/docs/installation/Developerguide/copymanager.md deleted file mode 100644 index dae6642ad847aac18bde40d00d6af41eb2defe12..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/copymanager.md +++ /dev/null @@ -1,109 +0,0 @@ -# CopyManager - -CopyManager is an API class provided by the JDBC driver in openGauss. It is used to import data to openGauss in batches. - -## Inheritance Relationship of CopyManager - -The CopyManager class is in the **org.postgresql.copy** package and inherits the java.lang.Object class. The declaration of the class is as follows: - -``` -public class CopyManager -extends Object -``` - -## Construction Method - -public CopyManager\(BaseConnection connection\) - -throws SQLException - -## Common Methods - -**Table 1** Common methods of CopyManager - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Return Value

-

Method

-

Description

-

throws

-

CopyIn

-

copyIn(String sql)

-

-

-

SQLException

-

long

-

copyIn(String sql, InputStream from)

-

Uses COPY FROM STDIN to quickly load data to tables in the database from InputStream.

-

SQLException,IOException

-

long

-

copyIn(String sql, InputStream from, int bufferSize)

-

Uses COPY FROM STDIN to quickly load data to tables in the database from InputStream.

-

SQLException,IOException

-

long

-

copyIn(String sql, Reader from)

-

Uses COPY FROM STDIN to quickly load data to tables in the database from Reader.

-

SQLException,IOException

-

long

-

copyIn(String sql, Reader from, int bufferSize)

-

Uses COPY FROM STDIN to quickly load data to tables in the database from Reader.

-

SQLException,IOException

-

CopyOut

-

copyOut(String sql)

-

-

-

SQLException

-

long

-

copyOut(String sql, OutputStream to)

-

Sends the result set of COPY TO STDOUT from the database to the OutputStream class.

-

SQLException,IOException

-

long

-

copyOut(String sql, Writer to)

-

Sends the result set of COPY TO STDOUT from the database to the Writer class.

-

SQLException,IOException

-
- diff --git a/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-full-disk-space.md b/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-full-disk-space.md deleted file mode 100644 index f9a4e31c9cc22f06d1fec09575ab958bf2eb1cb7..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-full-disk-space.md +++ /dev/null @@ -1,16 +0,0 @@ -# Core Dump Occurs due to Full Disk Space - -## Symptom - -When TPC-C is running, the disk space is full during injection. As a result, a core dump occurs on the GaussDB process, as shown in the following figure. - -![](figures/en-us_image_0244851037.png) - -## Cause Analysis - -When the disk is full, Xlog logs cannot be written. The program exits through the panic log. - -## Procedure - -Externally monitor the disk usage and periodically clean up the disk. - diff --git a/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-incorrect-settings-of-guc-parameter-log_directory.md b/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-incorrect-settings-of-guc-parameter-log_directory.md deleted file mode 100644 index 9da3d8c422f4ffe0013b192b8804add103929977..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/core-dump-occurs-due-to-incorrect-settings-of-guc-parameter-log_directory.md +++ /dev/null @@ -1,14 +0,0 @@ -# Core Dump Occurs Due to Incorrect Settings of GUC Parameter log\_directory - -## Symptom - -After the database process is started, a core dump occurs and no log is recorded. - -## Cause Analysis - -The directory specified by GUC parameter **log\_directory** cannot be read or you do not have permissions to access this directory. As a result, the verification fails during the database startup, and the program exits through the panic log. - -## Procedure - -Set **log\_directory** to a valid directory. For details, see [log\_directory](logging-destination.md#en-us_topic_0237124721_en-us_topic_0059778787_sfbedf09fcf1a4223a4538679f80f12a9). - diff --git a/content/en/docs/installation/Developerguide/core-fault-locating.md b/content/en/docs/installation/Developerguide/core-fault-locating.md deleted file mode 100644 index 205ca26af7d9af1e80b26dac1a6a955cb820b4c9..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/core-fault-locating.md +++ /dev/null @@ -1,7 +0,0 @@ -# Core Fault Locating - -- **[Core Dump Occurs due to Full Disk Space](core-dump-occurs-due-to-full-disk-space.md)** - -- **[Core Dump Occurs Due to Incorrect Settings of GUC Parameter log\_directory](core-dump-occurs-due-to-incorrect-settings-of-guc-parameter-log_directory.md)** - - diff --git a/content/en/docs/installation/Developerguide/cost-based-vacuum-delay.md b/content/en/docs/installation/Developerguide/cost-based-vacuum-delay.md deleted file mode 100644 index 200b18535011196ec9d81d2a24d1fd194098818a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cost-based-vacuum-delay.md +++ /dev/null @@ -1,69 +0,0 @@ -# Cost-based Vacuum Delay - -This feature allows administrators to reduce the I/O impact of the **VACUUM** and **ANALYZE** statements on concurrent database activities. It is often more important to prevent maintenance statements, such as **VACUUM** and **ANALYZE**, from affecting other database operations than to run them quickly. Cost-based vacuum delay provides a way for administrators to achieve this purpose. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Certain vacuum operations hold critical locks and should be complete as quickly as possible. In openGauss, cost-based vacuum delays do not take effect during such operations. To avoid uselessly long delays in such cases, the actual delay is the larger of the two calculated values: ->- **vacuum\_cost\_delay** x **accumulated\_balance**/**vacuum\_cost\_limit** ->- **vacuum\_cost\_delay** x 4 - -## Background - -During the execution of the [ANALYZE | ANALYSE](analyze-analyse.md) and [VACUUM](vacuum.md) statements, the system maintains an internal counter that keeps track of the estimated cost of the various I/O operations that are performed. When the accumulated cost reaches a limit \(specified by **vacuum\_cost\_limit**\), the process performing the operation will sleep for a short period of time \(specified by **vacuum\_cost\_delay**\). Then, the counter resets and the operation continues. - -By default, this feature is disabled. To enable this feature, set **vacuum\_cost\_delay** to a positive value. - -## vacuum\_cost\_delay - -**Parameter description**: Specifies the length of time that a process will sleep when **vacuum\_cost\_limit** has been exceeded. - -In many systems, the effective resolution of the sleep length is 10 milliseconds. Therefore, setting this parameter to a value that is not a multiple of 10 has the same effect as setting it to the next higher multiple of 10. - -This parameter is usually set to a small value, such as 10 or 20 milliseconds. Adjusting vacuum's resource consumption is best done by changing other vacuum cost parameters. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 100 \(unit: ms\). A positive number enables cost-based vacuum delay and **0** disables cost-based vacuum delay. - -**Default value**: **0** - -## vacuum\_cost\_page\_hit - -**Parameter description**: Specifies the estimated cost for vacuuming a buffer found in the shared buffer. It represents the cost to lock the buffer pool, look up the shared hash table, and scan the content of the page. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 10000 - -**Default value**: **1** - -## vacuum\_cost\_page\_miss - -**Parameter description**: Specifies the estimated cost for vacuuming a buffer read from the disk. It represents the cost to lock the buffer pool, look up the shared hash table, read the desired block from the disk, and scan the block. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 10000 - -**Default value:** **10** - -## vacuum\_cost\_page\_dirty - -**Parameter description**: Specifies the estimated cost charged when vacuum modifies a block that was previously clean. It represents the extra I/O required to flush the dirty block out to disk again. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 1000 - -**Default value:** **20** - -## vacuum\_cost\_limit - -**Parameter description**: Specifies the cost limit. The vacuuming process will sleep if this limit is exceeded. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 1 to 10000 - -**Default value**: **200** - diff --git a/content/en/docs/installation/Developerguide/cpu.md b/content/en/docs/installation/Developerguide/cpu.md deleted file mode 100644 index 3c45dd6f2c3d77923cb799030bb1265eeab74380..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cpu.md +++ /dev/null @@ -1,117 +0,0 @@ -# CPU - -You can run the **top** command to check the CPU usage of each node in openGauss and analyze whether performance bottleneck caused by heavy CPU load exists. - -## Checking CPU Usage - -You can query the CPU usage of the server in the following ways: - -On each storage node, run the **top** command to check the CPU usage. Then, press **1** to view the usage of each CPU core. - -``` -top - 17:05:04 up 32 days, 20:34, 5 users, load average: 0.02, 0.02, 0.00 -Tasks: 124 total, 1 running, 123 sleeping, 0 stopped, 0 zombie -Cpu0 : 0.0%us, 0.3%sy, 0.0%ni, 69.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st -Cpu1 : 0.3%us, 0.3%sy, 0.0%ni, 69.3%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st -Cpu2 : 0.3%us, 0.3%sy, 0.0%ni, 69.3%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st -Cpu3 : 0.3%us, 0.3%sy, 0.0%ni, 69.3%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st -Mem: 8038844k total, 7165272k used, 873572k free, 530444k buffers -Swap: 4192924k total, 4920k used, 4188004k free, 4742904k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - - 35184 omm 20 0 822m 421m 128m S 0 5.4 5:28.15 gaussdb - 1 root 20 0 13592 820 784 S 0 0.0 1:16.62 init -``` - -In the command output, focus on the CPU usage occupied by each process. - -**us** indicates the CPU percentage occupied by the user space, **sy** indicates the CPU percentage occupied by the kernel space, and **id** indicates the idle CPU percentage. If **id** is less than 10%, the CPU load is high. In this case, you can reduce the CPU load by reducing the number of tasks on nodes. - -## Analyzing Performance Parameters - -1. Run the **top-H** command to check the CPU usage. The following is displayed: - - ``` - 14 root 20 0 0 0 0 S 0 0.0 0:16.41 events/3 - top - 14:22:49 up 5 days, 21:51, 2 users, load average: 0.08, 0.08, 0.06 - Tasks: 312 total, 1 running, 311 sleeping, 0 stopped, 0 zombie - Cpu(s): 1.3%us, 0.7%sy, 0.0%ni, 95.0%id, 2.4%wa, 0.5%hi, 0.2%si, 0.0%st - Mem: 8038844k total, 5317668k used, 2721176k free, 180268k buffers - Swap: 4192924k total, 0k used, 4192924k free, 2886860k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - - 3105 root 20 0 50492 11m 2708 S 3 0.1 22:22.56 acc-snf - - 4015 gdm 20 0 232m 23m 11m S 0 0.3 11:34.70 gdm-simple-gree - 51001 omm 20 0 12140 1484 948 R 0 0.0 0:00.94 top - - 54885 omm 20 0 615m 396m 116m S 0 5.1 0:09.44 gaussdb - - - 1 root 20 0 13592 944 792 S 0 0.0 0:08.54 init - ``` - -2. In the query result for **Cpu\(s\)**, check whether the system CPU \(**sy**\) or user CPU \(**us**\) usage is high. - - If the system CPU usage is too high, you need to identify the abnormal system processes and handle them. - - If the CPU usage of the openGauss process whose **USER** is **omm** is too high, optimize the service-related SQL statements based on the running services queries. Based on the features of the currently running service, perform the following operations to check whether this process containing infinite loop logics. - 1. Run the **top -H -p pid** command to identify the threads that use much CPU in the process. - - ``` - top -H -p 54952 - ``` - - The threads causing high CPU usage are displayed in the **top** column of the command output. In this section, thread **54775** is used as an example for analyzing the causes of the high CPU usage. - - ``` - top - 14:23:27 up 5 days, 21:52, 2 users, load average: 0.04, 0.07, 0.05 - Tasks: 13 total, 0 running, 13 sleeping, 0 stopped, 0 zombie - Cpu(s): 0.9%us, 0.4%sy, 0.0%ni, 97.3%id, 1.1%wa, 0.2%hi, 0.1%si, 0.0%st - Mem: 8038844k total, 5322180k used, 2716664k free, 180316k buffers - Swap: 4192924k total, 0k used, 4192924k free, 2889860k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - 54775 omm 20 0 684m 424m 131m S 0 5.4 0:00.32 gaussdb - 54951 omm 20 0 684m 424m 131m S 0 5.4 0:00.84 gaussdb - 54732 omm 20 0 684m 424m 131m S 0 5.4 0:00.24 gaussdb - 54758 omm 20 0 684m 424m 131m S 0 5.4 0:00.00 gaussdb - 54759 omm 20 0 684m 424m 131m S 0 5.4 0:00.02 gaussdb - 54773 omm 20 0 684m 424m 131m S 0 5.4 0:02.79 gaussdb - 54780 omm 20 0 684m 424m 131m S 0 5.4 0:00.04 gaussdb - 54781 omm 20 0 684m 424m 131m S 0 5.4 0:00.21 gaussdb - 54782 omm 20 0 684m 424m 131m S 0 5.4 0:00.02 gaussdb - 54798 omm 20 0 684m 424m 131m S 0 5.4 0:16.70 gaussdb - 54952 omm 20 0 684m 424m 131m S 0 5.4 0:07.51 gaussdb - 54953 omm 20 0 684m 424m 131m S 0 5.4 0:00.81 gaussdb - 54954 omm 20 0 684m 424m 131m S 0 5.4 0:06.54 gaussdb - ``` - - 2. Run the following command to view the function invocation stack for each thread in the process. Check the thread number for the ID of the thread that occupies high CPU usage in the last step. - - ``` - gstack 54954 - ``` - - The query result is as follows. The thread number for the thread ID **54775** is **10**. - - ``` - 192.168.0.11:~ # gstack 54954 - Thread 10 (Thread 0x7f95a5fff710 (LWP 54775)): - #0 0x00007f95c41d63c6 in poll () from /lib64/libc.so.6 - #1 0x0000000000d3d2d3 in WaitLatchOrSocket(Latch volatile*, int, int, long) () - #2 0x000000000095ed25 in XLogPageRead(XLogRecPtr*, int, bool, bool) () - #3 0x000000000095f6dd in ReadRecord(XLogRecPtr*, int, bool) () - #4 0x000000000096aef0 in StartupXLOG() () - #5 0x0000000000d5607a in StartupProcessMain() () - #6 0x00000000009e19f9 in AuxiliaryProcessMain(int, char**) () - #7 0x0000000000d50135 in SubPostmasterMain(int, char**) () - #8 0x0000000000d504ec in MainStarterThreadFunc(void*) () - #9 0x00007f95c79b85f0 in start_thread () from /lib64/libpthread.so.0 - #10 0x00007f95c41df84d in clone () from /lib64/libc.so.6 - #11 0x0000000000000000 in ?? () - ``` - - - - diff --git a/content/en/docs/installation/Developerguide/create-data-source.md b/content/en/docs/installation/Developerguide/create-data-source.md deleted file mode 100644 index 25ea3dad1050d228f55c6735908cb7ca5dd4f62b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-data-source.md +++ /dev/null @@ -1,92 +0,0 @@ -# CREATE DATA SOURCE - -## Function - -**CREATE DATA SOURCE** creates an external data source, which defines the information about the database that openGauss will connect to. - -## Precautions - -- The data source name must be unique in the database and comply with the identifier naming rules. Its length cannot exceed 63 bytes. Otherwise, it will be truncated. -- Only the system administrator or initial user has the permission to create data sources. The user who creates the object is the default owner of the object. -- If the **password** option is displayed, ensure that the **datasource.key.cipher** and **datasource.key.rand** files exist in the _$GAUSSHOME_**/bin** directory of each node in openGauss. If the two files do not exist, use the **gs\_guc** tool to generate them and use the **gs\_ssh** tool to release them to the _$GAUSSHOME_**/bin** directory on each node in openGauss. - -## Syntax - -``` -CREATE DATA SOURCE src_name - [TYPE 'type_str'] - [VERSION {'version_str' | NULL}] - [OPTIONS (optname 'optvalue' [, ...])]; -``` - -## Parameter Description - -- **src\_name** - - Specifies the name of the new data source, which must be unique in the database. - - Value range: a string. It must comply with the naming convention rule. - -- **TYPE** - - Specifies the type of the data source. This parameter can be left empty, and its default value will be used. - - Value range: an empty string or a non-empty string - -- **VERSION** - - Specifies the version number of the new data source. This parameter can be left empty or set to null. - - Value range: an empty string, a non-empty string, or null - -- **OPTIONS** - - Specifies the options of the data source. This parameter can be left empty or specified using the following keywords: - - - optname - - Specifies the option name. - - Value range: **dsn**, **username**, **password**, and **encoding**. The value is case-insensitive. - - - **dsn** corresponds to the DSN in the ODBC configuration file. - - **username**/**password** indicates the username and password for connecting to the destination database. - - The user name and password entered by the user are encrypted in the openGauss background to ensure security. The key file required for encryption must be generated using the **gs\_guc** tool and released to the _$GAUSSHOME_**/bin** directory of each node in openGauss using the **gs\_ssh** tool. The user name and password cannot contain the prefix "encryptOpt". Otherwise, they are considered as encrypted ciphertext. - - - **encoding** indicates the character string encoding mode used for interaction with the destination database \(including the sent SQL statements and returned data of the character type\). Its validity is not checked during object creation. Whether data can be encoded and decoded depends on whether the encoding you specified can be used in the database. - - - optvalue - - Specifies the option value. - - Value range: an empty string or a non-empty string - - - -## Examples - -``` --- Create an empty data source that does not contain any information. -postgres=# CREATE DATA SOURCE ds_test1; - --- Create a data source with TYPE information and VERSION being null. -postgres=# CREATE DATA SOURCE ds_test2 TYPE 'MPPDB' VERSION NULL; - --- Create a data source that contains only OPTIONS. -postgres=# CREATE DATA SOURCE ds_test3 OPTIONS (dsn 'openGauss', encoding 'utf8'); - --- Create a data source that contains TYPE, VERSION, and OPTIONS. -postgres=# CREATE DATA SOURCE ds_test4 TYPE 'unknown' VERSION '11.2.3' OPTIONS (dsn 'openGauss', username 'userid', password 'pwd@123456', encoding ''); - --- Delete the data source. -postgres=# DROP DATA SOURCE ds_test1; -postgres=# DROP DATA SOURCE ds_test2; -postgres=# DROP DATA SOURCE ds_test3; -postgres=# DROP DATA SOURCE ds_test4; -``` - -## Helpful Links - -[ALTER DATA SOURCE](alter-data-source.md), [DROP DATA SOURCE](drop-data-source.md) - diff --git a/content/en/docs/installation/Developerguide/create-database.md b/content/en/docs/installation/Developerguide/create-database.md deleted file mode 100644 index 9668c5ba7c1a3ceaf5f75aff3ca0c2577e5c6046..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-database.md +++ /dev/null @@ -1,174 +0,0 @@ -# CREATE DATABASE - -## Function - -Create a database. By default, a new database is created by copying the standard system database template0. Only template0 can be used to create a new database. - -## Precautions - -- A user that has the **CREATEDB** permission or a system administrator can create a database. -- **CREATE DATABASE** cannot be executed inside a transaction block. -- Errors along the line of "could not initialize database directory" are most likely related to insufficient permissions on the data directory, a full disk, or other file system problems. - -## Syntax - -``` -CREATE DATABASE database_name - [ [ WITH ] { [ OWNER [=] user_name ] | - [ TEMPLATE [=] template ] | - [ ENCODING [=] encoding ] | - [ LC_COLLATE [=] lc_collate ] | - [ LC_CTYPE [=] lc_ctype ] | - [ DBCOMPATIBILITY [=] compatibilty_type ] | - [ TABLESPACE [=] tablespace_name ] | - [ CONNECTION LIMIT [=] connlimit ]}[...] ]; -``` - -## Parameter Description - -- **database\_name** - - Specifies the database name. - - Value range: a string. It must comply with the naming convention. - -- **OWNER \[ = \] user\_name** - - Specifies the owner of the new database. By default, the owner of a new database is the current user. - - Value range: an existing username - -- **TEMPLATE \[ = \] template** - - Specifies a template name. That is, the template from which the database is created. openGauss creates a database by copying data from a template database. openGauss has two default template databases **template0** and **template1** and a default user database **postgres**. - - Value range: template0. - -- **ENCODING \[ = \] encoding** - - Specifies the encoding format used by the new database. The value can be a string \(for example, **SQL\_ASCII**\) or an integer. - - By default, the encoding format of the template database is used. The encoding formats of the template databases **template0** and **template1** depend on the OS. The encoding format of **template1** cannot be changed. If you need to change the encoding format when creating a database, use **template0**. - - Common values : **GBK**, **UTF8**, and **Latin1** - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- The character set encoding of the new database must be compatible with the local settings \(**LC\_COLLATE** and **LC\_CTYPE**\). - >- When the specified character encoding set is **GBK**, some uncommon Chinese characters cannot be directly used as object names. This is because the byte encoding overlaps with the ASCII characters @A-Z\[\\\]^\_\`a-z\{|\} when the second byte of the GBK ranges from 0x40 to 0x7E. **@\[\\\]^\_'\{|\}** is an operator in the database. If it is directly used as an object name, a syntax error will be reported. For example, the GBK hexadecimal code is **0x8240**, and the second byte is **0x40**, which is the same as the ASCII character @. Therefore, the character cannot be used as an object name. If you do need to use this function, you can add double quotation marks \(""\) to avoid this problem when creating and accessing objects. - -- **LC\_COLLATE \[ = \] lc\_collate** - - Specifies the character set used by the new database. For example, set this parameter by using **lc\_collate = 'zh\_CN.gbk'**. - - The use of this parameter affects the sort order of strings \(for example, the order of using **ORDER BY** for execution and the order of using indexes on text columns\). By default, the sorting order of the template database is used. - - Value range: a valid sorting type - -- **LC\_CTYPE \[ = \] lc\_ctype** - - Specifies the character class used by the new database. For example, set this parameter by using **lc\_ctype = 'zh\_CN.gbk'**. The use of this parameter affects the classification of characters, such as uppercase letters, lowercase letters, and digits. By default, the character classification of the template database is used. - - Value range: a valid character type - -- **DBCOMPATIBILITY \[ = \] compatibilty\_type** - - Specifies the type of the compatible database. - - **Value range**: A, B, C , and PG, indicating **O**, **MY**, **TD** , and **POSTGRES** databases, respectively. - - ![](public_sys-resources/icon-notice.gif) **NOTICE:** - - When DBCOMPATIBILITY is set to A, an empty string is considered as NULL. - -- **TABLESPACE \[ = \] tablespace\_name** - - Specifies the tablespace of the database. - - Value range: an existing tablespace name - -- **CONNECTION LIMIT \[ = \] connlimit** - - Specifies the maximum number of concurrent connections that can be made to the new database. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- The system administrator is not restricted by this parameter. - >- connlimit is calculated separately for each master database node. Number of connections of the openGauss = connlimit x Number of normal CN master database nodes. - - Value range: an integer greater than or equal to -1 The default value is **-1**, indicating that there is no limit. - - -The restrictions on character encoding are as follows: - -- If the locale is set to **C** \(or **POSIX**\), all encoding types are allowed. For other locale settings, the character encoding must be the same as that of the locale. -- The encoding and region settings must match the template database, except that **template0** is used as a template. This is because other databases may contain data that does not match the specified encoding, or may contain indexes whose sorting order is affected by **LC\_COLLATE** and **LC\_CTYPE**. Copying this data will invalidate the indexes in the new database. **template0** does not contain any data or indexes that may be affected. - -## Examples - -``` --- Create users jim and tom: -postgres=# CREATE USER jim PASSWORD 'Bigdata@123'; -postgres=# CREATE USER tom PASSWORD 'Bigdata@123'; - --- Create database music using GBK (the local encoding type is also GBK): -postgres=# CREATE DATABASE music ENCODING 'GBK' template = template0; - --- Create database music2 and specify user jim as its owner: -postgres=# CREATE DATABASE music2 OWNER jim; - --- Create database music3 using template template0 and specify user jim as its owner: -postgres=# CREATE DATABASE music3 OWNER jim TEMPLATE template0; - --- Set the maximum number of connections to database music to 10: -postgres=# ALTER DATABASE music CONNECTION LIMIT= 10; - --- Rename database music to music4: -postgres=# ALTER DATABASE music RENAME TO music4; - --- Change the owner of database music2 to user tom: -postgres=# ALTER DATABASE music2 OWNER TO tom; - --- Set the tablespace of database music3 to PG_DEFAULT: -postgres=# ALTER DATABASE music3 SET TABLESPACE PG_DEFAULT; - --- Disable the default index scan on database music3. -postgres=# ALTER DATABASE music3 SET enable_indexscan TO off; - --- Reset the enable_indexscan parameter. -postgres=# ALTER DATABASE music3 RESET enable_indexscan; - -Delete the databases: -postgres=# DROP DATABASE music2; -postgres=# DROP DATABASE music3; -postgres=# DROP DATABASE music4; - --- Delete the jim and tom users. -postgres=# DROP USER jim; -postgres=# DROP USER tom; - --- Create a database compatible with the TD format. -postgres=# CREATE DATABASE td_compatible_db DBCOMPATIBILITY 'C'; - --- Create a database compatible with the ORA format. -postgres=# CREATE DATABASE ora_compatible_db DBCOMPATIBILITY 'A'; - --- Delete the databases that are compatible with the TD and ORA formats. -postgres=# DROP DATABASE td_compatible_db; -postgres=# DROP DATABASE ora_compatible_db; -``` - -## Helpful Links - -[ALTER DATABASE](alter-database.md) and [DROP DATABASE](drop-database.md) - -## Suggestions - -- **create database** - - Database cannot be created in a transaction. - - -- **ENCODING LC\_COLLATE LC\_CTYPE** - - If the new database Encoding, LC-Collate, or LC\_Ctype does not match the template database \(SQL\_ASCII\) \(**'GBK'**, **'UTF8'**, or **'LATIN1'**\), **template \[=\] template0** must be specified. - - diff --git a/content/en/docs/installation/Developerguide/create-directory.md b/content/en/docs/installation/Developerguide/create-directory.md deleted file mode 100644 index 91c3e82c4253d568b12ace83da604c6181e4a7cf..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-directory.md +++ /dev/null @@ -1,55 +0,0 @@ -# CREATE DIRECTORY - -## Function - -**CREATE DIRECTORY** creates a directory. The directory defines an alias for a path in the server file system and is used to store data files used by users. - -## Precautions - -- By default, only initial users can create directories. If **enable\_access\_server\_directory** is enabled \(for details, see [enable\_access\_server\_directory](operation-auditing.md#en-us_topic_0237124747_section4279164545515)\), users with the **sysadmin** permission can also create directories. -- By default, the user who creates a directory has the read and write permissions on the directory. -- The default owner of a directory is the user who creates the directory. -- A directory cannot be created for the following paths: - - The path contains special characters. - - The path is a relative path. - - The path is a symbolic link. - -- The following validity check is performed during directory creation: - - Check whether the path exists in the OS. If it does not exist, a message is displayed, indicating the potential risks. - - Check whether the database initial user omm has the R/W/X permissions for the OS path. If the user does not have all the permissions, a message is displayed, indicating the potential risks. - -- In openGauss, ensure that the path is the same on all the nodes. Otherwise, the path may fail to be found on some nodes when the directory is used. - -## Syntax - -``` -CREATE [OR REPLACE] DIRECTORY directory_name -AS 'path_name'; -``` - -## Parameter Description - -- **directory\_name** - - Specifies the name of a directory. - - Value range: a string. It must comply with the naming convention rule. - -- **path\_name** - - Specifies the OS path for which a directory is to be created. - - Value range: a valid OS path - - -## Examples - -``` --- Create a directory. -postgres=# CREATE OR REPLACE DIRECTORY dir as '/tmp/'; -``` - -## Helpful Links - -[ALTER DIRECTORY](alter-directory.md) and [DROP DIRECTORY](drop-directory.md) - diff --git a/content/en/docs/installation/Developerguide/create-foreign-table.md b/content/en/docs/installation/Developerguide/create-foreign-table.md deleted file mode 100644 index 42da008798007a6be37b5457a06d02b7d1a9b3c4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-foreign-table.md +++ /dev/null @@ -1,95 +0,0 @@ -# CREATE FOREIGN TABLE - -## Function - -**CREATE FOREIGN TABLE** creates a foreign table. - -## Precautions - -The foreign table does not support the use of system columns (such as tableoid, ctid, etc.). - -## Syntax - -``` -CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [ - column_name type_name [ OPTIONS ( option 'value' [, ... ] ) ] [ COLLATE collation ] [ column_constraint [ ... ] ] - [, ... ] -] ) - SERVER server_name -[ OPTIONS ( option 'value' [, ... ] ) ] - -The column_constraint can be: -[ CONSTRAINT constraint_name ] -{ NOT NULL | - NULL | - DEFAULT default_expr } -``` - -## Parameter Description - -- **IF NOT EXISTS** - - Sends a notice, but does not throw an error, if a table with the same name exists. - -- **table\_name** - - Specifies the name of a foreign table. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies the name of a column in the foreign table. - - Value range: a string. It must comply with the naming convention. - -- **type\_name** - - Specifies the data type of the column. - -- **SERVER server\_name** - - Specifies the server name of the foreign table. The default value is **mot\_server**. - -- **OPTIONS \( option 'value' \[, ... \] \)** - - Options are related to the new foreign table or the columns in the foreign table. The allowed option names and values are specified by each foreign data wrapper and verified with the verification function of the foreign data wrapper. The option name must be unique \(although table options and table column options can share the same name\). - - - Options supported by oracle\_fdw are as follows: - - **table** - - Name of a table on the Oracle server. The value must be the same as the table name recorded in the Oracle system catalog. Generally, the value consists of uppercase letters. - - - **schema** - - Schema \(or owner\) corresponding to the table. The value must be the same as the table name recorded in the Oracle system catalog. Generally, the value consists of uppercase letters. - - - Options supported by mysql\_fdw are as follows: - - **dbname** - - Name of the MySQL database. - - - **table\_name** - - Name of a table in the MySQL database. - - - Options supported by postgres\_fdw are as follows: - - **schema\_name** - - Schema name of a remote server. If this option is not specified, the schema name of the foreign table is used as the schema name of the remote server. - - - **table\_name** - - Table name of a remote server. If this option is not specified, the name of the foreign table is used as the table name of the remote server. - - - **column\_name** - - Column name of a table on a remote server. If this option is not specified, the column name of the foreign table is used as the column name of a table on a remote server. - - - - -## Helpful Links - -[ALTER FOREIGN TABLE](alter-foreign-table.md) and [DROP FOREIGN TABLE](drop-foreign-table.md) - diff --git a/content/en/docs/installation/Developerguide/create-function.md b/content/en/docs/installation/Developerguide/create-function.md deleted file mode 100644 index f6517af3b0d4b7516f2f0643652abc3de9486d96..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-function.md +++ /dev/null @@ -1,308 +0,0 @@ -# CREATE FUNCTION - -## Function - -**CREATE FUNCTION** creates a function. - -## Precautions - -- If the parameters or return values of a function have precision, the precision is not checked. -- When creating a function, you are advised to explicitly specify the schemas of tables in the function definition. Otherwise, the function may fail to be executed. -- **current\_schema** and **search\_path** specified by **SET** during function creation are invalid. **search\_path** and **current\_schema** before and after function execution should be the same. -- If a function has output parameters, the **SELECT** statement uses the default values of the output parameters when calling the function. When the **CALL** statement calls the function, it requires that the output parameters must be specified. When the **CALL** statement calls an overloaded **PACKAGE** function, it can use the default values of the output parameters. For details, see examples in [CALL](call.md). -- Only the functions compatible with PostgreSQL or those with the **PACKAGE** attribute can be overloaded. After **REPLACE** is specified, a new function is created instead of replacing a function if the number of parameters, parameter type, or return value is different. -- You can use the **SELECT** statement to specify different parameters using identical functions, but cannot use the **CALL** statement to call identical functions without the **PACKAGE** attribute. -- When you create a function, you cannot insert other agg functions out of the avg function or other functions. -- By default, the permissions to execute new functions are granted to **PUBLIC**. For details, see [GRANT](grant.md). You can revoke the default execution permissions from **PUBLIC** and grant them to other users as needed. To avoid the time window during which new functions can be accessed by all users, create functions in transactions and set function execution permissions. - -## Syntax - -- Syntax \(compatible with PostgreSQL\) for creating a customized function: - - ``` - CREATE [ OR REPLACE ] FUNCTION function_name - ( [ { argname [ argmode ] argtype [ { DEFAULT | := | = } expression ]} [, ...] ] ) - [ RETURNS rettype [ DETERMINISTIC ] | RETURNS TABLE ( { column_name column_type } [, ...] )] - LANGUAGE lang_name - [ - {IMMUTABLE | STABLE | VOLATILE } - | {SHIPPABLE | NOT SHIPPABLE} - | WINDOW - | [ NOT ] LEAKPROOF - | {CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT } - | {[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER | AUTHID DEFINER | AUTHID CURRENT_USER} - | {fenced | not fenced} - | {PACKAGE} - - | COST execution_cost - | ROWS result_rows - | SET configuration_parameter { {TO | =} value | FROM CURRENT }} - ][...] - { - AS 'definition' - } - - ``` - -- O syntax of creating a customized function: - - ``` - CREATE [ OR REPLACE ] FUNCTION function_name - ( [ { argname [ argmode ] argtype [ { DEFAULT | := | = } expression ] } [, ...] ] ) - RETURN rettype [ DETERMINISTIC ] - [ - {IMMUTABLE | STABLE | VOLATILE } - | {SHIPPABLE | NOT SHIPPABLE} - | {PACKAGE} - | {FENCED | NOT FENCED} - | [ NOT ] LEAKPROOF - | {CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT } - | {[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER | - AUTHID DEFINER | AUTHID CURRENT_USER - } - | COST execution_cost - | ROWS result_rows - | SET configuration_parameter { {TO | =} value | FROM CURRENT - - ][...] - - { - IS | AS - } plsql_body - / - ``` - - -## Parameter Description - -- **function\_name** - - Specifies the name of the function to create \(optionally schema-qualified\). - - Value range: a string. It must comply with the naming convention and up to 63 character strings. If there are more than 63 strings, the database will truncate the strings and reserve the first 63 strings as function_name. - -- **argname** - - Specifies the parameter name of the function. - - Value range: a string. It must comply with the naming convention and up to 63 character strings. If there are more than 63 strings, the database will truncate the strings and reserve the first 63 strings as function parameter names. - -- **argmode** - - Specifies the parameter mode of the function. - - Value range: **IN**, **OUT**, **INOUT**, and **VARIADIC**. The default value is **IN**. The parameters of **OUT** and **INOUT** cannot be used in the function definition of **RETURNS TABLE**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >**VARIADIC** specifies parameters of the array type. - -- **argtype** - - Specifies the data type of a function parameter. - -- **expression** - - Specifies the default expression of a parameter. - -- **rettype** - - Specifies the return data type. - - When there is **OUT** or **INOUT** parameter, the **RETURNS** clause can be omitted. If the clause exists, the result type of the clause must be the same as that of the output parameter. If there are multiple output parameters, the result type of the clause is **RECORD**. Otherwise, the result type of the clause is the same as that of a single output parameter. - - The **SETOF** modifier indicates that the function will return a set of items, rather than a single item. - -- **column\_name** - - Specifies the column name. - -- **column\_type** - - Specifies the column type. - -- **definition** - - Specifies a string constant defining a function. Its meaning depends on the language. It can be an internal function name, a path pointing to a target file, a SQL query, or text in a procedural language. - -- **DETERMINISTIC** - - Specifies an interface compatible with the SQL syntax. You are not advised to use it. - -- **LANGUAGE lang\_name** - - Specifies the name of the language that is used to implement the function. It can be **SQL**, **internal**, or the name of a customized process language. To ensure downward compatibility, the name can use single quotation marks. Contents in single quotation marks must be capitalized. - -- **WINDOW** - - Indicates that this function is a window function. The **WINDOW** attribute cannot be changed when replacing an existing function definition. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >For a customized window function, the value of **LANGUAGE** can only be **internal**, and the referenced internal function must be a window function. - -- **IMMUTABLE** - - Specifies that the function always returns the same result if the parameter values are the same. - -- **STABLE** - - Specifies that the function cannot modify the database, and that within a single table scan it will consistently return the same result for the same parameter value, but its result varies by SQL statements. - -- **VOLATILE** - - Specifies that the function value can change in a single table scan and no optimization is performed. - -- **SHIPPABLE | NOT SHIPPABLE** - - Specifies whether the function can be pushed down for execution. This interface is reserved and is not recommended. - -- **FENCED | NOT FENCED** - - Specifies whether the user-defined C function is executed in fenced or not-fenced mode. This interface is reserved and is not recommended. - -- **PACKAGE** - - Specifies whether the function can be overloaded. PostgreSQL-style functions can be overloaded, and this parameter is designed for functions of other styles. - - - All PACKAGE and non-PACKAGE functions cannot be overloaded or replaced. - - PACKAGE functions do not support parameters of the VARIADIC type. - - The **PACKAGE** attribute of functions cannot be modified. - -- **LEAKPROOF** - - Specifies that the function has no side effects. **LEAKPROOF** can be set only by the system administrator. - -- **CALLED ON NULL INPUT** - - Declares that some parameters of the function can be invoked in normal mode if the parameter values are null. This parameter can be omitted. - -- **RETURNS NULL ON NULL INPUT** - - **STRICT** - - Specifies that the function always returns null whenever any of its parameters is null. If this parameter is specified, the function is not executed when there are null parameters; instead a null result is returned automatically. - - **RETURNS NULL ON NULL INPUT** and **STRICT** have the same functions. - -- **EXTERNAL** - - The keyword **EXTERNAL** is allowed for SQL conformance, but it is optional since, unlike in SQL, this feature applies to all functions not only external ones. - -- **SECURITY INVOKER** - - **AUTHID CURRENT\_USER** - - Specifies that the function will be executed with the permissions of the user who invokes it. This parameter can be omitted. - - **SECURITY INVOKER** and **AUTHID CURRENT\_USER** have the same functions. - -- **SECURITY DEFINER** - - **AUTHID DEFINER** - - Specifies that the function will be executed with the permissions of the user who created it. - - **AUTHID DEFINER** and **SECURITY DEFINER** have the same functions. - -- **COST execution\_cost** - - Estimates the execution cost of a function. - - The unit of **execution\_cost** is **cpu\_operator\_cost**. - - Value range: a positive integer - -- **ROWS result\_rows** - - Estimates the number of rows returned by the function. This is only allowed when the function is declared to return a set. - - Value range: a positive number. The default value is **1000**. - -- **configuration\_parameter** - - **value** - - Sets a specified database session parameter to a specified value. If the value is **DEFAULT** or **RESET**, the default setting is used in the new session. **OFF** closes the setting. - - Value range: a string - - - DEFAULT - - OFF - - RESET - - Specifies the default value. - - - **from current** - - Uses the value of **configuration\_parameter** of the current session. - - -- **plsql\_body** - - Specifies the PL/SQL stored procedure body. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >When a user is created in the function body, the plaintext password is recorded in the log. You are not advised to do it. - - -## Examples - -``` --- Define a function as SQL query. -postgres=# CREATE FUNCTION func_add_sql(integer, integer) RETURNS integer - AS 'select $1 + $2;' - LANGUAGE SQL - IMMUTABLE - RETURNS NULL ON NULL INPUT; - --- Add an integer by parameter name using PL/pgSQL. -postgres=# CREATE OR REPLACE FUNCTION func_increment_plsql(i integer) RETURNS integer AS $$ - BEGIN - RETURN i + 1; - END; -$$ LANGUAGE plpgsql; - --- Return the RECORD type. -postgres=# CREATE OR REPLACE FUNCTION func_increment_sql(i int, out result_1 bigint, out result_2 bigint) -returns SETOF RECORD -as $$ -begin - result_1 = i + 1; - result_2 = i * 10; -return next; -end; -$$language plpgsql; - --- Return a record containing multiple output parameters. -postgres=# CREATE FUNCTION func_dup_sql(in int, out f1 int, out f2 text) - AS $$ SELECT $1, CAST($1 AS text) || ' is text' $$ - LANGUAGE SQL; - -postgres=# SELECT * FROM func_dup_sql(42); - --- Compute the sum of two integers and return the result (if the input is null, the returned result is null). -postgres=# CREATE FUNCTION func_add_sql2(num1 integer, num2 integer) RETURN integer -AS -BEGIN -RETURN num1 + num2; -END; -/ --- Alter the execution rule of function func_add_sql2 to IMMUTABLE (that is, the same result is returned if the parameter remains unchanged). -postgres=# ALTER FUNCTION func_add_sql2(INTEGER, INTEGER) IMMUTABLE; - --- Alter the name of function func_add_sql2 to add_two_number. -postgres=# ALTER FUNCTION func_add_sql2(INTEGER, INTEGER) RENAME TO add_two_number; - --- Change the owner of function add_two_number to omm. -postgres=# ALTER FUNCTION add_two_number(INTEGER, INTEGER) OWNER TO omm; - --- Delete the function. -postgres=# DROP FUNCTION add_two_number; -postgres=# DROP FUNCTION func_increment_sql; -postgres=# DROP FUNCTION func_dup_sql; -postgres=# DROP FUNCTION func_increment_plsql; -postgres=# DROP FUNCTION func_add_sql; -``` - -## Helpful Links - -[ALTER FUNCTION](alter-function.md) and [DROP FUNCTION](drop-function.md) - diff --git a/content/en/docs/installation/Developerguide/create-group.md b/content/en/docs/installation/Developerguide/create-group.md deleted file mode 100644 index 5e56391ce20798e011c6b401833c2aafe04f1012..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-group.md +++ /dev/null @@ -1,56 +0,0 @@ -# CREATE GROUP - -## Function - -**CREATE GROUP** creates a user group. - -## Precautions - -**CREATE GROUP** is an alias for **CREATE ROLE**, and it is not a standard SQL syntax and not recommended. Users can use **CREATE ROLE** directly. - -## Syntax - -``` -CREATE GROUP group_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' | DISABLE }; -``` - -The syntax of the **option** clause is as follows: - -``` -{SYSADMIN | NOSYSADMIN} - | {AUDITADMIN | NOAUDITADMIN} - | {CREATEDB | NOCREATEDB} - | {USEFT | NOUSEFT} - | {CREATEROLE | NOCREATEROLE} - | {INHERIT | NOINHERIT} - | {LOGIN | NOLOGIN} - | {REPLICATION | NOREPLICATION} - | {INDEPENDENT | NOINDEPENDENT} - | {VCADMIN | NOVCADMIN} - | CONNECTION LIMIT connlimit - | VALID BEGIN 'timestamp' - | VALID UNTIL 'timestamp' - | RESOURCE POOL 'respool' - | PERM SPACE 'spacelimit' - | TEMP SPACE 'tmpspacelimit' - | SPILL SPACE 'spillspacelimit' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN rol e_name [, ...] - | USER role_name [, ...] - | SYSID uid - | DEFAULT TABLESPACE tablespace_name - | PROFILE DEFAULT - | PROFILE profile_name - | PGUSER -``` - -## Parameter Description - -See [Parameter Description](create-role.md#en-us_topic_0237122112_en-us_topic_0059778189_s5a43ec5742a742089e2c302063de7fe4) in **CREATE ROLE**. - -## Helpful Links - -[ALTER GROUP](alter-group.md), [DROP GROUP](drop-group.md), and [CREATE ROLE](create-role.md) - diff --git a/content/en/docs/installation/Developerguide/create-index.md b/content/en/docs/installation/Developerguide/create-index.md deleted file mode 100644 index af2967dfabc39c2cbc1d2268a87acae09e1331e1..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-index.md +++ /dev/null @@ -1,314 +0,0 @@ -# CREATE INDEX - -## Function - -**CREATE INDEX** creates an index in a specified table. - -Indexes are primarily used to enhance database performance \(though inappropriate use can result in database performance deterioration\). You are advised to create indexes on: - -- Columns that are often queried -- Join conditions. For a query on joined columns, you are advised to create a composite index on the columns, for example, **select \* from t1 join t2 on t1.a=t2.a and t1.b=t2.b**. You can create a composite index on columns **a** and **b** in table **t1**. -- Columns having filter criteria \(especially scope criteria\) of a **where** clause -- Columns that appear after **order by**, **group by**, and **distinct** - -Partitioned tables do not support concurrent index creation, partial index creation, and **NULL FIRST**. - -## Precautions - -- Indexes consume storage and computing resources. Creating too many indexes has negative impact on database performance \(especially the performance of data import. Therefore, you are advised to import the data before creating indexes\). Therefore, create indexes only when they are necessary. -- All functions and operators used in an index definition must be immutable, that is, their results must depend only on their parameters and never on any outside influence \(such as the contents of another table or the current time\). This restriction ensures that the behavior of the index is well-defined. To use a customized function in an index expression or **WHERE** clause, remember to mark the function **immutable** when you create it. -- A unique index created on a partitioned table must include a partitioned column and all the partition keys. -- Column-store tables support B-tree and psort indexes. If the two indexes are used, you cannot create expression, partial, and unique indexes. -- Column-store tables support GIN indexes, rather than partial indexes and unique indexes. If GIN indexes are used, you can create expression indexes. However, an expression in this situation cannot contain empty splitters, empty columns, or multiple columns. - -## Syntax - -- Create an index on a table. - - ``` - CREATE [ UNIQUE ] INDEX [ [schemaname.]index_name ] ON table_name [ USING method ] - ({ { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] }[, ...] ) - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ TABLESPACE tablespace_name ] - [ WHERE predicate ]; - ``` - -- Create an index on a partitioned table. - - ``` - CREATE [ UNIQUE ] INDEX [ [schemaname.]index_name ] ON table_name [ USING method ] - ( {{ column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS LAST ] }[, ...] ) - LOCAL [ ( { PARTITION index_partition_name [ TABLESPACE index_partition_tablespace ] } [, ...] ) ] - [ WITH ( { storage_parameter = value } [, ...] ) ] - [ TABLESPACE tablespace_name ]; - ``` - - -## Parameter Description - -- **UNIQUE** - - Creates a unique index. In this way, the system checks whether new values are unique in the index column. Attempts to insert or update data which would result in duplicate entries will generate an error. - - Currently, only B-tree supports **UNIQUE** indexes. - -- **schema\_name** - - Specifies the schema name. - - Value range: an existing schema name - -- **index\_name** - - Specifies the name of the index to create. No schema name can be included here; the index is always created in the same schema as its parent table. - - Value range: a string. It must comply with the naming convention. - -- **table\_name** - - Specifies the name of the table to be indexed \(optionally schema-qualified\). - - Value range: an existing table name - -- **USING method** - - Specifies the name of the index method to be used. - - Value range: - - - **btree**: B-tree indexes store key values of data in a B+ tree structure. This structure helps users to quickly search for indexes. B-tree supports comparison queries with a scope specified. - - **gin**: GIN indexes are reverse indexes and can process values that contain multiple keys \(for example, arrays\). - - **gist**: GiST indexes are suitable for the set data type and multidimensional data types, such as geometric and geographic data types. - - **Psort**: psort index. It is used to perform partial sort on column-store tables. - - Row-store tables support the following index types: **btree** \(default\), **gin**, and **gist**. Column-store tables support the following index types: **Psort** \(default\), **btree**, and **gin**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >Column-store tables support GIN indexes only for the tsvector type. That is, the input parameter for creating a column-store GIN index must be the return value of the **to\_tsvector** function. This method is commonly used for GIN indexes. - -- **column\_name** - - Specifies the name of the column on which an index is to be created. - - Multiple columns can be specified if the index method supports multi-column indexes. A maximum of 32 columns can be specified. - -- **expression** - - Specifies an expression based on one or more columns of the table. The expression usually must be written with surrounding parentheses, as shown in the syntax. However, the parentheses can be omitted if the expression has the form of a function call. - - Expression can be used to obtain fast access to data based on some transformation of the basic data. For example, an index computed on **upper\(col\)** would allow the clause **WHERE upper\(col\) = 'JIM'** to use an index. - - If an expression contains **IS NULL**, the index for this expression is invalid. In this case, you are advised to create a partial index. - -- **COLLATE collation** - - Assigns a collation to the column \(which must be of a collatable data type\). If no collation is specified, the default collation is used. - -- **opclass** - - Specifies the name of an operator class. An operator class can be specified for each column of an index. The operator class identifies the operators to be used by the index for that column. For example, a B-tree index on the type int4 would use the **int4\_ops** class; this operator class includes comparison functions for values of type int4. In practice, the default operator class for the column's data type is sufficient. The operator class applies to data with multiple sorts. For example, users might want to sort a complex-number data type either by absolute value or by real part. They could do this by defining two operator classes for the data type and then selecting the proper class when making an index. - -- **ASC** - - Specifies an ascending \(default\) sort order. - -- **DESC** - - Specifies a descending sort order. - -- **NULLS FIRST** - - Specifies that null values appear before non-null values in the sort ordering. This is the default when **DESC** is specified. - -- **NULLS LAST** - - Specifies that null values appear after non-null values in the sort ordering. This is the default when **DESC** is not specified. - -- **WITH \( \{storage\_parameter = value\} \[, ... \] \)** - - Specifies the storage parameter used for an index. - - Value range: - - Only index GIN supports parameters **FASTUPDATE** and **GIN\_PENDING\_LIST\_LIMIT**. Indexes other than GIN and psort support the **FILLFACTOR** parameter. - - - FILLFACTOR - - The fill factor of an index is a percentage from 10 to 100. - - Value range: 10–100 - - - FASTUPDATE - - Specifies whether fast update is enabled for the GIN index. - - Value range: : **ON** and **OFF** - - Default value: **ON** - - - GIN\_PENDING\_LIST\_LIMIT - - Specifies the maximum capacity of the pending list of the GIN index when fast update is enabled for the GIN index. - - Value range: 64–_INT\_MAX_. The unit is KB. - - Default value: The default value of **gin\_pending\_list\_limit** depends on **gin\_pending\_list\_limit** specified in GUC parameters. By default, the value is **4**. - - -- **TABLESPACE tablespace\_name** - - Specifies the tablespace for an index. If no tablespace is specified, the default tablespace is used. - - Value range: an existing table name - -- **WHERE predicate** - - Creates a partial index. A partial index is an index that contains entries for only a portion of a table, usually a portion that is more useful for indexing than the rest of the table. For example, if you have a table that contains both billed and unbilled orders where the unbilled orders take up a small fraction of the total table and yet that is an often used portion, you can improve performance by creating an index on just that portion. In addition, **WHERE** with **UNIQUE** can be used to enforce uniqueness over a subset for a table. - - Value range: The predicate expression can only refer to columns of the underlying table, but it can use all columns, not just the ones being indexed. Currently, subqueries and aggregate expressions are forbidden in **WHERE**. - -- **PARTITION index\_partition\_name** - - Specifies the name of an index partition. - - Value range: a string. It must comply with the naming convention. - -- **TABLESPACE index\_partition\_tablespace** - - Specifies the tablespace of an index partition. - - Value range: If this parameter is not specified, the value of **index\_tablespace** is used. - - -## Examples - -``` --- Create the tpcds.ship_mode_t1 table. -postgres=# create schema tpcds; -postgres=# CREATE TABLE tpcds.ship_mode_t1 -( - SM_SHIP_MODE_SK INTEGER NOT NULL, - SM_SHIP_MODE_ID CHAR(16) NOT NULL, - SM_TYPE CHAR(30) , - SM_CODE CHAR(10) , - SM_CARRIER CHAR(20) , - SM_CONTRACT CHAR(20) -) -; - --- Create a common index on the SM_SHIP_MODE_SK column in the tpcds.ship_mode_t1 table. -postgres=# CREATE UNIQUE INDEX ds_ship_mode_t1_index1 ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK); - --- Create a B-tree index on the SM_SHIP_MODE_SK column in the tpcds.ship_mode_t1 table. -postgres=# CREATE INDEX ds_ship_mode_t1_index4 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK); - --- Create an expression index on the SM_CODE column in the tpcds.ship_mode_t1 table: -postgres=# CREATE INDEX ds_ship_mode_t1_index2 ON tpcds.ship_mode_t1(SUBSTR(SM_CODE,1 ,4)); - --- Create a partial index on the SM_SHIP_MODE_SK column where SM_SHIP_MODE_SK is greater than 10 in the tpcds.ship_mode_t1 table. -postgres=# CREATE UNIQUE INDEX ds_ship_mode_t1_index3 ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK) WHERE SM_SHIP_MODE_SK>10; - --- Rename an existing index. -postgres=# ALTER INDEX tpcds.ds_ship_mode_t1_index1 RENAME TO ds_ship_mode_t1_index5; - --- Set the index as unusable. -postgres=# ALTER INDEX tpcds.ds_ship_mode_t1_index2 UNUSABLE; - --- Rebuild an index. -postgres=# ALTER INDEX tpcds.ds_ship_mode_t1_index2 REBUILD; - --- Delete an existing index. -postgres=# DROP INDEX tpcds.ds_ship_mode_t1_index2; - --- Delete the table. -postgres=# DROP TABLE tpcds.ship_mode_t1; - --- Create a tablespace. -postgres=# CREATE TABLESPACE example1 RELATIVE LOCATION 'tablespace1/tablespace_1'; -postgres=# CREATE TABLESPACE example2 RELATIVE LOCATION 'tablespace2/tablespace_2'; -postgres=# CREATE TABLESPACE example3 RELATIVE LOCATION 'tablespace3/tablespace_3'; -postgres=# CREATE TABLESPACE example4 RELATIVE LOCATION 'tablespace4/tablespace_4'; --- Create the tpcds.customer_address_p1 table. -postgres=# CREATE TABLE tpcds.customer_address_p1 -( - CA_ADDRESS_SK INTEGER NOT NULL, - CA_ADDRESS_ID CHAR(16) NOT NULL, - CA_STREET_NUMBER CHAR(10) , - CA_STREET_NAME VARCHAR(60) , - CA_STREET_TYPE CHAR(15) , - CA_SUITE_NUMBER CHAR(10) , - CA_CITY VARCHAR(60) , - CA_COUNTY VARCHAR(30) , - CA_STATE CHAR(2) , - CA_ZIP CHAR(10) , - CA_COUNTRY VARCHAR(20) , - CA_GMT_OFFSET DECIMAL(5,2) , - CA_LOCATION_TYPE CHAR(20) -) -TABLESPACE example1 -PARTITION BY RANGE(CA_ADDRESS_SK) -( - PARTITION p1 VALUES LESS THAN (3000), - PARTITION p2 VALUES LESS THAN (5000) TABLESPACE example1, - PARTITION p3 VALUES LESS THAN (MAXVALUE) TABLESPACE example2 -) -ENABLE ROW MOVEMENT; --- Create the partitioned table index ds_customer_address_p1_index1 without specifying the index partition name. -postgres=# CREATE INDEX ds_customer_address_p1_index1 ON tpcds.customer_address_p1(CA_ADDRESS_SK) LOCAL; --- Create the partitioned table index ds_customer_address_p1_index2 with the name of the index partition specified. -postgres=# CREATE INDEX ds_customer_address_p1_index2 ON tpcds.customer_address_p1(CA_ADDRESS_SK) LOCAL -( - PARTITION CA_ADDRESS_SK_index1, - PARTITION CA_ADDRESS_SK_index2 TABLESPACE example3, - PARTITION CA_ADDRESS_SK_index3 TABLESPACE example4 -) -TABLESPACE example2; - --- Change the tablespace of the partitioned table index CA_ADDRESS_SK_index2 to example1. -postgres=# ALTER INDEX tpcds.ds_customer_address_p1_index2 MOVE PARTITION CA_ADDRESS_SK_index2 TABLESPACE example1; - --- Change the tablespace of the partitioned table index CA_ADDRESS_SK_index3 to example2. -postgres=# ALTER INDEX tpcds.ds_customer_address_p1_index2 MOVE PARTITION CA_ADDRESS_SK_index3 TABLESPACE example2; - --- Rename a partitioned table index. -postgres=# ALTER INDEX tpcds.ds_customer_address_p1_index2 RENAME PARTITION CA_ADDRESS_SK_index1 TO CA_ADDRESS_SK_index4; - --- Delete the created indexes and the partitioned table. -postgres=# DROP INDEX tpcds.ds_customer_address_p1_index1; -postgres=# DROP INDEX tpcds.ds_customer_address_p1_index2; -postgres=# DROP TABLE tpcds.customer_address_p1; --- Delete the tablespace. -postgres=# DROP TABLESPACE example1; -postgres=# DROP TABLESPACE example2; -postgres=# DROP TABLESPACE example3; -postgres=# DROP TABLESPACE example4; - --- Create a column-store table and its GIN index: -postgres=# create table cgin_create_test(a int, b text) with (orientation = column); -CREATE TABLE -postgres=# create index cgin_test on cgin_create_test using gin(to_tsvector('ngram', b)); -CREATE INDEX -``` - -## Helpful Links - -[ALTER INDEX](alter-index.md) and [DROP INDEX](drop-index.md) - -## Suggestions - -- create index - - You are advised to create indexes on: - - - Columns that are often queried - - Join conditions. For a query on joined columns, you are advised to create a composite index on the columns, for example, **select \* from t1 join t2 on t1.a=t2.a and t1.b=t2.b**. You can create a composite index on columns **a** and **b** in table **t1**. - - Columns having filter criteria \(especially scope criteria\) of a **where** clause - - Columns that appear after **order by**, **group by**, and **distinct** - - Constraints: - - - Partitioned tables do not support partial indexes or the **NULL FIRST** feature. - - - A unique index created on a partitioned table must include a partitioned column and all the partition keys. - - diff --git a/content/en/docs/installation/Developerguide/create-materialized-view.md b/content/en/docs/installation/Developerguide/create-materialized-view.md deleted file mode 100644 index d1d8cf88a951035c7dad93af4d7e725f673e5fab..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-materialized-view.md +++ /dev/null @@ -1,79 +0,0 @@ -# CREATE MATERIALIZED VIEW - -## Function - -**CREATE MATERIALIZED VIEW** defines a materialized view for query. When this command is delivered, the query is executed and used to fill the view \(unless WITH NO DATA is used\), and the **REFRESH MATERIALIZED VIEW** command can be used to refresh data. - -CREATE MATERIALIZED VIEW is similar to CREATE TABLE AS, but it remembers the query used to initialize the view, so it can refresh data later. A materialized view has many attributes that are the same as those of a table, but does not support temporary materialized views. - -## Precautions - -- Materialized views cannot be created on temporary tables or global temporary tables. -- After a materialized view is created, you need to run the **REFRESH** command to synchronize the materialized view with the base table when the data in the base table changes. - -## Syntax - -``` -CREATE MATERIALIZED VIEW mv_name - [ (column_name [, ...] ) ] - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ TABLESPACE tablespace_name ] - AS query - [ WITH [ NO ] DATA ]; -``` - -## Parameter Description - -- **mv\_name** - - Specifies the name \(optionally schema-qualified\) of the materialized view to be created. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies a column name in the new materialized view. The materialized view supports specified columns. The number of specified columns must be the same as the number of columns in the result of the subsequent query statement. If no column name is provided, the column name is obtained from the output column name of the query. - - Value range: a string. It must comply with the naming convention. - -- **WITH \( storage\_parameter \[= value\] \[, ... \] \)** - - Specifies an optional storage parameter for a table or an index. CREATE MATERIALIZED VIEW supports all parameters supported by CREATE TABLE ,except **OIDS**. For details, see [CREATE TABLE](en-us_topic_0242370581.md). - -- **TABLESPACE tablespace\_name** - - Tablespace to which the new materialized view belongs. If not specified, the default tablespace is used. - -- **AS query** - - Specifies the **SELECT**, **TABLE**, or **VALUES** command. This query will be run in a security-constrained operation. - -- **\[ WITH \[ NO \] DATA \]** - - Specifies whether the data produced by the query should be copied to the new materialized view. By default, the data will be copied. If the value **NO** is used, no data is copied. - - -## Examples - -``` --- Create the tpcds.store_returns table. -postgres=# CREATE TABLE tpcds.store_returns -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - sr_item_sk VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER -); --- Create the materialized view tpcds.store_returns_mv based on the tpcds.store_returns base table. -postgres=# CREATE MATERIALIZED VIEW tpcds.store_returns_mv AS SELECT * FROM tpcds.store_returns'; - --- Use tpcds.store_returns to copy a new table tpcds.store_returns_mv2 as a materialized view. -postgres=# CREATE MATERIALIZED VIEW tpcds.store_returns_mv2 AS table tpcds.store_returns; --- Delete the table. -postgres=# DROP MATERIALIZED VIEW tpcds.store_returns_mv cascade; -``` - -## Helpful Links - -[CREATE TABLE](en-us_topic_0242370581.md), [DROP MATERIALIZED VIEW](drop-materialized-view.md), [ALTER MATERIALIZED VIEW](alter-materialized-view.md), and [REFRESH MATERIALIZED VIEW](refresh-materialized-view.md) - diff --git a/content/en/docs/installation/Developerguide/create-procedure.md b/content/en/docs/installation/Developerguide/create-procedure.md deleted file mode 100644 index ba8587df31d264791ad7b2bd982351179d2aa274..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-procedure.md +++ /dev/null @@ -1,110 +0,0 @@ -# CREATE PROCEDURE - -## Function - -**CREATE PROCEDURE** creates a stored procedure. - -## Precautions - -- If the parameters or return values of a stored procedure have precision, the precision is not checked. -- When creating a stored procedure, you are advised to explicitly specify the schemas of all operations on table objects in the stored procedure definition. Otherwise, the stored procedure may fail to be executed. -- **current\_schema** and **search\_path** specified by **SET** during stored procedure creation are invalid. **search\_path** and **current\_schema** before and after function execution should be the same. -- If a stored procedure has output parameters, the **SELECT** statement uses the default values of the output parameters when calling the procedure. When the **CALL** statement calls the stored procedure or a non-overloaded function, output parameters must be specified. When the **CALL** statement calls an overloaded **PACKAGE** function, it can use the default values of the output parameters. For details, see examples in [CALL](call.md). -- A stored procedure with the **PACKAGE** attribute can use overloaded functions. -- When you create a procedure, you cannot insert aggregate functions or other functions out of the average function. - -## Syntax - -``` -CREATE [ OR REPLACE ] PROCEDURE procedure_name - [ ( {[ argmode ] [ argname ] argtype [ { DEFAULT | := | = } expression ]}[,...]) ] - [ - { IMMUTABLE | STABLE | VOLATILE } - | { SHIPPABLE | NOT SHIPPABLE } - | {PACKAGE} - | [ NOT ] LEAKPROOF - | { CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT } - | {[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER | AUTHID DEFINER | AUTHID CURRENT_USER} - | COST execution_cost - | SET configuration_parameter { TO value| = value | FROM CURRENT } - ][ ... ] - { IS | AS } -plsql_body -/ -``` - -## Parameter Description - -- **OR REPLACE** - - Replaces the original definition when two stored procedures are with the same name. - -- **procedure\_name** - - Specifies the name of the stored procedure that is created \(optionally with schema names\). - - Value range: a string. It must comply with the naming convention. - -- **argmode** - - Specifies the mode of an argument. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >**VARIADIC** specifies parameters of the array type. - - Value range: **IN**, **OUT**, **INOUT**, and **VARIADIC**. The default value is **IN**. Only the parameter of the **OUT** mode can follow **VARIADIC**. - -- **argname** - - Specifies the argument name. - - Value range: a string. It must comply with the naming convention. - -- **argtype** - - Specifies the type of an argument. - - Value range: a valid data type - -- **configuration\_parameter** - - - **value** - - Sets a specified database session parameter to a specified value. If the value is **DEFAULT**, the default setting is used in the new session. **OFF** closes the setting. - - Value range: a string - - - DEFAULT - - OFF - - Specifies the default value. - - - **from current** - - Uses the value of **configuration\_parameter** of the current session. - -- **IMMUTABLE, STABLE,**... - - Specifies a constraint. The function of each parameter is similar to that of **CREATE FUNCTION**. For details, see [CREATE FUNCTION](create-function.md). - -- **plsql\_body** - - Specifies the PL/SQL stored procedure body. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >When you create a user, or perform other operations requiring password input in a stored procedure, the system catalog and CSV log record the password in plaintext. Therefore, you are advised not to perform such operations in the stored procedure. - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->No specific order is applied to **argument\_name** and **argmode**. The following order is advised: **argument\_name**, **argmode**, and **argument\_type**. - -## Helpful Links - -[DROP PROCEDURE](drop-procedure.md) - -## Suggestions - -- analyse | analyze - - Do not run **ANALYZE** in a transaction or anonymous block. - - Do not run **ANALYZE** in a function or stored procedure. - - diff --git a/content/en/docs/installation/Developerguide/create-role.md b/content/en/docs/installation/Developerguide/create-role.md deleted file mode 100644 index 2b1eab5c07decf97c520eae00ceded60d670159f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-role.md +++ /dev/null @@ -1,236 +0,0 @@ -# CREATE ROLE - -## Function - -**CREATE ROLE** is used to create a role. - -A role is an entity that owns database objects and permissions. In different environments, a role can be considered a user, a group, or both. - -## Precautions - -- **CREATE ROLE** adds a role to a database. The role does not have the **LOGIN** permission. -- Only the user who has the **CREATE ROLE** permission or a system administrator is allowed to create roles. - -## Syntax - -``` -CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' | DISABLE }; -``` - -The syntax of role information configuration clause **option** is as follows: - -``` -{SYSADMIN | NOSYSADMIN} - | {AUDITADMIN | NOAUDITADMIN} - | {CREATEDB | NOCREATEDB} - | {USEFT | NOUSEFT} - | {CREATEROLE | NOCREATEROLE} - | {INHERIT | NOINHERIT} - | {LOGIN | NOLOGIN} - | {REPLICATION | NOREPLICATION} - | {INDEPENDENT | NOINDEPENDENT} - | {VCADMIN | NOVCADMIN} - | CONNECTION LIMIT connlimit - | VALID BEGIN 'timestamp' - | VALID UNTIL 'timestamp' - | RESOURCE POOL 'respool' - | PERM SPACE 'spacelimit' - | TEMP SPACE 'tmpspacelimit' - | SPILL SPACE 'spillspacelimit' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN rol e_name [, ...] - | USER role_name [, ...] - | SYSID uid - | DEFAULT TABLESPACE tablespace_name - | PROFILE DEFAULT - | PROFILE profile_name - | PGUSER -``` - -## Parameter Description - -- **role\_name** - - Specifies the name of a role. - - Value range: a string. It must comply with the naming convention rule, and can contain a maximum of 63 characters. If the value contains more than 63 characters, the database truncates it and retains the first 63 characters as the role name. When a role is created, the database will display a message. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The identifier must be letters, underscores \(\_\), digits \(0-9\), or dollar signs \($\) and must start with a letter \(a-z\) or underscore \(\_\). - -- **password** - - Specifies the login password. - - The new password must: - - - Contain at least eight characters. This is the default length. - - Differ from the username or the username spelled backward. - - Contain at least three types of the following four types of characters: uppercase characters \(A to Z\), lowercase characters \(a to z\), digits \(0 to 9\), and special characters, including: \~!@\#$%^&\*\(\)-\_=+\\|\[\{\}\];:,<.\>/? - - Value range: a string - -- DISABLE - - By default, you can change your password unless it is disabled. To disable the password of a user, use this parameter. After the password of a user is disabled, the password will be deleted from the system. The user can connect to the database only through external authentication, for example, Kerberos authentication. Only administrators can enable or disable a password. Common users cannot disable the password of an initial user. To enable a password, run **ALTER USER** and specify the password. - -- **ENCRYPTED | UNENCRYPTED** - - Controls whether the password is stored encrypted in the system catalogs. \(If neither is specified, the default behavior is determined by the configuration parameter **password\_encryption**.\) According to product security requirement, the password must be stored encrypted. Therefore, **UNENCRYPTED** is forbidden in openGauss. If the password string has already been encrypted in the SHA256 format, it is stored encrypted as it was, regardless of whether **ENCRYPTED** or **UNENCRYPTED** is specified \(since the system cannot decrypt the specified encrypted password string\). This allows reloading of encrypted passwords during dump/restore. - -- **SYSADMIN | NOSYSADMIN** - - Determines whether a new role is a system administrator. Roles having the **SYSADMIN** attribute have the highest permission. - - Value range: If not specified, **NOSYSADMIN** is the default. - -- **AUDITADMIN | NOAUDITADMIN** - - Determines whether a role has the audit and management attributes. - - If not specified, **NOAUDITADMIN** is the default. - -- **CREATEDB | NOCREATEDB** - - Determines a role's permission to create databases. - - A new role does not have the permission to create databases. - - Value range: If not specified, **NOCREATEDB** is the default. - -- **USEFT | NOUSEFT** - - This parameter is reserved and not used in this version. - -- **CREATEROLE | NOCREATEROLE** - - Determines whether a role will be permitted to create new roles \(that is, execute **CREATE ROLE** and **CREATE USER**\). A role with the **CREATEROLE** permission can also modify and delete other roles. - - Value range: If not specified, **NOCREATEROLE** is the default. - -- **INHERIT | NOINHERIT** - - Determines whether a role "inherits" the permissions of roles in the same group. You are not advised to set this parameter. - -- **LOGIN | NOLOGIN** - - Determines whether a role is allowed to log in to a database. A role having the **LOGIN** attribute can be considered as a user. - - Value range: If not specified, **NOLOGIN** is the default. - -- **REPLICATION | NOREPLICATION** - - Determines whether a role is allowed to initiate streaming replication or put the system in and out of backup mode. A role having the **REPLICATION** attribute is specific to replication. - - If not specified, **NOREPLICATION** is the default. - -- **INDEPENDENT | NOINDEPENDENT** - - Defines private, independent roles. For a role with the **INDEPENDENT** attribute, administrators' permissions to control and access this role are separated. The rules are as follows: - - - Administrators have no permission to add, delete, query, modify, copy, or authorize the corresponding table objects without the authorization from the **INDEPENDENT** role. - - System administrators and security administrators with the **CREATEROLE** attribute have no permission to modify the inheritance relationship of the **INDEPENDENT** role without the authorization of the **INDEPENDENT** role. - - System administrators have no permission to modify the owner of the table objects for the **INDEPENDENT** role. - - System administrators and security administrators with the **CREATEROLE** attribute have no permission to remove the **INDEPENDENT** attribute of the **INDEPENDENT** role. - - System administrators and security administrators with the **CREATEROLE** attribute have no permission to change the database password of the **INDEPENDENT** role. The **INDEPENDENT** role must manage its own password. If the password is lost, it cannot be reset. - - The **SYSADMIN** attribute of a user cannot be changed to the **INDEPENDENT** attribute. - -- **CONNECTION LIMIT** - - Specifies how many concurrent connections the role can make. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- The system administrator is not restricted by this parameter. - >- The number of concurrent connections of each primary database node is calculated separately \(which is the value of **connlimit**\). The number of all connections of openGauss = Value of **connlimit** x Number of normal primary database nodes. - - Value range: an integer greater than or equal to -1. The default value is **-1**, which means unlimited. - -- **VALID BEGIN** - - Sets a date and time when the role's password takes effect. If this clause is omitted, the password takes effect immediately. - -- **VALID UNTIL** - - Sets a date and time after which the role's password is no longer valid. If this clause is omitted, the password will be valid for all time. - -- **RESOURCE POOL** - - Sets the name of resource pool used by the role. The name belongs to the system catalog **pg\_resource\_pool**. - -- **PERM SPACE** - - Sets the space available for a user. - -- **TEMP SPACE** - - Sets the space allocated to the temporary table of a user. - -- **SPILL SPACE** - - Sets the operator disk flushing space of a user. - -- **IN ROLE** - - Lists one or more existing roles to which the new role will be immediately added as a new member. You are not advised to set this parameter. - -- **IN GROUP** - - Specifies an obsolete spelling of **IN ROLE**. You are not advised to set this parameter. - -- **ROLE** - - Lists one or more existing roles which are automatically added as members of the new role. - -- **ADMIN** - - Similar to **ROLE**. However, **ADMIN** grants permissions of new roles to other roles. - -- **USER** - - Specifies an obsolete spelling of the **ROLE** clause. - -- **SYSID** - - The **SYSID** clause is ignored. - -- **DEFAULT TABLESPACE** - - The **DEFAULT TABLESPACE** clause is ignored. - -- **PROFILE** - - The **PROFILE** clause is ignored. - -- **PGUSER** - - In the current version, this attribute is reserved only for forward compatibility. - - -## Example: - -``` --- Create role manager whose password is Bigdata123@. -postgres=# CREATE ROLE manager IDENTIFIED BY 'Bigdata@123'; - --- Create a role with its validity from January 1, 2015 to January 1, 2026. -postgres=# CREATE ROLE miriam WITH LOGIN PASSWORD 'Bigdata@123' VALID BEGIN '2015-01-01' VALID UNTIL '2026-01-01'; - --- Change the password of role manager to abcd@123. -postgres=# ALTER ROLE manager IDENTIFIED BY 'abcd@123' REPLACE 'Bigdata@123'; - --- Change role manager to the system administrator. -postgres=# ALTER ROLE manager SYSADMIN; - --- Delete role manager. -postgres=# DROP ROLE manager; - --- Delete role miriam. -postgres=# DROP ROLE miriam; -``` - -## Helpful Links - -[SET ROLE](set-role.md), [ALTER ROLE](alter-role.md), [DROP ROLE](drop-role.md), and [GRANT](grant.md) - diff --git a/content/en/docs/installation/Developerguide/create-row-level-security-policy.md b/content/en/docs/installation/Developerguide/create-row-level-security-policy.md deleted file mode 100644 index 5a4347601b950a8394532ceebb4e44655f8f7e46..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-row-level-security-policy.md +++ /dev/null @@ -1,224 +0,0 @@ -# CREATE ROW LEVEL SECURITY POLICY - -## Function - -**CREATE ROW LEVEL SECURITY POLICY** creates a row-level access control policy for a table. - -The policy takes effect only after row-level access control is enabled \(by running **ALTER TABLE... ENABLE ROW LEVEL SECURITY**\). Otherwise, this statement does not take effect. - -Currently, row-level access control affects the read \(**SELECT**, **UPDATE**, **DELETE**\) of data tables and does not affect the write \(**INSERT** and **MERGE INTO**\) of data tables. The table owner or system administrators can create an expression in the **USING** clause. When the client reads the data table, the database server combines the expressions that meet the condition and applies it to the execution plan in the statement rewriting phase of a query. For each tuple in a data table, if the expression returns **TRUE**, the tuple is visible to the current user; if the expression returns **FALSE** or **NULL**, the tuple is invisible to the current user. - -A row-level access control policy name is specific to a table. A data table cannot have row-level access control policies with the same name. Different data tables can have the same row-level access control policy. - -Row-level access control policies can be applied to specified operations \(**SELECT**, **UPDATE**, **DELETE**, and **ALL**\). **ALL** indicates that **SELECT**, **UPDATE**, and **DELETE** will be affected. For a new row-level access control policy, the default value **ALL** will be used if you do not specify the operations that will be affected. - -Row-level access control policies can be applied to a specified user \(role\) or to all users \(**PUBLIC**\). For a new row-level access control policy, the default value **PUBLIC** will be used if you do not specify the user that will be affected. - -## Precautions - -- Row-level access control policies can be defined for row-store tables, row-store partitioned tables, column-store tables, column-store partitioned tables, replication tables, unlogged tables, and hash tables. -- Row-level access control policies cannot be defined for foreign tables and temporary tables. -- Row-level access control policies cannot be defined for views. -- A maximum of 100 row-level access control policies can be defined for a table. -- System administrators are not affected by row-level access control policies and can view all data in a table. -- Tables queried by using SQL statements, views, functions, and stored procedures are affected by row-level access control policies. - -## Syntax - -``` -CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name - [ AS { PERMISSIVE | RESTRICTIVE } ] - [ FOR { ALL | SELECT | INSERT | UPDATE | DELETE } ] - [ TO { role_name | PUBLIC | CURRENT_USER | SESSION_USER } [, ...] ] - USING ( using_expression ) -``` - -## Parameter Description - -- **policy\_name** - - Specifies the name of a row-level access control policy to be created. The names of row-level access control policies for a table must be unique. - -- **table\_name** - - Specifies the name of a table to which a row-level access control policy is applied. - -- **command** - - Specifies the SQL operations affected by a row-level access control policy, including **ALL**, **SELECT**, **UPDATE**, and **DELETE**. If this parameter is not specified, the default value **ALL** will be used, covering **SELECT**, **UPDATE**, and **DELETE**. - - If _command_ is set to **SELECT**, only tuple data that meets the condition \(the return value of _using\_expression_ is **TRUE**\) can be queried. The operations that are affected include **SELECT**, **UPDATE.... RETURNING**, and **DELETE... RETURNING**. - - If _command_ is set to **UPDATE**, only tuple data that meets the condition \(the return value of _using\_expression_ is **TRUE**\) can be updated. The operations that are affected include **UPDATE**, **UPDATE ... RETURNING**, and **SELECT ... FOR UPDATE/SHARE**. - - If _command_ is set to **DELETE**, only tuple data that meets the condition \(the return value of _using\_expression_ is **TRUE**\) can be deleted. The operations that are affected include **DELETE** and **DELETE ... RETURNING**. - - The following table describes the relationship between row-level access control policies and SQL statements. - - **Table 1** Relationship between row-level access control policies and SQL statements - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Command

-

SELECT/ALL policy

-

UPDATE/ALL policy

-

DELETE/ALL policy

-

SELECT

-

Existing row

-

No

-

No

-

SELECT FOR UPDATE/SHARE

-

Existing row

-

Existing row

-

No

-

UPDATE

-

No

-

Existing row

-

No

-

UPDATE RETURNING

-

Existing row

-

Existing row

-

No

-

DELETE

-

No

-

No

-

Existing row

-

DELETE RETURNING

-

Existing row

-

No

-

Existing row

-
- -- **role\_name** - - Specifies database users affected by a row-level access control policy. - - If this parameter is not specified, the default value **PUBLIC** will be used, indicating that all database users will be affected. You can specify multiple affected database users. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >System administrators are not affected by row access control. - - -- **using\_expression** - - Specifies an expression defined for a row-level access control policy \(return type: boolean\). - - The expression cannot contain aggregate functions or window functions. In the statement rewriting phase of a query, if row-level access control for a data table is enabled, the expressions that meet the specified conditions will be added to the plan tree. The expression is calculated for each tuple in the data table. For **SELECT**, **UPDATE**, and **DELETE**, row data is visible to the current user only when the return value of the expression is **TRUE**. If the expression returns **FALSE**, the tuple is invisible to the current user. In this case, the user cannot view the tuple through the **SELECT** statement, update the tuple through the **UPDATE** statement, or delete the tuple through the **DELETE** statement. - - -## Example: - -``` --- Create user alice. -postgres=# CREATE ROLE alice PASSWORD 'Gauss@123'; - --- Create user bob. -postgres=# CREATE ROLE bob PASSWORD 'Gauss@123'; - --- Create the data table all_data. -postgres=# CREATE TABLE all_data(id int, role varchar(100), data varchar(100)); - ---Insert data into the data table. -postgres=# INSERT INTO all_data VALUES(1, 'alice', 'alice data'); -postgres=# INSERT INTO all_data VALUES(2, 'bob', 'bob data'); -postgres=# INSERT INTO all_data VALUES(3, 'peter', 'peter data'); - --- Grant the read permission on the all_data table to users alice and bob. -postgres=# GRANT SELECT ON all_data TO alice, bob; - ---Enable row-level access control. -postgres=# ALTER TABLE all_data ENABLE ROW LEVEL SECURITY; - ---Create a row-level access control policy to specify that the current user can view only their own data. -postgres=# CREATE ROW LEVEL SECURITY POLICY all_data_rls ON all_data USING(role = CURRENT_USER); - --- View information about the all_data table. -postgres=# \d+ all_data - Table "public.all_data" - Column | Type | Modifiers | Storage | Stats target | Description ---------+------------------------+-----------+----------+--------------+------------- - id | integer | | plain | | - role | character varying(100) | | extended | | - data | character varying(100) | | extended | | -Row Level Security Policies: - POLICY "all_data_rls" - USING (((role)::name = "current_user"())) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: orientation=row, compression=no, enable_rowsecurity=true - --- Run SELECT. -postgres=# SELECT * FROM all_data; - id | role | data -----+-------+------------ - 1 | alice | alice data - 2 | bob | bob data - 3 | peter | peter data -(3 rows) - -postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; - QUERY PLAN ----------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data -(3 rows) - --- Switch to user alice and run SELECT. -postgres=# SELECT * FROM all_data; - id | role | data -----+-------+------------ - 1 | alice | alice data -(1 row) - -postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; - QUERY PLAN ----------------------------------------------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data - Filter: ((role)::name = 'alice'::name) - Notice: This query is influenced by row level security feature -(5 rows) -``` - -## Helpful Links - -[DROP ROW LEVEL SECURITY POLICY](drop-row-level-security-policy.md) - diff --git a/content/en/docs/installation/Developerguide/create-schema.md b/content/en/docs/installation/Developerguide/create-schema.md deleted file mode 100644 index 2e3b26c3c0e962c67f49449bc131bb3eb2f00e5f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-schema.md +++ /dev/null @@ -1,81 +0,0 @@ -# CREATE SCHEMA - -## Function - -**CREATE SCHEMA** creates a schema. - -Named objects are accessed either by "qualifying" their names with the schema name as a prefix, or by setting a search path that includes the desired schema. When creating named objects, you can also use the schema name as a prefix. - -Optionally, **CREATE SCHEMA** can include sub-commands to create objects within the new schema. The sub-commands are treated essentially the same as separate commands issued after creating the schema. If the **AUTHORIZATION** clause is used, all the created objects are owned by this user. - -## Precautions - -- Only a user with the **CREATE** permission on the current database can perform this operation. -- The owner of an object created by a system administrator in a schema with the same name as a common user is the common user, not the system administrator. - -## Syntax - -- Create a schema based on a specified name. - - ``` - CREATE SCHEMA schema_name - [ AUTHORIZATION user_name ] [ schema_element [ ... ] ]; - ``` - -- Create a schema based on a username. - - ``` - CREATE SCHEMA AUTHORIZATION user_name [ schema_element [ ... ] ]; - ``` - - -## Parameter Description - -- **schema\_name** - - Specifies the schema name. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >The name must be unique. - >The schema name cannot start with **pg\_**. - - Value range: a string. It must comply with the naming convention rule. - -- **AUTHORIZATION user\_name** - - Specifies the owner of a schema. If **schema\_name** is not specified, **user\_name** will be used as the schema name. In this case, **user\_name** can only be a role name. - - Value range: an existing username or role name - -- **schema\_element** - - Specifies an SQL statement defining an object to be created within the schema. Currently, only **CREATE TABLE**, **CREATE VIEW**, **CREATE INDEX**, **CREATE PARTITION**, and **GRANT** are accepted as clauses within **CREATE SCHEMA**. - - Objects created by sub-commands are owned by the user specified by **AUTHORIZATION**. - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If objects in the schema on the current search path are with the same name, specify the schemas for different objects. You can run **SHOW SEARCH\_PATH** to check the schemas on the current search path. - -## Examples - -``` --- Create the role1 role. -postgres=# CREATE ROLE role1 IDENTIFIED BY 'Bigdata@123'; - --- Create a schema named role1 for the role1 role. The owner of the films and winners tables created by the clause is role1. -postgres=# CREATE SCHEMA AUTHORIZATION role1 - CREATE TABLE films (title text, release date, awards text[]) - CREATE VIEW winners AS - SELECT title, release FROM films WHERE awards IS NOT NULL; - --- Delete the schema. -postgres=# DROP SCHEMA role1 CASCADE; --- Delete the user. -postgres=# DROP USER role1 CASCADE; -``` - -## Helpful Links - -[ALTER SCHEMA](alter-schema.md) and [DROP SCHEMA](drop-schema.md) - diff --git a/content/en/docs/installation/Developerguide/create-sequence.md b/content/en/docs/installation/Developerguide/create-sequence.md deleted file mode 100644 index dba8d26b5116cb6517d1b5f7762430e4edfd8416..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-sequence.md +++ /dev/null @@ -1,140 +0,0 @@ -# CREATE SEQUENCE - -## Function - -**CREATE SEQUENCE** adds a sequence to the current database. The owner of a sequence is the user who creates the sequence. - -## Precautions - -- A sequence is a special table that stores arithmetic progressions. It has no actual meaning and is usually used to generate unique identifiers for rows or tables. -- If a schema name is given, the sequence is created in the specified schema; otherwise, it is created in the current schema. The sequence name must be different from the names of other sequences, tables, indexes, views in the same schema. -- After the sequence is created, functions **nextval\(\)** and **generate\_series\(1,N\)** insert data to the table. Make sure that the number of times for invoking **nextval** is greater than or equal to N+1. Otherwise, errors will be reported because the number of times for invoking function **generate\_series\(\)** is N+1. - -## Syntax - -``` -CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] - [ MINVALUE minvalue | NO MINVALUE | NOMINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE] - [ START [ WITH ] start ] [ CACHE cache ] [ [ NO ] CYCLE | NOCYCLE ] - [ OWNED BY { table_name.column_name | NONE } ]; -``` - -## Parameter Description - -- **name** - - Specifies the name of a sequence to be created. - - Value range: a sting containing only lowercase letters, uppercase letters, special characters \#\_$, and digits - -- **increment** - - Specifies the step for a sequence. A positive number generates an ascending sequence, and a negative number generates a decreasing sequence. - - The default value is **1**. - -- **MINVALUE minvalue | NO MINVALUE| NOMINVALUE** - - Specifies the minimum value of the sequence. If **MINVALUE** is not declared, or **NO MINVALUE** is declared, the default value of the ascending sequence is **1**, and that of the descending sequence is **-263-1**. **NOMINVALUE** is equivalent to **NO MINVALUE**. - -- **MAXVALUE maxvalue | NO MAXVALUE| NOMAXVALUE** - - Specifies the maximum value of the sequence. If **MAXVALUE** is not declared, or **NO MAXVALUE** is declared, the default value of the ascending sequence is **263-1**, and that of the descending sequence is **-1**. **NOMAXVALUE** is equivalent to **NO MAXVALUE**. - -- **start** - - Specifies the start value of the sequence. The default value for an ascending sequence is **minvalue** and that for a descending sequence is **maxvalue**. - -- **cache** - - Specifies the number of sequences stored in the memory for quick access purposes. - - Default value **1** indicates that one sequence can be generated each time. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >It is not recommended that you define **cache** and **maxvalue** or **minvalue** at the same time. The continuity of sequences cannot be ensured after **cache** is defined because unacknowledged sequences may be generated, causing waste of sequences. - -- **CYCLE** - - Recycles sequences after the number of sequences reaches **maxvalue** or **minvalue**. - - If **NO CYCLE** is specified, any invocation of **nextval** would return an error after the number of sequences reaches **maxvalue** or **minvalue**. - - **NOCYCLE** is equivalent to **NO CYCLE**. - - The default value is **NO CYCLE**. - - If **CYCLE** is specified, the sequence uniqueness cannot be ensured. - -- **OWNED BY**- - - Associates a sequence with a specified column included in a table. In this way, the sequence will be deleted when you delete its associated column or the table where the column belongs to. The associated table and sequence must be owned by the same user and in the same schema. **OWNED BY** only establishes the association between a table column and the sequence. Sequences on the column do not increase automatically when data is inserted. - - The default value **OWNED BY NONE** indicates that such association does not exist. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >You are not advised to use the sequence created using **OWNED BY** in other tables. If multiple tables need to share a sequence, the sequence must not belong to a specific table. - - -## Examples - -Create an ascending sequence named **serial**, which starts from 101. - -``` -postgres=# CREATE SEQUENCE serial - START 101 - CACHE 20; -``` - -Select the next number from the sequence. - -``` -postgres=# SELECT nextval('serial'); - nextval - --------- - 101 -``` - -Select the next number from the sequence. - -``` -postgres=# SELECT nextval('serial'); - nextval - --------- - 102 -``` - -Create a sequence associated with the table. - -``` -postgres=# CREATE TABLE customer_address -( - ca_address_sk integer not null, - ca_address_id char(16) not null, - ca_street_number char(10) , - ca_street_name varchar(60) , - ca_street_type char(15) , - ca_suite_number char(10) , - ca_city varchar(60) , - ca_county varchar(30) , - ca_state char(2) , - ca_zip char(10) , - ca_country varchar(20) , - ca_gmt_offset decimal(5,2) , - ca_location_type char(20) -); - -postgres=# CREATE SEQUENCE serial1 - START 101 - CACHE 20 -OWNED BY customer_address.ca_address_sk; --- Delete the sequence. -postgres=# DROP TABLE customer_address; -postgres=# DROP SEQUENCE serial cascade; -postgres=# DROP SEQUENCE serial1 cascade; -``` - -## Helpful Links - -[DROP SEQUENCE](drop-sequence.md) and [ALTER SEQUENCE](alter-sequence.md) - diff --git a/content/en/docs/installation/Developerguide/create-server.md b/content/en/docs/installation/Developerguide/create-server.md deleted file mode 100644 index 5bc21e55dab50d56c7fbf9446a8cdf9c2d6863f7..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-server.md +++ /dev/null @@ -1,87 +0,0 @@ -# CREATE SERVER - -## Function - -**CREATE SERVER** defines a new foreign server. - -## Syntax - -``` -CREATE SERVER server_name - FOREIGN DATA WRAPPER fdw_name - OPTIONS ( { option_name ' value ' } [, ...] ) ; -``` - -## Parameter Description - -- **server\_name** - - Specifies the server name. - - Value range: a string containing no more than 63 characters - -- **fdw\_name** - - Specifies the name of the foreign data wrapper. - - Value range: oracle\_fdw, mysql\_fdw, postgres\_fdw, mot\_fdw - -- **OPTIONS \( \{ option\_name ' value ' \} \[, ...\] \)** - - Specifies options for the server. These options typically define the connection details of the server, but the actual names and values depend on the foreign data wrapper of the server. - - - Options supported by oracle\_fdw are as follows: - - **dbserver** - - Connection string of the remote Oracle database. - - - **isolation\_level** \(default value: **serializable**\) - - Oracle database transaction isolation level. - - Value range: serializable, read\_committed, read\_only - - - Options supported by mysql\_fdw are as follows: - - **host** \(default value: **127.0.0.1**\) - - IP address of the MySQL server or MariaDB. - - - **port** \(default value: **3306**\) - - Listening port number of the MySQL server or MariaDB. - - - The options supported by postgres\_fdw are the same as those supported by libpq. For details, see _Connection Character Strings_. Note that the following options cannot be set: - - **user** and **password** - - The user name and password are specified when the user mapping is created. - - - **client\_encoding** - - The encoding mode of the local server is automatically obtained and set. - - - **application\_name** - - This option is always set to **postgres\_fdw**. - - - - -In addition to the connection parameters supported by libpq, the following options are provided: - -- **use\_remote\_estimate** - - Controls whether postgres\_fdw issues the EXPLAIN command to obtain the estimated run time. The default value is **false**. - -- **fdw\_startup\_cost** - - Estimates the startup time required for a foreign table scan, including the time to establish a connection, analyze the request at the remote server, and generate a plan. The default value is **100**. - -- **fdw\_typle\_cost** - - Specifies the additional consumption when each tuple is scanned on a remote server. The value specifies the extra consumption of data transmission between servers. The default value is **0.01**. - - -## Helpful Links - -[ALTER SERVER](alter-server.md) and [DROP SERVER](drop-server.md) - diff --git a/content/en/docs/installation/Developerguide/create-synonym.md b/content/en/docs/installation/Developerguide/create-synonym.md deleted file mode 100644 index 1097d06103043fc9334e92b618e7b8ab43602b44..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-synonym.md +++ /dev/null @@ -1,106 +0,0 @@ -# CREATE SYNONYM - -## Function - -**CREATE SYNONYM** 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. - -## Precautions - -- The user of a synonym should be its owner. -- If the schema name is specified, create a synonym in the specified schema. Otherwise create a synonym in the current schema. -- Database objects that can be accessed using synonyms include tables, views, functions, and stored procedures. -- To use synonyms, you must have the required permissions on associated objects. -- The following DML statements support synonyms: **SELECT**, **INSERT**, **UPDATE**, **DELETE**, **EXPLAIN**, and **CALL**. - -## Syntax - -``` -CREATE [ OR REPLACE ] SYNONYM synonym_name - FOR object_name; -``` - -## Parameter Description - -- **synonym** - - Specifies the name of the synonym to be created, which can contain the schema name. - - Value range: a string. It must comply with the naming convention. - -- **object\_name** - - Specifies the name of an object that is associated \(optionally with schema names\). - - Value range: a string. It must comply with the naming convention. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >**object\_name** can be the name of an object that does not exist. - - -## Example - -``` --- Create schema ot. -postgres=# CREATE SCHEMA ot; - --- Create table ot.t1 and its synonym t1. -postgres=# CREATE TABLE ot.t1(id int, name varchar2(10)); -postgres=# CREATE OR REPLACE SYNONYM t1 FOR ot.t1; - --- Use synonym t1. -postgres=# SELECT * FROM t1; -postgres=# INSERT INTO t1 VALUES (1, 'ada'), (2, 'bob'); -postgres=# UPDATE t1 SET t1.name = 'cici' WHERE t1.id = 2; - --- Create synonym v1 and its associated view ot.v_t1. -postgres=# CREATE SYNONYM v1 FOR ot.v_t1; -postgres=# CREATE VIEW ot.v_t1 AS SELECT * FROM ot.t1; - --- Use synonym v1. -postgres=# SELECT * FROM v1; - --- Create overloaded function ot.add and its synonym add. -postgres=# CREATE OR REPLACE FUNCTION ot.add(a integer, b integer) RETURNS integer AS -$$ -SELECT $1 + $2 -$$ -LANGUAGE sql; - -postgres=# CREATE OR REPLACE FUNCTION ot.add(a decimal(5,2), b decimal(5,2)) RETURNS decimal(5,2) AS -$$ -SELECT $1 + $2 -$$ -LANGUAGE sql; - -postgres=# CREATE OR REPLACE SYNONYM add FOR ot.add; - --- Use synonym add. -postgres=# SELECT add(1,2); -postgres=# SELECT add(1.2,2.3); - --- Create stored procedure ot.register and its synonym register. -postgres=# CREATE PROCEDURE ot.register(n_id integer, n_name varchar2(10)) -SECURITY INVOKER -AS -BEGIN - INSERT INTO ot.t1 VALUES(n_id, n_name); -END; -/ - -postgres=# CREATE OR REPLACE SYNONYM register FOR ot.register; - --- Use synonym register to invoke the stored procedure. -postgres=# CALL register(3,'mia'); - --- Delete the synonym. -postgres=# DROP SYNONYM t1; -postgres=# DROP SYNONYM IF EXISTS v1; -postgres=# DROP SYNONYM IF EXISTS add; -postgres=# DROP SYNONYM register; -postgres=# DROP SCHEMA ot CASCADE; -``` - -## Helpful Links - -[ALTER SYNONYM](alter-synonym.md) and [DROP SYNONYM](drop-synonym.md) - diff --git a/content/en/docs/installation/Developerguide/create-table-as.md b/content/en/docs/installation/Developerguide/create-table-as.md deleted file mode 100644 index ea90320439e1af1bf1eb63645b5a3c554cd9c3d6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-table-as.md +++ /dev/null @@ -1,156 +0,0 @@ -# CREATE TABLE AS - -## Function - -**CREATE TABLE AS** creates a table from the results of a query. - -It creates a table and fills it with data obtained using **SELECT**. The table columns have the names and data types associated with the output columns of **SELECT** \(except that you can override the **SELECT** output column names by giving an explicit list of new column names\). - -**CREATE TABLE AS** queries a source table once and writes the data in a new table. The result in the query view changes with the source table. In contrast, the view re-computes and defines its **SELECT** statement at each query. - -## Precautions - -- This statement cannot be used to create a partitioned table. -- If an error occurs during table creation, after it is fixed, the system may fail to delete the disk files that are created before the last automatic clearance and whose size is not 0. This problem seldom occurs and does not affect system running of the database. - -## Syntax - -``` -CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE table_name - [ (column_name [, ...] ) ] - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] - [ COMPRESS | NOCOMPRESS ] - [ TABLESPACE tablespace_name ] - AS query - [ WITH [ NO ] DATA ]; -``` - -## Parameter Description - -- **UNLOGGED** - - Specifies that the table is created as an unlogged table. Data written to unlogged tables is not written to the WALs, which makes them considerably faster than ordinary tables. However, they are not crash-safe: an unlogged table is automatically truncated after a crash or unclean shutdown. The contents of an unlogged table are also not replicated to standby servers. Any indexes created on an unlogged table are automatically unlogged as well. - - - Usage scenario: Unlogged tables do not ensure data security. Users can back up data before using unlogged tables; for example, users should back up the data before a system upgrade. - - Troubleshooting: If data is missing in the indexes of unlogged tables due to some unexpected operations such as an unclean shutdown, users should re-create the indexes with errors. - -- **GLOBAL | LOCAL** - - When creating a temporary table, you can specify the **GLOBAL** or **LOCAL** keyword before **TEMP** or **TEMPORARY**. If the keyword **GLOBAL** is specified, openGauss creates a global temporary table. Otherwise, openGauss creates a local temporary table. - -- **TEMPORARY | TEMP** - - If **TEMP** or **TEMPORARY** is specified, the created table is a temporary table. Temporary tables are classified into global temporary tables and local temporary tables. If the keyword **GLOBAL** is specified when a temporary table is created, the table is a global temporary table. Otherwise, the table is a local temporary table. - - The metadata of the global temporary table is visible to all sessions. After the sessions end, the metadata still exists. The user data, indexes, and statistics of a session are isolated from those of another session. Each session can only view and modify the data submitted by itself. Global temporary tables have two schemas: **ON COMMIT PRESERVE ROWS** and **ON COMMIT PRESERVE ROWS**. In session-based **ON COMMIT PRESERVE ROWS** schema, user data is automatically cleared when a session ends. In transaction-based **ON COMMIT DELETE ROWS** schema, user data is automatically cleared when the commit or rollback operation is performed. If the **ON COMMIT** option is not specified during table creation, the session level is used by default. Different from local temporary tables, you can specify a schema that does not start with **pg\_temp\_** when creating a global temporary table. - - A local temporary table is automatically dropped at the end of the current session. Therefore, you can create and use temporary tables in the current session as long as the connected database node in the session is normal. Temporary tables are created only in the current session. If a DDL statement involves operations on temporary tables, a DDL error will be generated. Therefore, you are not advised to perform operations on temporary tables in DDL statements. **TEMP** is equivalent to **TEMPORARY**. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- Local temporary tables are visible to the current session through the schema starting with **pg\_temp** start. Users should not delete schema started with **pg\_temp** or **pg\_toast\_temp**. - >- If **TEMPORARY** or **TEMP** is not specified when you create a table but its schema is set to that starting with **pg\_temp\_** in the current session, the table will be created as a temporary table. - >- If global temporary tables and indexes are being used by other sessions, do not perform **ALTER** or **DROP**. - >- The DDL of a global temporary table affects only the user data and indexes of the current session. For example, **TRUNCATE**, **REINDEX**, and **ANALYZE** are valid only for the current session. - -- **table\_name** - - Specifies the name of the table to be created. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies the name of a column to be created in the new table. - - Value range: a string. It must comply with the naming convention. - -- **WITH \( storage\_parameter \[= value\] \[, ... \] \)** - - Specifies an optional storage parameter for a table or an index. See details of parameters below. - - - FILLFACTOR - - The fill factor of a table is a percentage from 10 to 100. **100** \(complete filling\) is the default value. When a smaller fill factor is specified, **INSERT** operations pack table pages only to the indicated percentage. The remaining space on each page is reserved for updating rows on that page. This gives **UPDATE** a chance to place the updated copy of a row on the same page, which is more efficient than placing it on a different page. For a table whose entries are never updated, setting the fill factor to **100** \(complete filling\) is the best choice, but in heavily updated tables a smaller fill factor would be appropriate. The parameter is only valid for row–store tables. - - Value range: 10–100 - - - ORIENTATION - - Value range: - - **COLUMN**: The data will be stored in columns. - - **ROW** \(default value\): The data will be stored in rows. - - - COMPRESSION - - Specifies the compression level of table data. It determines the compression ratio and time. Generally, the higher the level of compression, the higher the ratio, the longer the time; and the lower the level of compression, the lower the ratio, the shorter the time. The actual compression ratio depends on the distribution mode of table data loaded. - - Value range: - - The valid values for column-store tables are **YES**, **NO**, **LOW**, **MIDDLE**, and **HIGH**, and the default value is **LOW**. - - Valid values for row-store tables are **YES** and **NO**, and the default value is **NO**. - - - MAX\_BATCHROW - - Specifies the maximum number of rows in a storage unit during data loading. The parameter is only valid for column-store tables. - - Value range: 10000 to 60000 - - -- **ON COMMIT \{ PRESERVE ROWS | DELETE ROWS | DROP \}** - - **ON COMMIT** determines what to do when you commit a temporary table creation operation. The three options are as follows. Currently, only **PRESERVE ROWS** and **DELETE ROWS** can be used. - - - **PRESERVE ROWS** \(default\): No special action is taken at the ends of transactions. The temporary table and its table data are unchanged. - - **DELETE ROWS**: All rows in the temporary table will be deleted at the end of each transaction block. - - **DROP**: The temporary table will be dropped at the end of the current transaction block. Only local temporary tables can be dropped. Global temporary tables cannot be dropped. - -- **COMPRESS / NOCOMPRESS** - - Specifies keyword **COMPRESS** during the creation of a table, so that the compression feature is triggered in case of bulk **INSERT** operations. If this feature is enabled, a scan is performed for all tuple data within the page to generate a dictionary and then the tuple data is compressed and stored. If **NOCOMPRESS** is specified, the table is not compressed. - - Default value: **NOCOMPRESS**, that is, tuple data is not compressed before storage. - -- **TABLESPACE tablespace\_name** - - Specifies that the new table will be created in the **tablespace\_name** tablespace. If not specified, the default tablespace is used. - -- **AS query** - - Specifies a **SELECT** or **VALUES** command, or an **EXECUTE** command that runs a prepared **SELECT** or **VALUES** query. - -- **\[ WITH \[ NO \] DATA \]** - - Specifies whether the data produced by the query should be copied to the new table. By default, the data will be copied. If the value **NO** is used, only the table structure will be copied. - - -## Example: - -``` --- Create the tpcds.store_returns table. -postgres=# CREATE TABLE tpcds.store_returns -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - sr_item_sk VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER -); --- Create the tpcds.store_returns_t1 table and insert numbers that are greater than 16 in the sr_item_sk column of the tpcds.store_returns table. -postgres=# CREATE TABLE tpcds.store_returns_t1 AS SELECT * FROM tpcds.store_returns WHERE sr_item_sk > '4795'; - --- Copy tpcds.store_returns to create the tpcds.store_returns_t2 table. -postgres=# CREATE TABLE tpcds.store_returns_t2 AS table tpcds.store_returns; - --- Delete the table. -postgres=# DROP TABLE tpcds.store_returns_t1 ; -postgres=# DROP TABLE tpcds.store_returns_t2 ; -postgres=# DROP TABLE tpcds.store_returns; -``` - -## Helpful Links - -[CREATE TABLE](en-us_topic_0242370581.md) and [SELECT](en-us_topic_0242370648.md) - diff --git a/content/en/docs/installation/Developerguide/create-table-partition.md b/content/en/docs/installation/Developerguide/create-table-partition.md deleted file mode 100644 index d975ca72a521e461835bacf13b72a5a3436acbcd..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-table-partition.md +++ /dev/null @@ -1,717 +0,0 @@ -# CREATE TABLE PARTITION - -## Function - -**CREATE TABLE PARTITION** creates a partitioned table. A partitioned table is a logical table that is divided into several physical partitions for storage based on a specific plan. Data is stored in physical partitions not the logical table. - -The common forms of partitioning include range partitioning, interval partitioning, hash partitioning, list partitioning, and value partitioning. Currently, row-store tables support only range partitioning and interval partitioning, and column-store tables support only range partitioning. - -In range partitioning, a table is partitioned based on ranges defined by values in one or more columns, with no overlap between the ranges of values assigned to different partitions. Each range has a dedicated partition for data storage. - -The range partitioning policy refers to how data is inserted into partitions. Currently, range partitioning only allows the use of the range partitioning policy. - -In range partitioning, a table is partitioned based on partition key values. If a record can be mapped to a partition, it is inserted into the partition; if it cannot, an error message is returned. Range partitioning is the most commonly used partitioning policy. - -Interval partitioning is a special type of range partitioning. Compared with range partitioning, interval value definition is added. When no matching partition can be found for an inserted record, a partition can be automatically created based on the interval value. - -Interval partitioning supports only table-based partitioning of a column where the data type can be TIMESTAMP\[\(p\)\] \[WITHOUT TIME ZONE\], TIMESTAMP\[\(p\)\] \[WITH TIME ZONE\] and DATE. - -Interval partitioning policy: A record is mapped to a created partition based on the partition key value. If the record can be mapped to a created partition, the record is inserted into the corresponding partition. Otherwise, a partition is automatically created based on the partition key value and table definition information, and then the record is inserted into the new partition. The data range of the new partition is equal to the interval value. - -Partitioning can provide several benefits: - -- Query performance can be improved drastically in certain situations, particularly when most of the heavily accessed rows of the table are in a single partition or a small number of partitions. Partitioning narrows the range of data search and improves data access efficiency. -- In the case of an insert or update operation on most portions of a single partition, performance can be improved by taking advantage of continuous scan of that partition instead of partitions scattered across the whole table. -- Frequent loading or deletion operations on records in a separate partition can be accomplished by reading or removing that partition. It also entirely avoids the **VACUUM** overload caused by bulk **DELETE** operations \(only for range partitioning\). - -## Precautions - -A partitioned table supports unique and primary key constraints. The constraint keys of these constraints must contain all partition keys. - -## Syntax - -``` -CREATE TABLE [ IF NOT EXISTS ] partition_table_name -( [ - { column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] - | table_constraint - | LIKE source_table [ like_option [...] ] }[, ... ] -] ) - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ COMPRESS | NOCOMPRESS ] - [ TABLESPACE tablespace_name ] - PARTITION BY { - {RANGE (partition_key) [ INTERVAL ('interval_expr') [ STORE IN (tablespace_name [, ... ] ) ] ] ( partition_less_than_item [, ... ] )} | - {RANGE (partition_key) [ INTERVAL ('interval_expr') [ STORE IN (tablespace_name [, ... ] ) ] ] ( partition_start_end_item [, ... ] )} - } [ { ENABLE | DISABLE } ROW MOVEMENT ]; -``` - -- **column\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { NOT NULL | - NULL | - CHECK ( expression ) | - DEFAULT default_expr | - UNIQUE index_parameters | - PRIMARY KEY index_parameters } - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - -- **table\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { CHECK ( expression ) | - UNIQUE ( column_name [, ... ] ) index_parameters | - PRIMARY KEY ( column_name [, ... ] ) index_parameters} - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - -- **like\_option** is as follows: - - ``` - { INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | INDEXES | STORAGE | COMMENTS | RELOPTIONS| ALL } - ``` - - -- **index\_parameters** is as follows: - - ``` - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ USING INDEX TABLESPACE tablespace_name ] - ``` - - -- partition\_less\_than\_item: - - ``` - PARTITION partition_name VALUES LESS THAN ( { partition_value | MAXVALUE } ) [TABLESPACE tablespace_name] - ``` - -- partition\_start\_end\_item: - - ``` - PARTITION partition_name { - {START(partition_value) END (partition_value) EVERY (interval_value)} | - {START(partition_value) END ({partition_value | MAXVALUE})} | - {START(partition_value)} | - {END({partition_value | MAXVALUE})} - } [TABLESPACE tablespace_name] - ``` - - -## Parameter Description - -- **IF NOT EXISTS** - - Sends a notice, but does not throw an error, if a table with the same name exists. - -- **partition\_table\_name** - - Specifies the name of the partitioned table. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies the name of a column to be created in the new table. - - Value range: a string. It must comply with the naming convention. - -- **data\_type** - - Specifies the data type of the column. - -- **COLLATE collation** - - Assigns a collation to the column \(which must be of a collatable data type\). If no collation is specified, the default collation is used. - -- **CONSTRAINT constraint\_name** - - Specifies the name of a column or table constraint. The optional constraint clauses specify constraints that new or updated rows must satisfy for an insert or update operation to succeed. - - There are two ways to define constraints: - - - A column constraint is defined as part of a column definition, and it is bound to a particular column. - - A table constraint is not bound to a particular column but can apply to more than one column. - -- **LIKE source\_table \[ like\_option ... \]** - - Specifies a table from which the new table automatically copies all column names, their data types, and their not-null constraints. - - Unlike **INHERITS**, the new table and original table are decoupled after creation is complete. Changes to the original table will not be applied to the new table, and it is not possible to include data of the new table in scans of the original table. - - Default expressions for the copied column definitions will be copied only if **INCLUDING DEFAULTS** is specified. The default behavior is to exclude default expressions, resulting in the copied columns in the new table having default values **null**. - - Not-null constraints are always copied to the new table. **CHECK** constraints will only be copied if **INCLUDING CONSTRAINTS** is specified; other types of constraints will never be copied. These rules also apply to column constraints and table constraints. - - Unlike those of **INHERITS**, columns and constraints copied by **LIKE** are not merged with similarly named columns and constraints. If the same name is specified explicitly or in another **LIKE** clause, an error is reported. - - - Any indexes on the original table will not be created on the new table, unless the **INCLUDING INDEXES** clause is specified. - - **STORAGE** settings for the copied column definitions are copied only if **INCLUDING STORAGE** is specified. The default behavior is to exclude **STORAGE** settings. - - If **INCLUDING COMMENTS** is specified, comments for the copied columns, constraints, and indexes are copied. The default behavior is to exclude comments. - - If **INCLUDING RELOPTIONS** is specified, the new table will copy the storage parameter \(that is, **WITH** clause\) of the source table. The default behavior is to exclude partition definition of the storage parameter of the source table. - - **INCLUDING ALL** contains the meaning of **INCLUDING DEFAULTS**, **INCLUDING CONSTRAINTS**, **INCLUDING INDEXES**, **INCLUDING STORAGE**, **INCLUDING COMMENTS**, **INCLUDING PARTITION**, and **INCLUDING RELOPTIONS**. - -- **WITH \( storage\_parameter \[= value\] \[, ... \] \)** - - Specifies an optional storage parameter for a table or an index. Optional parameters are as follows: - - - FILLFACTOR - - The fill factor of a table is a percentage from 10 to 100. **100** \(complete filling\) is the default value. When a smaller fill factor is specified, **INSERT** operations pack table pages only to the indicated percentage. The remaining space on each page is reserved for updating rows on that page. This gives **UPDATE** a chance to place the updated copy of a row on the same page, which is more efficient than placing it on a different page. For a table whose entries are never updated, setting the fill factor to **100** \(complete filling\) is the best choice, but in heavily updated tables a smaller fill factor would be appropriate. The parameter has no meaning for column–store tables. - - Value range: 10–100 - - - ORIENTATION - - Determines the storage mode of the data in the table. - - Value range: - - - **COLUMN**: The data will be stored in columns. - - **ROW** \(default value\): The data will be stored in rows. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >**orientation** cannot be modified. - - - - COMPRESSION - - Valid values for column-store tables are **LOW**, **MIDDLE**, **HIGH**, **YES**, and **NO**, and the compression level increases accordingly. The default is **LOW**. - - Valid values for row-store tables are **YES** and **NO**, and the default value is **NO**. - - - MAX\_BATCHROW - - Specifies the maximum number of rows in a storage unit during data loading. The parameter is only valid for column-store tables. - - Value range: 10000 to 60000 - - - PARTIAL\_CLUSTER\_ROWS - - Specifies the number of records to be partially clustered for storage during data loading. The parameter is only valid for column-store tables. - - Value range: a number greater than or equal to 100000 The value is a multiple of _MAX\_BATCHROW_. - - - DELTAROW\_THRESHOLD - - A reserved parameter. The parameter is only valid for column-store tables. - - Value range: 0 to 9999 - - -- **COMPRESS / NOCOMPRESS** - - Specifies keyword **COMPRESS** during the creation of a table, so that the compression feature is triggered in case of bulk **INSERT** operations. If this feature is enabled, a scan is performed for all tuple data within the page to generate a dictionary and then the tuple data is compressed and stored. If **NOCOMPRESS** is specified, the table is not compressed. - - Default value: **NOCOMPRESS**, that is, tuple data is not compressed before storage. - -- **TABLESPACE tablespace\_name** - - Specifies that the new table will be created in the **tablespace\_name** tablespace. If not specified, the default tablespace is used. - -- **PARTITION BY RANGE\(partition\_key\)** - - Creates a range partition. **partition\_key** is the name of the partition key. - - \(1\) Assume that the **VALUES LESS THAN** syntax is used. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >In this case, a maximum of four partition keys are supported. - - Data types supported by the partition keys are as follows: **SMALLINT**, **INTEGER**, **BIGINT**, **DECIMAL**, **NUMERIC**, **REAL**, **DOUBLE PRECISION**, **CHARACTER VARYING**\(_n_\), **VARCHAR**\(_n_\), **CHARACTER**\(_n_\), **CHAR**\(_n_\), **CHARACTER**, **CHAR**, **TEXT**, **NVARCHAR2**, **NAME**, **TIMESTAMP\[\(p\)\] \[WITHOUT TIME ZONE\]**, **TIMESTAMP\[\(p\)\] \[WITH TIME ZONE\]**, and **DATE**. - - \(2\) Assume that the **START END** syntax is used. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >In this case, only one partition key is supported. - - Data types supported by the partition key are as follows: **SMALLINT**, **INTEGER**, **BIGINT**, **DECIMAL**, **NUMERIC**, **REAL**, **DOUBLE PRECISION**, **TIMESTAMP\[\(p\)\] \[WITHOUT TIME ZONE\]**, **TIMESTAMP\[\(p\)\] \[WITH TIME ZONE\]**, and **DATE**. - - \(3\) Assume that the **INTERVAL** syntax is used. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >In this case, only one partition key is supported. - - In this case, the data types supported by the partition key are TIMESTAMP\[\(p\)\] \[WITHOUT TIME ZONE\], TIMESTAMP\[\(p\)\] \[WITH TIME ZONE\] and DATE. - -- **PARTITION partition\_name VALUES LESS THAN \( \{ partition\_value | MAXVALUE \} \)** - - Specifies the information of partitions. **partition\_name** is the name of a range partition. **partition\_value** is the upper limit of a range partition, and the value depends on the type of **partition\_key**. _MAXVALUE_ usually specifies the upper limit of the last range partition. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- Each partition requires an upper limit. - >- The data type of the upper limit must be the same as that of the partition key. - >- In a partition list, partitions are arranged in ascending order of upper limits. A partition with a smaller upper limit value is placed before another partition with a larger one. - -- **PARTITION partition\_name \{START \(partition\_value\) END \(partition\_value\) EVERY \(interval\_value\)\} | **\{START \(partition\_value\) END \(partition\_value|MAXVALUE\)\} | \{START\(partition\_value\)\} | **\{END \(partition\_value | MAXVALUE\)**\} - - Specifies the information of partitions. - - - **partition\_name**: name or name prefix of a range partition. It is the name prefix only in the following cases \(assuming that **partition\_name** is **p1**\): - - If **START**+**END**+**EVERY** is used, the names of partitions will be defined as **p1\_1**, **p1\_2**, and the like. For example, if **PARTITION p1 START\(1\) END\(4\) EVERY\(1\)** is defined, the generated partitions are \[1, 2\), \[2, 3\), and \[3, 4\), and their names are **p1\_1**, **p1\_2**, and **p1\_3**. In this case, **p1** is a name prefix. - - If the defined statement is in the first place and has **START** specified, the range \(_MINVALUE_, **START**\) will be automatically used as the first actual partition, and its name will be **p1\_0**. The other partitions are then named **p1\_1**, **p1\_2**, and the like. For example, if **PARTITION p1 START\(1\), PARTITION p2 START\(2\)** is defined, generated partitions are \(_MINVALUE_, 1\), \[1, 2\), and \[2, _MAXVALUE_\), and their names will be **p1\_0**, **p1\_1**, and **p2**. In this case, **p1** is a name prefix and **p2** is a partition name. **MINVALUE** means the minimum value. - - - **partition\_value**: start value or end value of a range partition. The value depends on **partition\_key** and cannot be _MAXVALUE_. - - **interval\_value**: width of each partition for dividing the \[**START**, **END**\) range. It cannot be _MAXVALUE_. If the value of \(**END** – **START**\) divided by **EVERY** has a remainder, the width of only the last partition is less than the value of **EVERY**. - - _MAXVALUE_: upper limit of the last range partition. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >1. If the defined statement is in the first place and has **START** specified, the range \(_MINVALUE_, **START**\) will be automatically used as the first actual partition. - >2. The **START END** syntax must comply with the following rules: - > - The value of **START** \(if any, same for the following situations\) in each **partition\_start\_end\_item** must be smaller than that of **END**. - > - In two adjacent **partition\_start\_end\_item** statements, the value of the first **END** must be equal to that of the second **START**. - > - The value of **EVERY** in each **partition\_start\_end\_item** must be a positive number \(in ascending order\) and must be smaller than **END** minus **START**. - > - Each partition includes the start value \(unless it is _MINVALUE_\) and excludes the end value. The format is as follows: \[**START**, **END**\). - > - Partitions created by the same **partition\_start\_end\_item** belong to the same tablespace. - > - If **partition\_name** is a name prefix of a partition, the length must not exceed 57 bytes. If there are more than 57 bytes, the prefix will be automatically truncated. - > - When creating or modifying a partitioned table, ensure that the total number of partitions in the table does not exceed the maximum value \(32767\). - >3. In statements for creating partitioned tables, **START END** and **LESS THAN** cannot be used together. - >4. The **START END** syntax in a partitioned table creation SQL statement will be replaced by the **VALUES LESS THAN** syntax when **gs\_dump** is executed. - -- **INTERVAL \('interval\_expr'\) \[ STORE IN \(tablespace\_name \[, ... \] \) \]** - - Defines interval partitioning. - - - **interval\_expr**: interval for automatically creating partitions, for example, 1 day or 1 month. - - - **STORE IN \(tablespace\_name \[, ... \] \)**: Specifies the list of tablespaces for storing automatically created partitions. If this parameter is specified, the automatically created partitions are cyclically selected from the tablespace list. Otherwise, the default tablespace of the partition table is used. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >Column-store tables do not support interval partitioning. - -- **\{ ENABLE | DISABLE \} ROW MOVEMENT** - - Sets row movement. - - If the tuple value is updated on the partition key during the **UPDATE** action, the partition where the tuple is located is altered. Setting this parameter enables error messages to be reported or movement of the tuple between partitions. - - Value range: - - - **ENABLE** \(default value\): Row movement is enabled. - - **DISABLE**: Row movement is disabled. - - -- **NOT NULL** - - The column is not allowed to contain null values. **ENABLE** can be omitted. - -- **NULL** - - Specifies that the column is allowed to contain null values. This is the default setting. - - This clause is only provided for compatibility with non-standard SQL databases. It is not recommended. - -- **CHECK \(condition\) \[ NO INHERIT \]** - - Specifies an expression producing a Boolean result where the insert or update operation of new or updated rows can succeed only when the expression result is **TRUE** or **UNKNOWN**; otherwise, an error is thrown and the database is not altered. - - A check constraint specified as a column constraint should reference only the column's values, while an expression appearing in a table constraint can reference multiple columns. - - A constraint marked with **NO INHERIT** will not propagate to child tables. - - **ENABLE** can be omitted. - -- **DEFAULT default\_expr** - - Assigns a default data value for a column. The value can be any variable-free expressions. \(Subqueries and cross-references to other columns in the current table are not allowed.\) The data type of the default expression must match the data type of the column. - - The default expression will be used in any insert operation that does not specify a value for the column. If there is no default value for a column, then the default value is null. - -- **UNIQUE index\_parameters** - - **UNIQUE \( column\_name \[, ... \] \) index\_parameters** - - Specifies that a group of one or more columns of a table can contain only unique values. - - For the purpose of a unique constraint, null is not considered equal. - -- **PRIMARY KEY index\_parameters** - - **PRIMARY KEY \( column\_name \[, ... \] \) index\_parameters** - - Specifies that a column or columns of a table can contain only unique \(non-duplicate\) and non-null values. - - Only one primary key can be specified for a table. - -- **DEFERRABLE | NOT DEFERRABLE** - - They determine whether the constraint is deferrable. A constraint that is not deferrable will be checked immediately after every command. Checking of constraints that are deferrable can be postponed until the end of the transaction using the **SET CONSTRAINTS** command. **NOT DEFERRABLE** is the default value. Currently, only **UNIQUE** and **PRIMARY KEY** constraints accept this clause. All the other constraints are not deferrable. - -- **INITIALLY IMMEDIATE | INITIALLY DEFERRED** - - If a constraint is deferrable, this clause specifies the default time to check the constraint. - - - If the constraint is **INITIALLY IMMEDIATE** \(default value\), it is checked after each statement. - - If the constraint is **INITIALLY DEFERRED**, it is checked only at the end of the transaction. - - The constraint check time can be altered using the **SET CONSTRAINTS** statement. - -- **USING INDEX TABLESPACE tablespace\_name** - - Allows selection of the tablespace in which the index associated with a **UNIQUE** or **PRIMARY KEY** constraint will be created. If not specified, **default\_tablespace** is consulted, or the default tablespace in the database if **default\_tablespace** is empty. - - -## Examples - -- Example 1: Create a range-partitioned table **tpcds.web\_returns\_p1**. The table has eight partitions and their partition keys are of the integer type. The ranges of the partitions are: wr\_returned\_date\_sk < 2450815, 2450815 ≤ wr\_returned\_date\_sk < 2451179, 2451179 ≤ wr\_returned\_date\_sk < 2451544, 2451544 ≤ wr\_returned\_date\_sk < 2451910, 2451910 ≤ wr\_returned\_date\_sk < 2452275, 2452275 ≤ wr\_returned\_date\_sk < 2452640, 2452640 ≤ wr\_returned\_date\_sk < 2453005, and wr\_returned\_date\_sk ≥ 2453005. - - ``` - -- Create the tpcds.web_returns table. - postgres=# CREATE TABLE tpcds.web_returns - ( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) - ); - -- Create a range-partitioned table tpcds.web_returns_p1. - postgres=# CREATE TABLE tpcds.web_returns_p1 - ( - WR_RETURNED_DATE_SK INTEGER , - WR_RETURNED_TIME_SK INTEGER , - WR_ITEM_SK INTEGER NOT NULL, - WR_REFUNDED_CUSTOMER_SK INTEGER , - WR_REFUNDED_CDEMO_SK INTEGER , - WR_REFUNDED_HDEMO_SK INTEGER , - WR_REFUNDED_ADDR_SK INTEGER , - WR_RETURNING_CUSTOMER_SK INTEGER , - WR_RETURNING_CDEMO_SK INTEGER , - WR_RETURNING_HDEMO_SK INTEGER , - WR_RETURNING_ADDR_SK INTEGER , - WR_WEB_PAGE_SK INTEGER , - WR_REASON_SK INTEGER , - WR_ORDER_NUMBER BIGINT NOT NULL, - WR_RETURN_QUANTITY INTEGER , - WR_RETURN_AMT DECIMAL(7,2) , - WR_RETURN_TAX DECIMAL(7,2) , - WR_RETURN_AMT_INC_TAX DECIMAL(7,2) , - WR_FEE DECIMAL(7,2) , - WR_RETURN_SHIP_COST DECIMAL(7,2) , - WR_REFUNDED_CASH DECIMAL(7,2) , - WR_REVERSED_CHARGE DECIMAL(7,2) , - WR_ACCOUNT_CREDIT DECIMAL(7,2) , - WR_NET_LOSS DECIMAL(7,2) - ) - WITH (ORIENTATION = COLUMN,COMPRESSION=MIDDLE) - PARTITION BY RANGE(WR_RETURNED_DATE_SK) - ( - PARTITION P1 VALUES LESS THAN(2450815), - PARTITION P2 VALUES LESS THAN(2451179), - PARTITION P3 VALUES LESS THAN(2451544), - PARTITION P4 VALUES LESS THAN(2451910), - PARTITION P5 VALUES LESS THAN(2452275), - PARTITION P6 VALUES LESS THAN(2452640), - PARTITION P7 VALUES LESS THAN(2453005), - PARTITION P8 VALUES LESS THAN(MAXVALUE) - ); - - -- Import data from the example data table. - postgres=# INSERT INTO tpcds.web_returns_p1 SELECT * FROM tpcds.web_returns; - - -- Drop the P8 partition. - postgres=# ALTER TABLE tpcds.web_returns_p1 DROP PARTITION P8; - - -- Add a partition WR_RETURNED_DATE_SK with values ranging from 2453005 to 2453105. - postgres=# ALTER TABLE tpcds.web_returns_p1 ADD PARTITION P8 VALUES LESS THAN (2453105); - - -- Add a partition WR_RETURNED_DATE_SK with values ranging from 2453105 to MAXVALUE. - postgres=# ALTER TABLE tpcds.web_returns_p1 ADD PARTITION P9 VALUES LESS THAN (MAXVALUE); - - -- Drop the P8 partition. - postgres=# ALTER TABLE tpcds.web_returns_p1 DROP PARTITION FOR (2453005); - - -- Rename the P7 partition to P10. - postgres=# ALTER TABLE tpcds.web_returns_p1 RENAME PARTITION P7 TO P10; - - -- Rename the P6 partition to P11. - postgres=# ALTER TABLE tpcds.web_returns_p1 RENAME PARTITION FOR (2452639) TO P11; - - -- Query the number of rows in the P10 partition. - postgres=# SELECT count(*) FROM tpcds.web_returns_p1 PARTITION (P10); - count - -------- - 0 - (1 row) - - -- Query the number of rows in the P1 partition. - postgres=# SELECT COUNT(*) FROM tpcds.web_returns_p1 PARTITION FOR (2450815); - count - -------- - 0 - (1 row) - ``` - -- Example 2: Create a range-partitioned table **tpcds.web\_returns\_p2**. The table has eight partitions and their partition keys are of the integer type. The upper limit of the eighth partition is _MAXVALUE_. - - The ranges of the partitions are: wr\_returned\_date\_sk < 2450815, 2450815 ≤ wr\_returned\_date\_sk < 2451179, 2451179 ≤ wr\_returned\_date\_sk < 2451544, 2451544 ≤ wr\_returned\_date\_sk < 2451910, 2451910 ≤ wr\_returned\_date\_sk < 2452275, 2452275 ≤ wr\_returned\_date\_sk < 2452640, 2452640 ≤ wr\_returned\_date\_sk < 2453005, and wr\_returned\_date\_sk ≥ 2453005. - - The tablespace of the **tpcds.web\_returns\_p2** partitioned table is **example1**. Partitions **P1** to **P7** have no specified tablespaces, and use the **example1** tablespace of the **tpcds.web\_returns\_p2** partitioned table. The tablespace of the **P8** partitioned table is **example2**. - - Assume that the following data directories of the database nodes are empty directories for which user **dwsadmin** has the read and write permissions: **/pg\_location/mount1/path1**, **/pg\_location/mount2/path2**, **/pg\_location/mount3/path3**, and **/pg\_location/mount4/path4**. - - ``` - postgres=# CREATE TABLESPACE example1 RELATIVE LOCATION 'tablespace1/tablespace_1'; - postgres=# CREATE TABLESPACE example2 RELATIVE LOCATION 'tablespace2/tablespace_2'; - postgres=# CREATE TABLESPACE example3 RELATIVE LOCATION 'tablespace3/tablespace_3'; - postgres=# CREATE TABLESPACE example4 RELATIVE LOCATION 'tablespace4/tablespace_4'; - - postgres=# CREATE TABLE tpcds.web_returns_p2 - ( - WR_RETURNED_DATE_SK INTEGER , - WR_RETURNED_TIME_SK INTEGER , - WR_ITEM_SK INTEGER NOT NULL, - WR_REFUNDED_CUSTOMER_SK INTEGER , - WR_REFUNDED_CDEMO_SK INTEGER , - WR_REFUNDED_HDEMO_SK INTEGER , - WR_REFUNDED_ADDR_SK INTEGER , - WR_RETURNING_CUSTOMER_SK INTEGER , - WR_RETURNING_CDEMO_SK INTEGER , - WR_RETURNING_HDEMO_SK INTEGER , - WR_RETURNING_ADDR_SK INTEGER , - WR_WEB_PAGE_SK INTEGER , - WR_REASON_SK INTEGER , - WR_ORDER_NUMBER BIGINT NOT NULL, - WR_RETURN_QUANTITY INTEGER , - WR_RETURN_AMT DECIMAL(7,2) , - WR_RETURN_TAX DECIMAL(7,2) , - WR_RETURN_AMT_INC_TAX DECIMAL(7,2) , - WR_FEE DECIMAL(7,2) , - WR_RETURN_SHIP_COST DECIMAL(7,2) , - WR_REFUNDED_CASH DECIMAL(7,2) , - WR_REVERSED_CHARGE DECIMAL(7,2) , - WR_ACCOUNT_CREDIT DECIMAL(7,2) , - WR_NET_LOSS DECIMAL(7,2) - ) - TABLESPACE example1 - PARTITION BY RANGE(WR_RETURNED_DATE_SK) - ( - PARTITION P1 VALUES LESS THAN(2450815), - PARTITION P2 VALUES LESS THAN(2451179), - PARTITION P3 VALUES LESS THAN(2451544), - PARTITION P4 VALUES LESS THAN(2451910), - PARTITION P5 VALUES LESS THAN(2452275), - PARTITION P6 VALUES LESS THAN(2452640), - PARTITION P7 VALUES LESS THAN(2453005), - PARTITION P8 VALUES LESS THAN(MAXVALUE) TABLESPACE example2 - ) - ENABLE ROW MOVEMENT; - - -- Create a partitioned table using LIKE. - postgres=# CREATE TABLE tpcds.web_returns_p3 (LIKE tpcds.web_returns_p2 INCLUDING PARTITION); - - -- Change the tablespace of the P1 partition to example2. - postgres=# ALTER TABLE tpcds.web_returns_p2 MOVE PARTITION P1 TABLESPACE example2; - - -- Change the tablespace of the P2 partition to example3. - postgres=# ALTER TABLE tpcds.web_returns_p2 MOVE PARTITION P2 TABLESPACE example3; - - -- Split the P8 partition at 2453010. - postgres=# ALTER TABLE tpcds.web_returns_p2 SPLIT PARTITION P8 AT (2453010) INTO - ( - PARTITION P9, - PARTITION P10 - ); - - -- Merge the P6 and P7 partitions into one. - postgres=# ALTER TABLE tpcds.web_returns_p2 MERGE PARTITIONS P6, P7 INTO PARTITION P8; - - -- Modify the migration attribute of the partitioned table. - postgres=# ALTER TABLE tpcds.web_returns_p2 DISABLE ROW MOVEMENT; - -- Drop tables and tablespaces. - postgres=# DROP TABLE tpcds.web_returns_p1; - postgres=# DROP TABLE tpcds.web_returns_p2; - postgres=# DROP TABLE tpcds.web_returns_p3; - postgres=# DROP TABLESPACE example1; - postgres=# DROP TABLESPACE example2; - postgres=# DROP TABLESPACE example3; - postgres=# DROP TABLESPACE example4; - ``` - - -- Example 3: Use **START END** to create and modify a range-partitioned table. - - Assume that **/home/omm/startend\_tbs1**, **/home/omm/startend\_tbs2**, **/home/omm/startend\_tbs3**, and **/home/omm/startend\_tbs4** are empty directories for which user omm has the read and write permissions. - - ``` - -- Create tablespaces. - postgres=# CREATE TABLESPACE startend_tbs1 LOCATION '/home/omm/startend_tbs1'; - postgres=# CREATE TABLESPACE startend_tbs2 LOCATION '/home/omm/startend_tbs2'; - postgres=# CREATE TABLESPACE startend_tbs3 LOCATION '/home/omm/startend_tbs3'; - postgres=# CREATE TABLESPACE startend_tbs4 LOCATION '/home/omm/startend_tbs4'; - - -- Create a temporary schema. - postgres=# CREATE SCHEMA tpcds; - postgres=# SET CURRENT_SCHEMA TO tpcds; - - -- Create a partitioned table with the partition key of the integer type. - postgres=# CREATE TABLE tpcds.startend_pt (c1 INT, c2 INT) - TABLESPACE startend_tbs1 - PARTITION BY RANGE (c2) ( - PARTITION p1 START(1) END(1000) EVERY(200) TABLESPACE startend_tbs2, - PARTITION p2 END(2000), - PARTITION p3 START(2000) END(2500) TABLESPACE startend_tbs3, - PARTITION p4 START(2500), - PARTITION p5 START(3000) END(5000) EVERY(1000) TABLESPACE startend_tbs4 - ) - ENABLE ROW MOVEMENT; - - -- View the information of the partitioned table. - postgres=# SELECT relname, boundaries, spcname FROM pg_partition p JOIN pg_tablespace t ON p.reltablespace=t.oid and p.parentid='tpcds.startend_pt'::regclass ORDER BY 1; - relname | boundaries | spcname - -------------+------------+--------------- - p1_0 | {1} | startend_tbs2 - p1_1 | {201} | startend_tbs2 - p1_2 | {401} | startend_tbs2 - p1_3 | {601} | startend_tbs2 - p1_4 | {801} | startend_tbs2 - p1_5 | {1000} | startend_tbs2 - p2 | {2000} | startend_tbs1 - p3 | {2500} | startend_tbs3 - p4 | {3000} | startend_tbs1 - p5_1 | {4000} | startend_tbs4 - p5_2 | {5000} | startend_tbs4 - startend_pt | | startend_tbs1 - (12 rows) - - -- Import data and check the data volume in a partition. - postgres=# INSERT INTO tpcds.startend_pt VALUES (GENERATE_SERIES(0, 4999), GENERATE_SERIES(0, 4999)); - postgres=# SELECT COUNT(*) FROM tpcds.startend_pt PARTITION FOR (0); - count - ------- - 1 - (1 row) - - postgres=# SELECT COUNT(*) FROM tpcds.startend_pt PARTITION (p3); - count - ------- - 500 - (1 row) - - -- Add partitions [5000, 5300), [5300, 5600), [5600, 5900), and [5900, 6000). - postgres=# ALTER TABLE tpcds.startend_pt ADD PARTITION p6 START(5000) END(6000) EVERY(300) TABLESPACE startend_tbs4; - - -- Add the partition p7, specified by MAXVALUE. - postgres=# ALTER TABLE tpcds.startend_pt ADD PARTITION p7 END(MAXVALUE); - - -- Rename the partition p7 to p8. - postgres=# ALTER TABLE tpcds.startend_pt RENAME PARTITION p7 TO p8; - - -- Drop the partition p8. - postgres=# ALTER TABLE tpcds.startend_pt DROP PARTITION p8; - - -- Rename the partition where 5950 is located to p71. - postgres=# ALTER TABLE tpcds.startend_pt RENAME PARTITION FOR(5950) TO p71; - - -- Split the partition [4000, 5000) where 4500 is located. - postgres=# ALTER TABLE tpcds.startend_pt SPLIT PARTITION FOR(4500) INTO(PARTITION q1 START(4000) END(5000) EVERY(250) TABLESPACE startend_tbs3); - - -- Change the tablespace of the partition p2 to startend_tbs4. - postgres=# ALTER TABLE tpcds.startend_pt MOVE PARTITION p2 TABLESPACE startend_tbs4; - - -- View the partition status. - postgres=# SELECT relname, boundaries, spcname FROM pg_partition p JOIN pg_tablespace t ON p.reltablespace=t.oid and p.parentid='tpcds.startend_pt'::regclass ORDER BY 1; - relname | boundaries | spcname - -------------+------------+--------------- - p1_0 | {1} | startend_tbs2 - p1_1 | {201} | startend_tbs2 - p1_2 | {401} | startend_tbs2 - p1_3 | {601} | startend_tbs2 - p1_4 | {801} | startend_tbs2 - p1_5 | {1000} | startend_tbs2 - p2 | {2000} | startend_tbs4 - p3 | {2500} | startend_tbs3 - p4 | {3000} | startend_tbs1 - p5_1 | {4000} | startend_tbs4 - p6_1 | {5300} | startend_tbs4 - p6_2 | {5600} | startend_tbs4 - p6_3 | {5900} | startend_tbs4 - p71 | {6000} | startend_tbs4 - q1_1 | {4250} | startend_tbs3 - q1_2 | {4500} | startend_tbs3 - q1_3 | {4750} | startend_tbs3 - q1_4 | {5000} | startend_tbs3 - startend_pt | | startend_tbs1 - (19 rows) - - -- Drop tables and tablespaces. - postgres=# DROP SCHEMA tpcds CASCADE; - postgres=# DROP TABLESPACE startend_tbs1; - postgres=# DROP TABLESPACE startend_tbs2; - postgres=# DROP TABLESPACE startend_tbs3; - postgres=# DROP TABLESPACE startend_tbs4; - ``` - - -- Example 4: Create an interval-partitioned table **sales**. The table initially contains two partitions and the partition key is of the DATE type. - - Ranges of the two partitions are as follows: time\_id < '2019-02-01 00:00:00' and '2019-02-01 00:00:00' ≤ time\_id < '2019-02-02 00:00:00'. - - ``` - -- Create table sales: - postgres=# CREATE TABLE sales - (prod_id NUMBER(6), - cust_id NUMBER, - time_id DATE, - channel_id CHAR(1), - promo_id NUMBER(6), - quantity_sold NUMBER(3), - amount_sold NUMBER(10,2) - ) - PARTITION BY RANGE (time_id) - INTERVAL('1 day') - ( PARTITION p1 VALUES LESS THAN ('2019-02-01 00:00:00'), - PARTITION p2 VALUES LESS THAN ('2019-02-02 00:00:00') - ); - - -- Insert data into partition p1. - postgres=# INSERT INTO sales VALUES(1, 12, '2019-01-10 00:00:00', 'a', 1, 1, 1); - - -- Insert data into partition p2. - postgres=# INSERT INTO sales VALUES(1, 12, '2019-02-01 00:00:00', 'a', 1, 1, 1); - - -- View the partition information. - postgres=# SELECT t1.relname, partstrategy, boundaries FROM pg_partition t1, pg_class t2 WHERE t1.parentid = t2.oid AND t2.relname = 'sales' AND t1.parttype = 'p'; - relname | partstrategy | boundaries - ---------+--------------+------------------------- - p1 | r | {"2019-02-01 00:00:00"} - p2 | r | {"2019-02-02 00:00:00"} - (2 rows) - - -- If the data to be inserted does not match any partition, create a partition and insert the data into the new partition. - -- The range of the new partition is '2019-02-05 00:00:00' ≤ time_id < '2019-02-06 00:00:00'. - postgres=# INSERT INTO sales VALUES(1, 12, '2019-02-05 00:00:00', 'a', 1, 1, 1); - - -- If the data to be inserted does not match any partition, create a partition and insert the data into the new partition. - -- The range of the new partition is '2019-02-03 00:00:00' ≤ time_id < '2019-02-04 00:00:00'. - postgres=# INSERT INTO sales VALUES(1, 12, '2019-02-03 00:00:00', 'a', 1, 1, 1); - - -- View the partition information. - postgres=# SELECT t1.relname, partstrategy, boundaries FROM pg_partition t1, pg_class t2 WHERE t1.parentid = t2.oid AND t2.relname = 'sales' AND t1.parttype = 'p'; - relname | partstrategy | boundaries - ---------+--------------+------------------------- - sys_p1 | i | {"2019-02-06 00:00:00"} - sys_p2 | i | {"2019-02-04 00:00:00"} - p1 | r | {"2019-02-01 00:00:00"} - p2 | r | {"2019-02-02 00:00:00"} - (4 rows) - - ``` - - -## Helpful Links - -[ALTER TABLE PARTITION](alter-table-partition.md) and [DROP TABLE](en-us_topic_0242370616.md) - diff --git a/content/en/docs/installation/Developerguide/create-table.md b/content/en/docs/installation/Developerguide/create-table.md deleted file mode 100644 index 695ce7504211bee34c23d1d77b5d4dac4aba5f08..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-table.md +++ /dev/null @@ -1,926 +0,0 @@ -# CREATE TABLE - -## Function - -**CREATE TABLE** is used to create an initially empty table in the current database. The table will be owned by the creator. - -## Precautions - -- For details about the data types supported by column-store tables, see [Data Types Supported by Column-store Tables](data-types-supported-by-column-store-tables.md). -- column-store tables do not support arrays. -- It is recommended that the number of column-store tables do not exceed 1000. -- The primary key constraint and unique constraint in the table must contain distribution keys. -- If an error occurs during table creation, after it is fixed, the system may fail to delete the empty disk files created before the last automatic clearance. This problem seldom occurs and does not affect system running of the database. -- Column-store tables support only **PARTIAL CLUSTER KEY** table-level constraints, but do not support primary and foreign key table-level constraints. -- Only the **NULL**, **NOT NULL**, and **DEFAULT** constant values can be used as column-store table constraints. -- Whether column-store tables support a delta table is specified by the [enable\_delta\_store](parallel-data-import.md#en-us_topic_0237124705_section1035224982816) parameter. The threshold for storing data into a delta table is specified by the **deltarow\_threshold** parameter. -- When JDBC is used, the **DEFAULT** value can be set through **PrepareStatement**. - -## Syntax - -- Create a table. - - ``` - CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name - ({ column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ] - | table_constraint - | LIKE source_table [ like_option [...] ] } - [, ... ]) - [ WITH ( {storage_parameter = value} [, ... ] ) ] - [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] - [ COMPRESS | NOCOMPRESS ] - [ TABLESPACE tablespace_name ]; - ``` - - - **column\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { NOT NULL | - NULL | - CHECK ( expression ) | - DEFAULT default_expr | - UNIQUE index_parameters | - PRIMARY KEY index_parameters } - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - - **compress\_mode** of a column is as follows: - - ``` - { DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS } - ``` - - - **table\_constraint** is as follows: - - ``` - [ CONSTRAINT constraint_name ] - { CHECK ( expression ) | - UNIQUE ( column_name [, ... ] ) index_parameters | - PRIMARY KEY ( column_name [, ... ] ) index_parameters | - PARTIAL CLUSTER KEY ( column_name [, ... ] ) } - [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - ``` - - - **like\_option** is as follows: - - ``` - { INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | INDEXES | STORAGE | COMMENTS | PARTITION | RELOPTIONS | ALL } - ``` - - - -**index\_parameters** is as follows: - -``` -[ WITH ( {storage_parameter = value} [, ... ] ) ] -[ USING INDEX TABLESPACE tablespace_name ] -``` - -## Parameter Description - -- **UNLOGGED** - - If this keyword is specified, the created table is an unlogged table. Data written to unlogged tables is not written to the WALs, which makes them considerably faster than ordinary tables. However, an unlogged table is automatically truncated after a crash or unclean shutdown, incurring data loss risks. Contents of an unlogged table are also not replicated to standby servers. Any indexes created on an unlogged table are not automatically logged as well. - - Usage scenario: Unlogged tables do not ensure data security. Users can back up data before using unlogged tables; for example, users should back up the data before a system upgrade. - - Troubleshooting: If data is missing in the indexes of unlogged tables due to some unexpected operations such as an unclean shutdown, users should re-create the indexes with errors. - -- **GLOBAL | LOCAL** - - When creating a temporary table, you can specify the **GLOBAL** or **LOCAL** keyword before **TEMP** or **TEMPORARY**. Currently, the two keywords are used to be compatible with the SQL standard. In fact, a local temporary table will be created by openGauss regardless of whether **GLOBAL** or **LOCAL** is specified. - -- **TEMPORARY | TEMP** - - If **TEMP** or **TEMPORARY** is specified, the created table is a temporary table. A temporary table is automatically dropped at the end of the current session. Therefore, you can create and use temporary tables in the current session as long as the connected database node in the session is normal. Temporary tables are created only in the current session. If a DDL statement involves operations on temporary tables, a DDL error will be generated. Therefore, you are not advised to perform operations on temporary tables in DDL statements. **TEMP** is equivalent to **TEMPORARY**. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- Temporary tables are visible to the current session through the schema starting with **pg\_temp** start. Users should not delete schema started with **pg\_temp** or **pg\_toast\_temp**. - >- If **TEMPORARY** or **TEMP** is not specified when you create a table but its schema is set to that starting with **pg\_temp\_** in the current session, the table will be created as a temporary table. - -- **IF NOT EXISTS** - - Sends a notice, but does not throw an error, if a table with the same name exists. - -- **table\_name** - - Specifies the name of the table to be created. - -- **column\_name** - - Specifies the name of a column to be created in the new table. - -- **data\_type** - - Specifies the data type of the column. - -- **compress\_mode** - - Specifies the compression option of the table, which is only available for row-store tables. The option specifies the algorithm preferentially used by table columns. - - Value range: **DELTA**, **PREFIX**, **DICTIONARY**, **NUMSTR**, and **NOCOMPRESS** - -- **COLLATE collation** - - Assigns a collation to the column \(which must be of a collatable data type\). If no collation is specified, the default collation is used. - -- **LIKE source\_table \[ like\_option ... \]** - - Specifies a table from which the new table automatically copies all column names, their data types, and their not-null constraints. - - The new table and the original table are decoupled after creation is complete. Changes to the original table will not be applied to the new table, and it is not possible to include data of the new table in scans of the original table. - - Columns and constraints copied by **LIKE** are not merged with the same name. If the same name is specified explicitly or in another **LIKE** clause, an error is reported. - - - The default expressions are copied from the original table to the new table only if **INCLUDING DEFAULTS** is specified. The default behavior is to exclude default expressions, resulting in the copied columns in the new table having default values null. - - The **CHECK** constraints are copied from the original table to the new table only when **INCLUDING CONSTRAINTS** is specified. Other types of constraints are never copied to the new table. Not-null constraints are always copied to the new table. These rules also apply to column constraints and table constraints. - - Any indexes on the original table will not be created on the new table, unless the **INCLUDING INDEXES** clause is specified. - - **STORAGE** settings for the copied column definitions are copied only if **INCLUDING STORAGE** is specified. The default behavior is to exclude **STORAGE** settings. - - If **INCLUDING COMMENTS** is specified, comments for the copied columns, constraints, and indexes are copied. The default behavior is to exclude comments. - - If **INCLUDING PARTITION** is specified, the partition definitions of the source table are copied to the new table, and the new table no longer uses the **PARTITION BY** clause. The default behavior is to exclude partition definition of the original table. - - If **INCLUDING RELOPTIONS** is specified, the new table will copy the storage parameter \(that is, **WITH** clause\) of the source table. The default behavior is to exclude partition definition of the storage parameter of the original table. - - **INCLUDING ALL** contains the meaning of **INCLUDING DEFAULTS**, **INCLUDING CONSTRAINTS**, **INCLUDING INDEXES**, **INCLUDING STORAGE**, **INCLUDING COMMENTS**, **INCLUDING PARTITION**, and **INCLUDING RELOPTIONS**. - - >![](public_sys-resources/icon-notice.gif) **NOTICE:** - >- If the source table contains a sequence with the **SERIAL**, **BIGSERIAL**, or **SMALLSERIRAL** data type, or a column in the source table is a sequence by default and the sequence is created for this table by using **CREATE SEQUENCE...** **OWNED BY**, these sequences will not be copied to the new table, and another sequence specific to the new table will be created. This is different from earlier versions. To share a sequence between the source table and new table, create a shared sequence \(do not use **OWNED BY**\) and set a column in the source table to this sequence. - >- You are not advised to set a column in the source table to the sequence specific to another table especially when the table is distributed in specific node groups, because doing so may result in **CREATE TABLE ... LIKE** execution failures. In addition, doing so may cause the sequence to become invalid in the source sequence because the sequence will also be deleted from the source table when it is deleted from the table that the sequence is specific to. To share a sequence among multiple tables, you are advised to create a shared sequence for them. - -- **WITH \( \{ storage\_parameter = value \} \[, ... \] \)** - - Specifies an optional storage parameter for a table or an index. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >When using **Numeric** of any precision to define a column, specifies precision **p** and scale **s**. When precision and scale are not specified, the input will be displayed. - - The description of parameters is as follows: - - - FILLFACTOR - - The fill factor of a table is a percentage from 10 to 100. **100** \(complete filling\) is the default value. When a smaller fill factor is specified, **INSERT** operations pack table pages only to the indicated percentage. The remaining space on each page is reserved for updating rows on that page. This gives **UPDATE** a chance to place the updated copy of a row on the same page, which is more efficient than placing it on a different page. For a table whose entries are never updated, setting the fill factor to **100** \(complete filling\) is the best choice, but in heavily updated tables a smaller fill factor would be appropriate. The parameter has no meaning for column–store tables. - - Value range: 10–100 - - - ORIENTATION - - Specifies the storage mode \(row-store, column-store, or ORC\) of table data. This parameter cannot be modified once it is set. - - Value range: - - - **ROW** indicates that table data is stored in rows. - - **ROW** applies to OLTP service and scenarios with a large number of point queries or addition/deletion operations. - - - **COLUMN** indicates that the data is stored in columns. - - **COLUMN** applies to the data warehouse service, which has a large amount of aggregation computing, and involves a few column operations. - - Default value: - - If an ordinary tablespace is specified, the default is **ROW**. - - - COMPRESSION - - Specifies the compression level of table data. It determines the compression ratio and time. Generally, the higher the level of compression, the higher the ratio, the longer the time; and the lower the level of compression, the lower the ratio, the shorter the time. The actual compression ratio depends on the distribution mode of table data loaded. - - Value range: - - The valid values for column-store tables are **YES**, **NO**, **LOW**, **MIDDLE**, and **HIGH**, and the default value is **LOW**. - - - COMPRESSLEVEL - - Specifies the table data compression ratio and duration at the same compression level. This divides a compression level into sublevels, providing more choices for compression ratio and duration. As the value becomes greater, the compression ratio becomes higher and duration longer at the same compression level. - - Value range: 0 to 3. The default value is **0**. - - - MAX\_BATCHROW - - Specifies the maximum number of rows in a storage unit during data loading. The parameter is only valid for column-store tables. - - Value range: 10000 to 60000 - - - PARTIAL\_CLUSTER\_ROWS - - Specifies the number of records to be partially clustered for storage during data loading. The parameter is only valid for column-store tables. - - Value range: 600000 to 2147483647 - - - DELTAROW\_THRESHOLD - - Specifies the upper limit of to-be-imported rows for triggering the data import to a delta table when data of a column-store table is to be imported. This parameter takes effect only if [enable\_delta\_store](parallel-data-import.md#en-us_topic_0237124705_section1035224982816) is set to **on**. The parameter is only valid for column-store tables. - - Value range: from 0 to 9999. The default value is **100**. - - - VERSION - - Specifies the version of ORC storage format. - - Value range: 0.12. ORC 0.12 format is supported currently. More formats will be supported as the development of ORC format. - - Default value: **0.12** - - -- **ON COMMIT \{ PRESERVE ROWS | DELETE ROWS | DROP \}** - - **ON COMMIT** determines what to do when you commit a temporary table creation operation. The three options are as follows. Currently, only **PRESERVE ROWS** and **DELETE ROWS** can be used. - - - **PRESERVE ROWS** \(default\): No special action is taken at the ends of transactions. The temporary table and its table data are unchanged. - - **DELETE ROWS**: All rows in the temporary table will be deleted at the end of each transaction block. - - **DROP**: The temporary table will be dropped at the end of the current transaction block. - -- **COMPRESS | NOCOMPRESS** - - If you specify **COMPRESS** in the **CREATE TABLE** statement, the compression feature is triggered in case of a bulk **INSERT** operation. If this feature is enabled, a scan is performed for all tuple data within the page to generate a dictionary and then the tuple data is compressed and stored. If **NOCOMPRESS** is specified, the table is not compressed. - - Default value: **NOCOMPRESS**, that is, tuple data is not compressed before storage. - -- **TABLESPACE tablespace\_name** - - Specifies the tablespace where the new table is created. If not specified, the default tablespace is used. - -- **CONSTRAINT constraint\_name** - - Specifies the name of a column or table constraint. The optional constraint clauses specify constraints that new or updated rows must satisfy for an insert or update operation to succeed. - - There are two ways to define constraints: - - - A column constraint is defined as part of a column definition, and it is bound to a particular column. - - A table constraint is not bound to a particular column but can apply to more than one column. - -- **NOT NULL** - - The column is not allowed to contain null values. - -- **NULL** - - The column is allowed to contain null values. This is the default setting. - - This clause is only provided for compatibility with non-standard SQL databases. It is not recommended. - -- **CHECK \( expression \)** - - Specifies an expression producing a Boolean result where the insert or update operation of new or updated rows can succeed only when the expression result is **TRUE** or **UNKNOWN**; otherwise, an error is thrown and the database is not altered. - - A check constraint specified as a column constraint should reference only the column's values, while an expression appearing in a table constraint can reference multiple columns. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >**<\>NULL** and **!=NULL** are invalid in an expression. Change them to **IS NOT NULL**. - -- **DEFAULT default\_expr** - - Assigns a default data value for a column. The value can be any variable-free expressions. \(Subqueries and cross-references to other columns in the current table are not allowed.\) The data type of the default expression must match the data type of the column. - - The default expression will be used in any insert operation that does not specify a value for the column. If there is no default value for a column, then the default value is null. - -- **UNIQUE index\_parameters** - - **UNIQUE \( column\_name \[, ... \] \) index\_parameters** - - Specifies that a group of one or more columns of a table can contain only unique values. - - For the purpose of a unique constraint, null is not considered equal. - -- **PRIMARY KEY index\_parameters** - - **PRIMARY KEY \( column\_name \[, ... \] \) index\_parameters** - - Specifies that a column or columns of a table can contain only unique \(non-duplicate\) and non-null values. - - Only one primary key can be specified for a table. - -- **DEFERRABLE | NOT DEFERRABLE** - - They determine whether the constraint is deferrable. A constraint that is not deferrable will be checked immediately after every command. Checking of constraints that are deferrable can be postponed until the end of the transaction using the **SET CONSTRAINTS** command. **NOT DEFERRABLE** is the default value. Currently, only **UNIQUE** and **PRIMARY KEY** constraints accept this clause. All the other constraints are not deferrable. - -- **PARTIAL CLUSTER KEY** - - Specifies a partial cluster key for storage. When importing data to a column-store table, you can perform local data sorting by specified columns \(single or multiple\). - -- **INITIALLY IMMEDIATE | INITIALLY DEFERRED** - - If a constraint is deferrable, this clause specifies the default time to check the constraint. - - - If the constraint is **INITIALLY IMMEDIATE** \(default value\), it is checked after each statement. - - If the constraint is **INITIALLY DEFERRED**, it is checked only at the end of the transaction. - - The constraint check time can be altered using the **SET CONSTRAINTS** statement. - -- **USING INDEX TABLESPACE tablespace\_name** - - Allows selection of the tablespace in which the index associated with a **UNIQUE** or **PRIMARY KEY** constraint will be created. If not specified, **default\_tablespace** is consulted, or the default tablespace in the database if **default\_tablespace** is empty. - - -## Example: - -``` --- Create a simple table. -postgres=# CREATE TABLE tpcds.warehouse_t1 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - -postgres=# CREATE TABLE tpcds.warehouse_t2 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) DICTIONARY, - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); -``` - -``` --- Create a table and set the default value of the W_STATE column to GA. -postgres=# CREATE TABLE tpcds.warehouse_t3 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) DEFAULT 'GA', - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- Create a table and check whether the W_WAREHOUSE_NAME column is unique at the end of its creation. -postgres=# CREATE TABLE tpcds.warehouse_t4 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) UNIQUE DEFERRABLE, - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); -``` - -``` --- Create a table with its fill factor set to 70%. -postgres=# CREATE TABLE tpcds.warehouse_t5 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - UNIQUE(W_WAREHOUSE_NAME) WITH(fillfactor=70) -); - --- Alternatively, user the following syntax: -postgres=# CREATE TABLE tpcds.warehouse_t6 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) UNIQUE, - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) WITH(fillfactor=70); - --- Create a table and specify that its data is not written to WALs. -postgres=# CREATE UNLOGGED TABLE tpcds.warehouse_t7 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- Create a temporary table. -postgres=# CREATE TEMPORARY TABLE warehouse_t24 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- Create a temporary table in a transaction and specify that this table is deleted when the transaction is committed. -postgres=# CREATE TEMPORARY TABLE warehouse_t25 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) ON COMMIT DELETE ROWS; - --- Create a table and specify that no error is reported for duplicate tables (if any). -postgres=# CREATE TABLE IF NOT EXISTS tpcds.warehouse_t8 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- Create a general tablespace. -postgres=# CREATE TABLESPACE DS_TABLESPACE1 RELATIVE LOCATION 'tablespace/tablespace_1'; --- Specify a tablespace when creating a table. -postgres=# CREATE TABLE tpcds.warehouse_t9 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) TABLESPACE DS_TABLESPACE1; - --- Separately specify the index tablespace for W_WAREHOUSE_NAME when creating the table. -postgres=# CREATE TABLE tpcds.warehouse_t10 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) UNIQUE USING INDEX TABLESPACE DS_TABLESPACE1, - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); -``` - -``` --- Create a table with a primary key constraint. -postgres=# CREATE TABLE tpcds.warehouse_t11 -( - W_WAREHOUSE_SK INTEGER PRIMARY KEY, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- An alternative for the preceding syntax is as follows: -postgres=# CREATE TABLE tpcds.warehouse_t12 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - PRIMARY KEY(W_WAREHOUSE_SK) -); - --- Or use the following statement to specify the name of the constraint: -postgres=# CREATE TABLE tpcds.warehouse_t13 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - CONSTRAINT W_CSTR_KEY1 PRIMARY KEY(W_WAREHOUSE_SK) -); - --- Create a table with a compound primary key constraint. -postgres=# CREATE TABLE tpcds.warehouse_t14 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - CONSTRAINT W_CSTR_KEY2 PRIMARY KEY(W_WAREHOUSE_SK, W_WAREHOUSE_ID) -); - --- Create a column-store table. -postgres=# CREATE TABLE tpcds.warehouse_t15 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) WITH (ORIENTATION = COLUMN); - --- Create a column-store table using partial clustered storage. -postgres=# CREATE TABLE tpcds.warehouse_t16 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - PARTIAL CLUSTER KEY(W_WAREHOUSE_SK, W_WAREHOUSE_ID) -) WITH (ORIENTATION = COLUMN); - --- Define a column-store table with compression enabled. -postgres=# CREATE TABLE tpcds.warehouse_t17 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) WITH (ORIENTATION = COLUMN, COMPRESSION=HIGH); - --- Define a table with compression enabled. -postgres=# CREATE TABLE tpcds.warehouse_t18 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -) COMPRESS; - --- Define a column check constraint. -postgres=# CREATE TABLE tpcds.warehouse_t19 -( - W_WAREHOUSE_SK INTEGER PRIMARY KEY CHECK (W_WAREHOUSE_SK > 0), - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) CHECK (W_WAREHOUSE_NAME IS NOT NULL), - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - -postgres=# CREATE TABLE tpcds.warehouse_t20 -( - W_WAREHOUSE_SK INTEGER PRIMARY KEY, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) CHECK (W_WAREHOUSE_NAME IS NOT NULL), - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - CONSTRAINT W_CONSTR_KEY2 CHECK(W_WAREHOUSE_SK > 0 AND W_WAREHOUSE_NAME IS NOT NULL) -); - --- Define a table. Each row in the table is stored on the database node. -postgres=# CREATE TABLE tpcds.warehouse_t21 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2) -); - --- Define a hash table. -postgres=# CREATE TABLE tpcds.warehouse_t22 -( - W_WAREHOUSE_SK INTEGER NOT NULL, - W_WAREHOUSE_ID CHAR(16) NOT NULL, - W_WAREHOUSE_NAME VARCHAR(20) , - W_WAREHOUSE_SQ_FT INTEGER , - W_STREET_NUMBER CHAR(10) , - W_STREET_NAME VARCHAR(60) , - W_STREET_TYPE CHAR(15) , - W_SUITE_NUMBER CHAR(10) , - W_CITY VARCHAR(60) , - W_COUNTY VARCHAR(30) , - W_STATE CHAR(2) , - W_ZIP CHAR(10) , - W_COUNTRY VARCHAR(20) , - W_GMT_OFFSET DECIMAL(5,2), - CONSTRAINT W_CONSTR_KEY3 UNIQUE(W_WAREHOUSE_SK) -); - --- Add a varchar column to the tpcds.warehouse_t19 table. -``` - -``` -postgres=# ALTER TABLE tpcds.warehouse_t19 ADD W_GOODS_CATEGORY varchar(30); - --- Add a check constraint to the tpcds.warehouse_t19 table. -postgres=# ALTER TABLE tpcds.warehouse_t19 ADD CONSTRAINT W_CONSTR_KEY4 CHECK (W_STATE IS NOT NULL); - --- Use one statement to alter the types of two existing columns. -postgres=# ALTER TABLE tpcds.warehouse_t19 - ALTER COLUMN W_GOODS_CATEGORY TYPE varchar(80), - ALTER COLUMN W_STREET_NAME TYPE varchar(100); - --- This statement is equivalent to the preceding statement. -postgres=# ALTER TABLE tpcds.warehouse_t19 MODIFY (W_GOODS_CATEGORY varchar(30), W_STREET_NAME varchar(60)); - --- Add a not-null constraint to an existing column. -postgres=# ALTER TABLE tpcds.warehouse_t19 ALTER COLUMN W_GOODS_CATEGORY SET NOT NULL; - --- Remove not-null constraints from an existing column. -postgres=# ALTER TABLE tpcds.warehouse_t19 ALTER COLUMN W_GOODS_CATEGORY DROP NOT NULL; - --- If no partial cluster is specified in a column-store table, add a partial cluster to the table. -postgres=# ALTER TABLE tpcds.warehouse_t17 ADD PARTIAL CLUSTER KEY(W_WAREHOUSE_SK); - --- View the constraint name and delete the partial cluster column of a column-store table. -postgres=# \d+ tpcds.warehouse_t17 - Table "tpcds.warehouse_t17" - Column | Type | Modifiers | Storage | Stats target | Description --------------------+-----------------------+-----------+----------+--------------+------------- - w_warehouse_sk | integer | not null | plain | | - w_warehouse_id | character(16) | not null | extended | | - w_warehouse_name | character varying(20) | | extended | | - w_warehouse_sq_ft | integer | | plain | | - w_street_number | character(10) | | extended | | - w_street_name | character varying(60) | | extended | | - w_street_type | character(15) | | extended | | - w_suite_number | character(10) | | extended | | - w_city | character varying(60) | | extended | | - w_county | character varying(30) | | extended | | - w_state | character(2) | | extended | | - w_zip | character(10) | | extended | | - w_country | character varying(20) | | extended | | - w_gmt_offset | numeric(5,2) | | main | | -Partial Cluster : - "warehouse_t17_cluster" PARTIAL CLUSTER KEY (w_warehouse_sk) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: compression=no, version=0.12 -postgres=# ALTER TABLE tpcds.warehouse_t17 DROP CONSTRAINT warehouse_t17_cluster; - --- Move a table to another tablespace. -postgres=# ALTER TABLE tpcds.warehouse_t19 SET TABLESPACE PG_DEFAULT; --- Create the joe schema. -postgres=# CREATE SCHEMA joe; - --- Move a table to another schema. -postgres=# ALTER TABLE tpcds.warehouse_t19 SET SCHEMA joe; - --- Rename an existing table. -postgres=# ALTER TABLE joe.warehouse_t19 RENAME TO warehouse_t23; - --- Delete a column from the warehouse_t23 table. -postgres=# ALTER TABLE joe.warehouse_t23 DROP COLUMN W_STREET_NAME; - --- Delete the tablespace, schema joe, and schema tables warehouse. -postgres=# DROP TABLE tpcds.warehouse_t1; -postgres=# DROP TABLE tpcds.warehouse_t2; -postgres=# DROP TABLE tpcds.warehouse_t3; -postgres=# DROP TABLE tpcds.warehouse_t4; -postgres=# DROP TABLE tpcds.warehouse_t5; -postgres=# DROP TABLE tpcds.warehouse_t6; -postgres=# DROP TABLE tpcds.warehouse_t7; -postgres=# DROP TABLE tpcds.warehouse_t8; -postgres=# DROP TABLE tpcds.warehouse_t9; -postgres=# DROP TABLE tpcds.warehouse_t10; -postgres=# DROP TABLE tpcds.warehouse_t11; -postgres=# DROP TABLE tpcds.warehouse_t12; -postgres=# DROP TABLE tpcds.warehouse_t13; -postgres=# DROP TABLE tpcds.warehouse_t14; -postgres=# DROP TABLE tpcds.warehouse_t15; -postgres=# DROP TABLE tpcds.warehouse_t16; -postgres=# DROP TABLE tpcds.warehouse_t17; -postgres=# DROP TABLE tpcds.warehouse_t18; -postgres=# DROP TABLE tpcds.warehouse_t20; -postgres=# DROP TABLE tpcds.warehouse_t21; -postgres=# DROP TABLE tpcds.warehouse_t22; -postgres=# DROP TABLE joe.warehouse_t23; -postgres=# DROP TABLE tpcds.warehouse_t24; -postgres=# DROP TABLE tpcds.warehouse_t25; -postgres=# DROP TABLESPACE DS_TABLESPACE1; -postgres=# DROP SCHEMA IF EXISTS joe CASCADE; -``` - -## Helpful Links - -[ALTER TABLE](alter-table.md), [DROP TABLE](drop-table.md), and [CREATE TABLESPACE](create-tablespace.md) - -## Suggestions - -- UNLOGGED - - The unlogged table and its indexes do not use the WAL log mechanism during data writing. Their write speed is much higher than that of ordinary tables. Therefore, they can be used for storing intermediate result sets of complex queries to improve query performance. - - The unlogged table has no primary/standby mechanism. In case of system faults or abnormal breakpoints, data loss may occur. Therefore, the unlogged table cannot be used to store basic data. - -- TEMPORARY | TEMP - - A temporary table is automatically dropped at the end of a session. - -- LIKE - - The new table automatically inherits all column names, data types, and not-null constraints from this table. The new table is irrelevant to the original table after the creation. - -- LIKE INCLUDING DEFAULTS - - The default expressions are copied from the original table to the new table only if **INCLUDING DEFAULTS** is specified. The default behavior is to exclude default expressions, resulting in the copied columns in the new table having default values null. - -- LIKE INCLUDING CONSTRAINTS - - The **CHECK** constraints are copied from the original table to the new table only when **INCLUDING CONSTRAINTS** is specified. Other types of constraints are never copied to the new table. Not-null constraints are always copied to the new table. These rules also apply to column constraints and table constraints. - -- LIKE INCLUDING INDEXES - - Any indexes on the original table will not be created on the new table, unless the **INCLUDING INDEXES** clause is specified. - -- LIKE INCLUDING STORAGE - - **STORAGE** settings for the copied column definitions are copied only if **INCLUDING STORAGE** is specified. The default behavior is to exclude **STORAGE** settings. - -- LIKE INCLUDING COMMENTS - - If **INCLUDING COMMENTS** is specified, comments for the copied columns, constraints, and indexes are copied. The default behavior is to exclude comments. - -- LIKE INCLUDING PARTITION - - If **INCLUDING PARTITION** is specified, the partition definitions of the source table are copied to the new table, and the new table no longer uses the **PARTITION BY** clause. The default behavior is to exclude partition definition of the original table. - -- LIKE INCLUDING RELOPTIONS - - If **INCLUDING RELOPTIONS** is specified, the new table will copy the storage parameter \(that is, **WITH** clause\) of the source table. The default behavior is to exclude partition definition of the storage parameter of the original table. - -- LIKE INCLUDING ALL - - **INCLUDING ALL** contains the meaning of **INCLUDING DEFAULTS**, **INCLUDING CONSTRAINTS**, **INCLUDING INDEXES**, **INCLUDING STORAGE**, **INCLUDING COMMENTS**, **INCLUDING PARTITION**, and **INCLUDING RELOPTIONS**. - -- ORIENTATION ROW - - Creates a row-store table. Row-store applies to the OLTP service, which has many interactive transactions. An interaction involves many columns in the table. Using row-store can improve the efficiency. - -- ORIENTATION COLUMN - - Creates a column-store table. Column-store applies to the DWS, which has a large amount of aggregation computing, and involves a few column operations. - - diff --git a/content/en/docs/installation/Developerguide/create-tablespace.md b/content/en/docs/installation/Developerguide/create-tablespace.md deleted file mode 100644 index 5b712b0895a98d93e9b05ac7fb1c97fdbb86c53b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-tablespace.md +++ /dev/null @@ -1,131 +0,0 @@ -# CREATE TABLESPACE - -## Function - -**CREATE TABLESPACE** creates a tablespace in a database. - -## Precautions - -- Only system administrators can create a tablespace. -- Do not run **CREATE TABLESPACE** in a transaction block. -- If executing **CREATE TABLESPACE** fails but the internal directory \(or file\) has been created, the directory \(or file\) will remain. You need to manually clear it before creating the tablespace again. If there are residual files of soft links for the tablespace in the data directory, delete the residual files, and then perform O&M operations. -- **CREATE TABLESPACE** cannot be used for two-phase transactions. If it fails on some nodes, the execution cannot be rolled back. -- For details about how to prepare for creating tablespaces, see the description of parameters below. - -## Syntax - -``` -CREATE TABLESPACE tablespace_name - [ OWNER user_name ] RELATIVE LOCATION 'directory' [ MAXSIZE 'space_size' ] - [with_option_clause]; -``` - -The **with\_option\_clause** syntax for creating a general tablespace is as follows: - -``` -WITH ( {filesystem= { 'general'| "general" | general} | - random_page_cost = { 'value ' | value } | - seq_page_cost = { 'value ' | value }}[,...]) -``` - -## Parameter Description - -- **tablespace\_name** - - Specifies name of a tablespace to be created. - - The tablespace name must be distinct from the name of any existing tablespace in openGauss and cannot start with "pg", which are reserved for system catalog spaces. - - Value range: a string. It must comply with the naming convention. - -- **OWNER user\_name** - - Specifies the name of the user who will own the tablespace. If omitted, the default owner is the current user. - - Only system administrators can create tablespaces, but they can use the **OWNER** clause to assign ownership of tablespaces to non-**Sysadmin** administrators. - - Value range: a string. It must be an existing user. - -- **RELATIVE** - - Relative path. The **LOCATION** directory is relative to the data directory in each database node. - - Directory hierarchy: the relative path of the database node directory **/pg\_location/** - - A relative path contains a maximum of two levels. - -- **LOCATION directory** - - Specifies the directory used for the tablespace. The directory must meet the following requirements: - - - The openGauss system user must have the read and write permissions on the directory, and the directory must be empty. If the directory does not exist, the system automatically creates it. - - The directory must be an absolute path, and does not contain special characters, such as dollar sign \($\) and greater-than sign \(\>\). - - The directory cannot be specified under the database data directory. - - The directory must be a local path. - - Value range: a string. It must be a valid directory. - -- **MAXSIZE 'space\_size'** - - Specifies the maximum value of the tablespace in a single database node. - - Value range: a string consisting of a positive integer and unit. The unit can be KB, MB, GB, TB, or PB currently. The unit of parsed value is KB and cannot exceed the range that can be expressed in 64 bits, which is 1 KB to 9007199254740991 KB. - -- **random\_page\_cost** - - Specifies the cost of randomly reading the page overhead. - - Value range: 0 to 1.79769e+308 - - Default value: value of the GUC parameter **random\_page\_cost** - -- **seq\_page\_cost** - - Specifies the cost of reading the page overhead in specified order. - - Value range: 0 to 1.79769e+308 - - Default value: value of GUC parameter **seq\_page\_cost** - - -## Examples - -``` --- Create a tablespace. -postgres=# CREATE TABLESPACE ds_location1 RELATIVE LOCATION 'tablespace/tablespace_1'; - --- Create user joe. -postgres=# CREATE ROLE joe IDENTIFIED BY 'Bigdata@123'; - --- Create user jay. -postgres=# CREATE ROLE jay IDENTIFIED BY 'Bigdata@123'; - --- Create a tablespace and set its owner to user joe. -postgres=# CREATE TABLESPACE ds_location2 OWNER joe RELATIVE LOCATION 'tablespace/tablespace_1'; - --- Rename the ds_location1 tablespace to ds_location3. -postgres=# ALTER TABLESPACE ds_location1 RENAME TO ds_location3; - --- Change the owner of the ds_location2 tablespace. -postgres=# ALTER TABLESPACE ds_location2 OWNER TO jay; - --- Delete the tablespace. -postgres=# DROP TABLESPACE ds_location2; -postgres=# DROP TABLESPACE ds_location3; - --- Delete users. -postgres=# DROP ROLE joe; -postgres=# DROP ROLE jay; -``` - -## Helpful Links - -[CREATE DATABASE](create-database.md), [CREATE TABLE](create-table.md), [CREATE INDEX](create-index.md), [DROP TABLESPACE](drop-tablespace.md), and [ALTER TABLESPACE](alter-tablespace.md) - -## Suggestions - -- create tablespace - - You are not advised to create tablespaces in a transaction. - - diff --git a/content/en/docs/installation/Developerguide/create-text-search-configuration.md b/content/en/docs/installation/Developerguide/create-text-search-configuration.md deleted file mode 100644 index 50f054e4e6df8d87bc103c3e2e37ff815e525888..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-text-search-configuration.md +++ /dev/null @@ -1,123 +0,0 @@ -# CREATE TEXT SEARCH CONFIGURATION - -## Function - -**CREATE TEXT SEARCH CONFIGURATION** creates a text search configuration. A text search configuration specifies a text search parser that can divide a string into tokens, plus dictionaries that can be used to determine which tokens are of interest for searching. - -## Precautions - -- If only the parser is specified, the new text search configuration initially has no mapping from token types to dictionaries, and therefore will ignore all words. Subsequently, **ALTER TEXT SEARCH CONFIGURATION** must be used to create mapping to make the configuration useful. If **COPY** is specified, the parser, mapping and parameters of the text search configuration is copied automatically. -- If the schema name is given, the text search configuration will be created in the specified schema. Otherwise, the configuration will be created in the current schema. -- The user who defines a text search configuration becomes its owner. -- **PARSER** and **COPY** options are mutually exclusive, because when an existing configuration is copied, its parser selection is copied too. -- If only the parser is specified, the new text search configuration initially has no mapping from token types to dictionaries, and therefore will ignore all words. - -## Syntax - -``` -CREATE TEXT SEARCH CONFIGURATION name - ( PARSER = parser_name | COPY = source_config ) - [ WITH ( {configuration_option = value} [, ...] )]; -``` - -## Parameter Description - -- **name** - - Specifies the name of the text search configuration to be created. The name can be schema-qualified. - -- **parser\_name** - - Specifies the name of the text search parser to use for this configuration. - -- **source\_config** - - Specifies the name of an existing text search configuration to copy. - -- **configuration\_option** - - Specifies parameters for the text search configuration, particularly for the parser executed by **parser\_name** or contained by **source\_config**. - - Value range: The default and **ngram** parsers are supported. The parser of default type has no corresponding **configuration\_option**. [Table 1](#en-us_topic_0237122121_en-us_topic_0059777835_t0d301ca84e1a4c16ae8bead85aa1a8c3) lists **configuration\_option** for **ngram** parsers. - - **Table 1** Configuration parameters for **ngram** parsers - - - - - - - - - - - - - - - - - - - - - - -

Parser

-

Parameter

-

Description

-

Value Range

-

ngram

-

gram_size

-

Length of word segmentation

-

Integer, 1 to 4

-

Default value: 2

-

punctuation_ignore

-

Whether to ignore punctuations

-
  • true (default value): Ignore punctuations.
  • false: Do not ignore punctuations.
-

grapsymbol_ignore

-

Whether to ignore graphical characters

-
  • true: Ignore graphical characters.
  • false (default value): Do not ignore graphical characters.
-
- - -## Examples - -``` --- Create a text search configuration. -postgres=# CREATE TEXT SEARCH CONFIGURATION ngram2 (parser=ngram) WITH (gram_size = 2, grapsymbol_ignore = false); - --- Create a text search configuration. -postgres=# CREATE TEXT SEARCH CONFIGURATION ngram3 (copy=ngram2) WITH (gram_size = 2, grapsymbol_ignore = false); - --- Add type mapping. -postgres=# ALTER TEXT SEARCH CONFIGURATION ngram2 ADD MAPPING FOR multisymbol WITH simple; - --- Create user joe. -postgres=# CREATE USER joe IDENTIFIED BY 'Bigdata@123'; - --- Change the owner of the text search configuration. -postgres=# ALTER TEXT SEARCH CONFIGURATION ngram2 OWNER TO joe; - --- Change the schema of the text search configuration. -postgres=# ALTER TEXT SEARCH CONFIGURATION ngram2 SET SCHEMA joe; - --- Rename the text search configuration. -postgres=# ALTER TEXT SEARCH CONFIGURATION joe.ngram2 RENAME TO ngram_2; - --- Delete the type mapping. -postgres=# ALTER TEXT SEARCH CONFIGURATION joe.ngram_2 DROP MAPPING IF EXISTS FOR multisymbol; - --- Delete the text search configuration. -postgres=# DROP TEXT SEARCH CONFIGURATION joe.ngram_2; -postgres=# DROP TEXT SEARCH CONFIGURATION ngram3; - --- Delete the schema and user joe. -postgres=# DROP SCHEMA IF EXISTS joe CASCADE; -postgres=# DROP ROLE IF EXISTS joe; -``` - -## Helpful Links - -[ALTER TEXT SEARCH CONFIGURATION](alter-text-search-configuration.md) and [DROP TEXT SEARCH CONFIGURATION](drop-text-search-configuration.md) - diff --git a/content/en/docs/installation/Developerguide/create-text-search-dictionary.md b/content/en/docs/installation/Developerguide/create-text-search-dictionary.md deleted file mode 100644 index 69c710df70d8d8c0b698f31ce940227a58b4fdab..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-text-search-dictionary.md +++ /dev/null @@ -1,143 +0,0 @@ -# CREATE TEXT SEARCH DICTIONARY - -## Function - -**CREATE TEXT SEARCH DICTIONARY** creates a full-text retrieval dictionary. A dictionary is used to identify and process particular words during full-text retrieval. - -Dictionaries are created by using predefined templates \(defined in the [PG\_TS\_TEMPLATE](pg_ts_template.md) system catalog\). Five types of dictionaries can be created, **Simple**, **Ispell**, **Synonym**, **Thesaurus**, and **Snowball**. These dictionaries are used to handle different types of tasks. - -## Precautions - -- A user with the **SYSADMIN** permission can create a dictionary. Then, the user automatically becomes the owner of the dictionary. -- A dictionary cannot be created in **pg\_temp** mode. -- After a dictionary is created or modified, any modification to the customized dictionary definition file will not affect the dictionary in the database. To make such modifications take effect in the dictionary in the database, run the **ALTER** statement to update the definition file of the dictionary. - -## Syntax - -``` -CREATE TEXT SEARCH DICTIONARY name ( - TEMPLATE = template - [, option = value [, ... ]] -); -``` - -## Parameter Description - -- **name** - - Specifies the name of a dictionary to be created. \(If you do not specify a schema name, the dictionary will be created in the current schema.\) - - Value range: a string, which complies with the identifier naming convention. A value can contain a maximum of 63 characters. - -- **template** - - Specifies a template name. - - Value range: templates \(**Simple**, **Synonym**, **Thesaurus**, **Ispell**, and **Snowball**\) defined in the [PG\_TS\_TEMPLATE](pg_ts_template.md) system catalog - -- **option** - - Specifies a parameter name. Each type of dictionaries has a template containing their custom parameters. Parameters function in a way irrelevant to their setting sequence. - - - Parameters for a **Simple** dictionary - - **STOPWORDS** - - Specifies the name of a file listing stop words. The default file name extension is .stop. In the file, each line defines a stop word. Dictionaries will ignore blank lines and spaces in the file and convert stop-word phrases into lowercase. - - - **ACCEPT** - - Specifies whether to accept a non-stop word as recognized. Default value: **true** - - If **ACCEPT=true** is set for a **Simple** dictionary, no token will be passed to subsequent dictionaries. In this case, you are advised to place the **Simple** dictionary at the end of the dictionary list. If **ACCEPT=false** is set, you are advised to place the **Simple** dictionary before at least one dictionary in the list. - - - **FILEPATH** - - Specifies the directory for storing dictionary files. The directory can be a local directory or an OBS directory. The local directory format is **file://**_absolute\_path_. The OBS directory format is **obs://**_bucket\_name_**/path accesskey=ak secretkey=sk region=rg**. The default value is the directory where predefined dictionary files are located. If any of the **FILEPATH** and **STOPWORDS** parameters is specified, the other one must also be specified. - - - Parameters for a **Synonym** dictionary - - **SYNONYM** - - Specifies the name of the definition file for a **Synonym** dictionary. The default file name extension is .syn. - - The file is a list of synonyms. Each line is in the format of _token synonym_, that is, token and its synonym separated by a space. - - - **CASESENSITIVE** - - Specifies whether tokens and their synonyms are case sensitive. The default value is **false**, indicating that tokens and synonyms in dictionary files will be converted into lowercase. If this parameter is set to **true**, they will not be converted into lowercase. - - - **FILEPATH** - - Specifies the directory for storing **Synonym** dictionary files. The directory can be a local directory or an OBS directory. The local directory format is **file://**_absolute\_path_. The OBS directory format is **obs://**_bucket\_name_**/path accesskey=ak secretkey=sk region=rg**. The default value is the directory where predefined dictionary files are located. - - - Parameters for a **Thesaurus** dictionary - - **DICTFILE** - - Specifies the name of a dictionary definition file. The default file name extension is .ths. - - The file is a list of synonyms. Each line is in the format of _sample words_**:** _indexed words_. The colon \(:\) is used as a separator between a phrase and its substitute word. If multiple sample words are matched, the TZ selects the longest one. - - - **DICTIONARY** - - Specifies the name of a subdictionary used for word normalization. This parameter is mandatory and only one subdictionary name can be specified. The specified subdictionary must exist. It is used to identify and normalize input text before phrase matching. - - If an input word cannot be recognized by the subdictionary, an error will be reported. In this case, remove the word or update the subdictionary to make the word recognizable. In addition, an asterisk \(\*\) can be placed at the beginning of an indexed word to skip the application of a subdictionary on it, but all sample words must be recognizable by the subdictionary. - - If the sample words defined in the dictionary file contain stop words defined in the subdictionary, use question marks \(?\) to replace them. Assume that **a** and **the** are stop words defined in the subdictionary. - - ``` - ? one ? two : swsw - ``` - - **a one the two** and **the one a two** will be matched and output as **swsw**. - - - **FILEPATH** - - Specifies the directory for storing dictionary definition files. The directory can be a local directory or an OBS directory. The local directory format is **file://**_absolute\_path_. The OBS directory format is **obs://**_bucket\_name_**/path accesskey=ak secretkey=sk region=rg**. The default value is the directory where predefined dictionary files are located. - - - Parameters for an **Ispell** dictionary - - **DICTFILE** - - Specifies the name of a dictionary definition file. The default file name extension is .dict. - - - **AFFFILE** - - Specifies the name of an affix file. The default file name extension is .affix. - - - **STOPWORDS** - - Specifies the name of a file listing stop words. The default file name extension is .stop. The file content format is the same as that of the file for a **Simple** dictionary. - - - **FILEPATH** - - Specifies the directory for storing dictionary files. The directory can be a local directory or an OBS directory. The local directory format is **file://**_absolute\_path_. The OBS directory format is **obs://**_bucket\_name_**/path accesskey=ak secretkey=sk region=rg**. The default value is the directory where predefined dictionary files are located. - - - Parameters for a **Snowball** dictionary - - **LANGUAGE** - - Specifies the name of a language whose stemming algorithm will be used. According to spelling rules in the language, the algorithm normalizes the variants of an input word into a basic word or a stem. - - - **STOPWORDS** - - Specifies the name of a file listing stop words. The default file name extension is .stop. The file content format is the same as that of the file for a **Simple** dictionary. - - - **FILEPATH** - - Specifies the directory for storing dictionary definition files. The directory can be a local directory or an OBS directory. The local directory format is **file://**_absolute\_path_. The OBS directory format is **obs://**_bucket\_name_**/path accesskey=ak secretkey=sk region=rg**. The default value is the directory where predefined dictionary files are located. If any of the **FILEPATH** and **STOPWORDS** parameters is specified, the other one must also be specified. - - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The name of a dictionary definition file can contain only lowercase letters, digits, and underscores \(\_\). - -- **value** - - Specifies a parameter value. If the value is not an identifier or a number, enclose it with single quotation marks \(''\). You can also enclose identifiers and numbers. - - -## Examples - -See examples in [Configuration Examples](configuration-examples.md). - -## Helpful Links - -[ALTER TEXT SEARCH DICTIONARY](alter-text-search-dictionary.md) and [CREATE TEXT SEARCH DICTIONARY](create-text-search-dictionary.md) - diff --git a/content/en/docs/installation/Developerguide/create-trigger.md b/content/en/docs/installation/Developerguide/create-trigger.md deleted file mode 100644 index e835bc072da2cb1893560857272690c8a2e9e2ec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-trigger.md +++ /dev/null @@ -1,352 +0,0 @@ -# CREATE TRIGGER - -## Function - -**CREATE TRIGGER** creates a trigger. The trigger will be associated with the specified table or view, and will execute the specified function operations are performed. - -## Precautions - -- Currently, triggers can be created only on ordinary row-store tables, instead of on column-store tables, temporary tables, or unlogged tables. -- If multiple triggers of the same kind are defined for the same event, they will be fired in alphabetical order by name. -- Triggers are usually used for data association and synchronization between multiple tables. SQL execution performance is greatly affected. Therefore, you are advised not to use this statement when a large amount of data needs to be synchronized and performance requirements are high. - -## Syntax - -``` -CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] } - ON table_name - [ FROM referenced_table_name ] - { NOT DEFERRABLE | [ DEFERRABLE ] { INITIALLY IMMEDIATE | INITIALLY DEFERRED } } - [ FOR [ EACH ] { ROW | STATEMENT } ] - [ WHEN ( condition ) ] - EXECUTE PROCEDURE function_name ( arguments ); -``` - -Events include: - -``` - INSERT - UPDATE [ OF column_name [, ... ] ] - DELETE - TRUNCATE -``` - -## Parameter Description - -- **CONSTRAINT** - - \(Optional\) Creates a constraint trigger. That is, the trigger is used as a constraint. This is the same as a regular trigger except that the timing of the trigger firing can be adjusted using **SET CONSTRAINTS**. Constraint triggers must be **AFTER ROW** triggers. - -- **trigger\_name** - - Specifies the name of the trigger to be created. This must be distinct from the name of any other trigger for the same table. The name cannot be schema-qualified — the trigger inherits the schema of its table. For a constraint trigger, this is also the name to use when modifying the trigger's behavior using [SET CONSTRAINTS](set-constraints.md). - - Value range: a string, which complies with the identifier naming convention and contains a maximum of 63 characters. - -- **BEFORE** - - Specifies that the function is called before the event. - -- **AFTER** - - Specifies that the function is called after the event. A constraint trigger can only be specified as **AFTER**. - -- **INSTEAD OF** - - Specifies that the function is called instead of the event. - -- **event** - - Specifies the event that will fire the trigger. Values are **INSERT**, **UPDATE**, **DELETE**, and **TRUNCATE**. Multiple events can be specified using **OR**. - - For **UPDATE** events, it is possible to specify a list of columns using this syntax: - - ``` - UPDATE OF column_name1 [, column_name2 ... ] - ``` - - The trigger will only fire if at least one of the listed columns is mentioned as a target of the **UPDATE** statement. **INSTEAD OF UPDATE** events do not allow a list of columns. - -- **table\_name** - - Specifies the name of the table for which the trigger is created. - - Value range: name of an existing table in the database - -- **referenced\_table\_name** - - Specifies the name of another table referenced by the constraint. This option is used for foreign-key constraints. It can only be specified for constraint triggers. - - Value range: name of an existing table in the database - -- **DEFERRABLE | NOT DEFERRABLE** - - Specifies the start time of the trigger. It can only be specified for constraint triggers. They determine whether the constraint is deferrable. - - For details, see [CREATE TABLE](create-table.md). - -- **INITIALLY IMMEDIATE** **| INITIALLY DEFERRED** - - If the constraint is deferrable, the two clauses specify the default time to check the constraint. It can only be specified for constraint triggers. - - For details, see [CREATE TABLE](create-table.md). - -- **FOR EACH ROW | FOR EACH STATEMENT** - - Specifies the frequency of firing the trigger. - - - **FOR EACH ROW** indicates that the trigger should be fired once for every row affected by the trigger event. - - **FOR EACH STATEMENT** indicates that the trigger should be fired just once per SQL statement. - - If neither is specified, the default is **FOR EACH STATEMENT**. Constraint triggers can only be marked as **FOR EACH ROW**. - -- **condition** - - Specifies whether the trigger function will actually be executed. If **WHEN** is specified, the function will be called only when **condition** returns **true**. - - In **FOR EACH ROW** triggers, the **WHEN** condition can refer to columns of the old and/or new row values by writing **OLD.**_column name_ or **NEW.**_column name_ respectively. In addition, **INSERT** triggers cannot refer to **OLD**, and **DELETE** triggers cannot refer to **NEW**. - - **INSTEAD OF** triggers do not support **WHEN** conditions. - - Currently, **WHEN** expressions cannot contain subqueries. - - Note that for constraint triggers, evaluation of the **WHEN** condition is not deferred, but occurs immediately after the row update operation is performed. If the condition does not evaluate to **true**, then the trigger is not queued for deferred execution. - -- **function\_name** - - Specifies a user-defined function, which must be declared as taking no parameters and returning type trigger. This is executed when a trigger fires. - -- **arguments** - - Specifies an optional comma-separated list of parameters to be provided to the function when the trigger is executed. The parameters are literal string constants. Simple names and numeric constants can also be written here, but they will all be converted to strings. Check the description of the implementation language of the trigger function to find out how these parameters can be accessed within the function. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The following details trigger types: - >- **INSTEAD OF** triggers must be marked as **FOR EACH ROW** and can be defined only on views. - >- **BEFORE** and **AFTER** triggers on a view must be marked as **FOR EACH STATEMENT**. - >- **TRUNCATE** triggers must be marked as **FOR EACH STATEMENT**. - - **Table 1** Types of triggers supported on tables and views - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

When

-

Event

-

Row-Level

-

Statement-Level

-

BEFORE

-

INSERT/UPDATE/DELETE

-

Tables

-

Tables and views

-

TRUNCATE

-

Not supported.

-

Tables

-

AFTER

-

INSERT/UPDATE/DELETE

-

Tables

-

Tables and views

-

TRUNCATE

-

Not supported.

-

Tables

-

INSTEAD OF

-

INSERT/UPDATE/DELETE

-

Views

-

Not supported.

-

TRUNCATE

-

Not supported.

-

Not supported.

-
- - **Table 2** Special variables in PL/pgSQL functions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Variable

-

Description

-

NEW

-

New tuple for INSERT and UPDATE operations. This variable is NULL for DELETE operations.

-

OLD

-

Old tuple for UPDATE and DELETE operations. This variable is NULL for INSERT operations.

-

TG_NAME

-

Trigger name.

-

TG_WHEN

-

Trigger timing (BEFORE, AFTER, or INSTEAD OF).

-

TG_LEVEL

-

Trigger frequency (ROW or STATEMENT).

-

TG_OP

-

Trigger event (INSERT, UPDATE, DELETE, or TRUNCATE).

-

TG_RELID

-

OID of the table where the trigger resides.

-

TG_RELNAME

-

Name of the table where the trigger resides. (This variable has been replaced by TG_TABLE_NAME.)

-

TG_TABLE_NAME

-

Name of the table where the trigger resides.

-

TG_TABLE_SCHEMA

-

Schema of the table where the trigger resides.

-

TG_NARGS

-

Number of parameters for the trigger function.

-

TG_ARGV[]

-

List of parameters for the trigger function.

-
- - -## Examples - -``` --- Create a source table and a destination table. -postgres=# CREATE TABLE test_trigger_src_tbl(id1 INT, id2 INT, id3 INT); -postgres=# CREATE TABLE test_trigger_des_tbl(id1 INT, id2 INT, id3 INT); - --- Create a trigger function. -postgres=# CREATE OR REPLACE FUNCTION tri_insert_func() RETURNS TRIGGER AS - $$ - DECLARE - BEGIN - INSERT INTO test_trigger_des_tbl VALUES(NEW.id1, NEW.id2, NEW.id3); - RETURN NEW; - END - $$ LANGUAGE PLPGSQL; - -postgres=# CREATE OR REPLACE FUNCTION tri_update_func() RETURNS TRIGGER AS - $$ - DECLARE - BEGIN - UPDATE test_trigger_des_tbl SET id3 = NEW.id3 WHERE id1=OLD.id1; - RETURN OLD; - END - $$ LANGUAGE PLPGSQL; - -postgres=# CREATE OR REPLACE FUNCTION TRI_DELETE_FUNC() RETURNS TRIGGER AS - $$ - DECLARE - BEGIN - DELETE FROM test_trigger_des_tbl WHERE id1=OLD.id1; - RETURN OLD; - END - $$ LANGUAGE PLPGSQL; - --- Create an INSERT trigger. -postgres=# CREATE TRIGGER insert_trigger - BEFORE INSERT ON test_trigger_src_tbl - FOR EACH ROW - EXECUTE PROCEDURE tri_insert_func(); - --- Create an UPDATE trigger. -postgres=# CREATE TRIGGER update_trigger - AFTER UPDATE ON test_trigger_src_tbl - FOR EACH ROW - EXECUTE PROCEDURE tri_update_func(); - --- Create a DELETE trigger. -postgres=# CREATE TRIGGER delete_trigger - BEFORE DELETE ON test_trigger_src_tbl - FOR EACH ROW - EXECUTE PROCEDURE tri_delete_func(); - --- Execute the INSERT event and check the trigger results. -postgres=# INSERT INTO test_trigger_src_tbl VALUES(100,200,300); -postgres=# SELECT * FROM test_trigger_src_tbl; -postgres=# SELECT * FROM test_trigger_des_tbl; //Check whether the trigger operation takes effect. - --- Execute the UPDATE event and check the trigger results. -postgres=# UPDATE test_trigger_src_tbl SET id3=400 WHERE id1=100; -postgres=# SELECT * FROM test_trigger_src_tbl; -postgres=# SELECT * FROM test_trigger_des_tbl; //Check whether the trigger operation takes effect. - --- Execute the DELETE event and check the trigger results. -postgres=# DELETE FROM test_trigger_src_tbl WHERE id1=100; -postgres=# SELECT * FROM test_trigger_src_tbl; -postgres=# SELECT * FROM test_trigger_des_tbl; //Check whether the trigger operation takes effect. - --- Modify a trigger. -postgres=# ALTER TRIGGER delete_trigger ON test_trigger_src_tbl RENAME TO delete_trigger_renamed; - --- Disable insert_trigger. -postgres=# ALTER TABLE test_trigger_src_tbl DISABLE TRIGGER insert_trigger; - --- Disable all triggers on the current table. -postgres=# ALTER TABLE test_trigger_src_tbl DISABLE TRIGGER ALL; - --- Delete triggers. -postgres=# DROP TRIGGER insert_trigger ON test_trigger_src_tbl; -postgres=# DROP TRIGGER update_trigger ON test_trigger_src_tbl; -postgres=# DROP TRIGGER delete_trigger_renamed ON test_trigger_src_tbl; -``` - -## Helpful Links - -[ALTER TRIGGER](alter-trigger.md), [DROP TRIGGER](drop-trigger.md), and [ALTER TABLE](alter-table.md) - diff --git a/content/en/docs/installation/Developerguide/create-type.md b/content/en/docs/installation/Developerguide/create-type.md deleted file mode 100644 index 7147d9b58b28789d30f4b6fe25195386923f452c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-type.md +++ /dev/null @@ -1,274 +0,0 @@ -# CREATE TYPE - -## Function - -**CREATE TYPE** registers a new data type for use in the current database. The user who defines a type becomes its owner. Types are designed only for row-store tables. - -The following data types can be created: composite type, base type, shell type, and enumerated type. - -- Composite type - - A composite type is specified by a list of attribute names and data types. If the data type of an attribute is collatable, the attribute's collation rule can also be specified. This is essentially the same as the row type of a table, but using **CREATE TYPE** avoids the need to create an actual table when all that is wanted is to define a type. A stand-alone composite type is useful as the parameter or return type of a function. - - To create a composite type, you must have the **USAGE** permission on all of its attribute types. - -- Base type - - You can create a base type \(scalar type\). Generally, these functions must be written in the underlying language. - -- Shell type - - A shell type is simply a placeholder for a type to be defined later; it is created by issuing **CREATE TYPE** with no parameters except for the type name. Shell types are needed as forward references when base types are created. - -- Enumerated type - - An enumerated type is a list of one or more quoted labels, each of which must be 1 to 64 bytes long. - - -## Precautions - -If a schema name is given then the type is created in the specified schema. Otherwise, it is created in the current schema. The type name must be distinct from the name of any existing type or domain in the same schema. \(Because tables have associated data types, the type name must also be distinct from the name of any existing table in the same schema.\) - -## Syntax - -``` -CREATE TYPE name AS - ( [ attribute_name data_type [ COLLATE collation ] [, ... ] ] ) - -CREATE TYPE name ( - INPUT = input_function, - OUTPUT = output_function - [ , RECEIVE = receive_function ] - [ , SEND = send_function ] - [ , TYPMOD_IN = -type_modifier_input_function ] - [ , TYPMOD_OUT = -type_modifier_output_function ] - [ , ANALYZE = analyze_function ] - [ , INTERNALLENGTH = { internallength | -VARIABLE } ] - [ , PASSEDBYVALUE ] - [ , ALIGNMENT = alignment ] - [ , STORAGE = storage ] - [ , LIKE = like_type ] - [ , CATEGORY = category ] - [ , PREFERRED = preferred ] - [ , DEFAULT = default ] - [ , ELEMENT = element ] - [ , DELIMITER = delimiter ] - [ , COLLATABLE = collatable ] -) - -CREATE TYPE name - -CREATE TYPE name AS ENUM - ( [ 'label' [, ... ] ] ) -``` - -## Parameter Description - -Composite type - -- **name** - - Specifies the name \(optionally schema-qualified\) of the type to be created. - -- **attribute\_name** - - Specifies the name of an attribute \(column\) for the composite type. - -- **data\_type** - - Specifies the name of an existing data type to become a column of the composite type. - -- **collation** - - Specifies the name of an existing collation rule to be associated with a column of the composite type. - - -Base type - -When creating a base type, you can place parameters in any order. The **input\_function** and **output\_function** parameters are mandatory, and other parameters are optional. - -- **input\_function** - - Specifies the name of a function that converts data from the type's external textual form to its internal form. - - The input function may be declared as taking one parameter of type cstring or taking three parameters of types cstring, oid, and integer. - - - The first parameter is the input text as a C string, - - the second parameter is the type's own OID \(except for array types, which instead receive their element type's OID\), - - and the third is the typmod of the destination column, if known \(**-1** will be passed if not\). - - The input function must return a value of the data type itself. Usually, an input function should be declared **STRICT**; if it is not, it will be called with a **NULL** first parameter when reading a **NULL** input value. The function must still return **NULL** in this case, unless it raises an error. \(This case is mainly meant to support domain input functions, which might need to reject **NULL** inputs.\) - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The input and output functions can be declared to have results or parameters of the new type, when they have to be created before the new type can be created. The type should first be defined as a shell type, which is a placeholder type that has no attributes except a name and an owner. This is done by issuing the **CREATE TYPE **_name_ statement, with no additional parameters. Then the I/O functions can be defined referencing the shell type. Finally, **CREATE TYPE** with a full definition replaces the shell entry with a complete, valid type definition, after which the new type can be used normally. - -- **output\_function** - - Specifies the name of a function that converts data from the type's internal form to its external textual form. - - The output function must be declared as taking one parameter of the new data type. The output function must return type cstring. Output functions are not invoked for **NULL** values. - -- **receive\_function** - - \(Optional\) Specifies the name of a function that converts data from the type's external binary form to its internal form. - - If this function is not supplied, the type cannot participate in binary input. The binary representation should be chosen to be cheap to convert to internal form, while being reasonably portable. \(For example, the standard integer data types use network byte order as the external binary representation, while the internal representation is in the machine's native byte order.\) The receive function should perform adequate checking to ensure that the value is valid. - - The receive function may be declared as taking one parameter of type internal or taking three parameters of types internal, oid, integer. - - - The first parameter is a pointer to a StringInfo buffer holding the received byte string; - - the latter two are the same as for the text input function. - - The receive function must return a value of the data type itself. Usually, a receive function should be declared **STRICT**; if it is not, it will be called with a **NULL** first parameter when reading a **NULL** input value. The function must still return **NULL** in this case, unless it raises an error. \(This case is mainly meant to support domain receive functions, which might need to reject **NULL** inputs.\) - -- **send\_function** - - \(Optional\) Specifies the name of a function that converts data from the type's internal form to its external binary form. - - If this function is not supplied, the type cannot participate in binary output. The send function must be declared as taking one parameter of the new data type. The send function must return type bytea. Send functions are not invoked for **NULL** values. - -- **type\_modifier\_input\_function** - - \(Optional\) Specifies the name of a function that converts an array of modifier\(s\) for the type to an internal form. - -- **type\_modifier\_output\_function** - - \(Optional\) Specifies the name of a function that converts the internal form of the type's modifier\(s\) to its external textual form. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >**type\_modifier\_input\_function** and **type\_modifier\_output\_function** are needed if the type supports modifiers, that is optional constraints attached to a type declaration, such as char\(5\) or numeric\(30,2\). openGauss allows user-defined types to take one or more simple constants or identifiers as modifiers. However, this information must be capable of being packed into a single non-negative integer value for storage in the system catalogs. The **type\_modifier\_input\_function** is passed the declared modifier\(s\) in the form of a cstring array. It must check the values for validity \(throwing an error if they are wrong\), and if they are correct, return a single non-negative integer value that will be stored as the column "typmod". Type modifiers will be rejected if the type does not have a **type\_modifier\_input\_function**. The **type\_modifier\_output\_function** converts the internal integer typmod value back to the correct form for user display. It must return a cstring value that is the exact string to append to the type name; for example numeric's function might return \(30,2\). It is allowed to omit the **type\_modifier\_output\_function**, in which case the default display format is just the stored typmod integer value enclosed in parentheses. - -- **analyze\_function** - - \(Optional\) Specifies the name of a function that performs statistical analysis for the data type. - - By default, **ANALYZE** will attempt to gather statistics using the type's "equals" and "less-than" operators, if there is a default b-tree operator class for the type. For non-scalar types, this behavior is likely to be unsuitable, so it can be overridden by specifying a custom analysis function. The analysis function must be declared to take one parameter of type internal and return a boolean result. - -- **internallength** - - \(Optional\) Specifies the length in bytes of the new type's internal representation. The default assumption is that it is variable-length. - - While the details of the new type's internal representation are only known to the I/O functions and other functions you create to work with the type, there are several attributes of the internal representation that must be declared to openGauss. **internallength** is the most important one. Base data types can be fixed-length, in which case **internallength** is a positive integer, or variable length, indicated by setting **internallength** to **VARIABLE**. \(Internally, this is represented by setting **typlen** to **-1**.\) The internal representation of all variable-length types must start with a 4-byte integer giving the total length of this value of the type. - -- **PASSEDBYVALUE** - - \(Optional\) Indicates that values of this data type are passed by value, rather than by reference. You cannot pass by value types whose internal representation is larger than the size of the Datum type \(4 bytes on most machines, 8 bytes on a few\). - -- **alignment** - - \(Optional\) Specifies the storage alignment requirement of the data type. If specified, it must be **char**, **int2**, **int4**, or **double**; the default is **int4**. - - The allowed values equate to alignment on 1, 2, 4, or 8 byte boundaries. Note that variable-length types must have an alignment of at least 4, since they necessarily contain an int4 as their first component. - -- **storage** - - \(Optional\) Specifies the storage strategy for the data type. - - If specified, it must be **plain**, **external**, **extended**, or **main**; the default is **plain**. - - - **plain** specifies that data of the type will always be stored in-line and not compressed. \(Only **plain** is allowed for fixed-length types.\) - - **extended** specifies that the system will first try to compress a long data value, and will move the value out of the main table row if it is still too long. - - **external** allows the value to be moved out of the main table, but the system will not try to compress it. - - **main** allows compression, but discourages moving the value out of the main table. \(Data items with this storage strategy might still be moved out of the main table if there is no other way to make a row fit, but they will be kept in the main table preferentially over **extended** and **external** items.\) - - All **storage** values other than **plain** imply that the functions of the data type can handle values that have been toasted. The specific other value given merely determines the default **TOAST** storage strategy for columns of a toastable data type; users can pick other strategies for individual columns using **ALTER TABLE SET STORAGE**. - - -- **like\_type** - - \(Optional\) Specifies the name of an existing data type that the new type will have the same representation as. The values of **internallength**, **passedbyvalue**, **alignment**, and **storage** are copied from that type, unless overridden by explicit specification elsewhere in this **CREATE TYPE** statement. - - Specifying representation in this way is especially useful when the low-level implementation of a new type references an existing type. - -- **category** - - \(Optional\) Specifies the category code \(a single ASCII character\) for this type. The default is **U** for a user-defined type. You may also choose other ASCII characters to create custom categories. - -- **preferred** - - \(Optional\) Specifies whether a type is preferred within its type category. If it is, the value will be **TRUE**, else **FALSE**. The default is **FALSE**. Be very careful about creating a preferred type within an existing type category, as this could cause surprising changes in behavior. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The **category** and **preferred** parameters can be used to help control which implicit cast will be applied in ambiguous situations. Each data type belongs to a category named by a single ASCII character, and each type is either preferred or not within its category. The parser will prefer casting to preferred types \(but only from other types within the same category\) when this rule is helpful in resolving overloaded functions or operators. For types that have no implicit casts to or from any other types, it is sufficient to leave these settings at the defaults. However, for a group of related types that have implicit casts, it is often helpful to mark them all as belonging to a category and select one or two of the most general types as being preferred within the category. The **category** parameter is especially useful when adding a user-defined type to an existing built-in category, such as the numeric or string types. However, it is also possible to create entirely-user-defined type categories. Select any ASCII character other than an uppercase letter to name such a category. - -- **default** - - \(Optional\) Specifies the default value for the data type. If this is omitted, the default is null. - - A default value can be specified, in case a user wants columns of the data type to default to something other than the null value. Specify the default with the **DEFAULT** keyword. \(Such a default can be overridden by an explicit **DEFAULT** clause attached to a particular column.\) - -- **element** - - \(Optional\) Specifies the type of array elements when an array type is created. For example, to define an array of 4-byte integers \(int4\), specify **ELEMENT = int4**. - -- **delimiter** - - \(Optional\) Specifies the delimiter character to be used between values in arrays made of this type. - - **delimiter** can be set to a specific character. The default delimiter is the comma \(,\). Note that the delimiter is associated with the array element type, not the array type itself. - -- **collatable** - - \(Optional\) Specifies whether this type's operations can use collation information. If they can, the value will be **TRUE**, else **FALSE** \(default\). - - If **collatable** is **TRUE**, column definitions and expressions of the type may carry collation information through use of the **COLLATE** clause. It is up to the implementations of the functions operating on the type to actually use the collation information; this does not happen automatically merely by marking the type collatable. - -- **lable** - - \(Optional\) Represents the textual label associated with one value of an enumerated type. It is a string of 1 to 64 characters. - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->Whenever a user-defined type is created, openGauss automatically creates an associated array type whose name consists of the element type's name prepended with an underscore \(\_\). - -## Examples - -``` --- Create a composite type, create a table, insert data, and make a query. -postgres=# CREATE TYPE compfoo AS (f1 int, f2 text); -postgres=# CREATE TABLE t1_compfoo(a int, b compfoo); -postgres=# CREATE TABLE t2_compfoo(a int, b compfoo); -postgres=# INSERT INTO t1_compfoo values(1,(1,'demo')); -postgres=# INSERT INTO t2_compfoo select * from t1_compfoo; -postgres=# SELECT (b).f1 FROM t1_compfoo; -postgres=# SELECT * FROM t1_compfoo t1 join t2_compfoo t2 on (t1.b).f1=(t1.b).f1; - --- Rename the data type. -postgres=# ALTER TYPE compfoo RENAME TO compfoo1; - --- Change the owner of the user-defined type compfoo1 to usr1. -postgres=# CREATE USER usr1 PASSWORD 'Bigdata@123'; -postgres=# ALTER TYPE compfoo1 OWNER TO usr1; - --- Change the schema of the user-defined type compfoo1 to usr1. -postgres=# ALTER TYPE compfoo1 SET SCHEMA usr1; - --- Add a new attribute to the data type. -postgres=# ALTER TYPE usr1.compfoo1 ADD ATTRIBUTE f3 int; - --- Delete the compfoo1 type. -postgres=# DROP TYPE usr1.compfoo1 cascade; - --- Delete related tables and users. -postgres=# DROP TABLE t1_compfoo; -postgres=# DROP TABLE t2_compfoo; -postgres=# DROP SCHEMA usr1; -postgres=# DROP USER usr1; - --- Create an enumerated type. -postgres=# CREATE TYPE bugstatus AS ENUM ('create', 'modify', 'closed'); - --- Add a label. -postgres=# ALTER TYPE bugstatus ADD VALUE IF NOT EXISTS 'regress' BEFORE 'closed'; - --- Rename the label. -postgres=# ALTER TYPE bugstatus RENAME VALUE 'create' TO 'new'; -``` - -## Helpful Links - -[ALTER TYPE](alter-type.md) and [DROP TYPE](drop-type.md) - diff --git a/content/en/docs/installation/Developerguide/create-user-mapping.md b/content/en/docs/installation/Developerguide/create-user-mapping.md deleted file mode 100644 index fb0486d15c165671465e900a474ac90a70576e43..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-user-mapping.md +++ /dev/null @@ -1,64 +0,0 @@ -# CREATE USER MAPPING - -## Function - -**CREATE USER MAPPING** defines a new mapping from a user to a foreign server. - -## Syntax - -``` -CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER | PUBLIC } - SERVER server_name - [ OPTIONS ( option 'value' [ , ... ] ) ] -``` - -## Parameter Description - -- **user\_name** - - Specifies the name of an existing user to map to a foreign server. - - CURRENT\_USER and USER match the name of the current user. When PUBLIC is specified, a public mapping is created and used when no mapping for a particular user is available. - -- **server\_name** - - Specifies the name of the existing server for which a user mapping will be created. - -- **OPTIONS \( \{ option\_name ' value ' \} \[, ...\] \)** - - Specifies options for user mapping. These options typically define the actual user name and password for this mapping. The option name must be unique. The allowed option names and values are related to the foreign data wrapper of the server. - - - Options supported by oracle\_fdw are as follows: - - user - - Oracle server user name. - - - password - - Password of the Oracle user. - - - Options supported by mysql\_fdw are as follows: - - username - - User name of the MySQL server or MariaDB. - - - password - - User password of the MySQL server or MariaDB. - - - Options supported by postgres\_fdw are as follows: - - user - - User name of the remote openGauss database. - - - password - - User password of the remote openGauss database. - - - - -## Helpful Links - -[ALTER USER MAPPING](alter-user-mapping.md) and [DROP USER MAPPING](drop-user-mapping.md) - diff --git a/content/en/docs/installation/Developerguide/create-user.md b/content/en/docs/installation/Developerguide/create-user.md deleted file mode 100644 index c263de3d4dfe82e779ead4e95df2d0369cf64b79..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-user.md +++ /dev/null @@ -1,111 +0,0 @@ -# CREATE USER - -## Function - -**CREATE USER** creates a user. - -## Precautions - -- A user created using the **CREATE USER** statement has the **LOGIN** permission by default. -- A schema named after the user is automatically created in the database where the statement is executed, but not in other databases. You can run the **CREATE SCHEMA** statement to create such a schema for the user in other databases. -- The owner of an object created by a system administrator in a schema with the same name as a common user is the common user, not the system administrator. - -## Syntax - -``` -CREATE USER user_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' | DISABLE }; -``` - -The **option** clause is used to configure information, including permissions and properties. - -``` -{SYSADMIN | NOSYSADMIN} - | {AUDITADMIN | NOAUDITADMIN} - | {CREATEDB | NOCREATEDB} - | {USEFT | NOUSEFT} - | {CREATEROLE | NOCREATEROLE} - | {INHERIT | NOINHERIT} - | {LOGIN | NOLOGIN} - | {REPLICATION | NOREPLICATION} - | {INDEPENDENT | NOINDEPENDENT} - | {VCADMIN | NOVCADMIN} - | CONNECTION LIMIT connlimit - | VALID BEGIN 'timestamp' - | VALID UNTIL 'timestamp' - | RESOURCE POOL 'respool' - | PERM SPACE 'spacelimit' - | TEMP SPACE 'tmpspacelimit' - | SPILL SPACE 'spillspacelimit' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN role_name [, ...] - | USER role_name [, ...] - | SYSID uid - | DEFAULT TABLESPACE tablespace_name - | PROFILE DEFAULT - | PROFILE profile_name - | PGUSER -``` - -## Parameter Description - -- **user\_name** - - Username - - Value range: a string. It must comply with the naming convention. It can contain a maximum of 63 characters. - -- **password** - - Specifies the login password. - - The new password must: - - - Contain at least eight characters. This is the default length. - - Differ from the username or the username spelled backward. - - Contain at least three types of the following four types of characters: uppercase characters \(A to Z\), lowercase characters \(a to z\), digits \(0 to 9\), and special characters, including: \~!@\#$%^&\*\(\)-\_=+\\|\[\{\}\];:,<.\>/? - - Be enclosed by single or double quotation marks. - - Value range: a string - - -For other parameters, see [CREATE ROLE](create-role.md). - -## Example - -``` --- Create user jim whose login password is Bigdata@123: -postgres=# CREATE USER jim PASSWORD 'Bigdata@123'; - --- Alternatively, you can run the following statement: -postgres=# CREATE USER kim IDENTIFIED BY 'Bigdata@123'; - --- To create a user with the CREATEDB permission, add the CREATEDB keyword. -postgres=# CREATE USER dim CREATEDB PASSWORD 'Bigdata@123'; - --- Change user jim's login password from Bigdata123@ to Abcd@123: -postgres=# ALTER USER jim IDENTIFIED BY 'Abcd@123' REPLACE 'Bigdata@123'; - --- Add the CREATEROLE permission to jim. -postgres=# ALTER USER jim CREATEROLE; - --- Set enable_seqscan to on. (The setting will take effect in the next session.) -postgres=# ALTER USER jim SET enable_seqscan TO on; - --- Reset the enable_seqscan parameter for jim. -postgres=# ALTER USER jim RESET enable_seqscan; - --- Lock jim. -postgres=# ALTER USER jim ACCOUNT LOCK; - --- Delete users. -postgres=# DROP USER kim CASCADE; -postgres=# DROP USER jim CASCADE; -postgres=# DROP USER dim CASCADE; -``` - -## Helpful Links - -[ALTER USER](alter-user.md), [CREATE ROLE](create-role.md), and [DROP USER](drop-user.md) - diff --git a/content/en/docs/installation/Developerguide/create-view.md b/content/en/docs/installation/Developerguide/create-view.md deleted file mode 100644 index 468ecbea5a76dd3892acad57d5e89557cf23a23b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/create-view.md +++ /dev/null @@ -1,74 +0,0 @@ -# CREATE VIEW - -## Function - -**CREATE VIEW** creates a view. A view is a virtual table, not a base table. Only view definition is stored in the database and view data is not. The data is stored in a base table. If data in the base table changes, the data in the view changes accordingly. In this sense, a view is like a window through which users can know their interested data and data changes in the database. - -## Precautions - -None - -## Syntax - -``` -CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( column_name [, ...] ) ] - [ WITH ( {view_option_name [= view_option_value]} [, ... ] ) ] - AS query; -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->You can use **WITH \(security\_barriers\)** to create a relatively secure view. This prevents attackers from printing hidden base table data by using the **RAISE** statement of low-cost functions. - -## Parameter Description - -- **OR REPLACE** - - Redefines the view if it already exists. - -- **TEMP | TEMPORARY** - - Creates a temporary view. - -- **view\_name** - - Specifies the name \(optionally schema-qualified\) of the view to be created. - - Value range: a string. It must comply with the naming convention. - -- **column\_name** - - Specifies an optional list of names to be used for columns of the view. If not given, the column names are deduced from the query. - - Value range: a string. It must comply with the naming convention. - -- **view\_option\_name \[= view\_option\_value\]** - - Specifies an optional parameter for a view. - - Currently, **view\_option\_name** supports only the **security\_barrier** parameter. This parameter is used when the view attempts to provide row-level security. - - Value range: Boolean type, **TRUE**, and **FALSE**. - -- **query** - - Specifies a **SELECT** or **VALUES** statement that will provide the columns and rows of the view. - - -## Examples - -``` --- Create a view consisting of columns whose spcname is pg_default. -postgres=# CREATE VIEW myView AS - SELECT * FROM pg_tablespace WHERE spcname = 'pg_default'; - --- Query the view. -postgres=# SELECT * FROM myView ; - --- Delete the view. -postgres=# DROP VIEW myView; -``` - -## Helpful Links - -[ALTER VIEW](alter-view.md) and [DROP VIEW](drop-view.md) - diff --git a/content/en/docs/installation/Developerguide/creating-an-index-30.md b/content/en/docs/installation/Developerguide/creating-an-index-30.md deleted file mode 100644 index c496d78918fb8cd14fac09ba33201deed27d3f5b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-an-index-30.md +++ /dev/null @@ -1,59 +0,0 @@ -# Creating an Index - -You can create a **GIN** index to speed up text searches: - -``` -postgres=# CREATE INDEX pgweb_idx_1 ON tsearch.pgweb USING gin(to_tsvector('english', body)); -``` - -The **to\_tsvector** function comes in to two versions: the 1-argument version and the 2-argument version. When the 1-argument version is used, the system uses the configuration specified by **default\_text\_search\_config** by default. - -Notice that the 2-argument version of **to\_tsvector** is used for index creation. Only text search functions that specify a configuration name can be used in expression indexes. This is because the index contents must be unaffected by **default\_text\_search\_config**, whose value can be changed at any time. If they were affected, the index contents might be inconsistent, because different entries could contain **tsvectors** that were created with different text search configurations, and there would be no way to guess which was which. It would be impossible to dump and restore such an index correctly. - -Because the two-argument version of **to\_tsvector** was used in the index above, only a query reference that uses the 2-argument version of **to\_tsvector** with the same configuration name will use that index. That is, **WHERE to\_tsvector\('english', body\) @@ 'a & b'** can use the index, but **WHERE to\_tsvector\(body\) @@ 'a & b'** cannot. This ensures that an index will be used only with the same configuration used to create the index entries. - -It is possible to set up more complex expression indexes wherein the configuration name is specified by another column. For example: - -``` -postgres=# CREATE INDEX pgweb_idx_2 ON tsearch.pgweb USING gin(to_tsvector('ngram', body)); -``` - -where **body** is a column in the **pgweb** table. This allows mixed configurations in the same index while recording which configuration was used for each index entry. This would be useful, for example, if the document collection contained documents in different languages. Again, queries that are meant to use the index must be phrased to match, for example, **WHERE to\_tsvector\(config\_name, body\) @@ 'a & b'** must match **to\_tsvector** in the index. - -Indexes can even concatenate columns: - -``` -postgres=# CREATE INDEX pgweb_idx_3 ON tsearch.pgweb USING gin(to_tsvector('english', title || ' ' || body)); -``` - -Another approach is to create a separate **tsvector** column to hold the output of **to\_tsvector**. This example is a concatenation of **title** and **body**, using **coalesce** to ensure that one column will still be indexed when the other is **NULL**: - -``` -postgres=# ALTER TABLE tsearch.pgweb ADD COLUMN textsearchable_index_col tsvector; -postgres=# UPDATE tsearch.pgweb SET textsearchable_index_col = to_tsvector('english', coalesce(title,'') || ' ' || coalesce(body,'')); -``` - -Then, create a GIN index to speed up the search: - -``` -postgres=# CREATE INDEX textsearch_idx_4 ON tsearch.pgweb USING gin(textsearchable_index_col); -``` - -Now you are ready to perform a fast full text search: - -``` -postgres=# SELECT title -FROM tsearch.pgweb -WHERE textsearchable_index_col @@ to_tsquery('north & america') -ORDER BY last_mod_date DESC -LIMIT 10; - - title --------- - Canada - Mexico -(2 rows) -``` - -One advantage of the separate-column approach over an expression index is that it is unnecessary to explicitly specify the text search configuration in queries in order to use the index. As shown in the preceding example, the query can depend on **default\_text\_search\_config**. Another advantage is that searches will be faster, since it will not be necessary to redo the **to\_tsvector** calls to verify index matches. The expression-index approach is simpler to set up, however, and it requires less disk space since the **tsvector** representation is not stored explicitly. - diff --git a/content/en/docs/installation/Developerguide/creating-an-index-for-an-mot-table.md b/content/en/docs/installation/Developerguide/creating-an-index-for-an-mot-table.md deleted file mode 100644 index af987e5ee8c8481979327f36a4b094f80b550347..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-an-index-for-an-mot-table.md +++ /dev/null @@ -1,33 +0,0 @@ -# Creating an Index for an MOT Table - -Standard PostgreSQL create and drop index statements are supported. - -For example – - -``` -create index text_index1 on test(x) ; -``` - -The following is a complete example of creating an index for the ORDER table in a TPC-C workload – - -``` -create FOREIGN table bmsql_oorder ( - o_w_id integer not null, - o_d_id integer not null, - o_id integer not null, - o_c_id integer not null, - o_carrier_id integer, - o_ol_cnt integer, - o_all_local integer, - o_entry_d timestamp, - primarykey (o_w_id, o_d_id, o_id) -); - -create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->There is no need to specify the **FOREIGN** keyword before the MOT table name, because it is only created for create and drop table commands. - -For MOT index limitations, see the Index subsection under the _SQL Coverage and Limitations _section. - diff --git a/content/en/docs/installation/Developerguide/creating-an-index.md b/content/en/docs/installation/Developerguide/creating-an-index.md deleted file mode 100644 index 61628f46e6e91a5bf98533d164c45ce1fff526af..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-an-index.md +++ /dev/null @@ -1,59 +0,0 @@ -# Creating an Index - -You can create a **GIN** index to speed up text searches: - -``` -postgres=# CREATE INDEX pgweb_idx_1 ON tsearch.pgweb USING gin(to_tsvector('english', body)); -``` - -The **to\_tsvector** function comes in to two versions: the 1-argument version and the 2-argument version. When the 1-argument version is used, the system uses the configuration specified by **default\_text\_search\_config** by default. - -Notice that the 2-argument version of **to\_tsvector** is used for index creation. Only text search functions that specify a configuration name can be used in expression indexes. This is because the index contents must be unaffected by **default\_text\_search\_config**, whose value can be changed at any time. If they were affected, the index contents might be inconsistent, because different entries could contain **tsvectors** that were created with different text search configurations, and there would be no way to guess which was which. It would be impossible to dump and restore such an index correctly. - -Because the two-argument version of **to\_tsvector** was used in the index above, only a query reference that uses the 2-argument version of **to\_tsvector** with the same configuration name will use that index. That is, **WHERE to\_tsvector\('english', body\) @@ 'a & b'** can use the index, but **WHERE to\_tsvector\(body\) @@ 'a & b'** cannot. This ensures that an index will be used only with the same configuration used to create the index entries. - -It is possible to set up more complex expression indexes wherein the configuration name is specified by another column. For example: - -``` -postgres=# CREATE INDEX pgweb_idx_2 ON tsearch.pgweb USING gin(to_tsvector('ngram', body)); -``` - -where **body** is a column in the **pgweb** table. This allows mixed configurations in the same index while recording which configuration was used for each index entry. This would be useful, for example, if the document collection contained documents in different languages. Again, queries that are meant to use the index must be phrased to match, for example, **WHERE to\_tsvector\(config\_name, body\) @@ 'a & b'** must match **to\_tsvector** in the index. - -Indexes can even concatenate columns: - -``` -postgres=# CREATE INDEX pgweb_idx_3 ON tsearch.pgweb USING gin(to_tsvector('english', title || ' ' || body)); -``` - -Another approach is to create a separate **tsvector** column to hold the output of **to\_tsvector**. This example is a concatenation of **title** and **body**, using **coalesce** to ensure that one column will still be indexed when the other is **NULL**: - -``` -postgres=# ALTER TABLE tsearch.pgweb ADD COLUMN textsearchable_index_col tsvector; -postgres=# UPDATE tsearch.pgweb SET textsearchable_index_col = to_tsvector('english', coalesce(title,'') || ' ' || coalesce(body,'')); -``` - -Then, create a GIN index to speed up the search: - -``` -postgres=# CREATE INDEX textsearch_idx_4 ON tsearch.pgweb USING gin(textsearchable_index_col); -``` - -Now you are ready to perform a fast full text search: - -``` -postgres=# SELECT title -FROM tsearch.pgweb -WHERE textsearchable_index_col @@ to_tsquery('north & america') -ORDER BY last_mod_date DESC -LIMIT 10; - - title --------- - Canada - Mexico -(2 rows) -``` - -One advantage of the separate-column approach over an expression index is that it is unnecessary to explicitly specify the text search configuration in queries in order to use the index. As shown in the preceding example, the query can depend on **default\_text\_search\_config**. Another advantage is that searches will be faster, since it will not be necessary to redo the **to\_tsvector** calls to verify index matches. The expression-index approach is simpler to set up, however, and it requires less disk space since the **tsvector** representation is not stored explicitly. - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-databases.md b/content/en/docs/installation/Developerguide/creating-and-managing-databases.md deleted file mode 100644 index e1dd305d8feac40b6a2a494ac7005250aa03b905..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-databases.md +++ /dev/null @@ -1,99 +0,0 @@ -# Creating and Managing Databases - -## Prerequisites - -Only the database system administrator or users granted with database creation permissions can create a database. For details about how to grant database creation permissions to a user, see [Managing Users and Their Permissions](managing-users-and-their-permissions.md). - -## Background - -- openGauss has two default template databases **template0** and **template1** and a default user database **postgres**. The default database compatibility type of **postgres** is O (that is, DBCOMPATIBILITY = A), and the string is treated as NULL under this compatibility type. -- **CREATE DATABASE** creates a database by copying a template database \(**template0** by default\). Do not use a client or any other tools to connect to or to perform operations on the template databases. -- A maximum of 128 databases can be created in openGauss. -- A database system consists of multiple databases. A client can connect to only one database at a time. Users cannot query data across databases. If an openGauss cluster contains multiple databases, set the **-d** parameter to specify the database to connect to. - -## Precautions - -Assume that the database encoding is SQL\_ASCII. \(You can run the **show server\_encoding;** command to query the encoding used for storing data in the current database.\) If the database object name contains multi-byte characters \(such as Chinese\) or if the object name length exceeds the allowed maximum \(63 bytes\), the database truncates the last byte \(not the last character\) of the object name. In this case, half characters may appear. - -To resolve this problem, you need to: - -- Ensure that the name of the data object does not exceed the maximum length. -- Use a proper coded character set, such as UTF-8, as the default database storage code set \(**server\_encoding**\). -- Exclude multi-byte characters from object names. -- Ensure that no more than 128 databases are created. -- If you fail to delete an object by specifying its name after truncation, specify its original name to delete it, or manually delete it from the system catalogs on each node. - -## Procedure - -1. Create a database. - - 1. Run the following command to create a tablespace named **tpcds\_local**: - - ``` - postgres=# CREATE TABLESPACE tpcds_local RELATIVE LOCATION 'tablespace/tablespace_1' ; - CREATE TABLESPACE - ``` - - 2. Run the following command to create a database named **db\_tpcc**: - - ``` - postgres=# CREATE DATABASE db_tpcc WITH TABLESPACE = tpcds_local; - CREATE DATABASE - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- Database names must comply with the general naming convention rules of SQL identifiers. The current role automatically becomes the owner of this new database. - >- If a database system is used to support independent users and projects, store them in different databases. - >- If the projects or users are associated with each other and share resources, store them in one database. However, you can divide them into different schemas. A schema is a logical structure, and the access permission for a schema is controlled by the permission system module. - >- A database name contains a maximum of 63 bytes and the excessive bytes at the end of the name will be truncated by the server. You are advised to specify a database name no longer than 63 bytes when you create a database. - -2. View databases. - - Run the **\\l** meta-command to view the database list of the database system. - - ``` - \l - ``` - - - Run the following command to query the database list in the **pg\_database** system catalog: - - ``` - SELECT datname FROM pg_database; - ``` - -3. Modify the database. - - You can modify database configuration such as the database owner, name, and default settings. - - - Run the following command to set the default search path for the database: - - ``` - postgres=# ALTER DATABASE db_tpcc SET search_path TO pa_catalog,public; - ALTER DATABASE - ``` - - - Run the following command to modify the database tablespaces: - - ``` - postgres=# ALTER DATABASE db_tpcc SET TABLESPACE tpcds; - ALTER DATABASE - ``` - - - Run the following command to rename the database: - - ``` - postgres=# ALTER DATABASE db_tpcc RENAME TO human_tpcds; - ALTER DATABASE - ``` - -4. Delete the database. - - You can run the **[DROP DATABASE](drop-database.md)** command to delete a database. This command deletes the system directory in the database, as well as the database directory on the disk that stores data. Only the database owner or system administrator can delete a database. A database accessed by users cannot be deleted. You need to connect to another database before deleting this database. - - Run the following command to delete the database: - - ``` - postgres=# DROP DATABASE human_tpcds; - DROP DATABASE - ``` - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-indexes.md b/content/en/docs/installation/Developerguide/creating-and-managing-indexes.md deleted file mode 100644 index 051974059fd8ef88e055f3a0ed255c9a46a0cad5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-indexes.md +++ /dev/null @@ -1,245 +0,0 @@ -# Creating and Managing Indexes - -## Background - -Indexes accelerate data access but increase the processing time of insertion, update, and deletion operations. Therefore, before creating an index, consider whether it is necessary and determine the columns where the index will be created. You can determine whether to add an index for a table by analyzing the service processing and data use of applications, as well as columns that are frequently used as search criteria or need to be collated. - -Indexes are created based on columns in database tables. Therefore, you must correctly identify which columns require indexes. You are advised to create indexes for any of the following columns: - -- Columns that are often searched and queried. This speeds up searches. -- Columns that function as primary keys. This enforces the uniqueness of the columns and the data collation structures in organized tables. -- Columns that are often searched by range. The index helps collate data, and therefore the specified ranges are contiguous. -- Columns that often need to be collated. The index helps collate data, reducing the time for a collation query. -- Columns where the **WHERE** clause is executed frequently. This speeds up condition judgment. -- Columns that often appear after the keywords **ORDER BY**, **GROUP BY**, and **DISTINCT**. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >- After an index is created, the system automatically determines when to reference it. If the system determines that indexing is faster than sequenced scanning, the index will be used. - >- After an index is successfully created, it must be synchronized with the associated table to ensure new data can be accurately located, which increases the data operation load. Therefore, delete unnecessary indexes periodically. - >- Partitioned table indexes are classified into LOCAL indexes and GLOBAL indexes. A LOCAL index corresponds to a specific partition, and a GLOBAL index corresponds to the entire partitioned table. - - -## Procedure - -For details about how to create a partitioned table, see [Creating and Managing Partitioned Tables](en-us_topic_0242370193.md). - -- Creating an index - - Create the LOCAL index **tpcds\_web\_returns\_p2\_index1** without specifying the partition name for a partitioned table. - - ``` - postgres=# CREATE INDEX tpcds_web_returns_p2_index1 ON tpcds.web_returns_p2 (ca_address_id) LOCAL; - ``` - - If the following information is displayed, the table has been created: - - ``` - CREATE INDEX - ``` - - - Create the LOCAL index **tpcds\_web\_returns\_p2\_index2** with the partition name specified for a partitioned table. - - ``` - postgres=# CREATE INDEX tpcds_web_returns_p2_index2 ON tpcds.web_returns_p2 (ca_address_sk) LOCAL - ( - PARTITION web_returns_p2_P1_index, - PARTITION web_returns_p2_P2_index TABLESPACE example3, - PARTITION web_returns_p2_P3_index TABLESPACE example4, - PARTITION web_returns_p2_P4_index, - PARTITION web_returns_p2_P5_index, - PARTITION web_returns_p2_P6_index, - PARTITION web_returns_p2_P7_index, - PARTITION web_returns_p2_P8_index - ) TABLESPACE example2; - ``` - - If the following information is displayed, the table has been created: - - ``` - CREATE INDEX - ``` - - - Create the GLOBAL index **tpcds\_web\_returns\_p2\_global\_index** for a partitioned table. - - ``` - CREATE INDEX tpcds_web_returns_p2_global_index ON tpcds.web_returns_p2 (ca_street_number) GLOBAL; - ``` - - -- Modifying the tablespace of an index partition - - Change the tablespace of index partition **web\_returns\_p2\_P2\_index** to **example1**. - - ``` - postgres=# ALTER INDEX tpcds.tpcds_web_returns_p2_index2 MOVE PARTITION web_returns_p2_P2_index TABLESPACE example1; - ``` - - If the following information is displayed, the tablespace of the index partition has been modified: - - ``` - ALTER INDEX - ``` - - - Change the tablespace of index partition **web\_returns\_p2\_P3\_index** to **example2**. - - ``` - postgres=# ALTER INDEX tpcds.tpcds_web_returns_p2_index2 MOVE PARTITION web_returns_p2_P3_index TABLESPACE example2; - ``` - - If the following information is displayed, the tablespace of the index partition has been modified: - - ``` - ALTER INDEX - ``` - - -- Renaming an index partition - - Rename the name of index partition **web\_returns\_p2\_P8\_index** to **web\_returns\_p2\_P8\_index\_new**. - - ``` - postgres=# ALTER INDEX tpcds.tpcds_web_returns_p2_index2 RENAME PARTITION web_returns_p2_P8_index TO web_returns_p2_P8_index_new; - ``` - - If the following information is displayed, the index partition has been renamed: - - ``` - ALTER INDEX - ``` - -- Querying indexes - - Run the following command to query all indexes defined by the system and users: - - ``` - postgres=# SELECT RELNAME FROM PG_CLASS WHERE RELKIND='i' or RELKIND='I'; - ``` - - - Run the following command to query information about a specified index: - - ``` - postgres=# \di+ tpcds.tpcds_web_returns_p2_index2 - ``` - - -- Dropping an index - - ``` - postgres=# DROP INDEX tpcds.tpcds_web_returns_p2_index1; - postgres=# DROP INDEX tpcds.tpcds_web_returns_p2_index2; - ``` - - If the following information is displayed, the tables have been deleted: - - ``` - DROP INDEX - ``` - - -openGauss supports four methods for creating indexes. For details, see [Table 1](#en-us_topic_0237120308_en-us_topic_0059777978_tf6189b97ccf4474e871a7a982b53c2e4). - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- After an index is created, the system automatically determines when to reference it. If the system determines that indexing is faster than sequenced scanning, the index will be used. ->- After an index is successfully created, it must be synchronized with the associated table to ensure new data can be accurately located, which increases the data operation load. Therefore, delete unnecessary indexes periodically. - -**Table 1** Indexing methods - - - - - - - - - - - - - - - - - - - -

Indexing Method

-

Description

-

Unique index

-

An index that requires the uniqueness of an index attribute or an attribute group. If a table declares unique constraints or primary keys, openGauss automatically creates unique indexes (or composite indexes) for columns that form the primary keys or unique constraints. Currently, unique indexes can be created only for B-tree in openGauss.

-

Composite index

-

An index that can be defined for multiple attributes of a table. Currently, composite indexes can be created only for B-tree in openGauss and up to 32 columns can share a composite index.

-

Partial index

-

An index that can be created for subsets of a table. This indexing method contains only tuples that meet condition expressions.

-

Expression index

-

An index that is built on a function or expression calculated based on one or more attributes of a table. An expression index works only when the queried expression is the same as the created expression.

-
- -- Create an ordinary table. - - ``` - postgres=# CREATE TABLE tpcds.customer_address_bak AS TABLE tpcds.customer_address; - INSERT 0 0 - ``` - - -- Create an ordinary index. - - For the **tpcds.customer\_address\_bak** table, you need to perform the following operations frequently: - - ``` - postgres=# SELECT ca_address_sk FROM tpcds.customer_address_bak WHERE ca_address_sk=14888; - ``` - - Generally, the database system needs to scan the **tpcds.customer\_address\_bak** table row by row to find all matched tuples. If the size of the **tpcds.customer\_address\_bak** table is large but only a few \(possibly zero or one\) of the **WHERE** conditions are met, the performance of this sequential scan is low. If the database system uses an index to maintain the **ca\_address\_sk** attribute, the database system only needs to search a few tree layers for the matched tuples. This greatly improves data query performance. Furthermore, indexes can improve the update and deletion operation performance in the database. - - Run the following command to create an index: - - ``` - postgres=# CREATE INDEX index_wr_returned_date_sk ON tpcds.customer_address_bak (ca_address_sk); - CREATE INDEX - ``` - -- Create a multi-column index. - - Assume you need to frequently query records with **ca\_address\_sk** being **5050** and **ca\_street\_number** smaller than **1000** in the **tpcds.customer\_address\_bak** table. Run the following commands: - - ``` - postgres=# SELECT ca_address_sk,ca_address_id FROM tpcds.customer_address_bak WHERE ca_address_sk = 5050 AND ca_street_number < 1000; - ``` - - Run the following command to define a composite index on **ca\_address\_sk** and **ca\_street\_number** columns: - - ``` - postgres=# CREATE INDEX more_column_index ON tpcds.customer_address_bak(ca_address_sk ,ca_street_number ); - CREATE INDEX - ``` - -- Create a partial index. - - If you only want to find records whose **ca\_address\_sk** is **5050**, you can create a partial index to facilitate your query. - - ``` - postgres=# CREATE INDEX part_index ON tpcds.customer_address_bak(ca_address_sk) WHERE ca_address_sk = 5050; - CREATE INDEX - ``` - -- Create an expression index. - - Assume that you need to frequently query records with **ca\_street\_number** smaller than **1000**, run the following command: - - ``` - postgres=# SELECT * FROM tpcds.customer_address_bak WHERE trunc(ca_street_number) < 1000; - ``` - - The following expression index can be created for this query task: - - ``` - postgres=# CREATE INDEX para_index ON tpcds.customer_address_bak (trunc(ca_street_number)); - CREATE INDEX - ``` - -- Delete the **tpcds.customer\_address\_bak** table. - - ``` - postgres=# DROP TABLE tpcds.customer_address_bak; - DROP TABLE - ``` - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-partitioned-tables.md b/content/en/docs/installation/Developerguide/creating-and-managing-partitioned-tables.md deleted file mode 100644 index d7fb9752af4d905c85ca5f3aec1817ba0c99fd0b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-partitioned-tables.md +++ /dev/null @@ -1,200 +0,0 @@ -# Creating and Managing Partitioned Tables - -## Background - -openGauss supports range partitioned tables. - -In a range partitioned table, data within a certain range is mapped to each partition. The range is determined by the partition key specified when the partitioned table is created. This partitioning mode is most commonly used. The partition key is usually a date. For example, sales data is partitioned by month. - -A partitioned table has the following advantages over an ordinary table: - -- High query performance: You can specify partitions when querying partitioned tables, improving query efficiency. -- High availability: If a certain partition in a partitioned table is faulty, data in the other partitions is still available. -- Easy maintenance: To fix a partitioned table having a faulty partition, you only need to fix the partition. -- Balanced I/O: Partitions can be mapped to different disks to balance I/O and improve the overall system performance. - -To convert an ordinary table to a partitioned table, you need to create a partitioned table and import data to it from the ordinary table. When you design tables, plan whether to use partitioned tables based on service requirements. - -## Procedure - -Perform the following operations on range partitioned tables. - -- Creating a tablespace - - ``` - postgres=# CREATE TABLESPACE example1 RELATIVE LOCATION 'tablespace1/tablespace_1'; - postgres=# CREATE TABLESPACE example2 RELATIVE LOCATION 'tablespace2/tablespace_2'; - postgres=# CREATE TABLESPACE example3 RELATIVE LOCATION 'tablespace3/tablespace_3'; - postgres=# CREATE TABLESPACE example4 RELATIVE LOCATION 'tablespace4/tablespace_4'; - ``` - - If the following information is displayed, the tablespace has been created: - - ``` - CREATE TABLESPACE - ``` - -- Creating a partitioned table - - ``` - postgres=# CREATE TABLE tpcds.customer_address - ( - ca_address_sk integer NOT NULL , - ca_address_id character(16) NOT NULL , - ca_street_number character(10) , - ca_street_name character varying(60) , - ca_street_type character(15) , - ca_suite_number character(10) , - ca_city character varying(60) , - ca_county character varying(30) , - ca_state character(2) , - ca_zip character(10) , - ca_country character varying(20) , - ca_gmt_offset numeric(5,2) , - ca_location_type character(20) - ) - TABLESPACE example1 - - PARTITION BY RANGE (ca_address_sk) - ( - PARTITION P1 VALUES LESS THAN(5000), - PARTITION P2 VALUES LESS THAN(10000), - PARTITION P3 VALUES LESS THAN(15000), - PARTITION P4 VALUES LESS THAN(20000), - PARTITION P5 VALUES LESS THAN(25000), - PARTITION P6 VALUES LESS THAN(30000), - PARTITION P7 VALUES LESS THAN(40000), - PARTITION P8 VALUES LESS THAN(MAXVALUE) TABLESPACE example2 - ) - ENABLE ROW MOVEMENT; - ``` - - If the following information is displayed, the partitioned table has been created: - - ``` - CREATE TABLE - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >You are advised to create a maximum of 1000 column-store partitioned tables. - -- Inserting data - - Insert data from the **tpcds.customer\_address** table to the **tpcds.web\_returns\_p2** table. - - Suppose a backup table **tpcds.web\_returns\_p2** of the **tpcds.customer\_address** table has been created in the database. You can run the following command to insert the data of the **tpcds.customer\_address** table into the backup table **tpcds.web\_returns\_p2**: - - ``` - postgres=# CREATE TABLE tpcds.web_returns_p2 - ( - ca_address_sk integer NOT NULL , - ca_address_id character(16) NOT NULL , - ca_street_number character(10) , - ca_street_name character varying(60) , - ca_street_type character(15) , - ca_suite_number character(10) , - ca_city character varying(60) , - ca_county character varying(30) , - ca_state character(2) , - ca_zip character(10) , - ca_country character varying(20) , - ca_gmt_offset numeric(5,2) , - ca_location_type character(20) - ) - TABLESPACE example1 - PARTITION BY RANGE (ca_address_sk) - ( - PARTITION P1 VALUES LESS THAN(5000), - PARTITION P2 VALUES LESS THAN(10000), - PARTITION P3 VALUES LESS THAN(15000), - PARTITION P4 VALUES LESS THAN(20000), - PARTITION P5 VALUES LESS THAN(25000), - PARTITION P6 VALUES LESS THAN(30000), - PARTITION P7 VALUES LESS THAN(40000), - PARTITION P8 VALUES LESS THAN(MAXVALUE) TABLESPACE example2 - ) - ENABLE ROW MOVEMENT; - CREATE TABLE - postgres=# INSERT INTO tpcds.web_returns_p2 SELECT * FROM tpcds.customer_address; - INSERT 0 0 - ``` - -- Modifying the row movement attributes of the partitioned table - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 DISABLE ROW MOVEMENT; - ALTER TABLE - ``` - -- Deleting a partition - - Run the following command to delete partition **P8**: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 DROP PARTITION P8; - ALTER TABLE - ``` - -- Adding a partition - - Run the following command to add partition **P8** and set its range to \[40000, MAXVALUE\]: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 ADD PARTITION P8 VALUES LESS THAN (MAXVALUE); - ALTER TABLE - ``` - -- Renaming a partition - - Run the following command to rename partition **P8** to **P\_9**: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 RENAME PARTITION P8 TO P_9; - ALTER TABLE - ``` - - - Run the following command to rename partition **P\_9** to **P8**: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 RENAME PARTITION FOR (40000) TO P8; - ALTER TABLE - ``` - - -- Modifying the tablespace of a partition - - Run the following command to change the tablespace of partition **P6** to **example3**: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 MOVE PARTITION P6 TABLESPACE example3; - ALTER TABLE - ``` - - - Run the following command to change the tablespace of partition **P4** to **example4**: - - ``` - postgres=# ALTER TABLE tpcds.web_returns_p2 MOVE PARTITION P4 TABLESPACE example4; - ALTER TABLE - ``` - - -- Querying a partition - - Run the following command to query partition **P6**: - - ``` - postgres=# SELECT * FROM tpcds.web_returns_p2 PARTITION (P6); - postgres=# SELECT * FROM tpcds.web_returns_p2 PARTITION FOR (35888); - ``` - -- Deleting a partitioned table and its tablespaces - - ``` - postgres=# DROP TABLE tpcds.web_returns_p2; - DROP TABLE - postgres=# DROP TABLESPACE example1; - postgres=# DROP TABLESPACE example2; - postgres=# DROP TABLESPACE example3; - postgres=# DROP TABLESPACE example4; - DROP TABLESPACE - ``` - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-schemas.md b/content/en/docs/installation/Developerguide/creating-and-managing-schemas.md deleted file mode 100644 index 714549b2cc5290c126cd867d52e12b21fa48356c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-schemas.md +++ /dev/null @@ -1,155 +0,0 @@ -# Creating and Managing Schemas - -## Background - -Schemas function as models. Schema management allows multiple users to use the same database without mutual impacts, to organize database objects as manageable logical groups, and to add third-party applications to the same schema without causing conflicts. Schema management involves creating a schema, using a schema, deleting a schema, setting a search path for a schema, and setting schema permissions. - -## Precautions - -- openGauss contains one or more named databases. Users and user groups are shared within the openGauss, but their data is not shared. Any user who has connected to a server can access only the database specified in the connection request. -- A database can have one or more schemas, and a schema can contain tables and other data objects, such as data types, functions, and operators. One object name can be used in different schemas. For example, both **schema1** and **schema2** can have a table named **mytable**. -- Different from databases, schemas are not isolated. You can access the objects in a schema of the connected database if you have schema permissions. To manage schema permissions, you need to have knowledge about database permissions. -- A schema named with the **PG\_** prefix cannot be created because this type of schema is reserved for the database system. -- Each time a new user is created, the system creates a schema with the same name for the new user in the current database. In other databases, such a schema needs to be manually created. -- To reference a table that is not modified with a schema name, the system uses **search\_path** to find the schema that the table belongs to. **pg\_temp** and **pg\_catalog** are always the first two schemas to be searched no matter whether or how they are specified in **search\_path**. **search\_path** is a schema name list, and the first table detected in it is the target table. If no target table is found, an error will be reported. \(If a table exists but the schema it belongs to is not listed in **search\_path**, the search fails as well.\) The first schema in **search\_path** is called "current schema". This schema is the first one to be searched. If no schema name is declared, newly created database objects are saved in this schema by default. -- Each database has a **pg\_catalog** schema, which contains system catalogs and all embedded data types, functions, and operators. **pg\_catalog** is a part of the search path and has the second highest search priority. It is searched after the schema of temporary tables and before other schemas specified in **search\_path**. This search order ensures that database built-in objects can be found. To use a custom object that has the same name as a built-in object, you can specify the schema of the custom object. - -## Procedure - -- Managing users and their permissions - - Run the following command to create a schema: - - ``` - CREATE SCHEMA myschema; - ``` - - If the following information is displayed, the schema named **myschema** is successfully created: - - ``` - CREATE SCHEMA - ``` - - To create or access an object in the schema, the object name in the command should consist of the schema name and the object name, which are separated by a dot \(.\), for example, **myschema.table**. - - - Run the following command to create a schema and specify the owner: - - ``` - CREATE SCHEMA myschema AUTHORIZATION omm; - ``` - - If the following information is displayed, the **myschema** schema that belongs to **omm** is created successfully: - - ``` - CREATE SCHEMA - ``` - - -- Use a schema. - - If you want to create or access an object in a specified schema, the object name must contain the schema name. To be specific, the name consists of a schema name and an object name, which are separated by a dot \(.\). - - - Run the following command to create the **mytable** table in **myschema**: - - ``` - postgres=# CREATE TABLE myschema.mytable(id int, name varchar(20)); - CREATE TABLE - ``` - - To specify the location of an object, the object name must contain the schema name. - - - Run the following command to query all data of the **mytable** table in **myschema**: - - ``` - postgres=# SELECT * FROM myschema.mytable; - id | name - ----+------ - (0 rows) - ``` - - -- View **search\_path** of a schema. - - You can set **search\_path** to specify the sequence of schemas in which objects are searched. The first schema listed in **search\_path** will become the default schema. If no schema is specified during object creation, the object will be created in the default schema. - - - Run the following command to view **search\_path**: - - ``` - postgres=# SHOW SEARCH_PATH; - search_path - ---------------- - "$user",public - (1 row) - ``` - - - Run the following command to set **search\_path** to **myschema** and **public** \(**myschema** will be searched first\): - - ``` - postgres=# SET SEARCH_PATH TO myschema, public; - SET - ``` - - -- Set permissions for a schema. - - By default, a user can only access database objects in their own schema. Only after a user is granted with the usage permission for a schema by the schema owner, the user can access the objects in the schema. - - By granting the **CREATE** permission for a schema to a user, the user can create objects in this schema. By default, all roles have the **USAGE** permission in the **public** schema, but common users do not have the **CREATE** permission in the **public** schema. It is insecure for a common user to connect to a specified database and create objects in its **public** schema. If the common user has the **CREATE** permission on the **public** schema, it is advised to: - - - Run the following command to revoke **PUBLIC**'s permission to create objects in the **public** schema. **public** indicates the schema and **PUBLIC** indicates all roles. - - ``` - postgres=# REVOKE CREATE ON SCHEMA public FROM PUBLIC; - REVOKE - ``` - - - Run the following command to view the current schema: - - ``` - postgres=# SELECT current_schema(); - current_schema - ---------------- - myschema - (1 row) - ``` - - - Run the following commands to create user **jack** and grant the **usage** permission for **myschema** to the user: - - ``` - postgres=# CREATE USER jack IDENTIFIED BY 'Bigdata@123'; - CREATE ROLE - postgres=# GRANT USAGE ON schema myschema TO jack; - GRANT - ``` - - - Run the following command to revoke the usage permission for **myschema** from **jack**: - - ``` - postgres=# REVOKE USAGE ON schema myschema FROM jack; - REVOKE - ``` - - -- Delete a schema. - - If a schema is empty, that is, it contains no database objects, you can execute the **DROP SCHEMA** command to delete it. For example, run the following command to delete an empty schema named **nullschema**: - - ``` - postgres=# DROP SCHEMA IF EXISTS nullschema; - DROP SCHEMA - ``` - - - To delete a schema that is not null, use the keyword **CASCADE** to delete it and all its objects. For example, run the following command to delete **myschema** and all its objects in it: - - ``` - postgres=# DROP SCHEMA myschema CASCADE; - DROP SCHEMA - ``` - - - Run the following command to delete user **jack**: - - ``` - postgres=# DROP USER jack; - DROP ROLE - ``` - - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-sequences.md b/content/en/docs/installation/Developerguide/creating-and-managing-sequences.md deleted file mode 100644 index 458dc2f59f1050aa025dbd3d8401e4a70d07cb16..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-sequences.md +++ /dev/null @@ -1,78 +0,0 @@ -# Creating and Managing Sequences - -## Background - -A sequence is a database object that generates unique integers. Sequence numbers are generated according to a certain rule. Sequences are unique because they increase automatically. This is why they are often used as primary keys. - -You can create a sequence for a column in either of the following methods: - -- Set the data type of a column to [sequence integer](numeric-data-types.md#en-us_topic_0237121927_en-us_topic_0059778296_t5262f987c61c4a8caff8c8037e912874). A sequence will be automatically created by the database for this column. -- Run the **[CREATE SEQUENCE](create-sequence.md)** statement to create a sequence. Set the initial value of the **nextval**\('_sequence\_name_'\) function to the default value of a column. - -## Procedure - -Method 1: Set the data type of a column to a sequence integer. For example: - -``` -CREATE TABLE T1 -( - id serial, - name text -); -``` - -If the following information is displayed, the table has been created: - -``` -CREATE TABLE -``` - -Method 2: Create a sequence and set the initial value of the **nextval**\('_sequence\_name_'\) function to the default value of a column. - -1. Create a sequence. - - ``` - CREATE SEQUENCE seq1 cache 100; - ``` - - If the following information is displayed, the sequence has been created: - - ``` - CREATE SEQUENCE - ``` - -2. Set the initial value of the **nextval**\('_sequence\_name_'\) function to the default value of a column. - - ``` - CREATE TABLE T2 - ( - id int not null default nextval('seq1'), - name text - ); - ``` - - If the following information is displayed, the default value has been specified: - - ``` - CREATE TABLE - ``` - -3. Associate the sequence with a column. - - Associates a sequence with a specified column included in a table. In this way, the sequence will be deleted when you delete its associated column or the table where the column belongs to. - - ``` - ALTER SEQUENCE seq1 OWNED BY T2.id; - ``` - - If the following information is displayed, the column has been specified: - - ``` - ALTER SEQUENCE - ``` - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->The preceding methods are similar, except that the second method specifies cache for the sequence. A sequence having cache defined has inconsecutive values \(such as 1, 4, and 5\) and cannot maintain the order of its values. After the dependent column of a sequence has been specified, once the sequence is deleted, the sequence of the dependent will be deleted. A sequence shared by multiple columns is not forbidden in a database, but you are not advised to do that. ->In the current version, you can specify the auto-increment column or set the default value of a column to **nextval\('seqname'\)** when defining a table. You cannot add an auto-increment column or a column whose default value is **nextval\('seqname'\)** to an existing table. - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-tables.md b/content/en/docs/installation/Developerguide/creating-and-managing-tables.md deleted file mode 100644 index 2658b9d5ef11fff9d8cb2cc5f60d6d84fdb69b8f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-tables.md +++ /dev/null @@ -1,13 +0,0 @@ -# Creating and Managing Tables - -- **[Creating Tables](creating-tables.md)** - -- **[Inserting Data to Tables](inserting-data-to-tables.md)** - -- **[Updating Data in a Table](updating-data-in-a-table.md)** - -- **[Viewing Data](viewing-data.md)** - -- **[Deleting Data from a Table](deleting-data-from-a-table.md)** - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-tablespaces.md b/content/en/docs/installation/Developerguide/creating-and-managing-tablespaces.md deleted file mode 100644 index db132dda9012d652868c4ad968b9f78357269651..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-tablespaces.md +++ /dev/null @@ -1,175 +0,0 @@ -# Creating and Managing Tablespaces - -## Background - -The administrator can use tablespaces to control the layout of disks where a database is installed. This has the following advantages: - -- If the initial disk partition or volume allocated to the database is full and the space cannot be logically increased, you can create and use tablespaces in other partitions until the space is reconfigured. - -- Tablespaces allow the administrator to distribute data based on the schema of database objects, improving system performance. - - A frequently used index can be placed in a disk having stable performance and high computing speed, such as a solid device. - - A table that stores archived data and is rarely used or has low performance requirements can be placed in a disk with a slow computing speed. - - -- The administrator can use tablespaces to set the maximum available disk space. In this way, when a partition is shared with other data, tablespaces will not occupy excessive space in the partition. -- You can use tablespaces to control the disk space occupied by data in a database. If the usage of a disk where a tablespace resides reaches 90%, the database switches to the read-only mode. It switches back to read/write mode when the disk usage becomes less than 90%. - - You are advised to use the background monitoring program or Database Manager to monitor the disk space usage when using the database to prevent the database from switching to the read-only mode. - -- Each tablespace corresponds to a file system directory. Assume that _Database node data directory_**/pg\_location/mount1/path1** is an empty directory for which users have read and write permissions. - - If the tablespace quota management is used, the performance may deteriorate by about 30%. **MAXSIZE** specifies the maximum quota for each database node. The deviation must be within 500 MB. Determine whether to set a tablespace to its maximum size as required. - - -## Procedure - -- Create a tablespace. - 1. Run the following command to create user **jack**: - - ``` - CREATE USER jack IDENTIFIED BY 'Bigdata@123'; - ``` - - If the following information is displayed, the user has been created: - - ``` - CREATE ROLE - ``` - - 2. Run the following command to create a tablespace: - - ``` - CREATE TABLESPACE fastspace RELATIVE LOCATION 'tablespace/tablespace_1'; - ``` - - If the following information is displayed, the tablespace has been created: - - ``` - CREATE TABLESPACE - ``` - - **fastspace** is the new tablespace, and _Database node data directory_**/pg\_location/tablespace/tablespace\_1** is an empty directory for which users have read and write permissions. - - 3. A database system administrator can run the following command to grant the permission of accessing the **fastspace** tablespace to user **jack**: - - ``` - GRANT CREATE ON TABLESPACE fastspace TO jack; - ``` - - If the following information is displayed, the permission has been assigned: - - ``` - GRANT - ``` - - - -- Create an object in a tablespace. - - If you have the **CREATE** permission for the tablespace, you can create database objects in the tablespace, such as tables and indexes. - - Take creating a table as an example: - - - Method 1: Run the following command to create a table in a specified tablespace: - - ``` - CREATE TABLE foo(i int) TABLESPACE fastspace; - ``` - - If the following information is displayed, the table has been created: - - ``` - CREATE TABLE - ``` - - - Method 2: Use **set default\_tablespace** to set the default tablespace and then create a table: - - ``` - postgres=# SET default_tablespace = 'fastspace'; - SET - postgres=# CREATE TABLE foo2(i int); - CREATE TABLE - ``` - - In this example, **fastspace** is the default tablespace, and **foo2** is the created table. - - -- Use one of the following methods to query a tablespace: - - Method 1: Check the **pg\_tablespace** system catalog. Run the following command to view all the tablespaces defined by the system and users: - - ``` - SELECT spcname FROM pg_tablespace; - ``` - - - Method 2: Run the following meta-command of the **gsql** program to query the tablespaces: - - ``` - \db - ``` - - -- Query the tablespace usage. - 1. Query the current usage of the tablespace. - - ``` - SELECT PG_TABLESPACE_SIZE('example'); - ``` - - Information similar to the following is displayed: - - ``` - pg_tablespace_size - -------------------- - 2146304 - (1 row) - ``` - - **2146304** is the size of the tablespace, and its unit is byte. - - 2. Calculate the tablespace usage. - - Tablespace usage rate = **PG\_TABLESPACE\_SIZE**/Size of the disk where the tablespace resides - - -- Modify a tablespace. - - Run the following command to rename tablespace **fastspace** to **fspace**: - - ``` - postgres=# ALTER TABLESPACE fastspace RENAME TO fspace; - ALTER TABLESPACE - ``` - -- Delete a tablespace and related data. - - Run the following command to delete user **jack**: - - ``` - postgres=# DROP USER jack CASCADE; - DROP ROLE - ``` - - - Run the following commands to delete tables **foo** and **foo2**: - - ``` - postgres=# DROP TABLE foo; - postgres=# DROP TABLE foo2; - ``` - - If the following information is displayed, the tables have been deleted: - - ``` - DROP TABLE - ``` - - - Run the following command to delete tablespace **fspace**: - - ``` - postgres=# DROP TABLESPACE fspace; - DROP TABLESPACE - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >Only the tablespace owner or system administrator can delete a tablespace. - - - diff --git a/content/en/docs/installation/Developerguide/creating-and-managing-views.md b/content/en/docs/installation/Developerguide/creating-and-managing-views.md deleted file mode 100644 index 6d84cb7f0d1181c20778162f2641bf336aeb0911..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-and-managing-views.md +++ /dev/null @@ -1,55 +0,0 @@ -# Creating and Managing Views - -## Background - -If some columns in one or more tables in a database are frequently searched for, an administrator can define a view for these columns, and then users can directly access these columns in the view without entering search criteria. - -A view is different from a base table. It is only a virtual object rather than a physical one. Only view definition is stored in the database and view data is not. The data is stored in a base table. If data in the base table changes, the data in the view changes accordingly. In this sense, a view is like a window through which users can know their interested data and data changes in the database. A view is triggered every time it is referenced. - -## Managing Views - -- Creating a view - - Run the following command to create **MyView**: - - ``` - postgres=# CREATE OR REPLACE VIEW MyView AS SELECT * FROM tpcds.web_returns WHERE trunc(wr_refunded_cash) > 10000; - CREATE VIEW - ``` - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >The **OR REPLACE** parameter in this command is optional. It indicates that if the view exists, the new view will replace the existing view. - -- Querying a view - - Run the following command to query **MyView**: - - ``` - SELECT * FROM MyView; - ``` - -- Viewing details about a specified view - - Run the following command to view details about the **dba\_users** view: - - ``` - postgres=# \d+ dba_users - View "PG_CATALOG.DBA_USERS" - Column | Type | Modifiers | Storage | Description - ----------+-----------------------+-----------+----------+------------- - USERNAME | CHARACTER VARYING(64) | | extended | - View definition: - SELECT PG_AUTHID.ROLNAME::CHARACTER VARYING(64) AS USERNAME - FROM PG_AUTHID; - ``` - -- Deleting a view - - Run the following command to delete **MyView**: - - ``` - postgres=# DROP VIEW MyView; - DROP VIEW - ``` - - diff --git a/content/en/docs/installation/Developerguide/creating-dropping-an-mot-table.md b/content/en/docs/installation/Developerguide/creating-dropping-an-mot-table.md deleted file mode 100644 index aa8b35a730e46bfef646efcea4f48d3cd0fa0180..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-dropping-an-mot-table.md +++ /dev/null @@ -1,23 +0,0 @@ -# Creating/Dropping an MOT Table - -Creating a Memory Optimized Table \(MOT\) is very simple. Only the create and drop table statements in MOT differ from the statements for disk-based tables in openGauss. The syntax of **all other** commands for SELECT, DML and DDL are the same for MOT tables as for openGauss disk-based tables. - -- To create an MOT table – - - ``` - create FOREIGN table test(x int) [server mot_server]; - ``` - -- Always use the FOREIGN keyword to refer to MOT tables. -- The \[server mot\_server\] part is optional when creating an MOT table because MOT is an integrated engine, not a separate server. -- The above is an extremely simple example creating a table named **test** with a single integer column named **x**. In the next section \(**Creating an Index**\) a more realistic example is provided. -- MOT tables cannot be created if incremental checkpoint is enabled in postgresql.conf. So please set enable_incremental_checkpoint to off before creating the MOT. -- To drop an MOT table named test – - - ``` - drop FOREIGN table test; - ``` - - -For a description of the limitations of supported features for MOT tables, such as data types, see the [MOT SQL Coverage and Limitations](mot-sql-coverage-and-limitations.md) section. - diff --git a/content/en/docs/installation/Developerguide/creating-tables.md b/content/en/docs/installation/Developerguide/creating-tables.md deleted file mode 100644 index eb6b2fe9b804b0283d0ee4d727754584efbcd193..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/creating-tables.md +++ /dev/null @@ -1,28 +0,0 @@ -# Creating Tables - -## Background - -A table is created in a database and can be saved in different databases. Tables under different schemas in a database can have the same name. Before creating a table, refer to [Planning a Storage Model](planning-a-storage-model.md). - -## Procedure - -Run the following statement to create a table: - -``` -CREATE TABLE customer_t1 -( - c_customer_sk integer, - c_customer_id char(5), - c_first_name char(6), - c_last_name char(8) -); -``` - -If the following information is displayed, the table has been created: - -``` - CREATE TABLE -``` - -**c\_customer\_sk**, **c\_customer\_id**, **c\_first\_name**, and **c\_last\_name** are the column names of the table. **integer**, **char\(5\)**, **char\(6\)**, and **char\(8\)** are column name types. - diff --git a/content/en/docs/installation/Developerguide/cursor-loop.md b/content/en/docs/installation/Developerguide/cursor-loop.md deleted file mode 100644 index 34643423e6ad02de6d63fb709e6932647aad6178..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cursor-loop.md +++ /dev/null @@ -1,18 +0,0 @@ -# Cursor Loop - -Use of cursors in WHILE and LOOP statements is called a cursor loop. Generally, OPEN, FETCH, and CLOSE statements are involved in this kind of loop. The following describes a loop that simplifies a cursor loop without the need for these operations. This kind of loop is applicable to a static cursor loop, without executing four steps about a static cursor. - -## Syntax - -[Figure 1](#en-us_topic_0237122246_en-us_topic_0059778239_fd1982700d7d8496a9358b5d029a0123b) shows the syntax diagram of the **FOR AS** loop. - -**Figure 1** FOR\_AS\_loop::= -![](figures/for_as_loop.png "for_as_loop") - -## Precautions - -- The **UPDATE** operation for the queried table is not allowed in the loop statement. -- The variable loop\_name is automatically defined and is valid only in this loop. Its type is the same as that in the select\_statement query result. The value of **loop\_name** is the query result of **select\_statement**. - -- The **%FOUND**, **%NOTFOUND**, and **%ROWCOUNT** attributes access the same internal variable in openGauss. Transactions and the anonymous block do not support multiple cursor accesses at the same time. - diff --git a/content/en/docs/installation/Developerguide/cursor-operations.md b/content/en/docs/installation/Developerguide/cursor-operations.md deleted file mode 100644 index 4259e025c8097f4ced2cc090925975bea11960e6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cursor-operations.md +++ /dev/null @@ -1,8 +0,0 @@ -# Cursor Operations - -openGauss provides cursors as a data buffer for users to store execution results of SQL statements. Each cursor region has a name. Users can use SQL statements to obtain records one by one from cursors and grant the records to master variables, then being processed further by host languages. - -Cursor operations include cursor definition, open, fetch, and close operations. - -For the complete example of cursor operations, see [Explicit Cursor](explicit-cursor.md). - diff --git a/content/en/docs/installation/Developerguide/cursor.md b/content/en/docs/installation/Developerguide/cursor.md deleted file mode 100644 index edc590c3069ef4e158523d2e822a8b66d8d2036a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cursor.md +++ /dev/null @@ -1,65 +0,0 @@ -# CURSOR - -## Function - -**CURSOR** defines a cursor to retrieve a small number of rows at a time out of a larger query. - -To process SQL statements, the stored procedure process assigns a memory segment to store context association. Cursors are handles or pointers pointing to context regions. With cursors, stored procedures can control alterations in context regions. - -## Precautions - -- **CURSOR** is used only in transaction blocks. -- Generally, **CURSOR** and **SELECT** both have text returns. Since data is stored in binary format in the system, the system needs to convert the data from the binary format to the text format. If data is returned in text format, client applications need to convert the data back to the binary format for processing. **FETCH** implements conversion between binary data and text data. -- Binary cursors should be used carefully. Text usually occupies larger space than binary data. A binary cursor returns internal binary data, which is easier to operate. A text cursor returns text, which is easier to retrieve and therefore reduces workload on the client. As an example, if a query returns a value of one from an integer column, you would get a string of 1 with a default cursor, whereas with a binary cursor you would get a 4-byte field containing the internal representation of the value \(in big-endian byte order\). - -## Syntax - -``` -CURSOR cursor_name - [ BINARY ] [ NO SCROLL ] [ { WITH | WITHOUT } HOLD ] - FOR query ; -``` - -## Parameter Description - -- **cursor\_name** - - Specifies the name of the cursor to be created. - - Value range: a string. It must comply with the naming convention. - -- **BINARY** - - Causes the cursor to return data in binary rather than in text format. - -- **NO SCROLL** - - Specifies how the cursor retrieves rows. - - - **NO SCROLL**: specifies that the cursor cannot be used to retrieve rows in a nonsequential fashion. - - Unspecified: Based on the query's execution plan, the system automatically determines whether the cursor can be used to retrieve rows in a nonsequential fashion. - -- **WITH HOLD | WITHOUT HOLD** - - Specifies whether the cursor can continue to be used after the transaction that created it successfully commits. - - - **WITH HOLD**: The cursor can continue to be used after the transaction that created it successfully commits. - - **WITHOUT HOLD**: The cursor cannot be used outside of the transaction that created it. - - If neither **WITH HOLD** nor **WITHOUT HOLD** is specified, the default is **WITHOUT HOLD**. - - Cross-node transactions \(for example, DDL-contained transactions created in openGauss with multiple DBnode\) do not support **WITH HOLD**. - -- **query** - - Uses a **SELECT** or **VALUES** clause to specify the rows to be returned by the cursor. - - Value range: **SELECT** or **VALUES** clause - - -## Examples - -See [Examples](fetch.md#en-us_topic_0237122165_en-us_topic_0059778422_s1ee72832a27547e4949061a010e24578) in **FETCH**. - -## Helpful Links - -[FETCH](fetch.md) - diff --git a/content/en/docs/installation/Developerguide/cursors.md b/content/en/docs/installation/Developerguide/cursors.md deleted file mode 100644 index 7e1e8238f53d533d6666a9d86254c147f6dd4739..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/cursors.md +++ /dev/null @@ -1,11 +0,0 @@ -# Cursors - -- **[Overview](overview-23.md)** - -- **[Explicit Cursor](explicit-cursor.md)** - -- **[Implicit Cursor](implicit-cursor.md)** - -- **[Cursor Loop](cursor-loop.md)** - - diff --git a/content/en/docs/installation/Developerguide/data-export-by-a-user-without-required-permissions.md b/content/en/docs/installation/Developerguide/data-export-by-a-user-without-required-permissions.md deleted file mode 100644 index b179f7309d66557299618d6e3cfd8cd2df123b00..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-export-by-a-user-without-required-permissions.md +++ /dev/null @@ -1,125 +0,0 @@ -# Data Export By a User Without Required Permissions - -**gs\_dump** and **gs\_dumpall** use **-U** to specify the user that performs the export. If the specified user does not have the required permissions, data cannot be exported. In this case, you can set **--role** in the **gs\_dump** or **gs\_dumpall** command to the role that has the permissions. Then, **gs\_dump** or **gs\_dumpall** uses the specified role to export data. - -## Procedure - -1. Log in as the OS user **omm** to the primary node of the database. -2. Use **gs\_dump** to export data of the **human\_resource** database. - - User **jack** does not have the permissions to export data of the **human\_resource** database and the role **role1** has this permission. To export data of the **human\_resource** database, you can set **--role** to **role1** in the **gs\_dump** command. The exported files are in .tar format. - - ``` - gs_dump -U jack -W Bigdata@234 -f /home/omm/backup/MPPDB_backup.tar -p 8000 human_resource --role role1 --rolepassword abc@1234 -F t - ``` - - **Table 1** Common parameters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Parameter

-

Description

-

Example Value

-

-U

-

Username for database connection.

-

-U jack

-

-W

-

User password for database connection.

-
  • This parameter is not required for database administrators if the trust policy is used for authentication.
  • If you connect to the database without specifying this parameter and you are not a database administrator, you will be prompted to enter the password.
-

-W Bigdata@123

-

-f

-

Folder to store exported files. If this parameter is not specified, the exported files are stored in the standard output.

-

-f /home/omm/backup/MPPDB_backup.tar

-

-p

-

TCP port or local Unix-domain socket file extension on which the server is listening for connections.

-

-p 8000

-

dbname

-

Name of the database to export.

-

human_resource

-

--role

-

Role name for the export operation. After this parameter is set, the SET ROLE command will be issued after gs_dump or gs_dumpall connects to the database. It is useful when the user specified by -U does not have the permissions required by gs_dump or gs_dumpall. This parameter allows you to switch to a role with the required permissions.

-

-r role1

-

--rolepassword

-

Role password.

-

--rolepassword abc@1234

-

-F

-

Select the format of file to export. The values of -F are as follows:

-
  • p: plaintext
  • c: custom
  • d: directory
  • t: .tar
-

-F t

-
- - For details about other parameters, see "Server Tools \> gs\_dump" or "Server Tools \> gs\_dumpall" in the _Tool Reference_. - - -## Examples - -Example 1: User **jack** does not have the permissions required to export data of the **human\_resource** database using **gs\_dump** and the role **role1** has the permissions. To export data of the **human\_resource** database, you can set **--role** to **role1** in the **gs\_dump** command. The exported files are in .tar format. - -``` -human_resource=# CREATE USER jack IDENTIFIED BY "1234@abc"; -CREATE ROLE - -gs_dump -U jack -W 1234@abc -f /home/omm/backup/MPPDB_backup11.tar -p 8000 human_resource --role role1 --rolepassword abc@1234 -F t -gs_dump[port='8000'][human_resource][2017-07-21 16:21:10]: dump database human_resource successfully -gs_dump[port='8000'][human_resource][2017-07-21 16:21:10]: total time: 4239 ms -``` - -Example 2: User **jack** does not have the permissions required to export the **public** schema using **gs\_dump** and the role **role1** has the permissions. To export the **public** schema, you can set **--role** to **role1** in the **gs\_dump** command. The exported files are in .tar format. - -``` -human_resource=# CREATE USER jack IDENTIFIED BY "1234@abc"; -CREATE ROLE - -gs_dump -U jack -W 1234@abc -f /home/omm/backup/MPPDB_backup12.tar -p 8000 human_resource -n public --role role1 --rolepassword abc@1234 -F t -gs_dump[port='8000'][human_resource][2017-07-21 16:21:10]: dump database human_resource successfully -gs_dump[port='8000'][human_resource][2017-07-21 16:21:10]: total time: 3278 ms -``` - -Example 3: User **jack** does not have the permissions required to export all databases in a cluster using **gs\_dumpall** and the role **role1** \(cluster administrator\) has the permissions. To export all the databases, you can set **--role** to **role1** in the **gs\_dumpall** command. The exported files are in text format. - -``` -human_resource=# CREATE USER jack IDENTIFIED BY "1234@abc"; -CREATE ROLE - -gs_dumpall -U jack -W 1234@abc -f /home/omm/backup/MPPDB_backup.sql -p 8000 --role role1 --rolepassword abc@1234 -gs_dumpall[port='8000'][human_resource][2018-11-14 17:26:18]: dumpall operation successful -gs_dumpall[port='8000'][human_resource][2018-11-14 17:26:18]: total time: 6437 ms -``` - diff --git a/content/en/docs/installation/Developerguide/data-import-using-copy-from-stdin.md b/content/en/docs/installation/Developerguide/data-import-using-copy-from-stdin.md deleted file mode 100644 index 4fb633f1960faddf27d7bdc9d8bd4be8815920d6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-import-using-copy-from-stdin.md +++ /dev/null @@ -1,9 +0,0 @@ -# Data Import Using COPY FROM STDIN - -This method is applicable to low-concurrency scenarios where a small volume of data is to import. - -Run the **COPY FROM STDIN** statement to import data to openGauss in either of the following ways: - -- Write data into the openGauss database by typing. For details, see [COPY](copy.md). -- Import data from a file or database to openGauss through the CopyManager interface driven by JDBC. You can use any parameters in the **COPY** syntax. - diff --git a/content/en/docs/installation/Developerguide/data-ingestion-speed.md b/content/en/docs/installation/Developerguide/data-ingestion-speed.md deleted file mode 100644 index fc0e2f70c0d971250c84fb9a39e401ab0ad3a1b2..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-ingestion-speed.md +++ /dev/null @@ -1,16 +0,0 @@ -# Data Ingestion Speed - -This test simulates realtime data streams arriving from massive IoT, cloud or mobile devices that need to be quickly ingested into the database on a massive scale. - -- The test involved - - 10 million rows were sent by 500 threads, 2000 rounds, 10 records \(rows\) in each insert command, each record was 200 bytes. - - The client and database were on different machines. Database server – x86 2-socket, 72 cores. - -- Performance Results - - **Throughput – 10,000 **Records/Core or **2** MB/Core. - - **Latency – 2.8ms per a 10 records** bulk insert \(includes client-server networking\) - - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->We are projecting that multiple additional, and even significant, performance improvements will be made by MOT for this scenario. - diff --git a/content/en/docs/installation/Developerguide/data-type-conversion.md b/content/en/docs/installation/Developerguide/data-type-conversion.md deleted file mode 100644 index 11ad2425e2a220ced667f0e9220f486da2e692e5..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-type-conversion.md +++ /dev/null @@ -1,171 +0,0 @@ -# Data Type Conversion - -Certain data types in the database support implicit data type conversions, such as assignments and parameters called by functions. For other data types, you can use the type conversion functions provided by openGauss, such as the **CAST** function, to forcibly convert them. - -openGauss lists common implicit data type conversions in [Table 1](#en-us_topic_0237122212_en-us_topic_0059778807_tbc67231ae8bc4ca484efaebd2629a0e4). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->The valid value range of **DATE** supported by openGauss is from 4713 B.C. to 294276 A.D. - -**Table 1** Implicit data type conversions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Raw Data Type

-

Target Data Type

-

Remarks

-

CHAR

-

VARCHAR2

-

-

-

CHAR

-

NUMBER

-

Raw data must consist of digits.

-

CHAR

-

DATE

-

Raw data cannot exceed the valid date range.

-

CHAR

-

RAW

-

-

-

CHAR

-

CLOB

-

-

-

VARCHAR2

-

CHAR

-

-

-

VARCHAR2

-

NUMBER

-

Raw data must consist of digits.

-

VARCHAR2

-

DATE

-

Raw data cannot exceed the valid date range.

-

VARCHAR2

-

CLOB

-

-

-

NUMBER

-

CHAR

-

-

-

NUMBER

-

VARCHAR2

-

-

-

DATE

-

CHAR

-

-

-

DATE

-

VARCHAR2

-

-

-

RAW

-

CHAR

-

-

-

RAW

-

VARCHAR2

-

-

-

CLOB

-

CHAR

-

-

-

CLOB

-

VARCHAR2

-

-

-

CLOB

-

NUMBER

-

Raw data must consist of digits.

-

INT4

-

CHAR

-

-

-

INT4

-

BOOLEAN

-

-

-

BOOLEAN

-

INT4

-

-

-
- - diff --git a/content/en/docs/installation/Developerguide/data-types-22.md b/content/en/docs/installation/Developerguide/data-types-22.md deleted file mode 100644 index f53a4f908a14ad24cb7e2cdcd8b8f81cc018d174..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-types-22.md +++ /dev/null @@ -1,4 +0,0 @@ -# Data Types - -A data type refers to a value set and an operation set defined on the value set. The openGauss database consists of tables, each of which is defined by its own columns. Each column corresponds to a data type. The openGauss uses corresponding functions to perform operations on data based on data types. For example, the openGauss can perform addition, subtraction, multiplication, and division operations on data of numeric values. - diff --git a/content/en/docs/installation/Developerguide/data-types-36.md b/content/en/docs/installation/Developerguide/data-types-36.md deleted file mode 100644 index 556fbf9aaf6895913c1de5cb4266fae40d9193cc..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-types-36.md +++ /dev/null @@ -1,4 +0,0 @@ -# Data Types - -A data type refers to a value set and an operation set defined on the value set. The openGauss database consists of tables, each of which is defined by its own columns. Each column corresponds to a data type. The openGauss uses corresponding functions to perform operations on data based on data types. For example, the openGauss can perform addition, subtraction, multiplication, and division operations on data of numeric values. - diff --git a/content/en/docs/installation/Developerguide/data-types-supported-by-column-store-tables.md b/content/en/docs/installation/Developerguide/data-types-supported-by-column-store-tables.md deleted file mode 100644 index 9eb43b190c49e3875275703dea50c52aacf8c5d6..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-types-supported-by-column-store-tables.md +++ /dev/null @@ -1,214 +0,0 @@ -# Data Types Supported by Column-store Tables - -[Table 1](#en-us_topic_0237121962_table1899319136548) lists the data types supported by column-store tables. - -**Table 1** Data types supported by column-store tables - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Category

-

Data Type

-

Length

-

Supported or Not

-

Numeric Types

-

smallint

-

2

-

Supported

-

integer

-

4

-

Supported

-

bigint

-

8

-

Supported

-

decimal

-

-1

-

Supported

-

numeric

-

-1

-

Supported

-

real

-

4

-

Supported

-

double precision

-

8

-

Supported

-

smallserial

-

2

-

Supported

-

serial

-

4

-

Supported

-

bigserial

-

8

-

Supported

-

Monetary Types

-

money

-

8

-

Supported

-

Character Types

-

character varying(n), varchar(n)

-

-1

-

Supported

-

character(n), char(n)

-

n

-

Supported

-

character, char

-

1

-

Supported

-

text

-

-1

-

Supported

-

nvarchar2

-

-1

-

Supported

-

name

-

64

-

Not supported

-

Date/Time Types

-

timestamp with time zone

-

8

-

Supported

-

timestamp without time zone

-

8

-

Supported

-

date

-

4

-

Supported

-

time without time zone

-

8

-

Supported

-

time with time zone

-

12

-

Supported

-

interval

-

16

-

Supported

-

big object

-

clob

-

-1

-

Supported

-

blob

-

-1

-

Not supported

-

other types

-

...

-

...

-

Not supported

-
- diff --git a/content/en/docs/installation/Developerguide/data-types.md b/content/en/docs/installation/Developerguide/data-types.md deleted file mode 100644 index 4fe7d18430e9412c25273f04153985a45ffb8e94..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/data-types.md +++ /dev/null @@ -1,35 +0,0 @@ -# Data Types - -openGauss supports implicit conversions between certain data types. For details, see [PG\_CAST](pg_cast.md). - -- **[Numeric Data Types](numeric-data-types.md)** - -- **[Monetary](monetary.md)** - -- **[Boolean Data Types](boolean-data-types.md)** - -- **[Character Data Types](character-data-types.md)** - -- **[Binary Data Types](binary-data-types.md)** - -- **[Date/Time Types](date-time-types.md)** - -- **[Geometric](geometric.md)** - -- **[Network Address](network-address.md)** - -- **[Bit String Types](bit-string-types.md)** - -- **[Text Search Types](text-search-types.md)** - -- **[UUID Type](uuid-type.md)** - -- **[JSON Types](json-types.md)** - -- **[Object Identifier Types](object-identifier-types.md)** - -- **[Pseudo-Types](pseudo-types.md)** - -- **[Data Types Supported by Column-store Tables](data-types-supported-by-column-store-tables.md)** - - diff --git a/content/en/docs/installation/Developerguide/database-connection-control-functions.md b/content/en/docs/installation/Developerguide/database-connection-control-functions.md deleted file mode 100644 index ad181fc62d5f4ef7f942dde2573855fbf65a5e81..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/database-connection-control-functions.md +++ /dev/null @@ -1,23 +0,0 @@ -# Database Connection Control Functions - -Database connection control functions control the connections to GaussDB servers. An application can connect to multiple servers at a time. For example, a client connects to multiple databases. Each connection is represented by a PGconn object, which is obtained from the function PQconnectdb, PQconnectdbParams, or PQsetdbLogin. Note that these functions will always return a non-null object pointer, unless there is too little memory to allocate the PGconn object. The interface for establishing a connection is stored in the PGconn object. The PQstatus function can be called to check the return value for a successful connection. - -- **[PQconnectdbParams](pqconnectdbparams.md)** - -- **[PQconnectdb](pqconnectdb.md)** - -- **[PQconninfoParse](pqconninfoparse.md)** - -- **[PQconnectStart](pqconnectstart.md)** - -- **[PQerrorMessage](pqerrormessage.md)** - -- **[PQsetdbLogin](pqsetdblogin.md)** - -- **[PQfinish](pqfinish.md)** - -- **[PQreset](pqreset.md)** - -- **[PQstatus](pqstatus.md)** - - diff --git a/content/en/docs/installation/Developerguide/database-logical-architecture.md b/content/en/docs/installation/Developerguide/database-logical-architecture.md deleted file mode 100644 index ee150f2b06b6fcdf8d3d4e06c4dba572e16b0e0e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/database-logical-architecture.md +++ /dev/null @@ -1,14 +0,0 @@ -# Database Logical Architecture - -Data nodes \(DNs\) in openGauss store data on disks. This section describes the objects on each DN from the logical view and the relationship between these objects. [Figure 1](#en-us_topic_0237120245_en-us_topic_0059779316_fb2fa3b3cc8824dea95318504e0537913) shows the database logical structure. - -**Figure 1** Database logical architecture -![](figures/database-logical-architecture.png "database-logical-architecture") - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- Tablespace: Directory storing physical files of its databases. Multiple tablespaces can coexist, and each of them can contain files belonging to different databases. ->- Database: A database manages various data objects and is isolated from each other. Objects managed by a database can be distributed to multiple tablespaces. ->- Datafile Segment: Data file, each of which stores data of only one table. A table containing more than 1 GB of data is stored in multiple datafile segments. ->- One table belongs to only one database and one tablespace. The datafile segments storing the data of the same table must be in the same tablespace. ->- Block: Basic unit of database management. Its default size is 8 KB. - diff --git a/content/en/docs/installation/Developerguide/database-object-functions.md b/content/en/docs/installation/Developerguide/database-object-functions.md deleted file mode 100644 index 657cc0cf841ff1e43a53b239cabfbc82931f8740..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/database-object-functions.md +++ /dev/null @@ -1,454 +0,0 @@ -# Database Object Functions - -## Database Object Size Functions - -Database object size functions calculate the actual disk space used by database objects. - -- pg\_column\_size\(any\) - - Description: Specifies the number of bytes used to store a particular value \(possibly compressed\) - - Return type: int - - Note: **pg\_column\_size** displays the space for storing an independent data value. - - ``` - postgres=# SELECT pg_column_size(1); - pg_column_size - ---------------- - 4 - (1 row) - ``` - -- pg\_database\_size\(oid\) - - Description: Specifies the disk space used by the database with the specified OID. - - Return type: bigint - -- pg\_database\_size\(name\) - - Description: Specifies the disk space used by the database with the specified name. - - Return type: bigint - - Note: **pg\_database\_size** receives the OID or name of a database and returns the disk space used by the corresponding object. - - For example: - - ``` - postgres=# SELECT pg_database_size('postgres'); - pg_database_size - ------------------ - 51590112 - (1 row) - ``` - -- pg\_relation\_size\(oid\) - - Description: Specifies the disk space used by the table with a specified OID or index. - - Return type: bigint - -- get\_db\_source\_datasize\(\) - - Description: Estimates the total size of non-compressed data in the current database. - - Return type: bigint - - Note: \(1\) **ANALYZE** must be performed before this function is called. \(2\) Calculate the total size of non-compressed data by estimating the compression rate of column-store tables. - - For example: - - ``` - postgres=# analyze; - ANALYZE - postgres=# select get_db_source_datasize(); - get_db_source_datasize - ------------------------ - 35384925667 - (1 row) - ``` - -- pg\_relation\_size\(text\) - - Description: Specifies the disk space used by the table with a specified name or index. The table name can be schema-qualified. - - Return type: bigint - -- pg\_relation\_size\(relation regclass, fork text\) - - Description: Specifies the disk space used by the specified bifurcating tree \('main', 'fsm', or 'vm'\) of a certain table or index. - - Return type: bigint - -- pg\_relation\_size\(relation regclass\) - - Description: Is an abbreviation of **pg\_relation\_size\(..., 'main'\)**. - - Return type: bigint - - Note: **pg\_relation\_size** receives the OID or name of a table, index, or compressed table, and returns the size. - -- pg\_partition\_size\(oid,oid\) - - Description: Specifies the disk space used by the partition with a specified OID. The first **oid** is the OID of the table and the second **oid** is the OID of the partition. - - Return type: bigint - -- pg\_partition\_size\(text, text\) - - Description: Specifies the disk space used by the partition with a specified name. The first **text** is the table name and the second **text** is the partition name. - - Return type: bigint - -- pg\_partition\_indexes\_size\(oid,oid\) - - Description: Specifies the disk space used by the index of the partition with a specified OID. The first **oid** is the OID of the table and the second **oid** is the OID of the partition. - - Return type: bigint - -- pg\_partition\_indexes\_size\(text,text\) - - Description: Specifies the disk space used by the index of the partition with a specified name. The first **text** is the table name and the second **text** is the partition name. - - Return type: bigint - -- pg\_indexes\_size\(regclass\) - - Description: Specifies the total disk space used by the index appended to the specified table. - - Return type: bigint - -- pg\_size\_pretty\(bigint\) - - Description: Converts a size in bytes expressed as a 64-bit integer into a human-readable format with size units. - - Return type: text - -- pg\_size\_pretty\(numeric\) - - Description: Converts a size in bytes expressed as a numeric value into a human-readable format with size units. - - Return type: text - - Note: **pg\_size\_pretty** formats the results of other functions into a human-readable format. KB/MB/GB/TB can be used. - -- pg\_table\_size\(regclass\) - - Description: Specifies the disk space used by the specified table, excluding indexes \(but including TOAST, free space mapping, and visibility mapping\). - - Return type: bigint - -- pg\_tablespace\_size\(oid\) - - Description: Specifies the disk space used by the tablespace with a specified OID. - - Return type: bigint - -- pg\_tablespace\_size\(name\) - - Description: Specifies the disk space used by the tablespace with a specified name. - - Return type: bigint - - Note: - - **pg\_tablespace\_size** receives the OID or name of a database and returns the disk space used by the corresponding object. - -- pg\_total\_relation\_size\(oid\) - - Description: Specifies the disk space used by the table with a specified OID, including the index and the compressed data. - - Return type: bigint - -- pg\_total\_relation\_size\(regclass\) - - Description: Specifies the total disk space used by the specified table, including all indexes and TOAST data. - - Return type: bigint - -- pg\_total\_relation\_size\(text\) - - Description: Specifies the disk space used by the table with a specified name, including the index and the compressed data. The table name can be schema-qualified. - - Return type: bigint - - Note: **pg\_total\_relation\_size** receives the OID or name of a table or a compressed table, and returns the sizes of the data, related indexes, and the compressed table in bytes. - -- datalength\(any\) - - Description: Specifies the number of bytes used by an expression of a specified data type \(data management space, data compression, or data type conversion is not considered\). - - Return type: int - - Note: **datalength** is used to calculate the space of an independent data value. - - For example: - - ``` - postgres=# SELECT datalength(1); - datalength - ------------ - 4 - (1 row) - ``` - - The following table lists the supported data types and calculation methods. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Data Type

-

Storage Space

-

Numeric data types

-

Integer types

-

TINYINT

-

1

-

SMALLINT

-

2

-

INTEGER

-

4

-

BINARY_INTEGER

-

4

-

BIGINT

-

8

-

Any-precision types

-

DECIMAL

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

NUMERIC

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

NUMBER

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

Sequence integer

-

SMALLSERIAL

-

2

-

SERIAL

-

4

-

BIGSERIAL

-

8

-

Floating point types

-

FLOAT4

-

4

-

DOUBLE PRECISION

-

8

-

FLOAT8

-

8

-

BINARY_DOUBLE

-

8

-

FLOAT[(p)]

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

DEC[(p[,s])]

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

INTEGER[(p[,s])]

-

Every four decimal digits occupy two bytes. The digits before and after the decimal point are calculated separately.

-

Boolean data types

-

Boolean type

-

BOOLEAN

-

1

-

Character data types

-

Character types

-

CHAR

-

n

-

CHAR(n)

-

n

-

CHARACTER(n)

-

n

-

NCHAR(n)

-

n

-

VARCHAR(n)

-

n

-

CHARACTER

-

Actual number of bytes of a character

-

VARYING(n)

-

Actual number of bytes of a character

-

VARCHAR2(n)

-

Actual number of bytes of a character

-

NVARCHAR2(n)

-

Actual number of bytes of a character

-

TEXT

-

Actual number of bytes of a character

-

CLOB

-

Actual number of bytes of a character

-

Time data types

-

Time types

-

DATE

-

8

-

TIME

-

8

-

TIMEZ

-

12

-

TIMESTAMP

-

8

-

TIMESTAMPZ

-

8

-

SMALLDATETIME

-

8

-

INTERVAL DAY TO SECOND

-

16

-

INTERVAL

-

16

-

RELTIME

-

4

-

ABSTIME

-

4

-

TINTERVAL

-

12

-
- - -## Database Object Position Functions - -- pg\_relation\_filenode\(relation regclass\) - - Description: Specifies the ID of a filenode with the specified relationship. - - Return type: oid - - Description: **pg\_relation\_filenode** receives the OID or name of a table, index, sequence, or compressed table, and returns the **filenode** number allocated to it. The **filenode** is the basic component of the file name used by the relationship. For most tables, the result is the same as that of **pg\_class.relfilenode**. For the specified system directory, **relfilenode** is **0** and this function must be used to obtain the correct value. If a relationship that is not stored is transmitted, such as a view, this function returns **NULL**. - -- pg\_relation\_filepath\(relation regclass\) - - Description: Specifies the name of a file path with the specified relationship. - - Return type: text - - Description: **pg\_relation\_filepath** is similar to **pg\_relation\_filenode**, except that **pg\_relation\_filepath** returns the whole file path name for the relationship \(relative to the data directory **PGDATA** of openGauss\). - - diff --git a/content/en/docs/installation/Developerguide/database-security-management.md b/content/en/docs/installation/Developerguide/database-security-management.md deleted file mode 100644 index 520991efc0a146ee3ac9e28f62eea34b8d3a183a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/database-security-management.md +++ /dev/null @@ -1,9 +0,0 @@ -# Database Security Management - -- **[Client Access Authentication](client-access-authentication.md)** - -- **[Managing Users and Their Permissions](managing-users-and-their-permissions.md)** - -- **[Configuring Database Audit](configuring-database-audit.md)** - - diff --git a/content/en/docs/installation/Developerguide/database-statement-execution-functions.md b/content/en/docs/installation/Developerguide/database-statement-execution-functions.md deleted file mode 100644 index 98c4beba81e852358097380d212a6df39fa3a729..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/database-statement-execution-functions.md +++ /dev/null @@ -1,29 +0,0 @@ -# **Database Statement Execution Functions** - -After the connection to the database server is successfully established, you can use the functions described in this section to execute SQL queries and commands. - -- **[PQclear](pqclear.md)** - -- **[PQexec](pqexec.md)** - -- **[PQexecParams](pqexecparams.md)** - -- **[PQexecParamsBatch](pqexecparamsbatch.md)** - -- **[PQexecPrepared](pqexecprepared.md)** - -- **[PQexecPreparedBatch](pqexecpreparedbatch.md)** - -- **[PQfname](pqfname.md)** - -- **[PQgetvalue](pqgetvalue.md)** - -- **[PQnfields](pqnfields.md)** - -- **[PQntuples](pqntuples.md)** - -- **[PQprepare](pqprepare.md)** - -- **[PQresultStatus](pqresultstatus.md)** - - diff --git a/content/en/docs/installation/Developerguide/date-and-time-processing-functions-and-operators.md b/content/en/docs/installation/Developerguide/date-and-time-processing-functions-and-operators.md deleted file mode 100644 index 2e4745ab50c66786cd7fcc9ef56a2b76029d3de0..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/date-and-time-processing-functions-and-operators.md +++ /dev/null @@ -1,1332 +0,0 @@ -# Date and Time Processing Functions and Operators - -## Date and Time Operators - ->![](public_sys-resources/icon-warning.gif) **WARNING:** ->When the user uses date/time operators, explicit type prefixes are modified for corresponding operands to ensure that the operands parsed by the database are consistent with what the user expects, and no unexpected results occur. ->For example, abnormal mistakes will occur in the following example without an explicit data type. ->``` ->SELECT date '2001-10-01' - '7' AS RESULT; ->``` - -**Table 1** Time and date operators - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Operator

-

Example

-

+

-
postgres=# SELECT date '2001-09-28' + integer '7' AS RESULT;
-       result        
----------------------
- 2001-10-05 00:00:00
-(1 row)
-
postgres=# SELECT date '2001-09-28' + interval '1 hour' AS RESULT;
-       result        
----------------------
- 2001-09-28 01:00:00
-(1 row)
-
postgres=# SELECT date '2001-09-28' + time '03:00' AS RESULT;
-       result        
----------------------
- 2001-09-28 03:00:00
-(1 row)
-
postgres=# SELECT interval '1 day' + interval '1 hour' AS RESULT;
-     result     
-----------------
- 1 day 01:00:00
-(1 row)
-
postgres=# SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT;
-       result        
----------------------
- 2001-09-29 00:00:00
-(1 row)
-
postgres=# SELECT time '01:00' + interval '3 hours' AS RESULT;
-  result  
-----------
- 04:00:00
-(1 row)
-

-

-
postgres=# SELECT date '2001-10-01' - date '2001-09-28' AS RESULT;
- result 
---------
- 3 days
-(1 row)
-
postgres=# SELECT date '2001-10-01' - integer '7' AS RESULT;
-       result        
----------------------
- 2001-09-24 00:00:00
-(1 row)
-
postgres=# SELECT date '2001-09-28' - interval '1 hour' AS RESULT;
-       result        
----------------------
- 2001-09-27 23:00:00
-(1 row)
-
postgres=# SELECT time '05:00' - time '03:00' AS RESULT;
-  result  
-----------
- 02:00:00
-(1 row)
-
postgres=# SELECT time '05:00' - interval '2 hours' AS RESULT;
-  result  
-----------
- 03:00:00
-(1 row)
-
postgres=# SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT;
-       result        
----------------------
- 2001-09-28 00:00:00
-(1 row)
-
postgres=# SELECT interval '1 day' - interval '1 hour' AS RESULT;
-  result  
-----------
- 23:00:00
-(1 row)
-
postgres=# SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT;
-     result     
-----------------
- 1 day 15:00:00
-(1 row)
-

*

-
postgres=# SELECT 900 * interval '1 second' AS RESULT;
-  result  
-----------
- 00:15:00
-(1 row)
-
postgres=# SELECT 21 * interval '1 day' AS RESULT;
- result  
----------
- 21 days
-(1 row)
-
postgres=# SELECT double precision '3.5' * interval '1 hour' AS RESULT;
-  result  
-----------
- 03:30:00
-(1 row)
-

/

-
postgres=# SELECT interval '1 hour' / double precision '1.5' AS RESULT;
-  result  
-----------
- 00:40:00
-(1 row)
-
- -## Time/Date Functions - -- age\(timestamp, timestamp\) - - Description: Subtracts arguments, producing a result in YYYY-MM-DD format. If the result is negative, the returned result is also negative. - - Return type: interval - - Example: - - ``` - postgres=# SELECT age(timestamp '2001-04-10', timestamp '1957-06-13'); - age - ------------------------- - 43 years 9 mons 27 days - (1 row) - ``` - -- age\(timestamp\) - - Description: Subtracts from **current\_date** - - Return type: interval - - Example: - - ``` - postgres=# SELECT age(timestamp '1957-06-13'); - age - ------------------------- - 60 years 2 mons 18 days - (1 row) - ``` - -- clock\_timestamp\(\) - - Description: Specifies the current timestamp of the real-time clock. - - Return type: timestamp with time zone - - Example: - - ``` - postgres=# SELECT clock_timestamp(); - clock_timestamp - ------------------------------- - 2017-09-01 16:57:36.636205+08 - (1 row) - ``` - -- current\_date - - Description: current date - - Return type: date - - Example: - - ``` - postgres=# SELECT current_date; - date - ------------ - 2017-09-01 - (1 row) - ``` - -- current\_time - - Description: current time - - Return type: time with time zone - - Example: - - ``` - postgres=# SELECT current_time; - timetz - -------------------- - 16:58:07.086215+08 - (1 row) - ``` - -- current\_timestamp - - Description: Specifies the current date and time. - - Return type: timestamp with time zone - - Example: - - ``` - postgres=# SELECT current_timestamp; - pg_systimestamp - ------------------------------ - 2017-09-01 16:58:19.22173+08 - (1 row) - ``` - -- date\_part\(text, timestamp\) - - Description: Obtains the value of a subdomain in date or time, for example, the year or hour. Equivalent to **extract\(field from timestamp\)**. - - Return type: double precision - - Example: - - ``` -postgres=# SELECT date_part('hour', timestamp '2001-02-16 20:38:40'); - date_part ------------ - 20 - (1 row) - ``` - -- date\_part\(text, interval\) - - Description: Obtains the subdomain value of the date/time value. When obtaining the month value, if the value is greater than 12, obtain the remainder after it is divided by 12. Equivalent to **extract\(field from timestamp\)**. - - Return type: double precision - - Example: - - ``` - postgres=# SELECT date_part('month', interval '2 years 3 months'); - date_part - ----------- - 3 - (1 row) - ``` - -- date\_trunc\(text, timestamp\) - - Description: Truncates to the precision specified by **text**. - - Return type: timestamp - - Example: - - ``` - postgres=# SELECT date_trunc('hour', timestamp '2001-02-16 20:38:40'); - date_trunc - --------------------- - 2001-02-16 20:00:00 - (1 row) - ``` - -- trunc\(timestamp\) - - Description: By default, the data is intercepted by day. - - Example: - - ``` - postgres=# SELECT trunc(timestamp '2001-02-16 20:38:40'); trunc - --------------------- - 2001-02-16 00:00:00 - (1 row) - ``` - -- extract\(field from timestamp\) - - Description: Obtains the hour. - - Return type: double precision - - Example: - - ``` - postgres=# SELECT extract(hour from timestamp '2001-02-16 20:38:40'); - date_part - ----------- - 20 - (1 row) - ``` - -- extract\(field from interval\) - - Description: Obtains the month. If the value is greater than 12, obtain the remainder after it is divided by 12. - - Return type: double precision - - Example: - - ``` - postgres=# SELECT extract(month from interval '2 years 3 months'); - date_part - ----------- - 3 - (1 row) - ``` - -- isfinite\(date\) - - Description: Tests for valid date. - - Return type: Boolean - - Example: - - ``` - postgres=# SELECT isfinite(date '2001-02-16'); - isfinite - ---------- - t - (1 row) - ``` - -- isfinite\(timestamp\) - - Description: Tests for valid timestamp. - - Return type: Boolean - - Example: - - ``` - postgres=# SELECT isfinite(timestamp '2001-02-16 21:28:30'); - isfinite - ---------- - t - (1 row) - ``` - -- isfinite\(interval\) - - Description: Tests for valid interval. - - Return type: Boolean - - Example: - - ``` - postgres=# SELECT isfinite(interval '4 hours'); - isfinite - ---------- - t - (1 row) - ``` - -- justify\_days\(interval\) - - Description: Sets the time interval in months \(30 days as a month\). - - Return type: interval - - Example: - - ``` - postgres=# SELECT justify_days(interval '35 days'); - justify_days - -------------- - 1 mon 5 days - (1 row) - ``` - -- justify\_hours\(interval\) - - Description: Sets the time interval in days \(24 hours is one day\). - - Return type: interval - - Example: - - ``` - postgres=# SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS'); - justify_hours - ---------------- - 1 day 03:00:00 - (1 row) - ``` - -- justify\_interval\(interval\) - - Description: Adjusts **interval** using **justify\_days** and **justify\_hours**. - - Return type: interval - - Example: - - ``` - postgres=# SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR'); - justify_interval - ------------------ - 29 days 23:00:00 - (1 row) - ``` - -- localtime - - Description: current time - - Return type: time - - Example: - - ``` - postgres=# SELECT localtime AS RESULT; - result - ---------------- - 16:05:55.664681 - (1 row) - ``` - -- localtimestamp - - Description: Specifies the current date and time. - - Return type: timestamp - - Example: - - ``` - postgres=# SELECT localtimestamp; - timestamp - ---------------------------- - 2017-09-01 17:03:30.781902 - (1 row) - ``` - -- now\(\) - - Description: Specifies the current date and time. - - Return type: timestamp with time zone - - Example: - - ``` - postgres=# SELECT now(); - now - ------------------------------- - 2017-09-01 17:03:42.549426+08 - (1 row) - ``` - -- numtodsinterval\(num, interval\_unit\) - - Description: Converts a number to the interval type. **num** is a numeric-typed number. **interval\_unit** is a string in the following format: 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' - - You can set the [IntervalStyle](zone-and-formatting.md#en-us_topic_0237124733_en-us_topic_0059778109_s89302a8dcd7f46ecb7167574d6397dc0) parameter to **a** to be compatible with the interval output format of the function. - - Example: - - ``` - postgres=# SELECT numtodsinterval(100, 'HOUR'); - numtodsinterval - ----------------- - 100:00:00 - (1 row) - - postgres=# SET intervalstyle = a; - SET - postgres=# SELECT numtodsinterval(100, 'HOUR'); - numtodsinterval - ------------------------------- - +000000004 04:00:00.000000000 - (1 row) - ``` - -- pg\_sleep\(seconds\) - - Description: Server thread delay time, in seconds. - - Return type: void - - Example: - - ``` - postgres=# SELECT pg_sleep(10); - pg_sleep - ---------- - - (1 row) - ``` - -- statement\_timestamp\(\) - - Description: Specifies the current date and time. - - Return type: timestamp with time zone - - Example: - - ``` - postgres=# SELECT statement_timestamp(); - statement_timestamp - ------------------------------- - 2017-09-01 17:04:39.119267+08 - (1 row) - ``` - -- sysdate - - Description: Specifies the current date and time. - - Return type: timestamp - - Example: - - ``` - postgres=# SELECT sysdate; - sysdate - --------------------- - 2017-09-01 17:04:49 - (1 row) - ``` - -- timeofday\(\) - - Description: current date and time \(like clock\_timestamp, but returned as text\) - - Return type: text - - Example: - - ``` - postgres=# SELECT timeofday(); - timeofday - ------------------------------------- - Fri Sep 01 17:05:01.167506 2017 CST - (1 row) - ``` - -- transaction\_timestamp\(\) - - Description: current date and time \(equivalent to **current\_timestamp**\) - - Return type: timestamp with time zone - - Example: - - ``` - postgres=# SELECT transaction_timestamp(); - transaction_timestamp - ------------------------------- - 2017-09-01 17:05:13.534454+08 - (1 row) - ``` - -- add\_months\(d,n\) - - Description: Returns the date _date_ plus _integer_ months. - - Return type: timestamp - - Example: - - ``` - postgres=# SELECT add_months(to_date('2017-5-29', 'yyyy-mm-dd'), 11) FROM dual; - add_months - --------------------- - 2018-04-29 00:00:00 - (1 row) - ``` - -- last\_day\(d\) - - Description: Returns the date of the last day of the month that contains _date_. - - Return type: timestamp - - Example: - - ``` - postgres=# select last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result; - cal_result - --------------------- - 2017-01-31 00:00:00 - (1 row) - ``` - - -- next\_day\(x,y\) - - Description: Returns the time of the next week y started from x - - Return type: timestamp - - Example: - - ``` - postgres=# select next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result; - cal_result - --------------------- - 2017-05-28 00:00:00 - (1 row) - ``` - - -## TIMESTAMPDIFF - -**TIMESTAMPDIFF\(**_unit , timestamp\_expr1, timestamp\_expr2_**\)** - -The timestampdiff function returns the result of **timestamp\_expr2** - **timestamp\_expr1** in the specified unit. **timestamp\_expr1** and **timestamp\_expr2** must be value expressions of the **timestamp**, **timestamptz**, or **date** type. **unit** indicates the unit of the difference between two dates. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->This function is valid only when openGauss is compatible with the MY type \(that is, dbcompatibility = 'B'\). - -- year - - Year. - - ``` - postgres=# SELECT TIMESTAMPDIFF(YEAR, '2018-01-01', '2020-01-01'); - timestamp_diff - ---------------- - 2 - (1 row) - ``` - - -- quarter - - Quarter. - - ``` - postgres=# SELECT TIMESTAMPDIFF(QUARTER, '2018-01-01', '2020-01-01'); - timestamp_diff - ---------------- - 8 - (1 row) - ``` - -- month - - Month. - - ``` - postgres=# SELECT TIMESTAMPDIFF(MONTH, '2018-01-01', '2020-01-01'); - timestamp_diff - ---------------- - 24 - (1 row) - ``` - -- week - - Week. - - ``` - postgres=# SELECT TIMESTAMPDIFF(WEEK, '2018-01-01', '2020-01-01'); - timestamp_diff - ---------------- - 104 - (1 row) - ``` - -- day - - Day. - - ``` - postgres=# SELECT TIMESTAMPDIFF(DAY, '2018-01-01', '2020-01-01'); - timestamp_diff - ---------------- - 730 - (1 row) - ``` - - -- hour - - Hour. - - ``` - postgres=# SELECT TIMESTAMPDIFF(HOUR, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); - timestamp_diff - ---------------- - 1 - (1 row) - - ``` - - -- minute - - Minute. - - ``` - postgres=# SELECT TIMESTAMPDIFF(MINUTE, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); - timestamp_diff - ---------------- - 61 - (1 row) - - ``` - - -- second - - Second. - - ``` - postgres=# SELECT TIMESTAMPDIFF(SECOND, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); - timestamp_diff - ---------------- - 3661 - (1 row) - - - ``` - - -- microseconds - - The seconds column, including fractional parts, multiplied by 1,000,000. - - ``` - postgres=# SELECT TIMESTAMPDIFF(MICROSECOND, '2020-01-01 10:10:10.000000', '2020-01-01 10:10:10.111111'); - timestamp_diff - ---------------- - 111111 - (1 row) - - ``` - - -## EXTRACT - -**EXTRACT\(**_field _**FROM **_source_**\)** - -The **extract** function retrieves subcolumns such as year or hour from date/time values. **source** must be a value expression of type **timestamp**, **time**, or **interval**. \(Expressions of type **date** are cast to **timestamp** and can therefore be used as well.\) **field** is an identifier or string that selects what column to extract from the source value. The **extract** function returns values of type **double precision**. The following are valid field names: - -- century - - - - The first century starts at 0001-01-01 00:00:00 AD. This definition applies to all Gregorian calendar countries. There is no century number 0. You go from **-1** century to **1** century. - - Example: - - ``` - postgres=# SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); - date_part - ----------- - 20 - (1 row) - ``` - -- day - - For **timestamp** values, the day \(of the month\) column \(1–31\) - - ``` - postgres=# SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 16 - (1 row) - ``` - - - For **interval** values, the number of days - - ``` - postgres=# SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); - date_part - ----------- - 40 - (1 row) - ``` - - -- decade - - Year column divided by 10 - - ``` - postgres=# SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 200 - (1 row) - ``` - -- dow - - Day of the week as Sunday\(**0**\) to Saturday \(**6**\) - - ``` - postgres=# SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 5 - (1 row) - ``` - -- doy - - Day of the year \(1–365 or 366\) - - ``` - postgres=# SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 47 - (1 row) - ``` - -- epoch - - For **timestamp with time zone** values, the number of seconds since 1970-01-01 00:00:00 UTC \(can be negative\); - - for **date** and **timestamp** values, the number of seconds since 1970-01-01 00:00:00 local time; - - for **interval** values, the total number of seconds in the interval. - - ``` - postgres=# SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); - date_part - -------------- - 982384720.12 - (1 row) - ``` - - ``` - postgres=# SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); - date_part - ----------- - 442800 - (1 row) - ``` - - - Way to convert an epoch value back to a timestamp - - ``` - postgres=# SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second' AS RESULT; - result - --------------------------- - 2001-02-17 12:38:40.12+08 - (1 row) - ``` - - -- hour - - Hour column \(0–23\) - - ``` - postgres=# SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 20 - (1 row) - ``` - -- isodow - - Day of the week \(1–7\) - - Monday is 1 and Sunday is 7. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >This is identical to **dow** except for Sunday. - - ``` - postgres=# SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40'); - date_part - ----------- - 7 - (1 row) - ``` - -- isoyear - - The ISO 8601 year that the date falls in \(not applicable to intervals\). - - Each ISO year begins with the Monday of the week containing January 4, so in early January or late December the ISO year may be different from the Gregorian year. See the **week** column for more information. - - ``` - postgres=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); - date_part - ----------- - 2005 - (1 row) - ``` - - ``` - postgres=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); - date_part - ----------- - 2006 - (1 row) - ``` - -- microseconds - - The seconds column, including fractional parts, multiplied by 1,000,000 - - ``` - postgres=# SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); - date_part - ----------- - 28500000 - (1 row) - ``` - -- millennium - - - - Years in the 1900s are in the second millennium. The third millennium started from January 1, 2001. - - ``` - postgres=# SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 3 - (1 row) - ``` - -- milliseconds - - The seconds column, including fractional parts, multiplied by 1000. Note that this includes full seconds. - - ``` - postgres=# SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); - date_part - ----------- - 28500 - (1 row) - ``` - -- minute - - Minutes column \(0–59\) - - ``` - postgres=# SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 38 - (1 row) - ``` - -- month - - For **timestamp** values, the number of the month within the year \(1–12\); - - ``` - postgres=# SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 2 - (1 row) - ``` - - For **interval** values, the number of months, modulo 12 \(0–11\) - - ``` - postgres=# SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); - date_part - ----------- - 1 - (1 row) - ``` - -- quarter - - Quarter of the year \(1–4\) that the date is in - - ``` - postgres=# SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 1 - (1 row) - ``` - -- second - - Seconds column, including fractional parts \(0–59\) - - ``` - postgres=# SELECT EXTRACT(SECOND FROM TIME '17:12:28.5'); - date_part - ----------- - 28.5 - (1 row) - ``` - -- timezone - - The time zone offset from UTC, measured in seconds. Positive values correspond to time zones east of UTC, negative values to zones west of UTC. - -- timezone\_hour - - The hour component of the time zone offset - -- timezone\_minute - - The minute component of the time zone offset - -- week - - The number of the week of the year that the day is in. By definition \(ISO 8601\), the first week of a year contains January 4 of that year. \(The ISO-8601 week starts on Monday.\) In other words, the first Thursday of a year is in week 1 of that year. - - Because of this, it is possible for early January dates to be part of the 52nd or 53rd week of the previous year, and late December dates to be part of the 1st week of the next year. For example, **2005-01-01** is part of the 53rd week of year 2004, **2006-01-01** is part of the 52nd week of year 2005, and **2012-12-31** is part of the 1st week of year 2013. You are advised to use the columns **isoyear** and **week** together to ensure consistency. - - ``` - postgres=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 7 - (1 row) - ``` - -- year - - Year column - - ``` - postgres=# SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); - date_part - ----------- - 2001 - (1 row) - ``` - - -## date\_part - -The **date\_part** function is modeled on the traditional Ingres equivalent to the SQL-standard function **extract**: - -**date\_part\('**_field_**', **_source_**\)** - -Note that here the **field** parameter needs to be a string value, not a name. The valid field names for **field** are the same as for **extract**. For details, see [EXTRACT](#en-us_topic_0237121972_en-us_topic_0059779084_scb40477163d740de80f0e984cad28e7b). - -Example: - -``` -postgres=# SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); - date_part ------------ - 16 -(1 row) -``` - -``` -postgres=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes'); - date_part ------------ - 4 -(1 row) -``` - -[Table 2](#en-us_topic_0237121972_en-us_topic_0059779084_t2e5425ae98464c3dab59352ff3bfa786) specifies the schema for formatting date and time values. - -**Table 2** Schema for formatting date and time - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Category

-

Pattern

-

Description

-

Hour

-

HH

-

Number of hours in one day (01-12)

-

HH12

-

Number of hours in one day (01-12)

-

HH24

-

Number of hours in one day (00-23)

-

Minute

-

MI

-

Minute (00-59)

-

Second

-

SS

-

Second (00-59)

-

FF

-

Microsecond (000000-999999)

-

SSSSS

-

Second after midnight (0-86399)

-

Morning and afternoon

-

AM or A.M.

-

Morning identifier

-

PM or P.M.

-

Afternoon identifier

-

Year

-

Y,YYY

-

Year with comma (with four digits or more)

-

SYYYY

-

Year with four digits BC

-

YYYY

-

Year (with four digits or more)

-

YYY

-

Last three digits of a year

-

YY

-

Last two digits of a year

-

Y

-

Last one digit of a year

-

IYYY

-

ISO year (with four digits or more)

-

IYY

-

Last three digits of an ISO year

-

IY

-

Last two digits of an ISO year

-

I

-

Last one digit of an ISO year

-

RR

-

Last two digits of a year (A year of the 20th century can be stored in the 21st century.)

-

RRRR

-

Capable of receiving a year with four digits or two digits. If there are 2 digits, the value is the same as the returned value of RR. If there are 4 digits, the value is the same as YYYY.

-
  • BC or B.C.
  • AD or A.D.
-

Era indicator Before Christ (BC) and After Christ (AD)

-

Month

-

MONTH

-

Full spelling of a month in uppercase (9 characters are filled in if the value is empty.)

-

MON

-

Month in abbreviated format in uppercase (with three characters)

-

MM

-

Month (01-12)

-

RM

-

Month in Roman numerals (I-XII; I=JAN) and uppercase

-

Day

-

DAY

-

Full spelling of a date in uppercase (9 characters are filled in if the value is empty.)

-

DY

-

Day in abbreviated format in uppercase (with three characters)

-

DDD

-

Day in a year (001-366)

-

DD

-

Day in a month (01-31)

-

D

-

Day in a week (1-7. Sunday is 1.)

-

Week

-

W

-

Week in a month (1-5) (The first week starts from the first day of the month.)

-

WW

-

Week in a year (1-53) (The first week starts from the first day of the year.)

-

IW

-

Week in an ISO year (The first Thursday is in the first week.)

-

Century

-

CC

-

Century (with two digits) (The 21st century starts from 2001-01-01.)

-

Julian date

-

J

-

Julian date (starting from January 1 of 4712 BC)

-

Quarter

-

Q

-

Quarter

-
- ->![](public_sys-resources/icon-note.gif) **NOTE:** ->In the table, the rules for RR to calculate years are as follows: ->- If the range of the input two-digit year is between 00 and 49: -> If the last two digits of the current year are between 00 and 49, the first two digits of the returned year are the same as the first two digits of the current year. -> If the last two digits of the current year are between 50 and 99, the first two digits of the returned year equal to the first two digits of the current year plus 1. ->- If the range of the input two-digit year is between 50 and 99: -> If the last two digits of the current year are between 00 and 49, the first two digits of the returned year equal to the first two digits of the current year minus 1. -> If the last two digits of the current year are between 50 and 99, the first two digits of the returned year are the same as the first two digits of the current year. - diff --git a/content/en/docs/installation/Developerguide/date-time-types.md b/content/en/docs/installation/Developerguide/date-time-types.md deleted file mode 100644 index beb58397731fcb008efc0382f4e7291795f98965..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/date-time-types.md +++ /dev/null @@ -1,616 +0,0 @@ -# Date/Time Types - -[Table 1](#en-us_topic_0237121952_en-us_topic_0059779229_en-us_topic_0058965827_table60826369) lists the date/time types supported by openGauss. For the operators and built-in functions of the types, see [Date and Time Processing Functions and Operators](date-and-time-processing-functions-and-operators.md). - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If the time format of another database is different from that of openGauss, modify the value of the **DateStyle** parameter to keep them consistent. - -**Table 1** Date/Time types - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Name

-

Description

-

Storage Space

-

DATE

-

Specifies the date and time.

-

4 bytes (The actual storage space is 8 bytes.)

-

TIME [(p)] [WITHOUT TIME ZONE]

-

Specifies time within one day.

-

p indicates the precision after the decimal point. The value ranges from 0 to 6.

-

8 bytes

-

TIME [(p)] [WITH TIME ZONE]

-

Specifies time within one day (with time zone).

-

p indicates the precision after the decimal point. The value ranges from 0 to 6.

-

12 bytes

-

TIMESTAMP[(p)] [WITHOUT TIME ZONE]

-

Specifies the date and time.

-

p indicates the precision after the decimal point. The value ranges from 0 to 6.

-

8 bytes

-

TIMESTAMP[(p)][WITH TIME ZONE]

-

Specifies the date and time (with time zone). TIMESTAMP is also called TIMESTAMPTZ.

-

p indicates the precision after the decimal point. The value ranges from 0 to 6.

-

8 bytes

-

SMALLDATETIME

-

Date and time (without time zone)

-

The precision level is minute. A duration between 30s and 60s is rounded into 1 minute.

-

8 bytes

-

INTERVAL DAY (l) TO SECOND (p)

-

Specifies the time interval (X days X hours X minutes X seconds).

-
  • l: indicates the precision of days. The value ranges from 0 to 6. For compatibility, the precision functions are not supported.
  • p: indicates the precision of seconds. The value ranges from 0 to 6. The digit 0 at the end of a decimal number is not displayed.
-

16 bytes

-

INTERVAL [FIELDS] [ (p) ]

-

Time interval.

-
  • fields: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, DAY TO HOUR, DAY TO MINUTE, DAY TO SECOND, HOUR TO MINUTE, HOUR TO SECOND, and MINUTE TO SECOND.
-
  • p: indicates the precision of seconds. The value ranges from 0 to 6. p takes effect only when fields are SECOND, DAY TO SECOND, HOUR TO SECOND, or MINUTE TO SECOND. The digit 0 at the end of a decimal number is not displayed.
-

12 bytes

-

reltime

-

Relative time interval. Command syntax:

-

X years X mons X days XX:XX:XX.

-
  • The Julian calendar is used. It specifies that a year has 365.25 days and a month has 30 days. The relative time interval needs to be calculated based on the input value. The output format is POSTGRES.
-

4 bytes

-
- -Example: - -``` --- Create a table. -postgres=# CREATE TABLE date_type_tab(coll date); - --- Insert data. -postgres=# INSERT INTO date_type_tab VALUES (date '12-10-2010'); - --- View data. -postgres=# SELECT * FROM date_type_tab; - coll ---------------------- - 2010-12-10 00:00:00 -(1 row) - --- Delete the table. -postgres=# DROP TABLE date_type_tab; - --- Create a table. -postgres=# CREATE TABLE time_type_tab (da time without time zone ,dai time with time zone,dfgh timestamp without time zone,dfga timestamp with time zone, vbg smalldatetime); - --- Insert data. -postgres=# INSERT INTO time_type_tab VALUES ('21:21:21','21:21:21 pst','2010-12-12','2013-12-11 pst','2003-04-12 04:05:06'); - --- View data. -postgres=# SELECT * FROM time_type_tab; - da | dai | dfgh | dfga | vbg -----------+-------------+---------------------+------------------------+--------------------- - 21:21:21 | 21:21:21-08 | 2010-12-12 00:00:00 | 2013-12-11 16:00:00+08 | 2003-04-12 04:05:00 -(1 row) - --- Delete the table. -postgres=# DROP TABLE time_type_tab; - --- Create a table. -postgres=# CREATE TABLE day_type_tab (a int,b INTERVAL DAY(3) TO SECOND (4)); - --- Insert data. -postgres=# INSERT INTO day_type_tab VALUES (1, INTERVAL '3' DAY); - --- View data. -postgres=# SELECT * FROM day_type_tab; - a | b ----+-------- - 1 | 3 days -(1 row) - --- Delete the table. -postgres=# DROP TABLE day_type_tab; - --- Create a table. -postgres=# CREATE TABLE year_type_tab(a int, b interval year (6)); - --- Insert data. -postgres=# INSERT INTO year_type_tab VALUES(1,interval '2' year); - --- View data. -postgres=# SELECT * FROM year_type_tab; - a | b ----+--------- - 1 | 2 years -(1 row) - --- Delete the table. -postgres=# DROP TABLE year_type_tab; -``` - -## Date Input - -Date and time input is accepted in almost any reasonable formats, including ISO 8601, SQL-compatible, and traditional POSTGRES. The system allows you to customize the sequence of day, month, and year in the date input. Set the **DateStyle** parameter to **MDY** to select month-day-year interpretation, **DMY** to select day-month-year interpretation, or **YMD** to select year-month-day interpretation. - -Remember that any date or time literal input needs to be enclosed with single quotes, and the syntax is as follows: - -type \[ \( p \) \] 'value' - -The **p** that can be selected in the precision statement is an integer, indicating the number of fractional digits in the **seconds** column. [Table 2](#en-us_topic_0237121952_en-us_topic_0059779229_t0606b0d8bec74d34a6440ef1de8d1e67) shows some possible inputs for the **date** type. - -**Table 2** Date input - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Example

-

Description

-

1999-01-08

-

ISO 8601 (recommended format). January 8, 1999 in any mode

-

January 8, 1999

-

Unambiguous in any date input mode

-

1/8/1999

-

January 8 in MDY mode. August 1 in DMY mode

-

1/18/1999

-

January 18 in MDY mode, rejected in other modes

-

01/02/03

-
  • January 2, 2003 in MDY mode
  • February 1, 2003 in DMY mode
  • February 3, 2001 in YMD mode
-

1999-Jan-08

-

January 8 in any mode

-

Jan-08-1999

-

January 8 in any mode

-

08-Jan-1999

-

January 8 in any mode

-

99-Jan-08

-

January 8 in YMD mode, else error

-

08-Jan-99

-

January 8, except error in YMD mode

-

Jan-08-99

-

January 8, except error in YMD mode

-

19990108

-

ISO 8601. January 8, 1999 in any mode

-

990108

-

ISO 8601. January 8, 1999 in any mode

-

1999.008

-

Year and day of year

-

J2451187

-

Julian date

-

January 8, 99 BC

-

Year 99 BC

-
- -Example: - -``` --- Create a table. -postgres=# CREATE TABLE date_type_tab(coll date); - --- Insert data. -postgres=# INSERT INTO date_type_tab VALUES (date '12-10-2010'); - --- View data. -postgres=# SELECT * FROM date_type_tab; - coll ---------------------- - 2010-12-10 00:00:00 -(1 row) - --- View the date format. -postgres=# SHOW datestyle; - DateStyle ------------ - ISO, MDY -(1 row) - --- Set the date format. -postgres=# SET datestyle='YMD'; -SET - --- Insert data. -postgres=# INSERT INTO date_type_tab VALUES(date '2010-12-11'); - --- View data. -postgres=# SELECT * FROM date_type_tab; - coll ---------------------- - 2010-12-10 00:00:00 - 2010-12-11 00:00:00 -(2 rows) - --- Delete the table. -postgres=# DROP TABLE date_type_tab; -``` - -## Date - -The time-of-day types are **TIME \[\(p\)\] \[WITHOUT TIME ZONE\]** and **TIME \[\(p\)\] \[WITH TIME ZONE\]**. **TIME** alone is equivalent to **TIME WITHOUT TIME ZONE**. - -If a time zone is specified in the input for **TIME WITHOUT TIME ZONE**, it is silently ignored. - -For details about the time input types, see [Table 3](#en-us_topic_0237121952_en-us_topic_0059779229_tc5d1089552ca4fb2a9f5ba27767a26b6). For details about time zone input types, see [Table 4](#en-us_topic_0237121952_en-us_topic_0059779229_te78a582bdc984cd3b5ecac5502f7793e). - -**Table 3** Time input - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Example

-

Description

-

05:06.8

-

ISO 8601

-

4:05:06

-

ISO 8601

-

4:05

-

ISO 8601

-

40506

-

ISO 8601

-

4:05 AM

-

Same as 04:05. AM does not affect the value.

-

4:05 PM

-

Same as 16:05. Input hours must be less than or equal to 12.

-

04:05:06.789-8

-

ISO 8601

-

04:05:06-08:00

-

ISO 8601

-

04:05-08:00

-

ISO 8601

-

040506-08

-

ISO 8601

-

04:05:06 PST

-

Time zone specified by abbreviation

-

2003-04-12 04:05:06 America/New_York

-

Time zone specified by full name

-
- -**Table 4** Time zone input - - - - - - - - - - - - - - - - - - - - - - -

Example

-

Description

-

PST

-

Abbreviation (for Pacific Standard Time)

-

America/New_York

-

Full time zone name

-

-8:00

-

ISO-8601 offset for PST

-

-800

-

ISO-8601 offset for PST

-

-8

-

ISO-8601 offset for PST

-
- -Example: - -``` -postgres=# SELECT time '04:05:06'; - time ----------- - 04:05:06 -(1 row) - -postgres=# SELECT time '04:05:06 PST'; - time ----------- - 04:05:06 -(1 row) - -postgres=# SELECT time with time zone '04:05:06 PST'; - timetz -------------- - 04:05:06-08 -(1 row) -``` - -## Special Values - -The special values supported by openGauss are converted to common date/time values when being read. For details, see [Table 5](#en-us_topic_0237121952_en-us_topic_0059779229_t8366745d681748c28d5a76843c7f0d4b). - -**Table 5** Special values - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Input String

-

Applicable Type

-

Description

-

epoch

-

date, timestamp

-

1970-01-01 00:00:00+00 (Unix system time zero)

-

infinity

-

timestamp

-

Later than any other timestamps

-

-infinity

-

timestamp

-

Earlier than any other timestamps

-

now

-

date, time, timestamp

-

Start time of the current transaction

-

today

-

date, timestamp

-

Today midnight

-

tomorrow

-

date, timestamp

-

Tomorrow midnight

-

yesterday

-

date, timestamp

-

Yesterday midnight

-

allballs

-

time

-

00:00:00.00 UTC

-
- -## Interval Input - -The input of **reltime** can be any valid interval in TEXT format. It can be a number \(negative numbers and decimals are also allowed\) or a specific time, which must be in SQL standard format, ISO-8601 format, or POSTGRES format. In addition, the text input needs to be enclosed with single quotation marks \(''\). - -For details, see [Interval input](#en-us_topic_0237121952_table1747116463276). - -**Table 6** Interval input - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Input Example

-

Output

-

Description

-

60

-

2 mons

-

Numbers are used to indicate intervals. The default unit is day. Decimals and negative numbers are also allowed. Particularly, a negative interval syntactically means how long before.

-

31.25

-

1 mons 1 days 06:00:00

-

-365

-

-12 mons -5 days

-

1 years 1 mons 8 days 12:00:00

-

1 years 1 mons 8 days 12:00:00

-

Intervals are in POSTGRES format. They can contain both positive and negative numbers and are case-insensitive. Output is a simplified POSTGRES interval converted from the input.

-

-13 months -10 hours

-

-1 years -25 days -04:00:00

-

-2 YEARS +5 MONTHS 10 DAYS

-

-1 years -6 mons -25 days -06:00:00

-

P-1.1Y10M

-

-3 mons -5 days -06:00:00

-

Intervals are in ISO-8601 format. They can contain both positive and negative numbers and are case-insensitive. Output is a simplified POSTGRES interval converted from the input.

-

-

-12H

-

-12:00:00

-
- -Example: - -``` --- Create a table. -postgres=# CREATE TABLE reltime_type_tab(col1 character(30), col2 reltime); - --- Insert data. -postgres=# INSERT INTO reltime_type_tab VALUES ('90', '90'); -postgres=# INSERT INTO reltime_type_tab VALUES ('-366', '-366'); -postgres=# INSERT INTO reltime_type_tab VALUES ('1975.25', '1975.25'); -postgres=# INSERT INTO reltime_type_tab VALUES ('-2 YEARS +5 MONTHS 10 DAYS', '-2 YEARS +5 MONTHS 10 DAYS'); -postgres=# INSERT INTO reltime_type_tab VALUES ('30 DAYS 12:00:00', '30 DAYS 12:00:00'); -postgres=# INSERT INTO reltime_type_tab VALUES ('P-1.1Y10M', 'P-1.1Y10M'); - --- View data. -postgres=# SELECT * FROM reltime_type_tab; - col1 | col2 ---------------------------------+------------------------------------- - 1975.25 | 5 years 4 mons 29 days - -2 YEARS +5 MONTHS 10 DAYS | -1 years -6 mons -25 days -06:00:00 - P-1.1Y10M | -3 mons -5 days -06:00:00 - -366 | -1 years -18:00:00 - 90 | 3 mons - 30 DAYS 12:00:00 | 1 mon 12:00:00 -(6 rows) - --- Delete the table. -postgres=# DROP TABLE reltime_type_tab; -``` - diff --git a/content/en/docs/installation/Developerguide/dbe_perf-schema.md b/content/en/docs/installation/Developerguide/dbe_perf-schema.md deleted file mode 100644 index 78ded17b3b942cf375e3de43fabf17efc52df007..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dbe_perf-schema.md +++ /dev/null @@ -1,41 +0,0 @@ -# DBE\_PERF Schema - -In the **DBE\_PERF** schema, views are used to diagnose performance issues and are also the data source of WDR snapshots. After the database is installed, only the initial user have permissions for the **DBE\_PERF** schema by default. If the database is upgraded from an earlier version, permissions for the **DBE\_PERF** schema are the same as those of the earlier version to ensure forward compatibility. Organization views are divided based on multiple dimensions, such as OS, instance, and memory. These views comply with the following naming rules: - -- Views starting with **GLOBAL\_**: Request data from database nodes and return the data without processing them. -- Views starting with **SUMMARY\_**: Summarize data in openGauss. In most cases, data from database nodes \(sometimes only the primary database node\) is processed, collected, and returned. -- Views that do not start with **GLOBAL\_** or **SUMMARY\_**: Local views that do not request data from other database nodes. - -- **[OS](os.md)** - -- **[Instance](instance.md)** - -- **[Memory](memory-24.md)** - -- **[File](file.md)** - -- **[Object](object.md)** - -- **[Workload](workload.md)** - -- **[Session/Thread](session-thread.md)** - -- **[Transaction](transaction.md)** - -- **[Query](query.md)** - -- **[Cache/IO](cache-io.md)** - -- **[Utility](utility.md)** - -- **[Lock](lock-25.md)** - -- **[Wait Events](wait-events.md)** - -- **[Configuration](configuration.md)** - -- **[Operator](operator.md)** - -- **[Workload Manager](workload-manager.md)** - - diff --git a/content/en/docs/installation/Developerguide/dcl-syntax-overview.md b/content/en/docs/installation/Developerguide/dcl-syntax-overview.md deleted file mode 100644 index 9aaa6bf41e77e1b999cf2f1d604a5d64db59a7cb..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dcl-syntax-overview.md +++ /dev/null @@ -1,82 +0,0 @@ -# DCL Syntax Overview - -Data control language \(DCL\) is used to create users and roles and set or modify database users or role rights. - -## Defining a Role - -A role is used to manage permissions. For database security, management and operation permissions can be granted to different roles. For details about related SQL statements, see [Table 1](#en-us_topic_0237122051_en-us_topic_0059777960_tf1770f1724d84240998305bfca259f11). - -**Table 1** SQL statements for defining a role - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a role

-

CREATE ROLE

-

Altering role attributes

-

ALTER ROLE

-

Dropping a role

-

DROP ROLE

-
- -## Defining a User - -A user is used to log in to a database. Different permissions can be granted to users for managing data accesses and operations of the users. For details about related SQL statements, see [Table 2](#en-us_topic_0237122051_en-us_topic_0059777960_t52a128d57b274569b95a3b35f6871348). - -**Table 2** SQL statements for defining a user - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a User

-

CREATE USER

-

Altering user attributes

-

ALTER USER

-

Dropping a user

-

DROP USER

-
- -## Granting Rights - -openGauss provides a statement for granting rights to data objects and roles. For details, see [GRANT](en-us_topic_0242370630.md). - -## Revoking Rights - -openGauss provides a statement for revoking rights. For details, see [REVOKE](en-us_topic_0242370643.md). - -## Setting Default Rights - -openGauss allows users to set rights for objects that will be created. For details, see [ALTER DEFAULT PRIVILEGES](en-us_topic_0252797127.md). - -## Shutting Down The Current Node - -openGauss allows users to run the **shutdown** command to shut down the current database node. For details, see [SHUTDOWN](shutdown.md). - diff --git a/content/en/docs/installation/Developerguide/ddl-syntax-overview.md b/content/en/docs/installation/Developerguide/ddl-syntax-overview.md deleted file mode 100644 index 631811c06bea059a6e0612c810e5cd9bcf9c0613..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/ddl-syntax-overview.md +++ /dev/null @@ -1,327 +0,0 @@ -# DDL Syntax Overview - -Data definition language \(DDL\) is used to define or modify an object in a database, such as a table, an index, or a view. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->openGauss does not support DDL when the primary node of the database is incomplete. For example, if the primary node of the database in openGauss is faulty, creating a database or a table will fail. - -## Defining a Database - -A database is the warehouse for organizing, storing, and managing data. Defining a database includes: creating a database, altering the database attributes, and dropping the database. For details about related SQL statements, see [Table 1](#en-us_topic_0237122049_en-us_topic_0059777960_t986073679146430a8bce8bf0ea8f3607). - -**Table 1** SQL statements for defining a database - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a database

-

CREATE DATABASE

-

Altering database attributes

-

ALTER DATABASE

-

Dropping a database

-

DROP DATABASE

-
- -## Defining a Schema - -A schema is the set of a group of database objects and is used to control the access to the database objects. For details about related SQL statements, see [Table 2](#en-us_topic_0237122049_en-us_topic_0059777960_t02977f28a9564837881f110b305d7509). - -**Table 2** SQL statements for defining a schema - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a schema

-

CREATE SCHEMA

-

Altering schema attributes

-

ALTER SCHEMA

-

Dropping a schema

-

DROP SCHEMA

-
- -## Defining a Tablespace - -A tablespace is used to manage data objects and corresponds to a catalog on a disk. For details about related SQL statements, see [Table 3](#en-us_topic_0237122049_en-us_topic_0059777960_t9b028195c0d143f6b8fc7065af1ce2f9). - -**Table 3** SQL statements for defining a tablespace - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a tablespace

-

CREATE TABLESPACE

-

Altering tablespace attributes

-

ALTER TABLESPACE

-

Dropping a tablespace

-

DROP TABLESPACE

-
- -## Defining a Table - -A table is a special data structure in a database and is used to store data objects and relationship between data objects. For details about related SQL statements, see [Table 4](#en-us_topic_0237122049_en-us_topic_0059777960_tcd92dbef720d4b7eaa5bf7a290b98605). - -**Table 4** SQL statements for defining a table - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a table

-

CREATE TABLE

-

Altering table attributes

-

ALTER TABLE

-

Dropping a table

-

DROP TABLE

-
- -## Defining a Partitioned Table - -A partitioned table is a logical table used to improve query performance and does not store data \(data is stored in common tables\). For details about related SQL statements, see [Table 5](#en-us_topic_0237122049_en-us_topic_0059777960_t3ec179079c524dbaae801012f990a692). - -**Table 5** SQL statements for defining a partitioned table - - - - - - - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a partitioned table

-

CREATE TABLE PARTITION

-

Creating a partition

-

ALTER TABLE PARTITION

-

Altering partitioned table attributes

-

ALTER TABLE PARTITION

-

Deleting a partition

-

ALTER TABLE PARTITION

-

Dropping a partitioned table

-

DROP TABLE

-
- -## Defining an Index - -An index indicates the sequence of values in one or more columns in a database table. It is a data structure that improves the speed of data access to specific information in a database table. For details about related SQL statements, see [Table 6](#en-us_topic_0237122049_en-us_topic_0059777960_te79920e4b7b849b7a64fb71029436d48). - -**Table 6** SQL statements for defining an index - - - - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating an index

-

CREATE INDEX

-

Altering index attributes

-

ALTER INDEX

-

Dropping an index

-

DROP INDEX

-

Rebuilding an index

-

REINDEX

-
- -## Defining a Stored Procedure - -A stored procedure is a set of SQL statements for achieving specific functions and is stored in the database after compiling. Users can specify a name and provide parameters \(if necessary\) to execute the stored procedure. For details about related SQL statements, see [Table 7](#en-us_topic_0237122049_en-us_topic_0059777960_t0116270962694804b50796a5d6824f3b). - -**Table 7** SQL statements for defining a stored procedure - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a stored procedure

-

CREATE PROCEDURE

-

Dropping a stored procedure

-

DROP PROCEDURE

-
- -## Defining a Function - -In openGauss, a function is similar to a stored procedure, which is a set of SQL statements. The function and stored procedure are used the same. For details about related SQL statements, see [Table 8](#en-us_topic_0237122049_en-us_topic_0059777960_tde31d523c25742e2aecc5ae8a17d561b). - -**Table 8** SQL statements for defining a function - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a function

-

CREATE FUNCTION

-

Altering function attributes

-

ALTER FUNCTION

-

Dropping a function

-

DROP FUNCTION

-
- -## Defining a View - -A view is a virtual table exported from one or more basic tables. It is used to control data accesses of users. [Table 9](#en-us_topic_0237122049_en-us_topic_0059777960_td65563e06b1c491892dbad9b57f3b96d) lists the related SQL statements. - -**Table 9** SQL statements for defining a view - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a view

-

CREATE VIEW

-

Dropping a view

-

DROP VIEW

-
- -## Defining a Cursor - -To process SQL statements, the stored procedure process assigns a memory segment to store context association. Cursors are handles or pointers pointing to context regions. With a cursor, the stored procedure can control alterations in context areas. For details, see [Table 10](#en-us_topic_0237122049_en-us_topic_0059777960_t191f977ebe0a4ab5b1348c888403e3b4). - -**Table 10** SQL statements for defining a cursor - - - - - - - - - - - - - - - - - - - -

Description

-

SQL Statement

-

Creating a cursor

-

CURSOR

-

Moving a cursor

-

MOVE

-

Fetching data from a cursor

-

FETCH

-

Closing a cursor

-

CLOSE

-
- diff --git a/content/en/docs/installation/Developerguide/deallocate.md b/content/en/docs/installation/Developerguide/deallocate.md deleted file mode 100644 index ad0249b17093782442f5c0706d753598c4604947..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/deallocate.md +++ /dev/null @@ -1,33 +0,0 @@ -# DEALLOCATE - -## Function - -**DEALLOCATE** deallocates a previously prepared statement. If you do not explicitly deallocate a prepared statement, it is deallocated when the session ends. - -The **PREPARE** keyword is always ignored. - -## Precautions - -None - -## Syntax - -``` -DEALLOCATE [ PREPARE ] { name | ALL }; -``` - -## Parameter Description - -- **name** - - Specifies the name of the prepared statement to be deallocated. - -- **ALL** - - Deallocates all prepared statements. - - -## Examples - -None - diff --git a/content/en/docs/installation/Developerguide/debugging.md b/content/en/docs/installation/Developerguide/debugging.md deleted file mode 100644 index 6a32bcfa42b0889b901ad73fd9bbf099ed05d1f8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/debugging.md +++ /dev/null @@ -1,122 +0,0 @@ -# Debugging - -## Syntax - -RAISE has the following five syntax formats: - -**Figure 1** raise\_format::= -![](figures/raise_format.png "raise_format") - -**Figure 2** raise\_condition::= -![](figures/raise_condition.png "raise_condition") - -**Figure 3** raise\_sqlstate::= -![](figures/raise_sqlstate.png "raise_sqlstate") - -**Figure 4** raise\_option::= -![](figures/raise_option.png "raise_option") - -**Figure 5** raise::= -![](figures/raise.png "raise") - -**Parameter description**: - -- The level option is used to specify the error level, that is, **DEBUG**, **LOG**, **INFO**, **NOTICE**, **WARNING**, or **EXCEPTION** \(default\). **EXCEPTION** throws an error that normally terminates the current transaction and the others only generate information at their levels. The [log\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a) and [client\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_s2955da1f1cb24b0aa68ddc77700233e0) parameters control whether the error messages of specific levels are reported to the client and are written to the server log. -- **format**: specifies the error message text to be reported, a format string. The format string can be appended with an expression for insertion to the message text. In a format string, **%** is replaced by the parameter value attached to format and **%%** is used to print **%**. For example: - - ``` - --v_job_id replaces % in the string. - RAISE NOTICE 'Calling cs_create_job(%)',v_job_id; - ``` - -- **option = expression**: inserts additional information to an error report. The keyword option can be **MESSAGE**, **DETAIL**, **HINT**, or **ERRCODE**, and each expression can be any string. - - **MESSAGE**: specifies the error message text. This option cannot be used in a **RAISE** statement that contains a format character string in front of **USING**. - - **DETAIL**: specifies detailed information of an error. - - **HINT**: prints hint information. - - **ERRCODE**: designates an error code \(SQLSTATE\) to a report. A condition name or a five-character SQLSTATE error code can be used. - -- **condition\_name**: specifies the condition name corresponding to the error code. -- **sqlstate**: specifies the error code. - -If neither a condition name nor an **SQLSTATE** is designated in a **RAISE EXCEPTION** command, the **RAISE EXCEPTION \(P0001\)** is used by default. If no message text is designated, the condition name or SQLSTATE is used as the message text by default. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If the **SQLSTATE** designates an error code, the error code is not limited to a defined error code. It can be any error code containing five digits or ASCII uppercase rather than **00000**. Do not use an error code ended with three zeros because this kind of error codes are type codes and can be captured by the whole category. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->The syntax described in [Figure 5](#en-us_topic_0237122256_en-us_topic_0059777683_f6b9d7253ecad413e9ee92ba78199a6b4) does not append any parameter. This form is used only for the **EXCEPTION** statement in a **BEGIN** block so that the error can be re-processed. - -## Example - -Display error and hint information when a transaction terminates: - -``` -CREATE OR REPLACE PROCEDURE proc_raise1(user_id in integer) -AS -BEGIN -RAISE EXCEPTION 'Noexistence ID --> %',user_id USING HINT = 'Please check your user ID'; -END; -/ - -call proc_raise1(300011); - --- Execution result: -ERROR: Noexistence ID --> 300011 -HINT: Please check your user ID -``` - -Two methods are available for setting **SQLSTATE**: - -``` -CREATE OR REPLACE PROCEDURE proc_raise2(user_id in integer) -AS -BEGIN -RAISE 'Duplicate user ID: %',user_id USING ERRCODE = 'unique_violation'; -END; -/ - -\set VERBOSITY verbose -call proc_raise2(300011); - --- Execution result: -ERROR: Duplicate user ID: 300011 -SQLSTATE: 23505 -LOCATION: exec_stmt_raise, pl_exec.cpp:3482 -``` - -If the main parameter is a condition name or **SQLSTATE**, the following applies: - -RAISE division\_by\_zero; - -RAISE SQLSTATE '22012'; - -For example: - -``` -CREATE OR REPLACE PROCEDURE division(div in integer, dividend in integer) -AS -DECLARE -res int; - BEGIN - IF dividend=0 THEN - RAISE division_by_zero; - RETURN; - ELSE - res := div/dividend; - RAISE INFO 'division result: %', res; - RETURN; - END IF; - END; -/ -call division(3,0); - --- Execution result: -ERROR: division_by_zero -``` - -Alternatively: - -``` -RAISE unique_violation USING MESSAGE = 'Duplicate user ID: ' || user_id; -``` - diff --git a/content/en/docs/installation/Developerguide/declare-syntax.md b/content/en/docs/installation/Developerguide/declare-syntax.md deleted file mode 100644 index c04c3544ce1afdca7a0d9e0a9a829cc6f78c9a35..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/declare-syntax.md +++ /dev/null @@ -1,9 +0,0 @@ -# DECLARE Syntax - -- **[Basic Structure](basic-structure.md)** - -- **[Anonymous Blocks](anonymous-blocks.md)** - -- **[Subprogram](subprogram.md)** - - diff --git a/content/en/docs/installation/Developerguide/declare.md b/content/en/docs/installation/Developerguide/declare.md deleted file mode 100644 index bb1f614ada8847e2864f47ab5fb7409ce6795408..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/declare.md +++ /dev/null @@ -1,91 +0,0 @@ -# DECLARE - -## Function - -**DECLARE** defines a cursor to retrieve a small number of rows at a time out of a larger query and can be the start of an anonymous block. - -This section describes usage of cursors. The usage of anonymous blocks is available in [BEGIN](begin.md). - -To process SQL statements, the stored procedure process assigns a memory segment to store context association. Cursors are handles or pointers pointing to context regions. With cursors, stored procedures can control alterations in context regions. - -Generally, **CURSOR** and **SELECT** both have text returns. Since data is stored in binary format in the system, the system needs to convert the data from the binary format to the text format. If data is returned in text format, client applications need to convert the data back to the binary format for processing. **FETCH** implements conversion between binary data and text data. - -## Precautions - -- **CURSOR** is used only in transaction blocks. -- Binary cursors should be used carefully. Text usually occupies larger space than binary data. A binary cursor returns internal binary data, which is easier to operate. A text cursor returns text, which is easier to retrieve and therefore reduces workload on the client. As an example, if a query returns a value of one from an integer column, you would get a string of 1 with a default cursor, whereas with a binary cursor you would get a 4-byte field containing the internal representation of the value \(in big-endian byte order\). - -## Syntax - -- Define a cursor. - - ``` - DECLARE cursor_name [ BINARY ] [ NO SCROLL ] - CURSOR [ { WITH | WITHOUT } HOLD ] FOR query ; - ``` - -- Enable an anonymous block. - - ``` - [DECLARE [declare_statements]] - BEGIN - execution_statements - END; - / - ``` - - -## Parameter Description - -- **cursor\_name** - - Specifies the name of the cursor to be created. - - Value range: a string. It must comply with the naming convention. - -- **BINARY** - - Causes the cursor to return data in binary rather than in text format. - -- **NO SCROLL** - - Specifies how the cursor retrieves rows. - - - **NO SCROLL**: specifies that the cursor cannot be used to retrieve rows in a nonsequential fashion. - - Unspecified: Based on the query's execution plan, the system automatically determines whether the cursor can be used to retrieve rows in a nonsequential fashion. - -- **WITH HOLD** - - **WITHOUT HOLD** - - Specifies whether the cursor can continue to be used after the transaction that created it successfully commits. - - - **WITH HOLD**: The cursor can continue to be used after the transaction that created it successfully commits. - - **WITHOUT HOLD**: The cursor cannot be used outside of the transaction that created it. - - If neither **WITH HOLD** nor **WITHOUT HOLD** is specified, the default is **WITHOUT HOLD**. - -- **query** - - Uses a **SELECT** or **VALUES** clause to specify the rows to be returned by the cursor. - - Value range: **SELECT** or **VALUES** clause - -- **declare\_statements** - - Declares a variable, including its name and type, for example, **sales\_cnt int**. - -- **execution\_statements** - - Specifies the statement to be executed in an anonymous block. - - Value range: an existing function name - - -## Examples - -For details about how to define a cursor, see [Examples](fetch.md#en-us_topic_0237122165_en-us_topic_0059778422_s1ee72832a27547e4949061a010e24578) in **FETCH**. - -## Helpful Links - -[BEGIN](begin.md) and [FETCH](fetch.md) - diff --git a/content/en/docs/installation/Developerguide/deep-copy.md b/content/en/docs/installation/Developerguide/deep-copy.md deleted file mode 100644 index 80ba612d494bcb74e15a8bfbe2a9643fd0c1f5c4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/deep-copy.md +++ /dev/null @@ -1,13 +0,0 @@ -# Deep Copy - -After data is imported, you can perform a deep copy to modify a partition key, change a row-store table to a column-store table, or add a partial cluster key. A deep copy re-creates a table and batch inserts data into the table. - -openGauss provides three deep copy methods. - -- **[Performing a Deep Copy by Using the CREATE TABLE Statement](performing-a-deep-copy-by-using-the-create-table-statement.md)** - -- **[Performing a Deep Copy by Using the CREATE TABLE LIKE Statement](performing-a-deep-copy-by-using-the-create-table-like-statement.md)** - -- **[Performing a Deep Copy by Creating a Temporary Table and Truncating the Original Table](performing-a-deep-copy-by-creating-a-temporary-table-and-truncating-the-original-table.md)** - - diff --git a/content/en/docs/installation/Developerguide/default-permission-mechanism.md b/content/en/docs/installation/Developerguide/default-permission-mechanism.md deleted file mode 100644 index f581e7c44233bf6b957187b4fdc33147f6bbb5ae..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/default-permission-mechanism.md +++ /dev/null @@ -1,14 +0,0 @@ -# Default Permission Mechanism - -A user who creates an object is the owner of this object. By default, [Separation of Duties](separation-of-duties.md) is disabled after openGauss installation. A database system administrator has the same permissions as object owners. After an object is created, only the object owner or system administrator can query, modify, and delete the object, and grant permissions for the object to other users through [GRANT](grant.md) by default. - -To enable another user to use the object, grant required permissions to the user or the role that contains the user. - -openGauss supports the following permissions: **SELECT**, **INSERT**, **UPDATE**, **DELETE**, **TRUNCATE**, **REFERENCES**, **CREATE**, **CONNECT**, **EXECUTE**, and **USAGE**. Permission types are associated with object types. For permission details, see [GRANT](grant.md). - -To remove permissions, run **[REVOKE](revoke.md)**. Object owner permissions such as **ALTER**, **DROP**, **GRANT**, and **REVOKE** are implicit and cannot be granted or revoked. That is, you have the implicit permissions for an object if you are the owner of the object. Object owners can remove their own common permissions, for example, making tables read-only to themselves or others，Except system administrators. - -System catalogs and views are visible to either system administrators or all users. System catalogs and views that require system administrator permissions can be queried only by system administrators. For details, see [System Catalogs and System Views](system-catalogs-and-system-views.md). - -The database provides the object isolation feature. If this feature is enabled, users can view only the objects \(tables, views, columns, and functions\) that they have the permission to access. System administrators are not affected by this feature. For details, see [ALTER DATABASE](alter-database.md). - diff --git a/content/en/docs/installation/Developerguide/default-settings-of-client-connection.md b/content/en/docs/installation/Developerguide/default-settings-of-client-connection.md deleted file mode 100644 index 40e6ec7e2ca9347d3450b66476f6d684429978d0..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/default-settings-of-client-connection.md +++ /dev/null @@ -1,9 +0,0 @@ -# Default Settings of Client Connection - -- **[Statement Behavior](statement-behavior.md)** - -- **[Zone and Formatting](zone-and-formatting.md)** - -- **[Other Default Parameters](other-default-parameters.md)** - - diff --git a/content/en/docs/installation/Developerguide/define-variable.md b/content/en/docs/installation/Developerguide/define-variable.md deleted file mode 100644 index 0853484881855f5462a29ab7a21166d45d9315ba..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/define-variable.md +++ /dev/null @@ -1,56 +0,0 @@ -# Define Variable - -This section describes the declaration of variables in the PL/SQL and the scope of this variable in codes. - -## Variable Declaration - -For details about the variable declaration syntax, see [Figure 1](#en-us_topic_0237122221_en-us_topic_0059777427_f6cc941e0c136457aade3860fc682cbbc). - -**Figure 1** declare\_variable::= -![](figures/declare_variable.png "declare_variable") - -The above syntax diagram is explained as follows: - -- **variable\_name** indicates the name of a variable. -- **type** indicates the type of a variable. -- **value** indicates the initial value of the variable. \(If the initial value is not given, NULL is taken as the initial value.\) **value** can also be an expression. - -**Examples** - -``` -postgres=# DECLARE - emp_id INTEGER := 7788; -- Define a variable and assign a value to it. -BEGIN - emp_id := 5*7784; -- Assign a value to the variable. -END; -/ -``` - -In addition to the declaration of basic variable types, **%TYPE** and **%ROWTYPE** can be used to declare variables related to table columns or table structures. - -**%TYPE Attribute** - -**%TYPE** declares a variable to be of the same data type as a previously declared variable \(for example, a column in a table\). For example, if you want to define a _my\_name_ variable whose data type is the same as the data type of the **firstname** column in the **employee** table, you can define the variable as follows: - -``` -my_name employee.firstname%TYPE -``` - -In this way, you can declare _my\_name_ without the need of knowing the data type of **firstname** in **employee**, and the data type of _my\_name_ can be automatically updated when the data type of **firstname** changes. - -**%ROWTYPE Attribute** - -**%ROWTYPE** declares data types of a set of data. It stores a row of table data or results fetched from a cursor. For example, if you want to define a set of data with the same column names and column data types as the **employee** table, you can define the data as follows: - -``` -my_employee employee%ROWTYPE -``` - -## Scope of a Variable - -The scope of a variable indicates the accessibility and availability of the variable in code block. In other words, a variable takes effect only within its scope. - -- To define a function scope, a variable must declare and create a **BEGIN-END** block in the declaration section. The necessity of such declaration is also determined by block structure, which requires that a variable has different scopes and lifetime during a process. -- A variable can be defined multiple times in different scopes, and inner definition can cover outer one. -- A variable defined in an outer block can also be used in a nested block. However, the outer block cannot access variables in the nested block. - diff --git a/content/en/docs/installation/Developerguide/delete.md b/content/en/docs/installation/Developerguide/delete.md deleted file mode 100644 index 0515144f6d659d931961eac9594698132145fbe3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/delete.md +++ /dev/null @@ -1,106 +0,0 @@ -# DELETE - -## Function - -**DELETE** deletes rows that satisfy the **WHERE** clause from the specified table. If the **WHERE** clause is absent, the effect is to delete all rows in the table. The result is a valid, but an empty table. - -## Precautions - -- You must have the **DELETE** permission on the table to delete from it, as well as the **SELECT** permission for any table in the **USING** clause or whose values are read in the **condition**. -- For row-store tables, the **DELETE** operation can be used only when they have primary key constraints. -- For column-store tables, the **RETURNING** clause is currently not supported. - -## Syntax - -``` -[ WITH [ RECURSIVE ] with_query [, ...] ] -DELETE FROM [ ONLY ] table_name [ * ] [ [ AS ] alias ] - [ USING using_list ] - [ WHERE condition | WHERE CURRENT OF cursor_name ] - [ RETURNING { * | { output_expr [ [ AS ] output_name ] } [, ...] } ]; -``` - -## Parameter Description - -- **WITH \[ RECURSIVE \] with\_query \[, ...\]** - - Specifies one or more subqueries that can be referenced by name in the main query, which is equivalent to a temporary table. - - If **RECURSIVE** is specified, it allows a **SELECT** subquery to reference itself by name. - - Format of **with\_query**: - - with\_query\_name \[ \( column\_name \[, ...\] \) \] AS - - \( \{select | values | insert | update | delete\} \) - - -- **with\_query\_name** specifies the name of the result set generated by a subquery. Such names can be used to access the subquery - - result set. - - – **column\_name** specifies the column name displayed in the subquery result set. - - – Each subquery can be a **SELECT**, **VALUES**, **INSERT**, **UPDATE** or **DELETE** statement. - -- **ONLY** - - If **ONLY** is specified before the table name, matching rows are deleted from the named table only. If **ONLY** is not specified, matching rows are also deleted from any tables inheriting from the named table. - -- **table\_name** - - Specifies the name \(optionally schema-qualified\) of the target table. - - Value range: an existing table name - -- **alias** - - Specifies a substitute name for the target table. - - Value range: a string. It must comply with the naming convention rule. - -- **using\_list** - - Specifies the **USING** clause. - -- **condition** - - Specifies an expression that returns a Boolean value. Only rows for which this expression returns **true** will be deleted. - -- **WHERE CURRENT OF cursor\_name** - - This parameter is reserved. - -- **output\_expr** - - Specifies an expression to be computed and returned by the **DELETE** statement after each row is deleted. The expression can use any column names of the table. Write **\*** to return all columns. - -- **output\_name** - - Specifies a name to use for a returned column. - - Value range: a string. It must comply with the naming convention rule. - - -## Examples - -``` --- Create the tpcds.customer_address_bak table. -postgres=# CREATE TABLE tpcds.customer_address_bak AS TABLE tpcds.customer_address; - --- Delete employees whose ca_address_sk is smaller than 14888 from the tpcds.customer_address_bak table. -postgres=# DELETE FROM tpcds.customer_address_bak WHERE ca_address_sk < 14888; - --- Delete all data from the tpcds.customer_address_bak table. -postgres=# DELETE FROM tpcds.customer_address_bak; - -Delete the tpcds.customer_address_bak table. -postgres=# DROP TABLE tpcds.customer_address_bak; -``` - -## Suggestions - -- delete - - To delete all records in a table, use the **truncate** syntax. - - diff --git a/content/en/docs/installation/Developerguide/deleting-data-from-a-table.md b/content/en/docs/installation/Developerguide/deleting-data-from-a-table.md deleted file mode 100644 index adcb96e88e68b83b0dbb9d6404a4139bc75ed33c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/deleting-data-from-a-table.md +++ /dev/null @@ -1,32 +0,0 @@ -# Deleting Data from a Table - -Outdated data may need to be deleted when tables are used. Data can be deleted from tables only by row. - -SQL statements can only access and delete an independent row by declaring conditions that match the row. If a table has a primary key, you can use it to specify a row. You can delete several rows that match the specified condition or delete all the rows from a table. - -For example, to delete all the rows whose **c\_customer\_sk** column is **3869** from the table **customer\_t1**, run the following command: - -``` -DELETE FROM customer_t1 WHERE c_customer_sk = 3869; -``` - -To delete all rows from the table, run either of the following commands: - -``` -DELETE FROM customer_t1; -``` - -``` -or, -TRUNCATE TABLE customer_t1; -``` - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If you need to delete an entire table, you are advised to use the **TRUNCATE** statement rather than **DELETE**. - -To delete a table, run the following command: - -``` -DROP TABLE customer_t1; -``` - diff --git a/content/en/docs/installation/Developerguide/description.md b/content/en/docs/installation/Developerguide/description.md deleted file mode 100644 index 2782bc39d0bd55ace03cf38f154526e442e3baf4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/description.md +++ /dev/null @@ -1,99 +0,0 @@ -# Description - -As described in [Overview](overview-16.md), **EXPLAIN** displays the execution plan, but will not actually run SQL statements. **EXPLAIN ANALYZE** and **EXPLAIN PERFORMANCE** both will actually run SQL statements and return the execution information. This section describes the execution plan and execution information in detail. - -## Execution Plans - -The following SQL statement is used as an example: - -``` -SELECT * FROM t1, t2 WHERE t1.c1 = t2.c2; -``` - -Run the **EXPLAIN** command and the output is as follows: - -![](figures/en-us_image_0252663634.png) - -**Interpretation of the execution plan level \(vertical\)**: - -1. Layer 1: **Seq Scan on t2** - - The table scan operator scans the table **t2** using **Seq Scan**. At this layer, data in the table **t2** is read from a buffer or disk, and then transferred to the upper-layer node for calculation. - -2. Layer 2: **Hash** - - Hash operator. It is used to calculate the hash value of the operator transferred from the lower layer for subsequent hash join operations. - -3. Layer 3: **Seq Scan on t1** - - The table scan operator scans the table **t1** using **Seq Scan**. At this layer, data in the table **t1** is read from a buffer or disk, and then transferred to the upper-layer node for hash join calculation. - -4. Layer 4: **Hash Join** - - Join operator. It is used to join data in the **t1** and **t2** tables using the hash join method and output the result data. - - -**Keywords in the execution plan**: - -1. Table access modes - - Seq Scan - - Scans all rows of the table in sequence. - - - Index Scan - - The optimizer uses a two-step plan: the child plan node visits an index to find the locations of rows matching the index condition, and then the upper plan node actually fetches those rows from the table itself. Fetching rows separately is much more expensive than reading them sequentially, but because not all pages of the table have to be visited, this is still cheaper than a sequential scan. The upper-layer planning node sorts index-identified rows based on their physical locations before reading them. This minimizes the independent capturing overhead. - - If there are separate indexes on multiple columns referenced in **WHERE**, the optimizer might choose to use an **AND** or **OR** combination of the indexes. However, this requires the visiting of both indexes, so it is not necessarily a win compared to using just one index and treating the other condition as a filter. - - The following Index scans featured with different sorting mechanisms are involved: - - - Bitmap Index Scan - - Fetches data pages using a bitmap. - - - Index Scan using index\_name - - Fetches table rows in index order, which makes them even more expensive to read. However, there are so few rows that the extra cost of sorting the row locations is unnecessary. This plan type is used mainly for queries fetching just a single row and queries having an **ORDER BY** condition that matches the index order, because no extra sorting step is needed to satisfy **ORDER BY**. - - -2. Table connection modes - - Nested Loop - - A nested loop is used for queries that have a smaller data set connected. In a nested loop join, the foreign table drives the internal table and each row returned from the foreign table should have a matching row in the internal table. The returned result set of all queries should be less than 10,000. The table that returns a smaller subset will work as a foreign table, and indexes are recommended for connection columns of the internal table. - - - \(Sonic\) Hash Join - - A hash join is used for large tables. The optimizer uses a hash join, in which rows of one table are entered into an in-memory hash table, after which the other table is scanned and the hash table is probed for matches to each row. Sonic and non-Sonic hash joins differ in their hash table structures, which do not affect the execution result set. - - - Merge Join - - In most cases, the execution performance of a merge join is lower than that of a hash join. However, if the source data has been pre-sorted and no more sorting is needed during the merge join, its performance excels. - -3. Operators - - sort - - Sorts the result set. - - - filter - - The **EXPLAIN** output shows the **WHERE** clause being applied as a **Filter** condition attached to the **Seq Scan** plan node. This means that the plan node checks the condition for each row it scans, and returns only the ones that meet the condition. The estimated number of output rows has been reduced because of the **WHERE** clause. However, the scan will still have to visit all 10,000 rows, as a result, the cost is not decreased. It increases a bit \(by 10,000 x **cpu\_operator\_cost**\) to reflect the extra CPU time spent on checking the **WHERE** condition. - - - LIMIT - - Limits the number of output execution results. If a **LIMIT** condition is added, not all rows are retrieved. - - - -## Execution Information - -The following SQL statement is used as an example: - -``` -select sum(t2.c1) from t1,t2 where t1.c1=t2.c2 group by t1.c2; -``` - -The output of running **EXPLAIN PERFORMANCE** is as follows: - -![](figures/en-us_image_0252660975.png) - diff --git a/content/en/docs/installation/Developerguide/design.md b/content/en/docs/installation/Developerguide/design.md deleted file mode 100644 index 0927c2cdda356d7f4fd82a9413f53fa1d7ff91f0..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/design.md +++ /dev/null @@ -1,18 +0,0 @@ -# Design - -The key organizing principle is to eliminate unnecessary contention by reducing writes to shared memory. This variant of OCC achieves serializability, even after recovery, using CSN or periodically-updated epochs; epoch boundaries form natural serialization points. Epochs also help make garbage collection efficient and enable snapshot transactions. Several design choices, such as transaction ID design, record overwriting, and range query support, simplify and speed up transaction execution further, and the decentralized durability subsystem also avoids contention. - -SILO key technologies when running a transaction ‒ - -Transaction Private Memory for lock-less reads and writes, short locks only at commit. - -Very Low Contention. - -Low Latency. NUMA-aware local memory. - -Optimistic CC ‒ Minimal data locks, Low Contention. - -Auto-Vacuum with No Locks, No Overhead. - -Masstree implementation of Btree – extremely optimized - diff --git a/content/en/docs/installation/Developerguide/determining-the-scope-of-performance-tuning.md b/content/en/docs/installation/Developerguide/determining-the-scope-of-performance-tuning.md deleted file mode 100644 index dbda7cdeff672a6f619dc36d867920f94dcac345..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/determining-the-scope-of-performance-tuning.md +++ /dev/null @@ -1,46 +0,0 @@ -# Determining the Scope of Performance Tuning - -Database performance tuning often happens when users are not satisfied with the service execution efficiency and want to improve the efficiency. The database performance is affected by many factors as described in section [Performance Elements](#en-us_topic_0237121484_en-us_topic_0073259659_en-us_topic_0040046511_section218827915473). Therefore, performance tuning is a complex process and sometimes cannot be systematically described or explained. It depends more on the database administrator's experience. However, this section still attempts to illustrate the performance tuning methods that can be referred to by application development personnel and new openGauss database administrators. - -## Performance Elements - -There are multiple performance factors that affect the database performance. Knowing these factors can help you identify and analyze performance-associated issues. - -- System resources - - Database performance greatly relies on disk I/O and memory usage. To accurately set performance counters, you need to have a knowledge of the basic performance of the hardware deployed in openGauss. Performance of hardware, such as the CPU, hard disk, disk controller, memory, and network interfaces, greatly affects database running speed. - -- Load - - The load indicates the total database system demands and it changes over time. The overall load contains user queries, applications, concurrent jobs, transactions, and system commands transferred at any time. For example, the system load increases if multiple users are executing multiple queries. The load will significantly affect the database performance. Identifying load peak hours helps improve resource utilization so that tasks are executed effectively. - -- Throughput - - The data processing capability of a database is defined by its throughput. Database throughput is measured by the number of queries or processed transactions per second or by the average response time. The database processing capacity is closely related to the underlying system performance \(disk I/O, CPU speed, and storage bandwidth\). You need to know about the hardware performance before setting a target throughput. - -- Competition - - Competition indicates that two or more load components try to use system resources in a conflicting way. For example, competition occurs when multiple queries attempt to update the same data at the same time, or when a large number of loads compete for system resources. When competition increases, the throughput decreases. - -- Optimization - - The database optimization can affect the performance of the whole system. Before executing the SQL statements, configuring database parameters, designing tables, and performing data distribution, enable the database query optimizer can help you obtain the most efficient execution plan. - - -## Determining the Tuning Scope - -Performance tuning depends on the usage of hardware resources, such as the CPU, memory, I/O, and network of each node in openGauss. Check whether these resources are fully utilized, and whether any bottlenecks exist, and then perform performance tuning as required. - -- If a resource reaches the bottleneck: - 1. Check whether the key OS parameters and database parameters are properly set and perform [System Optimization](system-optimization.md). - 2. Find the resource consuming SQL statements by querying the most time-consuming SQL statements and unresponsive SQL statements, and then perform [SQL Optimization](sql-optimization.md). - -- If no resource reaches the bottleneck, the system performance can be improved. In this case, query the most time-consuming SQL statements and the unresponsive SQL statements, and then perform [SQL Optimization](sql-optimization.md) as required. - -- **[Analyzing Hardware Bottlenecks](analyzing-hardware-bottlenecks.md)** -The CPU, memory, I/O, and network resource usage of each node in openGauss are obtained to check whether these resources are fully used and whether any bottleneck exists. -- **[Querying SQL Statements That Affect Performance Most](querying-sql-statements-that-affect-performance-most.md)** - -- **[Checking Blocked Statements](checking-blocked-statements.md)** - - diff --git a/content/en/docs/installation/Developerguide/developer-options.md b/content/en/docs/installation/Developerguide/developer-options.md deleted file mode 100644 index 89ea2ed0d0293e0b49570657e1415a7813fde82d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/developer-options.md +++ /dev/null @@ -1,662 +0,0 @@ -# Developer Options - -## allow\_system\_table\_mods - -**Parameter description**: Specifies whether the structures of system tables can be modified. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the structures of system tables can be modified. -- **off** indicates that the structures of system tables cannot be modified. - -**Default value**: **off** - -## debug\_assertions - -**Parameter description:** Specifies whether to enable various assertion checks. This parameter assists in debugging. If you are experiencing strange problems or crashes, set this parameter to **on** to identify programming defects. To use this parameter, the macro USE\_ASSERT\_CHECKING must be defined \(through the configure option **--enable-cassert**\) during the openGauss compilation. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that various assertion checks are enabled. -- **off** indicates that various assertion checks are disabled. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->This parameter is set to **on** by default if openGauss is compiled with various assertion checks enabled. - -**Default value**: **off** - -## ignore\_checksum\_failure - -**Parameter description**: Specifies whether to ignore check failures \(but still generates an alarm\) and continues reading data. Continuing reading data may result in breakdown, damaged data being transferred or hidden, failure of data recovery from remote nodes, or other serious problems. You are not advised to modify the settings. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that data check errors are ignored. -- **off** indicates that data check errors are reported. - -**Default value**: **off** - -## enable\_force\_vector\_engine - -**Parameter description:** Specifies whether to forcibly generate vectorized execution plans for a vectorized execution operator if the operator's child node is a non-vectorized operator. When this parameter is set to **on**, vectorized execution plans are forcibly generated. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -**Default value**: **off** - -## explain\_dna\_file - -**Parameter description:** Sets [explain\_perf\_mode](#en-us_topic_0237124743_en-us_topic_0059778871_s05e1286701bc4b8d9e1c0c9aecae3a0e) to **run** to export object files in CSV format. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->The value of this parameter must be an absolute path plus a file name with the extension **.csv**. - -**Value range**: a string - -**Default value**: empty - -## explain\_perf\_mode - -**Parameter description:** Specifies the display format of the **explain** command. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range:** **normal**, **pretty**, **summary**, and **run** - -- **normal** indicates that the default printing format is used. -- **pretty** indicates a new format improved by using openGauss. A new format contains a plan node ID, directly and effectively analyzing performance. -- **summary** indicates that the analysis result on this information is printed in addition to the printed information in the format specified by **pretty**. -- **run** indicates that in addition to the printed information specified by **summary**, the database exports the information as a CSV file. - -**Default value**: **pretty** - -## ignore\_system\_indexes - -**Parameter description:** specifies whether to ignore system indexes when reading system tables \(but still update the indexes when modifying the tables\). - -This parameter is a BACKEND parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->This parameter is useful for recovering data from tables whose system indexes are damaged. - -**Value range**: Boolean - -- **on** indicates that system indexes are ignored. -- **off** indicates that system indexes are not ignored. - -**Default value**: **off** - -## post\_auth\_delay - -**Parameter description:** Specifies the delay in the connection to the server after a successful authentication. Developers can attach a debugger to the server startup process. - -This parameter is a BACKEND parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 2147. The unit is s. - -**Default value**: **0** - -## pre\_auth\_delay - -**Parameter description**: Specifies the period of delaying authentication after the connection to the server is started. Developers can attach a debugger to the authentication procedure. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 60. The unit is s. - -**Default value**: **0** - -## trace\_notify - -**Parameter description:** Specifies whether to generate a large amount of debugging output for the **LISTEN** and **NOTIFY** commands. The level of [client\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_s2955da1f1cb24b0aa68ddc77700233e0) or [log\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a) must be **DEBUG1** or lower to send such output to the client or server logs, respectively. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the function is enabled. -- **off** indicates that the function is disabled. - -**Default value**: **off** - -## trace\_recovery\_messages - -**Parameter description**: Specifies whether to enable logging of recovery-related debugging output. This parameter allows users to overwrite the normal setting of [log\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a), but only for specific messages. This is intended for the use in debugging the standby server. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: enumerated values. Valid values include **debug5**, **debug4**, **debug3**, **debug2**, **debug1**, and **log**. For details about the parameter values, see [log\_min\_messages](logging-time.md#en-us_topic_0237124722_en-us_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a). - -**Default value**: **log** - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->- **log** indicates that recovery-related debugging information will not be logged. ->- Except the default value **log**, each of the other values indicates that recovery-related debugging information at the specified level will also be logged. Common settings of **log\_min\_messages** will unconditionally record information into server logs. - -## trace\_sort - -**Parameter description**: Specifies whether to print information about resource usage during sorting operations. This parameter is available only when the macro TRACE\_SORT is defined during the openGauss compilation. However, TRACE\_SORT is currently defined by default. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the function is enabled. -- **off** indicates that the function is disabled. - -**Default value**: **off** - -## zero\_damaged\_pages - -Parameter description: Specifies whether to detect a damaged page header that causes openGauss to report an error, aborting the current transaction. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -Setting this parameter to **on** causes the system to report a warning, zero out the damaged page, and continue processing. This behavior will destroy data, including all the rows on the damaged page. However, it allows you to bypass the error and retrieve rows from any undamaged pages that may be present in the table. Therefore, it is useful for restoring data if corruption has occurred due to a hardware or software error. In most cases, you are advised not to set this parameter to **on** unless you do not want to restore data from the damaged pages of a table. - -**Default value**: **off** - -## string\_hash\_compatible - -**Parameter description:** specifies whether to use the same method to calculate char-type hash values and varchar- or text-type hash values. Based on the setting of this parameter, you can determine whether a redistribution is required when a distribution column is converted from a char-type data distribution into a varchar- or text-type data distribution. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the same calculation method is used and a redistribution is not required. -- **off** indicates that different calculation methods are used and a redistribution is required. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->Calculation methods differ in the length of input strings used for calculating hash values. \(For a char-type hash value, spaces following a string are not counted as the length. For a text- or varchar-type hash value, the spaces are counted.\) The hash value affects the calculation result of queries. To avoid query errors, do not modify this parameter during database running once it is set. - -**Default value**: **off** - -## cost\_param - -**Parameter description:** Controls use of different estimation methods in specific customer scenarios, allowing estimated values approximating to onsite values. This parameter can control various methods simultaneously by performing AND \(&\) on the bit of each method. A method is selected if the result value is not **0**. - -When **cost\_param & 1** is set to a value other than **0**, an improved mechanism is used for estimating the selection rate of non-equi-joins. This method is more accurate for estimating the selection rate of joins between two identical tables. At present, **cost\_param & 1=0** is not used. That is, a better formula is selected for calculation. - -When **cost\_param & 2** is set to a value other than **0**, the selection rate is estimated based on multiple filter criteria. The lowest selection rate among all filter criteria, but not the product of the selection rates for two tables under a specific filter criterion, is used as the total selection rate. This method is more accurate when a close correlation exists between the columns to be filtered. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range:** an integer ranging from 1 to _INT\_MAX_ - -**Default value**: **0** - -## convert\_string\_to\_digit - -**Parameter description:** Specifies the implicit conversion priority, which determines whether to preferentially convert strings into numbers. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that strings are preferentially converted into numbers. -- **off** indicates that strings are not preferentially converted into numbers. - -**Default value**: **on** - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Modify this parameter only when absolutely necessary because the modification will change the rule for converting internal data types and may cause unexpected results. - -## nls\_timestamp\_format - -**Parameter description:** Specifies the default timestamp format. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -**Default value**: **DD-Mon-YYYY HH:MI:SS.FF AM** - -## remotetype - -**Parameter description**: Specifies the remote connection type. - -This parameter is a BACKEND parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: enumerated values. Valid values are **application**, **datanode**, and **internaltool**. - -**Default value**: **application** - -## enable\_partitionwise - -**Parameter description:** Specifies whether to select an intelligent algorithm for joining partition tables. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that an intelligent algorithm is selected. -- **off** indicates that an intelligent algorithm is not selected. - -**Default value**: **off** - -## max\_function\_args - -**Parameter description**: Specifies the maximum number of parameters allowed for a function. - -This parameter is an INTERNAL parameter. The value of this parameter cannot be modified. - -**Value range**: an integer. - -**Default value**: **666** - -## max\_user\_defined\_exception - -**Parameter description**: Specifies the maximum number of exceptions. The default value cannot be changed. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -Value range: an integer. Currently, only the fixed value **1000** is supported. - -**Default value**: **1000** - -## enable\_debug\_vacuum - -**Parameter description**: Specifies whether to allow output of some VACUUM-related logs for problem locating. This parameter is used only by developers. Common users are advised not to use it. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on/true** indicates that output of VACUUM-related logs is allowed. -- **off/false** indicates that output of VACUUM-related logs is disallowed. - -**Default value**: **off** - -## enable\_global\_stats - -**Parameter description**: Specifies the current statistics collection mode, which can be global statistics collection or single-node statistics collection. By default, the global statistics collection mode is used. If this parameter is set to **off**, the statistics of the first node in the openGauss are collected by default. In this case, the quality of the generated query plan may be affected. However, the information collection performance is optimal. Therefore, exercise caution when disabling this parameter. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** or **true** indicates the global statistics mode. -- **off** or **false** indicates the database node statistics. - -**Default value**: **on** - -## enable\_fast\_numeric - -**Parameter description:** Specifies whether to enable optimization for numeric data calculation. Calculation of numeric data is time-consuming. Numeric data is converted into int64- or int128-type data to improve numeric data calculation performance. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** or **true** indicates that optimization for numeric data calculation is enabled. -- **off** or **false** indicates that optimization for numeric data calculation is disabled. - -**Default value**: **on** - -## rewrite\_rule - -**Parameter description**: Specifies the rewriting rule for enabled optional queries. Some query rewrite rules are optional. Enabling them cannot always improve the query efficiency. In a specific customer scenario, you can set the query rewriting rules through the GUC parameter to achieve optimal query efficiency. - -This parameter can control the combination of query rewriting rules, for example, there are over one override rules: rule1, rule2, rule3, and rule4. To set the parameters, you can perform the following operations: - -``` -set rewrite_rule=rule1; -- Enable query rewriting rule rule1 -set rewrite_rule=rule2, rule3; -- Enable the query rewriting rules rule2 and rule3 -set rewrite_rule=none; -- Disable all optional query rewriting rules -``` - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -- **none**: Does not use any optional query rewriting rules -- **lazyagg**: Uses the Lazy Agg query rewriting rules for eliminating aggregation operations in subqueries. - -**Default value**: **magicset** - -## enable\_compress\_spill - -**Parameter description**: Specifies whether to enable the compression function of writing data to disk. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** or **true** indicates that optimization for writing data to disk is enabled. -- **off** or **false** indicates that optimization for writing data to disk is disabled. - -**Default value**: **on** - -## analysis\_options - -**Parameter description**: Specifies whether to enable function options in the corresponding options to use the corresponding location functions, including data verification and performance statistics. For details, see the options in the value range. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -- **LLVM\_COMPILE** indicates that the codegen compilation time of each thread is displayed on the explain performance page. -- **HASH\_CONFLICT** indicates that the log file in the **pg\_log** directory of the database node process displays the hash table statistics, including the hash table size, hash chain length, and hash conflict information. -- **STREAM\_DATA\_CHECK** indicates that a CRC check is performed on data before and after network data transmission. - -**Default value**: **ALL,on\(\),off\(LLVM\_COMPILE,HASH\_CONFLICT,STREAM\_DATA\_CHECK\)**, which indicates that no location function is enabled. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Use **on\(\)** or** off\(\)** to enable or disable the functions. The function options that are not displayed retain the original values. Format for reference: ->'on\(option1, option2, ...\)' ->'off\(ALL\)' - -## resource\_track\_log - -**Parameter description**: Specifies the log level of self-diagnosis. Currently, this parameter takes effect only in multi-column statistics. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string - -- **summary**: Brief diagnosis information is displayed. -- **detail**: Detailed diagnosis information is displayed. - -Currently, the two parameter values differ only when there is an alarm about multi-column statistics not collected. If the parameter is set to **summary**, such an alarm will not be displayed. If it is set to **detail**, such an alarm will be displayed. - -**Default value**: **summary** - -## udf\_memory\_limit - -**Parameter description**: Controls the maximum physical memory that can be used when each database node executes UDFs. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer. The value range is from 200 x 1024 to _max\_process\_memory_ and the unit is KB. - -**Default value**: **200MB** - -## FencedUDFMemoryLimit - -**Parameter description**: Specifies the virtual memory used by each fenced udf worker process. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Suggestion**: You are not advised to set this parameter. You can set [udf\_memory\_limit](#en-us_topic_0237124743_section1765913299426) instead. - -Value range: an integer ranging from 0 KB to 2147483647 KB. The unit can also be MB or GB. **0** indicates that the memory is not limited. - -**Default value**: **0** - -## UDFWorkerMemHardLimit - -**Parameter description**: Specifies the maximum value of **fencedUDFMemoryLimit**. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Suggestion**: You are not advised to set this parameter. You can set [udf\_memory\_limit](#en-us_topic_0237124743_section1765913299426) instead. - -Value range: an integer ranging from 0KB to 2147483647KB. The unit can also be MB or GB. - -**Default value**: **1GB** - -## pljava\_vmoptions - -**Parameter description**: Specifies the startup parameters for JVMs used by the PL/Java function. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string, supporting: - -- JDK8 JVM startup parameters. For details, see JDK [official ](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html)descriptions. -- JDK8 JVM system attributes \(starting with **–D**, for example, **–Djava.ext.dirs**\). For details, see JDK [official ](https://docs.oracle.com/javase/tutorial/deployment/doingMoreWithRIA/properties.html)descriptions. -- User-defined parameters \(starting with **–D**, for example, **–Duser.defined.option**\). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->If **pljava\_vmoptions** is set to a value beyond the value range, an error will be reported when PL/Java functions are used. For details, see [PL/pgSQL Functions](pl-pgsql-functions.md). - -**Default value**: empty - -## enable\_pbe\_optimization - -**Parameter description**: Specifies whether the optimizer optimizes the query plan for statements executed in Parse Bind Execute \(PBE\) mode. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the optimizer optimizes the query plan. -- **off** indicates that the optimizer does not optimize the execution. - -**Default value**: **on** - -## enable\_light\_proxy - -**Parameter description**: Specifies whether the optimizer optimizes the execution of simple queries on the primary node of the databases. This parameter does not take effect if the character set of the application side does not match that of the kernel side. You are advised to set the character set to UTF8 when creating a database. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the optimizer optimizes the execution of simple queries on the primary node of the databases. -- **off** indicates that the optimizer does not optimize the execution. - -**Default value**: **on** - -## enable\_global\_plancache - -**Parameter description**: Specifies whether to share the cache of the PBE query execution plan. Enabling this function can reduce the memory usage of database nodes in high concurrency scenarios. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the execution plan of the PBE query is shared in the cache. -- **off** indicates that the execution plan of the PBE query is not shared in the cache. - -**Default value**: **off** - -## checkpoint\_flush\_after - -**Parameter description**: Specifies the number of consecutive disk pages that the checkpointer writer thread writes before asynchronous flush. In openGauss, the disk page size is 8 KB. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 256. **0** indicates that the asynchronous flush function is disabled. For example, if the value is **32**, the checkpointer thread continuously writes 32 disk pages \(that is, 32 x 8 = 256 KB\) before asynchronous flush. - -**Default value**: **32** - -## bgwriter\_flush\_after - -**Parameter description**: Specifies the number of consecutive disk pages that the background writer thread writes before asynchronous flush. In openGauss, the disk page size is 8 KB. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 256. **0** indicates that the asynchronous flush function is disabled. The size of a single page is 8 KB. For example, if the value is **64**, the background writer thread continuously writes 64 disk pages \(that is, 64 x 8 = 512 KB\) before asynchronous flush. - -**Default value**: **256KB** \(32 pages\) - -## backend\_flush\_after - -**Parameter description**: Specifies the number of consecutive disk pages that the backend thread writes before asynchronous flush. In openGauss, the disk page size is 8 KB. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 256. **0** indicates that the asynchronous flush function is disabled. The size of a single page is 8 KB. For example, if the value is **64**, the backend thread continuously writes 64 disk pages \(that is, 64 x 8 = 512 KB\) before asynchronous flush. - -**Default value**: **0** - -## enable\_parallel\_ddl - -**Parameter description**: Specifies whether multiple database nodes can concurrently perform DDL operations on the same database object. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on**: DDL operations can be concurrently performed without distributed deadlocks. -- **off**: Distributed deadlocks may occur when DDL operations are concurrently performed. - -**Default value**: **on** - -## show\_acce\_estimate\_detail - -**Parameter description**: The evaluation information is generally used by O&M personnel during maintenance, and it may affect the output display of the **EXPLAIN** statement. Therefore, this parameter is disabled by default. The evaluation information is displayed only if the **verbose** option of the **EXPLAIN** statement is enabled. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the evaluation information is displayed in the output of the **EXPLAIN** statement. -- **off** indicates that the evaluation information is not displayed in the output of the **EXPLAIN** statement. - - -**Default value**: **off** - -## enable\_prevent\_job\_task\_startup - -**Parameter description**: Specifies whether to start the job thread. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the job thread is not started. -- **off** indicates that the job thread is started. - -**Default value**: **off** - -## enable\_early\_free - -**Parameter description**: Specifies whether the operator memory can be released in advance. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the operator memory can be released in advance. -- **off** indicates that the operator memory cannot be released in advance. - -**Default value**: **on** - -## support\_batch\_bind - -**Parameter description**: Specifies whether to batch bind and execute PBE statements through interfaces such as JDBC, ODBC, and Libpq. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that batch binding and execution are used. -- **off** indicates that batch binding and execution are not used. - -**Default value**: **on** - -## check\_implicit\_conversions - -**Parameter description**: Specifies whether to check candidate index paths generated for index columns that have implicit type conversions in a query. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that a check will be performed for candidate index paths generated for index columns that have implicit type conversion in a query. -- **off** indicates that a check will not be performed. - -**Default value**: **off** - -## enable\_thread\_pool - -**Parameter description**: Specifies whether to enable the thread pool function. This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the thread pool function is enabled. -- **off** indicates that the thread pool function is disabled. - -**Default value**: **off** - -## thread\_pool\_attr - -**Parameter description**: Specifies the detailed attributes of the thread pool function. This parameter is valid only when **enable\_thread\_pool** is set to **on**. This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string, consisting of one or more characters. - -This parameter consists of three parts: thread\_num, group\_num, and cpubind\_info. The meanings of the three parts are as follows: - -- **thread\_num** indicates the total number of threads in the thread pool. The value ranges from 0 to 4096. The value **0** indicates that the database automatically configures the number of threads in the thread pool based on the number of CPU cores. If the value is greater than **0**, the number of threads in the thread pool is the same as the value of **thread\_num**. -- **group\_num** indicates the number of thread groups in the thread pool. The value ranges from 0 to 64. The value **0** indicates that the database automatically configures the number of thread groups in the thread pool based on the number of NUMA groups. If the value is greater than **0**, the number of thread groups in the thread pool is the same as the value of **group\_num**. -- **cpubind\_info** indicates whether the thread pool is bound to a core. The available configuration modes are as follows: 1. '\(nobind\)': The thread is not bound to a core. 2. '\(allbind\)': Use all CPU cores that can be queried in the current system to bind threads. 3. '\(nodebind: 1, 2\)': Use the CPU cores in NUMA groups 1 and 2 to bind threads. 4. '\(cpubind: 0-30\)': Use the CPU cores 0 to 30 to bind threads. This parameter is case-insensitive. - -**Default value**: **'16, 2, \(nobind\)'** - -## numa\_distribute\_mode - -**Parameter description**: Specifies the distribution of some shared data and threads among NUMA nodes. This parameter is used to optimize the performance of large-scale ARM servers with multiple NUMA nodes. Generally, you do not need to set this parameter. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: a string. The valid values are **none** and **all**. - -- **none** indicates that this function is disabled. -- **all** indicates that some shared data and threads are distributed to different NUMA nodes to reduce the number of remote access times and improve performance. Currently, this function applies only to ARM servers with multiple NUMA nodes. All NUMA nodes must be available for database processes. You cannot select only some NUMA nodes. - -**Default value**: **none** - -## log\_pagewriter - -**Parameter description**: Specifies whether to display the page refresh information of a thread and details about an incremental check point after the incremental check point is enabled. You are not advised to set this parameter to **true** because a large amount of information will be generated. - -This parameter is a SIGHUP parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -**Default value**: **off** - -## enable\_opfusion - -**Parameter description**: Specifies whether to optimize simple queries. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: Boolean - -- **on** indicates that the performance logs are output. -- **off** indicates that the performance logs are not output. - -**Default value**: **on** - -## advance\_xlog\_file\_num - -**Parameter description**: Specifies the number of Xlog files that are periodically initialized in advance in the background. This parameter is used to prevent the Xlog file initialization from affecting the performance during transaction submission. However, such a fault may occur only when the system is overloaded. Therefore, you do not need to set this parameter. - -This parameter is a POSTMASTER parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from 0 to 100. The value **0** indicates that initialization is not performed in advance. For example, the value **10** indicates that the background thread periodically initializes 10 Xlog files in advance based on the write location of the current Xlog. - -**Default value**: **0** - -## enable\_beta\_opfusion - -**Parameter description**: Specifies whether to accelerate the execution of SQL statements, such as aggregate functions, sorting, and nestloop join, in TPC-C when **enable\_opfusion** is set to **on**. For the nestloop join SQL statements, **enable\_beta\_nestloop\_fusion** must be also set to **on**. - -**Value range**: Boolean - -**Default value**: **off** - -## enable\_beta\_nestloop\_fusion - -**Parameter description**: Specifies whether to accelerate the execution of nestloop join SQL statements in TPC-C when both **enable\_opfusion** and **enable\_beta\_opfusion** are set to **on**. - -**Value range**: Boolean - -**Default value**: **off** - diff --git a/content/en/docs/installation/Developerguide/development-based-on-jdbc.md b/content/en/docs/installation/Developerguide/development-based-on-jdbc.md deleted file mode 100644 index 792c27b020e34315dbdf9b6f157dc3b1f68fc5f9..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-based-on-jdbc.md +++ /dev/null @@ -1,31 +0,0 @@ -# Development Based on JDBC - -Java Database Connectivity \(JDBC\) is a Java API for running SQL statements. It provides unified access interfaces for different relational databases, based on which applications process data. The openGauss library supports JDBC 4.0 and requires JDK 1.8 for code compiling. It does not support JDBC-ODBC bridge. - -- **[JDBC Package, Driver Class, and Environment Class](jdbc-package-driver-class-and-environment-class.md)** - -- **[Development Process](development-process.md)** - -- **[Loading the Driver](loading-the-driver.md)** - -- **[Connecting to a Database](connecting-to-a-database-0.md)** - -- **[Connecting to the Database \(Using SSL\)](connecting-to-the-database-(using-ssl).md)** - -- **[Running SQL Statements](running-sql-statements.md)** - -- **[Processing Data in a Result Set](processing-data-in-a-result-set.md)** - -- **[Closing a Connection](closing-a-connection.md)** - -- **[Example: Common Operations](example-common-operations.md)** - -- **[Example: Retrying SQL Queries for Applications](example-retrying-sql-queries-for-applications.md)** - -- **[Example: Importing and Exporting Data Through Local Files](example-importing-and-exporting-data-through-local-files.md)** - -- **[Example 2: Migrating Data from a MY Database to openGauss](example-2-migrating-data-from-a-my-database-to-opengauss.md)** - -- **[JDBC Interface Reference](jdbc-interface-reference.md)** - - diff --git a/content/en/docs/installation/Developerguide/development-based-on-libpq.md b/content/en/docs/installation/Developerguide/development-based-on-libpq.md deleted file mode 100644 index b71d6514ccb41da252feff1beba6afe80303da73..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-based-on-libpq.md +++ /dev/null @@ -1,6 +0,0 @@ -# Development Based on libpq - -openGauss does not verify the use of libpq interfaces in application development. You are not advised to use this set of interfaces for application development, because underlying risks probably exist. You can use the ODBC or JDBC interface instead. - - - diff --git a/content/en/docs/installation/Developerguide/development-based-on-odbc.md b/content/en/docs/installation/Developerguide/development-based-on-odbc.md deleted file mode 100644 index 23527050fa7bf9e927c3778becf957ad95a5f6ec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-based-on-odbc.md +++ /dev/null @@ -1,61 +0,0 @@ -# Development Based on ODBC - -Open Database Connectivity \(ODBC\) is a Microsoft API for accessing databases based on the X/OPEN CLI. Applications interact with the database through the APIs provided by ODBC, which enhances their portability, scalability, and maintainability. - -[Figure 1](#fig1255101034110) shows the system structure of ODBC. - -**Figure 1** ODBC system structure -![](figures/odbc-system-structure.png "odbc-system-structure") - -openGauss supports ODBC 3.5 in the following environments. - -**Table 1** OSs Supported by ODBC - - - - - - - - - - - - - - - - - - - -

OS

-

Platform

-

CentOS 6.4/6.5/6.6/6.7/6.8/6.9/7.0/7.1/7.2/7.3/7.4

-

x86_64

-

CentOS 7.6

-

ARM64

-

EulerOS 2.0 SP2/SP3

-

x86_64

-

EulerOS 2.0 SP8

-

ARM64

-
- -The ODBC Driver Manager running on UNIX or Linux can be unixODBC or iODBC. unixODBC-2.3.0 is used as the component for connecting the database. - -Windows has a native ODBC Driver Manager. You can locate **Data Sources \(ODBC\)** by choosing **Control Panel** \> **Administrative Tools**. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->The current database ODBC driver is based on an open-source version and may be incompatible with data types tinyint, smalldatetime, and nvarchar2. - -- **[ODBC Packages, Dependent Libraries, and Header Files](odbc-packages-dependent-libraries-and-header-files.md)** - -- **[Configuring a Data Source in the Linux OS](configuring-a-data-source-in-the-linux-os.md)** - -- **[Development Process](development-process-1.md)** - -- **[Example](example.md)** - -- **[ODBC Interface Reference](odbc-interface-reference.md)** - - diff --git a/content/en/docs/installation/Developerguide/development-process-1.md b/content/en/docs/installation/Developerguide/development-process-1.md deleted file mode 100644 index e77a5e85c496c018f0136fc5197b49109bdca646..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-process-1.md +++ /dev/null @@ -1,104 +0,0 @@ -# Development Process - -**Figure 1** ODBC-based application development process -![](figures/odbc-based-application-development-process.png "odbc-based-application-development-process") - -## APIs Involved in the Development Process - -**Table 1** API description - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

-

API

-

Allocate a handle

-

SQLAllocHandle is a generic function for allocating a handle. It can replace the following functions:

- -

Set environment attributes

-

SQLSetEnvAttr

-

Set connection attributes

-

SQLSetConnectAttr

-

Set statement attributes

-

SQLSetStmtAttr

-

Connect to a data source

-

SQLConnect

-

Bind a buffer to a column in the result set

-

SQLBindCol

-

Bind the parameter marker of an SQL statement to a buffer

-

SQLBindParameter

-

Return the error message of the last operation

-

SQLGetDiagRec

-

Prepare an SQL statement for execution

-

SQLPrepare

-

Run a prepared SQL statement

-

SQLExecute

-

Run an SQL statement directly

-

SQLExecDirect

-

Fetch the next row (or rows) from the result set

-

SQLFetch

-

Return data in a column of the result set

-

SQLGetData

-

Get the column information from a result set

-

SQLColAttribute

-

Disconnect from a data source

-

SQLDisconnect

-

Release a handle

-

SQLFreeHandle is a generic function for releasing a handle. It can replace the following functions:

- -
- ->![](public_sys-resources/icon-note.gif) **NOTE:** ->If an execution request \(not in a transaction block\) received in the database contains multiple statements, the request is packed into a transaction. If one of the statements fails, the entire request will be rolled back. - diff --git a/content/en/docs/installation/Developerguide/development-process.md b/content/en/docs/installation/Developerguide/development-process.md deleted file mode 100644 index 554c7b22f5fb1ed582d379fb76d76d8591cbf0e8..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-process.md +++ /dev/null @@ -1,5 +0,0 @@ -# Development Process - -**Figure 1** Application development process based on JDBC -![](figures/application-development-process-based-on-jdbc.png "application-development-process-based-on-jdbc") - diff --git a/content/en/docs/installation/Developerguide/development-specifications.md b/content/en/docs/installation/Developerguide/development-specifications.md deleted file mode 100644 index f2795b512242e4a8ac8ea70c8008cbb34a6dd679..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/development-specifications.md +++ /dev/null @@ -1,9 +0,0 @@ -# Development Specifications - -If the connection pool mechanism is used during application development, comply with the following specifications: - -- If GUC parameters are set in the connection, run **SET SESSION AUTHORIZATION DEFAULT;RESET ALL;** to clear the connection status before you return the connection to the connection pool. -- If a temporary table is used, delete the temporary table before you return the connection to the connection pool. - -If you do not do so, the connection in the connection pool will be stateful, which affects subsequent operations on the connection pool. - diff --git a/content/en/docs/installation/Developerguide/dictionaries.md b/content/en/docs/installation/Developerguide/dictionaries.md deleted file mode 100644 index b850b017565c6ea97d3c2cdb8ca0bf33c90670db..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dictionaries.md +++ /dev/null @@ -1,17 +0,0 @@ -# Dictionaries - -- **[Overview](overview-19.md)** - -- **[Stop Words](stop-words.md)** - -- **[Simple Dictionary](simple-dictionary.md)** - -- **[Synonym Dictionary](synonym-dictionary.md)** - -- **[Thesaurus Dictionary](thesaurus-dictionary.md)** - -- **[Ispell Dictionary](ispell-dictionary.md)** - -- **[Snowball Dictionary](snowball-dictionary.md)** - - diff --git a/content/en/docs/installation/Developerguide/disk-space.md b/content/en/docs/installation/Developerguide/disk-space.md deleted file mode 100644 index 9bc786dc687636aa61481d34f008de13a10f418a..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/disk-space.md +++ /dev/null @@ -1,29 +0,0 @@ -# Disk Space - -This section describes the disk space parameters, which are used to set limits on the disk space for storing temporary files. - -## sql\_use\_spacelimit - -**Parameter description**: Specifies the space size for files to be flushed to disks when a single SQL statement is executed on a single database node. The managed space includes the space occupied by ordinary tables, temporary tables, and intermediate result sets to be flushed to disks. - -This parameter is a USERSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - -**Value range**: an integer ranging from –1 to 2147483647. The unit is KB. **–1** indicates no limit. - -**Default value:** **–1** - -## temp\_file\_limit - -**Parameter description**: Specifies the limit on the size of a temporary file spilled to disk in a session. The temporary file can be a sort or hash temporary file, or the storage file for a held cursor. - -This is a session-level setting. - -This parameter is a SUSET parameter. Set it based on instructions provided in [Table 1](resetting-parameters.md#en-us_topic_0237121562_en-us_topic_0059777490_t91a6f212010f4503b24d7943aed6d846). - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->This parameter does not apply to disk space used for temporary tables during the SQL query process. - -**Value range**: an integer ranging from –1 to 2147483647. The unit is KB. **–1** indicates no limit. - -**Default value**: **–1** - diff --git a/content/en/docs/installation/Developerguide/disk-ssd.md b/content/en/docs/installation/Developerguide/disk-ssd.md deleted file mode 100644 index bf876f244f80db9cbc03be7c5b47a1797b19502e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/disk-ssd.md +++ /dev/null @@ -1,15 +0,0 @@ -# Disk/SSD - -The following describes how to ensure that disk R/W performance is suitable for database synchronous commit mode. - -To do so, test your disk bandwidth using the following: - -``` -[...]$ sync; dd if=/dev/zero of=testfile bs=1M count=1024; sync -1024+0 records in -1024+0 records out -1073741824 bytes (1.1 GB) copied, 1.36034 s, 789 MB/s -``` - -In case the disk bandwidth is significantly below the above number \(789 MB/s\), it may create a performance bottleneck for openGauss, and especially for MOT. - diff --git a/content/en/docs/installation/Developerguide/dml-syntax-overview.md b/content/en/docs/installation/Developerguide/dml-syntax-overview.md deleted file mode 100644 index 90316dc6bd5423a7a007526f5c545bac3b02f5a1..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dml-syntax-overview.md +++ /dev/null @@ -1,60 +0,0 @@ -# DML Syntax Overview - -Data manipulation language \(DML\) is used to perform operations on data in database tables, such as inserting, updating, querying, or deleting data. - -## Inserting Data - -Inserting data refers to adding one or multiple records to a database table. For details, see [INSERT](insert.md). - -## Updating Data - -Updating data refers to modifying one or multiple records in a database table. For details, see [UPDATE](update.md). - -## Querying Data - -The database query statement **SELECT** is used to search required information in a database. For details, see [SELECT](select.md). - -## Deleting Data - -openGauss provides two statements for deleting data from database tables. To delete data meeting specified conditions from a database table, see [DELETE](delete.md). To delete all data from a database table, see [TRUNCATE](truncate.md). - -**TRUNCATE** can quickly delete all data from a database table, which achieves the effect same as that running **DELETE** to delete data without specifying conditions from each table. Deletion efficiency using **TRUNCATE** is faster because **TRUNCATE** does not scan tables. Therefore, **TRUNCATE** is useful in large tables. - -## Copying Data - -openGauss provides a statement for copying data between tables and files. For details, see [COPY](copy.md). - -## Locking a Table - -openGauss provides multiple lock modes to control concurrent accesses to table data. For details, see [LOCK](lock.md). - -## Calling a Function - -openGauss provides three statements for calling functions. These statements are the same in the syntax structure. For details, see [CALL](call.md). - -## Session Management - -A session is a connection established between the user and the database. [Table 1](#en-us_topic_0237122050_en-us_topic_0059777960_t320d7e04ba33427cbe2132b994ef6cb2) lists the related SQL statements. - -**Table 1** SQL statements related to sessions - - - - - - - - - - - - - -

Function

-

SQL Statement

-

Altering a session

-

ALTER SESSION

-

Killing a session

-

ALTER SYSTEM KILL SESSION

-
- diff --git a/content/en/docs/installation/Developerguide/do.md b/content/en/docs/installation/Developerguide/do.md deleted file mode 100644 index ca05bbd1db809faa9f7cf60c4cda9eb5e1c708b4..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/do.md +++ /dev/null @@ -1,51 +0,0 @@ -# DO - -## Function - -**DO** executes an anonymous code block. - -The code block is treated as though it were the body of a function with no parameters, returning **void**. It is parsed and executed a single time. - -## Precautions - -- he procedural language to be used must already have been installed into the current database by means of **CREATE LANGUAGE**. **plpgsql** is installed by default, but other languages are not. -- The user must have the **USAGE** permission on the procedural language, or must be a system administrator if the language is untrusted. - -## Syntax - -``` -DO [ LANGUAGE lang_name ] code; -``` - -## Parameter Description - -- **lang\_name** - - Specifies the name of the procedural language the code is written in. If omitted, the default is **plpgsql**. - -- **code** - - Specifies the procedural language code to be executed. This must be specified as a string literal. - - -## Example - -``` --- Create the webuser user. -postgres=# CREATE USER webuser PASSWORD 'Bigdata@123'; - --- Grant all permissions on all views in the tpcds schema to the webuser user. -postgres=# DO $$DECLARE r record; -BEGIN - FOR r IN SELECT c.relname table_name,n.nspname table_schema FROM pg_class c,pg_namespace n - WHERE c.relnamespace = n.oid AND n.nspname = 'tpcds' AND relkind IN ('r','v') - LOOP - EXECUTE 'GRANT ALL ON ' || quote_ident(r.table_schema) || '.' || quote_ident(r.table_name) || ' TO webuser'; - END LOOP; -END$$; - - --- Delete the webuser user. -postgres=# DROP USER webuser CASCADE; -``` - diff --git a/content/en/docs/installation/Developerguide/doing-vacuum-to-a-table.md b/content/en/docs/installation/Developerguide/doing-vacuum-to-a-table.md deleted file mode 100644 index d48cc998628f2a4bae7f287774e380fbcd26bb88..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/doing-vacuum-to-a-table.md +++ /dev/null @@ -1,17 +0,0 @@ -# Doing VACUUM to a Table - -If a large number of rows were updated or deleted during import, run **VACUUM FULL** before **ANALYZE**. A large number of UPDATE and DELETE operations generate huge disk page fragments, which reduces query efficiency. **VACUUM FULL** can restore disk page fragments and return them to the OS. - -1. Run the **VACUUM FULL** statement. - - Do **VACUUM FULL** to the **product\_info** table. - - ``` - VACUUM FULL product_info - ``` - - ``` - VACUUM - ``` - - diff --git a/content/en/docs/installation/Developerguide/drop-data-source.md b/content/en/docs/installation/Developerguide/drop-data-source.md deleted file mode 100644 index 846d89acc7e2686a50d497ee3283fa035eeec580..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-data-source.md +++ /dev/null @@ -1,51 +0,0 @@ -# DROP DATA SOURCE - -## Function - -**DROP DATA SOURCE** deletes a data source. - -## Important Notes - -Only an owner, system administrator, or initial user can delete a data source. - -## Syntax - -``` -DROP DATA SOURCE [IF EXISTS] src_name [CASCADE | RESTRICT]; -``` - -## Parameter Description - -- **src\_name** - - Specifies the name of the data source to be deleted. - - Value range: a string. It must comply with the naming convention. - -- **IF EXISTS** - - Reports a notice instead of an error if the specified data source does not exist. - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the data source. - - **RESTRICT**: refuses to delete the data source if any objects depend on it. This is the default action. - - Currently, no objects depend on data sources. Therefore, **CASCADE** is equivalent to **RESTRICT**, and they are reserved to ensure backward compatibility. - - - -## Examples - -``` --- Create a data source. -postgres=# CREATE DATA SOURCE ds_tst1; - --- Delete the data source. -postgres=# DROP DATA SOURCE ds_tst1 CASCADE; -postgres=# DROP DATA SOURCE IF EXISTS ds_tst1 RESTRICT; -``` - -## Helpful Links - -[CREATE DATA SOURCE](create-data-source.md) and [DROP DATA SOURCE](drop-data-source.md) - diff --git a/content/en/docs/installation/Developerguide/drop-database.md b/content/en/docs/installation/Developerguide/drop-database.md deleted file mode 100644 index aaffab384b632ba4ba1836e925a780cc496f7a21..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-database.md +++ /dev/null @@ -1,51 +0,0 @@ -# DROP DATABASE - -## Function - -**DROP DATABASE** deletes a database. - -## Precautions - -- Only the owner of a database or a system administrator has the **DROP DATABASE** permission. -- The preinstalled POSTGRES, TEMPLATE0, and TEMPLATE1 databases are protected and therefore cannot be deleted. To check databases in the current service, run the gsql statement **\\l**. -- If any users are connected to the database, the database cannot be deleted. -- **DROP DATABASE** cannot be executed within a transaction block. -- If **DROP DATABASE** fails and is rolled back, run **DROP DATABASE IF EXISTS** again. - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->**DROP DATABASE** cannot be undone. - -## Syntax - -``` -DROP DATABASE [ IF EXISTS ] database_name ; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified database does not exist. - -- **database\_name** - - Specifies the name of the database to be deleted. - - Value range: an existing database name - - -## Examples - -See [Examples](create-database.md#en-us_topic_0237122099_en-us_topic_0059778277_s6be7b8abbb4b4aceb9dae686434d672c) in **CREATE DATABASE**. - -## Helpful Links - -[CREATE DATABASE](create-database.md) - -## Suggestions - -- drop database - - Do not delete databases during transactions. - - diff --git a/content/en/docs/installation/Developerguide/drop-directory.md b/content/en/docs/installation/Developerguide/drop-directory.md deleted file mode 100644 index d53db11a2fe61319fe94228bef96ccfbdb2b1912..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-directory.md +++ /dev/null @@ -1,39 +0,0 @@ -# DROP DIRECTORY - -## Function - -**DROP Directory** deletes a synonym. - -## Precautions - -By default, only the initial user can perform the drop operation. When **enable\_access\_server\_directory** \([enable\_access\_server\_directory](operation-auditing.md#en-us_topic_0237124747_section4279164545515)\), users with the **sysadmin** permission can also perform the drop operation. - -## Syntax - -``` -DROP DIRECTORY [ IF EXISTS ] directory_name; -``` - -## Parameter Description - -- **directory\_name** - - Specifies the name of the directory to be deleted. - - Value range: an existing directory name - - -## Example - -``` --- Create a directory. -postgres=# CREATE OR REPLACE DIRECTORY dir as '/tmp/'; - --- Delete a directory. -postgres=# DROP DIRECTORY dir; -``` - -## Helpful Links - -[CREATE DIRECTORY](create-directory.md) and [ALTER DIRECTORY](alter-directory.md) - diff --git a/content/en/docs/installation/Developerguide/drop-foreign-table.md b/content/en/docs/installation/Developerguide/drop-foreign-table.md deleted file mode 100644 index c368145c7aa0a3ab66bda278b0ebc063d98a696d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-foreign-table.md +++ /dev/null @@ -1,41 +0,0 @@ -# DROP FOREIGN TABLE - -## Function - -**DROP FOREIGN TABLE** drops a foreign table. - -## Precautions - -**DROP FOREIGN TABLE** forcibly drops the specified table and the indexes depending on the table. After the table is dropped, the functions and stored procedures that need to use this table cannot be executed. - -## Syntax - -``` -DROP FOREIGN TABLE [ IF EXISTS ] - table_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified table does not exist. - -- **table\_name** - - Table name - - Value range: an existing table name - -- **CASCADE | RESTRICT** - - - **CASCADE**: automatically drops the objects \(such as views\) that depend on the table. - - - **RESTRICT**: refuses to drop the table if any objects depend on it. This is the default action. - - - -## Helpful Links - -[ALTER FOREIGN TABLE](alter-foreign-table.md) and [CREATE FOREIGN TABLE](create-foreign-table.md) - diff --git a/content/en/docs/installation/Developerguide/drop-function.md b/content/en/docs/installation/Developerguide/drop-function.md deleted file mode 100644 index 5635f592c95b96d529789d96772d5443b2fd759b..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-function.md +++ /dev/null @@ -1,50 +0,0 @@ -# DROP FUNCTION - -## Function - -**DROP FUNCTION** deletes a function. - -## Precautions - -If a function involves operations on temporary tables, **DROP FUNCTION** cannot be used. - -## Syntax - -``` -DROP FUNCTION [ IF EXISTS ] function_name -[ ( [ {[ argmode ] [ argname ] argtype} [, ...] ] ) [ CASCADE | RESTRICT ] ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified function does not exist. - -- **function\_name** - - Specifies the name of the function to be deleted. - - Value range: an existing function name - -- **argmode** - - Specifies the parameter mode of the function. - -- **argname** - - Specifies the parameter name of the function. - -- **argtype** - - Specifies the parameter type of the function. - - -## Examples - -For details, see [Examples](create-function.md#en-us_topic_0237122104_en-us_topic_0059778837_scc61c5d3cc3e48c1a1ef323652dda821). - -## Helpful Links - -[ALTER FUNCTION](alter-function.md) and [CREATE FUNCTION](create-function.md) - diff --git a/content/en/docs/installation/Developerguide/drop-group.md b/content/en/docs/installation/Developerguide/drop-group.md deleted file mode 100644 index 09c018b1491a9c3bf9e403013e7bdde41f93125d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-group.md +++ /dev/null @@ -1,26 +0,0 @@ -# DROP GROUP - -## Function - -**DROP GROUP** deletes a user group. - -**DROP GROUP** is an alias for **DROP ROLE**. - -## Precautions - -**DROP GROUP** is an internal interface of the openGauss management tool. You are not advised to use this interface, because doing so affects openGauss. - -## Syntax - -``` -DROP GROUP [ IF EXISTS ] group_name [, ...]; -``` - -## Parameter Description - -See [Parameter Description](drop-role.md#en-us_topic_0237122147_en-us_topic_0059778848_sabe550f7ed48409b8ffd1d88ca9f0725) in **DROP ROLE**. - -## Helpful Links - -[CREATE GROUP](create-group.md), [ALTER GROUP](alter-group.md), and [DROP ROLE](drop-role.md) - diff --git a/content/en/docs/installation/Developerguide/drop-index.md b/content/en/docs/installation/Developerguide/drop-index.md deleted file mode 100644 index 13211a0e0fd15d40e732b7a6a7edb8b333a94883..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-index.md +++ /dev/null @@ -1,50 +0,0 @@ -# DROP INDEX - -## Function - -**DROP INDEX** deletes an index. - -## Precautions - -Only the owner of an index or a system administrator has the **DROP INDEX** permission. - -## Syntax - -``` -DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] - index_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **CONCURRENTLY** - - Deletes an index without locking it. A normal **DROP INDEX** acquires exclusive lock on the table on which the index depends, blocking other accesses until the index drop can be completed. With this option, the statement does not lock the table during index deletion. - - This parameter allows only one index name and does not support **CASCADE**. - - The **DROP INDEX** statement can be run within a transaction, but **DROP INDEX CONCURRENTLY** cannot. - -- **IF EXISTS** - - Reports a notice instead of an error if the specified index does not exist. - -- **index\_name** - - Specifies the index name to be deleted. - - Value range: an existing index - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the index. - - **RESTRICT**: refuses to delete the index if any objects depend on it. This is the default action. - - -## Examples - -See [Examples](create-index.md#en-us_topic_0237122106_en-us_topic_0059777455_s985289833081489e9d77c485755bd362) in **CREATE INDEX**. - -## Helpful Links - -[ALTER INDEX](alter-index.md) and [CREATE INDEX](create-index.md) - diff --git a/content/en/docs/installation/Developerguide/drop-materialized-view.md b/content/en/docs/installation/Developerguide/drop-materialized-view.md deleted file mode 100644 index aef16b6f5e4692b9ecf35c3c60e150362b828414..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-materialized-view.md +++ /dev/null @@ -1,42 +0,0 @@ -# DROP MATERIALIZED VIEW - -## Function - -**DROP MATERIALIZED VIEW** forcibly deletes an existing materialized view from the database. - -## Precautions - -Only the owner of a materialized view or a system administrator has the **DROP MATERIALIZED VIEW** permission. - -## Syntax - -``` -DROP MATERIALIZED VIEW [ IF EXISTS ] mv_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified materialized view does not exist. - -- **mv\_name** - - Specifies the name of the materialized view to be deleted. - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the materialized view. - - **RESTRICT**: refuses to delete the materialized view if any objects depend on it. This is the default action. - - -## Examples - -``` --- Delete the materialized view named order_summary. -postgres=# DROP MATERIALIZED VIEW order_summary; -``` - -## Helpful Links - -[ALTER MATERIALIZED VIEW](alter-materialized-view.md), [REFRESH MATERIALIZED VIEW](refresh-materialized-view.md), [CREATE MATERIALIZED VIEW](create-materialized-view.md), and [DROP TABLE](en-us_topic_0242370616.md) - diff --git a/content/en/docs/installation/Developerguide/drop-owned.md b/content/en/docs/installation/Developerguide/drop-owned.md deleted file mode 100644 index 032b8aabd818f38b68efe7a0f30e1988a2061a5f..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-owned.md +++ /dev/null @@ -1,34 +0,0 @@ -# DROP OWNED - -## Function - -**DROP OWNED** deletes the database objects owned by a database role. - -## Precautions - -- This interface will revoke the role's permissions on all objects in the current database and shared objects \(databases and tablespaces\). -- **DROP OWNED** is often used to prepare for removing one or more roles. Because **DROP OWNED** affects only the objects in the current database, you need to run this statement in each database that contains the objects owned by the role to be removed. -- Using the **CASCADE** option may cause this statement to recursively remove objects owned by other users. -- The databases and tablespaces owned by the role will not be removed. - -## Syntax - -``` -DROP OWNED BY name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **name** - - Specifies the role name. - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the objects to be deleted. - - **RESTRICT**: refuses to delete the objects if other objects depend on them. This is the default action. - - -## Helpful Links - -[REASSIGN OWNED](reassign-owned.md) and [DROP ROLE](drop-role.md) - diff --git a/content/en/docs/installation/Developerguide/drop-procedure.md b/content/en/docs/installation/Developerguide/drop-procedure.md deleted file mode 100644 index 584ae9949280cca525b3b0a3b2eb9b52d1aee030..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-procedure.md +++ /dev/null @@ -1,33 +0,0 @@ -# DROP PROCEDURE - -## Function - -**DROP PROCEDURE** deletes a stored procedure. - -## Precautions - -None - -## Syntax - -``` -DROP PROCEDURE [ IF EXISTS ] procedure_name ; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified stored procedure does not exist. - -- **procedure\_name** - - Specifies the name of the stored procedure to be deleted. - - Value range: an existing stored procedure name - - -## Helpful Links - -[CREATE PROCEDURE](create-procedure.md) - diff --git a/content/en/docs/installation/Developerguide/drop-role.md b/content/en/docs/installation/Developerguide/drop-role.md deleted file mode 100644 index 40d0e356f0d91c8b7f687d7542e076b3a909d78e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-role.md +++ /dev/null @@ -1,37 +0,0 @@ -# DROP ROLE - -## Function - -**DROP ROLE** deletes a role. - -## Precautions - -None - -## Syntax - -``` -DROP ROLE [ IF EXISTS ] role_name [, ...]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified role does not exist. - -- **role\_name** - - Specifies the name of the role to be deleted. - - Value range: an existing role name - - -## Examples - -See [Example:](create-role.md#en-us_topic_0237122112_en-us_topic_0059778189_s0dea2f90b8474387aff0ab3f366a611e) in **CREATE ROLE**. - -## Helpful Links - -[CREATE ROLE](create-role.md), [ALTER ROLE](alter-role.md), and [SET ROLE](set-role.md) - diff --git a/content/en/docs/installation/Developerguide/drop-row-level-security-policy.md b/content/en/docs/installation/Developerguide/drop-row-level-security-policy.md deleted file mode 100644 index 37e7d81d4cde065407eb3562f7c9cca54ab6cd38..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-row-level-security-policy.md +++ /dev/null @@ -1,53 +0,0 @@ -# DROP ROW LEVEL SECURITY POLICY - -## Function - -**DROP ROW LEVEL SECURITY POLICY** deletes a row-level access control policy from a table. - -## Precautions - -Only the owner of a table or a system administrator has the **DROP ROW LEVEL SECURITY POLICY** permission. - -## Syntax - -``` -DROP [ ROW LEVEL SECURITY ] POLICY [ IF EXISTS ] policy_name ON table_name [ CASCADE | RESTRICT ] -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified row-level access control policy does not exist. - -- **policy\_name** - - Specifies the name of the row-level access control policy to be deleted. - - - table\_name - - Specifies the name of the table containing the row-level access control policy. - - - CASCADE/RESTRICT - - Currently, no objects depend on row-level access control policies. Therefore, **CASCADE** is equivalent to **RESTRICT**, and they are reserved to ensure backward compatibility. - - - -## Examples - -``` --- Create the data table all_data. -postgres=# CREATE TABLE all_data(id int, role varchar(100), data varchar(100)); - --- Create a row-level access control policy. -postgres=# CREATE ROW LEVEL SECURITY POLICY all_data_rls ON all_data USING(role = CURRENT_USER); - --- Delete a row-level access control policy. -postgres=# DROP ROW LEVEL SECURITY POLICY all_data_rls ON all_data; -``` - -## Helpful Links - -[ALTER ROW LEVEL SECURITY POLICY](alter-row-level-security-policy.md) and [CREATE ROW LEVEL SECURITY POLICY](create-row-level-security-policy.md) - diff --git a/content/en/docs/installation/Developerguide/drop-schema.md b/content/en/docs/installation/Developerguide/drop-schema.md deleted file mode 100644 index 9de13953c34b2fc4bd10af9fadf75dbd80c1a037..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-schema.md +++ /dev/null @@ -1,47 +0,0 @@ -# DROP SCHEMA - -## Function - -**DROP SCHEMA** deletes a schema from the current database. - -## Precautions - -Only the owner of a schema or a system administrator has the **DROP SCHEMA** permission. - -## Syntax - -``` -DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified schema does not exist. - -- **schema\_name** - - Specifies the name of the schema to be deleted. - - Value range: an existing schema name - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes all the objects contained in the schema. - - **RESTRICT**: refuses to delete the schema if the schema contains objects. This is the default action. - - ->![](public_sys-resources/icon-notice.gif) **NOTICE:** ->Schemas beginning with **pg\_temp** or **pg\_toast\_temp** are for internal use. Do not delete them. Otherwise, unexpected consequences may be incurred. - ->![](public_sys-resources/icon-note.gif) **NOTE:** ->The schema currently being used cannot be deleted. To delete it, switch to another schema first. - -## Examples - -See [Examples](create-schema.md#en-us_topic_0237122113_en-us_topic_0059777945_s05e72232af5e4507aad1511c025d7617) in **CREATE SCHEMA**. - -## Helpful Links - -[ALTER SCHEMA](alter-schema.md) and [CREATE SCHEMA](create-schema.md) - diff --git a/content/en/docs/installation/Developerguide/drop-sequence.md b/content/en/docs/installation/Developerguide/drop-sequence.md deleted file mode 100644 index ce2ca40840dee12cdda68a34e7b82a8ea5f3da5e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-sequence.md +++ /dev/null @@ -1,49 +0,0 @@ -# DROP SEQUENCE - -## Function - -**DROP SEQUENCE** deletes a sequence from the current database. - -## Precautions - -Only the owner of a schema or a system administrator has the **DROP SEQUENCE** permission. - -## Syntax - -``` -DROP SEQUENCE [ IF EXISTS ] {[schema.]sequence_name} [ , ... ] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified sequence does not exist. - -- **name** - - Specifies the name of the sequence to be deleted. - -- **CASCADE** - - Automatically deletes the objects that depend on the sequence. - -- **RESTRICT** - - Refuses to delete the sequence if any objects depend on it. This is the default action. - - -## Examples - -``` --- Create an ascending sequence named serial, starting from 101. -postgres=# CREATE SEQUENCE serial START 101; - --- Delete a sequence. -postgres=# DROP SEQUENCE serial; -``` - -## Helpful Links - -[ALTER SEQUENCE](alter-sequence.md) and [DROP SEQUENCE](drop-sequence.md) - diff --git a/content/en/docs/installation/Developerguide/drop-server.md b/content/en/docs/installation/Developerguide/drop-server.md deleted file mode 100644 index bf453d693aba6db0eeea04d3dcabb3d0eb9f6a84..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-server.md +++ /dev/null @@ -1,38 +0,0 @@ -# DROP SERVER - -## Function - -**DROP SERVER** drops a data server. - -## Precautions - -Only the owner of the server can execute this statement. - -## Syntax - -``` -DROP SERVER [ IF EXISTS ] server_name [ {CASCADE | RESTRICT} ] ; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified data server does not exist. - -- **server\_name** - - Specifies the name of the data server to be dropped. - -- **CASCADE | RESTRICT** - - - **CASCADE**: automatically drops the objects that depend on the data server. - - - **RESTRICT**: refuses to drop the server if any objects depend on it. This is the default action. - - - -## Helpful Links - -[ALTER SERVER](alter-server.md) and [CREATE SERVER](create-server.md) - diff --git a/content/en/docs/installation/Developerguide/drop-synonym.md b/content/en/docs/installation/Developerguide/drop-synonym.md deleted file mode 100644 index f13a7d333ba0e994707d1f394c203b82bb73b668..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-synonym.md +++ /dev/null @@ -1,39 +0,0 @@ -# DROP SYNONYM - -## Function - -**DROP SYNONYM** deletes a synonym. - -## Precautions - -Only the owner of a synonym or a system administrator has the **DROP SYNONYM** permission. - -## Syntax - -``` -DROP SYNONYM [ IF EXISTS ] synonym_name [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified synonym does not exist. - -- **synonym\_name** - - Specifies the name \(optionally schema-qualified\) of the synonym to be deleted. - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects \(such as views\) that depend on the synonym. - - **RESTRICT**: refuses to delete the synonym if any objects depend on it. This is the default action. - - -## Examples - -See [Example](create-synonym.md#en-us_topic_0237122116_section1853433744413) in **CREATE SYNONYM**. - -## Helpful Links - -[ALTER SYNONYM](alter-synonym.md) and [CREATE SYNONYM](create-synonym.md) - diff --git a/content/en/docs/installation/Developerguide/drop-table.md b/content/en/docs/installation/Developerguide/drop-table.md deleted file mode 100644 index 9844d34a850fec3a0aafae9fca195078d39bde59..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-table.md +++ /dev/null @@ -1,44 +0,0 @@ -# DROP TABLE - -## Function - -**DROP TABLE** deletes a table. - -## Precautions - -**DROP TABLE** forcibly deletes the specified table and the indexes depending on the table. After the table is deleted, the functions and stored procedures that need to use this table cannot be executed. Deleting a partitioned table also deletes all partitions in the table. - -## Syntax - -``` -DROP TABLE [ IF EXISTS ] - { [schema.]table_name } [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified table does not exist. - -- **schema** - - Specifies the schema name. - -- **table\_name** - - Specifies the name of the table to be deleted. - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects \(such as views\) that depend on the table. - - **RESTRICT**: refuses to delete the table if any objects depend on it. This is the default action. - - -## Examples - -See [Example:](create-table.md#en-us_topic_0237122117_en-us_topic_0059778169_s86758dcf05d442d2a9ebd272e76ed1b8) in **CREATE TABLE**. - -## Helpful Links - -[ALTER TABLE](alter-table.md) and [CREATE TABLE](create-table.md) - diff --git a/content/en/docs/installation/Developerguide/drop-tablespace.md b/content/en/docs/installation/Developerguide/drop-tablespace.md deleted file mode 100644 index cd617040ef3a5b072504ad16d8967b65bc27313c..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-tablespace.md +++ /dev/null @@ -1,48 +0,0 @@ -# DROP TABLESPACE - -## Function - -**DROP TABLESPACE** deletes a tablespace. - -## Precautions - -- Only the owner of a tablespace or a system administrator has the **DROP TABLESPACE** permission. -- The tablespace to be deleted should not contain any database objects. Otherwise, an error will be reported. -- **DROP TABLESPACE** cannot be rolled back and therefore cannot be run in transaction blocks. -- During execution of **DROP TABLESPACE**, database queries by other sessions using **\\db** may fail and need to be reattempted. -- If **DROP TABLESPACE** fails to be executed, run **DROP TABLESPACE IF EXISTS**. - -## Syntax - -``` -DROP TABLESPACE [ IF EXISTS ] tablespace_name; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified tablespace does not exist. - -- **tablespace\_name** - - Specifies the name of the tablespace to be deleted. - - Value range: an existing tablespace name - - -## Examples - -See [Examples](create-tablespace.md#en-us_topic_0237122120_en-us_topic_0059777670_s4e5e97caa377440d87fad0d49b56323e) in **CREATE TABLESPACE**. - -## Helpful Links - -[ALTER TABLESPACE](alter-tablespace.md) and [CREATE TABLESPACE](create-tablespace.md) - -## Suggestions - -- drop database - - Do not delete databases during transactions. - - diff --git a/content/en/docs/installation/Developerguide/drop-text-search-configuration.md b/content/en/docs/installation/Developerguide/drop-text-search-configuration.md deleted file mode 100644 index c3ac7819a9132766966f2ea49af8cfc923bde4b7..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-text-search-configuration.md +++ /dev/null @@ -1,43 +0,0 @@ -# DROP TEXT SEARCH CONFIGURATION - -## Function - -**DROP TEXT SEARCH CONFIGURATION** deletes a text search configuration. - -## Precautions - -Only the owner of a text search configuration has the **DROP TEXT SEARCH CONFIGURATION** permission. - -## Syntax - -``` -DROP TEXT SEARCH CONFIGURATION [ IF EXISTS ] name [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified text search configuration does not exist. - -- **name** - - Specifies the name \(optionally schema-qualified\) of the text search configuration to be deleted. - -- **CASCADE** - - Automatically deletes the objects that depend on the text search configuration. - -- **RESTRICT** - - Refuses to delete the text search configuration if any objects depend on it. This is the default action. - - -## Examples - -See [Examples](create-text-search-configuration.md#en-us_topic_0237122121_en-us_topic_0059777835_sc3a4aef5c0c0420eaf5a2e67097004a2) in **CREATE TEXT SEARCH CONFIGURATION**. - -## Helpful Links - -[ALTER TEXT SEARCH CONFIGURATION](alter-text-search-configuration.md) and [CREATE TEXT SEARCH CONFIGURATION](create-text-search-configuration.md) - diff --git a/content/en/docs/installation/Developerguide/drop-text-search-dictionary.md b/content/en/docs/installation/Developerguide/drop-text-search-dictionary.md deleted file mode 100644 index 52bc03e2c713875993e77868768af835e72025fd..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-text-search-dictionary.md +++ /dev/null @@ -1,52 +0,0 @@ -# DROP TEXT SEARCH DICTIONARY - -## Function - -**DROP TEXT SEARCH DICTIONARY** deletes a full-text retrieval dictionary. - -## Precautions - -- Predefined dictionaries do not support the **DROP** operations. -- Only the owner of a dictionary or a system administrator has the **DROP TEXT SEARCH DICTIONARY** permission. -- Execute **DROP...CASCADE** only when necessary because this operation will delete the text search configurations that use this dictionary. - -## Syntax - -``` -DROP TEXT SEARCH DICTIONARY [ IF EXISTS ] name [ CASCADE | RESTRICT ] -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified full-text retrieval dictionary does not exist. - -- **name** - - Specifies the name of the dictionary to be deleted. \(If you do not specify a schema name, the dictionary in the current schema will be used.\) - - Value range: an existing dictionary name - -- **CASCADE** - - Automatically deletes the objects that depend on the full-text retrieval dictionary and other objects that depend on these objects. - - If any text search configuration uses the dictionary, the **DROP** statement will fail. You can add **CASCADE** to delete all text search configurations and dictionaries that use this dictionary. - -- **RESTRICT** - - Refuses to delete the full-text retrieval dictionary if any object depends on it. This is the default action. - - -## Examples - -``` --- Delete the english dictionary. -postgres=# DROP TEXT SEARCH DICTIONARY english; -``` - -## Helpful Links - -[ALTER TEXT SEARCH DICTIONARY](alter-text-search-dictionary.md) and [CREATE TEXT SEARCH DICTIONARY](create-text-search-dictionary.md) - diff --git a/content/en/docs/installation/Developerguide/drop-trigger.md b/content/en/docs/installation/Developerguide/drop-trigger.md deleted file mode 100644 index cef644eb5e23176621f38f90911be60f960431ce..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-trigger.md +++ /dev/null @@ -1,47 +0,0 @@ -# DROP TRIGGER - -## Function - -**DROP TRIGGER** deletes a trigger. - -## Precautions - -Only the owner of a trigger or a system administrator has the **DROP TRIGGER** permission. - -## Syntax - -``` -DROP TRIGGER [ IF EXISTS ] trigger_name ON table_name [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified trigger does not exist. - -- **trigger\_name** - - Specifies the name of the trigger to be deleted. - - Value range: an existing trigger name - -- **table\_name** - - Specifies the name of the table containing the trigger. - - Value range: name of the table containing the trigger - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the trigger. - - **RESTRICT**: refuses to delete the trigger if any objects depend on it. This is the default action. - - -## Examples - -For details, see [Examples](create-trigger.md#en-us_topic_0237122123_en-us_topic_0059778166_sfbca773f5bcd4799b3ea668b3eb074fa) in [CREATE TRIGGER](create-trigger.md). - -## Helpful Links - -[CREATE TRIGGER](create-trigger.md), [ALTER TRIGGER](alter-trigger.md), and [ALTER TABLE](alter-table.md) - diff --git a/content/en/docs/installation/Developerguide/drop-type.md b/content/en/docs/installation/Developerguide/drop-type.md deleted file mode 100644 index 044167cad824222e34c262cca056cef50bf8b352..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-type.md +++ /dev/null @@ -1,39 +0,0 @@ -# DROP TYPE - -## Function - -**DROP TYPE** deletes a user-defined data type. Superuser, sysadmin and the owner of a type has the **DROP TYPE** permission. - -## Syntax - -``` -DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified type does not exist. - -- **name** - - Specifies the name \(optionally schema-qualified\) of the type to be deleted. - -- **CASCADE** - - Automatically deletes the objects \(such as fields, functions, and operators\) that depend on the type. - - **RESTRICT** - - Refuses to delete the type if any objects depend on it. This is the default action. - - -## Example - -See [Examples](create-type.md#en-us_topic_0237122124_en-us_topic_0059779377_s66a0b4a6a1df4ba4a116c6c565a0fe9d) in **CREATE TYPE**. - -## Helpful Links - -[CREATE TYPE](create-type.md) and [ALTER TYPE](alter-type.md) - diff --git a/content/en/docs/installation/Developerguide/drop-user-mapping.md b/content/en/docs/installation/Developerguide/drop-user-mapping.md deleted file mode 100644 index ea21a2c78c8805169506558d3b01f0ded9d707f7..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-user-mapping.md +++ /dev/null @@ -1,33 +0,0 @@ -# DROP USER MAPPING - -## Function - -**DROP USER MAPPING** drops a user mapping for a foreign server. - -## Syntax - -``` -DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the user mapping does not exist. - -- **user\_name** - - Specifies user name of the mapping. - - CURRENT\_USER and USER match the name of the current user. PUBLIC is used to match all current and future user names in the system. - -- **server\_name** - - Specifies name of the server to which the user is mapped. - - -## Helpful Links - -[ALTER USER MAPPING](alter-user-mapping.md) and [CREATE USER MAPPING](create-user-mapping.md) - diff --git a/content/en/docs/installation/Developerguide/drop-user.md b/content/en/docs/installation/Developerguide/drop-user.md deleted file mode 100644 index 86250bcb95991cdf46cab08a8035847e223613ae..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-user.md +++ /dev/null @@ -1,53 +0,0 @@ -# DROP USER - -## Function - -**DROP USER** deletes a user and the schema with the same name as the user. - -## Precautions - -- **CASCADE** is used to delete the objects \(excluding databases\) that depend on the user. **CASCADE** cannot delete locked objects unless the objects are unlocked or the processes locking the objects are killed. -- In openGauss, the **enable\_kill\_query** configuration parameter exists in the **postgresql.conf** file. This parameter affects **CASCADE**. - - If **enable\_kill\_query** is **on** and **CASCADE** is used, the statement automatically kills the processes locking dependent objects and then deletes the specified user. - - If **enable\_kill\_query** is **off** and **CASCADE** is used, the statement waits until the processes locking dependent objects stop and then deletes the specified user. - -- If the dependent objects are other databases or reside in other databases, manually delete them before deleting the user from the current database. **DROP USER** cannot delete objects across databases. -- If a data source depends on the user, the user cannot be deleted directly. You need to manually delete the data source first. - -## Syntax - -``` -DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified user does not exist. - -- **user\_name** - - Specifies the name of the user to be deleted. - - Value range: an existing username - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects that depend on the user. - - **RESTRICT**: refuses to delete the user if any objects depend on it. This is the default action. - - >![](public_sys-resources/icon-note.gif) **NOTE:** - >In openGauss, the **enable\_kill\_query** configuration parameter exists in the **postgresql.conf** file. This parameter affects **CASCADE**. - >- If **enable\_kill\_query** is **on** and **CASCADE** is used, the statement automatically kills the processes locking dependent objects and then deletes the specified user. - >- If **enable\_kill\_query** is **off** and **CASCADE** is used, the statement waits until the processes locking dependent objects stop and then deletes the specified user. - - - -## Examples - -See [Example](create-user.md#en-us_topic_0237122125_en-us_topic_0059778166_sfbca773f5bcd4799b3ea668b3eb074fa) in **CREATE USER**. - -## Helpful Links - -[ALTER USER](alter-user.md) and [CREATE USER](create-user.md) - diff --git a/content/en/docs/installation/Developerguide/drop-view.md b/content/en/docs/installation/Developerguide/drop-view.md deleted file mode 100644 index 0fe1597ae89e04fa46e7f10bb429ad8abe5dddaa..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/drop-view.md +++ /dev/null @@ -1,41 +0,0 @@ -# DROP VIEW - -## Function - -**DROP VIEW** forcibly deletes a view from the database. - -## Precautions - -Only the owner of a view or a system administrator has the **DROP VIEW** permission. - -## Syntax - -``` -DROP VIEW [ IF EXISTS ] view_name [, ...] [ CASCADE | RESTRICT ]; -``` - -## Parameter Description - -- **IF EXISTS** - - Reports a notice instead of an error if the specified view does not exist. - -- **view\_name** - - Specifies the name of the view to be deleted. - - Value range: an existing view name - -- **CASCADE | RESTRICT** - - **CASCADE**: automatically deletes the objects \(such as other views\) that depend on the view. - - **RESTRICT**: refuses to delete the view if any objects depend on it. This is the default action. - - -## Examples - -See [Examples](create-view.md#en-us_topic_0237122126_en-us_topic_0059779377_s66a0b4a6a1df4ba4a116c6c565a0fe9d) in **CREATE VIEW**. - -## Helpful Links - -[ALTER VIEW](alter-view.md) and [CREATE VIEW](create-view.md) - diff --git a/content/en/docs/installation/Developerguide/durability-20.md b/content/en/docs/installation/Developerguide/durability-20.md deleted file mode 100644 index 9eedf3031b5466f7505c455fee83f50a8239dbec..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/durability-20.md +++ /dev/null @@ -1,19 +0,0 @@ -# Durability - -NIR - -Write-Ahead Logging \(WAL\) is a standard method for ensuring data durability. WAL's central concept is that changes to data files \(where tables and indexes reside\) must be written only after those changes have been logged, that is, after log records describing the changes have been flushed to permanent storage. - -The MOT is fully integrated with the envelope openGauss/GaussDB logging facilities. Besides durability and additional benefit of this method is being able to use it for replication purposes as well. - -Three logging methods are supported, two standard “Synchronous” and “Asynchronous” which are also supported by the standard disk-engine. In addition, in the MOT a new “Group-Commit” with special NUMA-Awareness optimization is introduced. The Group-Commit provides the top performance while maintaining ACID properties. - -Vladi / Eli: Text text text …a paragraph about the state of the art checkpoint module…. - -- **[Exception Handling](exception-handling.md)** - -- **[Logging](logging-21.md)** - -- **[Checkpoint](checkpoint-22.md)** - - diff --git a/content/en/docs/installation/Developerguide/dynamic-statements.md b/content/en/docs/installation/Developerguide/dynamic-statements.md deleted file mode 100644 index 3a6d5950927ea82d492cc52dc5ce928bdba22899..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dynamic-statements.md +++ /dev/null @@ -1,11 +0,0 @@ -# Dynamic Statements - -- **[Executing Dynamic Query Statements](executing-dynamic-query-statements.md)** - -- **[Executing Dynamic Non-query Statements](executing-dynamic-non-query-statements.md)** - -- **[Dynamically Calling Stored Procedures](dynamically-calling-stored-procedures.md)** - -- **[Dynamically Calling Anonymous Blocks](dynamically-calling-anonymous-blocks.md)** - - diff --git a/content/en/docs/installation/Developerguide/dynamically-calling-anonymous-blocks.md b/content/en/docs/installation/Developerguide/dynamically-calling-anonymous-blocks.md deleted file mode 100644 index 5d9bfa1abe607d89cf21c329b82b684e166bed3e..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dynamically-calling-anonymous-blocks.md +++ /dev/null @@ -1,23 +0,0 @@ -# Dynamically Calling Anonymous Blocks - -This section describes how to execute anonymous blocks in dynamic statements. Append **IN** and **OUT** behind the **EXECUTE IMMEDIATE...USING** statement to input and output parameters. - -## Syntax - -[Figure 1](#en-us_topic_0237122228_en-us_topic_0059778140_fcac14cc166724cca818d8c659b30fbb9) shows the syntax diagram. - -**Figure 1** call\_anonymous\_block::= -![](figures/call_anonymous_block.png "call_anonymous_block") - -[Figure 2](#en-us_topic_0237122228_en-us_topic_0059778140_f06fb8cdac8dc4c42bacd550e446ca6bd) shows the syntax diagram for **using\_clause**. - -**Figure 2** using\_clause::= -![](figures/using_clause-2.png "using_clause-2") - -The above syntax diagram is explained as follows: - -- The execute part of an anonymous block starts with a **BEGIN** statement, has a break with an **END** statement, and ends with a semicolon \(;\). -- **USING \[IN|OUT|IN OUT\]bind\_argument**: specifies where the variable passed to the stored procedure parameter value is stored. The modifiers in front of **bind\_argument** and of the corresponding parameter are the same. -- The input and output parameters in the middle of an anonymous block are designated by placeholders. The numbers of the placeholders and parameters are the same. The sequences of the parameters corresponding to the placeholders and the USING parameters are the same. -- Currently in openGauss, when dynamic statements call anonymous blocks, placeholders cannot be used to pass input and output parameters in an **EXCEPTION** statement. - diff --git a/content/en/docs/installation/Developerguide/dynamically-calling-stored-procedures.md b/content/en/docs/installation/Developerguide/dynamically-calling-stored-procedures.md deleted file mode 100644 index 7128a78dfaee92bc0d4bf86d71a2c5d8adce1623..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/dynamically-calling-stored-procedures.md +++ /dev/null @@ -1,22 +0,0 @@ -# Dynamically Calling Stored Procedures - -This section describes how to dynamically call store procedures. You must use anonymous statement blocks to package stored procedures or statement blocks and append **IN** and **OUT** behind the **EXECUTE IMMEDIATE...USING** statement to input and output parameters. - -## Syntax - -[Figure 1](#en-us_topic_0237122227_en-us_topic_0059778625_f7bf3ce30f4aa42d38394f459c525f33b) shows the syntax diagram. - -**Figure 1** call\_procedure::= -![](figures/call_procedure.png "call_procedure") - -[Figure 2](#en-us_topic_0237122227_en-us_topic_0059778625_fd82a97bfa5774a32bd19b36b80dd5248) shows the syntax diagram for **using\_clause**. - -**Figure 2** using\_clause::= -![](figures/using_clause-1.png "using_clause-1") - -The above syntax diagram is explained as follows: - -- **CALL procedure\_name**: calls the stored procedure. -- **\[:placeholder1,:placeholder2,...\]**: specifies the placeholder list of the stored procedure parameters. The numbers of the placeholders and parameters are the same. -- **USING \[IN|OUT|IN OUT\]bind\_argument**: specifies where the variable passed to the stored procedure parameter value is stored. The modifiers in front of **bind\_argument** and of the corresponding parameter are the same. - diff --git a/content/en/docs/installation/Developerguide/en-us_bookmap_0260488019.md b/content/en/docs/installation/Developerguide/en-us_bookmap_0260488019.md deleted file mode 100644 index 05f4efc2ac6e59eea95c17aef3212683fb2397a3..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/en-us_bookmap_0260488019.md +++ /dev/null @@ -1,143 +0,0 @@ -# openGauss MOT Engine User Manual - 3 - -- [Introducing MOT](introducing-mot.md) - - [MOT Introduction](mot-introduction.md) - - [Features and Benefits](features-and-benefits.md) - - [MOT Key Technologies](mot-key-technologies.md) - - [Usage Scenarios](usage-scenarios.md) - - [Performance Benchmarks](performance-benchmarks.md) - - [Hardware](hardware.md) - - [Results – Summary](results-summary.md) - - [High Throughput](high-throughput.md) - - [ARM/Kunpeng 2-Socket 128 Cores](arm-kunpeng-2-socket-128-cores.md) - - [ARM/Kunpeng 4-Socket 256 Cores](arm-kunpeng-4-socket-256-cores.md) - - [x86-based servers](x86-based-servers.md) - - - [Low Latency](low-latency.md) - - [Recovery / Cold-Start Time](recovery-cold-start-time.md) - - [Resource Utilization](resource-utilization.md) - - [Data Ingestion Speed](data-ingestion-speed.md) - - -- [Using MOT](using-mot.md) - - [Overview](overview.md) - - [Preparation](preparation.md) - - [Prerequisites](prerequisites.md) - - [Memory and Storage Planning](memory-and-storage-planning.md) - - [Memory Planning](memory-planning.md) - - [Storage IO](storage-io.md) - - - - [Deployment](deployment.md) - - [Server Optimization – x86](server-optimization-x86.md) - - [Server Optimization – ARM Huawei Taishan 2P/4P](server-optimization-arm-huawei-taishan-2p-4p.md) - - [MOT Configuration Settings](mot-configuration-settings.md) - - [General Guidelines](general-guidelines.md) - - [REDO LOG \(MOT\)](redo-log-(mot).md) - - [CHECKPOINT \(MOT\)](checkpoint-(mot).md) - - [RECOVERY \(MOT\)](recovery-(mot).md) - - [STATISTICS \(MOT\)](statistics-(mot).md) - - [ERROR LOG \(MOT\)](error-log-(mot).md) - - [MEMORY \(MOT\)](memory-(mot).md) - - [GARBAGE COLLECTION \(MOT\)](garbage-collection-(mot).md) - - [JIT \(MOT\)](jit-(mot).md) - - [STORAGE \(MOT\)](storage-(mot).md) - - [Default MOT.conf](default-mot-conf.md) - - - - [Usage](usage.md) - - [Workflow Overview](workflow-overview.md) - - [Granting User Permissions](granting-user-permissions.md) - - [Creating/Dropping a MOT Table](creating-dropping-a-mot-table.md) - - [Creating an Index for MOT Table](creating-an-index-for-mot-table.md) - - [Converting a Disk Table into a MOT Table](converting-a-disk-table-into-a-mot-table.md) - - [Prerequisite Check](prerequisite-check.md) - - [Converting](converting.md) - - [Conversion Example](conversion-example.md) - - [Query Native Compilation](query-native-compilation.md) - - - [Retrying an Aborted Transaction](retrying-an-aborted-transaction.md) - - [External Support Tools](external-support-tools.md) - - [gs\_ctl \(Full and Incremental\)](gs_ctl-(full-and-incremental).md) - - [gs\_basebackup](gs_basebackup.md) - - [gs\_dump](gs_dump.md) - - [gs\_restore](gs_restore.md) - - - [SQL Coverage and Limitations](sql-coverage-and-limitations.md) - - [Unsupported Features](unsupported-features.md) - - [MOT Table Limitations](mot-table-limitations.md) - - [Unsupported Table DDLs](unsupported-table-ddls.md) - - [Unsupported Data Types](unsupported-data-types.md) - - [Unsupported Index DDLs and Index](unsupported-index-ddls-and-index.md) - - [Unsupported DMLs](unsupported-dmls.md) - - [Unsupported Queries for Native Compilation and Lite Execution](unsupported-queries-for-native-compilation-and-lite-execution.md) - - - - [Administration](administration.md) - - [Durability](durability.md) - - [Configuring Durability](configuring-durability.md) - - [Logging – WAL Redo Log](logging-wal-redo-log.md) - - [Logging Types](logging-types.md) - - [Configuring Logging](configuring-logging.md) - - - [Checkpoints](checkpoints.md) - - [Recovery](recovery.md) - - [Replication and High Availability](replication-and-high-availability.md) - - [Memory Management](memory-management.md) - - [Vacuum](vacuum.md) - - [Statistics](statistics.md) - - [Monitoring](monitoring.md) - - [Error Messages](error-messages.md) - - [Errors Written the Log File](errors-written-the-log-file.md) - - [Errors Returned to the User](errors-returned-to-the-user.md) - - - - [Sample Workloads](sample-workloads.md) - - [TPC-C Benchmark](tpc-c-benchmark.md) - - [TPC-C Introduction](tpc-c-introduction.md) - - [System-Level Optimization](system-level-optimization.md) - - [BenchmarkSQL – An Open-Source TPC-C Tool](benchmarksql-an-open-source-tpc-c-tool.md) - - [Results Report](results-report.md) - - - -- [Concepts of MOT](concepts-of-mot.md) - - [Scale-up Architecture](scale-up-architecture.md) - - [Technical Requirements](technical-requirements.md) - - [Design Principles](design-principles.md) - - [Integration using Foreign Data Wrappers \(FDW\)](integration-using-foreign-data-wrappers-(fdw).md) - - [Result – Linear Scale-up](result-linear-scale-up.md) - - - [Concurrency Control Mechanism](concurrency-control-mechanism.md) - - [Local and Global MOT Memory](local-and-global-mot-memory.md) - - [SILO Enhancements for MOT](silo-enhancements-for-mot.md) - - [Isolation Levels](isolation-levels.md) - - [Optimistic Concurrency Control](optimistic-concurrency-control.md) - - [Optimistic OCC vs. Pessimistic 2PL](optimistic-occ-vs-pessimistic-2pl.md) - - - [OCC vs 2PL Differences by Example](occ-vs-2pl-differences-by-example.md) - - [Pessimistic Approach – Used in Disk-based Tables](pessimistic-approach-used-in-disk-based-tables.md) - - [Optimistic Approach – Used in MOT](optimistic-approach-used-in-mot.md) - - - - [Extended FDW and Other openGauss Features](extended-fdw-and-other-opengauss-features.md) - - [NUMA Awareness Allocation and Affinity](numa-awareness-allocation-and-affinity.md) - - [Indexes](indexes.md) - - [Secondary Index Support](secondary-index-support.md) - - [Non-unique Indexes](non-unique-indexes.md) - - - [Durability](durability-0.md) - - [Exception Handling](exception-handling.md) - - [Logging](logging.md) - - [Overall Architecture](overall-architecture.md) - - - [Checkpoint](checkpoint.md) - - [CALC Checkpoint algorithm: low overhead in memory and compute](calc-checkpoint-algorithm-low-overhead-in-memory-and-compute.md) - - [Checkpoint Activation](checkpoint-activation.md) - - - - [Recovery](recovery-1.md) - - [Query Native Compilation \(JIT\)](query-native-compilation-(jit).md) - - [Comparison – Disk vs. MOT](comparison-disk-vs-mot.md) - - diff --git a/content/en/docs/installation/Developerguide/environment-deployment.md b/content/en/docs/installation/Developerguide/environment-deployment.md deleted file mode 100644 index 2451a906987d45cc262074eefadd821e5e0d5987..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/environment-deployment.md +++ /dev/null @@ -1,231 +0,0 @@ -# Environment Deployment - -## Prerequisites - -openGauss is in the normal state. The user logs in to openGauss with an authenticated identity. The executed SQL syntax is correct and no error is reported. In the historical performance data window, the number of openGauss concurrent tasks is stable, the structure and number of tables remain unchanged, the data volume changes smoothly, and the GUC parameters related to query performance remain unchanged. During prediction, the model has been trained and converged. The running environment of the AIEngine is stable. - -## Request Example - -The AIEngine process communicates with the kernel process using HTTPS. An example request is as follows: - -``` -curl -X POST -d '{"modelName":"modelname"}' -H 'Content-Type: application/json' 'https://IP-address:port/request-API' -``` - -**Table 1** AIEngine external APIs - - - - - - - - - - - - - - - - - - - - - - - - - -

Request API

-

Description

-

/check

-

Checks whether a model is properly started.

-

/configure

-

Sets model parameters.

-

/train

-

Trains a model.

-

/track_process

-

Views model training logs.

-

/setup

-

Loads historical models.

-

/predict

-

Predicts a model.

-
- -## Generating Certificates - -Before using the prediction function, you need to use OpenSSL to generate certificates required for authentication between the communication parties, ensuring communication security. - -1. Set up a certificate generation environment. The certificate file is stored in **$GAUSSHOME/CA**. - - -- Copy the certificate generation script and related files. - - ``` - cp path_to_predictor/install/ssl.sh $GAUSSHOME/ - cp path_to_predictor/install/ca_ext.txt $GAUSSHOME/ - ``` - - -- Copy the configuration file **openssl.cnf** to **$GAUSSHOME**. - - ``` - cp $GAUSSHOME/share/om/openssl.cnf $GAUSSHOME/ - ``` - - -- Modify the configuration parameters in **openssl.conf**. - - ``` - dir = $GAUSSHOME/CA/demoCA - default_md = sha256 - ``` - - -- The certificate generation environment is ready. - -2. Generate a certificate and private key. - - ``` - cd $GAUSSHOME - sh ssl.sh - ``` - - -- Set the password as prompted, for example, **Test@123**. - - -- The password must contain at least eight characters of at least three different types. - - ``` - Please enter your password: - ``` - - -- Set the options as prompted. - - ``` - Certificate Details: - Serial Number: 1 (0x1) - Validity - Not Before: May 15 08:32:44 2020 GMT - Not After : May 15 08:32:44 2021 GMT - Subject: - countryName = CN - stateOrProvinceName = SZ - organizationName = HW - organizationalUnitName = GS - commonName = CA - X509v3 extensions: - X509v3 Basic Constraints: - CA:TRUE - Certificate is to be certified until May 15 08:32:44 2021 GMT (365 days) - Sign the certificate? [y/n]:y - 1 out of 1 certificate requests certified, commit? [y/n]y - ``` - - -- Enter the IP address for starting the AIEngine, for example, **127.0.0.1**. - - ``` - Please enter your aiEngine IP: 127.0.0.1 - ``` - - -- Set the options as prompted. - - ``` - Certificate Details: - Serial Number: 2 (0x2) - Validity - Not Before: May 15 08:38:07 2020 GMT - Not After : May 13 08:38:07 2030 GMT - Subject: - countryName = CN - stateOrProvinceName = SZ - organizationName = HW - organizationalUnitName = GS - commonName = 127.0.0.1 - X509v3 extensions: - X509v3 Basic Constraints: - CA:FALSE - Certificate is to be certified until May 13 08:38:07 2030 GMT (3650 days) - Sign the certificate? [y/n]:y - 1 out of 1 certificate requests certified, commit? [y/n]y - ``` - - -- Enter the IP address for starting openGauss, for example, **127.0.0.1**. - - ``` - Please enter your gaussdb IP: 127.0.0.1 - ``` - - -- Set the options as prompted. - - ``` - Certificate Details: - Serial Number: 3 (0x3) - Validity - Not Before: May 15 08:41:46 2020 GMT - Not After : May 13 08:41:46 2030 GMT - Subject: - countryName = CN - stateOrProvinceName = SZ - organizationName = HW - organizationalUnitName = GS - commonName = 127.0.0.1 - X509v3 extensions: - X509v3 Basic Constraints: - CA:FALSE - Certificate is to be certified until May 13 08:41:46 2030 GMT (3650 days) - Sign the certificate? [y/n]:y - 1 out of 1 certificate requests certified, commit? [y/n]y - ``` - - -- The related certificate and key have been generated. The content in **$GAUSSHOME/CA** is as follows: - - ![](figures/en-us_image_0253082069.png) - - -## Setting Up the Environment - -1. Copy the tool code folder to the target environment. - - -- Assume that the installation directory is **$INSTALL\_FOLDER**. - - -- Assume that the destination directory is **/home/ai\_user**. - - ``` - scp -r $INSTALL_FOLDER/bin/dbmind/predictor ai_user@127.0.0.1:path_to_Predictor - ``` - -2. Copy the CA certificate folder to a directory in the AIEngine environment. - - ``` - cp -r $GAUSSHOME/CA ai_user@127.0.0.1:path_to_CA - ``` - -3. Install the **predictor/install/requirements\(-gpu\).txt** tool. - - ``` - With GPU: pip install -r requirements-gpu.txt - Without GPU: pip install -r requirements.txt - ``` - - -## Starting AIEngine - -1. Switch to the AIEngine environment \(that is, copy the target environment **ai\_user** of the predictor\). - - Set parameters in **predictor/python/settings.py**. - - ``` - DEFAULT_FLASK_SERVER_HOST = '127.0.0.1' (running IP address of AIEngine) - DEFAULT_FLASK_SERVER_PORT = '5000' (running port number of AIEngine) - PATH_SSL = "path_to_CA" (CA folder path) - ``` - -2. Run the startup script of AIEngine. - - ``` - python path_to_Predictor/python/run.py - ``` - - In this case, the AIEngine keeps enabled on the corresponding port and waits for the request of the time prediction function from the kernel. - - For details about how to initiate a time prediction command from the kernel, see the _Time Prediction Usage Guide_. - - diff --git a/content/en/docs/installation/Developerguide/error-log.md b/content/en/docs/installation/Developerguide/error-log.md deleted file mode 100644 index 8080403f4a4a8ba1f272ad992c948297acb548fe..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/error-log.md +++ /dev/null @@ -1,29 +0,0 @@ -# ERROR LOG - -- **log\_level = INFO** - - Configures the log level of messages issued by the MOT engine and recorded in the Error log of the database server. Valid values are PANIC, ERROR, WARN, INFO, TRACE, DEBUG, DIAG1 and DIAG2. - -- **Log/COMPONENT/LOGGER=LOG\_LEVEL** - - Configures specific loggers using the syntax described below. - - For example, to configure the TRACE log level for the ThreadIdPool logger in system component, use the following syntax – - - ``` - Log/System/ThreadIdPool=TRACE - ``` - - To configure the log level for all loggers under some component, use the following syntax. - - ``` - Log/COMPONENT=LOG_LEVEL - ``` - - For example: - - ``` - Log/System=DEBUG - ``` - - diff --git a/content/en/docs/installation/Developerguide/error-reporting-and-logging.md b/content/en/docs/installation/Developerguide/error-reporting-and-logging.md deleted file mode 100644 index 980d2ad9e639941b5529ed23f3429c2f1f0f855d..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/error-reporting-and-logging.md +++ /dev/null @@ -1,11 +0,0 @@ -# Error Reporting and Logging - -- **[Logging Destination](logging-destination.md)** - -- **[Logging Time](logging-time.md)** - -- **[Logging Content](logging-content.md)** - -- **[Using CSV Log Output](using-csv-log-output.md)** - - diff --git a/content/en/docs/installation/Developerguide/error-trapping-statements.md b/content/en/docs/installation/Developerguide/error-trapping-statements.md deleted file mode 100644 index 5bb6d5faf7f5012fd9a169002f382f70ee32fb80..0000000000000000000000000000000000000000 --- a/content/en/docs/installation/Developerguide/error-trapping-statements.md +++ /dev/null @@ -1,112 +0,0 @@ -# Error Trapping Statements - -By default, any error occurring in a PL/SQL function aborts execution of the function, and indeed of the surrounding transaction as well. You can trap errors and restore from them by using a **BEGIN** block with an **EXCEPTION** clause. The syntax is an extension of the normal syntax for a **BEGIN** block: - -``` -[<

Basic port number of the database node. The default value is 40000.

dataListenIp1

+

Listening IP address. If this parameter is not set, the value is determined based on backIp1 of the corresponding host.

+

The first and second IP addresses are the IP addresses of the hosts where the primary and standby nodes reside, respectively.

+

dataNode1

Directory for storing data of the database nodes on the current host. It is a data storage directory, and should be on a data disk.

diff --git a/content/en/docs/installation/figures/en-us_image_0283136470.png b/content/en/docs/installation/figures/en-us_image_0283136470.png index 3367550c342f032d6a9936a66cce7bfc29310fdc..d30298d2ce1a7eb052419af5e16be4b23055829a 100644 Binary files a/content/en/docs/installation/figures/en-us_image_0283136470.png and b/content/en/docs/installation/figures/en-us_image_0283136470.png differ diff --git a/content/en/docs/installation/figures/en-us_image_0283136486.png b/content/en/docs/installation/figures/en-us_image_0283136486.png index 8566842bf37a0e35aeb7f3ea449dbc836732dea1..747b55cb629aaf9e323d0ba4492ddce1137e22f3 100644 Binary files a/content/en/docs/installation/figures/en-us_image_0283136486.png and b/content/en/docs/installation/figures/en-us_image_0283136486.png differ diff --git a/content/en/docs/installation/initializing-the-database.md b/content/en/docs/installation/initializing-the-database.md index 1e675c5815ce2c3c5fc223ed9fad3c8948b24140..0abe60ecbfa41cefe2985af252e4f15a49bd4a90 100644 --- a/content/en/docs/installation/initializing-the-database.md +++ b/content/en/docs/installation/initializing-the-database.md @@ -2,6 +2,9 @@ Use SQL to create a database. +>![](C:/Users/gongsiyi/Desktop/test/05-openGauss Installation Guide/public_sys-resources/icon-note.gif) **NOTE:** +>To ensure security, change the initial password of user **omm** after the first login. + When using an SQL statement to create a database, set the character set to **GBK**. ``` diff --git a/content/en/docs/installation/initializing-the-installation-environment.md b/content/en/docs/installation/initializing-the-installation-environment.md index 5bbe1f3ce5ad8ba3d1550b3e39ff703a22350648..4b3e53fb8744b886370b3fe1855776abd96ca90e 100644 --- a/content/en/docs/installation/initializing-the-installation-environment.md +++ b/content/en/docs/installation/initializing-the-installation-environment.md @@ -95,7 +95,7 @@ Executing the **gs\_preinstall** script enables the system to automatically co ./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml ``` - **omm** is the database administrator \(also the OS user running the openGauss\), **dbgrp** is the group name of the OS user running the openGauss, and **/opt/software/openGauss/cluster\_config.xml** is the path of the openGauss configuration file. During the execution, you need to determine whether to establish mutual trust as prompted and enter the password of user **root** or the openGauss user. + **omm** is the database administrator \(also the OS user running the openGauss\), **dbgrp** is the group name of the OS user running the openGauss, and **/opt/software/openGauss/cluster\_config.xml** is the path of the openGauss configuration file. During the execution, you need to determine whether to establish mutual trust as prompted and enter the password of the OS user **root** or the user omm. - If the mutual trust between users **root** cannot be created, create the **omm** user, perform local preinstallation on each host, and manually create the mutual trust between openGauss users. If the **-L** parameter is specified during preinstallation, manually write the mapping between the host names and IP addresses of all nodes to the **/etc/hosts** file of each host before preinstallation, add **\#Gauss OM IP Hosts Mapping** to the end of each mapping. 1. Run the following command to configure the installation environment: diff --git a/content/en/docs/installation/obtaining-and-verifying-an-installation-package.md b/content/en/docs/installation/obtaining-and-verifying-an-installation-package.md index d7c0dde3de8895854d732e9e2c69fb26e18c47fc..e8b1bdac1bcb8ce087a8f8ce1cdf2eb2c338812c 100644 --- a/content/en/docs/installation/obtaining-and-verifying-an-installation-package.md +++ b/content/en/docs/installation/obtaining-and-verifying-an-installation-package.md @@ -4,8 +4,8 @@ You can obtain the installation package from the openGauss open-source community ## Procedure -1. Download the installation package of the corresponding platform from the openGauss community. -a. Click [https://opengauss.org/en/download.html](https://opengauss.org/zh/download.html) to go to download page of openGauss open-source community. You can download the installation packages listed in [Table 1](#en-us_topic_0241805803_en-us_topic_0085434653_en-us_topic_0059781995_te4a9d557337c400c85acff184476a722) as required. +1. Download the installation package of the corresponding platform from the openGauss community. +a. Log in to the openGauss open-source community at [https://opengauss.org/en/download.html](https://opengauss.org/en/download.html) and download the corresponding installation package. **Figure 1** openGauss Server @@ -50,7 +50,7 @@ a. Click [https://opengauss.org/en/download.html](https://opengauss.org/zh/dow ``` tar -zxvf openGauss-1.0.1-openEuler-64bit.tar.gz - ls -1 + ls -1b ``` Run the **ls** command and information similar to the following is displayed. diff --git a/content/en/docs/installation/preparing-the-software-and-hardware-installation-environment.md b/content/en/docs/installation/preparing-the-software-and-hardware-installation-environment.md index 676af17cb2d5f35d6b9429f527eaa753d5544567..08b9ec3fabdc08884ca64f7c42ccd288e2fb0ed4 100644 --- a/content/en/docs/installation/preparing-the-software-and-hardware-installation-environment.md +++ b/content/en/docs/installation/preparing-the-software-and-hardware-installation-environment.md @@ -4,9 +4,18 @@ This chapter describes the preparations for the installation. -- [Software and Hardware Requirements](#software-and-hardware-requirements) -- [Modifying OS Configuration](#modifying-os-configuration) -- [Setting Remote Login of User root](#setting-remote-login-of-user-root) +- [Preparing the Software and Hardware Installation Environment](#preparing-the-software-and-hardware-installation-environmenta-nameen-us_topic_0249784586a) + - [Software and Hardware Requirements](#software-and-hardware-requirements) + - [Hardware Requirements](#hardware-requirements) + - [Software Requirements](#software-requirements) + - [Software Dependency Requirements](#software-dependency-requirements) + - [Modifying OS Configuration](#modifying-os-configuration) + - [Disabling the OS Firewall](#disabling-the-os-firewall) + - [Setting Character Set Parameters](#setting-character-set-parameters) + - [Setting the Time Zone and Time](#setting-the-time-zone-and-time) + - [Disabling the Swap Memory](#disabling-the-swap-memory) + - [Setting the NIC MTU](#setting-the-nic-mtu) + - [Setting Remote Login of User root](#setting-remote-login-of-user-root) @@ -222,44 +231,43 @@ Take openEuler OS as an example. Assume that the openGauss information is listed Currently, EulerOS can be installed only when the firewall is disabled. -1. Check whether the firewall is disabled. +1. Set the value of **SELINUX** in the **/etc/selinux/config** file to **disabled**. + a. Run the **vim** command to open the **config** file. - ``` - systemctl status firewalld - ``` - - If the firewall is not disabled, go to [2](#en-us_topic_0241802566_en-us_topic_0085434636_en-us_topic_0059782018_li11887129193617). + ``` + vim /etc/selinux/config + ``` + b. Change the value of **SELINUX** to **disabled** and run the **:wq** command to save the change and exit. - If the firewall is disabled, skip [2](#en-us_topic_0241802566_en-us_topic_0085434636_en-us_topic_0059782018_li11887129193617). + ``` + SELINUX=disabled + ``` -2. Disable the firewall. - ``` - systemctl disable firewalld.service - systemctl stop firewalld.service - ``` +2. Restart the OS. -3. Set the value of **SELINUX** in the **/etc/selinux/config** file to **disabled**. + ``` + reboot + ``` - a.Run the **vim** command to open the **config** file. +3. Check whether the firewall is disabled. - ``` - vim /etc/selinux/config - ``` + ``` + systemctl status firewalld + ``` - b.Set the value of **SELINUX** to **disabled**. + If the firewall status is **active \(running\)**, the firewall is not disabled. Go to [4](#li17330102819394). - ``` - SELINUX=disabled - ``` + If the firewall status is **inactive \(dead\)**, you do not need to disable the firewall. -4. Restart the OS. +4. Disable the firewall. - ``` - reboot - ``` + ``` + systemctl disable firewalld.service + systemctl stop firewalld.service + ``` -5. Repeat steps 1 to 3 on other hosts. +5. Repeat steps 1 to 4 on other hosts. ### Setting Character Set Parameters @@ -283,7 +291,7 @@ _$Locale/$Time zone_ indicates the locale and time zone to be set, for example, Run the **date -s** command to set the time of each host to the same time. For example: ``` -date -s Mon May 11 16:42:11 CST 2020 +date -s "Sat Sep 27 16:00:07 CST 2020" ``` ![](public_sys-resources/icon-note.gif) **NOTE:** @@ -309,57 +317,60 @@ ifconfig NIC ID mtu Value During the openGauss installation, the user **root** is required for remote login. This section describes how to set the user **root** for remote login. -1. Modify the **PermitRootLogin** configuration to enable remote login of user **root**. - -a. Open the **sshd\_config** file. - +1. Modify the **PermitRootLogin** configuration to enable remote login of user **root**. + + a. Open the **sshd\_config** file. + ``` vim /etc/ssh/sshd_config ``` - - b. Modify permissions of user **root** using either of the following methods: - - Comment out **PermitRootLogin no**. - - #PermitRootLogin no - - - Set the value of **PermitRootLogin** to **yes**. - - - PermitRootLogin yes - - - c. Run the **:wq** command to save the modification and exit. - -2. Modify the **Banner** configuration to delete the welcome information displayed when you connect to the system. The welcome information affects the return result of remote operations during the installation. - a. Open the **sshd\_config** file. + b. Modify permissions of user **root** using either of the following methods: - ``` - vim /etc/ssh/sshd_config - ``` + - Comment out **PermitRootLogin no**. - b. Comment out the line where **Banner** is located. + ``` + #PermitRootLogin no + ``` - ``` - #Banner XXXX - ``` + - Set the value of **PermitRootLogin** to **yes**. + + ``` + PermitRootLogin yes + ``` + + c. Run the **:wq** command to save the modification and exit. + +2. Modify the **Banner** configuration to delete the welcome information displayed when you connect to the system. The welcome information affects the return result of remote operations during the installation. + + a. Open the **sshd\_config** file. + + ``` + vim /etc/ssh/sshd_config + ``` + + b. Comment out the line where **Banner** is located. - c. Run the **:wq** command to save the modification and exit. + ``` + #Banner XXXX + ``` + + c. Run the **:wq** command to save the modification and exit. 3. Run the following command to validate the settings: - ``` - service sshd restart - ``` + ``` + service sshd restart + ``` - ![](public_sys-resources/icon-caution.gif) **CAUTION:** + ![](public_sys-resources/icon-caution.gif) **CAUTION:** If **Redirecting to /bin/systemctl restart sshd.service** is displayed, run the **/bin/systemctl restart sshd.service** command. 4. Re-log in to the system as user **root**. - ``` - ssh xxx.xxx.xxx.xxx - ``` + ``` + ssh xxx.xxx.xxx.xxx + ``` - ![](public_sys-resources/icon-note.gif) **NOTE:** + ![](public_sys-resources/icon-note.gif) **NOTE:** _xxx.xxx.xxx.xxx_ indicates the IP address of the openGauss installation environment. diff --git a/content/en/menu/index.md b/content/en/menu/index.md index f1770585da1f9fb70c1a00d21a5a321604a08911..e07f89b3ccbde877c61a7cb37e0ab77bf336a6f8 100644 --- a/content/en/menu/index.md +++ b/content/en/menu/index.md @@ -76,7 +76,6 @@ headless: true - [Cost-based Vacuum Delay]({{< relref "./docs/Developerguide/cost-based-vacuum-delay.md" >}}) - [Background Writer]({{< relref "./docs/Developerguide/background-writer.md" >}}) - [Asynchronous I/O Operations]({{< relref "./docs/Developerguide/asynchronous-i-o-operations.md" >}}) - - [Parallel Data Import]({{< relref "./docs/Developerguide/parallel-data-import.md" >}}) - [Write Ahead Log]({{< relref "./docs/Developerguide/write-ahead-log.md" >}}) - [Settings]({{< relref "./docs/Developerguide/settings.md" >}}) - [Checkpoints]({{< relref "./docs/Developerguide/checkpoints-41.md" >}}) @@ -124,7 +123,7 @@ headless: true - [Query]({{< relref "./docs/Developerguide/query-28.md" >}}) - [System Performance Snapshot]({{< relref "./docs/Developerguide/system-performance-snapshot.md" >}}) - [FAQs]({{< relref "./docs/Quickstart/faqs.md" >}}) - + - [Installation Guide]({{< relref "./docs/Installation/Installation.md" >}}) - [Installation Overview]({{< relref "./docs/Installation/installation-overview.md" >}}) - [Preparing for Installation]({{< relref "./docs/Installation/preparing-for-installation.md" >}}) @@ -1165,7 +1164,6 @@ headless: true - [Cost-based Vacuum Delay]({{< relref "./docs/Developerguide/cost-based-vacuum-delay.md" >}}) - [Background Writer]({{< relref "./docs/Developerguide/background-writer.md" >}}) - [Asynchronous I/O Operations]({{< relref "./docs/Developerguide/asynchronous-i-o-operations.md" >}}) - - [Parallel Data Import]({{< relref "./docs/Developerguide/parallel-data-import.md" >}}) - [Write Ahead Log]({{< relref "./docs/Developerguide/write-ahead-log.md" >}}) - [Settings]({{< relref "./docs/Developerguide/settings.md" >}}) - [Checkpoints]({{< relref "./docs/Developerguide/checkpoints-41.md" >}}) @@ -1242,7 +1240,7 @@ headless: true - [An Error Occurs During Integer Conversion]({{< relref "./docs/Developerguide/an-error-occurs-during-integer-conversion.md" >}}) - ["too many clients already" Is Reported or Threads Failed To Be Created in High Concurrency Scenarios]({{< relref "./docs/Developerguide/too-many-clients-already-is-reported-or-threads-failed-to-be-created-in-high-concurrency-scenarios.md" >}}) - [B-tree Index Faults]({{< relref "./docs/Developerguide/b-tree-index-faults.md" >}}) - + - [Tool Reference]({{< relref "./docs/Toolreference/Toolreference.md" >}}) - [Tool Overview]({{< relref "./docs/Toolreference/tool-overview.md" >}}) - [Client Tool]({{< relref "./docs/Toolreference/client-tool.md" >}}) diff --git "a/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md" "b/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md" index c404d4e84eee94afa22f0371a100ad603afe1ca2..a992b351eeb1413702705d7dc2f5fa74af9f500a 100644 --- "a/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md" +++ "b/content/zh/docs/Compilationguide/\346\220\255\345\273\272\347\274\226\350\257\221\347\216\257\345\242\203.md" @@ -22,7 +22,7 @@ openGauss支持的操作系统： **软件依赖要求** -编译openGauss的软件依赖要求如[表 软件依赖要求](#table1212531681911)所示。 +编译openGauss的软件依赖要求如[表 1 软件依赖要求](#table1212531681911)所示。 建议使用上述操作系统安装光盘或者源中，下列依赖软件的默认安装包，若不存在下列软件，可参看软件对应的建议版本。 diff --git "a/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md" "b/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md" index 56cbe76e7bf4d343e2990bef01437f7a729704fb..c08f24b58ee228278098e5b3a8155cd467c17683 100644 --- "a/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md" +++ "b/content/zh/docs/Compilationguide/\347\211\210\346\234\254\347\274\226\350\257\221.md" @@ -102,7 +102,7 @@ openGauss的编译，需要提前把所依赖的开源第三方软件进行编
-同时需要下载gcc8.2.0的源码包[gcc-8.2.0.zip](https://github.com/gcc-mirror/gcc/archive/releases/gcc-8.2.0.zip)或者[gcc-8.2.0.tar.gz](https://github.com/gcc-mirror/gcc/archive/releases/gcc-8.2.0.tar.gz)，并将其拷贝至对应位置。例如，开源三方件下载目录为/sda/openGauss-third\_party，则需要将gcc的源码包拷贝至/sda/openGauss-third\_party/buildtools/gcc/路径下。在安装完[表 openGauss开源三方件编译前置软件要求](#table1212531681911)中的软件、gcc8.2.0的源码包下载并拷贝至对应的路径后，请将python默认版本指向python3.x并执行如下操作： +同时需要下载gcc8.2.0的源码包[gcc-8.2.0.zip](https://github.com/gcc-mirror/gcc/archive/releases/gcc-8.2.0.zip)或者[gcc-8.2.0.tar.gz](https://github.com/gcc-mirror/gcc/archive/releases/gcc-8.2.0.tar.gz)，并将其拷贝至对应位置。例如，开源三方件下载目录为/sda/openGauss-third\_party，则需要将gcc的源码包拷贝至/sda/openGauss-third\_party/buildtools/gcc/路径下。在安装完[表 1 openGauss开源三方件编译前置软件要求](#table1212531681911)中的软件、gcc8.2.0的源码包下载并拷贝至对应的路径后，请将python默认版本指向python3.x并执行如下操作： 1. 执行如下命令进入内核依赖的开源第三方软件目录，进行开源第三方软件的编译和构建，产生相应的二进制程序或库文件。/sda/openGauss-third\_party为开源第三方软件下载目录。 @@ -314,7 +314,7 @@ openGauss-server/build.sh是编译过程中的重要脚本工具。其集成了 - release: 代表生成release版本的二进制程序，该版本编译时，配置GCC高级别优化选项，去除内核调试代码，通常用于生产环境或性能测试环境。 - - debug：代表生成debug版本的二进制程序，该版本编译时，增加内核代码调试功能，通常用于开发自测环境； + - debug：代表生成debug版本的二进制程序，该版本编译时，增加内核代码调试功能，通常用于开发自测环境。 - memcheck：代表生成memcheck版本的二进制程序，该版本编译时，在debug版本基础上新增ASAN功能，通常用于定位内存问题。 diff --git a/content/zh/docs/Developerguide/ALTER-DIRECTORY.md b/content/zh/docs/Developerguide/ALTER-DIRECTORY.md index 7172605b1e338d836ad45b9b01b67b1f1f81cdae..7d5e71476823d693d6f5ec4b79ed64feddadeac0 100644 --- a/content/zh/docs/Developerguide/ALTER-DIRECTORY.md +++ b/content/zh/docs/Developerguide/ALTER-DIRECTORY.md @@ -31,7 +31,7 @@ postgres=# CREATE OR REPLACE DIRECTORY dir as '/tmp/'; --修改目录的owner。 postgres=# ALTER DIRECTORY dir OWNER TO system; ---删除外部表。 +--删除目录。 postgres=# DROP DIRECTORY dir; ``` diff --git a/content/zh/docs/Developerguide/ALTER-SEQUENCE.md b/content/zh/docs/Developerguide/ALTER-SEQUENCE.md index 555b5ed5408d37ea3ba350570d279daa24ba5bed..3cb259dc05133ea30776fcd8c26ce5e86d93e080 100644 --- a/content/zh/docs/Developerguide/ALTER-SEQUENCE.md +++ b/content/zh/docs/Developerguide/ALTER-SEQUENCE.md @@ -65,7 +65,7 @@ postgres=# CREATE TABLE T1(C1 bigint default nextval('serial')); --将序列serial的归属列变为T1.C1。 postgres=# ALTER SEQUENCE serial OWNED BY T1.C1; ---删除序列 +--删除序列和表。 postgres=# DROP SEQUENCE serial cascade; postgres=# DROP TABLE T1; ``` diff --git a/content/zh/docs/Developerguide/CREATE-DIRECTORY.md b/content/zh/docs/Developerguide/CREATE-DIRECTORY.md index 1bdd629027acf9f1dcdafd7852847df40a45e8d5..2365f46e2b9e112a59f8e7f8ab1df248313f15e1 100644 --- a/content/zh/docs/Developerguide/CREATE-DIRECTORY.md +++ b/content/zh/docs/Developerguide/CREATE-DIRECTORY.md @@ -33,7 +33,7 @@ AS 'path_name'; 目录名称。 - 取值范围：字符串，要符标识符的命名规范。 + 取值范围：字符串，要符合标识符的命名规范。 - **path\_name** diff --git a/content/zh/docs/Developerguide/CREATE-ROW-LEVEL-SECURITY-POLICY.md b/content/zh/docs/Developerguide/CREATE-ROW-LEVEL-SECURITY-POLICY.md index c7663f9d0f5fee600fe0746cb5c037eddc5beec7..0a32c561688c77c9fbb406211a644d164605787a 100644 --- a/content/zh/docs/Developerguide/CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/content/zh/docs/Developerguide/CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -16,8 +16,8 @@ ## 注意事项 -- 支持对行存表、行存分区表、列存表、列存分区表、复制表、unlogged表、hash表定义行访问控制策略。 -- 不支持外表、临时表定义行访问控制策略。 +- 支持对行存表、行存分区表、列存表、列存分区表、unlogged表、hash表定义行访问控制策略。 +- 不支持外表、本地临时表定义行访问控制策略。 - 不支持对视图定义行访问控制策略。 - 同一张表上可以创建多个行访问控制策略，一张表最多创建100个行访问控制策略。 - 系统管理员不受行访问控制影响，可以查看表的全量数据。 @@ -43,18 +43,6 @@ CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name 行访问控制策略的表名。 -- **PERMISSIVE | RESTRICTIVE** - - PERMISSIVE指定行访问控制策略为宽容性策略。宽容性策略的条件用OR表达式拼接。 - - RESTRICTIVE指定行访问控制策略为限制性策略。限制性策略的条件用AND表达式拼接。拼接方式如下： - - ``` -(using_expression_permissive_1 OR using_expression_permissive_2 ...) AND (using_expression_restrictive_1 AND using_expression_restrictive_2 ...) - ``` - - 缺省值为PERMISSIVE。 - - **command** 当前行访问控制影响的SQL操作，可指定操作包括：ALL、SELECT、UPDATE、DELETE。当未指定时，ALL为默认值，涵盖SELECT、UPDATE、DELETE操作。 @@ -67,7 +55,7 @@ CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name 行访问控制策略与适配的SQL语法关系参加下表： - **表 1** ROW LEVEL SECURITY策略与适配SQL语法关系 + **表 1** ROW LEVLEL SECURITY策略与适配SQL语法关系 - - -

Command

@@ -158,10 +146,10 @@ CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name ``` --创建用户alice -postgres=# CREATE ROLE alice PASSWORD 'Gauss@123'; +postgres=# CREATE USER alice PASSWORD 'Gauss@123'; --创建用户bob -postgres=# CREATE ROLE bob PASSWORD 'Gauss@123'; +postgres=# CREATE USER bob PASSWORD 'Gauss@123'; --创建数据表all_data postgres=# CREATE TABLE all_data(id int, role varchar(100), data varchar(100)); @@ -192,7 +180,6 @@ Row Level Security Policies: POLICY "all_data_rls" USING (((role)::name = "current_user"())) Has OIDs: no -Location Nodes: ALL DATANODES Options: orientation=row, compression=no, enable_rowsecurity=true --当前用户执行SELECT操作 @@ -207,10 +194,8 @@ postgres=# SELECT * FROM all_data; postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; QUERY PLAN ---------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data -(3 rows) + Seq Scan on all_data +(1 rows) --切换至alice用户执行SELECT操作 postgres=# SELECT * FROM all_data; @@ -220,17 +205,15 @@ postgres=# SELECT * FROM all_data; (1 row) postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; - QUERY PLAN + QUERY PLAN ---------------------------------------------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data - Filter: ((role)::name = 'alice'::name) + Seq Scan on all_data + Filter: ((role)::name = 'alice'::name) Notice: This query is influenced by row level security feature -(5 rows) +(3 rows) ``` ## 相关链接 -[DROP ROW LEVEL SECURITY POLICY](DROP-ROW-LEVEL-SECURITY-POLICY.md) +[DROP ROW LEVEL SECURITY POLICY](DROP-ROW-LEVEL-SECURITY-POLICY.md)，[ALTER ROW LEVEL SECURITY POLICY](alter-row-level-security-policy.md) diff --git a/content/zh/docs/Developerguide/CREATE-ROW-LEVLEL-SECURITY-POLICY.md b/content/zh/docs/Developerguide/CREATE-ROW-LEVLEL-SECURITY-POLICY.md deleted file mode 100644 index acc5d59f8a6b9da195814a56260c0b730e77a387..0000000000000000000000000000000000000000 --- a/content/zh/docs/Developerguide/CREATE-ROW-LEVLEL-SECURITY-POLICY.md +++ /dev/null @@ -1,224 +0,0 @@ -# CREATE ROW LEVLEL SECURITY POLICY - -## 功能描述 - -对表创建行访问控制策略。 - -当对表创建了行访问控制策略，只有打开该表的行访问控制开关\(ALTER TABLE ... ENABLE ROW LEVEL SECURITY\)，策略才能生效。否则不生效。 - -当前行访问控制影响数据表的读取操作\(SELECT、UPDATE、DELETE\)，暂不影响数据表的写入操作\(INSERT、MERGE INTO\)。表所有者或系统管理员可以在USING子句中创建表达式，在客户端执行数据表读取操作时，数据库后台在查询重写阶段会将满足条件的表达式拼接并应用到执行计划中。针对数据表的每一条元组，当USING表达式返回TRUE时，元组对当前用户可见，当USING表达式返回FALSE或NULL时，元组对当前用户不可见。 - -行访问控制策略名称是针对表的，同一个数据表上不能有同名的行访问控制策略；对不同的数据表，可以有同名的行访问控制策略。 - -行访问控制策略可以应用到指定的操作\(SELECT、UPDATE、DELETE、ALL\)，ALL表示会影响SELECT、UPDATE、DELETE三种操作；定义行访问控制策略时，若未指定受影响的相关操作，默认为ALL。 - -行访问控制策略可以应用到指定的用户\(角色\)，也可应用到全部用户\(PUBLIC\)；定义行访问控制策略时，若未指定受影响的用户，默认为PUBLIC。 - -## 注意事项 - -- 支持对行存表、行存分区表、列存表、列存分区表、复制表、unlogged表、hash表定义行访问控制策略。 -- 不支持外表、临时表定义行访问控制策略。 -- 不支持对视图定义行访问控制策略。 -- 同一张表上可以创建多个行访问控制策略，一张表最多创建100个行访问控制策略。 -- 系统管理员不受行访问控制影响，可以查看表的全量数据。 -- 通过SQL语句、视图、函数、存储过程查询包含行访问控制策略的表，都会受影响。 - -## 语法格式 - -``` -CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name - [ AS { PERMISSIVE | RESTRICTIVE } ] - [ FOR { ALL | SELECT | INSERT | UPDATE | DELETE } ] - [ TO { role_name | PUBLIC | CURRENT_USER | SESSION_USER } [, ...] ] - USING ( using_expression ) -``` - -## 参数说明 - -- **policy\_name** - - 行访问控制策略名称，同一个数据表上行访问控制策略名称不能相同。 - -- **table\_name** - - 行访问控制策略的表名。 - -- **command** - - 当前行访问控制影响的SQL操作，可指定操作包括：ALL、SELECT、UPDATE、DELETE。当未指定时，ALL为默认值，涵盖SELECT、UPDATE、DELETE操作。 - - 当command为SELECT时，SELECT类操作受行访问控制的影响，只能查看到满足条件\(using\_expression返回值为TRUE\)的元组数据，受影响的操作包括SELECT，UPDATE ... RETURNING，DELETE ... RETURNING。 - - 当command为UPDATE时，UPDATE类操作受行访问控制的影响，只能更新满足条件\(using\_expression返回值为TRUE\)的元组数据，受影响的操作包括UPDATE, UPDATE ... RETURNING, SELECT ... FOR UPDATE/SHARE。 - - 当command为DELETE时，DELETE类操作受行访问控制的影响，只能删除满足条件\(using\_expression返回值为TRUE\)的元组数据，受影响的操作包括DELETE, DELETE ... RETURNING。 - - 行访问控制策略与适配的SQL语法关系参加下表： - - **表 1** ROW LEVLEL SECURITY策略与适配SQL语法关系 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Command

-

SELECT/ALL policy

-

UPDATE/ALL policy

-

DELETE/ALL policy

-

SELECT

-

Existing row

-

No

-

No

-

SELECT FOR UPDATE/SHARE

-

Existing row

-

Existing row

-

No

-

UPDATE

-

No

-

Existing row

-

No

-

UPDATE RETURNING

-

Existing row

-

Existing row

-

No

-

DELETE

-

No

-

No

-

Existing row

-

DELETE RETURNING

-

Existing row

-

No

-

Existing row

-
- -- **role\_name** - - 行访问控制影响的数据库用户。 - - 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - - >![](public_sys-resources/icon-notice.gif) **须知：** - >系统管理员不受行访问控制特性影响。 - - -- **using\_expression** - - 行访问控制的表达式（返回boolean值）。 - - 条件表达式中不能包含AGG函数和窗口（WINDOW）函数。在查询重写阶段，如果数据表的行访问控制开关打开，满足条件的表达式会添加到计划树中。针对数据表的每条元组，会进行表达式计算，只有表达式返回值为TRUE时，行数据对用户才可见（SELECT、UPDATE、DELETE）；当表达式返回FALSE时，该元组对当前用户不可见，用户无法通过SELECT语句查看此元组，无法通过UPDATE语句更新此元组，无法通过DELETE语句删除此元组。 - - -## 示例 - -``` ---创建用户alice -postgres=# CREATE ROLE alice PASSWORD 'Gauss@123'; - ---创建用户bob -postgres=# CREATE ROLE bob PASSWORD 'Gauss@123'; - ---创建数据表all_data -postgres=# CREATE TABLE all_data(id int, role varchar(100), data varchar(100)); - ---向数据表插入数据 -postgres=# INSERT INTO all_data VALUES(1, 'alice', 'alice data'); -postgres=# INSERT INTO all_data VALUES(2, 'bob', 'bob data'); -postgres=# INSERT INTO all_data VALUES(3, 'peter', 'peter data'); - ---将表all_data的读取权限赋予alice和bob用户 -postgres=# GRANT SELECT ON all_data TO alice, bob; - ---打开行访问控制策略开关 -postgres=# ALTER TABLE all_data ENABLE ROW LEVEL SECURITY; - ---创建行访问控制策略，当前用户只能查看用户自身的数据 -postgres=# CREATE ROW LEVEL SECURITY POLICY all_data_rls ON all_data USING(role = CURRENT_USER); - ---查看表all_data相关信息 -postgres=# \d+ all_data - Table "public.all_data" - Column | Type | Modifiers | Storage | Stats target | Description ---------+------------------------+-----------+----------+--------------+------------- - id | integer | | plain | | - role | character varying(100) | | extended | | - data | character varying(100) | | extended | | -Row Level Security Policies: - POLICY "all_data_rls" - USING (((role)::name = "current_user"())) -Has OIDs: no -Location Nodes: ALL DATANODES -Options: orientation=row, compression=no, enable_rowsecurity=true - ---当前用户执行SELECT操作 -postgres=# SELECT * FROM all_data; - id | role | data -----+-------+------------ - 1 | alice | alice data - 2 | bob | bob data - 3 | peter | peter data -(3 rows) - -postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; - QUERY PLAN ----------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data -(3 rows) - ---切换至alice用户执行SELECT操作 -postgres=# SELECT * FROM all_data; - id | role | data -----+-------+------------ - 1 | alice | alice data -(1 row) - -postgres=# EXPLAIN(COSTS OFF) SELECT * FROM all_data; - QUERY PLAN ----------------------------------------------------------------- - Streaming (type: GATHER) - Node/s: All dbnodes - -> Seq Scan on all_data - Filter: ((role)::name = 'alice'::name) - Notice: This query is influenced by row level security feature -(5 rows) -``` - -## 相关链接 - -[DROP ROW LEVEL SECURITY POLICY](DROP-ROW-LEVEL-SECURITY-POLICY.md) - diff --git a/content/zh/docs/Developerguide/CREATE-SEQUENCE.md b/content/zh/docs/Developerguide/CREATE-SEQUENCE.md index a3cfdb26a225965133e7c2d832c470486a88caf3..a6ffd2a3e361d4e3b8a310f3ba456e1a2b354a1d 100644 --- a/content/zh/docs/Developerguide/CREATE-SEQUENCE.md +++ b/content/zh/docs/Developerguide/CREATE-SEQUENCE.md @@ -66,7 +66,7 @@ CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 若定义序列为CYCLE，则不能保证序列的唯一性。 -- **OWNED BY**- +- **OWNED BY** 将序列和一个表的指定字段进行关联。这样，在删除那个字段或其所在表的时候会自动删除已关联的序列。关联的表和序列的所有者必须是同一个用户，并且在同一个模式中。需要注意的是，通过指定OWNED BY，仅仅是建立了表的对应列和sequence之间关联关系，并不会在插入数据时在该列上产生自增序列。 @@ -128,7 +128,7 @@ postgres=# CREATE SEQUENCE serial1 START 101 CACHE 20 OWNED BY customer_address.ca_address_sk; ---删除序列 +--删除表和序列 postgres=# DROP TABLE customer_address; postgres=# DROP SEQUENCE serial cascade; postgres=# DROP SEQUENCE serial1 cascade; diff --git a/content/zh/docs/Developerguide/DELETE.md b/content/zh/docs/Developerguide/DELETE.md index b342c53ad4f4026398b4218d73be8b05d6d1acd4..053fd71daad5d9efb1e44db13b9203022b03202f 100644 --- a/content/zh/docs/Developerguide/DELETE.md +++ b/content/zh/docs/Developerguide/DELETE.md @@ -7,7 +7,6 @@ DELETE从指定的表里删除满足WHERE子句的行。如果WHERE子句不存 ## 注意事项 - 要删除表中的数据，用户必须对它有DELETE权限。同样也必须有USING子句引用的表以及condition上读取的表的SELECT权限。 -- 对于行存复制表，仅支持有主键约束场景下的delete操作。 - 对于列存表，暂时不支持RETURNING子句。 ## 语法格式 diff --git a/content/zh/docs/Developerguide/FETCH.md b/content/zh/docs/Developerguide/FETCH.md index 6bb432bcf6e02fef00cdc50b725cefc6e793088b..77eba83ad0106bd65926d069a2366e2d9ebe84ef 100644 --- a/content/zh/docs/Developerguide/FETCH.md +++ b/content/zh/docs/Developerguide/FETCH.md @@ -17,7 +17,7 @@ FETCH通过已创建的游标来检索数据。 - NEXT，PRIOR，FIRST，LAST，ABSOLUTE，RELATIVE形式在恰当地移动游标之后抓取一条记录。如果后面没有数据行，就返回一个空的结果，此时游标就会停在查询结果的最后一行之后（向后查询时）或者第一行之前（向前查询时）。 - FORWARD和BACKWARD形式在向前或者向后移动的过程中抓取指定的行数，然后把游标定位在最后返回的行上；或者是，如果count大于可用的行数，则在所有行之后（向后查询时）或者之前（向前查询时）。 - RELATIVE 0，FORWARD 0，BACKWARD 0都要求在不移动游标的前提下抓取当前行，也就是重新抓取最近刚抓取过的行。除非游标定位在第一行之前或者最后一行之后，这个动作都应该成功，而在那两种情况下，不返回任何行。 -- 当FETCH的游标上涉及列存表时，不支持BACKWARD、PRIOR、FIRST等涉及反向获取操作。 +- 当FETCH的游标上涉及列存表时，不支持BACKWARD、PRIOR等涉及反向获取操作。 ## 语法格式 @@ -119,8 +119,8 @@ NEXT 取值范围：有符号的整数 - - count为正数就抓取当前关联位置之前的第count行。 - - count为负数就抓取当前关联位置之后的第abs（count）行。 + - count为正数就抓取当前关联位置之前的count行。 + - count为负数就抓取当前关联位置之后的abs（count）行。 - 如果有数据的话，BACKWARD 0重新抓取当前行。 - BACKWARD ALL diff --git a/content/zh/docs/Developerguide/Foreign-Data-Wrapper.md b/content/zh/docs/Developerguide/Foreign-Data-Wrapper.md index a3e60d662c0fd770707a6cf6219df4f894297f2e..e642c80a9a559e6ef53b6d698b0b4bbf427c2523 100644 --- a/content/zh/docs/Developerguide/Foreign-Data-Wrapper.md +++ b/content/zh/docs/Developerguide/Foreign-Data-Wrapper.md @@ -1,7 +1,7 @@ # Foreign Data Wrapper openGauss的fdw实现的功能是各个openGauss数据库及远程数据库之间的跨库操作。目前支持的远程数据库类型包括Oracle、Mysql（MariaDB）、openGauss（postgres_fdw）。 -- **[oracle_fdw](oracle_fdw.md)** +- **[oracle_fdw](用于Oracle的外部数据包装器.md)** - **[mysql_fdw](mysql_fdw.md)** diff --git "a/content/zh/docs/Developerguide/MOT-SQL\350\246\206\347\233\226\345\222\214\351\231\220\345\210\266.md" "b/content/zh/docs/Developerguide/MOT-SQL\350\246\206\347\233\226\345\222\214\351\231\220\345\210\266.md" index d1663343b1b02ad605fe3c978195a2779b75f02e..c027b602e1b970ef397aea2c81f5ed47d74543a0 100644 --- "a/content/zh/docs/Developerguide/MOT-SQL\350\246\206\347\233\226\345\222\214\351\231\220\345\210\266.md" +++ "b/content/zh/docs/Developerguide/MOT-SQL\350\246\206\347\233\226\345\222\214\351\231\220\345\210\266.md" @@ -170,11 +170,7 @@ MOT功能限制： ## 不支持的DML - Merge into -- Delete on conflict -- Insert on conflict - Select into -- Update on conflict -- Update from - Lock table - Copy from table diff --git a/content/zh/docs/Developerguide/REINDEX.md b/content/zh/docs/Developerguide/REINDEX.md index 2a3edaab1c3b983e01c07c29e0dc02e08308bfc6..e73bddf805ec31ab13c72e8f46c58f4927abed0f 100644 --- a/content/zh/docs/Developerguide/REINDEX.md +++ b/content/zh/docs/Developerguide/REINDEX.md @@ -9,8 +9,7 @@ - 索引崩溃，并且不再包含有效的数据。 - 索引变得“臃肿”，包含大量的空页或接近空页。 - 为索引更改了存储参数（例如填充因子），并且希望这个更改完全生效。 - - 使用CONCURRENTLY选项创建索引失败，留下了一个“非法”索引。 +- 使用CONCURRENTLY选项创建索引失败，留下了一个“非法”索引。 ## 注意事项 @@ -130,10 +129,10 @@ postgres=# DROP TABLE tpcds.customer_t1; - DATABASE - 不建议在事务中reindex database。 + 不能在事务中reindex database。 - SYSTEM - 不建议在事务中reindex系统表。 + 不能在事务中reindex系统表。 diff --git a/content/zh/docs/Developerguide/SET-ROLE.md b/content/zh/docs/Developerguide/SET-ROLE.md index 3a1f69c85b96c61c700f2ffccec8b08ddf699633..d9f6ad2ccdc107a34b1de79385db5d70ee74b1e7 100644 --- a/content/zh/docs/Developerguide/SET-ROLE.md +++ b/content/zh/docs/Developerguide/SET-ROLE.md @@ -30,9 +30,7 @@ 声明这个命令只对当前会话起作用，此参数为缺省值。 - 取值范围：字符串，要符合标识符的命名规范。 - -- **LOCALE** +- **LOCAL** 声明该命令只在当前事务中有效。 diff --git a/content/zh/docs/Developerguide/SET-SESSION-AUTHORIZATION.md b/content/zh/docs/Developerguide/SET-SESSION-AUTHORIZATION.md index 7ec4c6e85018caa00f12637b3eee87a35809f117..1ee61733bb1ec74c41560103340f1751a36795ed 100644 --- a/content/zh/docs/Developerguide/SET-SESSION-AUTHORIZATION.md +++ b/content/zh/docs/Developerguide/SET-SESSION-AUTHORIZATION.md @@ -30,9 +30,7 @@ 声明这个命令只对当前会话起作用。 - 取值范围：字符串，要符合标识符的命名规范。 - -- **LOCALE** +- **LOCAL** 声明该命令只在当前事务中有效。 diff --git a/content/zh/docs/Developerguide/STATEMENT_COMPLEX_RUNTIME.md b/content/zh/docs/Developerguide/STATEMENT_COMPLEX_RUNTIME.md index baeb4676bab7455e1c1bcf030552ccb4617b2c83..b7d13b48b677a8b1dd2d1f2fa66af26b71a5dcef 100644 --- a/content/zh/docs/Developerguide/STATEMENT_COMPLEX_RUNTIME.md +++ b/content/zh/docs/Developerguide/STATEMENT_COMPLEX_RUNTIME.md @@ -38,7 +38,7 @@ STATEMENT\_COMPLEX\_RUNTIME视图显示当前用户在数据库主节点上正

text

数据库进程名称

+

数据库进程名称。

username

diff --git a/content/zh/docs/Developerguide/STATEMENT_WLMSTAT_COMPLEX_RUNTIME.md b/content/zh/docs/Developerguide/STATEMENT_WLMSTAT_COMPLEX_RUNTIME.md index 585d691029475a371afd0bf46d121a64dfd8936e..9f1a805b8aefa656702bd60dad45b9b579c3b86c 100644 --- a/content/zh/docs/Developerguide/STATEMENT_WLMSTAT_COMPLEX_RUNTIME.md +++ b/content/zh/docs/Developerguide/STATEMENT_WLMSTAT_COMPLEX_RUNTIME.md @@ -137,7 +137,7 @@ STATEMENT\_WLMSTAT\_COMPLEX\_RUNTIME视图显示和当前用户执行作业正

text

该字段不支持

+

该字段不支持。

enqueue

diff --git a/content/zh/docs/Developerguide/SUMMARY_STATEMENT_COUNT.md b/content/zh/docs/Developerguide/SUMMARY_STATEMENT_COUNT.md index c36c907b93344a82d5ff1bb4ab672ba778a492dd..1c304faa43a8c44aa49ae355729fe1b12ce68163 100644 --- a/content/zh/docs/Developerguide/SUMMARY_STATEMENT_COUNT.md +++ b/content/zh/docs/Developerguide/SUMMARY_STATEMENT_COUNT.md @@ -136,7 +136,7 @@

numeric

总insert的时间花费(单位：微秒)。

+

总insert的时间花费（单位：微秒）。

avg_insert_elapse

diff --git "a/content/zh/docs/Developerguide/WDR-Snapshot\347\224\237\346\210\220\346\200\247\350\203\275\346\212\245\345\221\212.md" "b/content/zh/docs/Developerguide/WDR-Snapshot\347\224\237\346\210\220\346\200\247\350\203\275\346\212\245\345\221\212.md" index f4ef2c30fe3ad1ef4d22a67cbb99becd84bc7640..18c58ef9a84a28c69fc383118853d142fb97fe61 100644 --- "a/content/zh/docs/Developerguide/WDR-Snapshot\347\224\237\346\210\220\346\200\247\350\203\275\346\212\245\345\221\212.md" +++ "b/content/zh/docs/Developerguide/WDR-Snapshot\347\224\237\346\210\220\346\200\247\350\203\275\346\212\245\345\221\212.md" @@ -4,7 +4,7 @@ ## 前提条件 -WDR Snasphot在启动后（即参数[enable\_wdr\_snapshot](zh-cn_topic_0242371547.md#zh-cn_topic_0237124757_section983311682019)为on时）， 且快照数量大于等于2时可以生成报告。 +WDR Snasphot在启动后（即参数[enable\_wdr\_snapshot](系统性能快照.md#zh-cn_topic_0237124757_section983311682019)为on时）， 且快照数量大于等于2时可以生成报告。 ## 操作步骤 diff --git "a/content/zh/docs/Developerguide/\344\272\214\350\277\233\345\210\266\345\255\227\347\254\246\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" "b/content/zh/docs/Developerguide/\344\272\214\350\277\233\345\210\266\345\255\227\347\254\246\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" index 79deb8fd20e6cece7c579f7ec794574b60fcbb0b..6d0ad0a4efc616f8a4f5bc4ba189f27fbade2642 100644 --- "a/content/zh/docs/Developerguide/\344\272\214\350\277\233\345\210\266\345\255\227\347\254\246\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" +++ "b/content/zh/docs/Developerguide/\344\272\214\350\277\233\345\210\266\345\255\227\347\254\246\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" @@ -52,7 +52,7 @@ SQL定义了一些字符串函数，在这些函数里使用关键字而不是 (1 row) ``` -- substring\(string \[from int\] \[for int\]\) +- substring\(string [from int] \[for int\]\) 描述：截取子串。 @@ -68,6 +68,22 @@ SQL定义了一些字符串函数，在这些函数里使用关键字而不是 (1 row) ``` +- substr\(string, from int \[, for int\]\) + + 描述：截取子串。 + + 返回值类型：bytea + + 示例： + + ``` + postgres=# SELECT substr(E'Th\\000omas'::bytea from 2 for 3) AS RESULT; + result + ---------- + \x68006f + (1 row) + ``` + - trim\(\[both\] bytes from string\) 描述：从string的开头和结尾删除只包含bytes中字节的最长字符串。 diff --git "a/content/zh/docs/Developerguide/\344\275\215\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" "b/content/zh/docs/Developerguide/\344\275\215\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" index 14f1d80c59019c5e7a8d79d06e3a9d5e7f50504c..86607f5808359331142dbd099667a19069d987b7 100644 --- "a/content/zh/docs/Developerguide/\344\275\215\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" +++ "b/content/zh/docs/Developerguide/\344\275\215\344\270\262\345\207\275\346\225\260\345\222\214\346\223\215\344\275\234\347\254\246.md" @@ -19,7 +19,7 @@ ``` >![](public_sys-resources/icon-note.gif) **说明：** - >单字段内部连续连接操作不能超过180次，若超过需拆分为多个连续连接的字符串，它们之间再做连接操作。 + >单字段内部连续连接操作不建议超过180次，若超过需拆分为多个连续连接的字符串，它们之间再做连接操作。 >例如：str1||str2||str3||str4 拆分为 \(str1||str2\)||\(str3||str4\)。 - & diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250SQL\345\207\275\346\225\260\346\216\245\345\217\243\350\277\233\350\241\214\351\200\273\350\276\221\350\247\243\347\240\201.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250SQL\345\207\275\346\225\260\346\216\245\345\217\243\350\277\233\350\241\214\351\200\273\350\276\221\350\247\243\347\240\201.md" index 60b66bf6b67859acad70a03ac18dd6e1fb76f4fd..316a5cf6736a0c93a19a687f70ceaf8a3384ee2e 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250SQL\345\207\275\346\225\260\346\216\245\345\217\243\350\277\233\350\241\214\351\200\273\350\276\221\350\247\243\347\240\201.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250SQL\345\207\275\346\225\260\346\216\245\345\217\243\350\277\233\350\241\214\351\200\273\350\276\221\350\247\243\347\240\201.md" @@ -10,8 +10,8 @@ openGauss可以通过调用SQL函数，进行创建、删除、推进逻辑复 >为避免安全风险，请保证启用SSL连接。 -- 设置GUC参数[wal\_level](zh-cn_topic_0242371497.md#zh-cn_topic_0237124707_zh-cn_topic_0059778393_s2c76f5957066407a959191148f2c780f)=logical。 -- 设置GUC参数[max\_replication\_slots](zh-cn_topic_0242371502.md#section7322161612568)\>每个节点所需的（物理流复制槽数+逻辑复制槽数）。 +- 设置GUC参数[wal\_level](设置.md#zh-cn_topic_0237124707_zh-cn_topic_0059778393_s2c76f5957066407a959191148f2c780f)=logical。 +- 设置GUC参数[max\_replication\_slots](发送端服务器.md#section7322161612568)\>每个节点所需的（物理流复制槽数+逻辑复制槽数）。 物理流复制槽提供了一种自动化的方法来确保主节点在所有备节点或从备节点收到xlog之前，xlog不会被移除。也就是说物理流复制槽用于支撑集群HA。集群所需要的物理流复制槽数为：备节点加从备的和与主节点之间的比例。例如，假设集群的高可用方案为1主、1备、1从备，则所需物理流复制槽数为2。又例如，假设集群的高可用方案为1主3备，则所需物理流复制槽数为3。 diff --git "a/content/zh/docs/Developerguide/\345\206\205\345\255\230-21.md" "b/content/zh/docs/Developerguide/\345\206\205\345\255\230-21.md" index 02b1075fc507ff459350aba2cf804602fef6d5bf..222892c441e04dd859f631f73b2fe9f7ec279667 100644 --- "a/content/zh/docs/Developerguide/\345\206\205\345\255\230-21.md" +++ "b/content/zh/docs/Developerguide/\345\206\205\345\255\230-21.md" @@ -1,279 +1,279 @@ -# 内存 - -介绍与内存相关的参数设置。 - ->![](public_sys-resources/icon-notice.gif) **须知：** ->这些参数只能在数据库服务重新启动后生效。 - -## memorypool\_enable - -**参数说明**：设置是否允许使用内存池。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：布尔型 - -- on表示允许使用内存池。 -- off表示不允许使用内存池。 - -**默认值**：off - -## memorypool\_size - -**参数说明**：设置内存池大小。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：整型，128\*1024～INT\_MAX/2，单位为KB。 - -**默认值**：512MB - -## enable\_memory\_limit - -**参数说明：**启用逻辑内存管理模块。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：布尔型 - -- on表示启用逻辑内存管理模块。 -- off表示不启用逻辑内存管理模块。 - -**默认值：**on - ->![](public_sys-resources/icon-notice.gif) **须知：** ->若max\_process\_memory-shared buffer-cstore buffers少于2G，openGauss强制把enable\_memory\_limit设置为off。 - -## max\_process\_memory - -**参数说明：**设置一个数据库节点可用的最大物理内存。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：整型，2\*1024\*1024～INT\_MAX，单位为KB。 - -**默认值：**非从备数据库节点自动适配，公式为（物理内存大小）\*0.6/\(1+主节点个数\)，当结果不足2GB时，默认取2GB。从备节点默认为12GB。 - -**设置建议：** - -数据库节点上该数值需要根据系统物理内存及单节点部署主数据库节点个数决定。建议计算公式如下：物理内存大小 \* 系数 / 主节点个数，系数通常建议为0.8。该系数的目的在于预留内存供操作系统内核使用，尽可能保证系统的可靠性，防止因数据库内存膨胀导致物理节点OOM。节点的物理内存越小, 系数应越小。例如, 128GB物理内存的节点可以使用0.9作为系数, 而32GB的节点可能只适合0.7作为系数。 - -## enable\_memory\_context\_control - -**参数说明：**启用检查内存上下文是否超过给定限制的功能。仅适用于DEBUG版本。 - -该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：布尔型 - -- on表示启用最大内存上下文限制检查功能。 -- off表示关闭最大内存上下文限制检查功能。 - -**默认值：**off - -## uncontrolled\_memory\_context - -**参数说明：**启用检查内存上下文是否超过给定限制的功能时，设置不受此功能约束。仅适用于DEBUG版本。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -查询时会在参数值的最前面添加标题含义字符串“MemoryContext white list:"。 - -**取值范围**：字符串 - -**默认值：**空 - -## shared\_buffers - -**参数说明：**设置openGauss使用的共享内存大小。增加此参数的值会使openGauss比系统默认设置需要更多的System V共享内存。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，16 \~ 1073741823 ，单位为8KB。 - -改变BLCKSZ的值会改变最小值。 - -**默认值：**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 - -**设置建议：** - -建议设置shared\_buffers值为内存的40%以内。行存列存分开对待。行存设大，列存设小。列存：\(单服务器内存/单服务器数据库节点个数\)\*0.4\*0.25。 - -如果设置较大的shared\_buffers需要同时增加checkpoint\_segments的值，因为写入大量新增、修改数据需要消耗更多的时间周期。 - -## bulk\_write\_ring\_size - -**参数说明：**数据并行导入使用的环形缓冲区大小。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，16384 \~ 2147483647，单位为KB。 - -**默认值：**2GB - -**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 - -## standby\_shared\_buffers\_fraction - -**参数说明：**备实例所在服务器使用shared\_buffers内存缓冲区大小的比例。 - -该参数属于SIGHUP类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**双精度类型，0.1\~1.0 - -**默认值：**0.3 - -## temp\_buffers - -**参数说明：**设置每个数据库会话使用的LOCAL临时缓冲区的大小。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -在每个会话的第一次使用临时表之前可以改变temp\_buffers的值，之后的设置将是无效的。 - -一个会话将按照temp\_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 - -**取值范围：**整型，100\~1073741823，单位为8KB。 - -**默认值：**1MB - -## max\_prepared\_transactions - -**参数说明：**设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使openGauss比系统默认设置需要更多的System V共享内存。 - -当openGauss部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型。0\~536870911。 - -**默认值：**800 - ->![](public_sys-resources/icon-note.gif) **说明：** ->为避免在准备步骤失败，此参数的值不能小于max\_connections。 - -## work\_mem - -**参数说明：**设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 - -对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样，好几个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work\_mem的好几倍。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，64\~2147483647，单位为KB。 - -**默认值：**64MB - -**设置建议：** - -依据查询特点和并发来确定，一旦work\_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 - -- 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work\_mem=50%内存/10。 -- 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work\_mem=50%内存/5。 -- 对于并发场景，建议work\_mem=串行下的work\_mem/物理并发数。 - -## query\_mem - -**参数说明：**设置执行作业所使用的内存。如果设置的query\_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 - -**默认值：**0 - -## query\_max\_mem - -**参数说明：**设置执行作业所能够使用的最大内存。如果设置的query\_max\_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 - -**默认值：**0 - -## maintenance\_work\_mem - -**参数说明：**设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，1024\~INT\_MAX，单位为KB。 - -**默认值：**128MB - -**设置建议：** - -- 建议设置此参数的值大于[work\_mem](#zh-cn_topic_0237124699_zh-cn_topic_0059777577_sd27c81d651ce4d2585febca76c4cc34e)，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 -- 当[自动清理](自动清理.md)进程运行时，[autovacuum\_max\_workers](自动清理.md#zh-cn_topic_0237124730_zh-cn_topic_0059778244_s76932f79410248ba8923017d19982673)倍数的内存将会被分配，所以此时设置maintenance\_work\_mem的值应该不小于[work\_mem](#zh-cn_topic_0237124699_zh-cn_topic_0059777577_sd27c81d651ce4d2585febca76c4cc34e)。 -- 如果进行大数据量的cluster等，可以在session中调大该值。 - -## psort\_work\_mem - -**参数说明：**设置列存表在进行局部排序中在开始写入临时磁盘文件之前使用的内存大小。带partial cluster key的表、带索引的表插入，创建表索引，删除表和更新表都会用到。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - ->![](public_sys-resources/icon-notice.gif) **须知：** ->同样，好几个正在运行的会话可能会同时进行表的局部排序操作。因此使用的总内存可能是psort\_work\_mem的好几倍。 - -**取值范围：**整型64\~2147483647，单位为KB。 - -**默认值：**512MB - -## max\_loaded\_cudesc - -**参数说明：**设置列存表在做扫描时，每列缓存cudesc信息的个数。增大设置会提高查询性能，但也会增加内存占用，特别是当列存表的列非常多时。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - ->![](public_sys-resources/icon-notice.gif) **须知：** ->max\_loaded\_cudesc设置过高时，有可能引起内存分配不足。 - -**取值范围：**100\~1073741823。 - -**默认值：**1024 - -## max\_stack\_depth - -**参数说明：**设置openGauss执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 - -该参数属于SUSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -设置原则： - -- 数据库需要预留640KB堆栈深度，因此此参数的最佳设置是等于操作系统内核允许的最大值（就是ulimit -s的设置）- 640KB。 -- 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在openGauss能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 -- 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 - -**取值范围：**整型，100\~INT\_MAX，单位为KB。 - -**默认值：**2MB - ->![](public_sys-resources/icon-note.gif) **说明：** ->默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。 - -## cstore\_buffers - -**参数说明：**设置列存所使用的共享缓冲区的大小。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，16384～1073741823，单位为KB。 - -**默认值：**1GB - -**设置建议**： - -列存表使用cstore\_buffers设置的共享缓冲区，几乎不用shared\_buffers。因此在列存表为主的场景中，应减少shared\_buffers，增加cstore\_buffers。 - -## bulk\_read\_ring\_size - -**参数说明：**并行导出，使用的环形缓冲区大小。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围：**整型，256\~2147483647，单位为KB。 - -**默认值：**16MB - +# 内存 + +介绍与内存相关的参数设置。 + +>![](public_sys-resources/icon-notice.gif) **须知：** +>这些参数只能在数据库服务重新启动后生效。 + +## memorypool\_enable + +**参数说明**：设置是否允许使用内存池。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围**：布尔型 + +- on表示允许使用内存池。 +- off表示不允许使用内存池。 + +**默认值**：off + +## memorypool\_size + +**参数说明**：设置内存池大小。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围**：整型，128\*1024～INT\_MAX/2，单位为KB。 + +**默认值**：512MB + +## enable\_memory\_limit + +**参数说明：**启用逻辑内存管理模块。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围**：布尔型 + +- on表示启用逻辑内存管理模块。 +- off表示不启用逻辑内存管理模块。 + +**默认值：**on + +>![](public_sys-resources/icon-notice.gif) **须知：** +>若max\_process\_memory-shared buffer-cstore buffers少于2G，GaussDB KernelopenGauss强制把enable\_memory\_limit设置为off。 + +## max\_process\_memory + +**参数说明：**设置一个数据库节点可用的最大物理内存。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围**：整型，2\*1024\*1024～INT\_MAX，单位为KB。 + +**默认值：**非从备数据库节点自动适配，公式为（物理内存大小）\*0.6/\(1+主节点个数\)，当结果不足2GB时，默认取2GB。从备节点默认为12GB。 + +**设置建议：** + +数据库节点上该数值需要根据系统物理内存及单节点部署主数据库节点个数决定。建议计算公式如下：物理内存大小 \* 系数 / 主节点个数，系数通常建议为0.8。该系数的目的在于预留内存供操作系统内核使用，尽可能保证系统的可靠性，防止因数据库内存膨胀导致物理节点OOM。节点的物理内存越小, 系数应越小。例如, 128GB物理内存的节点可以使用0.9作为系数, 而32GB的节点可能只适合0.7作为系数。 + +## enable\_memory\_context\_control + +**参数说明：**启用检查内存上下文是否超过给定限制的功能。仅适用于DEBUG版本。 + +该参数属于SIGHUP类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围**：布尔型 + +- on表示启用最大内存上下文限制检查功能。 +- off表示关闭最大内存上下文限制检查功能。 + +**默认值：**off + +## uncontrolled\_memory\_context + +**参数说明：**启用检查内存上下文是否超过给定限制的功能时，设置不受此功能约束。仅适用于DEBUG版本。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +查询时会在参数值的最前面添加标题含义字符串“MemoryContext white list:"。 + +**取值范围**：字符串 + +**默认值：**空 + +## shared\_buffers + +**参数说明：**设置openGauss使用的共享内存大小。增加此参数的值会使GaussDB KernelopenGauss比系统默认设置需要更多的System V共享内存。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，16 \~ 1073741823 ，单位为KB。 + +shared\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared\_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 + +**默认值：**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 + +**设置建议：** + +建议设置shared\_buffers值为内存的40%以内。行存列存分开对待。行存设大，列存设小。列存：\(单服务器内存/单服务器数据库节点个数\)\*0.4\*0.25。 + +如果设置较大的shared\_buffers需要同时增加checkpoint\_segments的值，因为写入大量新增、修改数据需要消耗更多的时间周期。 + +## bulk\_write\_ring\_size + +**参数说明：**数据并行导入使用的环形缓冲区大小。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，16384 \~ 2147483647，单位为KB。 + +**默认值：**2GB + +**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 + +## standby\_shared\_buffers\_fraction + +**参数说明：**备实例所在服务器使用shared\_buffers内存缓冲区大小的比例。 + +该参数属于SIGHUP类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**双精度类型，0.1\~1.0 + +**默认值：**0.3 + +## temp\_buffers + +**参数说明：**设置每个数据库会话使用的LOCAL临时缓冲区的大小。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +在每个会话的第一次使用临时表之前可以改变temp\_buffers的值，之后的设置将是无效的。 + +一个会话将按照temp\_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 + +**取值范围：**整型，100\~1073741823，单位为8KB。 + +**默认值：**1MB + +## max\_prepared\_transactions + +**参数说明：**设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使GaussDB KernelopenGauss比系统默认设置需要更多的System V共享内存。 + +当GaussDB KernelopenGauss部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型。0\~536870911。 + +**默认值：**800 + +>![](public_sys-resources/icon-note.gif) **说明：** +>为避免在准备步骤失败，此参数的值不能小于max\_connections。 + +## work\_mem + +**参数说明：**设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 + +对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样，好几个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work\_mem的好几倍。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，64\~2147483647，单位为KB。 + +**默认值：**64MB + +**设置建议：** + +依据查询特点和并发来确定，一旦work\_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 + +- 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work\_mem=50%内存/10。 +- 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work\_mem=50%内存/5。 +- 对于并发场景，建议work\_mem=串行下的work\_mem/物理并发数。 + +## query\_mem + +**参数说明：**设置执行作业所使用的内存。如果设置的query\_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 + +**默认值：**0 + +## query\_max\_mem + +**参数说明：**设置执行作业所能够使用的最大内存。如果设置的query\_max\_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 + +**默认值：**0 + +## maintenance\_work\_mem + +**参数说明：**设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，1024\~INT\_MAX，单位为KB。 + +**默认值：**128MB + +**设置建议：** + +- 建议设置此参数的值大于[work\_mem](#zh-cn_topic_0283136786_zh-cn_topic_0237124699_zh-cn_topic_0059777577_sd27c81d651ce4d2585febca76c4cc34e)，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 +- 当[自动清理](zh-cn_topic_0289900634.md)进程运行时，[autovacuum\_max\_workers](zh-cn_topic_0289900634.md#zh-cn_topic_0283137694_zh-cn_topic_0237124730_zh-cn_topic_0059778244_s76932f79410248ba8923017d19982673)倍数的内存将会被分配，所以此时设置maintenance\_work\_mem的值应该不小于[work\_mem](#zh-cn_topic_0283136786_zh-cn_topic_0237124699_zh-cn_topic_0059777577_sd27c81d651ce4d2585febca76c4cc34e)。 +- 如果进行大数据量的cluster等，可以在session中调大该值。 + +## psort\_work\_mem + +**参数说明：**设置列存表在进行局部排序中在开始写入临时磁盘文件之前使用的内存大小。带partial cluster key的表、带索引的表插入，创建表索引，删除表和更新表都会用到。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +>![](public_sys-resources/icon-notice.gif) **须知：** +>同样，好几个正在运行的会话可能会同时进行表的局部排序操作。因此使用的总内存可能是psort\_work\_mem的好几倍。 + +**取值范围：**整型64\~2147483647，单位为KB。 + +**默认值：**512MB + +## max\_loaded\_cudesc + +**参数说明：**设置列存表在做扫描时，每列缓存cudesc信息的个数。增大设置会提高查询性能，但也会增加内存占用，特别是当列存表的列非常多时。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +>![](public_sys-resources/icon-notice.gif) **须知：** +>max\_loaded\_cudesc设置过高时，有可能引起内存分配不足。 + +**取值范围：**100\~1073741823。 + +**默认值：**1024 + +## max\_stack\_depth + +**参数说明：**设置GaussDB KernelopenGauss执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 + +该参数属于SUSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +设置原则： + +- 数据库需要预留640KB堆栈深度，因此此参数的最佳设置是等于操作系统内核允许的最大值（就是ulimit -s的设置）- 640KB。 +- 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在GaussDB KernelopenGauss能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 +- 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 + +**取值范围：**整型，100\~INT\_MAX，单位为KB。 + +**默认值：**2MB + +>![](public_sys-resources/icon-note.gif) **说明：** +>默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。 + +## cstore\_buffers + +**参数说明：**设置列存所使用的共享缓冲区的大小。 + +该参数属于POSTMASTER类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，16384～1073741823，单位为KB。 + +**默认值：**1GB + +**设置建议**： + +列存表使用cstore\_buffers设置的共享缓冲区，几乎不用shared\_buffers。因此在列存表为主的场景中，应减少shared\_buffers，增加cstore\_buffers。 + +## bulk\_read\_ring\_size + +**参数说明：**并行导出，使用的环形缓冲区大小。 + +该参数属于USERSET类型参数，请参考[表1](zh-cn_topic_0289899927.md#zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 + +**取值范围：**整型，256\~2147483647，单位为KB。 + +**默认值：**16MB + diff --git "a/content/zh/docs/Developerguide/\345\206\205\345\255\230-23.md" "b/content/zh/docs/Developerguide/\345\206\205\345\255\230-23.md" index 62a25c768bc5a1dc479b1f0a0da3f2bdeef84dea..2f296bfa8053272ce430b910140613bf68ddb7db 100644 --- "a/content/zh/docs/Developerguide/\345\206\205\345\255\230-23.md" +++ "b/content/zh/docs/Developerguide/\345\206\205\345\255\230-23.md" @@ -89,9 +89,9 @@ 该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 -**取值范围：**整型，16 \~ 1073741823 ，单位为8KB。 +**取值范围：**整型，16 \~ 1073741823 ，单位为KB。 -改变BLCKSZ的值会改变最小值。 +shared\_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared\_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 **默认值：**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 diff --git "a/content/zh/docs/Developerguide/\345\244\207\346\234\272\345\244\204\344\272\216need-repair(WAL)\347\212\266\346\200\201\351\227\256\351\242\230.md" "b/content/zh/docs/Developerguide/\345\244\207\346\234\272\345\244\204\344\272\216need-repair(WAL)\347\212\266\346\200\201\351\227\256\351\242\230.md" deleted file mode 100644 index 7b0e5476242b74dd4cbf7ac16ec22468e3fc89cb..0000000000000000000000000000000000000000 --- "a/content/zh/docs/Developerguide/\345\244\207\346\234\272\345\244\204\344\272\216need-repair(WAL)\347\212\266\346\200\201\351\227\256\351\242\230.md" +++ /dev/null @@ -1,14 +0,0 @@ -# 备机处于need repair\(WAL\)状态问题 - -## 问题现象 - -openGauss备机出现Standby Need repair\(WAL\)故障。 - -## 原因分析 - -因网络故障、磁盘满等原因造成主备实例连接断开，主备日志不同步，导致数据库集群在启动时异常。 - -## 处理分析 - -通过gs\_ctl build -D 命令对故障节点进行重建，具体的操作方法请参见openGauss工具参考中的build参数。 - diff --git "a/content/zh/docs/Developerguide/\345\255\230\345\202\250\350\277\207\347\250\213\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" "b/content/zh/docs/Developerguide/\345\255\230\345\202\250\350\277\207\347\250\213\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" index ff50c41495b8ccf2e89a11b59fc0d7eccc7ca6b1..f2e38de3995b95be51e735676e26208124e46002 100644 --- "a/content/zh/docs/Developerguide/\345\255\230\345\202\250\350\277\207\347\250\213\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" +++ "b/content/zh/docs/Developerguide/\345\255\230\345\202\250\350\277\207\347\250\213\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" @@ -1,6 +1,6 @@ # 存储过程支持自治事务 -存储过程支持自治事务，标识符为PRAGMA AUTONOMOUS\_TRANSACTION，执行的函数块中使用start transaction和commit/rollback包含执行的sql，其余语法与[CREATE PROCEDURE](zh-cn_topic_0242370574.md)创建存储过程类似，一个简单例子如下： +存储过程支持自治事务，标识符为PRAGMA AUTONOMOUS\_TRANSACTION，执行的函数块中使用start transaction和commit/rollback包含执行的sql，其余语法与[CREATE PROCEDURE](CREATE-PROCEDURE.md)创建存储过程类似，一个简单例子如下： ``` --创建表。 diff --git "a/content/zh/docs/Developerguide/\345\270\270\350\247\201\346\225\205\351\232\234\345\256\232\344\275\215\346\241\210\344\276\213.md" "b/content/zh/docs/Developerguide/\345\270\270\350\247\201\346\225\205\351\232\234\345\256\232\344\275\215\346\241\210\344\276\213.md" index c82a06753ee729ed691ea9edf7394d605c106f7e..568259c39710f2c866fdfb22f8c3e749861eee81 100644 --- "a/content/zh/docs/Developerguide/\345\270\270\350\247\201\346\225\205\351\232\234\345\256\232\344\275\215\346\241\210\344\276\213.md" +++ "b/content/zh/docs/Developerguide/\345\270\270\350\247\201\346\225\205\351\232\234\345\256\232\344\275\215\346\241\210\344\276\213.md" @@ -4,7 +4,7 @@ - **[TPCC运行时，注入磁盘满故障，TPCC卡住的问题](TPCC运行时-注入磁盘满故障-TPCC卡住的问题.md)** -- **[备机处于need repair\(WAL\)状态问题](备机处于need-repair(WAL)状态问题.md)** +- **[备机处于need repair\(WAL\)状态问题](备机处于need-repair_WAL_状态问题.md)** - **[内存不足问题](内存不足问题.md)** diff --git "a/content/zh/docs/Developerguide/\345\271\266\350\241\214\345\257\274\345\205\245.md" "b/content/zh/docs/Developerguide/\345\271\266\350\241\214\345\257\274\345\205\245.md" deleted file mode 100644 index 213dd54c4cee2a45116dbe7d5aada36b9f09cb45..0000000000000000000000000000000000000000 --- "a/content/zh/docs/Developerguide/\345\271\266\350\241\214\345\257\274\345\205\245.md" +++ /dev/null @@ -1,52 +0,0 @@ -# 并行导入 - -openGauss提供了并行导入功能，以快速、高效地完成大量数据导入。介绍openGauss并行导入的相关参数。 - -## raise\_errors\_if\_no\_files - -**参数说明：**导入时是否区分“导入文件记录数为空”和“导入文件不存在”。raise\_errors\_if\_no\_files=TRUE，则“导入文件不存在”的时候，openGauss将抛出“文件不存在的”错误。 - -该参数属于SUSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：布尔型 - -- on表示导入时区分“导入文件记录数为空”和“导入文件不存在”。 -- off表示导入时不区分“导入文件记录数为空”和“导入文件不存在”。 - -**默认值：**off - -## partition\_mem\_batch - -**参数说明：**为了优化对列存分区表的批量插入，在批量插入过程中会对数据进行缓存后再批量写盘。通过partition\_mem\_batch可指定缓存个数。该值设置过大，将消耗较多系统内存资源；设置过小，将降低系统列存分区表批量插入性能。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**：1\~ 65535 - -**默认值：**256 - -## partition\_max\_cache\_size - -**参数说明：**为了优化对列存分区表的批量插入，在批量插入过程中会对数据进行缓存后再批量写盘。通过partition\_max\_cache\_size可指定数据缓存区大小。该值设置过大，将消耗较多系统内存资源；设置过小，将降低列存分区表批量插入性能。 - -该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**： - -列存分区表：4096\~ INT\_MAX / 2，最小单位为KB。 - -**默认值：**2GB - -## enable\_delta\_store - -**参数说明：**为了增强列存单条数据导入的性能和解决磁盘冗余问题，可通过此参数选择是否开启支持列存delta表功能。该参数开启时，数据导入列存表，会根据表定义时指定的[DELTAROW\_THRESHOLD](CREATE-TABLE.md#zh-cn_topic_0237122117_zh-cn_topic_0059778169_lb0b5377e83534b3eac0e425f44b60166)决定数据进入delta表存储还是主表CU存储，当数据量小于DELTAROW\_THRESHOLD时，数据进入delta表。该参数影响的操作包括insert，copy，vacuum，vacuum full，vacuum deltamerge重分布等所有涉及列存表数据移动的操作。 - -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - -**取值范围**： - -- on表示开启列存delta表功能。 -- off表示不开启列存delta表功能。 - -**默认值：**off - diff --git "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\344\272\272\345\221\230\351\200\211\351\241\271.md" "b/content/zh/docs/Developerguide/\345\274\200\345\217\221\344\272\272\345\221\230\351\200\211\351\241\271.md" index ac3c08266e3bebd75d700c5510d5dc962ec158a6..a09ce753e008c0478087dc83c22fe44b053144a9 100644 --- "a/content/zh/docs/Developerguide/\345\274\200\345\217\221\344\272\272\345\221\230\351\200\211\351\241\271.md" +++ "b/content/zh/docs/Developerguide/\345\274\200\345\217\221\344\272\272\345\221\230\351\200\211\351\241\271.md" @@ -623,7 +623,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 ## enable\_opfusion -**参数说明**：控制是否对简单查询进行查询优化。 +**参数说明**：控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 diff --git "a/content/zh/docs/Developerguide/\345\276\252\347\216\257\350\257\255\345\217\245.md" "b/content/zh/docs/Developerguide/\345\276\252\347\216\257\350\257\255\345\217\245.md" index 7d934bcf42720955ca1783883fbf345b4b158e3b..06904ff62d470db38b57ab8acf5c23a9c84bc495 100644 --- "a/content/zh/docs/Developerguide/\345\276\252\347\216\257\350\257\255\345\217\245.md" +++ "b/content/zh/docs/Developerguide/\345\276\252\347\216\257\350\257\255\345\217\245.md" @@ -106,7 +106,7 @@ CREATE TABLE hdfs_t1 ( interval VARCHAR2(20), time DATE, isModified VARCHAR2(10) -) +); INSERT INTO hdfs_t1 VALUES( 8, 'Donald', 'OConnell', 'DOCONNEL', '650.507.9833', to_date('21-06-1999', 'dd-mm-yyyy'), 'SH_CLERK' ); diff --git "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\207\275\346\225\260.md" "b/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\207\275\346\225\260.md" index faf4419decfb91f5adedc92a78e04937c7b0a9aa..51e7d9bbb0325f4bd7181593dad8f75a469414ff 100644 --- "a/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\207\275\346\225\260.md" +++ "b/content/zh/docs/Developerguide/\346\225\260\346\215\256\345\272\223\345\257\271\350\261\241\345\207\275\346\225\260.md" @@ -451,6 +451,12 @@ 备注：pg\_relation\_filepath类似于pg\_relation\_filenode，但是它返回关系的整个文件路径名（相对于openGauss的数据目录PGDATA）。 +- pg_filenode_relation(tablespace oid, filenode oid) + + 描述：获取对应的tablespace和relfilenode所对应的表名。 + + 返回值类型：regclass + - pg_partition_filenode(partition_oid) 描述：获取到指定分区表的oid锁对应的filenode。 diff --git "a/content/zh/docs/Developerguide/\346\225\260\347\273\204\350\241\250\350\276\276\345\274\217.md" "b/content/zh/docs/Developerguide/\346\225\260\347\273\204\350\241\250\350\276\276\345\274\217.md" index 1f74d8b12f7ff4c0b52b6068e1a1541b82522925..7cb725eb74c6daccd79e6ef5b55cee72a35630c5 100644 --- "a/content/zh/docs/Developerguide/\346\225\260\347\273\204\350\241\250\350\276\276\345\274\217.md" +++ "b/content/zh/docs/Developerguide/\346\225\260\347\273\204\350\241\250\350\276\276\345\274\217.md" @@ -1,94 +1,92 @@ -# 数组表达式 - -## IN - -_expression _**IN **_\(value \[, ...\]\)_ - -右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果列表中的内容符合左侧表达式的结果，则IN的结果为true。如果没有相符的结果，则IN的结果为false。 - -示例如下： - -``` -postgres=# SELECT 8000+500 IN (10000, 9000) AS RESULT; - result ----------- - f -(1 row) -``` - ->![](public_sys-resources/icon-note.gif) **说明：** ->如果表达式结果为null，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 - -## NOT IN - -_expression _**NOT IN**_ \(value \[, ...\]\)_ - -右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果在列表中的内容没有符合左侧表达式结果的内容，则NOT IN的结果为true。如果有符合的内容，则NOT IN的结果为false。 - -示例如下： - -``` -postgres=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; - result ----------- - t -(1 row) -``` - ->![](public_sys-resources/icon-note.gif) **说明：** ->如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 - -提示：在所有情况下X NOT IN Y等价于NOT\(X IN Y\)。 - -## ANY/SOME \(array\) - -_expression operator _**ANY **_\(array expression\)_ - -_expression operator _**SOME **_\(array expression\)_ - -``` -postgres=# SELECT 8000+500 < SOME (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) - -``` - -``` -postgres=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) -``` - -右侧括号中的是一个数组表达式，它必须产生一个数组值。左侧表达式的结果使用操作符对数组表达式的每一行结果都进行计算和比较，比较结果必须是布尔值。 - -- 如果对比结果至少获取一个真值，则ANY的结果为true。 -- 如果对比结果没有真值，则ANY的结果为false。 - ->![](public_sys-resources/icon-note.gif) **说明：** ->如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 - -SOME是ANY的同义词。 - -## ALL \(array\) - -_expression operator _**ALL **_\(array expression\)_ - -右侧括号中的是一个数组表达式，它必须产生一个数组值。左侧表达式的结果使用操作符对数组表达式的每一行结果都进行计算和比较，比较结果必须是布尔值。 - -- 如果所有的比较结果都为真值（包括数组不含任何元素的情况），则ALL的结果为true。 -- 如果存在一个或多个比较结果为假值，则ALL的结果为false。 - -如果数组表达式产生一个NULL数组，则ALL的结果为NULL。如果左边表达式的值为NULL ，则ALL的结果通常也为NULL\(某些不严格的比较操作符可能得到不同的结果\)。另外，如果右边的数组表达式中包含null元素并且比较结果没有假值，则ALL的结果将是NULL\(某些不严格的比较操作符可能得到不同的结果\)， 而不是真。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 - -``` -postgres=# SELECT 8000+500 < ALL (array[10000,9000]) AS RESULT; - result ----------- - t -(1 row) -``` - +# 数组表达式 + +## IN + +*expression* **IN** *\(value \[, ...\]\)* + +右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果列表中的内容符合左侧表达式的结果，则IN的结果为true。如果没有相符的结果，则IN的结果为false。 + +示例如下： + +``` +postgres=# SELECT 8000+500 IN (10000, 9000) AS RESULT; + result +---------- + f +(1 row) +``` + +如果表达式结果为null，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 + +## NOT IN + +*expression* **NOT IN** *\(value \[, ...\]\)* + +右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果在列表中的内容没有符合左侧表达式结果的内容，则NOT IN的结果为true。如果有符合的内容，则NOT IN的结果为false。 + +示例如下： + +``` +postgres=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; + result +---------- + t +(1 row) +``` + +如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 + +>![](public_sys-resources/icon-note.gif) **说明：** +>在所有情况下X NOT IN Y等价于NOT\(X IN Y\)。 + +## ANY/SOME \(array\) + +*expression operator* **ANY** *\(array expression\)* + +*expression operator* **SOME** *\(array expression\)* + +``` +postgres=# SELECT 8000+500 < SOME (array[10000,9000]) AS RESULT; + result +---------- + t +(1 row) + +``` + +``` +postgres=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; + result +---------- + t +(1 row) +``` + +右侧括号中的是一个数组表达式，它必须产生一个数组值。左侧表达式的结果使用操作符对数组表达式的每一行结果都进行计算和比较，比较结果必须是布尔值。 + +- 如果对比结果至少获取一个真值，则ANY的结果为true。 +- 如果对比结果没有真值，则ANY的结果为false。 +- 如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 + +>![](public_sys-resources/icon-note.gif) **说明：** +>SOME是ANY的同义词。 + +## ALL \(array\) + +*expression operator* **ALL** *\(array expression\)* + +右侧括号中的是一个数组表达式，它必须产生一个数组值。左侧表达式的结果使用操作符对数组表达式的每一行结果都进行计算和比较，比较结果必须是布尔值。 + +- 如果所有的比较结果都为真值（包括数组不含任何元素的情况），则ALL的结果为true。 +- 如果存在一个或多个比较结果为假值，则ALL的结果为false。 + +如果数组表达式产生一个NULL数组，则ALL的结果为NULL。如果左边表达式的值为NULL ，则ALL的结果通常也为NULL\(某些不严格的比较操作符可能得到不同的结果\)。另外，如果右边的数组表达式中包含null元素并且比较结果没有假值，则ALL的结果将是NULL\(某些不严格的比较操作符可能得到不同的结果\)， 而不是真。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 + +``` +postgres=# SELECT 8000+500 < ALL (array[10000,9000]) AS RESULT; + result +---------- + t +(1 row) +``` + diff --git "a/content/zh/docs/Developerguide/\346\227\245\345\277\227\345\233\236\346\224\276.md" "b/content/zh/docs/Developerguide/\346\227\245\345\277\227\345\233\236\346\224\276.md" index 7f12f97e5dd4e61bac1adcabe411bfb6b3717d20..d9218485f563d8e91640c4d0904df4ef0886c9e1 100644 --- "a/content/zh/docs/Developerguide/\346\227\245\345\277\227\345\233\236\346\224\276.md" +++ "b/content/zh/docs/Developerguide/\346\227\245\345\277\227\345\233\236\346\224\276.md" @@ -50,8 +50,6 @@ **参数说明：**查询实际回放线程个数，该参数为只读参数。 -该参数属于POSTMASTER类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 - **取值范围**：整型，1\~2147483647 该参数受参数：recovery_max_workers及参数：recovery_parse_workers影响，上述任意一参数值大于0时，该参数值将重新计算。 diff --git "a/content/zh/docs/Developerguide/\346\235\241\344\273\266\350\241\250\350\276\276\345\274\217.md" "b/content/zh/docs/Developerguide/\346\235\241\344\273\266\350\241\250\350\276\276\345\274\217.md" index cc24be8d09f0e499828353c288f8eda5b7a619e6..91c5dc6a328c4cf478c99bca3358c23fa58456b0 100644 --- "a/content/zh/docs/Developerguide/\346\235\241\344\273\266\350\241\250\350\276\276\345\274\217.md" +++ "b/content/zh/docs/Developerguide/\346\235\241\344\273\266\350\241\250\350\276\276\345\274\217.md" @@ -196,7 +196,7 @@ ``` postgres=# SELECT nvl(null,1); - NVL + nvl ----- 1 (1 row) diff --git "a/content/zh/docs/Developerguide/\347\224\250\346\210\267\350\207\252\345\256\232\344\271\211\345\207\275\346\225\260\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" "b/content/zh/docs/Developerguide/\347\224\250\346\210\267\350\207\252\345\256\232\344\271\211\345\207\275\346\225\260\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" index 5e2803d67b02cea2cba8e06ac6ed517672504b5e..8a138f98afaa17b1d8249cd4f34d7087458fc87b 100644 --- "a/content/zh/docs/Developerguide/\347\224\250\346\210\267\350\207\252\345\256\232\344\271\211\345\207\275\346\225\260\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" +++ "b/content/zh/docs/Developerguide/\347\224\250\346\210\267\350\207\252\345\256\232\344\271\211\345\207\275\346\225\260\346\224\257\346\214\201\350\207\252\346\262\273\344\272\213\345\212\241.md" @@ -1,6 +1,6 @@ # 用户自定义函数支持自治事务 -自治事务可以在函数中定义，标识符为PRAGMA AUTONOMOUS\_TRANSACTION，执行的函数块中使用包含start transaction和commit/rollback的sql，其余语法与[CREATE FUNCTION](zh-cn_topic_0242370568.md)创建函数语法类似，一个简单的用例如下： +自治事务可以在函数中定义，标识符为PRAGMA AUTONOMOUS\_TRANSACTION，执行的函数块中使用包含start transaction和commit/rollback的sql，其余语法与[CREATE FUNCTION](CREATE-FUNCTION.md)创建函数语法类似，一个简单的用例如下： ``` --创建表。 diff --git "a/content/zh/docs/Developerguide/\347\256\200\345\215\225\350\241\250\350\276\276\345\274\217.md" "b/content/zh/docs/Developerguide/\347\256\200\345\215\225\350\241\250\350\276\276\345\274\217.md" index 85c9a002231123acdb8f1078180e7aa13345f3ec..324be54d01f5421f04f991133249f14f3817f496 100644 --- "a/content/zh/docs/Developerguide/\347\256\200\345\215\225\350\241\250\350\276\276\345\274\217.md" +++ "b/content/zh/docs/Developerguide/\347\256\200\345\215\225\350\241\250\350\276\276\345\274\217.md" @@ -1,104 +1,129 @@ -# 简单表达式 - -## 逻辑表达式 - -逻辑表达式的操作符和运算规则，请参见[逻辑操作符](逻辑操作符.md)。 - -## 比较表达式 - -常用的比较操作符，请参见[操作符](操作符.md)。 - -除比较操作符外，还可以使用以下句式结构： - -- BETWEEN操作符 - - a BETWEEN x_ _ AND y等效于a \>= x AND a <= y - - a NOT BETWEEN_ _ x AND y等效于a < x OR a \> y - -- 检查一个值是不是null，可使用： - - expression_ _IS NULL - - expression IS NOT NULL - - 或者与之等价的句式结构，但不是标准的： - - expression_ _ ISNULL - - expression NOTNULL - - >![](public_sys-resources/icon-notice.gif) **须知：** - >不要写expression=NULL或expression<\>\(!=\)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 - - -## 示例 - -``` -postgres=# SELECT 2 BETWEEN 1 AND 3 AS RESULT; - result ----------- - t -(1 row) - -postgres=# SELECT 2 >= 1 AND 2 <= 3 AS RESULT; - result ----------- - t -(1 row) - -postgres=# SELECT 2 NOT BETWEEN 1 AND 3 AS RESULT; - result ----------- - f -(1 row) - -postgres=# SELECT 2 < 1 OR 2 > 3 AS RESULT; - result ----------- - f -(1 row) - -postgres=# SELECT 2+2 IS NULL AS RESULT; - result ----------- - f -(1 row) - -postgres=# SELECT 2+2 IS NOT NULL AS RESULT; - result ----------- - t -(1 row) - -postgres=# SELECT 2+2 ISNULL AS RESULT; - result ----------- - f -(1 row) - -postgres=# SELECT 2+2 NOTNULL AS RESULT; - result ----------- - t -(1 row) - -postgres=# SELECT 2+2 IS DISTINCT FROM NULL AS RESULT; - result ----------- - t -(1 row) - -postgres=# SELECT 2+2 IS NOT DISTINCT FROM NULL AS RESULT; - result ----------- - f -(1 row) -``` - -## 伪列 -### ROWNUM -ROWNUM是一个伪列， 它返回一个数字表示从查询中获取结果的行编号，第一行的ROWNUM为1， 第二行的为2，依此类推。ROWNUM的返回类型为BIGINT。ROWNUM可以用于限制查询返回的总行数， 例如下面查询用于从Students表中返回最多10条记录。 -```sql -select * from Students where rownum <= 10; -``` \ No newline at end of file +# 简单表达式 + +## 逻辑表达式 + +逻辑表达式的操作符和运算规则，请参见[逻辑操作符](zh-cn_topic_0289900814.md)。 + +## 比较表达式 + +常用的比较操作符，请参见[操作符](zh-cn_topic_0289900672.md)。 + +除比较操作符外，还可以使用以下句式结构： + +- BETWEEN操作符 + + a BETWEEN x_ _ AND y等效于a \>= x AND a <= y + + a NOT BETWEEN_ _ x AND y等效于a < x OR a \> y + +- 检查一个值是不是null，可使用： + + expression_ _IS NULL + + expression IS NOT NULL + + 或者与之等价的句式结构，但不是标准的： + + expression_ _ ISNULL + + expression NOTNULL + + >![](public_sys-resources/icon-notice.gif) **须知：** + >不要写expression=NULL或expression<\>\(!=\)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 + + +- is distinct from/is not distinct from + - is distinct from + + A和B的数据类型、值不完全相同时为true。 + + A和B的数据类型、值完全相同时为false。 + + 将空值视为相同。 + + - is not distinct from + + A和B的数据类型、值不完全相同时为false。 + + A和B的数据类型、值完全相同时为true。 + + 将空值视为相同。 + + + +## 伪列 + +ROWNUM + +ROWNUM是一个伪列， 它返回一个数字，表示从查询中获取结果的行编号。第一行的ROWNUM为1， 第二行的为2，依此类推。 + +ROWNUM的返回类型为BIGINT。ROWNUM可以用于限制查询返回的总行数， 例如下面语句限制查询从Students表中返回最多10条记录。 + +``` +select * from Students where rownum <= 10; +``` + +## 示例 + +``` +postgres=# SELECT 2 BETWEEN 1 AND 3 AS RESULT; + result +---------- + t +(1 row) + +postgres=# SELECT 2 >= 1 AND 2 <= 3 AS RESULT; + result +---------- + t +(1 row) + +postgres=# SELECT 2 NOT BETWEEN 1 AND 3 AS RESULT; + result +---------- + f +(1 row) + +postgres=# SELECT 2 < 1 OR 2 > 3 AS RESULT; + result +---------- + f +(1 row) + +postgres=# SELECT 2+2 IS NULL AS RESULT; + result +---------- + f +(1 row) + +postgres=# SELECT 2+2 IS NOT NULL AS RESULT; + result +---------- + t +(1 row) + +postgres=# SELECT 2+2 ISNULL AS RESULT; + result +---------- + f +(1 row) + +postgres=# SELECT 2+2 NOTNULL AS RESULT; + result +---------- + t +(1 row) + +postgres=# SELECT 2+2 IS DISTINCT FROM NULL AS RESULT; + result +---------- + t +(1 row) + +postgres=# SELECT 2+2 IS NOT DISTINCT FROM NULL AS RESULT; + result +---------- + f +(1 row) +``` + diff --git "a/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\345\207\275\346\225\260.md" "b/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\345\207\275\346\225\260.md" index 065805f324f081ffeb80785488b232df4ffe5e67..80d0f30c958de1c4ce8d4528f3f5fd158bd894ff 100644 --- "a/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\345\207\275\346\225\260.md" +++ "b/content/zh/docs/Developerguide/\347\273\237\350\256\241\344\277\241\346\201\257\345\207\275\346\225\260.md" @@ -1,4 +1,4 @@ -# 统计信息函数 +# 统计信息函数 统计信息函数根据访问对象分为两种类型：针对某个数据库进行访问的函数，以数据库中每个表或索引的OID作为参数，标识需要报告的数据库；针对某个服务器进行访问的函数，以一个服务器进程号为参数，其范围从1到当前活跃服务器的数目。 @@ -22,7 +22,7 @@ - pg\_stat\_get\_function\_total\_time\(oid\) - 描述：该函数花费的总挂钟时间，以微秒为单位。包括花费在此函数调用上的时间。 + 描述：该函数花费的总挂钟时间，以微秒为单位。包括花费在此函数调用其它函数上的时间。 返回值类型：bigint @@ -58,15 +58,15 @@ - pg\_stat\_get\_xact\_function\_self\_time\(oid\) - 描述：在当前事务中仅花费在此功能上的时间，不包括花费在调用函数上的时间。 + 描述：在当前事务中仅花费在此函数上的时间，不包括花费在此函数内部调用其它函数上的时间。 返回值类型：bigint - pg\_stat\_get\_xact\_function\_total\_time\(oid\) - 描述：当前事务中该函数所花费的总挂钟时间（以微秒为单位），包括花费在此函数调用上的时间。 + 描述：当前事务中该函数所花费的总挂钟时间（以微秒为单位），包括花费在此函数内部调用其它函数上的时间。 - 返回值类型： + 返回值类型：bigint - pg\_stat\_get\_wal\_senders\(\) @@ -78,160 +78,160 @@ **表 1** 返回字段说明 - -

字段名称

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -247,41 +247,41 @@ **表 2** 返回值说明 - -

字段名称

字段类型

+

字段类型

字段说明

+

字段说明

pid

+

pid

bigint

+

bigint

walsender的线程号。

+

walsender的线程号。

sender_pid

+

sender_pid

integer

+

integer

walsender的pid相对的轻量级线程号。

+

walsender的pid相对的轻量级线程号。

local_role

+

local_role

text

+

text

主节点类型。

+

主节点类型。

peer_role

+

peer_role

text

+

text

备节点类型。

+

备节点类型。

peer_state

+

peer_state

text

+

text

备节点状态。

+

备节点状态。

state

+

state

text

+

text

walsender状态。

+

walsender状态。

catchup_start

+

catchup_start

timestamp with time zone

+

timestamp with time zone

catchup启动时间。

+

catchup启动时间。

catchup_end

+

catchup_end

timestamp with time zone

+

timestamp with time zone

catchup结束时间。

+

catchup结束时间。

sender_sent_location

+

sender_sent_location

text

+

text

主节点发送位置。

+

主节点发送位置。

sender_write_location

+

sender_write_location

text

+

text

主节点落盘位置。

+

主节点落盘位置。

sender_flush_location

+

sender_flush_location

text

+

text

主节点flush磁盘位置。

+

主节点flush磁盘位置。

sender_replay_location

+

sender_replay_location

text

+

text

主节点redo位置。

+

主节点redo位置。

receiver_received_location

+

receiver_received_location

text

+

text

备节点接收位置。

+

备节点接收位置。

receiver_write_location

+

receiver_write_location

text

+

text

备节点落盘位置。

+

备节点落盘位置。

receiver_flush_location

+

receiver_flush_location

text

+

text

备节点flush磁盘位置。

+

备节点flush磁盘位置。

receiver_replay_location

+

receiver_replay_location

text

+

text

备节点redo磁盘位置。

+

备节点redo磁盘位置。

sync_percent

+

sync_percent

text

+

text

同步百分比。

+

同步百分比。

sync_state

+

sync_state

text

+

text

同步状态。

+

同步状态。

sync_priority

+

sync_priority

text

+

text

同步复制的优先级。

+

同步复制的优先级。

sync_most_available

+

sync_most_available

text

+

text

最大可用模式设置。

+

最大可用模式设置。

channel

+

channel

text

+

text

walsender信道信息。

+

walsender信道信息。

返回参数

+ + - - - - - - - - - - - - - - @@ -419,19 +419,19 @@ - pg\_stat\_get\_tuples\_hot\_updated\(oid\) - 描述：热更新的行数表。 + 描述：表热更新的行数。 返回值类型：bigint - pg\_stat\_get\_live\_tuples\(oid\) - 描述：活行数表。 + 描述：表活行数。 返回值类型：bigint - pg\_stat\_get\_dead\_tuples\(oid\) - 描述：死行数表。 + 描述：表死行数。 返回值类型：bigint @@ -473,13 +473,13 @@ - pg\_stat\_get\_partition\_live\_tuples\(oid\) - 描述：活行数表分区。 + 描述：分区表活行数。 返回值类型：bigint - pg\_stat\_get\_partition\_dead\_tuples\(oid\) - 描述：死行数表分区。 + 描述：分区表死行数。 返回值类型：bigint @@ -589,62 +589,62 @@ **表 3** 返回参数说明 - -

返回参数

返回参数类型

+

返回参数类型

返回参数说明

+

返回参数说明

local_role

+

local_role

text

+

text

本地角色。

+

本地角色。

static_connections

+

static_connections

integer

+

integer

连接统计。

+

连接统计。

db_state

+

db_state

text

+

text

数据库状态。

+

数据库状态。

detail_information

+

detail_information

text

+

text

详细信息。

+

详细信息。

返回参数

+ + - - - - - - - - - - - - - - - - - - - - - - - @@ -660,76 +660,76 @@ **表 4** 返回值参数说明 - -

返回参数

返回参数类型

+

返回参数类型

返回参数说明

+

返回参数说明

nodename

+

nodename

name

+

name

节点名称。

+

节点名称。

nspname

+

nspname

name

+

name

名称空间名称。

+

名称空间名称。

relname

+

relname

name

+

name

表、索引、视图等对象名称。

+

表、索引、视图等对象名称。

partname

+

partname

name

+

name

分区名称。

+

分区名称。

n_dead_tuples

+

n_dead_tuples

bigint

+

bigint

表分区内的死行数。

+

表分区内的死行数。

n_live_tuples

+

n_live_tuples

bigint

+

bigint

表分区内的活行数。

+

表分区内的活行数。

changes_since_analyze

+

changes_since_analyze

bigint

+

bigint

analyze产生改变的数量。

+

analyze产生改变的数量。

返回参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -749,7 +749,7 @@ - pg\_stat\_get\_last\_data\_changed\_time\(oid\) - 描述：insert/update/delete, exchange/truncate/drop partition在该表上最后一次操作的时间，[PG\_STAT\_ALL\_TABLES](zh-cn_topic_0242385969.md)视图last\_data\_changed列的数据是通过该函数求值，在表数量很大的场景中，通过视图获取表数据最后修改时间的性能较差，建议直接使用该函数获取表数据的最后修改时间。 + 描述：insert/update/delete, exchange/truncate/drop partition在该表上最后一次操作的时间，[PG\_STAT\_ALL\_TABLES](zh-cn_topic_0289900450.md)视图last\_data\_changed列的数据是通过该函数求值，在表数量很大的场景中，通过视图获取表数据最后修改时间的性能较差，建议直接使用该函数获取表数据的最后修改时间。 返回值类型：timestamptz @@ -767,7 +767,7 @@ - pg\_stat\_get\_activity\(integer\) - 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是[PG\_STAT\_ACTIVITY](zh-cn_topic_0242385966.md)视图中的一个子集，不包含connection\_info列。 + 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是[PG\_STAT\_ACTIVITY](zh-cn_topic_0289899849.md)视图中的一个子集，不包含connection\_info列。 示例： @@ -791,133 +791,133 @@ **表 5** 返回参数说明 - -

返回参数

返回参数类型

+

返回参数类型

返回参数说明

+

返回参数说明

nspname

+

nspname

text

+

text

名称空间名称。

+

名称空间名称。

relname

+

relname

text

+

text

表、索引、视图等对象名称。

+

表、索引、视图等对象名称。

nodename

+

nodename

text

+

text

节点名称。

+

节点名称。

doanalyze

+

doanalyze

Boolean

+

Boolean

是否执行analyze。

+

是否执行analyze。

anltuples

+

anltuples

bigint

+

bigint

analyze tuple数量。

+

analyze tuple数量。

anlthresh

+

anlthresh

bigint

+

bigint

analyze阈值。

+

analyze阈值。

dovacuum

+

dovacuum

Boolean

+

Boolean

是否执行vacuum。

+

是否执行vacuum。

vactuples

+

vactuples

bigint

+

bigint

vacuum tuple数量。

+

vacuum tuple数量。

vacthresh

+

vacthresh

bigint

+

bigint

vacuum阈值。

+

vacuum阈值。

返回参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -925,7 +925,7 @@ - pg\_stat\_get\_activity\_with\_conninfo\(integer\) - 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是[PG\_STAT\_ACTIVITY](zh-cn_topic_0242385966.md)视图中的一个子集。 + 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是[PG\_STAT\_ACTIVITY](zh-cn_topic_0289899849.md)视图中的一个子集。 返回值类型：setofrecord @@ -933,139 +933,139 @@ **表 6** 返回值说明 - -

返回参数

返回参数类型

+

返回参数类型

返回参数说明

+

返回参数说明

datid

+

datid

oid

+

oid

用户会话在后台连接到的数据库OID。

+

用户会话在后台连接到的数据库OID。

pid

+

pid

bigint

+

bigint

后台线程ID。

+

后台线程ID。

sessionid

+

sessionid

bigint

+

bigint

会话ID。

+

会话ID。

usesysid

+

usesysid

oid

+

oid

登录该后台的用户名。

+

登录该后台的用户名。

application_name

+

application_name

text

+

text

连接到该后台的应用名。

+

连接到该后台的应用名。

state

+

state

text

+

text

该后台当前总体状态。

+

该后台当前总体状态。

query

+

query

text

+

text

该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。

+

该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。

waiting

+

waiting

Boolean

+

Boolean

如果后台当前正等待锁则为true。

+

如果后台当前正等待锁则为true。

xact_start

+

xact_start

timestamp with time zone

+

timestamp with time zone

启动当前事务的时间，如果没有事务是活跃的，则为null。

-

如果当前查询是首个事务，则这列等同于query_start列。

+

启动当前事务的时间，如果没有事务是活跃的，则为null。

+

如果当前查询是首个事务，则这列等同于query_start列。

query_start

+

query_start

timestamp with time zone

+

timestamp with time zone

开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。

+

开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。

backend_start

+

backend_start

timestamp with time zone

+

timestamp with time zone

该过程开始的时间，即当客户端连接服务器时。

+

该过程开始的时间，即当客户端连接服务器时。

state_change

+

state_change

timestamp with time zone

+

timestamp with time zone

上次状态改变的时间。

+

上次状态改变的时间。

client_addr

+

client_addr

inet

+

inet

连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum。

+

连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum。

client_hostname

+

client_hostname

text

+

text

客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。

+

客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。

client_port

+

client_port

integer

+

integer

客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。

+

客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。

enqueue

+

enqueue

text

+

text

该字段暂不支持。

+

该字段暂不支持。

query_id

+

query_id

bigint

+

bigint

查询语句的ID。

+

查询语句的ID。

返回值

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1079,62 +1079,62 @@ 函数返回字段说明如下： - -

返回值

返回值类型

+

返回值类型

返回值说明

+

返回值说明

datid

+

datid

oid

+

oid

用户会话在后台连接到的数据库OID。

+

用户会话在后台连接到的数据库OID。

pid

+

pid

bigint

+

bigint

后台线程ID。

+

后台线程ID。

sessionid

+

sessionid

bigint

+

bigint

会话ID。

+

会话ID。

usesysid

+

usesysid

oid

+

oid

登录该后台的用户名。

+

登录该后台的用户名。

application_name

+

application_name

text

+

text

连接到该后台的应用名。

+

连接到该后台的应用名。

state

+

state

text

+

text

改后台当前总体状态

+

改后台当前总体状态

query

+

query

text

+

text

该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。

+

该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。

waiting

+

waiting

Boolean

+

Boolean

如果后台当前正等待锁则为true

+

如果后台当前正等待锁则为true

xact_start

+

xact_start

timestamp with time zone

+

timestamp with time zone

启动当前事务的时间，如果没有事务是活跃的，则为null。如果当前查询是首个事务，则这列等同于query_start列。

+

启动当前事务的时间，如果没有事务是活跃的，则为null。如果当前查询是首个事务，则这列等同于query_start列。

query_start

+

query_start

timestamp with time zone

+

timestamp with time zone

开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。

+

开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。

backend_start

+

backend_start

timestamp with time zone

+

timestamp with time zone

该过程开始的时间，即当客户端连接服务器时。

+

该过程开始的时间，即当客户端连接服务器时。

state_change

+

state_change

timestamp with time zone

+

timestamp with time zone

上次状态改变的时间。

+

上次状态改变的时间。

client_addr

+

client_addr

inet

+

inet

连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum

+

连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum

client_hostname

+

client_hostname

text

+

text

客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。

+

客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。

client_port

+

client_port

integer

+

integer

客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。

+

客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。

enqueue

+

enqueue

text

+

text

该字段暂不支持。

+

该字段暂不支持。

query_id

+

query_id

bigint

+

bigint

查询语句的ID。

+

查询语句的ID。

connection_info

+

connection_info

text

+

text

json格式字符串，记录当前连接数据库的驱动类型、驱动版本号、当前驱动的部署路径、进程属主用户等信息。

+

json格式字符串，记录当前连接数据库的驱动类型、驱动版本号、当前驱动的部署路径、进程属主用户等信息。

名称

+ + - - - - - - - - - - - - - - - - - - - - - - - @@ -1146,15 +1146,9 @@ 返回值类型：bigint -- pg\_stat\_get\_function\_time\(oid\) - - 描述：该函数花费的总挂钟时间，单位为微秒。包括在这个函数调用所花费的时间。 - - 返回值类型：bigint - - pg\_stat\_get\_function\_self\_time\(oid\) - 描述：只有在此功能所花费的时间。在所谓的功能所花费的时间被排除在外。 + 描述：只有在此函数上所花费的时间。此函数调用其它函数上花费的时间被排除在外。 返回值类型：bigint @@ -1310,13 +1304,13 @@ - gs\_get\_stat\_session\_cu\(text, int, int, int\) - 描述：获取openGauss所有运行session的CU命中统计信息。 + 描述：获取数据库openGauss所有运行session的CU命中统计信息。 返回值类型：record - gs\_get\_stat\_db\_cu\(text, text, int, int, int\) - 描述：获取openGauss一个数据库的CU命中统计信息。 + 描述：获取GaussDB KernelopenGauss一个数据库的CU命中统计信息。 返回值类型：record @@ -1416,76 +1410,76 @@ 返回信息如下： - -

名称

类型

+

类型

描述

+

描述

userid

+

userid

oid

+

oid

用户id。

+

用户id。

min_curr_iops

+

min_curr_iops

int4

+

int4

当前该用户io在数据库节点中的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

当前该用户io在数据库节点中的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

max_curr_iops

+

max_curr_iops

int4

+

int4

当前该用户io在数据库节点中的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

当前该用户io在数据库节点中的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

min_peak_iops

+

min_peak_iops

int4

+

int4

该用户io峰值中，数据库节点的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

该用户io峰值中，数据库节点的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

max_peak_iops

+

max_peak_iops

int4

+

int4

该用户io峰值中，数据库节点的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

该用户io峰值中，数据库节点的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。

io_limits

+

io_limits

int4

+

int4

用户指定的资源池所设置的io_limits。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

用户指定的资源池所设置的io_limits。对于行存，以万次/s为单位；对于列存，以次/s为单位。

io_priority

+

io_priority

text

+

text

该用户所设io_priority。对于行存，以万次/s为单位；对于列存，以次/s为单位。

+

该用户所设io_priority。对于行存，以万次/s为单位；对于列存，以次/s为单位。

属性

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1509,104 +1503,104 @@ 返回值类型：record - -

属性

属性值

+

属性值

描述

+

描述

name

+

name

class_a:workload_a1

+

class_a:workload_a1

class和workload名称

+

class和workload名称

class

+

class

class_a

+

class_a

Class控制组名称

+

Class控制组名称

workload

+

workload

workload_a1

+

workload_a1

Workload控制组名称

+

Workload控制组名称

type

+

type

DEFWD

+

DEFWD

控制组类型（Top、CLASS、BAKWD、DEFWD、TSWD）

+

控制组类型（Top、CLASS、BAKWD、DEFWD、TSWD）

gid

+

gid

87

+

87

控制组id

+

控制组id

shares

+

shares

30

+

30

占父节点CPU资源的百分比

+

占父节点CPU资源的百分比

limits

+

limits

0

+

0

占父节点CPU核数的百分比

+

占父节点CPU核数的百分比

rate

+

rate

0

+

0

Timeshare中的分配比例

+

Timeshare中的分配比例

cpucores

+

cpucores

0-3

+

0-3

CPU核心数

+

CPU核心数

属性

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1618,83 +1612,83 @@ 返回值类型：record - -

属性

属性值

+

属性值

描述

+

描述

resourcepool_oid

+

resourcepool_oid

10

+

10

资源池的oid(逻辑同负载等价)

+

资源池的oid(逻辑同负载等价)

commit_counter

+

commit_counter

4

+

4

前端事务commit数量

+

前端事务commit数量

rollback_counter

+

rollback_counter

1

+

1

前端事务rollback数量

+

前端事务rollback数量

resp_min

+

resp_min

949

+

949

前端事务最小响应时间（单位：微秒）

+

前端事务最小响应时间（单位：微秒）

resp_max

+

resp_max

201891

+

201891

前端事务最大响应时间（单位：微秒）

+

前端事务最大响应时间（单位：微秒）

resp_avg

+

resp_avg

43564

+

43564

前端事务平均响应时间(单位：微秒)

+

前端事务平均响应时间(单位：微秒)

resp_total

+

resp_total

217822

+

217822

前端事务总响应时间（单位：微秒）

+

前端事务总响应时间（单位：微秒）

bg_commit_counter

+

bg_commit_counter

910

+

910

后端事务commit数量

+

后端事务commit数量

bg_rollback_counter

+

bg_rollback_counter

0

+

0

后端事务rollback数量

+

后端事务rollback数量

bg_resp_min

+

bg_resp_min

97

+

97

后端事务最小响应时间（单位：微秒）

+

后端事务最小响应时间（单位：微秒）

bg_resp_max

+

bg_resp_max

678080687

+

678080687

后端事务最大响应时间（单位：微秒）

+

后端事务最大响应时间（单位：微秒）

bg_resp_avg

+

bg_resp_avg

327847884

+

327847884

后端事务平均响应时间（单位：微秒）

+

后端事务平均响应时间（单位：微秒）

bg_resp_total

+

bg_resp_total

298341575300

+

298341575300

后端事务总响应时间（单位：微秒）

+

后端事务总响应时间（单位：微秒）

Stat_name属性

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1702,7 +1696,7 @@ - DBE\_PERF.get\_global\_instance\_time\(\) - 描述：提供openGauss各个关键阶段的时间消耗，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。 + 描述：提供整个数据库openGauss各个关键阶段的时间消耗，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -1732,7 +1726,7 @@ - get\_instr\_rt\_percentile\(\) - 描述：获取CCN节点SQL 响应时间P80，P95分布信息，openGauss统一的信息在CCN节点上，其他节点查询为0。 + 描述：获取CCN节点SQL 响应时间P80，P95分布信息，数据库openGauss统一的信息在CCN节点上，其他节点查询为0。 返回值类型：record @@ -1750,31 +1744,31 @@ - DBE\_PERF.get\_global\_os\_threads\(\) - 描述：提供openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。 + 描述：提供整个数据库openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_summary\_workload\_sql\_count\(\) - 描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，DDL， DML，DCL计数信息，查询该函数必须具有sysadmin权限。 + 描述：提供整个数据库openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，DDL， DML，DCL计数信息，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_summary\_workload\_sql\_elapse\_time\(\) - 描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。 + 描述：提供整个数据库openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_global\_workload\_transaction\(\) - 描述：获取openGauss内所有节点上的事务量信息，事务时间信息，查询该函数必须具有sysadmin权限。 + 描述：获取数据库openGauss内所有节点上的事务量信息，事务时间信息，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_global\_session\_stat\(\) - 描述：获取openGauss节点上的会话状态信息，查询该函数必须具有sysadmin权限。 + 描述：获取数据库openGauss节点上的会话状态信息，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -1786,7 +1780,7 @@ - DBE\_PERF.get\_global\_session\_time\(\) - 描述：提供openGauss各节点各个关键阶段的时间消耗，查询该函数必须具有sysadmin权限。 + 描述：提供整个数据库openGauss各节点各个关键阶段的时间消耗，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -1816,7 +1810,7 @@ - create\_wlm\_session\_info\(int flag\) - 描述：将当前内存中记录的TopSQL查询语句级别相关统计信息清理，当传入的参数大于0时，会将这部分信息归档到gs\_wlm\_session\_query\_info\_all中，否则不会归档。该函数只有管理员用户可以执行。 + 描述：将当前内存中记录的TopSQL查询语句级别相关统计信息清理。该函数只有管理员用户可以执行。 返回值类型：int @@ -1980,6 +1974,12 @@ 返回值类型：record +- pg\_catalog.plancache\_status\(\) + + 描述：显示所有主节点上GPC缓存的计划状态信息。具体返回字段见[GLOBAL\_PLANCACHE\_STATUS](zh-cn_topic_0297927201.md) + + 返回值类型：record + - DBE\_PERF.get\_global\_active\_session\(\) 描述：显示所有节点上的ACTIVE SESSION PROFILE内存中的样本的汇总 @@ -1988,7 +1988,7 @@ - DBE\_PERF.get\_global\_session\_stat\_activity\(\) - 描述：汇聚openGauss内各节点上正在运行的线程相关的信息，查询该函数必须具有sysadmin权限。 + 描述：汇聚数据库openGauss内各节点上正在运行的线程相关的信息，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2084,7 +2084,7 @@ - DBE\_PERF.get\_summary\_statio\_all\_tables\(\) - 描述：统计openGauss内数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。 + 描述：统计数据库openGauss内数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2120,7 +2120,7 @@ - DBE\_PERF.get\_summary\_statio\_sys\_tables\(\) - 描述：openGauss内汇聚命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。 + 描述：数据库openGauss内汇聚命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2132,7 +2132,7 @@ - DBE\_PERF.get\_summary\_statio\_user\_indexes\(\) - 描述：openGauss内汇聚命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。 + 描述：数据库openGauss内汇聚命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2150,13 +2150,13 @@ - DBE\_PERF.get\_summary\_statio\_user\_tables\(\) - 描述：openGauss内汇聚命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。 + 描述：数据库openGauss内汇聚命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_stat\_db\_cu\(\) - 描述：视图查询openGauss各个节点，每个数据库的CU命中情况，查询该函数必须具有sysadmin权限。 + 描述：视图查询数据库openGauss各个节点，每个数据库的CU命中情况，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2372,19 +2372,19 @@ - DBE\_PERF.get\_statement\_responsetime\_percentile\(\) - 描述：获取openGaussSQL响应时间P80，P95分布信息，查询该函数必须具有sysadmin权限。 + 描述：获取数据库openGaussSQL响应时间P80，P95分布信息，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_summary\_user\_login\(\) - 描述：统计openGauss各节点用户登入登出次数信息，查询该函数必须具有sysadmin权限。 + 描述：统计数据库openGauss各节点用户登入登出次数信息，查询该函数必须具有sysadmin权限。 返回值类型：record - DBE\_PERF.get\_global\_record\_reset\_time\(\) - 描述：汇聚openGauss统计信息重置（重启，主备倒换，数据库删除）时间，查询该函数必须具有sysadmin权限。 + 描述：汇聚数据库openGauss统计信息重置（重启，主备倒换，数据库删除）时间，查询该函数必须具有sysadmin权限。 返回值类型：record @@ -2426,74 +2426,136 @@ - DBE\_PERF.global\_threadpool\_status\(\) - 描述：显示在所有节点上的线程池中工作线程及会话的状态信息。函数返回信息具体字段[GLOBAL\_THREADPOOL\_STATUS](zh-cn_topic_0245374746.md)字段。 + 描述：显示在所有节点上的线程池中工作线程及会话的状态信息。函数返回信息具体字段[GLOBAL\_THREADPOOL\_STATUS](zh-cn_topic_0289900218.md)字段。 返回值类型：record +- remote\_bgwriter\_stat\(\) + + 描述：显示整个集群所有实例的bgwriter线程刷页信息，候选buffer链中页面个数，buffer淘汰信息（本节点除外、DN上不可使用）。 + + 返回值类型：record + + **表 7** remote\_bgwriter\_stat参数说明 + + +

Stat_name属性

属性值

+

属性值

描述

+

描述

DB_TIME

+

DB_TIME

1062385

+

1062385

所有线程端到端的墙上时间（WALL TIME）消耗总和(单位： 微秒)

+

所有线程端到端的墙上时间（WALL TIME）消耗总和(单位： 微秒)

CPU_TIME

+

CPU_TIME

311777

+

311777

所有线程CPU时间消耗总和(单位： 微秒)

+

所有线程CPU时间消耗总和(单位： 微秒)

EXECUTION_TIME

+

EXECUTION_TIME

380037

+

380037

消耗在执行器上的时间总和(单位： 微秒)

+

消耗在执行器上的时间总和(单位： 微秒)

PARSE_TIME

+

PARSE_TIME

6033

+

6033

消耗在SQL解析上的时间总和(单位： 微秒)

+

消耗在SQL解析上的时间总和(单位： 微秒)

PLAN_TIME

+

PLAN_TIME

173356

+

173356

消耗在执行计划生成上的时间总和(单位： 微秒)

+

消耗在执行计划生成上的时间总和(单位： 微秒)

REWRITE_TIME

+

REWRITE_TIME

2274

+

2274

消耗在查询重写上的时间总和(单位： 微秒)

+

消耗在查询重写上的时间总和(单位： 微秒)

PL_EXECUTION_TIME

+

PL_EXECUTION_TIME

0

+

0

消耗在PL/SQL执行上的时间总和(单位： 微秒)

+

消耗在PL/SQL执行上的时间总和(单位： 微秒)

PL_COMPILATION_TIME

+

PL_COMPILATION_TIME

557

+

557

消耗在SQL编译上的时间总和(单位： 微秒)

+

消耗在SQL编译上的时间总和(单位： 微秒)

NET_SEND_TIME

+

NET_SEND_TIME

1673

+

1673

消耗在网络发送上的时间总和(单位： 微秒)

+

消耗在网络发送上的时间总和(单位： 微秒)

DATA_IO_TIME

+

DATA_IO_TIME

426622

+

426622

消耗在数据读写上的时间总和(单位： 微秒)

+

消耗在数据读写上的时间总和(单位： 微秒)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

参数

+

类型

+

描述

+

node_name

+

text

+

实例名称。

+

bgwr_actual_flush_total_num

+

bigint

+

从启动到当前时间bgwriter线程总计刷脏页数量。

+

bgwr_last_flush_num

+

integer

+

bgwriter线程上一批刷脏页数量。

+

candidate_slots

+

integer

+

当前候选buffer链中页面个数。

+

get_buffer_from_list

+

bigint

+

buffer淘汰从候选buffer链中获取页面的次数。

+

get_buf_clock_sweep

+

bigint

+

buffer淘汰从原淘汰方案中获取页面的次数。

+
+ - remote\_ckpt\_stat\(\) 描述：用于显示整个集群所有实例的检查点信息和各类日志刷页情况（本节点除外）。 返回值类型：record - **表 7** remote\_ckpt\_stat参数说明 + **表 8** remote\_ckpt\_stat参数说明 - -

参数

+ + - - - - - - - - - - - - - - - - - - - - - - - @@ -2505,92 +2567,92 @@ 返回值类型：record - **表 8** remote\_double\_write\_stat参数说明 + **表 9** remote\_double\_write\_stat参数说明 - -

参数

类型

+

类型

描述

+

描述

node_name

+

node_name

text

+

text

实例名称。

+

实例名称。

ckpt_redo_point

+

ckpt_redo_point

text

+

text

当前实例的检查点。

+

当前实例的检查点。

ckpt_clog_flush_num

+

ckpt_clog_flush_num

int8

+

int8

从启动到当前时间clog刷盘页面数。

+

从启动到当前时间clog刷盘页面数。

ckpt_csnlog_flush_num

+

ckpt_csnlog_flush_num

int8

+

int8

从启动到当前时间csnlog刷盘页面数。

+

从启动到当前时间csnlog刷盘页面数。

ckpt_multixact_flush_num

+

ckpt_multixact_flush_num

int8

+

int8

从启动到当前时间multixact刷盘页面数。

+

从启动到当前时间multixact刷盘页面数。

ckpt_predicate_flush_num

+

ckpt_predicate_flush_num

int8

+

int8

从启动到当前时间predicate刷盘页面数。

+

从启动到当前时间predicate刷盘页面数。

ckpt_twophase_flush_num

+

ckpt_twophase_flush_num

int8

+

int8

从启动到当前时间twophase刷盘页面数。

+

从启动到当前时间twophase刷盘页面数。

参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -2602,71 +2664,71 @@ 返回值类型：record - **表 9** remote\_pagewriter\_stat参数说明 + **表 10** remote\_pagewriter\_stat参数说明 - -

参数

类型

+

类型

描述

+

描述

node_name

+

node_name

text

+

text

实例名称。

+

实例名称。

curr_dwn

+

curr_dwn

int8

+

int8

当前双写文件的序列号。

+

当前双写文件的序列号。

curr_start_page

+

curr_start_page

int8

+

int8

当前双写文件恢复起始页面。

+

当前双写文件恢复起始页面。

file_trunc_num

+

file_trunc_num

int8

+

int8

当前双写文件复用的次数。

+

当前双写文件复用的次数。

file_reset_num

+

file_reset_num

int8

+

int8

当前双写文件写满后发生重置的次数。

+

当前双写文件写满后发生重置的次数。

total_writes

+

total_writes

int8

+

int8

当前双写文件总的I/O次数。

+

当前双写文件总的I/O次数。

low_threshold_writes

+

low_threshold_writes

int8

+

int8

低效率写双写文件的I/O次数（一次I/O刷页数量少于16页面）。

+

低效率写双写文件的I/O次数（一次I/O刷页数量少于16页面）。

high_threshold_writes

+

high_threshold_writes

int8

+

int8

高效率写双写文件的I/O次数（一次I/O刷页数量多于一批，421个页面）。

+

高效率写双写文件的I/O次数（一次I/O刷页数量多于一批，421个页面）。

total_pages

+

total_pages

int8

+

int8

当前刷页到双写文件区的总的页面个数。

+

当前刷页到双写文件区的总的页面个数。

low_threshold_pages

+

low_threshold_pages

int8

+

int8

低效率刷页的页面个数。

+

低效率刷页的页面个数。

high_threshold_pages

+

high_threshold_pages

int8

+

int8

高效率刷页的页面个数。

+

高效率刷页的页面个数。

参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -2678,78 +2740,78 @@ 返回值类型：record - **表 10** remote\_recovery\_status参数说明 + **表 11** remote\_recovery\_status参数说明 - -

参数

类型

+

类型

描述

+

描述

node_name

+

node_name

text

+

text

实例名称。

+

实例名称。

pgwr_actual_flush_total_num

+

pgwr_actual_flush_total_num

int8

+

int8

从启动到当前时间总计刷脏页数量。

+

从启动到当前时间总计刷脏页数量。

pgwr_last_flush_num

+

pgwr_last_flush_num

int4

+

int4

上一批刷脏页数量。

+

上一批刷脏页数量。

remain_dirty_page_num

+

remain_dirty_page_num

int8

+

int8

当前预计还剩余多少脏页。

+

当前预计还剩余多少脏页。

queue_head_page_rec_lsn

+

queue_head_page_rec_lsn

text

+

text

当前实例的脏页队列第一个脏页的recovery_lsn。

+

当前实例的脏页队列第一个脏页的recovery_lsn。

queue_rec_lsn

+

queue_rec_lsn

text

+

text

当前实例的脏页队列的recovery_lsn。

+

当前实例的脏页队列的recovery_lsn。

current_xlog_insert_lsn

+

current_xlog_insert_lsn

text

+

text

当前实例XLog写入的位置。

+

当前实例XLog写入的位置。

ckpt_redo_point

+

ckpt_redo_point

text

+

text

当前实例的检查点。

+

当前实例的检查点。

参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -2761,176 +2823,176 @@ 返回值类型：record - **表 11** remote\_redo\_stat参数说明 + **表 12** remote\_redo\_stat参数说明 - -

参数

类型

+

类型

描述

+

描述

node_name

+

node_name

text

+

text

节点的名称，包含主机和备机。

+

节点的名称，包含主机和备机。

standby_node_name

+

standby_node_name

text

+

text

备机名称。

+

备机名称。

source_ip

+

source_ip

text

+

text

主机的IP地址。

+

主机的IP地址。

source_port

+

source_port

int4

+

int4

主机的端口号。

+

主机的端口号。

dest_ip

+

dest_ip

text

+

text

备机的IP地址。

+

备机的IP地址。

dest_port

+

dest_port

int4

+

int4

备机的端口号。

+

备机的端口号。

current_rto

+

current_rto

int8

+

int8

备机当前的日志流控时间，单位秒。

+

备机当前的日志流控时间，单位秒。

target_rto

+

target_rto

int8

+

int8

备机通过GUC参数设置的预期流控时间，单位秒。

+

备机通过GUC参数设置的预期流控时间，单位秒。

current_sleep_time

+

current_sleep_time

int8

+

int8

为了达到这个预期主机所需要的睡眠时间，单位微秒

+

为了达到这个预期主机所需要的睡眠时间，单位微秒
-

参数

+ + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git "a/content/zh/docs/Developerguide/\351\224\231\350\257\257\346\215\225\350\216\267\350\257\255\345\217\245.md" "b/content/zh/docs/Developerguide/\351\224\231\350\257\257\346\215\225\350\216\267\350\257\255\345\217\245.md" index cb070d9d4a552a942e672618d20cbe38a42b54e4..1c45662b7384ea1f5b928cceee2e0b16c61b3ef5 100644 --- "a/content/zh/docs/Developerguide/\351\224\231\350\257\257\346\215\225\350\216\267\350\257\255\345\217\245.md" +++ "b/content/zh/docs/Developerguide/\351\224\231\350\257\257\346\215\225\350\216\267\350\257\255\345\217\245.md" @@ -107,6 +107,6 @@ SELECT merge_db(1, 'dennis'); --删除FUNCTION和TABLE DROP FUNCTION merge_db; -DROP TABLE db ; +DROP TABLE db; ``` diff --git "a/content/zh/docs/Releasenotes/\347\211\271\346\200\247\344\273\213\347\273\215.md" "b/content/zh/docs/Releasenotes/\347\211\271\346\200\247\344\273\213\347\273\215.md" index b850a404e16de443c65a6ff8b54e86af2ce7390f..bf6a1891d1ffad456e3d4b3c6e4eab7e4048fb38 100644 --- "a/content/zh/docs/Releasenotes/\347\211\271\346\200\247\344\273\213\347\273\215.md" +++ "b/content/zh/docs/Releasenotes/\347\211\271\346\200\247\344\273\213\347\273\215.md" @@ -57,7 +57,7 @@ openGauss 1.0.1定位为Update版本，与原来1.0.0版本特性功能保持兼 外键表示了两个关系之间的相关联系。以另一个关系的外键作主关键字的表被称为主表，具有此外键的表被称为主表的从表，外键建立了主表和从表之间的参照完整性约束。 -- UPSERT（insert on conflict do）。 +- UPSERT（insert on conflict do） 当插入遇到约束错误时，直接返回或者改为执行UPDATE。 diff --git a/content/zh/docs/Toolreference/gs_checkos.md b/content/zh/docs/Toolreference/gs_checkos.md index ae4ce3e997747a83500772d6cddee319c8bb2a15..0732db3a8568734c20054e7a786c4c33b6cc53d6 100644 --- a/content/zh/docs/Toolreference/gs_checkos.md +++ b/content/zh/docs/Toolreference/gs_checkos.md @@ -37,11 +37,11 @@ gs\_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 列表编号。格式：-i A、-i B1、-i A1 -i A2或-i A1,A2。 - 取值范围：A1...A14、B1...B7 + 取值范围：A1...A14、B1...B8 >![](public_sys-resources/icon-note.gif) **说明：** >A1...A14 表示只检查操作系统参数，并不设置。 - >B1...B7 表示将参数系统参数设置为期望值。 + >B1...B8 表示将参数系统参数设置为期望值。 >A和B不能同时输入。 详细的检查项请参见[表1](#zh-cn_topic_0237152331_zh-cn_topic_0059778883_t5348bfc47f50450687012eacb1a1ba4e)。 @@ -256,9 +256,17 @@ gs\_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 + + + +

参数

类型

+

类型

描述

+

描述

node_name

+

node_name

text

+

text

实例名称。

+

实例名称。

redo_start_ptr

+

redo_start_ptr

int8

+

int8

当前实例日志回放的起始点。

+

当前实例日志回放的起始点。

redo_start_time

+

redo_start_time

int8

+

int8

当前实例日志回放的起始UTC时间。

+

当前实例日志回放的起始UTC时间。

redo_done_time

+

redo_done_time

int8

+

int8

当前实例日志回放的结束UTC时间。

+

当前实例日志回放的结束UTC时间。

curr_time

+

curr_time

int8

+

int8

当前实例的当前UTC时间。

+

当前实例的当前UTC时间。

min_recovery_point

+

min_recovery_point

int8

+

int8

当前实例日志的最小一致性点位置。

+

当前实例日志的最小一致性点位置。

read_ptr

+

read_ptr

int8

+

int8

当前实例日志的读取位置。

+

当前实例日志的读取位置。

last_replayed_read_ptr

+

last_replayed_read_ptr

int8

+

int8

当前实例的日志回放位置。

+

当前实例的日志回放位置。

recovery_done_ptr

+

recovery_done_ptr

int8

+

int8

当前实例启动完成时的回放位置。

+

当前实例启动完成时的回放位置。

read_xlog_io_counter

+

read_xlog_io_counter

int8

+

int8

当前实例读取回放日志的io次数计数。

+

当前实例读取回放日志的io次数计数。

read_xlog_io_total_dur

+

read_xlog_io_total_dur

int8

+

int8

当前实例读取回放日志的io总时延。

+

当前实例读取回放日志的io总时延。

read_data_io_counter

+

read_data_io_counter

int8

+

int8

当前实例回放过程中读取数据页面的io次数计数。

+

当前实例回放过程中读取数据页面的io次数计数。

read_data_io_total_dur

+

read_data_io_total_dur

int8

+

int8

当前实例回放过程中读取数据页面的io总时延。

+

当前实例回放过程中读取数据页面的io总时延。

write_data_io_counter

+

write_data_io_counter

int8

+

int8

当前实例回放过程中写数据页面的io次数计数。

+

当前实例回放过程中写数据页面的io次数计数。

write_data_io_total_dur

+

write_data_io_total_dur

int8

+

int8

当前实例回放过程中写数据页面的io总时延。

+

当前实例回放过程中写数据页面的io总时延。

process_pending_counter

+

process_pending_counter

int8

+

int8

当前实例回放过程中日志分发线程的同步次数计数。

+

当前实例回放过程中日志分发线程的同步次数计数。

process_pending_total_dur

+

process_pending_total_dur

int8

+

int8

当前实例回放过程中日志分发线程的同步总时延。

+

当前实例回放过程中日志分发线程的同步总时延。

apply_counter

+

apply_counter

int8

+

int8

当前实例回放过程中回放线程的同步次数计数。

+

当前实例回放过程中回放线程的同步次数计数。

apply_total_dur

+

apply_total_dur

int8

+

int8

当前实例回放过程中回放线程的同步总时延。

+

当前实例回放过程中回放线程的同步总时延。

speed

+

speed

int8

+

int8

当前实例日志回放速率。

+

当前实例日志回放速率。

local_max_ptr

+

local_max_ptr

int8

+

int8

当前实例启动成功后本地收到的回放日志的最大值。

+

当前实例启动成功后本地收到的回放日志的最大值。

primary_flush_ptr

+

primary_flush_ptr

int8

+

int8

主机落盘日志的位置。

+

主机落盘日志的位置。

worker_info

+

worker_info

text

+

text

当前实例回放线程信息，若没有开并行回放则该值为空。

+

当前实例回放线程信息，若没有开并行回放则该值为空。

欧拉系统属性检查：检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service，/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no，当不为no时，对其进行修改设置。

B8

+

设置sshd服务应用pam模块（Set Session Process）

+

远程设备继承系统默认资源：修改/etc/pam.d/sshd服务文件，添加配置项session required pam_limits.so，来控制用户使用的资源。

+
+ >![](public_sys-resources/icon-note.gif) **说明：** >- A6选项检查标准来自配置文件check\_list.conf下\[/etc/sysctl.conf\]、\[SUGGEST:/etc/sysctl.conf\]域： > 若\[/etc/sysctl.conf\]下参数值与系统实际参数值不同，A6检查提示Abnormal，可以使用B1参数进行设置。 diff --git a/content/zh/docs/Toolreference/gs_ctl.md b/content/zh/docs/Toolreference/gs_ctl.md index db0f7387265faaf3433f8c7c84a00bf060288c8c..f2e8f5af4f5abe6e5d0b32eb677354c1cc3000ab 100644 --- a/content/zh/docs/Toolreference/gs_ctl.md +++ b/content/zh/docs/Toolreference/gs_ctl.md @@ -134,12 +134,10 @@ gs\_ctl参数可分为如下几类：

-t, --timeout=SECS

这个参数同时控制如下两个功能：

-
  • 等待数据库启动或者关闭完成的最大秒数。
+

等待数据库启动、关闭或者主备切换完成的最大秒数。

取值范围：整型（秒）。

-

默认值：

-
  • 等待数据库启动或者停止完成：60秒。
+

默认值：等待数据库启动、关闭或者主备切换完成：60秒。

-V , --version

diff --git a/content/zh/docs/Toolreference/gs_postuninstall.md b/content/zh/docs/Toolreference/gs_postuninstall.md index dcb7c58f3db231de18fd5b9b7ee6c3b0f0c1686b..5bd5af353f39d9dd61da6c53679dc2b2ffb9c9eb 100644 --- a/content/zh/docs/Toolreference/gs_postuninstall.md +++ b/content/zh/docs/Toolreference/gs_postuninstall.md @@ -61,15 +61,14 @@ openGauss提供了gs\_postuninstall工具来帮助清理准备openGauss环境阶 删除操作系统用户所在的用户组（选择此选项必须指定--delete-user参数）。 -- -l +- -l - 指定日志文件名及路径。在内部会自动给日志名添加一个时间戳。 + 指定日志文件名及路径。在内部会自动给日志名添加一个时间戳。 - - 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为“$GAUSSLOG/om/gs\_postuninstall-YYYY-MMDD\_hhmmss.log”。 - - 当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为“gaussdbLogPath/用户名/om/gs\_postuninstall-YYYY-MMDD\_hhmmss.log”。 + 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 - >![](public_sys-resources/icon-note.gif) **说明：** - >由于在执行gs\_postuninstall后，系统会自动删除openGauss相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非openGaussopenGauss相关路径。 + >![](public_sys-resources/icon-note.gif) **说明：** + >由于在执行gs\_postuninstall后，系统会自动删除openGauss相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非openGaussopenGauss相关路径。 - -?, --help diff --git a/content/zh/docs/installation/completing-the-installation.md b/content/zh/docs/installation/completing-the-installation.md deleted file mode 100644 index 98ece32f0065e6009206ce14322e8b24a263996e..0000000000000000000000000000000000000000 --- a/content/zh/docs/installation/completing-the-installation.md +++ /dev/null @@ -1 +0,0 @@ -这篇文档描述如何完成安装openGauss。 diff --git a/content/zh/docs/installation/configurations-during-installation.md b/content/zh/docs/installation/configurations-during-installation.md deleted file mode 100644 index 661f3261d73cfc058fd3ae85149209f442fa0ae1..0000000000000000000000000000000000000000 --- a/content/zh/docs/installation/configurations-during-installation.md +++ /dev/null @@ -1 +0,0 @@ -这篇文档描述在安装openGauss过程中如何配置。 diff --git a/content/zh/docs/installation/starting-installation.md b/content/zh/docs/installation/starting-installation.md deleted file mode 100644 index 95b515658620c331bd8033d2b97de440e014a3d8..0000000000000000000000000000000000000000 --- a/content/zh/docs/installation/starting-installation.md +++ /dev/null @@ -1 +0,0 @@ -这篇文档描述如何开始安装openGauss。 diff --git "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" index d1ecdd394681521426fb0fc47359927e0954e8b3..1b9b0934e616164096140cc638c5999c6975d30f 100644 --- "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -243,9 +243,9 @@ openGauss的软件依赖要求如[表 软件依赖要求](#table1212531681911) systemctl status firewalld -若防火墙未关闭，请执行步骤4； +若防火墙状态显示为active \(running\)，则表示防火墙未关闭，请执行步骤4； -若防火墙已关闭，则无需再关闭防火墙。 +若防火墙状态显示为inactive \(dead\)，则无需再关闭防火墙。 4.关闭防火墙并禁止开机重启。 @@ -277,13 +277,16 @@ cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime 使用date -s命令将各主机的时间设置为统一时间，举例如下。 ``` -date -s Mon May 11 16:42:11 CST 2020 +date -s "Sat Sep 27 16:00:07 CST 2020" ``` >![](public_sys-resources/icon-note.gif) **说明：** >可以通过date命令查询主机时区。 -### 关闭swap交换内存 +### （可选）关闭swap交换内存 + +>![](C:/Users/gongsiyi/Desktop/test/05-openGauss 安装指南/public_sys-resources/icon-note.gif) **说明：** +>关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 diff --git "a/content/zh/docs/installation/\345\210\233\345\273\272XML\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/content/zh/docs/installation/\345\210\233\345\273\272XML\351\205\215\347\275\256\346\226\207\344\273\266.md" index 0acda67b15d75f5f70fc482e078a7272840234d5..25a0689e2009edef60c17b489397f2211b03970f 100644 --- "a/content/zh/docs/installation/\345\210\233\345\273\272XML\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/content/zh/docs/installation/\345\210\233\345\273\272XML\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -203,6 +203,8 @@ + + @@ -212,34 +214,40 @@ **表 1** 参数说明 -

实例类型

+ - - - - - - - - - - - + + + diff --git "a/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" index bc0d0351d47a251d9deeeb88682de48f8a96cbf3..efbd68047baab9ba5cabcd4f72344a6675c541a5 100644 --- "a/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -89,7 +89,7 @@ export LD_LIBRARY_PATH={packagePath}/script/gspylib/clib:$LD_LIBRARY_PATH 9.使用gs\_preinstall准备好安装环境。若为共用环境需加入\-\-sep-env-file=ENVFILE参数分离环境变量，避免与其他用户相互影响，ENVFILE为用户自行指定的环境变量分离文件的路径。 -- 采用交互模式执行前置，并在执行过程中自动创建root用户互信和openGauss用户互信： +- 采用交互模式执行前置，并在执行过程中自动创建操作系统root用户互信和omm用户互信： ``` ./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml ``` @@ -122,7 +122,7 @@ omm为数据库管理员（也是运行openGauss的操作系统用户），dbgrp ![](public_sys-resources/icon-note.gif) **说明：** - 此模式要求用户确保在执行前，已经建立了各节点root用户互信和openGauss用户互信。 - + - root用户互信可能会存在安全隐患，因此建议用户在执行完安装后，立即删除各主机上root用户的互信。 diff --git "a/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\346\225\260\346\215\256\345\272\223.md" "b/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\346\225\260\346\215\256\345\272\223.md" index f47b2ecbcedfae5bba4eb6175266a4ffd46b60b1..fe6495f5becc8f5f3f0af460db604d9928e8f11d 100644 --- "a/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\346\225\260\346\215\256\345\272\223.md" +++ "b/content/zh/docs/installation/\345\210\235\345\247\213\345\214\226\346\225\260\346\215\256\345\272\223.md" @@ -1,6 +1,9 @@ # 初始化数据库 -使用SQL创建新的数据库 +使用SQL创建新的数据库。 + +>![](C:/Users/gongsiyi/Desktop/test/05-openGauss 安装指南/public_sys-resources/icon-note.gif) **说明：** +>为确保安全，首次登录后请修改omm初始密码。 使用SQL语句创建数据库时，指定数据库的字符集为GBK。 diff --git "a/content/zh/docs/installation/\345\256\211\350\243\205\351\252\214\350\257\201.md" "b/content/zh/docs/installation/\345\256\211\350\243\205\351\252\214\350\257\201.md" index ea89c8515497a6c4d37b2312ac3ef6c54835f49f..d9f8a1def7f88898099b09ec4ff7c914abf15a3b 100644 --- "a/content/zh/docs/installation/\345\256\211\350\243\205\351\252\214\350\257\201.md" +++ "b/content/zh/docs/installation/\345\256\211\350\243\205\351\252\214\350\257\201.md" @@ -9,7 +9,7 @@ openGauss数据库已安装。 ## 操作步骤 1. 以omm用户身份登录服务器。 -2. 执行如下命令检查数据库状态是否正常，“cluster\_state ”显示“Normal”表示数据库可正常使用 +2. 执行如下命令检查数据库状态是否正常，“cluster\_state ”显示“Normal”表示数据库可正常使用。 ``` gs_om -t status diff --git "a/content/zh/docs/installation/\345\256\271\345\231\250\345\256\211\350\243\205.md" "b/content/zh/docs/installation/\345\256\271\345\231\250\345\256\211\350\243\205.md" index 6a8021917d21772abde9e2d5eebebfe9682caf2e..4284ba28c68421f886522c33c803a1530b7660f9 100644 --- "a/content/zh/docs/installation/\345\256\271\345\231\250\345\256\211\350\243\205.md" +++ "b/content/zh/docs/installation/\345\256\271\345\231\250\345\256\211\350\243\205.md" @@ -1,61 +1,64 @@ -# 容器安装 +# 容器安装 本章节主要介绍通过Docker安装openGauss，方便DevOps用户的安装、配置和环境设置。 -## 支持的架构和操作系统版本 +## 支持的架构和操作系统版本 - x86-64 CentOS 7.6 - ARM64 openEuler 20.03 LTS -## 配置准备 +## 配置准备 -- 使用 buildDockerImage.sh脚本构建docker镜像，buildDockerImage.sh是一个方便使用的shell脚本，提供MD5的检查。 - -- 容器安装代码下载地址 [https://gitee.com/opengauss/openGauss-server/blob/master/docker/dockerfiles.zip](https://gitee.com/opengauss/openGauss-server/blob/master/docker/dockerfiles.zip) +使用 buildDockerImage.sh脚本构建docker镜像，buildDockerImage.sh是一个方便使用的shell脚本，提供MD5的检查。 -## 创建openGauss docker镜像 +## 创建openGauss docker镜像 ![](public_sys-resources/icon-note.gif) **说明：** -- 安装前需要提供openGauss二进制安装包，放到 dockerfiles/文件夹，不需要解压。二进制包可以从 [https://opengauss.org/zh/download.html](https://opengauss.org/zh/download.html)下载，确保有正确的yum源，如果你手动解压安装包会导致运行失败。 - -- openGauss源码包下载路径：https://gitee.com/opengauss/openGauss-server/repository/archive/master.zip - -- 当容器为centos环境时，需要预先从网络下载gosu-amd64文件并放到dockerfiles/ 文件夹下面，该文件下载地址：[https://github.com/tianon/gosu/releases/download/1.12/gosu-amd64](https://github.com/tianon/gosu/releases/download/1.12/gosu-amd64)。 - -- 当容器为openeuler环境时，需要预先从网络下载gosu-arm64文件并放到dockerfiles/ 文件夹下面，该文件下载地址：[https://github.com/tianon/gosu/releases/download/1.12/gosu-arm64](https://github.com/tianon/gosu/releases/download/1.12/gosu-arm64)。 - -- 安装前需要从华为开源镜像站获取openEuler\_aarch64.repo文件，并放到openGauss-server-master/docker/SingleInstance/dockerfiles/1.0.1文件夹下面。openEuler\_aarch64.repo获取方法： - ``` - wget -O openEuler_aarch64.repo https://mirrors.huaweicloud.com/repository/conf/openeuler_aarch64.repo - ``` +- 安装前需要提供openGauss二进制安装包，解压后将以bz2结尾的包\(openGauss-X.X.X-CentOS-64bit.tar.bz2\)，放到 dockerfiles/文件夹。二进制包可以从 [https://opengauss.org/zh/download.html](https://opengauss.org/zh/download.html)下载，确保有正确的yum源。 + +- 运行buildDockerImage.sh脚本时，如果不指定-i参数，此时默认提供MD5检查，需要您手动将校验结果写入md5\_file\_amd64文件。 + ``` + ## 修改md5校验文件内容 + cd /soft/openGauss-server/docker/dockerfiles/1.0.1 + md5sum openGauss-1.0.1-CentOS-64bit.tar.bz2 + ## 将校验信息写入校验文件md5_file_amd64中 + echo "58b9a029719f2d9d32b7d619c850735c openGauss-1.0.1-CentOS64bit.tar.bz2" > md5_file_amd64 + ``` + +- 安装前需要从华为开源镜像站获取openEuler\_aarch64.repo文件，并放到openGauss-server-master/docker/dockerfiles/1.0.1文件夹下面。openEuler\_aarch64.repo获取方法： + ``` + wget -O openEuler_aarch64.repo https://mirrors.huaweicloud.com/repository/conf/openeuler_aarch64.repo + ``` 在dockerfiles文件夹运行buildDockerImage.sh脚本。 ``` -[root@localhost dockerfiles]$ ./buildDockerImage.sh -h -Usage: buildDockerImage.sh -v [version] [-i] [Docker build option] -Builds a Docker Image for openGauss. +[root@ecs-complie dockerfiles]# ./buildDockerImage.sh +Usage: buildDockerImage.sh -v [version] [-i] [Docker build option] +Builds a Docker Image for openGauss Parameters: --v: version to build -Choose one of: 1.0.1 SingleInstance --i: ignores the MD5 checksums + -v: version to build + Choose one of: 1.0.0 1.0.1 + -i: ignores the MD5 checksums + +LICENSE UPL 1.0 ``` -## 环境变量 +## 环境变量 为了更灵活的使用openGuass镜像，可以设置额外的参数。未来我们会扩充更多的可控制参数，当前版本支持以下变量的设定。 **GS\_PASSWORD** -使用openGauss镜像的时候，必须设置该参数。该参数值不能为空或者不定义。该参数设置了openGauss数据库的超级用户omm以及测试用户gaussdb的密码。openGauss安装时默认会创建omm超级用户，该用户名暂时无法修改。测试用户gaussdb是在docker-entry point.sh中自定义创建的用户。 +使用openGauss镜像的时候，必须设置该参数。该参数值不能为空或者不定义。该参数设置了openGauss数据库的超级用户omm以及测试用户gaussdb的密码。openGauss安装时默认会创建omm超级用户，该用户名暂时无法修改。测试用户gaussdb是在entrypoint.sh中自定义创建的用户。 openGauss镜像配置了本地信任机制，因此在容器内连接数据库无需密码，但是如果要从容器外部（其它主机或者其它容器）连接则必须要输入密码。 **openGauss的密码有复杂度要求** -密码长度8个字符以上，必须同时包含英文字母、数字、以及特殊符号。 +密码长度8个字符以上，必须同时包含大写字母、小写字母、数字、以及特殊符号（特殊符号仅包含"\#?!@$%^&\*-"，并且"!$&"需要用转义符"\\"进行转义）。 **GS\_NODENAME** @@ -69,22 +72,22 @@ openGauss镜像配置了本地信任机制，因此在容器内连接数据库 指定数据库端口，默认为5432。 -## 开启实例 +## 开启实例 ``` -$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=secretpassword@123 opengauss:1.0.1 +$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 opengauss:1.0.1 ``` -## 从操作系统层面连接数据库 +## 从操作系统层面连接数据库 ``` -$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=secretpassword@123 -p8888:5432 opengauss:1.0.1 -$ gsql -d postgres -U gaussdb -W'secretpassword@123' -h your-host-ip -p8888 +$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -p8888:5432 opengauss:1.0.1 +$ gsql -d postgres -U gaussdb -W'Enmo@123' -h your-host-ip -p8888 ``` -## 数据持久化 +## 数据持久化 ``` -$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=secretpassword@123 -v /opengauss:/var/lib/opengauss opengauss:1.0.1 +$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss opengauss:1.0.1 ``` diff --git "a/content/zh/docs/installation/\346\211\247\350\241\214\345\256\211\350\243\205.md" "b/content/zh/docs/installation/\346\211\247\350\241\214\345\256\211\350\243\205.md" index 6575f42e4351211b1d1b17f5acdaa76a97362fc9..b78997826f39935b3df113704efd8831b1baf1b8 100644 --- "a/content/zh/docs/installation/\346\211\247\350\241\214\345\256\211\350\243\205.md" +++ "b/content/zh/docs/installation/\346\211\247\350\241\214\345\256\211\350\243\205.md" @@ -35,8 +35,8 @@ 设置的密码要符合复杂度要求： - - 最少包含8个字符； - - 不能和用户名、当前密码（ALTER）、或当前密码反序相同； + - 最少包含8个字符。 + - 不能和用户名、当前密码（ALTER）、或当前密码反序相同。 - 至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为\~!@\#$%^&\*\(\)-\_=+\\|\[\{\}\];:,<.\>/?）四类字符中的三类字符。 安装过程中会生成ssl证书，证书存放路径为\{gaussdbAppPath\}/share/sslcert/om，其中\{gaussdbAppPath\}为集群openGauss配置文件中指定的程序安装目录。 diff --git "a/content/zh/docs/installation/\350\216\267\345\217\226\345\256\211\350\243\205\345\214\205.md" "b/content/zh/docs/installation/\350\216\267\345\217\226\345\256\211\350\243\205\345\214\205.md" index 17bbb21db1ab5430354594322fd93d7689dff9d3..4deb86fd868882be3c26b502fdb0ddbe9ec76074 100644 --- "a/content/zh/docs/installation/\350\216\267\345\217\226\345\256\211\350\243\205\345\214\205.md" +++ "b/content/zh/docs/installation/\350\216\267\345\217\226\345\256\211\350\243\205\345\214\205.md" @@ -4,58 +4,61 @@ openGauss开源社区上提供了安装包的获取方式。 ## 操作步骤 -1. 从openGauss开源社区下载对应平台的安装包。 +1. 从openGauss开源社区下载对应平台的安装包。 - a.通过[https://opengauss.org/zh/download.html](https://opengauss.org/zh/download.html)登录openGauss开源社区下载对应平台安装包。 + a.通过[https://opengauss.org/zh/download.html](https://opengauss.org/zh/download.html)登录openGauss开源社区下载对应平台安装包。 - **图1** 开源网站openGauss Server页面 + **图1** 开源网站openGauss Server页面 - ![](figures/捕获.png) + ![](figures/捕获.png) - **图2** 开源网站openGauss Connectors页面 + **图2** 开源网站openGauss Connectors页面 - ![](figures/20201017-153355(eSpace).png) + ![](figures/20201017-153355(eSpace).png) - **表 1** openGauss Connectors安装包说明 + **表 1** openGauss Connectors安装包说明 - -

实例类型

参数

+

参数

说明

+

说明

DBnode

+

DBnode

dataNum

+

dataNum

当前主机上需要部署的数据库节点个数。

+

当前主机上需要部署的数据库节点个数。

dataPortBase

+

dataPortBase

数据库节点的基础端口号，默认值40000。

+

数据库节点的基础端口号，默认值40000。

dataNode1

+

dataListenIp1

用于指定当前主机上的数据库节点的数据存储目录。此目录为数据库的数据存储目录。应规划到数据盘上。

+

监听的IP地址。未设置时，使用对应主机上的backIp1生成。

+

第一个IP是主节点所在主机IP，第二个IP是备节点所在主机IP。

dataNode1_syncNum

+

dataNode1

可选参数，用于指定当前集群中同步模式的节点数目。取值范围为0~数据库备机节点数。

+

用于指定当前主机上的数据库节点的数据存储目录。此目录为数据库的数据存储目录。应规划到数据盘上。

+

dataNode1_syncNum

+

可选参数，用于指定当前集群中同步模式的节点数目。取值范围为0~数据库备机节点数。
- - - - - - - - - - - - - -

安装包名称

-

说明

-

JDBC

-

用于Linux的JDBC驱动安装包。

-

ODBC

-

用于Linux的ODBC驱动安装包。

-

libpq

-

用于Linux的libpq库。

-
+ - b.选择所需安装包单击“下载”。 + + + + + + + + + + + + + + +

安装包名称

+

说明

+

JDBC

+

用于Linux的JDBC驱动安装包。

+

ODBC

+

用于Linux的ODBC驱动安装包。

+

libpq

+

用于Linux的libpq库。

+
-2. 检查安装包。 - 解压安装包，检查安装目录及文件是否齐全。在安装包所在目录执行以下命令： + b.选择所需安装包单击“下载”。　　 + +2. 检查安装包。 + + 解压安装包，检查安装目录及文件是否齐全。在安装包所在目录执行以下命令： + ``` tar -zxvf openGauss-1.0.1-openEuler-64bit.tar.gz ls -1b ``` - + 执行ls命令，显示类似如下信息： - + ``` total 50M drwxr-xr-x 14 root root 4.0K Jul 6 11:03 lib diff --git a/content/zh/menu/index.md b/content/zh/menu/index.md index ed6fee32a35df863a52de9d16420958341341831..e5f7a012a08fca0b29acac58fcae5df9a697a262 100644 --- a/content/zh/menu/index.md +++ b/content/zh/menu/index.md @@ -71,7 +71,6 @@ headless: true - [基于开销的清理延迟]({{< relref "./docs/Developerguide/基于开销的清理延迟.md" >}}) - [后端写进程]({{< relref "./docs/Developerguide/后端写进程.md" >}}) - [异步IO]({{< relref "./docs/Developerguide/异步IO.md" >}}) - - [并行导入]({{< relref "./docs/Developerguide/并行导入.md" >}}) - [预写式日志]({{< relref "./docs/Developerguide/预写式日志.md" >}}) - [设置]({{< relref "./docs/Developerguide/设置.md" >}}) - [检查点]({{< relref "./docs/Developerguide/检查点.md" >}}) @@ -118,7 +117,7 @@ headless: true - [等待事件]({{< relref "./docs/Developerguide/等待事件.md" >}}) - [Query]({{< relref "./docs/Developerguide/Query-22.md" >}}) - [系统性能快照]({{< relref "./docs/Developerguide/系统性能快照.md" >}}) - - [FAQ]({{< relref "./docs/Quickstart/FAQ.md" >}}) + - [FAQ]({{< relref "./docs/Quickstart/FAQ.md" >}}) - [安装指南]({{< relref "./docs/Installation/Installation.md" >}}) - [安装概述]({{< relref "./docs/Installation/安装概述.md" >}}) - [安装准备]({{< relref "./docs/Installation/安装准备.md" >}}) @@ -1155,7 +1154,6 @@ headless: true - [基于开销的清理延迟]({{< relref "./docs/Developerguide/基于开销的清理延迟.md" >}}) - [后端写进程]({{< relref "./docs/Developerguide/后端写进程.md" >}}) - [异步IO]({{< relref "./docs/Developerguide/异步IO.md" >}}) - - [并行导入]({{< relref "./docs/Developerguide/并行导入.md" >}}) - [预写式日志]({{< relref "./docs/Developerguide/预写式日志.md" >}}) - [设置]({{< relref "./docs/Developerguide/设置.md" >}}) - [检查点]({{< relref "./docs/Developerguide/检查点.md" >}})