從 Cloud Shell 連線至 PostgreSQL 適用的 Cloud SQL

本頁面說明如何使用 Google Cloud 控制台和用戶端建立及連線至 PostgreSQL 執行個體，並執行基本 SQL 作業。假設您及時完成所有步驟 (包括清除作業)，本快速入門導覽課程建立的資源通常不會超過一美元。

事前準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. 啟用必要的 Google Cloud API。

    控制台

    前往 Google Cloud 控制台的「APIs」頁面。

    前往 API 頁面

    啟用 Cloud SQL Admin API。

    gcloud

    按一下下列按鈕開啟 Cloud Shell，直接在瀏覽器中使用指令列存取 Google Cloud 資源。您可以使用 Cloud Shell 執行本快速入門導覽課程中顯示的 gcloud 指令。

    開啟 Cloud Shell

    使用 Cloud Shell 執行下列 gcloud services enable 指令，啟用本快速入門導覽課程所需的 API：

    gcloud services enable sqladmin.googleapis.com

    這個指令會啟用下列 API：

    • Cloud SQL Admin API

  7. Make sure that you have the following role or roles on the project: Cloud SQL Admin (roles/cloudsql.admin)

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      前往 IAM
    2. 選取專案。
    3. 按一下 「授予存取權」。

    4. 在「New principals」(新增主體) 欄位中，輸入您的使用者 ID。 這通常是 Google 帳戶的電子郵件地址。

    5. 在「Select a role」(選取角色) 清單中，選取角色。
    6. 如要授予其他角色，請按一下 「新增其他角色」，然後新增每個其他角色。
    7. 按一下 [Save]。

建立 Cloud SQL 執行個體

在本快速入門導覽課程中，您將使用 Google Cloud 控制台。如要使用 gcloud CLI、cURL 或 PowerShell，請參閱「建立執行個體」。

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

    前往 Cloud SQL 執行個體

  2. 點選「建立執行個體」。
  3. 按一下「Choose PostgreSQL」(選擇 PostgreSQL)。
  4. 在「Instance ID」(執行個體 ID) 欄位中輸入 myinstance。
  5. 在「Password」(密碼) 欄位中，輸入 postgres 使用者的密碼。

  6. 點選「建立執行個體」。

    您會返回執行個體清單。您可以立即點選新執行個體查看詳細資料，但必須等到執行個體初始化並啟動後，才能執行其他作業。

連線至執行個體

在本快速入門導覽課程中，我們將使用 Cloud Shell 中的 psql 用戶端連線至執行個體。Cloud Shell 是遠端沙箱環境。

  1. 選用：如果您執行的是 PostgreSQL 的本機執行個體，請先停止執行，再連線至 Cloud SQL 執行個體。否則可能會發生 address already in use 等錯誤。

  2. 在 Google Cloud 控制台中，按一下右上角的 Cloud Shell 圖示 (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 平台，請使用 gcloud auth login 指令。

  4. 在 Cloud Shell 提示中，連線至 Cloud SQL 執行個體。使用 gcloud sql connect 指令，如下所示。如果執行個體名稱不同，請替換執行個體名稱。

    gcloud sql connect myinstance --user=postgres
  5. 在對話方塊中，按一下「Authorize」(授權)，授權 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=>

清除所用資源

如要避免系統向您的 Google Cloud 帳戶收取本頁所用資源的費用，請按照下列步驟操作。

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

    前往 Cloud SQL 執行個體

  2. 選取 myinstance 執行個體，開啟「執行個體詳細資料」頁面。
  3. 在頁面頂端的圖示列中，按一下 [刪除]。
  4. 在「Delete instance」(刪除執行個體) 視窗中輸入執行個體名稱，然後按一下「Delete」(刪除)。

選用清除步驟

如果您未使用本快速入門導覽課程啟用的 API，可以停用這些 API。

  • 本快速入門導覽課程中啟用的 API：
    • Cloud SQL Admin API

  1. 前往 Google Cloud 控制台的「APIs」頁面。

    前往 API 頁面

  2. 選取 Cloud SQL Admin API，然後按一下「停用 API」按鈕。

後續步驟