Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

AlloyDB Express クラスタを作成して管理する

このドキュメントでは、AlloyDB Express クラスタとインスタンスの作成、接続、編集、表示、削除、アップグレードの方法について説明します。

AlloyDB Express の機能と AlloyDB の機能の違いについては、AlloyDB Express の概要をご覧ください。代わりに AlloyDB クラスタを作成するには、クラスタとそのプライマリインスタンスを作成するをご覧ください。

始める前に

AlloyDB Express クラスタを作成または管理する前に、次の前提条件を満たしてください。

Google Cloud プロジェクトで AlloyDB API とその他の必要な API を有効にして、プロジェクトが AlloyDB にアクセスできるようにします。
AlloyDB リモート MCP サーバーを使用する場合は、グローバル MCP サーバーエンドポイント（https://alloydb.googleapis.com/mcp）またはリージョンエンドポイント（https://alloydb.REGION_ID.rep.googleapis.com/mcp）に接続するように MCP クライアントを構成します。リージョンエンドポイントは現在プレビュー版です。

必要なロール

AlloyDB Express クラスタとインスタンスの作成と管理に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

AlloyDB 管理者（roles/alloydb.admin）
オーナー（roles/owner）
編集者（roles/editor）
AlloyDB リモート MCP サーバーを使用する: MCP ツールユーザー（roles/mcp.toolUser）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

AlloyDB Express クラスタとインスタンスを作成する

AlloyDB Express クラスタとそのプライマリインスタンスは、 Google Cloud コンソール、Google Cloud CLI、AlloyDB REST API、または AlloyDB リモート MCP サーバーを使用して作成できます。

AlloyDB Express クラスタは PostgreSQL 18 をサポートし、1 つの vCPU（4 GB RAM）から始まり、ストレージを最大 20 GB まで自動的にスケーリングする単一のゾーンプライマリインスタンスが含まれています。後で 2 vCPU にサイズ変更せずに 1 vCPU インスタンスを AlloyDB にインプレースアップグレードする予定がある場合は、C4A マシンシリーズもサポートするリージョンにクラスタを作成します。

デフォルトの接続設定は、使用するツールによって異なります。

Google Cloud コンソール: デフォルトで、プライマリインスタンスのパブリック DNS とクラスタの Private Service Connect の両方を有効にします。Private Service Connect コンシューマーGoogle Cloud プロジェクトは、後でインスタンスの接続設定を編集して構成できます。
gcloud CLI、REST API、AlloyDB リモート MCP サーバー: デフォルトでは、クラスタで Private Service Connect のみが有効になります。プライマリインスタンスを作成するときに、パブリック DNS 経由で接続する場合はパブリック DNS を有効にし、インスタンスの Private Service Connect エンドポイントを作成するコンシューマーGoogle Cloud プロジェクトを許可リストに登録します。

コンソール

Google Cloud コンソールで、[使ってみる] ページに移動します。

[スタートガイド] に移動

Google Cloud プロジェクトにすでにクラスタがあり、[クラスタ] ページから開始する場合は、ツールバーの [クラスタを作成] をクリックして、[構成を選択] ページを開きます。どちらのページにも、プリセットクラスタ構成カード（AlloyDB Express、プロダクション（シングルゾーン）、プロダクション（マルチゾーン））が表示されます。
[AlloyDB Express] カードで、[クラスタを作成] をクリックして [AlloyDB Express クラスタを作成] ペインを開きます。
[AlloyDB Express クラスタの作成] ペインで、クラスタを構成します。
- [クラスタ ID] に、クラスタの ID を入力するか、デフォルトの ID をそのまま使用します。
- [パスワード] に、デフォルトの postgres ユーザーのパスワードを入力するか、[生成] をクリックしてパスワードを生成します。パスワードは、後で [ユーザー] ページから変更できます。
- [リージョン] で、クラスタのサポートされているリージョンを選択します。後で 2 vCPU にサイズ変更せずに 1 vCPU インスタンスを AlloyDB にアップグレードする場合は、C4A マシンシリーズをサポートするリージョンを選択します。
[クラスタを作成] をクリックします。

Google Cloud コンソールで AlloyDB Express クラスタとその 1 vCPU プライマリインスタンスが作成されます。Private Service Connect とパブリック DNS の両方がデフォルトで有効になっています。その後、AlloyDB Studio が開き、データベースにクエリを実行できます。

Google Cloud コンソールでクラスタを作成するときに接続設定を変更することはできませんが、後でインスタンスの接続設定を編集して、承認済みの外部ネットワークまたは Private Service Connect の設定を更新できます。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

AlloyDB Express クラスタを作成するには、--enable-express フラグを指定して gcloud beta alloydb clusters create コマンドを実行します。
```
gcloud beta alloydb clusters create CLUSTER_ID \
    --region=REGION_ID \
    --password=PASSWORD \
    --enable-express \
    --project=PROJECT_ID
```
次のように置き換えます。
- CLUSTER_ID: 作成するクラスタの ID。ID の先頭は英小文字にする必要があります。その後に英小文字、数字、ハイフンを続けることができます。
- REGION_ID: クラスタを作成するサポート対象のリージョン。後で 2 vCPU にサイズ変更せずに 1 vCPU インスタンスを AlloyDB にアップグレードする予定がある場合は、C4A マシンシリーズもサポートするリージョンを選択します。
- PASSWORD: デフォルトの postgres データベースユーザーの初期パスワード。
- PROJECT_ID: クラスタを作成するGoogle Cloud プロジェクトの ID。
注: デフォルトでは、gcloud CLI で AlloyDB Express クラスタを作成すると、Virtual Private Cloud（VPC）ネットワークからのプライベート接続に Private Service Connect が有効になります。一方、パブリック DNS は、次のステップでインスタンスレベルで有効になります。Private Service Connect に到達できるようにするには、プライマリインスタンスの作成時または更新時に、--allowed-psc-projects を使用してコンシューマー Google Cloud プロジェクトを許可リストに登録する必要があります。
AlloyDB Express クラスタにプライマリインスタンスを作成するには、gcloud beta alloydb instances create コマンドを実行し、接続フラグを選択します。
- パブリック DNS のみ: --enable-public-dns を指定し、--allowed-psc-projects を省略します。
- Private Service Connect のみ: --enable-public-dns を省略し、--allowed-psc-projects=ALLOWED_PROJECT_ID を指定して、コンシューマー Google Cloud プロジェクトからの Private Service Connect 接続を許可します。
- パブリック DNS と Private Service Connect の両方: --enable-public-dns と --allowed-psc-projects=ALLOWED_PROJECT_ID の両方を指定します。
```
gcloud beta alloydb instances create INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --instance-type=PRIMARY \
    --cpu-count=1 \
    --enable-public-dns \
    --allowed-psc-projects=ALLOWED_PROJECT_ID \
    --project=PROJECT_ID
```
次のように置き換えます。
- INSTANCE_ID: 作成するプライマリインスタンスの ID。
- ALLOWED_PROJECT_ID（省略可）: このインスタンスへの Private Service Connect エンドポイントの作成を許可する Google Cloud プロジェクト ID またはプロジェクト番号のカンマ区切りリスト。パブリック DNS のみを構成する場合は、--allowed-psc-projects を省略します。
注: AlloyDB Express クラスタは、ゾーンの可用性（--availability-type=ZONAL）のみをサポートしています。プライマリインスタンスは、CPU 数を 1（1 vCPU、4 GB RAM）にして作成する必要があります。1 以外の値を指定すると失敗します。必要に応じて、作成後にインスタンスを更新して 2（2 vCPU、8 GB RAM）にできます。

REST

AlloyDB Express クラスタを作成するには、expressConfig.enabled を true に設定して、POST リクエストを projects.locations.clusters.create エンドポイントに送信します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
- REGION_ID: クラスタを作成するサポート対象のリージョン。後で 2 vCPU にサイズ変更せずに 1 vCPU インスタンスを AlloyDB にアップグレードする予定がある場合は、C4A マシンシリーズもサポートするリージョンを選択します。
- CLUSTER_ID: 作成するクラスタの ID。
- INITIAL_USERNAME: 最初のデータベースユーザーのユーザー名（例: postgres）。
- INITIAL_USER_PASSWORD: 最初のデータベースユーザーのパスワード。
HTTP メソッドと URL:
```
POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID
```
リクエストの本文（JSON）:
```
{
  "databaseVersion": "POSTGRES_18",
  "expressConfig": {
    "enabled": true
  },
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  }
}
```
クラスタ作成オペレーションが完了したら、machineConfig.cpuCount を 1 に設定して projects.locations.clusters.instances.create エンドポイントに POST リクエストを送信して、プライマリインスタンスを作成します（1 以外の値を指定すると、作成に失敗します）。リクエスト本文で接続フィールドを選択します。
- パブリック DNS のみ: "networkConfig": {"publicDnsEnabled": true} を設定し、"pscInstanceConfig" を省略します。
- Private Service Connect のみ: "publicDnsEnabled"（デフォルトは false）を省略し、"pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]} を設定します。
- パブリック DNS と Private Service Connect の両方: "networkConfig": {"publicDnsEnabled": true} と "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]} の両方を含めます。
リクエストのデータを使用する前に、次のように置き換えます。
- INSTANCE_ID: 作成するプライマリインスタンスの ID。
- ALLOWED_PROJECT_ID（省略可）: このインスタンスへの Private Service Connect エンドポイントの作成を許可するGoogle Cloud プロジェクト ID またはプロジェクト番号。
HTTP メソッドと URL:
```
POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances?instanceId=INSTANCE_ID
```
リクエストの本文（JSON）:
```
{
  "instanceType": "PRIMARY",
  "availabilityType": "ZONAL",
  "machineConfig": {
    "cpuCount": 1
  },
  "networkConfig": {
    "publicDnsEnabled": true
  },
  "pscInstanceConfig": {
    "allowedConsumerProjects": [
      "ALLOWED_PROJECT_ID"
    ]
  }
}
```

MCP

MCP クライアントを使用するか、AlloyDB リモート MCP サーバーを直接呼び出して、AlloyDB Express クラスタとそのプライマリインスタンスを作成できます。

MCP クライアントでは、1 つのプロンプトを使用して AlloyDB Express クラスタとそのプライマリインスタンスの両方を作成できます。MCP クライアントは、create_cluster を自動的に呼び出し、get_operation をポーリングして、create_instance を呼び出します。

Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID with a primary instance named INSTANCE_ID.

各ステップを個別に実行するか、MCP ツールを直接呼び出すには、次の操作を行います。

AlloyDB Express クラスタを作成するには、MCP クライアントでプロンプトを入力するか、express_config.enabled を true に設定して create_cluster MCP ツールを呼び出します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
- REGION_ID: クラスタを作成するサポート対象のリージョン。後で 2 vCPU にサイズ変更せずに 1 vCPU インスタンスを AlloyDB にアップグレードする予定がある場合は、C4A マシンシリーズもサポートするリージョンを選択します。
- CLUSTER_ID: 作成するクラスタの ID。
MCP クライアントで、次のようなプロンプトを入力します。
```
Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.
```
ツール呼び出しのパラメータ:
```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_cluster",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID",
      "cluster_id": "CLUSTER_ID",
      "express_config": {
        "enabled": true
      }
    }
  }
}
```
注: デフォルトでは、create_cluster を使用して AlloyDB Express クラスタを作成すると、Private Service Connect（"psc_enabled": true）が有効になります。一方、パブリック DNS はインスタンスレベルで有効になります。AlloyDB Express クラスタは、network フィールドを使用した VPC ピアリングをサポートしていません。
VPC ネットワークから Private Service Connect にアクセスできるようにするには、プライマリインスタンスの作成時または更新時に、"psc_instance_config" のコンシューマーGoogle Cloud プロジェクトを許可リストに登録します。
create_cluster ツールは、長時間実行オペレーションを返します。done が true になり、クラスタが READY 状態になるまで、get_operation MCP ツールを使用してオペレーションのステータスをポーリングします。
AlloyDB Express クラスタにプライマリインスタンスを作成するには、MCP クライアントでプロンプトを入力するか、create_instance MCP ツールを呼び出します。接続設定を選択します。
- パブリック DNS のみ: "public_dns_enabled": true を設定し、"psc_instance_config" を省略します。
- Private Service Connect のみ: "public_dns_enabled"（デフォルトは false）を省略し、"psc_instance_config" を "allowed_consumer_projects"（または "consumer_project" と "consumer_network" を指定する "psc_auto_connections"）に設定します。
- パブリック DNS と Private Service Connect の両方: "public_dns_enabled": true と "psc_instance_config" の両方を設定します。
リクエストのデータを使用する前に、次のように置き換えます。
- INSTANCE_ID: 作成するプライマリインスタンスの ID。
- ALLOWED_PROJECT_ID: 省略可。このインスタンスへの Private Service Connect エンドポイントの作成を許可するGoogle Cloud プロジェクト ID またはプロジェクト番号。
MCP クライアントで、次のようなプロンプトを入力します。
```
Please create a primary instance named INSTANCE_ID in my AlloyDB Express cluster CLUSTER_ID.
```
ツール呼び出しのパラメータ:
```
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
      "instance_id": "INSTANCE_ID",
      "type": "PRIMARY",
      "public_dns_enabled": true,
      "psc_instance_config": {
        "allowed_consumer_projects": [
          "ALLOWED_PROJECT_ID"
        ]
      }
    }
  }
}
```
注: AlloyDB Express クラスタの場合、cpu_count と machine_type を省略すると、create_instance はデフォルトの AlloyDB Express マシン構成（1 vCPU と 4 GB の RAM）を使用します。AlloyDB Express プライマリインスタンスの作成時に 1 以外の cpu_count を指定すると、失敗します。create_instance で public_dns_enabled を省略すると、デフォルトで false に設定され、ツールによって Data API アクセス（data_api_access: ENABLED）と IAM データベース認証（db_iam_authentication: true）が自動的に有効になります。
done が true になり、インスタンスが READY 状態になるまで、get_operation MCP ツールを使用してインスタンス作成オペレーションをポーリングします。

AlloyDB Express インスタンスに接続する

AlloyDB Express は、次のインバウンドデータベース接続オプションをサポートしています。

パブリック DNS（デフォルト）: 一般公開でルーティング可能な DNS 名（networkInfo.publicDnsName）を提供します。これにより、VPC ネットワーク外のクライアントから接続できます。
Private Service Connect: Private Service Connect エンドポイントを介して VPC ネットワーク内からインスタンスにプライベートに接続できます。データベースをパブリックインターネットに公開する必要はありません。

パブリック DNS 経由で接続する

VPC ネットワークの外部からパブリック DNS 経由で接続する場合は、次のいずれかを行います。

PostgreSQL クライアント（ psql など）を使用して直接接続する: 最初に、承認済みの外部ネットワークでクライアント IP アドレスを許可リストに登録する必要があります。
gcloud CLI または Auth Proxy を使用して接続するか、AlloyDB 言語コネクタを使用します。トラフィックは自動的に暗号化され、承認済みの外部ネットワークを構成する必要はありません。

PostgreSQL クライアントを使用して直接接続する

デフォルトでは、パブリック DNS エンドポイントはすべての直接クライアント IP アドレスを拒否します。psql に直接接続する前に、クライアント CIDR ブロックを許可リストに登録する必要があります。

プライマリインスタンスで承認済み外部ネットワークを構成します。

承認済み外部ネットワークを個別に追加または削除することはできません。更新のたびに、既存のリストが上書きされます。許可するすべての CIDR ブロックのカンマ区切りのリストを指定します。
コンソール
1. Google Cloud コンソールで、[クラスタ] ページに移動します。
  
  [クラスタ] に移動
2. [リソース名] 列で、AlloyDB Express クラスタの名前をクリックします。
3. [概要] ページで [クラスタ内のインスタンス] に移動し、プライマリインスタンスを見つけて、 [インスタンスの操作] > [編集] をクリックします（または、ナビゲーションメニューの [接続] に移動して [編集] をクリックします）。
4. [接続] で、パブリック接続が有効になっていることを確認します。
5. [承認済み外部ネットワーク] で、IPv4 CIDR 範囲のカンマ区切りリスト（203.0.113.0/24 など）を入力するか、[自分の IP を使用] をクリックして、現在のマシンの /32 IPv4 アドレスを追加します。
6. [インスタンスを更新] をクリックします。
gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

--authorized-external-networks フラグを指定して gcloud alloydb instances update コマンドを実行します。
gcloud alloydb instances update INSTANCE_ID \ --cluster=CLUSTER_ID \ --region=REGION_ID \ --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2 \ --project=PROJECT_ID
次のように置き換えます。
- INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
- CLUSTER_ID: AlloyDB Express クラスタの ID。
- REGION_ID: クラスタが配置されているリージョン。
- CIDR_RANGE1、CIDR_RANGE2: CIDR 表記の IPv4 アドレス範囲のカンマ区切りのリスト（例: 203.0.113.0/24）。
- PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REST
updateMask=networkConfig.authorizedExternalNetworks を使用して、projects.locations.clusters.instances.patch エンドポイントに PATCH リクエストを送信します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
- REGION_ID: クラスタが配置されているリージョン。
- CLUSTER_ID: AlloyDB Express クラスタの ID。
- INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
- CIDR_RANGE1、CIDR_RANGE2: CIDR 表記の IPv4 アドレス範囲（例: 203.0.113.0/24）。
HTTP メソッドと URL:
PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=networkConfig.authorizedExternalNetworks
リクエストの本文（JSON）:
{ "networkConfig": { "authorizedExternalNetworks": [ { "cidrRange": "CIDR_RANGE1" }, { "cidrRange": "CIDR_RANGE2" } ] } }
MCP
MCP クライアントにプロンプトを入力するか、authorized_external_networks フィールドを指定して update_instance MCP ツールを呼び出します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
- REGION_ID: クラスタが配置されているリージョン。
- CLUSTER_ID: AlloyDB Express クラスタの ID。
- INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
- CIDR_RANGE1、CIDR_RANGE2: CIDR 表記の IPv4 アドレス範囲（203.0.113.0/24 など）。
MCP クライアントで、次のようなプロンプトを入力します。
Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to allow external connections from CIDR_RANGE1.
ツール呼び出しのパラメータ:
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "update_instance", "arguments": { "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID", "authorized_external_networks": [ "CIDR_RANGE1", "CIDR_RANGE2" ] } } }
インスタンスのパブリック DNS 名を取得します。
コンソール
1. Google Cloud コンソールで [クラスタ] ページに移動し、AlloyDB Express クラスタ名をクリックします。
2. [接続] に移動（または [概要] ページのプライマリインスタンスカードを表示）し、インスタンスのパブリック DNS 名をコピーします。
gcloud
gcloud beta alloydb instances describe コマンドを実行して、networkInfo.publicDnsName 値を取得します。
gcloud beta alloydb instances describe INSTANCE_ID \ --cluster=CLUSTER_ID \ --region=REGION_ID \ --format="value(networkInfo.publicDnsName)" \ --project=PROJECT_ID
出力は次の形式になります。
IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.goog
この出力で、IDENTIFIER はシステム生成の英数字識別子です。
REST
projects.locations.clusters.instances.get エンドポイントに GET リクエストを送信し、レスポンスから networkInfo.publicDnsName フィールドを読み取ります。
GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID
MCP
MCP クライアントにプロンプトを入力するか、get_instance MCP ツールを呼び出して、レスポンスから networkInfo.publicDnsName フィールドを読み取ります。

MCP クライアントで、次のようなプロンプトを入力します。
Please get the public DNS name of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.
ツール呼び出しのパラメータ:
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_instance", "arguments": { "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" } } }
標準の PostgreSQL 接続 URI とインスタンスのパブリック DNS 名を使用して、データベースに接続します。
```
psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME
```
次のように置き換えます。
- USERNAME: PostgreSQL データベースのユーザー名（例: postgres）。
- PUBLIC_DNS_NAME: AlloyDB Express インスタンスのパブリック DNS 名（例: 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog）。
- DATABASE_NAME: 接続先のデータベースの名前（デフォルトのデータベースは postgres）。
プロンプトが表示されたら、データベースユーザーのパスワードを入力します。

gcloud CLI または Auth Proxy を使用して接続する

承認済み外部ネットワークを構成せずにパブリック DNS 経由で接続するには、gcloud beta alloydb connect コマンドまたはスタンドアロンの Auth Proxy クライアント（alloydb-auth-proxy）を --public-ip フラグとともに使用します。AlloyDB Express にはパブリック IP アドレスではなくパブリック DNS 名が表示されますが、コントロールプレーンは、--public-ip を指定すると Auth Proxy が自動的に解決するインスタンスの基盤となるパブリック接続をプロビジョニングします。

ローカルの Auth Proxy インスタンスを起動し、gcloud CLI を使用して psql セッションを開くには、--public-ip フラグを指定して gcloud beta alloydb connect コマンドを実行します。

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip \
    --user=USERNAME \
    --database=DATABASE_NAME \
    --project=PROJECT_ID

次のように置き換えます。

INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
CLUSTER_ID: AlloyDB Express クラスタの ID。
REGION_ID: クラスタが配置されているリージョン。
USERNAME: データベースのユーザー名（デフォルトは postgres）。
DATABASE_NAME: データベース名（デフォルトは postgres）。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。

IAM データベース認証（--auto-iam-authn）など、gcloud CLI を使用した接続の詳細については、gcloud CLI を使用して接続するをご覧ください。

または、スタンドアロンの Auth Proxy クライアントをダウンロードして、--public-ip フラグを指定して実行することもできます。

./alloydb-auth-proxy \
    "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" \
    --public-ip

スタンドアロンの Auth Proxy クライアントをダウンロード、構成、接続する方法については、AlloyDB Auth Proxy を使用して接続するをご覧ください。

Private Service Connect 経由で接続する

データベースを公共のインターネットに公開せずに VPC ネットワーク内からプライベート接続を行うには、AlloyDB Express インスタンスで Private Service Connect を構成します。Private Service Connect エンドポイントには、VPC ネットワーク内のクライアントから直接接続することも、Auth Proxy を使用して接続することもできます。Private Service Connect への接続の詳細については、Private Service Connect を使用してインスタンスに接続するをご覧ください。

AlloyDB Express でこれらの手順を行う場合は、Private Service Connect を有効にして AlloyDB Express クラスタとインスタンスを作成するの説明に従って、クラスタと 1 vCPU ゾーンプライマリインスタンスを作成します。AlloyDB Express は、単一のゾーンプライマリインスタンスへのインバウンド Private Service Connect 接続をサポートしています。

AlloyDB Express インスタンスを編集する

AlloyDB Express プライマリインスタンスの CPU 数（1 vCPU または 2 vCPU）またはデータベースフラグを更新できます。

コンソール

Google Cloud コンソールで、[クラスタ] ページに移動します。

[クラスタ] に移動
[リソース名] 列で、AlloyDB Express クラスタの名前をクリックします。
[概要] ページの [クラスタ内のインスタンス] セクションで、プライマリインスタンスを見つけて、[プライマリを編集] をクリックします（または、 [インスタンスのアクション> 編集] をクリックします）。
[プライマリインスタンスの編集] ページで、インスタンスの設定を更新します。
- [マシン] の [マシンタイプ] リストで、[1 vCPU、4 GB] または [2 vCPU、8 GB] を選択します。
- 省略可: データベースフラグを構成するには、[フラグ] を開くか、[詳細オプションを表示] をクリックして [フラグ] を開き、[フラグを追加] をクリックします。[新しいデータベースフラグ] リストからフラグを選択し、値を指定して、[完了] をクリックします。
[インスタンスを更新] をクリックします。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

CPU 数（1 または 2）を変更してインスタンスをスケーリングするか、データベースフラグを更新するには、gcloud alloydb instances update コマンドを実行します。

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --cpu-count=CPU_COUNT \
    --database-flags=FLAGS \
    --project=PROJECT_ID

次のように置き換えます。

INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
CLUSTER_ID: AlloyDB Express クラスタの ID。
REGION_ID: クラスタが配置されているリージョン。
CPU_COUNT: インスタンスの vCPU の数（1 vCPU、4 GB RAM の場合は 1、2 vCPU、8 GB RAM の場合は 2）。
FLAGS（省略可）: データベースフラグと値のカンマ区切りリスト（FLAG_NAME=VALUE 形式）。CPU 数のみを更新する場合は、--database-flags フラグを省略します。サポートされているフラグの詳細については、サポートされているデータベースフラグをご覧ください。
PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。

--enable-public-dns または --no-enable-public-dns: インスタンスのパブリック DNS を有効または無効にします。このフラグは、gcloud beta（gcloud beta alloydb instances update）でのみ使用できます。
--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: インスタンスへの Private Service Connect エンドポイントの作成を許可するコンシューマ Google Cloud プロジェクト ID またはプロジェクト番号のカンマ区切りリストを更新します。

REST

AlloyDB Express プライマリインスタンスの CPU 数またはデータベースフラグを更新するには、projects.locations.clusters.instances.patch エンドポイントに PATCH リクエストを送信し、updateMask クエリパラメータで更新するフィールドを指定します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
CPU_COUNT: インスタンスの vCPU の数（1 または 2）。
FLAG_NAME と FLAG_VALUE（省略可）: 設定するデータベースフラグの名前と値。CPU 数のみを更新する場合は、updateMask=machineConfig.cpuCount を設定し、リクエスト本文から databaseFlags を省略します。

HTTP メソッドと URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=machineConfig.cpuCount,databaseFlags

リクエストの本文（JSON）:

{
  "machineConfig": {
    "cpuCount": CPU_COUNT
  },
  "databaseFlags": {
    "FLAG_NAME": "FLAG_VALUE"
  }
}

MCP

AlloyDB Express プライマリインスタンスの CPU 数またはデータベースフラグを更新するには、MCP クライアントでプロンプトを入力するか、update_instance MCP ツールを呼び出します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
CPU_COUNT: インスタンスの vCPU の数（1 または 2）。
FLAG_NAME、FLAG_VALUE: 省略可。設定するデータベースフラグの名前と値。CPU 数のみを更新する場合は、arguments から database_flags を省略します。

MCP クライアントで、次のようなプロンプトを入力します。

Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to CPU_COUNT vCPUs.

ツール呼び出しのパラメータ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "cpu_count": CPU_COUNT,
      "database_flags": {
        "FLAG_NAME": "FLAG_VALUE"
      }
    }
  }
}

AlloyDB Express クラスタとインスタンスの詳細を表示する

AlloyDB Express クラスタのリストの表示、特定の AlloyDB Express クラスタまたはインスタンスの詳細の表示、クラスタのコンピューティングとストレージ使用量の確認を行うことができます。

詳細については、クラスタのリストを表示する、クラスタの詳細を表示する、インスタンスの詳細を表示するをご覧ください。

コンソール

Google Cloud コンソールで、[クラスタ] ページに移動します。

[クラスタ] に移動

[リソース名] 列で、AlloyDB Express クラスタの名前の横に [Express] タグが表示されます。
クラスタとそのプライマリインスタンスの詳細情報を表示するには、[リソース名] 列でクラスタ名をクリックします。
[概要] ページで、[クラスタの詳細]（クラスタ ID の横にある Express タグと、20 GB の上限のうち使用されている合計ストレージを含む）と、[クラスタ内のインスタンス] のプライマリインスタンスの詳細を確認します。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

プロジェクト内のクラスタのリストを表示するには、gcloud alloydb clusters list コマンドを実行します。
```
gcloud alloydb clusters list --project=PROJECT_ID
```
特定のクラスタの詳細を表示するには、gcloud alloydb clusters describe コマンドを実行します。
```
gcloud alloydb clusters describe CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID
```

特定のインスタンスの詳細を表示するには、gcloud alloydb instances describe コマンドを実行します。

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
CLUSTER_ID: AlloyDB Express クラスタの ID。
REGION_ID: クラスタが配置されているリージョン。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
リージョン内のクラスタのリストを表示するには、projects.locations.clusters.list エンドポイントに GET リクエストを送信します。
```
GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters
```
クラスタの詳細を表示するには、projects.locations.clusters.get エンドポイントに GET リクエストを送信します。
```
GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID
```
インスタンスの詳細を表示するには、projects.locations.clusters.instances.get エンドポイントに GET リクエストを送信します。
```
GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID
```

MCP

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。

リージョン内のクラスタのリストを表示するには、MCP クライアントでプロンプトを入力するか、list_clusters MCP ツールを呼び出します。

MCP クライアントで、次のようなプロンプトを入力します。

Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

ツール呼び出しのパラメータ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID"
    }
  }
}

クラスタの詳細を表示するには、MCP クライアントでプロンプトを入力するか、get_cluster MCP ツールを呼び出します。

MCP クライアントで、次のようなプロンプトを入力します。

Please show the details of the AlloyDB cluster CLUSTER_ID in REGION_ID.

ツール呼び出しのパラメータ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
    }
  }
}

インスタンスの詳細を表示するには、MCP クライアントでプロンプトを入力するか、get_instance MCP ツールを呼び出します。

MCP クライアントで、次のようなプロンプトを入力します。

Please show the details of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

ツール呼び出しのパラメータ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

コンピューティングとストレージの使用状況を表示する

AlloyDB Express クラスタとプライマリインスタンスで使用されているストレージとコンピューティングを確認するには、 Google Cloud コンソールまたは Cloud Monitoring を使用します。

Google Cloud コンソールで、クラスタの [概要] ページを開きます。
- 使用されているストレージ: [クラスタの詳細] で [使用されているストレージの合計] を表示して、クラスタが 20 GB の上限のうちどれだけのストレージを使用しているかを確認します。
- コンピューティングと接続: [概要] ページで [CPU 使用率] グラフと [アクティブな接続] グラフを表示するか、ナビゲーションメニューで [システム分析情報] をクリックして、CPU、メモリ、ストレージの詳細な指標を表示します。
Cloud Monitoring Metrics Explorer で、alloydb.googleapis.com/Cluster と alloydb.googleapis.com/Instance のモニタリング対象リソースタイプについて次の指標をクエリします。
- 使用容量: alloydb.googleapis.com/cluster/storage/usage
- CPU 使用率: alloydb.googleapis.com/instance/cpu/average_utilization、alloydb.googleapis.com/instance/cpu/maximum_utilization
- アクティブな接続: alloydb.googleapis.com/database/postgresql/backends

AlloyDB Express クラスタまたはインスタンスを削除する

AlloyDB Express のプライマリインスタンスまたはクラスタが不要になった場合は、削除できます。

詳細については、インスタンスを削除するとクラスタを削除するをご覧ください。

コンソール

Google Cloud コンソールで、[クラスタ] ページに移動します。

[クラスタ] に移動
[リソース名] 列で、AlloyDB Express クラスタの名前をクリックします。
[概要] ページで、プライマリインスタンスまたはクラスタを削除します。
- プライマリインスタンスを削除するには、[クラスタ内のインスタンス] セクションに移動し、 [インスタンスのアクション] > [削除] をクリックします。ダイアログでインスタンス ID を入力し、[削除] をクリックします。
- クラスタを削除するには、まずクラスタ内のプライマリインスタンスを削除してから、[クラスタを削除] をクリックし、[クラスタを削除] ダイアログにクラスタ ID を入力して、[削除] をクリックします。
注:Google Cloud コンソールを使用して、インスタンスを含むクラスタを削除することはできません。クラスタとそのプライマリインスタンスを 1 回のステップで削除するには、gcloud CLI で --force フラグを使用するか、REST API で force=true パラメータを使用します。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

インスタンスを削除するには、gcloud alloydb instances delete コマンドを実行します。

gcloud alloydb instances delete INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

クラスタを削除するには、gcloud alloydb clusters delete コマンドを実行します。クラスタにプライマリインスタンスがまだ含まれている場合は、--force フラグを指定して、プライマリインスタンスとクラスタを一緒に削除します。
```
gcloud alloydb clusters delete CLUSTER_ID \
    --region=REGION_ID \
    --force \
    --project=PROJECT_ID
```

次のように置き換えます。

INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
CLUSTER_ID: AlloyDB Express クラスタの ID。
REGION_ID: クラスタが配置されているリージョン。
PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。
INSTANCE_ID: AlloyDB Express プライマリインスタンスの ID。
インスタンスを削除するには、projects.locations.clusters.instances.delete エンドポイントに DELETE リクエストを送信します。
```
DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID
```
クラスタ（force=true を指定した場合はプライマリインスタンスを含む）を削除するには、DELETE リクエストを projects.locations.clusters.delete エンドポイントに送信します。
```
DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?force=true
```

AlloyDB Express クラスタを AlloyDB にアップグレードする

AlloyDB Express クラスタを AlloyDB クラスタにインプレースアップグレードできます。

アップグレードでは、データベースデータ、スキーマ、拡張機能、ユーザー認証情報、ネットワーキング構成（パブリック DNS 名と Private Service Connect エンドポイントを含む）、プライマリインスタンスの vCPU 数が保持されます。

次のリストは、アップグレードプロセス中に変更されるリソースと設定を示しています。

CPU 数、メモリ比率、コンピューティング容量: インスタンスは現在の vCPU 数（1 vCPU または 2 vCPU）を保持し、AlloyDB Express の 1:4 の vCPU とメモリの比率（4 GB または 8 GB RAM）から AlloyDB の 1:8 の vCPU とメモリの比率（1 vCPU の場合は 8 GB RAM、2 vCPU の場合は 16 GB RAM）にアップグレードされます。アップグレード後は、コンピューティングを最大 288 個の vCPU までスケーリングできます。
- 1 vCPU インスタンスをアップグレードする場合、C4A マシンシリーズをサポートするリージョンに限定されます。サポート対象の地域については、C4A のリージョンの可用性をご覧ください。
- AlloyDB Express インスタンスが C4A マシンタイプをサポートするリージョンにない場合は、アップグレードする前に、まずプライマリインスタンスを更新して 2 vCPU 構成にする必要があります。 Google Cloud コンソールで、サポートされていないリージョンの 1 vCPU インスタンスの [アップグレード] をクリックすると、最初にインスタンスのサイズを 2 vCPU に変更するように求めるメッセージが表示されます。
プロビジョニングされたコンピュートと課金: アップグレードにより、ゼロへのスケーリングコンピュートが無効になり、インスタンスは AlloyDB 料金で課金される常時稼働の AlloyDB インスタンスとして実行されます。
ストレージ容量: アップグレードすると、20 GB のストレージ上限がなくなります。ストレージは、クラスタごとにデフォルトの割り当てである 16 TiB までスケールアップします。保存容量の増加をリクエストして、128 TiB までスケールアップできます。
エンタープライズ機能: アップグレードにより、リージョンの高可用性（HA）が有効になります。これは、99.99% の稼働時間サービスレベル契約（SLA）の対象となります。また、読み取りプールインスタンス、クロスリージョンレプリケーション、継続的なバックアップと復元、自動バックアップとオンデマンドバックアップも利用できます。

AlloyDB Express クラスタを AlloyDB クラスタにアップグレードする手順は次のとおりです。

コンソール

Google Cloud コンソールで、[クラスタ] ページに移動します。

[クラスタ] に移動
[リソース名] 列で、AlloyDB Express クラスタの名前をクリックします。
[概要] ページの [クラスタの詳細] で [クラスタ ID] を見つけて、[アップグレード] をクリックします。

プライマリインスタンスが、C4A マシンシリーズをサポートしていないリージョンの 1 vCPU インスタンスである場合、次のメッセージが表示されます。

Upgrading to AlloyDB requires a 2 vCPU instance in the REGION_ID region. Resize your instance to 2 vCPUs first.

インスタンスのサイズを 2 vCPU に変更するには、[インスタンスを編集] をクリックします。インスタンスのサイズを変更したら、もう一度 [アップグレード] をクリックします。
[AlloyDB Express からのアップグレード] ペインで、クラスタ ID を入力してアップグレードを確定し、[確定] をクリックします。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

AlloyDB Express クラスタを AlloyDB クラスタにアップグレードするには、--no-enable-express フラグを指定して gcloud beta alloydb clusters update コマンドを実行します。

gcloud beta alloydb clusters update CLUSTER_ID \
    --region=REGION_ID \
    --no-enable-express \
    --project=PROJECT_ID

次のように置き換えます。

CLUSTER_ID: AlloyDB Express クラスタの ID。
REGION_ID: クラスタが配置されているリージョン。
PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。

プライマリインスタンスが、C4A マシンシリーズをサポートしていないリージョンの 1 vCPU インスタンスの場合、コマンドは失敗し、次のエラーが発生します。

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

このエラーを解決するには、プライマリインスタンスを 2 vCPU（--cpu-count=2）に更新してから、アップグレードコマンドを再度実行します。

REST

AlloyDB Express クラスタを AlloyDB クラスタにアップグレードするには、updateMask=expressConfig.enabled を使用して projects.locations.clusters.patch エンドポイントに PATCH リクエストを送信し、expressConfig.enabled を false に設定します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
REGION_ID: クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB Express クラスタの ID。

HTTP メソッドと URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?updateMask=expressConfig.enabled

リクエストの本文（JSON）:

{
  "expressConfig": {
    "enabled": false
  }
}

プライマリインスタンスが、C4A マシンシリーズをサポートしていないリージョンの 1 vCPU インスタンスである場合、リクエストは次のエラーで失敗します。

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

このエラーを解決するには、プライマリインスタンスを 2 vCPU（"machineConfig": {"cpuCount": 2}）に更新してから、アップグレードリクエストを再度送信します。

AlloyDB Express クラスタを作成して管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

AlloyDB Express クラスタとインスタンスを作成する

コンソール

gcloud

REST

MCP

AlloyDB Express インスタンスに接続する

パブリック DNS 経由で接続する

PostgreSQL クライアントを使用して直接接続する

コンソール

gcloud

REST

MCP

コンソール

gcloud

REST

MCP

gcloud CLI または Auth Proxy を使用して接続する

Private Service Connect 経由で接続する

AlloyDB Express インスタンスを編集する

コンソール

gcloud

REST

MCP

AlloyDB Express クラスタとインスタンスの詳細を表示する

コンソール

gcloud

REST

MCP

コンピューティングとストレージの使用状況を表示する

AlloyDB Express クラスタまたはインスタンスを削除する

コンソール

gcloud

REST

AlloyDB Express クラスタを AlloyDB にアップグレードする

コンソール

gcloud

REST

次のステップ

AlloyDB Express クラスタを作成して管理する