設定 Cloud SQL (PostgreSQL) 執行個體

Application Design Center 可讓您設定 PostgreSQL 適用的 Cloud SQL 的連線和執行個體設定。PostgreSQL 適用的 Cloud SQL 是全代管服務,用於執行 PostgreSQL 關聯式資料庫。可設定的參數是以 GitHub 上的 terraform-google-sql-db Terraform 模組為基礎。

元件連線

下表列出可連結至 Cloud SQL (PostgreSQL) 執行個體的元件,以及應用程式和產生的 Terraform 程式碼會有哪些更新。

已連結的元件 應用程式更新 背景資訊

Compute Engine 執行個體範本

  • Compute Engine 執行個體可以連線至 Cloud SQL (PostgreSQL) 執行個體,並讀取及寫入資料。
  • Cloud SQL 連線中繼資料已新增至 Compute Engine 執行個體範本。
  • roles/cloudsql.instanceUser 和 roles/cloudsql.client 角色會授予 Compute Engine 執行個體範本服務帳戶。
  • Compute Engine 服務帳戶會新增為 Cloud SQL 執行個體的 Identity and Access Management (IAM) 使用者。
從 Compute Engine 連線
Secret Manager
  • Secret Manager 的「Secret Data」(密鑰資料) 欄位包含預設使用者的密碼。
使用 Secret Manager 處理 Cloud SQL 中的密鑰

服務帳戶

  • 服務帳戶可以連線至 Cloud SQL (PostgreSQL) 執行個體。
  • 服務帳戶會取得 roles/cloudsql.instanceUser 和 roles/cloudsql.client 角色。
  • 服務帳戶 IAM 資訊已新增至 Cloud SQL 執行個體。
角色和權限

Cloud Run

  • Cloud Run 服務可以讀取 Cloud SQL (PostgreSQL) 執行個體中的資料,以及將資料寫入該執行個體。
  • Cloud SQL 連線中繼資料會新增至 Cloud Run 服務。
  • roles/cloudsql.instanceUser 和 roles/cloudsql.client 角色會授予 Cloud Run 服務帳戶。
  • Cloud Run 服務帳戶會以 IAM 使用者的身分,新增至 Cloud SQL 執行個體。
從 Cloud Run 連線

必要設定參數

如果範本包含 Cloud SQL (PostgreSQL) 元件,您必須先設定下列參數,才能部署。

參數名稱 說明和限制資訊 背景資訊

專案 ID

要部署 Cloud SQL 資源的專案。

設定元件

名稱

name 建立 PostgreSQL 執行個體

資料庫版本

databaseVersion 建立 PostgreSQL 執行個體

區域

region 管理執行個體位置

選用設定參數

以下為選用參數。如要顯示進階參數,請在「Configuration」(設定) 區域中選取「Show advanced fields」(顯示進階欄位)。

功能 參數名稱 說明和限制資訊 背景資訊

可用區

gceZone 管理執行個體位置

版本

edition PostgreSQL 適用的 Cloud SQL 版本簡介

供應情形類型

availabilityType Cloud SQL 的可用性

啟用預設資料庫

如果選取,請建立預設資料庫。在「Db Name」(資料庫名稱) 欄位中,輸入預設資料庫的名稱。

在 Cloud SQL 執行個體上建立資料庫

啟用預設使用者

如果選取,請建立預設使用者。輸入預設使用者的使用者名稱和使用者密碼。

預設 PostgreSQL 使用者

根密碼

rootPassword

建立執行個體時的初始根密碼。

資料庫刪除政策

如要允許捨棄資料庫,而非刪除,請輸入 ABANDON。

如果 cloudsqlsuperuser 以外的使用者有權存取 PostgreSQL 資料庫,則無法刪除該資料庫。

已啟用資料快取

資料快取 資料快取總覽

機型

為執行個體選取機器系列和類型。所選選項會決定可用的儲存空間類型和設定選項。執行個體建立後,即無法變更機器系列。

機器系列總覽
自動調整磁碟大小

磁碟自動調整大小

storageAutoResize 啟用自動增加儲存空間
自動調整磁碟大小

磁碟自動調整大小上限

storageAutoResizeLimit 自動增加儲存空間上限

磁碟大小

dataDiskSizeGb 「儲存空間容量」

磁碟類型

dataDiskType 「儲存空間類型」

定價方案

pricingPlan SqlPricingPlan
備份設定

已啟用

enabled 建立 PostgreSQL 執行個體
備份設定

開始時間

startTime

建立 PostgreSQL 執行個體
備份設定

區域

location 自訂備份位置
備份設定

可用區

location 自訂備份位置
備份設定

已啟用時間點復原功能

pointInTimeRecoveryEnabled 執行時間點復原 (PITR)
備份設定

交易記錄保留天數

transactionLogRetentionDays 記錄保留期限
備份設定

保留的備份

retainedBackups 備份保留
備份設定

保留期限單位

retentionUnit 備份保留
IP 設定

授權網路金鑰

authorizedNetworks[] 使用已獲授權的網路進行授權
IP 設定

授權網路值

authorizedNetworks[] 使用已獲授權的網路進行授權
IP 設定

已啟用 IPv4

ipv4Enabled 設定公開 IP
IP 設定

私人網路

privateNetwork 私人 IP 設定選項
IP 設定

SSL 模式

sslMode SSL 模式
IP 設定

分配 IP 範圍

allocatedIpRange 分配給服務的 IP 位址範圍
IP 設定

啟用 Google Cloud 服務的私人路徑

Google Cloud 服務的私人路徑 建立支援私人服務存取權和 Private Service Connect 的執行個體
IP 設定

已啟用 PSC

pscEnabled Private Service Connect 總覽
IP 設定

PSC 允許的用戶專案

allowedConsumerProjects[] 建立支援私人服務存取權和 Private Service Connect 的執行個體

維護版本

maintenanceVersion 自助式維護

防刪除功能

如果選取,就無法刪除 Cloud SQL 執行個體。 防止刪除執行個體
資料庫旗標

名稱

databaseFlags 設定資料庫旗標
資料庫旗標

值

databaseFlags 設定資料庫旗標

使用者刪除政策

如要允許捨棄使用者而非刪除,請輸入 ABANDON。

如果 PostgreSQL 使用者已獲派 SQL 角色,就無法刪除。

其他使用者

名稱

name PostgreSQL 使用者和角色簡介
其他使用者

密碼

輸入密碼,或選取「隨機密碼」來產生密碼。

PostgreSQL 使用者和角色簡介
其他資料庫

名稱

name 建立及管理資料庫
其他資料庫

定序

collation 建立及管理資料庫

主要執行個體名稱

masterInstanceName 建立唯讀副本

執行個體類型

instanceType SqlInstanceType

隨機執行個體名稱

在執行個體名稱結尾加上隨機後置字串。

random_instance_name

次要可用區

副本執行個體的偏好可用區。

secondaryZone

追蹤 GAE 應用程式

要追蹤的 App Engine 應用程式。必須與 Cloud SQL 執行個體位於相同區域。

followGaeApplication

啟用政策

activationPolicy 啟用政策

已啟用防刪除功能

deletionProtectionEnabled 防止刪除執行個體

已啟用唯讀副本防刪除功能

如要禁止 Terraform 刪除副本 SQL 執行個體,請勾選核取方塊。

考慮為唯讀副本啟用防刪除功能
維護期間

維護期間日期

天 Cloud SQL 執行個體維護作業
維護期間

維護期間小時

hour Cloud SQL 執行個體維護作業
維護期間

維護期間更新發布群組

updateTrack Cloud SQL 執行個體維護作業
使用者標籤

金鑰

Cloud SQL 執行個體的主要標籤。

userLabels
使用者標籤

值

Cloud SQL 執行個體的值標籤。

userLabels
拒絕維護期

結束日期

endDate 設定拒絕維護期
拒絕維護期

開始日期

startDate 設定拒絕維護期
拒絕維護期

時間

time 設定拒絕維護期
洞察設定

每分鐘查詢計畫數

queryPlansPerMinute 使用查詢洞察提高查詢效能
洞察設定

查詢字串長度

queryStringLength 使用查詢洞察提高查詢效能
洞察設定

記錄應用程式標記

recordApplicationTags 啟用查詢洞察
洞察設定

記錄用戶端位址

recordClientAddress 啟用查詢洞察
密碼驗證政策設定

長度最小值

minLength 設定密碼政策
密碼驗證政策設定

複雜度

複雜度 設定密碼政策
密碼驗證政策設定

重複使用間隔

reuseInterval 設定密碼政策
密碼驗證政策設定

不允許使用者名稱子字串

disallowUsernameSubstring 設定密碼政策
密碼驗證政策設定

密碼變更間隔

passwordChangeInterval 設定密碼政策
唯讀備用資源

名稱

read_replicas 唯讀副本
唯讀備用資源

名稱覆寫值

用於覆寫預設唯讀副本名稱的字串。 read_replicas

唯讀副本名稱後置字串

要新增至讀取執行個體名稱的後置字串 (選用)。

唯讀副本

DB Charset

charset 在 Cloud SQL 執行個體上建立資料庫

資料庫定序

collation 在 Cloud SQL 執行個體上建立資料庫
IAM 使用者

ID

IAM 使用者的 ID。

IAM 驗證
IAM 使用者

電子郵件

IAM 使用者的電子郵件地址。

將個別 IAM 使用者或服務帳戶新增至 Cloud SQL 執行個體
IAM 使用者

類型

type 將個別 IAM 使用者或服務帳戶新增至 Cloud SQL 執行個體

建立逾時

選用逾時設定,用於限制長時間的資料庫建立作業。

create_timeout

更新逾時

選用的逾時設定,用於限制長時間的資料庫更新。

update_timeout

刪除逾時

選用的逾時設定,用於限制長時間的資料庫刪除作業。

delete_timeout

加密金鑰名稱

encryption_key_name 關於客戶自行管理的加密金鑰 (CMEK)

唯讀副本防刪除功能

如果選取,Terraform 就無法刪除 SQL 副本執行個體。

deletion_protection

啟用隨機密碼特殊字元

如果選取,隨機產生的密碼會包含特殊字元。

enable_random_password_special

連接器強制執行

connectorEnforcement Cloud SQL 語言連接器總覽

啟用 Google 機器學習整合功能

enable_google_ml_integration 使用 Cloud SQL 建構生成式 AI 應用程式

資料庫整合角色

預設資料庫執行個體服務帳戶所需的角色,用於與 Google Cloud 服務整合。

事前準備