创建只读副本

选择文档版本：

如需提高读取吞吐量和可用性，您可以为现有的 AlloyDB Omni 服务器创建 AlloyDB Omni 副本服务器。副本服务器提供主数据库服务器的只读克隆。它会持续更新自己的数据，以反映主服务器数据的变化。

以下部分提供了相关步骤，用于配置 AlloyDB Omni 主服务器以进行复制、配置副本服务器以及验证主服务器上的复制状态。

如需了解详情，请参阅在 Kubernetes 上安装 AlloyDB Omni。

配置主服务器以进行复制

  1. 更新主服务器主机的网络或防火墙设置，以便允许通过主服务器的 Postgres 端口从副本服务器主机发送入站流量。

  2. 创建复制用户：

    Docker 

    docker exec CONTAINER_NAME psql -h localhost -U postgres -c "create user REPLICA_USER with replication password 'PASSWORD'"

    替换以下内容：

    • REPLICA_USER：副本用户的名称。
    • PASSWORD：副本用户的密码。
    • CONTAINER_NAME：您在安装 AlloyDB Omni 容器时为其分配的名称。

    Podman

    podman exec CONTAINER_NAME psql -h localhost -U postgres -c "create user REPLICA_USER with replication password 'PASSWORD'"

    替换以下内容：

    • REPLICA_USER：副本用户的名称。
    • PASSWORD：副本用户的密码。
    • CONTAINER_NAME：您在安装 AlloyDB Omni 容器时为其分配的名称。

  3. 在主服务器的 /DATA_DIR/pg_hba.conf 文件中，将以下代码行添加到文件中存在的 host all all all scram-sha-256 之前：

    host alloydbmetadata    alloydbmetadata   IP_RANGE trust
host replication        REPLICA_USER    IP_RANGE scram-sha-256

    替换以下内容：

    • IP_RANGE：副本机器所在子网的 IP 范围（采用 CIDR 表示法）。例如 203.0.113.0/24。
    • DATA_DIR：主服务器的数据目录路径。

  4. 重启主服务器：

    Docker 

    docker restart CONTAINER_NAME

    Podman

    podman restart CONTAINER_NAME

创建和配置副本服务器

如需创建和配置 AlloyDB Omni 副本服务器，请完成以下步骤：

  1. 确保副本与主服务器之间建立了网络连接：

    ping SOURCE_IP

    将 SOURCE_IP 替换为要从中复制的 AlloyDB Omni 主实例的 IP 地址。

  2. 确保副本可以连接到主服务器：

    Docker 

    docker run -it --rm google/alloydbomni psql "host=SOURCE_IP user=REPLICA_USER replication=1" -c "IDENTIFY_SYSTEM;"

    Podman

    podman run -it --rm google/alloydbomni psql "host=SOURCE_IP user=REPLICA_USER replication=1" -c "IDENTIFY_SYSTEM;"

    输出应类似如下所示：

           systemid       | timeline |  xlogpos  | dbname
 ---------------------+----------+-----------+--------
  7376500460465963036 |        1 | 0/454B670 |
  (1 row)

  3. 副本必须在磁盘上具有永久性存储位置：

    Docker 

     mkdir alloydb && docker run --rm -it \
   -e PGDATA=/var/lib/postgresql/data/pgdata \
   -v "$PWD/alloydb":/var/lib/postgresql/data \
   -p 5432:5432 \
   --user $(id -u):$(id -g) \
   google/alloydbomni \
   /usr/lib/postgresql/15/bin/pg_basebackup \
     --pgdata=/var/lib/postgresql/data/pgdata \
     --checkpoint=fast \
     --host="SOURCE_IP" \
     --port="SOURCE_PORT" \
     --username=REPLICA_USER \
     --create-slot \
     --write-recovery-conf \
     --slot="SLOT_NAME"

    替换以下内容：

    • SOURCE_PORT：要从中复制的 AlloyDB Omni 主实例的 TCP 端口。如果您未提供此值，AlloyDB Omni 会应用默认值 5432。
    • SLOT_NAME：复制槽名称的标签。

    Podman

     mkdir alloydb && podman run --rm -it \
   -e PGDATA=/var/lib/postgresql/data/pgdata \
   -v "$PWD/alloydb":/var/lib/postgresql/data \
   -p 5432:5432 \
   --user $(id -u):$(id -g) \
   google/alloydbomni \
   /usr/lib/postgresql/15/bin/pg_basebackup \
     --pgdata=/var/lib/postgresql/data/pgdata \
     --checkpoint=fast \
     --host="SOURCE_IP" \
     --port="SOURCE_PORT" \
     --username=REPLICA_USER \
     --create-slot \
     --write-recovery-conf \
     --slot="SLOT_NAME"

    替换以下内容：

    • SOURCE_PORT：要从中复制的 AlloyDB Omni 主实例的 TCP 端口。如果您未提供此值，AlloyDB Omni 会应用默认值 5432。
    • SLOT_NAME：复制槽名称的标签。

  4. 启动副本实例：

    Docker 

    docker run --detach \
  --name pg-service \
  -e POSTGRES_PASSWORD=a \
  -e PGDATA=/var/lib/postgresql/data/pgdata \
  -v "$PWD/alloydb":/var/lib/postgresql/data \
  -v /dev/shm:/dev/shm \
  -p 5432:5432 \
  --user $(id -u):$(id -g) \
  google/alloydbomni

    Podman

    podman run --detach \
  --name pg-service \
  -e POSTGRES_PASSWORD=a \
  -e PGDATA=/var/lib/postgresql/data/pgdata \
  -v "$PWD/alloydb":/var/lib/postgresql/data \
  -v /dev/shm:/dev/shm \
  -p 5432:5432 \
  --user $(id -u):$(id -g) \
  google/alloydbomni

验证主服务器上的复制状态

如需验证复制是否已正确配置，请在主服务器的主机上运行以下命令：

Docker 

  docker exec -it CONTAINER_NAME psql -h localhost -U postgres -c "select * from pg_stat_replication"

Podman

  podman exec -it CONTAINER_NAME psql -h localhost -U postgres -c "select * from pg_stat_replication"

对于连接到主数据库服务器的每个副本，输出表中都包含对应的一行。

设置复制后，几秒钟内便可在副本上读取对主数据库服务器中的行执行的所有插入、更新和删除操作。

后续步骤