94 lines
3.3 KiB
Markdown
94 lines
3.3 KiB
Markdown
---
|
|
author: 棠羽
|
|
date: 2022/12/25
|
|
minute: 15
|
|
---
|
|
|
|
# 只读节点在线 Promote
|
|
|
|
<ArticleInfo :frontmatter=$frontmatter></ArticleInfo>
|
|
|
|
PolarDB for PostgreSQL 是一款存储与计算分离的云原生数据库，所有计算节点共享一份存储，并且对存储的访问具有 **一写多读** 的限制：所有计算节点可以对存储进行读取，但只有一个计算节点可以对存储进行写入。这种限制会带来一个问题：当读写节点因为宕机或网络故障而不可用时，集群中将没有能够可以写入存储的计算节点，应用业务中的增、删、改，以及 DDL 都将无法运行。
|
|
|
|
本文将指导您在 PolarDB for PostgreSQL 计算集群中的读写节点停止服务时，将任意一个只读节点在线提升为读写节点，从而使集群恢复对于共享存储的写入能力。
|
|
|
|
[[toc]]
|
|
|
|
## 前置准备
|
|
|
|
为方便起见，本示例使用基于本地磁盘的实例来进行演示。拉取如下镜像并启动容器，可以得到一个基于本地磁盘的 HTAP 实例：
|
|
|
|
```shell:no-line-numbers
|
|
docker pull polardb/polardb_pg_local_instance:htap
|
|
docker run -it \
|
|
--cap-add=SYS_PTRACE \
|
|
--privileged=true \
|
|
--name polardb_pg_htap \
|
|
--shm-size=512m \
|
|
polardb/polardb_pg_local_instance:htap \
|
|
bash
|
|
```
|
|
|
|
容器内的 `5432` 至 `5434` 端口分别运行着一个读写节点和两个只读节点。两个只读节点与读写节点共享同一份数据，并通过物理复制保持与读写节点的内存状态同步。
|
|
|
|
## 验证只读节点不可写
|
|
|
|
首先，连接到读写节点，创建一张表并插入一些数据：
|
|
|
|
```shell:no-line-numbers
|
|
psql -p5432
|
|
```
|
|
|
|
```sql:no-line-numbers
|
|
postgres=# CREATE TABLE t (id int);
|
|
CREATE TABLE
|
|
postgres=# INSERT INTO t SELECT generate_series(1,10);
|
|
INSERT 0 10
|
|
```
|
|
|
|
然后连接到只读节点，并同样试图对表插入数据，将会发现无法进行插入操作：
|
|
|
|
```shell:no-line-numbers
|
|
psql -p5433
|
|
```
|
|
|
|
```sql:no-line-numbers
|
|
postgres=# INSERT INTO t SELECT generate_series(1,10);
|
|
ERROR: cannot execute INSERT in a read-only transaction
|
|
```
|
|
|
|
## 读写节点停止写入
|
|
|
|
此时，关闭读写节点，模拟出读写节点不可用的行为：
|
|
|
|
```shell:no-line-numbers
|
|
$ pg_ctl -D ~/tmp_master_dir_polardb_pg_1100_bld/ stop
|
|
waiting for server to shut down.... done
|
|
server stopped
|
|
```
|
|
|
|
此时，集群中没有任何节点可以写入存储了。这时，我们需要将一个只读节点提升为读写节点，恢复对存储的写入。
|
|
|
|
## 只读节点 Promote
|
|
|
|
只有当读写节点停止写入后，才可以将只读节点提升为读写节点，否则将会出现集群内两个节点同时写入的情况。当数据库检测到出现多节点写入时，将会导致运行异常。
|
|
|
|
将运行在 `5433` 端口的只读节点提升为读写节点：
|
|
|
|
```shell:no-line-numbers
|
|
$ pg_ctl -D ~/tmp_replica_dir_polardb_pg_1100_bld1/ promote
|
|
waiting for server to promote.... done
|
|
server promoted
|
|
```
|
|
|
|
## 计算集群恢复写入
|
|
|
|
连接到已经完成 promote 的新读写节点上，再次尝试之前的 `INSERT` 操作：
|
|
|
|
```sql:no-line-numbers
|
|
postgres=# INSERT INTO t SELECT generate_series(1,10);
|
|
INSERT 0 10
|
|
```
|
|
|
|
从上述结果中可以看到，新的读写节点能够成功对存储进行写入。这说明原先的只读节点已经被成功提升为读写节点了。
|