AI Skills
cloud-sql-basics

cloud-sql-basics

熱門

此檔案會產生或說明 Cloud SQL 資源。當使用者要求建立 MySQL、PostgreSQL 或 SQL Server 的 Cloud SQL 執行個體或資料庫時，請使用此檔案。 Cloud SQL 將第三方 MySQL、PostgreSQL 和 SQL Server 執行個體做為 Cloud SQL 中的資源進行管理。例如，當 Cloud SQL 建立一個開放原始碼 MySQL 執行個體時，產生的資源就是一個由 Google Cloud 管理的 Cloud SQL for MySQL 執行個體。 Cloud SQL 負責處理關聯式資料庫工作負載的備份、高可用性和安全連線。

1.5萬星標
1201分支
更新於 2026/7/29
獲取技能源代碼

相關技能

supabase-postgres-best-practices2241things-mac38萬plan-orchestrate24萬
SKILL.md
readonlyread-only
name
cloud-sql-basics
description

此檔案會產生或說明 Cloud SQL 資源。當使用者要求建立 MySQL、PostgreSQL 或 SQL Server 的 Cloud SQL 執行個體或資料庫時，請使用此檔案。 Cloud SQL 將第三方 MySQL、PostgreSQL 和 SQL Server 執行個體做為 Cloud SQL 中的資源進行管理。例如，當 Cloud SQL 建立一個開放原始碼 MySQL 執行個體時，產生的資源就是一個由 Google Cloud 管理的 Cloud SQL for MySQL 執行個體。 Cloud SQL 負責處理關聯式資料庫工作負載的備份、高可用性和安全連線。

Cloud SQL 基礎

Cloud SQL 是一個全代管的關聯式資料庫服務，支援 MySQL、PostgreSQL 和 SQL Server。它會自動處理修補程式、更新、備份和複本等耗時的工作，同時為您的應用程式提供高效能和高可用性。

先決條件

請確保您擁有建立和管理 Cloud SQL 執行個體所需的 IAM 權限。Cloud SQL Admin (roles/cloudsql.admin) 角色可提供 Cloud SQL 資源的完整存取權。

快速入門 (PostgreSQL)

  1. 啟用 API：

    gcloud services enable sqladmin.googleapis.com --quiet

  2. 建立執行個體：

    gcloud sql instances create INSTANCE_NAME \
  --database-version=POSTGRES_18 \
  --cpu=2 \
  --memory=7680MiB \
  --region=REGION \
  --quiet

  3. 為預設使用者設定密碼：

    由於這是 Cloud SQL for PostgreSQL 執行個體，預設管理員使用者為 postgres：

    gcloud sql users set-password postgres \
  --instance=INSTANCE_NAME --password=PASSWORD \
  --quiet

  4. 建立資料庫：

    gcloud sql databases create DATABASE_NAME \
  --instance=INSTANCE_NAME \
  --quiet

  5. 取得執行個體連線名稱：

    您需要執行個體連線名稱（格式為 PROJECT_ID:REGION:INSTANCE_NAME）才能使用 Cloud SQL Auth Proxy 進行連線。使用以下指令取得：

    gcloud sql instances describe INSTANCE_NAME \
  --format="value(connectionName)" \
  --quiet

  6. 連線到執行個體：

    必須執行 Cloud SQL Auth Proxy 才能連線到執行個體。在另一個終端機中，使用連線名稱啟動 Proxy：

    ./cloud-sql-proxy INSTANCE_CONNECTION_NAME

    Proxy 執行後，在另一個終端機中使用 psql 連線：

    psql "host=127.0.0.1 port=5432 user=postgres dbname=DATABASE_NAME password=PASSWORD sslmode=disable"

參考目錄

  • 核心概念：Cloud SQL 版本（Enterprise 與 Enterprise Plus）、執行個體架構、讀取集區、高可用性 (HA) 及支援的資料庫引擎。

  • CLI 使用方式：用於執行個體、資料庫和使用者管理的必要 gcloud sql 指令。

  • 用戶端程式庫與連接器：使用 Python、Java、Node.js 和 Go 連線到 Cloud SQL。

  • MCP 使用方式：使用 Cloud SQL 遠端 MCP 伺服器和 Gemini CLI 擴充功能。

  • 基礎設施即程式碼：用於執行個體、資料庫和使用者的 Terraform 設定。

  • IAM 與安全性：預先定義的角色、SSL/TLS 憑證和 Auth Proxy 設定。

  • 災難復原與備份：備份類型、時間點復原 (PITR)、複本、讀取集區比較，以及 Enterprise Plus 進階災難復原。

如果您需要這些參考資料中未提供的產品資訊，請使用 Developer Knowledge MCP 伺服器的 search_documents 工具。