本页介绍了如何在 AlloyDB for PostgreSQL 集群中创建读取池实例。
准备工作
- 您使用的 Google Cloud 项目必须已启用对 AlloyDB 的访问权限。
- 您必须在所使用的 Google Cloud 项目中拥有以下 IAM 角色之一:
roles/alloydb.admin
(AlloyDB Admin 预定义 IAM 角色)roles/owner
(Owner 基本 IAM 角色)roles/editor
(Editor 基本 IAM 角色)
如果您不具备上述任何角色,请与您的组织管理员联系以请求访问权限。
创建读取池实例
控制台
在 Google Cloud 控制台中,前往集群页面。
点击资源名称列中的某个集群。
前往集群中的实例部分,然后点击添加读取池。
配置读取池实例:
在读取池实例 ID 字段中,输入读取池实例的 ID。
在节点数字段中,输入节点数。
读取池实例中的节点数决定了实例的总计算容量。
选择以下某个机器系列:
- C4A(基于 Google Axion 的机器系列)(预览版)
- N2(基于 x86 的机器系列)。这是默认的机器系列。
选择机器类型。
- C4A 支持 1、4、8、16、32、48、64 和 72 个机器类型或形状。
- N2 支持 2、4、8、16、32、64、96 和 128 个机器类型或形状。
如需详细了解如何使用基于 Axion 的 C4A 机器系列(包括 1 vCPU 机器类型),请参阅使用基于 Axion 的 C4A 机器系列时的注意事项。
- 可选:如需通过公共互联网连接您的应用和客户端,请点击公共 IP 连接中的启用公共 IP。启用公共 IP 可能需要额外配置,以确保安全连接。如需了解详情,请参阅使用公共 IP 进行连接。
默认情况下,专用 IP 始终处于启用状态。如需了解详情,请参阅启用专用服务访问通道。
可选:如需启用和使用托管式连接池,请选中托管式连接池下的启用托管式连接池复选框。如需了解详情,请参阅配置托管连接池。
选择网络安全设置。为确保您的数据安全,我们建议您使用 AlloyDB 连接器使用 mTLS 加密或 SSL 加密。
更改安全设置后,您的实例仍可供使用,但现有的不合规连接将被舍弃。
可选:为实例设置自定义标志。对于每个标志,请按以下步骤操作:
- 点击高级配置选项。
- 点击添加数据库标志。
- 从新数据库标志列表中选择一个标志。
- 为标志提供值。
- 点击完成。
点击添加读取池。
gcloud
如需使用 gcloud CLI,您可以安装并初始化 Google Cloud CLI,也可以使用 Cloud Shell。
使用 gcloud alloydb instances create
命令创建读取池实例。
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--read-pool-node-count=NODE_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID
替换以下内容:
INSTANCE_ID
:您要创建的实例的 ID。必须以小写字母开头,可以包含小写字母、数字和连字符。CPU_COUNT
:您希望实例具有的 N2 vCPU 数量。默认值为 N2。有效值包括:2
:2 个 vCPU,16 GB RAM4
:4 个 vCPU,32 GB RAM8
:8 个 vCPU,64 GB RAM16
:16 个 vCPU,128 GB RAM32
:32 个 vCPU,256 GB RAM64
:64 个 vCPU,512 GB RAM96
:96 个 vCPU,768 GB RAM128
:128 个 vCPU,864 GB RAM
MACHINE_TYPE
:在部署 N2 机器时,此参数是可选的。如需部署基于 Axion 的 C4A 机器系列(预览版),或在 C4A 和 N2 机器之间迁移,请选择此参数并使用以下值。将
MACHINE_TYPE
和CPU_COUNT
搭配使用时,CPU_COUNT
和MACHINE_TYPE
中的值必须匹配,否则会出现错误。对于基于 Axion 的 C4A 机器系列,请选择具有以下值的机器类型:
c4a-highmem-1
c4a-highmem-4-lssd
c4a-highmem-8-lssd
c4a-highmem-16-lssd
c4a-highmem-32-lssd
c4a-highmem-48-lssd
c4a-highmem-64-lssd
c4a-highmem-72-lssd
如需部署具有 4 个 vCPU 或更高 vCPU 的 C4A,请使用后缀
lssd
来启用超快缓存。如需详细了解如何使用基于 Axion 的 C4A 机器系列(包括 1 vCPU 机器类型),请参阅使用基于 Axion 的 C4A 机器系列时的注意事项。
对于基于 x86 的 N2 机器系列,请使用以下值:
N2-highmem-2
N2-highmem-4
N2-highmem-8
N2-highmem-16
N2-highmem-32
N2-highmem-64
N2-highmem-96
N2-highmem-128
NODE_COUNT
:实例中的节点数。 指定一个介于1
到20
(包括这两个数值)之间的数字。请注意,集群中所有读取池实例的节点总数不得超过 20 个。REGION_ID
:您希望实例所在的区域。CLUSTER_ID
:您希望将实例放置到的集群的 ID。PROJECT_ID
:放置集群的项目的 ID。
如需为启用了 Private Service Connect 的集群创建读取池实例,请添加 --allowed-psc-projects
标志,以设置您要允许访问实例的项目 ID 或 [项目编号](/resource-manager/docs/creating-managing-projects#identifying_projects)(例如 my-project-1
、12345
、my-project-n
)的逗号分隔列表。
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECT_LIST
替换以下内容:
ALLOWED_PROJECT
(可选):您要允许访问实例的项目 ID 或项目编号的逗号分隔列表,例如my-project-1
、12345
、my-project-n
。如果您的集群使用 Private Service Connect 作为连接到实例的方法,您必须设置允许的项目或编号列表。
如需在读取池实例中启用托管连接池,请将 --enable-connection-pooling
标志添加到 gcloud alpha alloydb instances create
命令:
gcloud alpha alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--enable-connection-pooling
如需为启用了公共 IP 的集群创建读取池实例,请添加 --assign-inbound-public-ip=ASSIGN_IPV4
参数。
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--assign-inbound-public-ip=ASSIGN_IPV4
(可选)您可以将 CIDR 地址块的逗号分隔列表(例如 64.233.160.0/16
)传递给 --authorized-external-networks
参数,以在实例上设置已获授权的外部网络。
后续步骤
- 了解连接读取池实例的选项。
- 查看实例详情。
- 扩缩实例。
- 重启实例或读取池节点。
- 排查读取池查询问题。
- 了解大小调整建议