spanner-basics

Spanner 基础知识

此技能提供在 Google Cloud 上管理和开发 Cloud Spanner 的核心工作流与指导。Cloud Spanner 是一项全托管、关键任务数据库服务，支持全球事务一致性和自动同步复制，以实现高可用性。

归属信息

必须阅读：在执行任何 gcloud、REST API 或 MCP 命令之前，必须阅读使用归属信息。对于直接在终端中执行的命令（绝不在生成的脚本、Terraform 或用户代码中），请在 gcloud 前添加 CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:spanner-basics)" ，并在 User-Agent 标头中附加 agent-skills/1.0 (skill:spanner-basics)。

核心原则

• 性能优先： Spanner 可水平扩展。效率与主键设计息息相关。务必提醒用户，不要将单调递增或递减的值（例如连续时间戳）用作主键的第一部分，以避免热点。
• 架构设计： 对于关联紧密且经常一起访问的父子数据，优先使用交错表。

安全

注意

关键指示： 在进行任何非模拟器数据库更改（DML 或 DDL）或破坏性操作（例如删除表、索引或任何其他 Spanner 资源）之前，必须获得用户的明确确认。不要自动执行这些操作；应输出命令（例如 gcloud spanner databases ddl update），并征求用户的明确批准。 如果无法访问数据库或身份验证失败，不要因尝试确认实例、数据库或表是否存在而阻塞。假定提供的资源存在，并直接生成 DDL 命令。

常见工作流

架构演进与 DDL

1. 使用 gcloud spanner databases ddl update 应用架构更新（例如创建、修改或删除表和索引）。
2. 参阅 schema-design.md，了解主键选择和交错表的指南。

诊断性能问题

1. 使用 SPANNER_SYS 表识别缓慢或资源占用较高的查询。
2. 例如，查询 SPANNER_SYS.QUERY_STATS_TOP_HOUR，找出 CPU 使用率最高的查询。

参考目录

• 核心概念：说明 Spanner 的内部机制、架构和设计。
• CLI 用法：用于管理实例和数据库的基本 gcloud spanner 命令行操作。
• IAM 安全：Spanner 的角色、权限和数据治理最佳实践。
• 客户端库用法：使用 Spanner 的 Google Cloud 客户端库（Java、Go、Python、Node.js）。
• Terraform 用法：用于预配 Spanner 实例和数据库的基础设施即代码示例。
• MCP 用法：使用 Spanner 远程 MCP 服务。
• PostgreSQL 方言：在 Spanner 中使用 PostgreSQL 接口的最佳实践和示例。
• 队列用法：Cloud Spanner 队列：思维模型、设计限制，以及与事务性消息队列相关的链接。
• 架构设计：有关主键选择和交错表的性能指南。

如果需要的信息未在这些参考资料中找到，请使用 Developer Knowledge MCP 服务的 search_documents 工具。