地點與平台

• 位置 — 請選擇您要部署資料庫的區域。 清單中的每個區域皆標示其支援的平台（ 第一代或第二代 ），以協助您進行選擇。
• 平台- 選擇您要部署資料庫的平台。 可選方案取決於您選擇的地區。 有關第一代與第二代之間差異的更多資訊，請參閱 《第一代與第二代概覽》。

服務詳細資料

• 服務名稱 — 名稱可以是任何字串，並用於在網頁和命令列介面 (CLI) 中識別此新部署。
• 資源群組 — 若您將服務整理成 資源群組，請在此欄位中指定該資源群組。 否則，您可以保留預設設定。 如需相關資訊，請參閱管理資源群組。

代管模式

對於第 2 代部署，僅提供「隔離式」託管模式。

隔離式： 專為複雜且需高效能的企業工作負載所設計的安全單租戶解決方案。 如需更多資訊，請參閱「託管模式」。

資源配置

精細調整您的資源配置。 請參照下表，為部署中的每個成員選擇機器規格，並指定磁碟大小。

服務配置

• 資料庫版本 [Set only at deployment] {: tag-red}- 您的資料庫的部署版本。 為確保最佳效能，請執行首選版本。 系統會自動採用最新的次版本。 如需更多資訊，請參閱《 版本控制政策 》。
• 加密 — 若您使用 Key Protect，可選擇一個實例和金鑰來加密部署的磁碟。 如果您未使用自己的金鑰，部署程序會自動建立並管理專屬的磁碟加密金鑰。
• 端點 Set only at deployment- 在您的部署中設定服務端點。 對於第 2 代，僅支援私有端點。

選取適當的設定後，請按一下「建立」以開始配置程序。

透過 CLI 建立服務實例

在進行配置之前，請依照文件中的指示安裝 IBM Cloud 命令列介面(CLI)工具。

1. 登入 IBM Cloud。 如果您使用的是聯邦式使用者 ID，請務必切換至一次性驗證碼（ibmcloud login --sso ），或使用 API 金鑰（ibmcloud login --apikey key or @key_file ）進行驗證。 如需進一步了解如何使用 CLI 登入，請參閱 ibmcloud login 中的「一般 CLI(ibmcloud)指令」。

   ibmcloud login
   

2. 請選擇您希望為資料庫配置的 託管模式。 您可以稍後進行變更。

3. 請使用以下指令為您的資料庫進行初始化：

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<Endpoint>"
   

   例如，若要配置一個採用「Databases for PostgreSQL」共享運算主機模式的實例，請使用類似以下的指令：

   ibmcloud resource service-instance-create test-database databases-for-postgresql standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "8192"}' --service-endpoints="private"
   

   請部署一個 Databases for PostgreSQL 隔離型實例，並使用相同的 "members_host_flavor" -p 參數，將其設定為所需的隔離型實例大小。 可用的主機空間大小及其 members_host_flavor value 參數列於 表 2 中。 例如，{"members_host_flavor": "b3c.4x16.encrypted"}。 請注意，由於主機規格選項已包含 CPU 和 RAM 容量（b3c.4x16.encrypted 代表 4 顆 CPU 和 16 RAM），因此此請求不接受同時選擇「隔離規格」以及分別設定 CPU 和 RAM 配額的選項。

   ibmcloud resource service-instance-create test-database databases-for-postgresql enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"
   

   該指令中的各欄位說明詳見下表。

   基本指令格式欄位

   欄位	說明	旗標
   INSTANCE_NAME Required	實例名稱可以是任何字串，這是用於在網頁和命令列介面 (CLI) 中識別新部署的名稱。
   SERVICE_NAME Required	服務的名稱或 ID。 若要存取 Databases for PostgreSQL，請使用 databases-for-postgresql。
   SERVICE_PLAN_NAME Required	標準方案（standard ）
   LOCATION Required	您要部署的位置。 若要擷取區域清單，請使用 ibmcloud regions 指令。
   RESOURCE_GROUP	資源群組名稱。 預設值為 default。	-g
   --parameters	要建立服務實例之參數的 JSON 檔案或 JSON 字串	-p
   members_host_flavor	若要配置隔離運算實例，請使用 {"members_host_flavor": "<members_host_flavor value>"}。 對於「隔離式運算」，請選擇所需的 CPU 和 RAM 配置。 如需更多資訊，請參閱下表或「託管模式」。
   members	將設定值設為 1 ，以配置單節點、非高可用性（非 HA）的編隊。 若要配置預設的高可用性編組，請省略此參數或將其設定為 2。
   --service-endpoints Required	僅支援 private。

   您將會看到類似以下的回應：

   Creating service instance INSTANCE_NAME in resource group default of account    USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-postgresql:us-south:a/   40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                        Status    create in progress
                        Message   Started create instance operation
   

   • 若要檢查配置狀態，請使用以下指令：

     ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>
     

     完成後，您將看到類似以下的回應：

     Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
     OK
     Name:                  INSTANCE_NAME
     ID:                    crn:v1:bluemix:public:databases-for-postgresql:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
     GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
     Location:              <LOCATION>
     Service Name:          databases-for-postgresql
     Service Plan Name:     standard
     Resource Group Name:   default
     State:                 active
     Type:                  service_instance
     Sub Type:              Public
     Locked:                false
     Service Endpoints:     private
     Created at:            2023-06-26T19:42:07Z
     Created by:            USER
     Updated at:            2023-06-26T19:53:25Z
     Last Operation:
                            Status    create succeeded
                            Message   Provisioning postgresql with version 12 (100%)
     

   • （可選）刪除服務實例 執行類似以下的指令來刪除一個實例：

     ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
     

members host flavor 參數

members_host_flavor 參數用於定義您的 Compute 規格。

要配置一個「隔離運算」執行個體，請指定符合您所需設定的 CPU 和 RAM 數值。

Cloud Databases 隔離運算服務不支援 CPU 和 RAM 的自動擴展，但支援磁碟的自動擴展。 透過 IBM Cloud® Monitoring 整合 功能監控您的資源，該功能可追蹤記憶體、磁碟空間及磁碟 I/O 使用狀況。 若要增加資源，請手動擴展您的部署規模。

--parameters 參數

service-instance-create 指令支援 -p 參數，此參數可將 JSON 格式的參數傳遞至配置流程。 例如，您可以將雲端資源名稱（CRN）作為參數值傳入，該名稱可唯一識別雲端中的資源。 所有參數名稱和值均以字串形式傳遞。

舉例來說，若要從某個特定備份建立資料庫，且新資料庫的部署在三個成員上總共需要 12 GB 記憶體，那麼每名成員配置 4 GB 的指令如下：

ibmcloud resource service-instance-create databases-for-postgresql <INSTANCE_NAME> standard us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "4096"
}' --service-endpoints="private"

host flavor 參數

members_host_flavor 參數用於定義您的 Compute 規格。

要配置一個「隔離運算」執行個體，請指定符合您所需設定的 CPU 和 RAM 數值。

Cloud Databases 隔離運算服務不支援 CPU 和 RAM 的自動擴展，但支援磁碟的自動擴展。 透過 IBM Cloud® Monitoring 整合 功能監控您的資源，該功能可追蹤記憶體、磁碟空間及磁碟 I/O 使用狀況。 若要增加資源，請手動擴展您的部署規模。

使用 Terraform 配置隔離的運算資源

部署一個具有相同 "host_flavor" 參數的 Databases for PostgreSQL 隔離實例，並將該參數設定為所需的隔離實例大小。 可用的主機空間大小及其 host_flavor value 參數列 於表 1 中。 例如，{"host_flavor": "b3c.4x16.encrypted"}。 請注意，由於主機規格選項已包含 CPU 和 RAM 容量（b3c.4x16.encrypted 代表 4 顆 CPU 和 16 RAM），因此此請求不接受同時選擇「隔離規格」以及分別設定 CPU 和 RAM 配額的選項。

Gen 2 並未提供預設的管理員使用者或密碼。 請使用 ibm_resource_key 建立具有「Manager」角色的服務憑證，以便在配置完成後產生資料庫憑證。

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "<region>"
  service           = "databases-for-postgresql"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  group {
    group_id = "member"
    host_flavor {
      id = "b3c.8x32.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
resource "ibm_resource_key" "this" {
  name                 = "<your_credential_name>"
  resource_instance_id = "<your_database_resource_instance_id>"
  parameters           = { "role" = "Manager" }
}

host flavor 參數

host_flavor 參數用於定義您的 Compute 規格。

隔離運算- 若要配置一個隔離運算實例，請指定符合您所需配置的 CPU 和 RAM 數值。

Cloud Databases 的「隔離運算」服務不支援 CPU 和 RAM 的自動擴展，但支援磁碟的自動擴展。 透過 IBM Cloud® Monitoring 整合 功能監控您的資源，該功能可追蹤記憶體、磁碟空間及磁碟 I/O 使用狀況。 若要增加資源，請手動擴展您的部署規模。