從本機電腦連線至 PostgreSQL 適用的 Cloud SQL

從本機電腦連線至 PostgreSQL 適用的 Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

瞭解如何透過 Google Cloud 控制台和用戶端應用程式，在 Linux、macOS 或 Windows 本機電腦上部署連結至 PostgreSQL 執行個體的範例應用程式。

假設您及時完成所有步驟，這項快速入門導覽課程建立的資源通常不到一美元。

事前準備

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

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify 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.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. 確認您具備完成本快速入門導覽課程所需的權限。
2. 啟用在本機電腦上執行 Cloud SQL 範例應用程式所需的 Cloud API。

   控制台

   按一下「Enable APIs」(啟用 API) 按鈕，啟用本快速入門導覽所需的 API。

   啟用 API

   這會啟用下列 API：

   • Cloud SQL Admin API
   • IAM API

   gcloud

   安裝 gcloud CLI，透過指令列存取 Google Cloud 資源。gcloud CLI 用於執行本快速入門導覽課程中顯示的 gcloud CLI 指令。所有指令都經過格式化，可在 Linux/macOS 終端機或 Windows Powershell 中執行。

   開啟終端機並執行下列 gcloud 指令：

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   這個指令會啟用下列 API：

   • Cloud SQL Admin API
   • IAM API

必要的角色

如要取得從本機電腦設定 Cloud SQL 所需的權限，請要求管理員在您要建立及連線的專案中，授予您下列 IAM 角色：

• 建立或刪除執行個體、資料庫和使用者： Cloud SQL 管理員角色 (roles/cloudsql.admin)。
• 建立或刪除 IAM 服務帳戶： IAM 服務帳戶管理員角色 (roles/iam.serviceAccountAdmin)。
• 新增或移除 IAM 政策繫結： 專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin)。
• 建立、管理及輪換服務帳戶金鑰： 服務帳戶金鑰管理員 (roles/iam.serviceAccountKeyAdmin)。

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

設定 Cloud SQL

如要建立 Cloud SQL 執行個體，請按照下列步驟操作：

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

   前往 Cloud SQL 執行個體

2. 選取「PostgreSQL」分頁，然後按一下「沙箱」方塊中的「建立沙箱執行個體」。或者，您也可以按一下「建立執行個體」，然後完成下列步驟：
1. 按一下「Choose PostgreSQL」(選擇 PostgreSQL)。
2. 選取「Enterprise」版本。
3. 選擇「Sandbox」預設設定。
3. 如果系統提示您啟用 Compute API，請按一下「啟用 API」按鈕。
4. 在「執行個體資訊」部分中，輸入 quickstart-instance 做為「執行個體 ID」。
5. 輸入 postgres 使用者的密碼。記下您建立的密碼，因為後續步驟會用到。
6. 在「選擇區域和可用區供應情形」部分，選取「單一可用區」選項。
7. 點選「建立執行個體」。

建立資料庫

控制台

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

   前往 Cloud SQL 執行個體

2. 選取「quickstart-instance」。
3. 開啟「資料庫」分頁。
4. 按一下 [Create database] (建立資料庫)。
1. 在「New database」(新增資料庫) 對話方塊中，輸入 quickstart_db 做為資料庫名稱。
   
2. 點選「建立」。

gcloud

執行 gcloud sql databases create 指令來建立資料庫。

gcloud sql databases create quickstart_db --instance=quickstart-instance

新增使用者

控制台

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

   前往 Cloud SQL 執行個體

2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
3. 從「SQL」導覽選單中選取「使用者」。
4. 按一下「新增使用者帳戶」。
5. 在「Add a user account to instance instance_name」(在執行個體「instance_name」中新增使用者帳戶) 頁面中， 新增下列資訊：
   • 在「Username」(使用者名稱) 欄位中輸入 quickstart-user。
   • 在「Password」(密碼) 欄位中，指定資料庫使用者的密碼。 請記下這個值，本快速入門導覽課程的後續步驟會用到。
6. 按一下「新增」。

gcloud

更改下列內容：

1. PASSWORD，並提供資料庫使用者的密碼。 請記下這個值，本快速入門導覽課程的後續步驟會用到。

執行 gcloud sql users create 指令來建立使用者。

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

Cloud SQL 的使用者名稱長度限制與地端部署 PostgreSQL 相同。

設定服務帳戶

建立及設定具有「Cloud SQL 用戶端」 Google Cloud 角色的服務帳戶，並授予連線至 Cloud SQL 的權限。 建立服務帳戶後，可能需要等待 60 秒以上才能使用該帳戶。

控制台

建立服務帳戶

1. 前往 Google Cloud 控制台的「Create service account」(建立服務帳戶) 頁面。

前往「建立服務帳戶」

2. 選取 Google Cloud 專案。
3. 輸入 quickstart-service-account 做為服務帳戶名稱。
4. 選用：輸入服務帳戶的說明。
5. 按一下「建立並繼續」，然後繼續進行下一個步驟。
6. 選擇要授予專案服務帳戶的 Cloud SQL 用戶端角色。
7. 按一下「繼續」。
8. 按一下「Done」(完成)，即完成建立服務帳戶。

建立並下載服務帳戶金鑰檔案

1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

前往「Service accounts」(服務帳戶)

2. 選取專案。
3. 點選要建立金鑰的 quickstart-service-account 服務帳戶電子郵件地址。
4. 按一下「Keys」(金鑰) 分頁標籤。
5. 按一下「Add key」(新增金鑰) 下拉式選單，然後選取「Create new key」(建立新的金鑰)。
6. 選取「JSON」做為金鑰類型，然後按一下「Create」(建立)。

按一下「Create」(建立)，即可下載服務帳戶金鑰檔案。金鑰檔案下載後，就不能再次下載。

請務必妥善保存金鑰檔案，因為此檔案可當做服務帳戶進行驗證。您可以任意移動及重新命名這個檔案。

gcloud

建立服務帳戶

1. 如要建立服務帳戶，請執行 gcloud iam service-accounts create 指令：

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

替換下列值：

• DESCRIPTION：服務帳戶的選填說明
2. 如要為專案中的服務帳戶授予 Cloud SQL 用戶端角色，請執行 gcloud projects add-iam-policy-binding 指令。將 PROJECT_ID 替換為您的 Google Cloud 專案 ID：

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

建立並下載服務帳戶金鑰檔案

如要從本機電腦使用剛建立的服務帳戶，您需要服務帳戶金鑰檔案，才能將範例應用程式驗證為服務帳戶。如要建立及下載服務帳戶金鑰檔案，請執行 gcloud iam service-accounts keys create 指令：

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

替換下列值：

• KEY_FILE：私密金鑰的新輸出檔案路徑，例如 ~/sa-private-key.json。
• PROJECT_ID：您的 Google Cloud 專案 ID。

服務帳戶金鑰檔案會下載至本機電腦。金鑰檔案下載後，就不能再次下載。

請務必妥善保存金鑰檔案，因為任何人都能使用此檔案，以服務帳戶身分進行驗證。您可以任意移動及重新命名這個檔案。

設定程式設計語言的開發環境

為偏好的程式設計語言設定本機電腦的開發環境。

Go

請完成下列步驟，設定開發環境來執行 Go 範例應用程式。

1. 前往 Go 開發環境設定指南。
2. 完成「安裝 Go」一節中的操作說明。

Java

請完成下列步驟，設定開發環境來執行 Java 範例應用程式。

1. 前往 Java 開發環境設定指南。
2. 完成「安裝 JDK (Java Development Kit)」一節中的操作說明。
3. 按照「安裝自動化建置工具」一節的說明，設定 Apache Maven。

Node.js

請完成下列步驟，設定開發環境來執行 Node.js 範例應用程式。

1. 請參閱 Node.js 開發環境設定指南。
2. 完成「安裝 Node.js 和 npm」一節中的操作說明。

Python

請完成下列步驟，設定開發環境來執行 Python 範例應用程式。

1. 請參閱 Python 開發環境設定指南。
2. 完成「安裝 Python」一節中的指示。

安裝 Git

安裝開放原始碼版本管控系統 Git。

Linux

請按照 Linux 的官方 Git 安裝說明文件操作。

macOS

請按照 macOS 的官方 Git 安裝說明文件操作。

Windows

請按照 Windows 的官方 Git 安裝說明文件操作。

複製範例應用程式

使用 git clone 指令，將範例應用程式複製到本機電腦。

Go

執行下列指令，將 Go 範例應用程式複製到本機電腦，並將目錄變更為包含範例應用程式的目錄。

1. 複製範例應用程式。

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. 將目錄變更為包含範例應用程式的目錄。

   cd golang-samples/cloudsql/postgres/database-sql

Java

執行下列指令，將 Java 範例應用程式複製到本機電腦，並將目錄變更為包含範例應用程式的目錄。

1. 複製範例應用程式。

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. 將目錄變更為包含範例應用程式的目錄。

   cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

執行下列指令，將 Node.js 範例應用程式複製到本機電腦，並將目錄變更為包含範例應用程式的目錄。

1. 複製範例應用程式。

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. 將目錄變更為包含範例應用程式的目錄。

   cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

執行下列指令，將 Python 範例應用程式複製到本機電腦，然後將目錄變更為包含範例應用程式的目錄。

1. 複製範例應用程式。

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. 將目錄變更為包含範例應用程式的目錄。

   cd python-docs-samples/cloud-sql/postgres/sqlalchemy

設定及執行範例應用程式

設定並執行範例應用程式。

Linux/macOS

Go

開啟終端機並執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換作業：

• CREDENTIALS_JSON_FILE，並使用 /path/to/service/account/key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

執行下列指令，在本機電腦上取得 Go 範例應用程式的依附元件，並執行範例應用程式。

1. 取得執行範例應用程式所需的依附元件。

   go get ./...

2. 執行範例應用程式。

   go run cmd/app/main.go

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的終端機視窗中按下 Control+C。

Java

執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

• CREDENTIALS_JSON_FILE，並使用 /path/to/service/account/key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. 執行下列指令，在本機電腦上取得 Java 範例應用程式的依附元件，並執行範例應用程式。

   mvn jetty:run

2. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

3. 如要停止範例應用程式，請在啟動範例應用程式的終端機視窗中按下 Control+C。

Node.js

1. 執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

   • CREDENTIALS_JSON_FILE，並使用 /path/to/service/account/key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
   • YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'

2. 下載 Cloud SQL 驗證 Proxy。

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. 以背景程序的形式執行 Cloud SQL 驗證 Proxy。將 INSTANCE_CONNECTION_NAME 改成 Cloud SQL 執行個體「總覽」頁面顯示的執行個體連線名稱。

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

注意：如要停止在背景執行 Cloud SQL 驗證 Proxy 的程序，請在啟動範例應用程式的終端機視窗中使用 fg 指令。這會將正在執行的 Cloud SQL 驗證 Proxy 工作帶到終端機前景。然後按下 Control+C 停止 Proxy 工作。

執行下列指令，在本機電腦上取得必要的 Node.js 套件，並執行範例應用程式。

1. 安裝在本機執行應用程式所需的 Node.js 套件。

   npm install

2. 執行範例應用程式。

   npm start

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的終端機視窗中按下 Control+C。

Python

執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

• CREDENTIALS_JSON_FILE，並使用 /path/to/service/account/key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

執行下列指令，將 Python 範例應用程式的需求項目下載到本機電腦，然後執行範例應用程式。

1. 初始化虛擬環境，並安裝執行範例應用程式的必要元件。

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt

2. 執行範例應用程式。

   python app.py

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的終端機視窗中按下 Control+C。

Windows

Go

執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

• CREDENTIALS_JSON_FILE，並使用 C:\Users\Your-Username\Downloads\key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

執行下列指令，在本機電腦上取得 Go 範例應用程式的依附元件，並執行範例應用程式。

1. 取得執行範例應用程式所需的依附元件。

   go get ./...

2. 執行範例應用程式。

   go run cmd\app\main.go

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的 Powershell 視窗中按下 Ctrl+C。

Java

執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

• CREDENTIALS_JSON_FILE，並使用 C:\Users\Your-Username\Downloads\key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. 執行下列指令，在本機電腦上取得 Java 範例應用程式的依附元件，並執行範例應用程式。

   mvn jetty:run

2. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

3. 如要停止範例應用程式，請在啟動範例應用程式的 Powershell 視窗中按下 Ctrl+C。

Node.js

1. 執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

   • CREDENTIALS_JSON_FILE，並使用 C:\Users\Your-Username\Downloads\key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
   • YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"

2. 下載 Cloud SQL 驗證 Proxy。

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe 
   -O cloud-sql-proxy.exe

3. 以背景程序的形式執行 Cloud SQL 驗證 Proxy。將 INSTANCE_CONNECTION_NAME 改成 Cloud SQL 執行個體「總覽」頁面顯示的執行個體連線名稱。

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

注意：如要停止在背景執行 Cloud SQL 驗證 Proxy 的程序，請選取由 Start-Process 指令產生的 cmd.exe 視窗。 關閉視窗即可停止 Proxy 工作。

執行下列指令，在本機電腦上取得必要的 Node.js 套件，並執行範例應用程式。

1. 安裝在本機執行應用程式所需的 Node.js 套件。

   npm install

2. 執行範例應用程式。

   npm start

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的 Powershell 視窗中按下 Ctrl+C。

Python

執行下列指令，初始化執行範例應用程式所需的環境變數。執行指令前，請先進行下列替換：

• CREDENTIALS_JSON_FILE，並使用 C:\Users\Your-Username\Downloads\key.json 等格式，將服務帳戶的 JSON 憑證金鑰檔案路徑提供給輔助工具。
• INSTANCE_CONNECTION_NAME 改成執行個體的連線名稱，該名稱會顯示在 Cloud SQL 執行個體的總覽頁面上。
• YOUR_DB_PASSWORD，並使用您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

執行下列指令，在本機電腦上取得 Python 範例應用程式的需求，並執行範例應用程式。

1. 初始化虛擬環境，並安裝執行範例應用程式的必要元件。

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt

2. 執行範例應用程式。

   python app.py

3. 查看執行中的範例應用程式。開啟瀏覽器視窗並前往 http://127.0.0.1:8080。

   

4. 如要停止範例應用程式，請在啟動範例應用程式的 Powershell 視窗中按下 Ctrl+C。

清除所用資源

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

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

   前往 Cloud SQL 執行個體

2. 選取 quickstart-instance 執行個體，開啟「Instance details」(執行個體詳細資料) 頁面。
3. 在頁面頂端的圖示列中，按一下 [刪除]。
4. 在「Delete instance」(刪除執行個體) 對話方塊中輸入 quickstart-instance，然後按一下「Delete」(刪除) 以刪除執行個體。

選用清除步驟

如果您未使用指派給 quickstart-service-account 服務帳戶的「Cloud SQL 用戶端」角色，可以將其移除。

1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

   前往「IAM」頁面

2. 點選名為「quickstart-service-account」的 IAM 帳戶編輯圖示 (看起來像鉛筆)。
3. 刪除 Cloud SQL 用戶端角色。
4. 按一下 [儲存]。

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

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

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

   前往 API 頁面

2. 選取要停用的 API，然後按一下「停用 API」按鈕。

後續步驟

您可以根據需求，進一步瞭解如何建立 Cloud SQL 執行個體。

您也可以瞭解如何建立 Cloud SQL 執行個體的 PostgreSQL 使用者和資料庫。

如要進一步瞭解定價，請參閱 PostgreSQL 適用的 Cloud SQL 定價。

請點選下列連結瞭解更多資訊：

• 使用公開 IP 位址設定 Cloud SQL 執行個體。
• 為 Cloud SQL 執行個體設定私人 IP 位址。

此外，您也可以瞭解如何從其他 Google Cloud 應用程式連線至 Cloud SQL 執行個體：

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