将 psql 客户端连接到实例

本页面介绍如何将 psql 客户端工具连接到 AlloyDB 实例。

将 psql 连接到 AlloyDB 实例的过程涉及以下任务：

1. 创建可以使用专用服务访问通道连接到 AlloyDB 实例的 Compute Engine 虚拟机。
2. 在该 Compute Engine 虚拟机上安装 psql 客户端。
3. 获取要连接到的 AlloyDB 实例的 IP 地址。
4. 运行 psql 客户端。

前两项任务是一次性操作。创建 Compute Engine 虚拟机并在其上安装 psql 客户端后，您便可以继续执行剩余任务，使用该虚拟机将 psql 连接到 AlloyDB 实例。

创建 Compute Engine 虚拟机

1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

   转到“虚拟机实例”

2. 选择要连接到的 AlloyDB 实例所属的项目。
3. 点击创建实例。
4. 点击机器配置部分。
5. 输入实例的名称。
6. 配置要在其中创建实例的区域和可用区。
7. 选择机器系列及相应的机器类型。
8. 保留操作系统和存储空间部分中的默认值。
9. 点击网络部分，并将网络接口设置为配置了 AlloyDB 专用服务访问通道的 VPC 网络。
   如果网络接口未设置为该配置了专用服务访问通道的 VPC 网络，请展开该选项，然后将网络设置为相应 VPC 网络。
10. 保留可观测性部分中的默认值。
11. 点击安全部分。
12. 在身份和 API 访问权限中，将访问权限范围设置为授予对所有 Cloud API 的完整访问权限。
13. 保留高级部分中的默认值。
14. 点击创建。

创建虚拟机后，使用 SSH 连接到您创建的 Compute Engine 虚拟机。

安装 psql 客户端工具

1. 使用 SSH 连接到您创建的 Compute Engine 虚拟机。

   控制台

   1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

      转到“虚拟机实例”

   2. 在虚拟机实例列表中，点击您创建的实例所在行中的 SSH。

   gcloud

   使用 gcloud compute ssh 命令连接到您创建的实例。

   gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

   替换以下内容：

   • PROJECT_ID：实例所属项目的 ID
   • ZONE：实例所在可用区的名称
   • VM_NAME：实例的名称
2. 通过软件包管理系统安装 psql 客户端：

   sudo apt-get update
   sudo apt-get install postgresql-client

获取 AlloyDB 实例的 IP 地址

如要获取要连接到的 AlloyDB 实例的 IP 地址，您可以查看该实例的设置。

运行 psql 客户端

1. 使用 SSH 连接到您创建的虚拟机。

   控制台

   1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

      转到“虚拟机实例”

   2. 在虚拟机实例列表中，点击您创建的实例所在行中的 SSH。

   gcloud

   使用 gcloud compute ssh 命令连接到您创建的实例。

   gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

   替换以下内容：

   • PROJECT_ID：实例所属项目的 ID。
   • ZONE：实例所在可用区的名称。
   • VM_NAME：实例的名称。
2. 运行 psql 客户端工具：

   psql -h IP_ADDRESS -U USERNAME -d postgres

   系统会提示您输入 USERNAME 用户的密码。

   如果您是首次连接，请为 USERNAME 和数据库都指定 postgres。您的命令如下所示：

   psql -h IP_ADDRESS -U postgres -d postgres

   请使用您在创建集群时设置的密码。