建立執行個體

本頁面說明如何建立 PostgreSQL 適用的 Cloud SQL 執行個體。

如需深入瞭解所有執行個體設定,請參閱執行個體設定

建立執行個體

控制台

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

    前往 Cloud SQL 執行個體頁面

  2. 按一下 [建立執行個體]
  3. 選取 [PostgreSQL],然後點選 [下一步]
  4. 輸入名稱。

    請勿在執行個體名稱中加入敏感資訊或個人識別資訊,因為外部使用者可以看見此名稱。
    您不需要在執行個體名稱中包含專案 ID,系統會在適當地方自動加入 (例如記錄檔中)。

  5. 輸入 postgres 使用者的密碼。
  6. 在「設定選項」下,更新其他所有必要的執行個體設定:

    設定 附註
    資料庫版本
    資料庫版本 PostgreSQL 9.6 (預設)
    PostgreSQL 11.1 Beta 版
    連線
    私人 IP 設定執行個體的私人 IP 連線。 瞭解詳情
    公開 IP 新增執行個體的公開 IPv4 位址。 瞭解詳情
    機器類型和儲存空間
    核心數 執行個體的 vCPU 數量。 瞭解詳情
    記憶體 執行個體的記憶體量,以 GiBs 為單位。 瞭解詳情
    儲存空間類型 決定您的執行個體使用 SSD 還是 HDD 儲存空間。 瞭解詳情
    儲存空間容量 佈建供執行個體使用的儲存空間量。 瞭解詳情
    自動增加儲存空間 決定 Cloud SQL 是否會在可用空間不足時,自動提供更多儲存空間供執行個體使用。 瞭解詳情
    自動備份及高可用性
    高可用性 如果您需要將執行個體設定成高可用性,必須選擇 [高可用性 (地區性)] 選項。 瞭解詳情
    自動備份 希望備份啟動的期間。 瞭解詳情
    已授權的網路
    資料庫標記
    資料庫標記 您可以使用資料庫標記控制執行個體的設定和參數。 瞭解詳情
    維護時間表
    維護期間 決定 Cloud SQL 可對執行個體執行中斷型維修的 1 小時期間。如果沒有設定期間,則表示可以隨時執行中斷型維修。 瞭解詳情
    維護時間 相對於同一專案中的其他執行個體,您偏好的執行個體更新時間。 瞭解詳情
  7. 按一下 [建立]
  8. 執行個體完成初始化程序後,點選執行個體名稱即可開啟執行個體。

gcloud

如要瞭解如何安裝及開始使用 gcloud 指令列工具,請參閱安裝 Cloud SDK。如要瞭解如何啟動 Cloud Shell,請參閱 Cloud Shell 說明文件

  1. 建立執行個體:
    gcloud sql instances create [INSTANCE_NAME] --database-version=POSTGRES_9_6 \
           --cpu=[NUMBER_CPUS] --memory=[MEMORY_SIZE]
    

    請勿在執行個體名稱中加入敏感資訊或個人識別資訊,因為外部使用者可以看見此名稱。
    您不需要在執行個體名稱中包含專案 ID,系統會在適當地方自動加入 (例如記錄檔中)。

    vCPU 數量與記憶體大小的值均受到限制:

    • vCPU 必須是 1,或介於 2 到 32 之間的偶數。
    • 記憶體必須符合下列條件:
      • 每個 vCPU 有 0.9 到 6.5 GiB 的記憶體
      • 必須是 256 MiB 的倍數
      • 至少要有 3.75 GiB (3840 MiB)

    例如,下列字串會建立一個執行個體,搭載兩個 vCPU 及 7,680 MiB 的記憶體:

     gcloud sql instances create myinstance --cpu=2 --memory=7680MiB \
            --database-version=POSTGRES_9_6
    

    如需一些關於值的範例,請參閱機器類型範例

    您也可以捨棄 --cpu--memory 參數,使用 --tier db-f1-micro--tier db-g1-small 建立共用核心執行個體。

    您可以加入更多參數來決定其他的執行個體設定:

    設定 參數 說明
    必要參數
    資料庫版本 --database-version POSTGRES_9_6 (預設)
    POSTGRES_11_1
    地區 --region 請參閱有效值
    連線
    私人 IP --network 指定您要用於此執行個體的虛擬私人雲端網路名稱。必須已針對網路設定私人服務存取權。僅適用於測試版指令 (gcloud beta sql instances create)。 瞭解詳情
    公開 IP --authorized-networks 針對 IP 連線,只有透過已授權網路的連線可以連接您的執行個體。 瞭解詳情
    機器類型和儲存空間
    機器類型 --tier 用來指定共用核心執行個體 (db-f1-microdb-g1-small)。使用這個參數就不能指定 --cpu--memory 參數。
    儲存空間類型 --storage-type 決定您的執行個體使用 SSD 還是 HDD 儲存空間。 瞭解詳情
    儲存空間容量 --storage-size 佈建用於執行個體的儲存空間量,以 GB 為單位。瞭解詳情
    自動增加儲存空間 --storage-auto-increase 決定 Cloud SQL 是否會在可用空間不足時,自動提供更多儲存空間供執行個體使用。 瞭解詳情
    自動增加儲存空間上限 --storage-auto-increase-limit 決定 Cloud SQL 自動增加儲存空間的上限量。僅適用於測試版指令 (gcloud beta sql instances create)。 瞭解詳情
    自動備份及高可用性
    高可用性 --availability-type 如果為可用性高的執行個體,請設為 REGIONAL瞭解詳情
    自動備份 --backup-start-time 希望備份啟動的期間。 瞭解詳情
    新增資料庫標記
    資料庫標記 --database-flags 您可以使用資料庫標記控制執行個體的設定和參數。 進一步瞭解資料庫標記深入瞭解如何設定此參數的格式
    設定維護時間表
    維護期間 --maintenance-window-day
    --maintenance-window-hour
    決定 Cloud SQL 可對執行個體執行中斷型維修的 1 小時期間。如果沒有設定期間,則表示可以隨時執行中斷型維修。 瞭解詳情
    維護時間 --maintenance-release-channel 相對於同一專案中的其他執行個體,您偏好的執行個體更新時間。使用 preview 表示較早更新;使用 production 表示較晚更新。 瞭解詳情
  2. 請記下系統自動指派的 IP 位址。

    如果您不是使用 Cloud SQL Proxy,則要使用這個位址作為主機位址,以便應用程式或工具用來連接執行個體。

  3. 設定 postgres 使用者的密碼:
    gcloud sql users set-password postgres no-host --instance=[INSTANCE_NAME] \
           --password=[PASSWORD]
    

cURL

  1. 建立執行個體:
    ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data '{"name":"[INSTANCE_NAME]", "region":"[REGION]",
                  "databaseVersion": "POSTGRES_9_6",
                  "settings": {"tier": "[TIER_STRING]",
                  "backupConfiguration": {"enabled":true}}}' \
         -X POST \
         https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances
    

    請勿在執行個體名稱中加入敏感資訊或個人識別資訊,因為外部使用者可以看見此名稱。
    您不需要在執行個體名稱中包含專案 ID,系統會在適當地方自動加入 (例如記錄檔中)。

    TIER_STRING 是一個字串,代表您要讓新執行個體搭載的 CPU 數量與記憶體量。此字串的格式如下:db-custom-[CPUS]-[MEMORY_MBS]。如需一些有效值的範例,請參閱機器類型範例。您也可以在 tier 參數中提供 db-f1-microdb-g1-small,以建立共用核心執行個體。

    如需這個呼叫的完整參數清單,請參閱 Instances:insert 頁面。如需瞭解執行個體設定的相關資訊,包含區域和機器類型的有效值,請參閱執行個體設定

  2. 執行個體完成初始化時,請更新 postgres 使用者的密碼:
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data '{"name": "postgres", "host": "", "password": "[PASSWORD]"}' \
         -X PUT \
         'https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users?host=&name=postgres'
    
  3. 擷取系統自動指派給新執行個體的 IPv4 位址:
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         -X GET \
         https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]
    
    找出回應中的 ipAddress 欄位。

機器類型範例

使用自訂機器類型,您可以設定執行個體所需的記憶體和 CPU 數量。但系統對這些值設有一些限制:

  • vCPU 必須是 1,或介於 2 到 32 之間的偶數。
  • 記憶體必須符合下列條件:
    • 每個 vCPU 有 0.9 到 6.5 GiB 的記憶體
    • 必須是 256 MiB 的倍數
    • 至少要有 3.75 GiB (3840 MiB)

以下依據 MySQL 執行個體適用的預先定義機器類型,提供一些機器類型值的範例:

預先定義的機器類型 vCPU 記憶體 (MiBs) API 級別字串
db-n1-standard-1 1 3840 db-custom-1-3840
db-n1-standard-2 2 7680 db-custom-2-7680
db-n1-standard-4 4 15360 db-custom-4-15360
db-n1-standard-8 8 30720 db-custom-8-30720
db-n1-standard-16 16 61440 db-custom-16-61440
db-n1-standard-32 32 122880 db-custom-32-122880
db-n1-standard-64 64 245760 db-custom-64-245760
db-n1-highmem-2 2 13312 db-custom-2-13312
db-n1-highmem-4 4 26624 db-custom-4-26624
db-n1-highmem-8 8 53248 db-custom-8-53248
db-n1-highmem-16 16 106496 db-custom-16-106496
db-n1-highmem-32 32 212992 db-custom-32-212992
db-n1-highmem-64 64 425984 db-custom-64-425984

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
PostgreSQL 適用的 Cloud SQL