Cloud SQL for PostgreSQL 快速入门

本页面向您展示如何创建并连接到 PostgreSQL 实例,并使用 Google Cloud Console 和客户端执行基本的 SQL 操作。如果您及时完成本快速入门中的步骤(包括清理),那么在此期间所创建资源的费用通常不会超过 1 美元。

设置项目

在执行本快速入门中的步骤之前,请完成以下任务:

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能

  4. 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  5. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能

  6. 确保您的用户帐号具有 Cloud SQL Admin 角色。
    • 转到 IAM 页面。 转到 IAM 页面
    • 点击添加
    • 新原则中,添加您的用户帐号名称。
    • 选择角色中,过滤 Cloud SQL Admin,然后从列表中选择该角色。
    • 点击保存
  7. 启用 Cloud SQL Admin API。

    启用 API

创建 Cloud SQL 实例

在此过程中,您将使用 Google Cloud Console。如需使用 gcloud 命令行工具、cURL 或 PowerShell,请参阅创建实例

  1. 在 Google Cloud Console 中,转到 Cloud SQL 实例页面。

    转到“Cloud SQL 实例”

  2. 点击创建实例
  3. 点击 PostgreSQL
  4. 如果系统提示您启用 Compute API,请点击启用 API 按钮。
  5. 实例 ID 部分输入 myinstance
  6. 为 postgres 用户输入密码。
  7. 对于其他字段,请使用默认值。
  8. 点击创建

    您将返回到实例列表;您可以立即点击进入新实例来查看详细信息,但该实例只能在初始化并启动之后才可用。

    注意:在此示例中,实例是使用默认设置(包括公共 IP 地址)创建的。

使用 Cloud Shell 中的 psql 客户端连接到实例

  1. Google Cloud Console 中,点击右上角的 Cloud Shell 图标 (Cloud Shell 图标)。

    Cloud Shell 完成初始化后,将显示以下内容:

    Welcome to Cloud Shell! Type "help" to get started.
    username@example-id:~$
    
  2. 在 Cloud Shell 提示符下,连接到您的 Cloud SQL 实例:

    gcloud sql connect myinstance --user=postgres
    
  3. 输入您的 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=>
    

清理

  1. 在 Google Cloud Console 中,转到 Cloud SQL 实例页面。

    转到“Cloud SQL 实例”

  2. 选择实例的名称以打开概览页面。
  3. 在页面顶部的图标栏中,点击删除
  4. 删除实例窗口中,输入实例名称,然后点击删除以删除该实例。

    在删除实例后的大约 7 天内,您不能重新使用相应的实例名称。

后续步骤

您可以根据自己的需求详细了解如何创建 Cloud SQL 实例

您还可以了解如何为 Cloud SQL 实例创建 PostgreSQL 用户数据库

另请参阅 Cloud SQL 价格信息

在本快速入门中,您将使用 Cloud Shell 连接到实例。在大多数使用场景中,连接方式都要取决于您的网络配置,例如:

  • 您的 Cloud SQL 实例具有公共或专用 IP 地址。
  • 从 Google Cloud 内部(通过同一项目或不同项目)进行连接。
  • 从 Google Cloud 外部进行连接。

详细了解以下内容:

此外,您还可以了解如何从其他 Google Cloud 应用连接到 Cloud SQL 实例: