使用 Cloud SQL Auth Proxy 連線至 SQL Server 適用的 Cloud SQL

本頁面說明如何使用 Cloud SQL Auth Proxy，從本機測試環境連線至 Cloud SQL。Cloud SQL Auth Proxy 可讓您安全存取 Cloud SQL 執行個體，不需授權網路或設定 SSL。使用 Cloud SQL Auth Proxy，即可安全連線至 Cloud SQL 執行個體。

本頁的操作說明僅適用於測試環境，不應用於正式環境。如要進一步瞭解正式環境所需的設定，請參閱「在正式環境中使用 Cloud SQL Auth Proxy」和「使用 Cloud SQL Auth Proxy 連線」。

事前準備

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

    Go to project selector

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

  3. 啟用必要的 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

  4. 確認您具備下列專案角色：Cloud SQL 管理員 (roles/cloudsql.admin)

    檢查角色

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

      前往「IAM」頁面
    2. 選取專案。

    3. 在「Principal」(主體) 欄中，找出所有代表您或您所屬群組的資料列。如要瞭解您所屬的群組，請與管理員聯絡。

    4. 針對指定或包含您的所有資料列，請查看「Role」(角色) 欄，確認角色清單是否包含必要角色。

    授予角色

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

      前往「IAM」頁面
    2. 選取專案。
    3. 按一下「Grant access」(授予存取權)。

    4. 在「New principals」(新增主體) 欄位中，輸入您的使用者 ID。 這通常是指員工身分集區中使用者的 ID。詳情請參閱「在 IAM 政策中代表工作團隊集區使用者」，或聯絡管理員。

    5. 按一下「Select a role」(選取角色)，然後搜尋角色。
    6. 如要授予其他角色，請按一下「Add another role」(新增其他角色)，然後新增其他角色。
    7. 按一下「Save」(儲存)。
  5. 安裝並初始化 gcloud CLI。

建立 Cloud SQL 執行個體

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

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選「建立執行個體」。
  3. 在「Create instance」(建立執行個體) 選單中，選取「New instance」(新增執行個體)。
  4. 按一下「Choose SQL Server」(選取 SQL Server)。
  5. 在「Instance ID」(執行個體 ID) 欄位中輸入 myinstance。
  6. 在「Password」(密碼) 欄位中，輸入 sqlserver 使用者的密碼。

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

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

Debian/Ubuntu

如果是 Debian/Ubuntu，請按照這些操作說明安裝適用的 SQL Server 指令列工具。

CentOS/RHEL

如果是 CentOS/RHEL，請按照這些操作說明安裝適用的 SQL Server 指令列工具。

openSUSE

如果是 openSUSE，請按照這些操作說明安裝適用的 SQL Server 指令列工具。

其他平台

請參閱安裝 SQL Server 的到達網頁，以及 SQL Server 下載頁面。

安裝 Cloud SQL Auth Proxy 用戶端

如要瞭解如何安裝，請參閱「安裝 Cloud SQL Auth Proxy」。

取得執行個體連線名稱

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 請按一下執行個體名稱，開啟執行個體的「Overview」 (總覽) 頁面。
  3. 在「連線至這個執行個體」部分，複製「連線名稱」。連線名稱的格式為 projectID:region:instanceID。

啟動 Cloud SQL Auth Proxy

Cloud SQL Auth Proxy 會使用應用程式預設憑證 (ADC) 向 Google Cloud進行驗證。詳情請參閱「驗證 Cloud SQL Auth Proxy 的選項」。

如要使用使用者帳戶憑證驗證 Cloud SQL Auth Proxy，請執行下列指令：

gcloud auth application-default login

在專屬終端機啟動 Cloud SQL Auth Proxy，以便監控輸出內容。將 INSTANCE_CONNECTION_NAME 替換為您在上一個步驟中複製的執行個體連線名稱。

在 Linux 或 macOS 環境中，使用下列指令啟動 Cloud SQL Auth Proxy：

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

在 Windows 的 PowerShell 中，使用下列指令啟動 Cloud SQL Auth Proxy：

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

系統會顯示類似以下內容的訊息：

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

執行下列指令，並將 USER_NAME 替換為 SQL Server 使用者名稱。

sqlcmd -S 127.0.0.1 -U USER_NAME

返回啟動 Cloud SQL Auth Proxy 的終端機視窗。您應該會看到類似下列的訊息：

New connection for myInstance

清除所用資源

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

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

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

選用清除步驟

如果不需要使用在本快速入門導覽課程中啟用的 API，可以將其停用。

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

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

    前往 API 頁面

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

後續步驟