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. インスタンスの接続名を取得:

   Cloud SQL Auth Proxy を使用して接続するには、インスタンス接続名 (PROJECT_ID:REGION:INSTANCE_NAME 形式) が必要です。次のコマンドで取得してください:

   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"
   

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

• Core Concepts: インスタンスアーキテクチャ、高可用性 (HA)、およびサポートされるデータベースエンジン。

• CLI Usage: インスタンス、データベース、ユーザー管理のための基本的な gcloud sql コマンド。

• Client Libraries & Connectors: Python、Java、Node.js、Go を使用した Cloud SQL への接続。

• MCP Usage: Cloud SQL リモート MCP サーバーと Gemini CLI 拡張機能の使用。

• Infrastructure as Code: インスタンス、データベース、ユーザーの Terraform 設定。

• IAM & Security: 事前定義されたロール、SSL/TLS 証明書、Auth Proxy 設定。

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