設定 Cloud SQL (PostgreSQL) 執行個體

您可以使用應用程式設計中心，設定 PostgreSQL 適用的 Cloud SQL 連線和執行個體設定。這項全代管服務可用於執行 PostgreSQL 關聯式資料庫。可設定的參數是以 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 執行個體的 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 服務帳戶會新增為 Cloud SQL 執行個體的 IAM 使用者。	從 Cloud Run 連線

必要設定參數

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

參數名稱	說明和限制資訊	背景資訊
專案 ID	要部署 Cloud SQL 資源的專案。	設定元件
名稱	name	建立 PostgreSQL 執行個體
資料庫版本	databaseVersion	建立 PostgreSQL 執行個體
區域	region	管理執行個體位置

選用設定參數

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

功能	參數名稱	說明和限制資訊	背景資訊
	可用區	gceZone	管理執行個體位置
	版本	edition	edition
	供應情形類型	availabilityType	Cloud SQL 的可用性
	啟用預設資料庫	如果選取，請建立預設資料庫。在「Db Name」(資料庫名稱) 欄位中，輸入預設資料庫的名稱。	在 Cloud SQL 執行個體上建立資料庫
	啟用預設使用者	如果選取，請建立預設使用者。輸入預設使用者的使用者名稱和使用者密碼。	預設 PostgreSQL 使用者
	根密碼	rootPassword	建立執行個體時的初始根密碼。
	資料庫刪除政策	如要捨棄資料庫而非刪除，請輸入 ABANDON。	如果 cloudsqlsuperuser 以外的使用者具有存取權，則無法刪除 PostgreSQL 資料庫。
	已啟用資料快取	資料快取	資料快取總覽
	機型	為執行個體選取機器系列和類型。所選選項會決定可用的儲存空間類型和設定選項。執行個體建立後，即無法變更機器系列。	機器系列總覽
自動調整磁碟大小	磁碟自動調整大小	storageAutoResize	啟用自動增加儲存空間
	磁碟自動調整大小限制	storageAutoResizeLimit	自動增加儲存空間上限
	磁碟大小	dataDiskSizeGb	「儲存空間容量」
	磁碟類型	dataDiskType	「儲存空間類型」
	定價方案	pricingPlan	SqlPricingPlan
備份設定	已啟用	enabled	建立 PostgreSQL 執行個體
	開始時間	BackupConfiguration	建立 PostgreSQL 執行個體
	區域	location	自訂備份位置
	可用區	location	自訂備份位置
	已啟用時間點復原功能	pointInTimeRecoveryEnabled	pointInTimeRecoveryEnabled
	交易記錄保留天數	BackupConfiguration	記錄保留期限
	保留的備份	retainedBackups	記錄和磁碟用量
	保留期限單位	retentionUnit	retentionUnit
IP 設定	授權網路金鑰	authorizedNetworks[]	使用已獲授權的網路進行授權
	授權網路值	authorizedNetworks[]	使用已獲授權的網路進行授權
	已啟用 IPv4	ipv4Enabled	設定公開 IP
	私人網路	privateNetwork	私人 IP 設定選項
	SSL 模式	sslMode	SSL 模式
	分配 IP 範圍	allocatedIpRange	分配給服務的 IP 位址範圍
	啟用 Google Cloud 服務的私人路徑	Google Cloud 服務的私人路徑	建立支援私人服務存取權和 Private Service Connect 的執行個體
	已啟用 PSC	psc_enabled	Private Service Connect 總覽
	PSC 允許的用戶專案	allowedConsumerProjects[]	建立支援私人服務存取權和 Private Service Connect 的執行個體
	維護版本	maintenanceVersion	自助式維護
	防刪除功能	如果選取這個選項，就無法刪除 Cloud SQL 執行個體。	防止刪除執行個體
資料庫旗標	名稱	databaseFlags	設定資料庫旗標
	值	databaseFlags	設定資料庫旗標
	使用者刪除政策	如要允許捨棄使用者而非刪除，請輸入 ABANDON。	如果 PostgreSQL 使用者已獲派 SQL 角色，就無法刪除。
其他使用者	名稱	name	PostgreSQL 使用者和角色簡介
	密碼	輸入密碼，或選取「隨機密碼」來產生密碼。	PostgreSQL 使用者和角色簡介
其他資料庫	名稱	name	建立及管理資料庫
	定序	定序	建立及管理資料庫
	主要執行個體名稱	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 執行個體上建立資料庫
	資料庫定序	定序	在 Cloud SQL 執行個體上建立資料庫
IAM 使用者	ID	IAM 使用者的 ID。	IAM 驗證
	電子郵件	IAM 使用者的電子郵件地址。	將個別 IAM 使用者或服務帳戶新增至 Cloud SQL 執行個體
	類型	type	將個別 IAM 使用者或服務帳戶新增至 Cloud SQL 執行個體
	建立逾時	選用逾時設定，用於限制長時間的資料庫建立作業。	create_timeout
	更新逾時	選用逾時設定，用於限制長時間的資料庫更新。	update_timeout
	刪除逾時	選用逾時設定，用於限制長時間的資料庫刪除作業。	delete_timeout
	加密金鑰名稱	encryption_key_name	關於用戶端加密
	唯讀副本防刪除功能	如果選取，Terraform 就無法刪除副本 SQL 執行個體。	deletion_protection
	啟用隨機密碼特殊字元	如果選取，則在隨機產生的密碼中啟用特殊字元。	enable_random_password_special
	連接器強制執行	connectorEnforcement	Cloud SQL 語言連接器總覽
	啟用 Google 機器學習整合功能	enable_google_ml_integration	使用 Cloud SQL 建構生成式 AI 應用程式
	資料庫整合角色	預設資料庫執行個體服務帳戶所需的角色，用於與 Google Cloud 服務整合。	事前準備