이 문서에서는 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 관리자 (
roles/alloydb.admin) - 소유자(
roles/owner) - 편집자(
roles/editor) -
AlloyDB 원격 MCP 서버 사용: MCP 도구 사용자(
roles/mcp.toolUser)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
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 프로젝트를 허용 목록에 추가합니다.
콘솔
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 클러스터와 vCPU 1개 기본 인스턴스를 만들고, 기본적으로 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입니다.
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를 생략합니다.
- 공개 DNS만:
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_IDJSON 요청 본문:
{ "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_IDJSON 요청 본문:
{ "instanceType": "PRIMARY", "availabilityType": "ZONAL", "machineConfig": { "cpuCount": 1 }, "networkConfig": { "publicDnsEnabled": true }, "pscInstanceConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECT_ID" ] } }- 공개 DNS만:
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 도구를 직접 호출하려면 다음 단계를 따르세요.
AlloyDB Express 클러스터를 만들려면 MCP 클라이언트에 프롬프트를 입력하거나
express_config.enabled를true로 설정하여create_clusterMCP 도구를 호출합니다.요청 데이터를 사용하기 전에 다음을 바꿉니다.
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 } } } }VPC 네트워크에서 Private Service Connect에 연결할 수 있도록 하려면 기본 인스턴스를 만들거나 업데이트할 때
"psc_instance_config"에서 소비자Google Cloud 프로젝트를 허용 목록에 추가합니다.create_cluster도구는 장기 실행 작업을 반환합니다.done가true이고 클러스터가READY상태가 될 때까지get_operationMCP 도구를 사용하여 작업 상태를 폴링합니다.AlloyDB Express 클러스터에 기본 인스턴스를 만들려면 MCP 클라이언트에 프롬프트를 입력하거나
create_instanceMCP 도구를 호출합니다. 연결 설정을 선택합니다.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" ] } } } }done가true이고 인스턴스가READY상태가 될 때까지get_operationMCP 도구를 사용하여 인스턴스 생성 작업을 폴링합니다.
AlloyDB Express 인스턴스에 연결
AlloyDB Express는 다음과 같은 인바운드 데이터베이스 연결 옵션을 지원합니다.
- 공개 DNS(기본값): VPC 네트워크 외부의 클라이언트에서 연결할 수 있도록 공개적으로 라우팅 가능한 DNS 이름(
networkInfo.publicDnsName)을 제공합니다. - Private Service Connect: 데이터베이스를 공개 인터넷에 노출하지 않고 Private Service Connect 엔드포인트를 통해 VPC 네트워크 내에서 인스턴스에 비공개로 연결할 수 있습니다.
공개 DNS를 통해 연결
VPC 네트워크 외부에서 공개 DNS를 통해 연결하는 경우 다음 중 하나를 수행할 수 있습니다.
- PostgreSQL 클라이언트를 사용하여 직접 연결(예:
psql): 먼저 승인된 외부 네트워크에서 클라이언트 IP 주소를 허용 목록에 추가해야 합니다. - gcloud CLI 또는 인증 프록시를 사용하여 연결하거나 AlloyDB 언어 커넥터를 사용합니다. 트래픽을 자동으로 암호화하며 승인된 외부 네트워크를 구성할 필요가 없습니다.
PostgreSQL 클라이언트를 사용하여 직접 연결
기본적으로 공개 DNS 엔드포인트는 모든 직접 클라이언트 IP 주소를 거부합니다. psql에 직접 연결하기 전에 클라이언트 CIDR 블록을 허용 목록에 추가해야 합니다.
기본 인스턴스에서 승인된 외부 네트워크를 구성합니다.
승인된 외부 네트워크를 개별적으로 추가하거나 삭제할 수 없습니다. 업데이트할 때마다 기존 목록을 덮어씁니다. 허용할 모든 CIDR 블록의 쉼표로 구분된 목록을 제공합니다.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.
개요 페이지에서 클러스터의 인스턴스로 이동하여 기본 인스턴스를 찾고 인스턴스 작업 > 수정을 클릭합니다(또는 탐색 메뉴에서 연결로 이동하여 수정 클릭).
연결에서 공개 연결이 사용 설정되어 있는지 확인합니다.
승인된 외부 네트워크에 쉼표로 구분된 목록인 IPv4 CIDR 범위(예:
203.0.113.0/24)를 입력하거나 내 IP 사용을 클릭하여 현재 머신의/32IPv4 주소를 추가합니다.인스턴스 업데이트를 클릭합니다.
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.authorizedExternalNetworksJSON 요청 본문:
{ "networkConfig": { "authorizedExternalNetworks": [ { "cidrRange": "CIDR_RANGE1" }, { "cidrRange": "CIDR_RANGE2" } ] } }MCP
MCP 클라이언트에 프롬프트를 입력하거나
authorized_external_networks필드를 사용하여update_instanceMCP 도구를 호출합니다.요청 데이터를 사용하기 전에 다음을 바꿉니다.
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 이름을 가져옵니다.
콘솔
- Google Cloud 콘솔에서 클러스터 페이지로 이동하여 AlloyDB Express 클러스터 이름을 클릭합니다.
- 연결로 이동하거나 개요 페이지에서 기본 인스턴스 카드를 보고 인스턴스의 공개 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_IDMCP
MCP 클라이언트에 프롬프트를 입력하거나
get_instanceMCP 도구를 호출하고 응답에서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 또는 인증 프록시를 사용하여 연결
승인된 외부 네트워크를 구성하지 않고 공개 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개) 또는 데이터베이스 플래그를 업데이트할 수 있습니다.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.
개요 페이지의 클러스터의 인스턴스 섹션에서 기본 인스턴스를 찾아 기본 수정을 클릭합니다(또는 인스턴스 작업 > 수정 클릭).
기본 인스턴스 수정 페이지에서 인스턴스 설정을 업데이트합니다.
- 머신의 머신 유형 목록에서 vCPU 1개, 4GB 또는 vCPU 2개, 8GB를 선택합니다.
- 선택사항: 데이터베이스 플래그를 구성하려면 플래그를 펼치거나(또는 고급 옵션 표시를 클릭하고 플래그를 펼침) 플래그 추가를 클릭합니다. 새 데이터베이스 플래그 목록에서 플래그를 선택하고 값을 입력한 후 완료를 클릭합니다.
인스턴스 업데이트를 클릭합니다.
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 클러스터 또는 인스턴스에 대한 세부정보를 확인하고, 클러스터의 컴퓨팅 및 스토리지 사용량을 확인할 수 있습니다.
자세한 내용은 클러스터 목록 보기, 클러스터 세부정보 보기, 인스턴스 세부정보 보기를 참조하세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 AlloyDB Express 클러스터는 클러스터 이름 옆에 Express 태그를 표시합니다.
클러스터 및 기본 인스턴스에 대한 자세한 정보를 보려면 리소스 이름 열에서 클러스터 이름을 클릭합니다.
개요 페이지에서 클러스터 세부정보(클러스터 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_clustersMCP 도구를 호출합니다.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_clusterMCP 도구를 호출합니다.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_instanceMCP 도구를 호출합니다.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 기본 인스턴스 또는 클러스터를 삭제할 수 있습니다.
자세한 내용은 인스턴스 삭제 및 클러스터 삭제를 참조하세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.
개요 페이지에서 기본 인스턴스 또는 클러스터를 삭제합니다.
- 기본 인스턴스를 삭제하려면 클러스터의 인스턴스 섹션으로 이동하여 인스턴스 작업 > 삭제를 클릭하고 대화상자에 인스턴스 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 클러스터로 업그레이드하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 AlloyDB Express 클러스터 이름을 클릭합니다.
개요 페이지의 클러스터 세부정보에서 클러스터 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개로 조절하려면 인스턴스 수정을 클릭합니다. 인스턴스 크기를 조절한 후 업그레이드를 다시 클릭합니다.
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})로 업데이트한 후 업그레이드
요청을 다시 전송합니다.