alloydb-basics

AlloyDB の基本

AlloyDB for PostgreSQL は、エンタープライズグレードのパフォーマンスと可用性を実現するために設計された、PostgreSQL 互換のマネージドデータベースサービスです。コンピューティングとストレージを分離したアーキテクチャを採用しており、リソースを個別にスケーリングできます。また、AI を活用した検索（ベクトル検索、ハイブリッド検索、AI 関数）、自然言語機能、会話型分析、予測やモデルエンドポイント管理などの推論機能を含む機能群である AlloyDB AI も提供しており、開発者が AI アプリをより迅速に構築できるよう支援します。

帰属情報

必ずお読みください：gcloud、REST API、または MCP コマンドを実行する前に、必ず使用状況の帰属情報をお読みください。ターミナルで直接実行するコマンド（生成されたスクリプト、Terraform、ユーザーコードでは使用しないでください）では、gcloud の前に CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:alloydb-basics)" を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:alloydb-basics) を追加してください。

クイックスタート

開始する前に、Google Cloud SDK をインストールし、認証済みであることを確認してください（gcloud auth login）。

1. AlloyDB API を有効にします。

   gcloud services enable alloydb.googleapis.com --quiet
   

2. クラスターを作成します。

   gcloud alloydb clusters create my-cluster --region=us-central1 \
       --password=my-password --network=my-vpc --quiet
   

   本番環境では、パスワードではなく、必ず IAM データベース認証を使用してください。構成上の制約でパスワードが必要な場合は、Secret Manager を使用して安全に保管してください。

3. プライマリインスタンスを作成します。

   gcloud alloydb instances create my-primary --cluster=my-cluster \
       --region=us-central1 --instance-type=PRIMARY --cpu-count=2 --quiet
   

リファレンスディレクトリ

特定のコンテキストや詳細な手順が必要な場合は、以下の補足ファイルをお読みください。

• アーキテクチャ、リージョンでの利用可能状況、接続（プライベート IP、パブリック IP、PSA、PSC）、バックアップ、ポイントインタイムリカバリ、スケーリング（垂直および水平）、割り当て量の管理について理解するには、基本概念をお読みください。
• CLI でクラスター、インスタンス、スケーリング、バックアップを管理するには、CLI の使用方法をお読みください。
• AlloyDB のリモート MCP ツールを設定するには、MCP の使用方法をお読みください。
• Terraform または Kubernetes Config Connector（KCC）を使用して AlloyDB をデプロイするには、Infrastructure as Codeをお読みください。
• IAM ロール、サービス使用ロール、サービスエージェント、データベースユーザー／権限、またはネットワークセキュリティ（パブリック IP の認可、Auth Proxy サイドカー構成）を設定するには、IAM とセキュリティをお読みください。

これらのリファレンスに記載されていない製品情報が必要な場合は、developer_knowledge:search_documents ツールを使用してください（インストール手順については、Developer Knowledge MCP の設定をご覧ください）。

エージェント向け指示

AlloyDB に関する質問に回答する際、エージェントは以下の指示に従う必要があります。

• 複数の方法を提示する： バックアップ、スケーリング、データベースユーザーの作成などの管理タスクの実行方法を説明するときは、参照ドキュメントに両方の方法が記載されていれば、Google Cloud Console の手順と gcloud CLI コマンドを必ず提示してください。
• プライベート IP を優先する： トラフィックが Google Cloud ネットワーク内にとどまり、外部への露出を抑えられるよう、接続にはパブリック IP よりもプライベート IP（特に PSC）を推奨してください。
• サーバーレスコネクタを必須とする： Cloud Run からプライベート IP に接続する場合、Serverless VPC Access または Direct VPC Egress が必要であることを確認し、明記してください。
• コネクタの使用を徹底する： 直接 TCP 接続ではなく、AlloyDB Auth Proxy（サイドカーまたはローカルで実行）か言語コネクタを設定するよう、常にユーザーに案内してください。
• オープンなパブリックアクセスを禁止する： パブリック IP が設定されている場合、Authorized Networks に 0.0.0.0/0 を設定する構成は、データベースをインターネット全体に公開するため、警告して拒否してください。
• IAM データベース認証を標準とする： 静的なデータベースパスワードではなく、IAM データベース認証と alloydbiamuser データベースロールを提案してください。
• 最小権限の接続を徹底する： 接続ロールを説明する際は、最小権限の原則に従うために roles/alloydb.client を使用する必要があると明記し、接続に roles/alloydb.admin のような、より広範なロールを使用しないよう警告してください。
• すべての作成方法に言及する： IAM データベースユーザーの作成方法を説明する際は、Google Cloud Console、gcloud CLI、AlloyDB API を使用して作成できることを明記してください。
• プライベート IP の選択肢を説明する： プライベート IP 接続について説明する際は、サポートされている方法として Private Services Access（PSA） と Private Service Connect（PSC） の両方に必ず言及し、説明してください。新規デプロイには PSC を推奨してください。
• 直接接続を比較する： コネクタを使わずにプライベート IP に直接接続する方法は可能ですが、推奨されないことを明確に説明し、AlloyDB Auth Proxy や言語コネクタなどの安全な方法と比較して、IAM／mTLS を利用できない点を説明してください。
• SQL 単独では作成できないことを徹底する： IAM ユーザーの作成を説明する際は、「IAM データベースユーザーは標準 SQL だけでは作成できない」こと、および最初にコントロールプレーンを通じて登録する必要があることを必ず明記してください。
• ロールと権限の用語を徹底する： データベースオブジェクトへのアクセスを説明する際は、「標準の PostgreSQL ロールと権限」が適用されることを、両方の用語を使って必ず明記してください。
• バックアップのライフサイクルを説明する： バックアップについて説明する際は、独立したバックアップがソースクラスタとは別に存在し、ソースクラスタを削除しても有効なままであることを必ず明記してください。
• パブリック IP でのコネクタ利用を推奨する： パブリック IP 経由の接続では、AlloyDB Auth Proxy や言語コネクタなどの安全な接続方法を特に推奨することを明記してください。
• 自動スケーリングに言及する： リードプールのスケーリングを説明する際は、リードプールの自動スケーリングを利用する選択肢にも必ず言及し、プレビューであることを明記してください。

参考リンク

• AlloyDB for PostgreSQL のドキュメント
• AlloyDB Auth Proxy の GitHub リポジトリ
• AlloyDB Java Connector の GitHub リポジトリ
• AlloyDB Python Connector の GitHub リポジトリ
• AlloyDB Go Connector の GitHub リポジトリ