AlloyDB Express 클러스터 만들기 및 관리

이 문서에서는 AlloyDB Express 클러스터 및 인스턴스를 만들고, 연결하고, 수정하고, 보고, 삭제하고, 업그레이드하는 방법을 설명합니다.

AlloyDB Express 기능이 AlloyDB 기능과 어떻게 다른지에 대한 자세한 내용은 AlloyDB Express 개요를 참조하세요. 대신 AlloyDB 클러스터를 만들려면 클러스터 및 클러스터의 기본 인스턴스 만들기를 참조하세요.

시작하기 전에

AlloyDB Express 클러스터를 만들거나 관리하기 전에 다음 기본 요건을 완료하세요.

  • 프로젝트가 AlloyDB에 액세스할 수 있도록 Google Cloud 프로젝트에서 AlloyDB API 및 기타 필수 API를 사용 설정합니다.
  • AlloyDB 원격 MCP 서버를 사용하는 경우 전역 MCP 서버 엔드포인트(https://alloydb.googleapis.com/mcp) 또는 리전 엔드포인트(https://alloydb.REGION_ID.rep.googleapis.com/mcp)에 연결하도록 MCP 클라이언트를 구성합니다. 리전 엔드포인트는 현재 프리뷰 버전입니다.

필요한 역할

AlloyDB Express 클러스터 및 인스턴스를 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

AlloyDB Express 클러스터 및 인스턴스 만들기

Google Cloud 콘솔, Google Cloud CLI, AlloyDB REST API 또는 AlloyDB 원격 MCP 서버를 사용하여 AlloyDB Express 클러스터와 기본 인스턴스를 만들 수 있습니다.

AlloyDB Express 클러스터는 PostgreSQL 18을 지원하며, vCPU 1개(RAM 4GB)로 시작하고 스토리지를 최대 20GB까지 자동으로 확장하는 단일 영역 기본 인스턴스를 포함합니다. 나중에 vCPU 2개로 크기를 조절하지 않고 vCPU 인스턴스 1개를 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 프로젝트를 허용 목록에 추가합니다.

콘솔

  1. Google Cloud 콘솔에서 시작하기 페이지로 이동합니다.

    시작하기로 이동

    Google Cloud 프로젝트에 이미 클러스터가 있고 대신 클러스터 페이지에서 시작하는 경우 툴바에서 클러스터 만들기를 클릭하여 구성 선택 페이지를 엽니다. 두 페이지 모두 사전 설정된 클러스터 구성 카드(AlloyDB Express, 프로덕션(단일 영역), 프로덕션(멀티 영역))를 표시합니다.

  2. AlloyDB Express 카드에서 클러스터 만들기를 클릭하여 AlloyDB Express 클러스터 만들기 창을 엽니다.

  3. AlloyDB Express 클러스터 만들기 창에서 클러스터를 구성합니다.

  4. 클러스터 만들기를 클릭합니다.

    Google Cloud 콘솔은 AlloyDB Express 클러스터와 vCPU 1개 기본 인스턴스를 만들고, 기본적으로 Private Service Connect와 공개 DNS를 모두 사용 설정한 다음, 데이터베이스를 쿼리할 수 있도록 AlloyDB Studio를 엽니다.

    Google Cloud 콘솔에서 클러스터를 만드는 동안에는 연결 설정을 변경할 수 없지만 나중에 인스턴스의 연결 설정을 수정하여 승인된 외부 네트워크 또는 Private Service Connect 설정을 업데이트할 수 있습니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

  1. 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입니다.
  2. 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를 생략합니다.

REST

  1. 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"
      }
    }
    
  2. 클러스터 생성 작업이 완료되면 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 클라이언트에서는 단일 프롬프트를 사용하여 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 도구를 직접 호출하려면 다음 단계를 따르세요.

  1. AlloyDB Express 클러스터를 만들려면 MCP 클라이언트에 프롬프트를 입력하거나 express_config.enabled를 true로 설정하여 create_cluster MCP 도구를 호출합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    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
          }
        }
      }
    }
    

    VPC 네트워크에서 Private Service Connect에 연결할 수 있도록 하려면 기본 인스턴스를 만들거나 업데이트할 때 "psc_instance_config"에서 소비자Google Cloud 프로젝트를 허용 목록에 추가합니다.

  2. create_cluster 도구는 장기 실행 작업을 반환합니다. done가 true이고 클러스터가 READY 상태가 될 때까지 get_operation MCP 도구를 사용하여 작업 상태를 폴링합니다.

  3. AlloyDB Express 클러스터에 기본 인스턴스를 만들려면 MCP 클라이언트에 프롬프트를 입력하거나 create_instance MCP 도구를 호출합니다. 연결 설정을 선택합니다.

    • Public 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"
            ]
          }
        }
      }
    }
    
  4. done가 true이고 인스턴스가 READY 상태가 될 때까지 get_operation MCP 도구를 사용하여 인스턴스 생성 작업을 폴링합니다.

AlloyDB Express 인스턴스에 연결

AlloyDB Express는 다음과 같은 인바운드 데이터베이스 연결 옵션을 지원합니다.

  • 공개 DNS(기본값): VPC 네트워크 외부의 클라이언트에서 연결할 수 있도록 공개적으로 라우팅 가능한 DNS 이름(networkInfo.publicDnsName)을 제공합니다.
  • Private Service Connect: 데이터베이스를 공개 인터넷에 노출하지 않고 Private Service Connect 엔드포인트를 통해 VPC 네트워크 내에서 인스턴스에 비공개로 연결할 수 있습니다.

공개 DNS를 통해 연결

VPC 네트워크 외부에서 공개 DNS를 통해 연결하는 경우 다음 중 하나를 수행할 수 있습니다.

PostgreSQL 클라이언트를 사용하여 직접 연결

기본적으로 공개 DNS 엔드포인트는 모든 직접 클라이언트 IP 주소를 거부합니다. psql에 직접 연결하기 전에 클라이언트 CIDR 블록을 허용 목록에 추가해야 합니다.

  1. 기본 인스턴스에서 승인된 외부 네트워크를 구성합니다.

    승인된 외부 네트워크를 개별적으로 추가하거나 삭제할 수 없습니다. 업데이트할 때마다 기존 목록을 덮어씁니다. 허용할 모든 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"
          ]
        }
      }
    }
    
  2. 인스턴스의 공개 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"
        }
      }
    }
    
  3. 표준 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).
  4. 메시지가 표시되면 데이터베이스 사용자의 비밀번호를 입력합니다.

gcloud CLI 또는 인증 프록시를 사용하여 연결

승인된 외부 네트워크를 구성하지 않고 공개 DNS를 통해 연결하려면 gcloud beta alloydb connect 명령어 또는 독립형 인증 프록시 클라이언트(alloydb-auth-proxy)를 --public-ip 플래그와 함께 사용하면 됩니다. AlloyDB Express는 공개 IP 주소 대신 공개 DNS 이름을 표시하지만, 컨트롤 플레인은 --public-ip를 지정할 때 인증 프록시가 자동으로 확인하는 인스턴스의 기본 공개 연결을 프로비저닝합니다.

로컬 인증 프록시 인스턴스를 시작하고 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를 사용하여 연결을 참조하세요.

또는 --public-ip 플래그를 사용하여 독립형 인증 프록시 클라이언트를 다운로드하고 실행할 수 있습니다.

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

독립형 인증 프록시 클라이언트를 통해 다운로드, 구성, 연결하는 방법에 대한 자세한 내용은 AlloyDB 인증 프록시를 사용하여 연결을 참조하세요.

Private Service Connect를 통해 연결

데이터베이스를 공개 인터넷에 노출하지 않고 VPC 네트워크 내에서 비공개로 연결하려면 AlloyDB Express 인스턴스에서 Private Service Connect를 구성하면 됩니다. VPC 네트워크 내의 클라이언트에서 직접 또는 인증 프록시를 사용하여 Private Service Connect 엔드포인트에 연결할 수 있습니다. Private Service Connect에 연결하는 방법에 대한 자세한 내용은 Private Service Connect를 사용하여 인스턴스에 연결을 참조하세요.

AlloyDB Express에 대한 안내를 따를 때는 Private Service Connect가 사용 설정된 AlloyDB Express 클러스터 및 인스턴스 만들기에 설명된 대로 클러스터와 vCPU 1개 영역 기본 인스턴스를 만듭니다. AlloyDB Express는 단일 영역 기본 인스턴스에 대한 인바운드 Private Service Connect 연결을 지원합니다.

AlloyDB Express 인스턴스 수정

AlloyDB Express 기본 인스턴스의 CPU 수(vCPU 1개 또는 vCPU 2개) 또는 데이터베이스 플래그를 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.

  3. 개요 페이지의 클러스터의 인스턴스 섹션에서 기본 인스턴스를 찾아 기본 수정을 클릭합니다(또는 인스턴스 작업 > 수정 클릭).

  4. 기본 인스턴스 수정 페이지에서 인스턴스 설정을 업데이트합니다.

    • 머신의 머신 유형 목록에서 vCPU 1개, 4GB 또는 vCPU 2개, 8GB를 선택합니다.
    • 선택사항: 데이터베이스 플래그를 구성하려면 플래그를 펼치거나(또는 고급 옵션 표시를 클릭하고 플래그를 펼침) 플래그 추가를 클릭합니다. 새 데이터베이스 플래그 목록에서 플래그를 선택하고 값을 입력한 후 완료를 클릭합니다.
  5. 인스턴스 업데이트를 클릭합니다.

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 수(vCPU 1개, RAM 4GB의 경우 1, vCPU 2개, RAM 8GB의 경우 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 수 또는 데이터베이스 플래그를 업데이트하려면 PATCH 요청을 projects.locations.clusters.instances.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 클러스터 또는 인스턴스에 대한 세부정보를 확인하고, 클러스터의 컴퓨팅 및 스토리지 사용량을 확인할 수 있습니다.

자세한 내용은 클러스터 목록 보기, 클러스터 세부정보 보기, 인스턴스 세부정보 보기를 참조하세요.

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

    리소스 이름 열에서 AlloyDB Express 클러스터는 클러스터 이름 옆에 Express 태그를 표시합니다.

  2. 클러스터 및 기본 인스턴스에 대한 자세한 정보를 보려면 리소스 이름 열에서 클러스터 이름을 클릭합니다.

  3. 개요 페이지에서 클러스터 세부정보(클러스터 ID 옆의 Express 태그 및 20GB 한도 중 사용된 총 스토리지 포함) 아래의 클러스터 세부정보와 클러스터의 인스턴스 아래의 기본 인스턴스 세부정보를 확인합니다.

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 콘솔에서 클러스터의 개요 페이지를 엽니다.

    • 사용된 스토리지: 클러스터 세부정보에서 사용된 총 스토리지를 확인하여 클러스터가 20GB 한도 중 얼마나 사용하고 있는지 확인합니다.
    • 컴퓨팅 및 연결: 개요 페이지에서 CPU 사용률 및 활성 연결 차트를 보거나 탐색 메뉴에서 시스템 통계를 클릭하여 자세한 CPU, 메모리, 스토리지 측정항목을 확인합니다.
  • Cloud Monitoring 측정항목 탐색기에서 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 기본 인스턴스 또는 클러스터를 삭제할 수 있습니다.

자세한 내용은 인스턴스 삭제 및 클러스터 삭제를 참조하세요.

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.

  3. 개요 페이지에서 기본 인스턴스 또는 클러스터를 삭제합니다.

    • 기본 인스턴스를 삭제하려면 클러스터의 인스턴스 섹션으로 이동하여 인스턴스 작업 > 삭제를 클릭하고 대화상자에 인스턴스 ID를 입력한 후 삭제를 클릭합니다.
    • 클러스터를 삭제하려면 먼저 클러스터의 기본 인스턴스를 삭제한 후 클러스터 삭제를 클릭하고 클러스터 삭제 대화상자에 클러스터 ID를 입력한 후 삭제를 클릭합니다.

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 수(vCPU 1개 또는 vCPU 2개)를 유지하고 AlloyDB Express 1:4 vCPU 대 메모리 비율(4GB 또는 8GB RAM)에서 AlloyDB 1:8 vCPU 대 메모리 비율(vCPU 1개의 경우 8GB RAM 또는 vCPU 2개의 경우 16GB RAM)로 업그레이드됩니다. 업그레이드 후에는 컴퓨팅을 최대 288개의 vCPU로 확장할 수 있습니다.
    • vCPU 1개 인스턴스를 업그레이드할 때는 C4A 머신 시리즈를 지원하는 리전으로 제한됩니다. 지원되는 지역은 C4A의 리전별 가용성을 참조하세요.
    • AlloyDB Express 인스턴스가 C4A 머신 유형을 지원하는 리전에 없는 경우 업그레이드하기 전에 먼저 기본 인스턴스를 2 vCPU 구성으로 업데이트해야 합니다. Google Cloud 콘솔에서 지원되지 않는 리전의 1 vCPU 인스턴스에 대해 업그레이드를 클릭하면 먼저 인스턴스 크기를 2 vCPU로 조절하라는 메시지가 표시됩니다.
  • 프로비저닝된 컴퓨팅 및 결제: 업그레이드하면 Scale-to-zero 컴퓨팅 기능이 사용 중지되고 인스턴스가 AlloyDB 요금으로 청구되는 상시 사용 AlloyDB 인스턴스로 실행됩니다.
  • 저장용량: 업그레이드하면 20GB 저장용량 한도가 삭제됩니다. 스토리지는 클러스터당 기본 할당량인 16TiB까지 확장되며 스토리지 한도 증가를 요청하여 최대 128TiB까지 확장할 수 있습니다.
  • 엔터프라이즈 기능: 업그레이드하면 99.99% 업타임 서비스수준계약(SLA)이 적용되는 리전별 고가용성(HA)이 잠금 해제됩니다. 또한 읽기 풀 인스턴스, 리전 간 복제, 지속적인 백업 및 복구, 자동 및 주문형 백업을 사용할 수 있습니다.

AlloyDB Express 클러스터를 AlloyDB 클러스터로 업그레이드하려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.

  3. 개요 페이지의 클러스터 세부정보에서 클러스터 ID를 찾은 후 업그레이드를 클릭합니다.

    기본 인스턴스가 C4A 머신 시리즈를 지원하지 않는 리전의 1vCPU 인스턴스인 경우 다음 메시지가 표시됩니다.

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

    인스턴스 크기를 vCPU 2개로 조절하려면 인스턴스 수정을 클릭합니다. 인스턴스 크기를 조절한 후 업그레이드를 다시 클릭합니다.

  4. 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 머신 시리즈를 지원하지 않는 리전의 vCPU 1개 인스턴스인 경우 다음 오류와 함께 명령어가 실패합니다.

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.

이 오류를 해결하려면 기본 인스턴스를 vCPU 2개(--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 머신 시리즈를 지원하지 않는 리전의 vCPU 1개 인스턴스인 경우 다음 오류와 함께 요청이 실패합니다.

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.

이 오류를 해결하려면 기본 인스턴스를 vCPU 2개("machineConfig": {"cpuCount": 2})로 업데이트한 후 업그레이드 요청을 다시 전송합니다.

다음 단계