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万Star
1201Fork
更新于 2026/7/29
获取 Skill源代码

相关 Skills

supabase-postgres-best-practices2241things-mac38万plan-orchestrate24万
SKILL.md
readonly只读
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 才能连接到实例。在另一个终端中，使用连接名称启动代理：

    ./cloud-sql-proxy INSTANCE_CONNECTION_NAME

    代理运行后，在另一个终端中使用 psql 连接：

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

参考目录

  • 核心概念：Cloud SQL 版本（企业版和企业增强版）、实例架构、只读池、高可用性 (HA) 以及支持的数据库引擎。

  • CLI 用法：用于实例、数据库和用户管理的基本 gcloud sql 命令。

  • 客户端库和连接器：使用 Python、Java、Node.js 和 Go 连接到 Cloud SQL。

  • MCP 用法：使用 Cloud SQL 远程 MCP 服务器和 Gemini CLI 扩展。

  • 基础设施即代码：用于实例、数据库和用户的 Terraform 配置。

  • IAM 和安全：预定义角色、SSL/TLS 证书和 Auth Proxy 配置。

  • 灾难恢复和备份：备份类型、时间点恢复 (PITR)、副本、只读池比较以及企业增强版高级灾难恢复。

如果您需要这些参考资料中未包含的产品信息，请使用 Developer Knowledge MCP 服务器的 search_documents 工具。