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 を使用して、スキーマの更新（テーブルやインデックスの CREATE、ALTER、DROP など）を適用します。
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 インスタンスとデータベースをプロビジョニングするための Infrastructure as Code の例です。
• MCP の使用方法：Spanner リモート MCP サーバーの使用方法です。
• PostgreSQL ダイアレクト：Spanner で PostgreSQL インターフェースを使用する際のベストプラクティスと例です。
• キューの使用方法：Cloud Spanner キューに関するメンタルモデル、設計上の制約、トランザクションメッセージキューに関するリンクです。
• スキーマ設計：パフォーマンス向上のための主キーの選択とインターリーブテーブルに関するガイドラインです。

これらのリファレンスにない製品情報が必要な場合は、Developer Knowledge MCP サーバーの search_documents ツールを使用してください。