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

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

MySQL  |  PostgreSQL  |  SQL Server

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

---

如要直接在 Google Cloud 控制台按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

---

事前準備

注意： 專案名稱長度必須介於 4 至 30 個字元之間。輸入名稱時，表單會建議專案 ID，您可以編輯。專案 ID 長度必須介於 6 到 30 個字元之間，第一個字元須為小寫英文字母，其餘字元可以是破折號、小寫英文字母或數字，但最後一個字元不得為破折號。

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.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

1. 啟用必要的 Google Cloud API。

   控制台

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

   前往 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

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

   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 MySQL」(選擇 MySQL)。
4. 在「Instance ID」(執行個體 ID) 欄位中輸入 myinstance。
5. 在「Password」(密碼) 欄位中，輸入 root 使用者的密碼。

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

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

   注意：在本範例中，執行個體是使用預設設定建立，包括公開 IP 位址。

連線至執行個體

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

注意： Cloud Shell 無法搭配私人 IP 位址使用。這些操作說明僅適用於具有公開 IP 位址的執行個體。

1. 選用：如果您執行的是本機 MySQL 執行個體，請先停止執行，再連線至 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 平台，請使用 gcloud auth login 指令。

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

   gcloud sql connect myinstance --user=root

5. 在對話方塊中，按一下「Authorize」(授權)，授權 Cloud Shell 發出 API 呼叫。

   系統隨即會顯示下列訊息：

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

   這則訊息表示系統允許 Cloud SQL 執行個體的公開 IP 位址接收連線。看到這則訊息後，系統會提示你輸入密碼。

6. 輸入 root 密碼。

   畫面上會顯示 mysql 提示。

建立資料庫並上傳資料

1. 在 Cloud SQL 執行個體上建立 SQL 資料庫：

   CREATE DATABASE guestbook;

2. 將範例資料插入 guestbook 資料庫：

   USE guestbook;
   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
       entryID INT NOT NULL AUTO_INCREMENT, PRIMARY KEY(entryID));
       INSERT INTO entries (guestName, content) values ("first guest", "I got here!");
       INSERT INTO entries (guestName, content) values ("second guest", "Me too!");

3. 擷取資料：

   SELECT * FROM entries;

   結果如下：

   +--------------+-------------------+---------+
   | guestName    | content           | entryID |
   +--------------+-------------------+---------+
   | first guest  | I got here!       |       1 |
   | second guest | Me too!           |       2 |
   +--------------+-------------------+---------+
   2 rows in set (0.00 sec)
   mysql>
   

清除所用資源

如要避免系統向您的 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 控制台的「API」頁面。

   前往 API 頁面

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

後續步驟

• 瞭解如何建立 Cloud SQL 執行個體。

• 瞭解如何建立 Cloud SQL 執行個體的 MySQL 使用者和資料庫。

• 請參閱 Cloud SQL 定價資訊。

• 在本快速入門導覽課程中，您已使用 Cloud Shell 連線至執行個體。瞭解 Cloud SQL 的所有連線選項。連線方式取決於網路設定，例如 Cloud SQL 執行個體是否具有公開或私人 IP 位址。瞭解如何使用公開 IP 和私人 IP 位址設定 Cloud SQL 執行個體。

• 瞭解如何從其他 Google Cloud 應用程式連線至 Cloud SQL 執行個體：

  • 從在 App Engine 標準環境中執行的應用程式
  • 從在 Compute Engine 中執行的應用程式
  • 從 GKE 上執行的應用程式
  • 從 Cloud Run