Updated PostgreSQL.md (markdown)

-## PostgreSQL学习

-PostgreSQL版本:16.6

-下载地址: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

-## 第 1 节. PG本地和Docker安装步骤

-### 一、本地安装PostgreSQL

-#### 1. 下载安装包

-- 访问 PostgreSQL 官方下载页面：[PostgreSQL 下载](https://www.postgresql.org/download/windows/)

-- 选择适合您系统的安装包（建议选择 `PostgreSQL Server` 和 `pgAdmin 4`）。

-#### 2. 运行安装程序

-- 双击下载的安装程序文件，启动安装向导。

-- 在安装向导中，选择安装组件，包括 `PostgreSQL Server`、`pgAdmin 4` 和 `Command Line Tools` 等。

-#### 3. 配置安装选项

-- **选择安装目录**：默认安装目录为 `C:\Program Files\PostgreSQL\16`，您可以根据需要更改。

-- **设置数据目录**：默认数据目录为 `C:\Program Files\PostgreSQL\16\data`，您可以根据需要更改。

-- **设置超级用户密码**：输入并确认超级用户 `postgres` 的密码。

-- **设置端口号**：默认端口号为 `5432`，您可以根据需要更改。

-- **配置高级选项**：如需要，可以配置其他高级选项，如 `locale` 和 `encoding` 等。

-#### 4. 完成安装

-- 点击 `Install` 按钮开始安装。

-- 安装完成后，您可以选择是否启动 `Stack Builder` 来安装其他工具和驱动程序。

-#### 5. 验证安装

-- 打开 `Dbeaver`，连接到本地服务器，数据库:`postgres` ,默认端口:`5432`, 输入超级用户 `postgres` 的密码，验证连接是否成功。

-- 打开命令行工具，输入 `psql -U postgres -h localhost -p 5432`，验证是否可以成功登录到数据库。

-- PostgreSQL 默认的数据库名字是`postgres`， 默认的模式`schema`是:`public`，pg的模式相当于MySQL的数据库,可以创建不同的模式。

-#### 6. DBCP配置

-########postgresql########

-driverClassName=org.postgresql.Driver

-url=jdbc:postgresql://localhost:5432/postgres?currentSchema=public&encoding=UTF-8&timezone=UTC

-username=postgres

-password=passw0rd

-#### 参考资料

-- [PostgreSQL 官方文档](https://www.postgresql.org/docs/)

-- [PostgreSQL 16 在 Windows 下安装](https://www.cnblogs.com/lwx11111/p/18375300)

-- [Windows 10 上安装 PostgreSQL 16](https://blog.csdn.net/fengbingchun/article/details/141750748)

-- [PostgreSQL 在 Windows 上的安装与配置](https://geek-docs.com/postgresql/postgresql-questions/218_tk_1704601434.html)

-

-### 二、Docker安装PostgreSQL

-以下是在192.168.184.120 机器上，使用 Docker 安装 PostgreSQL 16.6 的流程：

-#### 1. 拉取镜像

-从 Docker Hub 上拉取 PostgreSQL 16.6 的镜像：

-bash复制

-```bash

-docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/postgres:16.6-alpine3.21

-docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/postgres:16.6-alpine3.21 docker.io/postgres:16.6

-#### 2. 创建并运行 PostgreSQL 容器

-使用以下命令创建并运行一个 PostgreSQL 容器，并配置数据持久化：

-```bash

-docker run --name postgres16 -e POSTGRES_PASSWORD=passw0rd -p 5432:5432 -v /opt/postgresql/data:/var/lib/postgresql/data -d docker.io/postgres:16.6

-- `--name postgres16`：指定容器名称为 `postgres16`。

-- `-e POSTGRES_PASSWORD=mysecretpassword`：设置 PostgreSQL 的超级用户密码。

-- `-p 5432:5432`：将容器的 5432 端口映射到主机的 5432 端口。

-- `-v /opt/postgresql/data:/var/lib/postgresql/data`：将主机的目录（`/opt/postgresql/data`）挂载到容器的数据目录（`/var/lib/postgresql/data`），以实现数据持久化。

-#### 3. 进入容器

-如果需要进入容器内部，可以使用以下命令：

-bash复制

-```bash

-docker exec -it postgres16 bash

-#### 5. 连接到数据库

-在容器内部或宿主机上，可以使用 `psql` 命令连接到数据库：

-bash复制

-```bash

-psql -U postgres -h localhost -p 5432

-- `-U postgres`：指定用户名为 `postgres`。

-- `-h localhost`：指定主机名为 `localhost`。

-- `-p 5432`：指定端口号为 `5432`。

-#### 6. DBCP配置

-已经在192.168.184.120安装了PG,测试可以直接使用。PG默认的模式是：public，可以通过设置`currentSchema`切换模式。

-########postgresql########

-driverClassName=org.postgresql.Driver

-url=jdbc:postgresql://192.168.184.120:5432/postgres?currentSchema=public&encoding=UTF-8&timezone=UTC

-username=postgres

-password=passw0rd

-### 参考资料

-- [Docker 安装 PostgreSQL 16.6](https://developer.baidu.com/article/detail.html?id=2812489)

-- [Docker+PostgreSQL数据库](https://blog.csdn.net/shankezh/article/details/143241252)

-- [Docker 容器化部署 PostgreSQL](https://www.jianshu.com/p/c2f6759f3e75)

-## PostgreSQL 基础教程

-https://www.rockdata.net/zh-cn/tutorial/toc/

-本 **PostgreSQL 教程**可帮助您快速了解 PostgreSQL。您将通过许多实际示例快速掌握 PostgreSQL，并将这些知识应用于使用 PostgreSQL 开发应用程序。

-

-

-## PostgreSQL 基础教程

-## PostgreSQL 高级教程

-这个 PostgreSQL 高级教程涵盖了高级概念，包括存储过程、索引、视图、触发器和数据库管理。

-### [PostgreSQL 函数](https://www.rockdata.net/zh-cn/tutorial/postgres-functions/)

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-- [使用 Golang 连接到 PostgreSQL](https://www.rockdata.net/zh-cn/tutorial/golang-setup/) – 向您介绍如何使用 Go 编程语言与 PostgreSQL 数据库进行交互。

-

-

-

-

-

-## 语法差异

-

-如果列别名包含一个或多个空格，则需要用双引号将其引起来，如下所示：

-

-

-

-## 包含空格的列别名

-

-如果列别名包含一个或多个空格，则需要用双引号将其引起来，如下所示：

-

-```sql

-column_name AS "column alias"

-```

-

-例如：

-

-```sql

-SELECT

- first_name || ' ' || last_name "full name"

-FROM

- customer;

-```

-

-

-

-

-

-## PostgreSQL SELECT DISTINCT 子句简介

-

-在这种情况下，`column1`和`column2`列中的值的组合将用于计算重复项。

-

-PostgreSQL 还提供了`DISTINCT ON (expression)`来保留每组重复项的第一行的功能，使用以下语法：

-

-```sql

-SELECT

- DISTINCT ON (column1) column_alias,

- column2

-FROM

- table_name

-ORDER BY

- column1,

- column2;

-```

-

-从`SELECT`语句返回的行的顺序是未指定的，因此每组重复项的第一行也是未指定的。

-

-最好始终使用带有`DISTINCT ON(expression)`的 [ORDER BY](https://www.rockdata.net/zh-cn/tutorial/dml-order-by/) 子句，以使结果集可预测。

-

-请注意，`DISTINCT ON`表达式必须与`ORDER BY`子句中最左边的表达式匹配。

-

-

-

-

-

-## PostgreSQL ORDER BY 子句和 NULL

-

-在数据库世界中，`NULL`是一个标记，指示丢失的数据或数据在记录时未知。

-

-对包含`NULL`的行进行排序时，可以使用`ORDER BY`子句的`NULLS FIRST`或`NULLS LAST`选项，指定`NULL`与其他非空值的顺序：

-

-```sql

-ORDER BY sort_expresssion [ASC | DESC] [NULLS FIRST | NULLS LAST]

-```

-

-在此示例中，`ORDER BY`子句按升序对`sort_demo`表的`num`列中的值进行排序。它将`NULL`置于其他值之后。

-

-因此，如果您使用`ASC`选项，`ORDER BY`子句默认使用`NULLS LAST`选项。因此，以下查询返回相同的结果：

-

-```sql

-SELECT num

-FROM sort_demo

-ORDER BY num NULLS LAST;

-```

-

-要放置`NULL`在其他非空值之前，可以使用`NULLS FIRST`选项：

-

-```sql

-SELECT num

-FROM sort_demo

-ORDER BY num NULLS FIRST;

-```

-

-

-

-

-

-## PostgreSQL 的分页和过滤技术

-

-[PostgreSQL](https://geek-docs.com/postgresql/postgresql-top-tutorials/1000100_postgresql_index.html) 提供了多种方法来实现分页和过滤功能。其中，键集分页方法是在处理大型表时的一个非常有效的方法。

-

-https://www.rockdata.net/zh-cn/tutorial/dml-paginate/

-

-

-

-### 键集分页方法

-

-键集分页方法基于结果集中的唯一键（通常是主键）进行分页。它通过保存上一次查询的最后一行的键值，并将其作为下一次查询的起点来实现分页。

-

-以下是一个使用键集分页方法的示例查询：

-

-```sql

-SELECT *

-FROM large_table

-WHERE id > last_key

-ORDER BY id

-LIMIT 10;

-```

-

-

-

-在此示例中，我们使用唯一键 id 进行分页。上一次查询的最后一条数据的 id 值将用于下一次查询的过滤条件。通过以此方式逐步递增分页查询，我们可以避免加载整个结果集，从而提高性能和效率。

-

-### OFFSET 和 LIMIT 分页

-

-除了键集分页方法外，PostgreSQL 还提供了使用 OFFSET 和 LIMIT 子句进行分页的方式。OFFSET 子句用于指定开始返回结果的位置，LIMIT 子句用于指定返回结果的数量。

-

-以下是一个使用 OFFSET 和 LIMIT 分页的示例查询：

-

-```sql

-SELECT *

-FROM large_table

-ORDER BY id

-OFFSET 1000

-LIMIT 10;

-```

-

-## PostgreSQL LIMIT 子句简介

-

-https://www.rockdata.net/zh-cn/tutorial/dml-limit/

-

-PostgreSQL 的`LIMIT`是 [SELECT](https://www.rockdata.net/zh-cn/tutorial/dml-select/) 语句的可选子句，用于限制查询返回的行数。

-

-下面说明了`LIMIT`子句的语法：

-

-```sql

-SELECT select_list

-FROM table_name

-ORDER BY sort_expression

-LIMIT row_count

-```

-

-该语句返回查询生成的`row_count`行。如果`row_count`为零，则查询返回空集。如果`row_count`是`NULL`，查询将返回与没有`LIMIT`子句相同的结果集。

-

-如果您想在返回`row_count`行之前跳过一些行，请在`LIMIT`子句之后放置`OFFSET`子句，如下所示：

-

-```sql

-SELECT select_list

-FROM table_name

-LIMIT row_count OFFSET row_to_skip;

-```

-

-该语句首先跳过`row_to_skip`行，然后返回查询生成的`row_count`行。如果`row_to_skip`为零，则该语句将像没有`OFFSET`子句一样工作。

-

-由于表可能以未指定的顺序存储行，因此当您使用`LIMIT`子句时，应始终使用 [ORDER BY](https://www.rockdata.net/zh-cn/tutorial/dml-order-by/) 子句来控制行顺序。如果不使用`ORDER BY`子句，则可能会得到具有未指定行顺序的结果集。

-

-

-

-## PostgreSQL FETCH 子句简介

-

-为了限制查询返回的行数，您经常使用`LIMIT`子句。`LIMIT`子句被许多关系数据库管理系统广泛使用，例如 MySQL、H2 和 HSQLDB。但是，`LIMIT`子句不是 SQL 标准。

-

-为了符合 SQL 标准，PostgreSQL 支持`FETCH`子句来检索查询返回的行数。

-

-> 请注意，`FETCH`子句是在 SQL:2008 中作为 SQL 标准的一部分引入的。

-

-下面说明了 PostgreSQL 的`FETCH`子句的语法：

-

-```sql

-OFFSET start { ROW | ROWS }

-FETCH { FIRST | NEXT } [ row_count ] { ROW | ROWS } ONLY

-```

-

-## FETCH 对比 LIMIT

-

-`FETCH`子句在功能上等同于`LIMIT`子句。如果您计划使您的应用程序与其他数据库系统兼容，则应该使用`FETCH`子句，因为它遵循 SQL 标准。

-

-

-

-

-

-## PostgreSQL WHERE 子句概述

-

-https://www.rockdata.net/zh-cn/tutorial/dml-where/

-

-PostgreSQL 的`WHERE`子句的语法如下：

-

-```sql

-SELECT select_list

-FROM table_name

-WHERE condition

-ORDER BY sort_expression

-```

-

-`WHERE`子句出现在`SELECT`语句的`FROM`子句之后。`WHERE`子句使用`condition`来过滤从`SELECT`列表子句返回的行。

-

-`condition`的计算结果必须为真、假或未知。它可以是布尔表达式或使用`AND`和`OR`运算符的布尔表达式的组合。

-

-该查询仅返回满足`WHERE`子句中`condition`的行。换句话说，只有导致`condition`计算结果为 true 的行才会包含在结果集中。

-

-PostgreSQL 计算`WHERE`子句的时间点，在`FROM`子句之后，在`SELECT`列表和`ORDER BY`子句之前：

-

-如果在`SELECT`列表子句中使用列别名，则不能在`WHERE`子句中使用它们。

-

-除了`SELECT`语句之外，您还可以使用`UPDATE`和`DELETE`语句中的`WHERE`子句来指定要更新或删除的行。

-

-要构成`WHERE`子句中的条件，请使用比较运算符和逻辑运算符：

-

-| 运算符 | 描述 |

-| :----------------------------------------------------------- | :-------------------------------------- |

-| = | 等于 |

-| > | 大于 |

-| < | 小于 |

-| >= | 大等于 |

-| <= | 小等于 |

-| <> 或 != | 不等于 |

-| AND | 逻辑运算符 AND |

-| OR | 逻辑运算符 OR |

-| [IN](https://www.rockdata.net/zh-cn/tutorial/dml-in/) | 如果值与列表中的任何值匹配，则返回 true |

-| [BETWEEN](https://www.rockdata.net/zh-cn/tutorial/dml-between/) | 如果值介于某个值范围之间，则返回 true |

-| [LIKE](https://www.rockdata.net/zh-cn/tutorial/dml-like/) | 如果值与模式匹配则返回 true |

-| [IS NULL](https://www.rockdata.net/zh-cn/tutorial/dml-is-null/) | 如果值为 NULL，则返回 true |

-| NOT | 对其他运算符的结果求反 |

-

-### 7) 使用带有不等于运算符 (<>) 的 WHERE 子句示例

-

-此示例查找名字以`Bra`开头且姓氏不是`Motley`的客户：

-

-```sql

-SELECT

- first_name,

- last_name

-FROM

- customer

-WHERE

- first_name LIKE 'Bra%' AND

- last_name <> 'Motley';

-```

-

-

-

-## PostgreSQL BETWEEN 运算符简介

-

-您可以使用`BETWEEN`运算符将一个值与一系列值进行匹配。下面说明了`BETWEEN`运算符的语法：

-

-```sql

-value BETWEEN low AND high;

-```

-

-如果`value`大等于`low`值且小等于`high`值，则表达式返回 true，否则返回 false。

-

-您可以使用大等于 (`>=`) 或小等于 (`<=`) 运算符重写`BETWEEN`运算符，如下所示：

-

-```sql

-value >= low and value <= high

-```

-

-如果要检查值是否超出范围，可以将`NOT`运算符与`BETWEEN`运算符组合起来，如下所示：

-

-```sql

-value NOT BETWEEN low AND high;

-```

-

-以下表达式等效于使用`NOT`和`BETWEEN`运算符的表达式：

-

-```sql

-value < low OR value > high

-```

-

-

-

-如果要检查日期范围内的值，则应使用 ISO 8601 格式的文字日期，即 YYYY-MM-DD。例如，要获取付款日期在`2007-02-07`和`2007-02-15`之间的付款，请使用以下查询：

-

-```sql

-SELECT

- customer_id,

- payment_id,

- amount,

- payment_date

-FROM

- payment

-WHERE

- payment_date BETWEEN '2007-02-07' AND '2007-02-15';

-```

-

-

-

-

-

-## PostgreSQL LIKE 运算符简介

-

-假设您想要找到一位客户，但您不记得她的确切名字。但是，您可以记得她的名字以类似`Jen`开头。

-

-如何从数据库中找到准确的客户？您可以通过查看名字列来查找`customer`表中的客户，看看是否有任何以`Jen`开头的值。但是，如果客户表包含大量行，则此过程可能会非常耗时。

-

-幸运的是，您可以使用 PostgreSQL 的`LIKE`运算符，通过以下查询将客户的名字与字符串进行匹配：

-

-```sql

-SELECT

- first_name,

- last_name

-FROM

- customer

-WHERE

- first_name LIKE 'Jen%';

-```

-

-

-

-请注意，其中`WHERE`子句包含一个特殊表达式：`first_name`、`LIKE`运算符和包含百分号 (`%`) 的字符串。字符串`'Jen%'`称为模式。

-

-该查询返回`first_name`列值以`Jen`开头且后跟任意字符序列的行。这种技术称为模式匹配。

-

-您可以通过将文字值与通配符组合来构造模式，并使用`LIKE`或`NOT LIKE`运算符来查找匹配项。PostgreSQL 为您提供了两个通配符：

-

-- 百分号 (`%`) 匹配任何零个或多个字符的序列。

-- 下划线符号 (`_`) 匹配任何单个字符。

-

-PostgreSQL `LIKE`运算符的语法如下：

-

-```sql

-value LIKE pattern

-```

-

-如果`value`与`pattern`匹配，则表达式返回 true。

-

-要否定`LIKE`运算符，请按如下方式使用`NOT`运算符：

-

-```sql

-value NOT LIKE pattern

-```

-

-当`value`与`pattern`不匹配时，`NOT LIKE`运算符返回 true。

-

-如果模式不包含任何通配符，则`LIKE`运算符的行为类似于等于 (`=`) 运算符。

-

-

-

-## PostgreSQL 对 LIKE 运算符的扩展

-

-PostgreSQL 支持类似于`LIKE`运算符的`ILIKE`运算符。此外，`ILIKE`运算符匹配值时不区分大小写。例如：

-

-```sql

-SELECT

- first_name,

- last_name

-FROM

- customer

-WHERE

- first_name ILIKE 'BAR%';

-```

-

-

-

-模式`BAR%`匹配以`BAR`、`Bar`、`BaR`等开头的任何字符串。如果您改用`LIKE`运算符，查询将不会返回任何行。

-

-PostgreSQL 还提供了一些类似于`LIKE`, `NOT LIKE`, `ILIKE`和`NOT ILIKE`的运算符，如下所示：

-

-| 运算符 | 等价于 |

-| :----- | :-------- |

-| ~~ | LIKE |

-| ~~* | ILIKE |

-| !~~ | NOT LIKE |

-| !~~* | NOT ILIKE |

-

-在本教程中，您学习了如何使用 PostgreSQL 的`LIKE`和`ILIKE`运算符，通过模式匹配来查询数据。

-

-

-

-

-

-## NULL 和 IS NULL 运算符简介

-

-在数据库世界中，NULL 意味着缺少信息或不适用。NULL 不是一个值，因此，您不能将它与任何其他值（例如数字或字符串）进行比较。NULL 与值的比较将始终得到 NULL，这意味着结果未知。

-

-此外，NULL 不等于 NULL，因此以下表达式返回 NULL：

-

-```sql

-NULL = NULL

-```

-

-假设您有一个`contacts`表存储联系人的名字、姓氏、电子邮件和电话号码。在记录联系人时，您可能不知道联系人的电话号码。

-

-为了解决这个问题，您可以将`phone`列定义为可为空列，并在保存联系人信息时将 NULL [插入](https://www.rockdata.net/zh-cn/tutorial/dml-insert/)到`phone`列中。

-

-```sql

-CREATE TABLE contacts(

- id INT GENERATED BY DEFAULT AS IDENTITY,

- first_name VARCHAR(50) NOT NULL,

- last_name VARCHAR(50) NOT NULL,

- email VARCHAR(255) NOT NULL,

- phone VARCHAR(15),

- PRIMARY KEY (id)

-);

-```

-

-因此，要获取电话列中没有存储任何电话号码的联系人，请使用以下语句：

-

-```sql

-SELECT

- id,

- first_name,

- last_name,

- email,

- phone

-FROM

- contacts

-WHERE

- phone IS NULL;

-```

-

-## IS NOT NULL 运算符

-

-要检查值是否不为 NULL，请使用`IS NOT NULL`运算符：

-

-```sql

-value IS NOT NULL

-```

-

-如果值不为 NULL，则表达式返回 true；如果值为 NULL，则表达式返回 false。

-

-例如，要查找有电话号码的联系人，您可以使用以下语句：

-

-```sql

-SELECT

- id,

- first_name,

- last_name,

- email,

- phone

-FROM

- contacts

-WHERE

- phone IS NOT NULL;

-```

-

-

-

-

-

-### 3) 使用 DELETE 从表中删除多行

-

-以下语句从`links`表中删除两行并返回已删除行的`id`列中的值：

-

-```sql

-DELETE FROM links

-WHERE id IN (6,5)

-RETURNING *;

-```

-

-输出：

-

-### 4) 使用 DELETE 删除表中的所有行

-

-以下语句使用不带`WHERE`子句的`DELETE`语句删除`links`表中的所有行：

-

-```sql

-DELETE FROM links;

-```

-

-现在`links`表是空的。

-

-

-

-

-

-## PostgreSQL upsert 简介

-

-在关系数据库中，术语 upsert 称为合并。这个想法是，当您[向表中插入新行](https://www.rockdata.net/zh-cn/tutorial/dml-insert/)时，如果该行已存在，PostgreSQL 将[更新](https://www.rockdata.net/zh-cn/tutorial/dml-update/)该行，否则，它将插入新行。这就是为什么我们称该操作为 upsert（更新或插入的组合）。

-

-要在 PostgreSQL 中使用 upsert 功能，请使用`INSERT ON CONFLICT`语句，如下：

-

-```postgresql

-INSERT INTO table_name(column_list)

-VALUES(value_list)

-ON CONFLICT target action;

-```

-

-PostgreSQL 在`INSERT`语句中添加了`ON CONFLICT target action`子句以支持 upsert 功能。

-

-在此语句中，`target`可以是以下之一：

-

-- `(column_name)` – 列名称。

-- `ON CONSTRAINT constraint_name` – 其中约束名称可以是 [UNIQUE 约束](https://www.rockdata.net/zh-cn/tutorial/constraint-unique/)的名称。

-- `WHERE predicate` –带有谓词的[WHERE 子句](https://www.rockdata.net/zh-cn/tutorial/dml-where/)。

-

-`action`可以是以下之一：

-

-- `DO NOTHING` – 表示如果该行已存在于表中，则不执行任何操作。

-- `DO UPDATE SET column_1 = value_1, .. WHERE condition` – 更新表中的一些字段。

-

-> 请注意，`ON CONFLICT`子句仅在 PostgreSQL 9.5 和以上版本可用。如果您使用的是早期版本，则需要一种解决方法才能拥有更新插入功能。

-

-如果你也在使用 MySQL，你会发现 upsert 功能与 MySQL 中的`insert on duplicate key update`语句类似。

-

-

-

-以下语句与上面的语句等效，但它使用`name`列而不是唯一约束名称作为`INSERT`语句的目标。

-

-```postgresql

-INSERT INTO customers (name, email)

-VALUES('Microsoft','hotline@microsoft.com')

-ON CONFLICT (name)

-DO NOTHING;

-```

-

-假设，您想在插入已存在的客户时将新电子邮件与旧电子邮件连接起来，在这种情况下，您使用`UPDATE`子句作为`INSERT`语句的操作，如下所示：

-

-```postgresql

-INSERT INTO customers (name, email)

-VALUES('Microsoft','hotline@microsoft.com')

-ON CONFLICT (name)

-DO

- UPDATE SET email = EXCLUDED.email || ';' || customers.email;

-```

-

-

-

-

-

-

-

-## 子事务简介

-

-在专业的应用程序中，很难在不遇到任何错误的情况下编写相当长的事务。为了解决这个问题，用户可以使用一种叫做 SAVEPOINT 的东西。顾名思义，保存点是事务中的一个安全位置，如果出现严重错误，应用程序可以返回到该位置。

-

-保存点是一个数据库特性，它允许您在事务中创建命名点，以后可以回滚到该命名点，同时保持事务的其余部分不变。当您想要处理事务中的错误或异常，并有选择地回滚到事务中的特定点，而不必撤消到目前为止所做的所有更改时，保存点非常有用。

-

-## 怎么工作的

-

-以下是在 PostgreSQL 中使用保存点的方法：

-

-使用`BEGIN`语句启动一个事务：

-

-```postgresql

-BEGIN;

-```

-

-这将开始一个新的事务。

-

-在事务中，您可以使用`SAVEPOINT`语句创建一个保存点，并指定一个名称：

-

-```postgresql

-SAVEPOINT my_savepoint;

-```

-

-在此示例中，在事务中创建了一个名为`my_savepoint`的保存点。

-

-在事务中执行一个或多个 SQL 操作，例如`INSERT`、`UPDATE`、`DELETE`等。

-

-在任何时候，如果需要回滚到保存点，可以使用`ROLLBACK TO`语句：

-

-```postgresql

-ROLLBACK TO my_savepoint;

-```

-

-这将撤消在创建`my_savepoint`保存点后所做的所有更改，从而有效地将事务还原到该点。

-

-您还可以使用`RELEASE`语句释放保存点：

-

-```postgresql

-RELEASE my_savepoint;

-```

-

-这将删除保存点，并允许事务从当前位置继续。

-

-最后，当您准备好提交事务中所做的所有更改时，可以使用`COMMIT`语句：

-

-```postgresql

-COMMIT;

-```

-

-这会将事务中所做的所有更改保存到数据库中。

-

-## 示例

-

-下面是一个完整的示例：

-

-```postgresql

-CREATE TABLE test0 AS SELECT 1 AS i;

--- Start a main transaction

-BEGIN;

--- Perform some operations within the transaction

-UPDATE test0 SET i = i + 1;

--- Start a subtransaction

-SAVEPOINT s1;

--- Continue with more operations

-UPDATE test0 SET i = i - 1000;

--- Check the content in the table

-SELECT * FROM test0;

- i

-------

- -998

-(1 row)

--- Something went wrong, let's roll back to the savepoint

-ROLLBACK TO SAVEPOINT s1;

--- Continue with other operations

-UPDATE test0 SET i = i + 1;

--- Finally, when everything is fine, commit the transaction

-COMMIT;

--- Check the content in the table again

-SELECT * FROM test0;

- i

----

- 3

-(1 row)

-```

-

-

-

-

-

-## 13.3. 显式锁定

-

-- [13.3.1. 表级锁](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#LOCKING-TABLES)

-- [13.3.2. 行级锁](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#LOCKING-ROWS)

-- [13.3.3. 页级锁](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#LOCKING-PAGES)

-- [13.3.4. 死锁](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#LOCKING-DEADLOCKS)

-- [13.3.5. 咨询锁](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#ADVISORY-LOCKS)

-

-

-

-PostgreSQL提供了多种锁模式用于控制对表中数据的并发访问。 这些模式可以用于在MVCC无法给出期望行为的情境中由应用控制的锁。 同样，大多数PostgreSQL命令会自动要求恰当的锁以保证被引用的表在命令的执行过程中 不会以一种不兼容的方式删除或修改（例如，`TRUNCATE`无法安全地与同一表中上的其他操作并发地执行，因此它在表上获得一个`ACCESS EXCLUSIVE` 锁来强制这种行为）。

-

-要检查在一个数据库服务器中当前未解除的锁列表，可以使用[`pg_locks`](https://www.rockdata.net/zh-cn/docs/14/view-pg-locks.html)系统视图。 有关监控锁管理器子系统状态的更多信息，请参考[第 28 章](https://www.rockdata.net/zh-cn/docs/14/monitoring.html)。

-

-### 13.3.1. 表级锁

-

-

-

-下面的列表显示了可用的锁模式和PostgreSQL自动使用它们的场合。 你也可以用[LOCK](https://www.rockdata.net/zh-cn/docs/14/sql-lock.html)命令显式获得这些锁。请记住所有这些锁模式都是表级锁，即使它们的名字包含“row”单词（这些名称是历史遗产）。 在一定程度上，这些名字反应了每种锁模式的典型用法 — 但是语意却都是一样的。 两种锁模式之间真正的区别是它们有着不同的冲突锁模式集合（参考[表 13.2](https://www.rockdata.net/zh-cn/docs/14/explicit-locking.html#TABLE-LOCK-COMPATIBILITY)）。 两个事务在同一时刻不能在同一个表上持有属于相互冲突模式的锁（但是，一个事务决不会和自身冲突。例如，它可以在同一个表上获得`ACCESS EXCLUSIVE`锁然后接着获取`ACCESS SHARE`锁）。非冲突锁模式可以由许多事务同时持有。 请特别注意有些锁模式是自冲突的（例如，在一个时刻`ACCESS EXCLUSIVE`锁不能被多于一个事务持有)而其他锁模式不是自冲突的（例如，`ACCESS SHARE`锁可以被多个事务持有)。

-

-**表级锁模式**

-

-- `ACCESS SHARE`

-

- 只与`ACCESS EXCLUSIVE`锁模式冲突。`SELECT`命令在被引用的表上获得一个这种模式的锁。通常，任何只***读取\***表而不修改它的查询都将获得这种锁模式。

-

-- `ROW SHARE`

-

- 与`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。`SELECT FOR UPDATE`和`SELECT FOR SHARE`命令在目标表上取得一个这种模式的锁 （加上在被引用但没有选择`FOR UPDATE/FOR SHARE`的任何其他表上的`ACCESS SHARE`锁）。

-

-- `ROW EXCLUSIVE`

-

- 与`SHARE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。命令`UPDATE`、`DELETE`和`INSERT`在目标表上取得这种锁模式（加上在任何其他被引用表上的`ACCESS SHARE`锁）。通常，这种锁模式将被任何***修改表中数据\***的命令取得。

-

-- `SHARE UPDATE EXCLUSIVE`

-

- 与`SHARE UPDATE EXCLUSIVE`、`SHARE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。这种模式保护一个表不受并发模式改变和`VACUUM`运行的影响。由`VACUUM`（不带`FULL`）、`ANALYZE`、 `CREATE INDEX CONCURRENTLY`、`REINDEX CONCURRENTLY`、 `CREATE STATISTICS`以及某些[`ALTER INDEX`](https://www.rockdata.net/zh-cn/docs/14/sql-alterindex.html) 和 [`ALTER TABLE`](https://www.rockdata.net/zh-cn/docs/14/sql-altertable.html)的变体获得(详细内容请参考这些命令的文档)。

-

-- `SHARE`

-

- 与`ROW EXCLUSIVE`、`SHARE UPDATE EXCLUSIVE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。这种模式保护一个表不受并发数据改变的影响。由`CREATE INDEX`（不带`CONCURRENTLY`）取得。

-

-- `SHARE ROW EXCLUSIVE`

-

- 与`ROW EXCLUSIVE`、`SHARE UPDATE EXCLUSIVE`、`SHARE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。这种模式保护一个表不受并发数据修改所影响，并且是自排他的，这样在一个时刻只能有一个会话持有它。由`CREATE TRIGGER`和某些形式的 [`ALTER TABLE`](https://www.rockdata.net/zh-cn/docs/14/sql-altertable.html)所获得。

-

-- `EXCLUSIVE`

-

- 与`ROW SHARE`、`ROW EXCLUSIVE`、`SHARE UPDATE EXCLUSIVE`、`SHARE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`锁模式冲突。这种模式只允许并发的`ACCESS SHARE`锁，即只有来自于表的读操作可以与一个持有该锁模式的事务并行处理。由`REFRESH MATERIALIZED VIEW CONCURRENTLY`获得。

-

-- `ACCESS EXCLUSIVE`

-

- 与所有模式的锁冲突（`ACCESS SHARE`、`ROW SHARE`、`ROW EXCLUSIVE`、`SHARE UPDATE EXCLUSIVE`、`SHARE`、`SHARE ROW EXCLUSIVE`、`EXCLUSIVE`和`ACCESS EXCLUSIVE`）。这种模式保证持有者是访问该表的唯一事务。由`ALTER TABLE`、`DROP TABLE`、`TRUNCATE`、`REINDEX`、`CLUSTER`、`VACUUM FULL`和`REFRESH MATERIALIZED VIEW`（不带`CONCURRENTLY`）命令获取。 很多形式的`ALTER INDEX`和`ALTER TABLE`也在这个层面上获得锁（见[ALTER TABLE](https://www.rockdata.net/zh-cn/docs/14/sql-altertable.html)）。这也是未显式指定模式的`LOCK TABLE`命令的默认锁模式。

-

-### 提示

-

-只有一个`ACCESS EXCLUSIVE`锁阻塞一个`SELECT`（不带`FOR UPDATE/SHARE`）语句。

-

-一旦被获取，一个锁通常将被持有直到事务结束。 但是如果在建立保存点之后才获得锁，那么在回滚到这个保存点的时候将立即释放该锁。 这与`ROLLBACK`取消保存点之后所有的影响的原则保持一致。 同样的原则也适用于在PL/pgSQL异常块中获得的锁：一个跳出块的错误将释放在块中获得的锁。

-

-**表 13.2. 冲突的锁模式**

-