从 Cloud Shell 连接到 Cloud SQL for PostgreSQL

创建 Cloud SQL 实例

在本快速入门中，您将使用 Google Cloud 控制台。如需使用 gcloud CLI、cURL 或 PowerShell，请参阅创建实例。

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 点击创建实例。
3. 点击选择 PostgreSQL。
4. 在实例 ID 字段中，输入 myinstance。
5. 在密码字段中，输入 postgres 用户的密码。

6. 点击创建实例。

   您会返回到实例列表。您可以立即点击新实例以查看详细信息，但该实例只能在初始化并启动之后才可用于其他操作。

   ：在此示例中，将使用默认设置（包括公共 IP 地址）创建实例。

连接到您的实例

在本快速入门中，我们将在 Cloud Shell 中使用 psql 客户端来连接到您的实例。Cloud Shell 是一个远程沙盒化环境。

1. 可选：如果您运行的是 PostgreSQL, 的本地实例，请先停止该实例，然后再连接到 Cloud SQL 实例。否则，您可能会遇到 address already in use 之类的错误。

2. 在 Google Cloud 控制台中，点击右上角的 Cloud Shell 图标 ()。

   Cloud Shell 完成初始化后，系统会显示如下消息：

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. 可选：如果您尚未授权 gcloud CLI 使用您的 Google 用户凭据访问 Google Cloud Platform，请使用 gcloud auth login 命令。

4. 在 Cloud Shell 提示符下，连接到您的 Cloud SQL 实例。使用如下所示的 gcloud sql connect 命令。如果实例名称不同，请替换实例名称。

   gcloud sql connect myinstance --user=postgres

5. 在对话框中，点击授权，以授权 Cloud Shell 进行 API 调用。

   系统会显示以下消息：

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   此消息表示 Cloud SQL 实例的公共 IP 地址已获准接收传入连接。显示此消息后，系统会提示您输入密码。

6. 输入您的 postgres 密码。

   系统会显示 psql 提示符。

创建数据库并上传数据

1. 在 Cloud SQL 实例上创建 SQL 数据库：

   CREATE DATABASE guestbook;

2. 输入以下命令并指定密码，以连接到数据库。

   \connect guestbook;

3. 将示例数据插入数据库：

   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                           entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
   INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');

4. 检索数据：

   SELECT * FROM entries;

   结果是：

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>