設定公開 IP

本頁面說明如何設定 Cloud SQL 執行個體的公開 IP 連線。

簡介

您可以設定 Cloud SQL 執行個體擁有公開 IPv4 位址，並將授權位址加入執行個體，以接受來自特定 IP 位址或位址範圍的連線。

您無法將私人網路 (例如 10.x.x.x) 指定為已授權網路。

PostgreSQL 執行個體的公開 IP 位址：

  • IPv6：執行個體不支援 IPv6。
  • IPv4：系統會自動指派靜態 IPv4 位址給執行個體。只要您的執行個體關閉 (停用)，就會收取少許 IP 位址的費用。

如需透過 IP 連線將管理用戶端連線至執行個體的說明，請參閱使用 IP 位址連結 psql 用戶端。

如果將執行個體設定為接受使用公開 IP 位址的連線，請一併將這個執行個體設定為使用 SSL，以保護資料安全。如需詳細資訊，請參閱為執行個體設定安全資料傳輸層 (SSL) 的說明。

如要使用未暴露於公開網際網路的 IP 位址來設定執行個體，請參閱設定私人 IP 連線。

啟用公開 IP 並加入授權位址或位址範圍

當您為執行個體啟用公開 IP 時，Cloud SQL 會使用公開的靜態 IPv4 位址設定執行個體。啟用公開 IP 後，您必須設定資料庫連線的授權。詳情請參閱「授權選項」。

如果您使用共用憑證授權單位 (CA) 或客戶管理的 CA 做為執行個體的 serverCaMode，則在為執行個體啟用公開 IP 時，執行個體必須重新啟動。如要進一步瞭解伺服器 CA 模式設定，請參閱「憑證授權單位 (CA) 權威機構」。

如要啟用公開 IP 並加入授權位址，請執行下列操作：

控制台

  1. 前往 Trusted Cloud 控制台的「Cloud SQL 執行個體」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 在 SQL 導覽選單中，選取「連結」。
  4. 按一下 [網路] 分頁標籤。
  5. 選取 [公開 IP] 核取方塊。
  6. 按一下 [新增網路]。
  7. 您可以選擇在「名稱」欄位中輸入網路名稱。
  8. 在「Network」欄位中，輸入要允許連線的 IP 位址或位址範圍。

    使用 CIDR 標記法。

  9. 按一下 [完成]。
  10. 按一下 [儲存]。

gcloud

  1. 如果您尚未將 IPv4 位址加入執行個體，請執行下列操作：
    gcloud sql instances patch INSTANCE_NAME\
--assign-ip
  2. 透過描述執行個體來顯示所有現有的授權位址：
    gcloud sql instances describe INSTANCE_NAME

    在 [ipConfiguration] 下尋找 [authorizedNetwork] 項目，並記下您要保留的任何授權位址。

  3. 更新授權網路清單，加入所有要納入的地址。
    gcloud sql instances patch INSTANCE_NAME \
--authorized-networks=IP_ADDR1,IP_ADDR2...

    使用 CIDR 標記法。

  4. 確認變更：
    gcloud sql instances describe INSTANCE_NAME

REST v1

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體，包括要在執行個體中設定的「所有」位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • network_range_1 已授權的 IP 位址或範圍
    • network_range_2 另一個授權 IP 位址或範圍

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks":
        [{"value": "network_range_1"}, {"value": "network_range_2"}]
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

    使用 CIDR 標記法。

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

Terraform

如要啟用公開 IP 並加入授權位址或位址範圍，請使用 Terraform 資源。 

resource "google_sql_database_instance" "postgres_public_ip_instance_name" {
  database_version = "POSTGRES_14"
  name             = "postgres-public-ip-instance-name"
  region           = "asia-southeast2"
  settings {
    availability_type = "ZONAL"
    ip_configuration {
      # Add optional authorized networks
      # Update to match the customer's networks
      authorized_networks {
        name  = "test-net-3"
        value = "203.0.113.0/24"
      }
      # Enable public IP
      ipv4_enabled = true
    }
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

套用變更

如要在 Trusted Cloud 專案中套用 Terraform 設定，請完成下列各節中的步驟。

準備 Cloud Shell

  1. 啟動 Cloud Shell。

  2. 設定要套用 Terraform 設定的預設 Trusted Cloud 專案。

    您只需為每個專案執行這個指令一次，而且可以在任何目錄中執行。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 設定檔中設定明確的值，系統就會覆寫環境變數。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

  1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱必須包含 .tf 副檔名，例如 main.tf。在本教學課程中，檔案稱為 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. 如果您正在參考教學課程，可以複製各個章節或步驟中的程式碼範例。

    將範例程式碼複製到新建立的 main.tf 中。

    您可以視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您採用這種做法。

  3. 查看並修改要套用至環境的範例參數。
  4. 儲存變更。
  5. 初始化 Terraform。這項操作只需對每個目錄執行一次。 
    terraform init

    如要使用最新版的 Google 供應器，請視需要加入 -upgrade 選項：

    terraform init -upgrade

套用變更

  1. 檢查設定，並確認 Terraform 要建立或更新的資源是否符合您的預期：
    terraform plan

    視需要修正設定。

  2. 執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：
    terraform apply

    等待 Terraform 顯示「Apply complete!」(套用完成) 訊息。

  3. 開啟 Trusted Cloud 專案即可查看結果。在 Trusted Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

刪除變更

如要刪除變更，請按照下列步驟操作：

  1. 如要停用防刪除功能，請在 Terraform 設定檔中將 deletion_protection 引數設為 false。
    deletion_protection =  "false"
  2. 執行下列指令，並在提示中輸入 yes，即可套用更新的 Terraform 設定：
    terraform apply

  1. 如要移除先前透過 Terraform 設定套用的資源，請執行下列指令，並在提示中輸入 yes：

    terraform destroy

REST v1beta4

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體，包括要在執行個體中設定的「所有」位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • network_range_1 已授權的 IP 位址或範圍
    • network_range_2 另一個授權 IP 位址或範圍

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks":
        [{"value": "network_range_1"}, {"value": "network_range_2"}]
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

    使用 CIDR 標記法。

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

移除授權的位址或位址範圍

移除授權的位址：

控制台

  1. 前往 Trusted Cloud 控制台的「Cloud SQL 執行個體」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 在 SQL 導覽選單中選取「Connections」。
  4. 找出要刪除的位址，然後按一下相對應的刪除圖示 。。
  5. 按一下 [Save] (儲存) 以更新執行個體。

gcloud

  1. 透過描述執行個體來顯示所有現有的授權位址：
    gcloud sql instances describe INSTANCE_NAME

    在 [ipConfiguration] 下尋找 [authorizedNetwork] 項目，並記下您要保留的任何授權位址。

  2. 更新授權網路清單，移除所有要移除的地址。
    gcloud sql instances patch INSTANCE_NAME \
--authorized-networks=IP_ADDR1,IP_ADDR2...
  3. 確認變更：
    gcloud sql instances describe INSTANCE_NAME

REST v1

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體，方法是加入要保留的所有地址，並刪除要移除的所有地址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • network_range_1 要移除的授權 IP 位址或網路範圍

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks":
        [{"value": "network_range_1"}]
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address：IP 位址的 CIDR 格式
    • ip-address-name：IP 位址名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

REST v1beta4

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體，方法是加入要保留的所有地址，並刪除要移除的所有地址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • network_range_1 要移除的授權 IP 位址或網路範圍

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks":
        [{"value": "network_range_1"}]
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address：IP 位址的 CIDR 格式
    • ip-address-name：IP 位址名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

設定執行個體以拒絕所有公開 IP 連線

要設定執行個體以拒絕所有公開 IP 連線：

控制台

  1. 前往 Trusted Cloud 控制台的「Cloud SQL 執行個體」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 在 SQL 導覽選單中選取「Connections」。
  4. 按一下所有已授權位址的刪除圖示 。。
  5. 按一下 [Save] (儲存) 以更新執行個體。

gcloud

  1. 清除授權的位址清單：
    gcloud sql instances patch INSTANCE_NAME \
--clear-authorized-networks
  2. 確認變更：
    gcloud sql instances describe INSTANCE_NAME

REST v1

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新含有空白位址清單的執行個體：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks": []
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

REST v1beta4

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新含有空白位址清單的執行個體：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID

    HTTP 方法和網址：

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON 要求主體：

    {
  "settings":
  {
    "ipConfiguration":
    {
      "authorizedNetworks": []
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

停用公開 IP

您可以停用公開 IP，但前提是執行個體也已設定為使用私人 IP。如要啟用私人 IP，請參閱「將現有執行個體設定為使用私人 IP」。

如果您使用共用憑證授權單位 (CA) 或客戶管理的 CA 做為執行個體的 serverCaMode，則在停用執行個體的公開 IP 時，執行個體必須重新啟動。如要進一步瞭解伺服器 CA 模式設定，請參閱「憑證授權單位 (CA) 權威機構」。

要停用公開 IP：

控制台

  1. 前往 Trusted Cloud 控制台的「Cloud SQL 執行個體」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 在 SQL 導覽選單中選取「Connections」。
  4. 取消勾選「Public IP」(公開 IP) 核取方塊。
  5. 按一下 [Save] (儲存) 以更新執行個體。

gcloud

  1. 更新執行個體：
    gcloud sql instances patch INSTANCE_NAME \
--no-assign-ip
  2. 確認變更：
    gcloud sql instances describe INSTANCE_NAME

REST v1

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體：

    使用任何要求資料之前，請先替換以下項目：

    • PROJECT_ID: 專案 ID
    • INSTANCE_ID: 執行個體 ID
    • VPC_NETWORK_NAME: 指定要用於此執行個體的虛擬私有雲 (VPC) 網路名稱。必須已針對網路設定私人服務存取權。
    • RANGE_NAME: 選填。如果指定，則會設定 IP 範圍的範圍名稱。範圍名稱必須符合 RFC-1035 的規範，且長度介於 1 至 63 個半形字元之間。
    • AUTHORIZED_NETWORKS: 針對公開 IP 連線，請指定可連線至執行個體的授權網路連線。

    如果執行個體使用公開 IP 位址，請將 ipv4Enabled 參數的值設為 true；如果執行個體有私人 IP 位址，則設為 false。

    如果將 enablePrivatePathForGoogleCloudServices 參數設為 true，即可允許 BigQuery 等其他 Trusted Cloud by S3NS 服務存取 Cloud SQL 中的資料，並透過私人 IP 連線查詢這類資料。將這個參數設為 false 後，其他 Trusted Cloud by S3NS 服務就無法透過私人 IP 連線存取 Cloud SQL 中的資料。

    HTTP 方法和網址：

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

    JSON 要求主體：

    {
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

REST v1beta4

  1. 描述執行個體，即可顯示所有現有的授權位址：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • ip-address1：第一個 IP 位址的 CIDR 格式
    • ip-address-name1：第一個 IP 位址的名稱
    • ip-address2：第二個 IP 位址的 CIDR 格式
    • ip-address-name2：第二個 IP 位址的名稱
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  2. 更新執行個體：

    使用任何要求資料之前，請先替換以下項目：

    • PROJECT_ID: 專案 ID
    • INSTANCE_ID: 執行個體 ID
    • VPC_NETWORK_NAME: 指定要用於此執行個體的虛擬私有雲 (VPC) 網路名稱。必須已針對網路設定私人服務存取權。
    • RANGE_NAME: 選填。如果指定，則會設定 IP 範圍的範圍名稱。範圍名稱必須符合 RFC-1035 的規範，且長度介於 1 至 63 個半形字元之間。
    • AUTHORIZED_NETWORKS: 針對公開 IP 連線，請指定可連線至執行個體的授權網路連線。

    如果執行個體使用公開 IP 位址，請將 ipv4Enabled 參數的值設為 true；如果執行個體有私人 IP 位址，則設為 false。

    如果將 enablePrivatePathForGoogleCloudServices 參數設為 true，即可允許 BigQuery 等其他 Trusted Cloud by S3NS 服務存取 Cloud SQL 中的資料，並透過私人 IP 連線查詢這類資料。將這個參數設為 false 後，其他 Trusted Cloud by S3NS 服務就無法透過私人 IP 連線存取 Cloud SQL 中的資料。

    HTTP 方法和網址：

    POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

    JSON 要求主體：

    {
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

  3. 確認變更：

    使用任何要求資料之前，請先替換以下項目：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • machine-type 執行個體機器類型
    • zone 執行個體區域

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    如要傳送要求，請展開以下其中一個選項：

    您應該會收到如下的 JSON 回應：

疑難排解

問題 疑難排解
Aborted connection。 問題可能為：
  • 網路不穩定。
  • 對 TCP 保活指令沒有回應 (用戶端或伺服器沒有回應，可能已超載)
  • 資料庫引擎連線逾時，因此伺服器會終止連線。

應用程式必須能容許網路失敗，並遵循最佳做法，例如連線集區和重試。大多數連線集區會盡可能擷取這些錯誤。否則，應用程式必須重新嘗試或優雅失敗。

針對連線重試，我們建議採用下列方法：

  1. 指數輪詢。每次重試之間的時間間隔會以指數方式增加。
  2. 也新增隨機退避。

結合這些方法有助於減少頻寬限制。
Certificate verify failed。

用戶端憑證已過期，或憑證路徑不正確。

重新建立憑證。
FATAL: database 'user' does not exist。 gcloud sql connect --user 僅適用於預設 postgres 使用者。

連線至預設使用者，然後變更使用者。
您想找出與誰連線。 登入資料庫並執行下列指令： 

SELECT datname,
usename,
application_name as appname,
client_addr,
state,
now() - backend_start as conn_age,
now() - state_change as last_activity_age
FROM pg_stat_activity
WHERE backend_type = 'client backend'
ORDER BY 6 DESC
LIMIT 20

Hostname/IP does not match certificate's altnames: Host: localhost. is not in the cert's altnames。

主機位址與伺服器憑證的替代名稱中的位址不符。

如果您使用 Node.js 搭配 verify-full 或同等工具，請使用 DNS 名稱做為 servername 參數。使用 openssl 即可在伺服器憑證中找到 DNS 名稱。例如：openssl x509 -in server-cert.pem -noout -text |grep 'DNS:'。

 ssl: {
  rejectUnauthorized: true,
  ca: fs.readFileSync("/path/to/server/CA"),
  servername: 'N-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx.us-central1.sql.goog'
}

後續步驟