從 App Engine 標準環境連線至 SQL Server 適用的 Cloud SQL

從 App Engine 標準環境連線至 SQL Server 適用的 Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

瞭解如何使用 Google Cloud 控制台和用戶端應用程式，在 App Engine 標準環境中部署連結至 SQL Server 執行個體的範例應用程式。

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

事前準備

注意： 專案名稱長度必須介於 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

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.

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. 啟用必要的 Cloud API，以便在 App Engine 標準環境中執行 Cloud SQL 範例應用程式。

   控制台

   點選下方按鈕，啟用本快速入門指南所需的 API。

   啟用 API

   這會啟用下列 API：

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging API

   gcloud

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

   開啟 Cloud Shell

   使用 Cloud Shell 執行下列 gcloud 指令：

   gcloud services enable sqladmin.googleapis.com compute.googleapis.com \
   cloudbuild.googleapis.com logging.googleapis.com

   這個指令會啟用下列 API：

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging API

設定 Cloud SQL

建立 Cloud SQL 執行個體

公開 IP

App Engine 標準環境不支援透過 Unix 通訊端，經由公開 IP 連線至 SQL Server 適用的 Cloud SQL，但可以使用 Go、Java 和 Python 連接器建立連線。

控制台

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

   前往 Cloud SQL 執行個體

2. 點選「建立執行個體」。
3. 按一下「Choose SQL Server」(選取 SQL Server)。
4. 請確認執行個體的 Cloud SQL 版本為「Enterprise Plus」。
5. 在「Instance ID」(執行個體 ID) 欄位中輸入 quickstart-instance。
6. 在「Password」(密碼) 欄位中，輸入 sqlserver 使用者的密碼。請儲存這個密碼，以供日後使用。
7. 在「選擇區域和可用區供應情形」部分，選取「單一可用區」。
8. 按一下「顯示設定選項」選單。
9. 展開「機器設定」節點。
10. 在「機器類型」區域中，選取「4 個 vCPU，32 GB」類型。
11. 按一下「建立執行個體」，然後等待執行個體初始化並啟動。

gcloud

執行下列指令前，請將 DB_ROOT_PASSWORD 替換為資料庫使用者的密碼。

視需要修改下列參數的值：

• --database-version：資料庫引擎類型和版本。 如未指定，系統會使用 API 預設值。 如要查看目前可用的版本，請參閱 gcloud 資料庫版本說明文件。
• --cpu：機器中所需的核心數量。
• --memory：整數值，表示機器所需的記憶體量。請提供大小單位 (例如 3072MB 或 9GB)。如未指定單位，系統會假設您使用的是 GB。
• --region：執行個體所在的區域位置 (例如 asia-east1、us-east1)。如未指定，系統會使用預設的 us-central。

執行 gcloud sql instances create 指令，建立 Cloud SQL 執行個體。

 gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--root-password=DB_ROOT_PASSWORD

私人 IP

控制台

分配 IP 位址範圍並建立私人連線，以便設定 Cloud SQL 的私人服務存取權

1. 在 Google Cloud 控制台中，前往「VPC networks」(虛擬私有雲網路) 頁面。

   前往「VPC networks」(虛擬私有雲網路)

2. 選取 default 虛擬私有雲網路。
3. 選取 [Private service connection] (私人服務連線) 分頁標籤。
4. 選取「Allocated IP ranges for services」(已分配的服務 IP 範圍) 分頁標籤。
5. 按一下「Allocate IP range」(分配 IP 範圍)。
6. 為分配範圍的「Name」(名稱) 指定 google-managed-services-default。
7. 選取 IP 範圍的「自動」選項，並將前置字串長度指定為 16。
8. 按一下 [Allocate] (分配)，建立已分配範圍。
9. 選取 default 虛擬私有雲網路的「Private connections to services」(私人服務連線) 分頁。
10. 按一下「建立連線」，在網路與服務生產端之間建立私人連線。
11. 在「已指派的分配範圍」部分，選取「google-managed-services-default」。
12. 按一下 [Connect] (連線) 建立連線。

建立啟用 SSL 的私人 IP 位址執行個體

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

   前往 Cloud SQL 執行個體

2. 點選「建立執行個體」。
3. 按一下「Choose SQL Server」(選取 SQL Server)。
4. 請確認執行個體的 Cloud SQL 版本為「Enterprise Plus」。
5. 在「Instance ID」(執行個體 ID) 欄位中輸入 quickstart-instance。
6. 在「Password」(密碼) 欄位中，輸入 sqlserver 使用者的密碼。請儲存這個密碼，以供日後使用。
7. 在「選擇區域和可用區供應情形」部分，選取「單一可用區」。
8. 按一下「顯示設定選項」選單。
9. 展開「機器設定」節點。
10. 在「機器類型」區域中，選取「4 個 vCPU，32 GB」類型。
11. 展開「連線」節點。
12. 取消勾選「公開 IP」核取方塊，即可建立只有私人 IP 位址的執行個體。
13. 勾選「Private IP」(私人 IP) 核取方塊。
14. 從「Network」(網路) 選單中，選取「default」(預設)。
15. 按一下「建立執行個體」，然後等待執行個體初始化並啟動。
16. 按一下「連線」。
17. 在「安全性」部分，選取「僅允許 SSL 連線」即可啟用 SSL 連線。
18. 在「僅允許 SSL 連線」對話方塊中，按一下「儲存並重新啟動」，然後等待執行個體重新啟動。

gcloud

分配 IP 位址範圍並建立私人連線，以便設定 Cloud SQL 的私人服務存取權

1. 執行 gcloud compute addresses create 指令，分配 IP 位址範圍。

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. 執行 gcloud services vpc-peerings connect 指令，建立與已分配 IP 位址範圍的私人連線。將 YOUR_PROJECT_ID 替換為專案的專案 ID。

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

建立啟用 SSL 的私人 IP 位址執行個體

1. 執行下列指令前，請將 DB_ROOT_PASSWORD 替換為資料庫使用者的密碼。

視需要修改下列參數的值：

• --database-version：資料庫引擎類型和版本。 如未指定，系統會使用 API 預設值。 如要查看目前可用的版本，請參閱 gcloud 資料庫版本說明文件。
• --cpu：機器中的核心數量。
• --memory：整數值，表示要納入機器的記憶體容量。可以提供大小單位 (例如 3072MB 或 9GB)。如未指定單位，系統會假設您使用的是 GB。
• --region：執行個體所在的區域位置 (例如 asia-east1、us-east1)。如未指定，系統會使用預設的 us-central1。 查看完整區域清單。

執行 gcloud sql instances create 指令，建立使用私人 IP 位址的 Cloud SQL 執行個體。

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. 執行 gcloud sql instances patch 指令，為執行個體啟用「僅允許 SSL 連線」。

gcloud sql instances patch quickstart-instance --require-ssl

建立資料庫

控制台

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

   前往 Cloud SQL 執行個體

2. 選取「quickstart-instance」。
3. 在 SQL 導覽選單中，選取「資料庫」。
4. 按一下 [Create database] (建立資料庫)。
1. 在「New database」(新增資料庫) 對話方塊的「Database name」(資料庫名稱) 欄位中，輸入 quickstart-db。
2. 點選「建立」。

gcloud

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

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

將範例應用程式部署至 App Engine 標準環境

建立 App Engine 應用程式

在專案中建立 App Engine 應用程式。 Google Cloud 這會啟用 App Engine 服務、建立預設 App Engine 應用程式，以及建立用於連線至 Cloud SQL 的 App Engine 服務帳戶。

注意： 每個 Google Cloud 專案只需要執行這項步驟一次。

控制台

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

   前往 App Engine

2. 按一下「建立應用程式」按鈕。
3. 從「選取區域」下拉式選單中選取「us-central」。
4. 點選「下一步」。
5. 「開始使用」頁面顯示「稍後再執行」連結時，請點選該連結。

gcloud

1. 執行下列 gcloud app create 指令，建立 App Engine 應用程式：

gcloud app create

2. 系統提示您選擇 App Engine 應用程式所在的地區時，請輸入 us-central 的數字選項。

設定 App Engine 服務帳戶

設定 App Engine 使用的服務帳戶，使其具備「Cloud SQL 用戶端」角色，並擁有連線至 Cloud SQL 的權限。

控制台

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

   前往「IAM」頁面

2. 針對名為「App Engine default service account」(App Engine 預設服務帳戶) 的服務帳戶，按一下鉛筆圖示。
   注意： 服務帳戶名稱會顯示在帳戶主體旁邊。 主體的名稱為 [e-mail]。
3. 按一下 [Add another role] (新增其他角色)。
4. 新增名為「Cloud SQL Client」的角色。
5. 按一下 [儲存]。

gcloud

1. 執行下列 gcloud 指令，取得專案的服務帳戶清單：

   gcloud iam service-accounts list

2. 複製 App Engine 服務帳戶的電子郵件地址。
3. 執行下列指令，將「Cloud SQL Client」(Cloud SQL 用戶端) 角色新增至 App Engine 服務帳戶：

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

設定及部署 Cloud SQL 範例應用程式

有了 Cloud SQL 執行個體、資料庫和具備用戶端權限的服務帳戶，您現在可以設定及部署範例應用程式，連線至 Cloud SQL 執行個體。

公開 IP

App Engine 標準環境支援透過公開 IP 位址連線至 SQL Server 適用的 Cloud SQL，方法是使用 Go、Java 和 Python 連接器。

Go

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml 檔案。
6. 將 app.standard.yaml 檔案中的環境變數預留位置替換為下列值：
• 將 <PROJECT-ID> 替換為您的專案 ID。
• <INSTANCE-REGION> 替換為 us-central1。
• 將 <INSTANCE-NAME> 換成執行個體 ID，該 ID 會顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。
• <YOUR_DB_USER_NAME> 替換為 sqlserver。
• <YOUR_DB_PASSWORD>，並在建立使用者中建立 quickstart-user。
• 將 <YOUR_DB_NAME> 替換為 quickstart-db。
7. 在 Cloud Shell 命令提示字元中，於 golang-samples/cloudsql/sqlserver/database-sql 目錄執行下列 gcloud app deploy 指令，將範例應用程式部署至 App Engine 標準環境。

gcloud app deploy cmd/app/app.standard.yaml

8. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
9. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
10. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

11. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

Java

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml 檔案。
6. 將 appengine-web.xml 檔案中的環境變數預留位置替換為下列值：
• 將 project-name:region-name:instance-name 改成執行個體的連線名稱，該名稱會顯示在 Google Cloud 主控台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面上。
• my-db-user，並使用 quickstart-user。
• my-db-password，並使用您在「建立使用者」中建立的 sqlserver 密碼。
• my_db，並使用 quickstart-db。
7. 在 Cloud Shell 命令提示字元中，於 java-docs-samples/cloud-sql/sqlserver/servlet 目錄執行下列 Apache Maven mvn clean package 指令，將範例應用程式部署至 App Engine 標準環境。

mvn clean package appengine:deploy -DskipTests

8. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
9. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
10. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

11. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

Python

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml 檔案。
6. 將 app.standard.yaml 檔案中的環境變數預留位置替換為下列值：
• 將 <PROJECT-ID> 替換為您的專案 ID。
• <INSTANCE-REGION> 替換為 us-central1。
• 將 <INSTANCE-NAME> 換成執行個體 ID，該 ID 會顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。
• <YOUR_DB_USER_NAME> 替換為 sqlserver。
• <YOUR_DB_PASSWORD>，並在建立使用者中建立 quickstart-user。
• 將 <YOUR_DB_NAME> 替換為 quickstart-db。
7. 在 Cloud Shell 命令提示字元中，於 python-docs-samples/cloud-sql/sql-server/sqlalchemy 目錄執行下列 gcloud app deploy 指令，將範例應用程式部署至 App Engine 標準環境。

gcloud app deploy app.standard.yaml

8. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
9. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
10. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

11. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

私人 IP

如果是私人 IP 路徑，應用程式會透過無伺服器虛擬私有雲端存取，直接連線至執行個體。這個方法會使用 TCP Socket 直接連線至 Cloud SQL 執行個體，不需使用 Cloud SQL Auth Proxy。

Go

建立並下載 SSL 伺服器憑證

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

   前往 Cloud SQL 執行個體

2. 按一下 quickstart-instance 即可查看「總覽」頁面。
3. 按一下「連結」分頁標籤。
4. 在「安全性」部分，按一下「下載憑證」，即可下載 SSL 伺服器憑證。

建立無伺服器 VPC 連線，以便使用私人 IP 連線至執行個體

1. 在 Google Cloud 控制台中，前往「無伺服器虛擬私有雲存取」-「建立連接器」頁面。

   建立無伺服器虛擬私有雲連接器

2. 輸入 quickstart-connector 做為名稱。
3. 從「網路」下拉式選單中選取「預設」。
4. 從「子網路」下拉式選單中選取「自訂 IP 範圍」。
5. 在「IP 範圍」輸入方塊中輸入 10.8.0.0。
6. 點選「建立」。

使用 SSL 伺服器憑證建構範例應用程式

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 將 SSL 伺服器憑證檔案上傳至 certs 資料夾。
   1. 在 Cloud Shell 編輯器的 Explorer 導覽選單中，前往 golang-samples/cloudsql/sqlserver/database-sql/certs 資料夾。
   2. 在 Cloud Shell 編輯器中，對「certs」資料夾按一下滑鼠右鍵，然後選取「Upload Files」。
   3. 在本機選取下列檔案：server-ca.pem。
   4. 選取 SSL 伺服器憑證檔案後，按一下「開啟」，即可完成將檔案上傳至 Cloud Shell 編輯器的程序。
6. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml 檔案。
7. 複製下列程式碼並貼到檔案中，取代現有的檔案內容：

runtime: go116

env_variables:
  INSTANCE_CONNECTION_NAME: PROJECT-ID:INSTANCE-REGION:INSTANCE-NAME
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 1433
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. 替換下列變數：
• 將 PROJECT_ID 替換為您的專案 ID。
• INSTANCE-REGION，並以 us-central1 結尾。
• INSTANCE-NAME，請使用 Google Cloud 控制台「Cloud SQL 執行個體」頁面中顯示的執行個體 ID。
• YOUR_DB_PASSWORD，並將其替換為您在「建立使用者」中建立的 quickstart-user 密碼。
• INSTANCE_HOST，並使用 Google Cloud 控制台「Cloud SQL instances」(Cloud SQL 執行個體) 頁面中顯示的執行個體私人 IP 位址。
9. 在 Cloud Shell 命令提示字元中，於 golang-samples/cloudsql/sqlserver/database-sql 目錄執行下列 gcloud app deploy 指令，將範例應用程式部署至 App Engine 標準環境。

gcloud app deploy cmd/app/app.standard.yaml

10. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
11. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
12. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

13. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

Node.js

建立無伺服器虛擬私有雲連線，透過私人 IP 連線至執行個體

1. 在 Google Cloud 控制台中，前往「無伺服器虛擬私有雲存取」-「建立連接器」頁面。

   建立無伺服器虛擬私有雲連接器

2. 輸入 quickstart-connector 做為名稱。
3. 從「網路」下拉式選單中選取「預設」
4. 從「子網路」下拉式選單中選取「自訂 IP 範圍」
5. 在「IP 範圍」輸入方塊中輸入 10.8.0.0
6. 按一下「建立」來建立連接器。

建構範例應用程式

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml 檔案。
6. 將 app.standard.yaml 檔案中的環境變數預留位置替換為下列值：
• 將 CLOUD_SQL_INSTANCE_IP_ADDRESS 替換為執行個體的私人 IP 位址，該位址會顯示在 Google Cloud 控制台的「Cloud SQL instances」頁面中。
• 將 MY_DB_USER 替換為 quickstart-user。
• MY_DB_PASSWORD 改成您在「建立使用者」中建立的 quickstart-user 密碼。
• MY_DATABASE，並使用 quickstart-db。
• 將 <MY-PROJECT> 替換為您的專案 ID。
• <CONNECTOR_NAME>。quickstart-connector
7. 在 Cloud Shell 命令提示字元中，於 nodejs-docs-samples/cloud-sql/sqlserver/mssql 目錄執行下列 gcloud app deploy 指令，將範例應用程式部署至 App Engine 標準環境。

gcloud app deploy app.standard.yaml

8. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
9. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
10. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

11. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

Python

建立並下載 SSL 伺服器憑證

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

   前往 Cloud SQL 執行個體

2. 按一下 quickstart-instance 即可查看「總覽」頁面。
3. 按一下「連結」分頁標籤。
4. 在「安全性」部分，按一下「下載憑證」，即可下載 SSL 伺服器憑證。

建立 Serverless VPC 連線，以便使用私人 IP 連線至執行個體

1. 在 Google Cloud 控制台中，前往「無伺服器虛擬私有雲存取」-「建立連接器」頁面。

   建立無伺服器虛擬私有雲連接器

2. 輸入 quickstart-connector 做為名稱。
3. 從「網路」下拉式選單中選取「預設」。
4. 從「子網路」下拉式選單中選取「自訂 IP 範圍」。
5. 在「IP 範圍」輸入方塊中輸入 10.8.0.0。
6. 點選「建立」。

使用 SSL 伺服器憑證建構範例應用程式

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud Shell 命令提示字元中執行下列指令，啟用專案：

   gcloud config set project YOUR-PROJECT-ID

   注意：請將 YOUR-PROJECT-ID 替換為您的專案 ID。
4. 如果出現「Authorize Cloud Shell」(授權 Cloud Shell) 對話方塊，請按一下「Authorize」(授權)。
5. 將 SSL 伺服器憑證檔案上傳至 certs 資料夾。
   1. 在 Cloud Shell 編輯器的 Explorer 導覽選單中，前往 python-docs-samples/cloud-sql/sql-server/sqlalchemy/certs 資料夾。
   2. 在 Cloud Shell 編輯器中，對「certs」資料夾按一下滑鼠右鍵，然後選取「Upload Files」。
   3. 在本機電腦上選取下列檔案：server-ca.pem。
   4. 選取 SSL 伺服器憑證檔案後，按一下「開啟」，即可完成將檔案上傳至 Cloud Shell 編輯器的程序。
6. 在 Cloud Shell 編輯器的「Explorer」導覽選單中，前往並開啟 python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml 檔案。
7. 複製下列程式碼並貼到檔案中，取代現有的檔案內容：

runtime: python37
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_NAME: quickstart-db
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  INSTANCE_HOST: INSTANCE_HOST
  DB_PORT: 1433
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. 替換下列變數：
• YOUR_DB_PASSWORD，並將其替換為您在「建立使用者」中建立的 quickstart-user 密碼。
• INSTANCE_HOST，並使用 Google Cloud 控制台「Cloud SQL instances」(Cloud SQL 執行個體) 頁面中顯示的執行個體私人 IP 位址。
• 將 PROJECT_ID 替換為您的專案 ID。
9. 在 Cloud Shell 命令提示字元中，於 python-docs-samples/cloud-sql/sql-server/sqlalchemy 目錄執行下列 gcloud app deploy 指令，將範例應用程式部署至 App Engine 標準環境。

gcloud app deploy app.standard.yaml

10. 如果系統提示您選擇建立應用程式的地區，請輸入 us-central 的數字選項。
11. 系統顯示「Do you want to continue?」提示訊息時，請輸入 Y。
12. 部署指令完成後，請執行 gcloud app browse 指令：

gcloud app browse

13. 按一下產生的連結，即可查看在 App Engine 標準環境中執行的範例應用程式。這個環境已連線至 Cloud SQL。

清除所用資源

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

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

   前往 Cloud SQL 執行個體

2. 選取 quickstart-instance 執行個體，開啟「Instance details」(執行個體詳細資料) 頁面。
3. 在頁面頂端的圖示列中，按一下 [刪除]。
4. 在「Delete instance」(刪除執行個體) 對話方塊中輸入 quickstart-instance，然後按一下「Delete」(刪除) 刪除執行個體。停用應用程式後，系統就會停止執行個體的運作，並且不再處理要求。如果應用程式正在處理要求，就會先完成要求，再停用。

如要停用 App Engine 應用程式並保留資料，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Settings」(設定) 頁面：

   前往「設定」

2. 在「應用程式設定」分頁中，按一下「停用應用程式」。

3. 在「App ID」欄位中，輸入要停用的應用程式 ID，然後按一下「Disable」。

選用清除步驟

如果您未使用指派給 Compute Engine 服務帳戶的 Cloud SQL 用戶端角色，可以移除該角色。

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

   前往「IAM」頁面

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

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

• 本快速入門導覽課程中啟用的 API：
  • Compute Engine API
  • Cloud SQL Admin API
  • Cloud Run API
  • Container Registry API
  • Cloud Build API

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

   前往 API 頁面

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

後續步驟

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

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

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

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

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

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

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