이 페이지의 일부 또는 모든 정보는 Trusted Cloud by S3NS에 적용되지 않을 수 있습니다.
읽기 풀 만들기 및 관리
MySQL
| PostgreSQL
| SQL Server
프리뷰
이 기능에는 서비스별 약관 의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다.
Cloud 데이터 처리 추가 조항 에 설명된 대로 이 기능에 대해 개인 정보를 처리할 수 있으며 Google Cloud 액세스에 따른 계약에 설명된 의무와 제한이 적용됩니다.
GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다.
자세한 내용은 출시 단계 설명 을 참조하세요.
이 페이지에서는 대규모 읽기 워크로드의 읽기 풀 을 만들고 관리하는 방법을 설명합니다.
시작하기 전에
읽기 풀에는 기본 인스턴스 복사본이 포함됩니다. Cloud SQL Enterprise Plus 버전 기본 인스턴스 를 아직 만들지 않았으면 만듭니다.
읽기 풀은 공개 IP 연결을 지원하지만 이 가이드에서는 비공개 IP(PSA) 연결을 사용하여 기본 인스턴스를 만듭니다.
기본 인스턴스와 복제에 대한 자세한 내용은 Cloud SQL의 복제 정보 를 참조하세요.
기본 인스턴스가 생성된 후 루트 사용자의 비밀번호를 선택하고 다음 명령어를 실행하여 기본 인스턴스에서 비밀번호를 설정합니다.
나중에 읽기 풀에 연결할 때 사용할 수 있도록 이 비밀번호를 저장합니다.
gcloud --project= PROJECT \
sql users set-password root --host= % \
--instance= PRIMARY_INSTANCE_NAME --prompt-for-password
gcloud
v516.0.0 이상을 사용하고 있는지 확인합니다.
다음을 바꿉니다.
PROJECT : 기본 인스턴스와 읽기 풀이 상주할 프로젝트의 이름
PRIMARY_INSTANCE_NAME : 기본 인스턴스 이름입니다.
읽기 풀 만들기
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances create
명령어를 사용하여 읽기 풀 노드가 여러 개 있는 읽기 풀을 만듭니다.
gcloud beta sql instances create READ_POOL_NAME \
--tier= TIER --edition= ENTERPRISE_PLUS \
--instance-type= READ_POOL_INSTANCE --node-count= NODE_COUNT \
--master-instance-name= PRIMARY_INSTANCE_NAME
다음을 바꿉니다.
READ_POOL_NAME : 읽기 풀에 사용할 이름
TIER : 읽기 풀의 각 읽기 풀 노드에 사용할 머신 유형(예: db-perf-optimized-N-4
)
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
PRIMARY_INSTANCE_NAME : 읽기 풀과 연결된 기본 인스턴스의 이름(예: my-primary-instance
)
REST v1
인스턴스 리소스의 insert
메서드를 사용하여 읽기 풀 노드가 여러 개 있는 읽기 풀을 만듭니다. databaseVersion
속성은 기본 인스턴스와 동일해야 합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 기본 인스턴스와 읽기 풀이 상주할 프로젝트의 이름
REGION : 읽기 풀 리전(예: us-east1
).
리전은 기본 인스턴스와 동일해야 합니다.
TIER : 읽기 풀의 각 읽기 풀 노드에 사용할 머신 유형(예: db-perf-optimized-N-4
)
PRIMARY_INSTANCE_NAME : 기본 인스턴스 이름입니다.
READ_POOL_NAME : 읽기 풀에 사용할 이름(예: my-read-pool
)
DATABASE_VERSION : 사용할 데이터베이스 버전.
예를 들면 POSTGRES_16
입니다.
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
FULL_NETWORK_NAME : 읽기 풀이 상주할 전체 네트워크 경로(예: projects/vpc-host-project/global/networks/my-network-name
)
HTTP 메서드 및 URL:
POST https://sqladmin.googleapis.com/v1/projects/PROJECT /instances
JSON 요청 본문:
{
"name": "READ_POOL_NAME ",
"masterInstanceName": "PRIMARY_INSTANCE_NAME ",
"project": "PROJECT ",
"databaseVersion": "DATABASE_VERSION ",
"region": "REGION ",
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT ,
"settings": {
"tier": "TIER ",
"edition": "ENTERPRISE_PLUS",
"ipConfiguration": {
"ipv4Enabled": false,
"privateNetwork": "FULL_NETWORK_NAME "
}
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method POST ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "CREATE_READ_POOL",
"name": "OPERATION_ID ",
"targetId": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
인스턴스 리소스의 insert
메서드를 사용하여 읽기 풀 노드가 여러 개 있는 읽기 풀을 만듭니다. databaseVersion
속성은 기본 인스턴스와 동일해야 합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 기본 인스턴스와 읽기 풀이 상주할 프로젝트의 이름
REGION : 읽기 풀 리전(예: us-east1
).
리전은 기본 인스턴스와 동일해야 합니다.
TIER : 읽기 풀의 각 읽기 풀 노드에 사용할 머신 유형(예: db-perf-optimized-N-4
)
PRIMARY_INSTANCE_NAME : 기본 인스턴스 이름입니다.
READ_POOL_NAME : 읽기 풀에 사용할 이름(예: my-read-pool
)
DATABASE_VERSION : 사용할 데이터베이스 버전.
예를 들면 POSTGRES_16
입니다.
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
FULL_NETWORK_NAME : 읽기 풀이 상주할 전체 네트워크 경로(예: projects/vpc-host-project/global/networks/my-network-name
)
HTTP 메서드 및 URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances
JSON 요청 본문:
{
"name": "READ_POOL_NAME ",
"masterInstanceName": "PRIMARY_INSTANCE_NAME ",
"project": "PROJECT ",
"databaseVersion": "DATABASE_VERSION ",
"region": "REGION ",
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT ,
"settings": {
"tier": "TIER ",
"edition": "ENTERPRISE_PLUS",
"ipConfiguration": {
"ipv4Enabled": false,
"privateNetwork": "FULL_NETWORK_NAME "
}
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method POST ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "CREATE_READ_POOL",
"name": "OPERATION_ID ",
"targetId": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
읽기 풀로 읽기 복제본 변환
풀의 노드 수를 지정하여 기존 Cloud SQL Enterprise Plus 버전 읽기 복제본을 읽기 풀로 변환할 수 있습니다. 이 변환 프로세스 중에 복제본 IP가 읽기 풀 IP(읽기 엔드포인트)가 되므로 재구성하지 않고 기존 클라이언트가 풀에 연결할 수 있습니다.
새로 생성된 읽기 풀 노드의 머신 유형과 구성은 원래 읽기 복제본과 동일합니다. 이 머신 유형이나 구성을 변경하려면 별도의 작업이 필요합니다. 이 작업은 영역 읽기 복제본에만 지원됩니다. 고가용성(HA) 읽기 복제본을 읽기 풀로 변환하려면 먼저 영역 읽기 복제본으로 변환해야 합니다.
자세한 내용은 읽기 풀 구성 수정 을 참조하세요.
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances patch
명령어를 사용하여 읽기 풀에서 사용할 읽기 복제본을 변환합니다.
gcloud beta sql instances patch READ_REPLICA_NAME \
--instance-type= READ_POOL_INSTANCE --node-count= NODE_COUNT
다음을 바꿉니다.
READ_REPLICA_NAME : 변환하려는 읽기 복제본의 이름
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
REST v1
인스턴스 리소스의 patch
메서드를 사용하여 읽기 복제본을 읽기 풀로 변환합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
READ_REPLICA_NAME : 변환하려는 읽기 복제본의 이름(예: my-read-replica
)
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME
JSON 요청 본문:
{
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_REPLICA_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
인스턴스 리소스의 patch
메서드를 사용하여 읽기 복제본을 읽기 풀로 변환합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
READ_REPLICA_NAME : 변환하려는 읽기 복제본의 이름(예: my-read-replica
)
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME
JSON 요청 본문:
{
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_REPLICA_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
읽기 복제본으로 읽기 풀 변환
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances patch
명령어를 사용하여 읽기 풀에서 사용할 읽기 복제본을 변환합니다.
gcloud beta sql instances patch READ_POOL_NAME \
--instance-type= READ_REPLICA_INSTANCE --availability-type= ZONAL
다음을 바꿉니다.
READ_POOL_NAME : 변환하려는 읽기 풀의 이름
REST v1
인스턴스 리소스의 patch
메서드를 사용하여 읽기 풀을 읽기 복제본으로 변환합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"instanceType": "READ_REPLICA_INSTANCE",
"settings": {
"availabilityType": "ZONAL"
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
인스턴스 리소스의 patch
메서드를 사용하여 읽기 풀을 읽기 복제본으로 변환합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"instanceType": "READ_REPLICA_INSTANCE",
"settings": {
"availabilityType": "ZONAL"
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
읽기 풀 정보 보기
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances describe
명령어를 사용하여 읽기 풀을 설명합니다.
gcloud beta sql instances describe READ_POOL_NAME
다음을 바꿉니다.
READ_POOL_NAME : 설명할 읽기 풀의 이름
IP 주소와 노드 정보가 포함된 응답 예시는 다음과 비슷합니다.
...
connectionName : my-project:us-central1:read-pool
ipAddresses :
- ipAddress : 10.3.0.108
type : PRIVATE
nodeCount : 2
nodes :
- dnsName : c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
gceZone : us-central1-f
ipAddresses :
- ipAddress : 10.3.0.112
type : PRIVATE
name : read-pool-node-01
state : RUNNABLE
- dnsName : 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
gceZone : us-central1-c
ipAddresses :
- ipAddress : 10.3.0.113
type : PRIVATE
name : read-pool-node-02
state : RUNNABLE
REST v1
get
메서드를 사용하여 읽기 풀 세부정보를 봅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
[...],
"connectionName": "my-project:us-central1:read-pool",
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.108"
}
],
"nodeCount": 2,
"nodes": [
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.112"
}
],
"name": "read-pool-node-01",
"gceZone": "us-central1-f",
"dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
},
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.113"
}
],
"name": "read-pool-node-02",
"gceZone": "us-central1-c",
"dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
}
]
}
REST v1beta4
get
메서드를 사용하여 읽기 풀 세부정보를 봅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{
[...],
"connectionName": "my-project:us-central1:read-pool",
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.108"
}
],
"nodeCount": 2,
"nodes": [
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.112"
}
],
"name": "read-pool-node-01",
"gceZone": "us-central1-f",
"dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
},
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.113"
}
],
"name": "read-pool-node-02",
"gceZone": "us-central1-c",
"dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
}
]
}
읽기 풀 노드 추가 또는 삭제
다음 단계에서는 읽기 풀의 읽기 풀 노드 수를 수정하여 읽기 풀을 확장하거나 축소합니다. 일부 작업 제한사항이 적용됩니다. 자세한 내용은 읽기 풀 제한사항 을 참조하세요.
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances patch
명령어를 사용하여 읽기 풀을 확장합니다.
gcloud beta sql instances patch READ_POOL_NAME \
--node-count= NODE_COUNT
다음을 바꿉니다.
READ_POOL_NAME : 읽기 풀 이름
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
REST v1
patch
메서드를 사용하여 읽기 풀의 읽기 풀 노드 수를 수정해 읽기 풀을 확장하거나 축소합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"nodeCount": NODE_COUNT
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
patch
메서드를 사용하여 읽기 풀의 읽기 풀 노드 수를 수정해 읽기 풀을 확장하거나 축소합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
NODE_COUNT : 읽기 풀에 사용할 읽기 풀 노드 수. 1
~20
사이의 숫자를 선택합니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"nodeCount": NODE_COUNT
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME INSTANCE_ID ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
읽기 풀 구성 수정
다음 단계에서는 읽기 풀 구성을 수정하는 방법을 보여줍니다. 자세한 내용은 인스턴스 설정 정보 및 인스턴스 수정 을 참조하세요.
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud beta sql instances patch
명령어를 사용하여 머신 유형을 수정하는 등 읽기 풀을 수직 확장합니다.
gcloud beta sql instances patch READ_POOL_NAME \
--tier= TIER
다음을 바꿉니다.
READ_POOL_NAME : 읽기 풀 이름
TIER : 읽기 풀의 각 읽기 풀 노드에 적용할 머신 유형(예: db-perf-optimized-N-8
)
REST v1
patch
메서드를 사용하여 읽기 풀 노드 구성을 수정합니다.
설정은 읽기 풀의 모든 읽기 풀 노드에 균일하게 적용됩니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
TIER : 읽기 풀의 각 읽기 풀 노드에 사용할 머신 유형(예: db-perf-optimized-N-4
)
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"settings": {
"tier": "TIER "
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
patch
메서드를 사용하여 읽기 풀 노드 구성을 수정합니다.
설정은 읽기 풀의 모든 읽기 풀 노드에 균일하게 적용됩니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
TIER : 읽기 풀의 각 읽기 풀 노드에 사용할 머신 유형(예: db-perf-optimized-N-4
)
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
JSON 요청 본문:
{
"settings": {
"tier": "TIER "
}
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
읽기 풀에 연결
읽기 풀에 연결하는 방법에는 여러 가지가 있습니다. 다음 단계에서는 연결 소스로 제공되는 같은 VPC 네트워크에 VM을 만들어 비공개 IP 주소로 읽기 풀에 연결하는 한 가지 방법을 보여줍니다.
Cloud SQL 인스턴스에 대한 연결을 구성하는 다른 방법에 대한 자세한 내용은 Cloud SQL 연결 정보 를 참조하세요.
연결 방법에서는 일반적으로 읽기 풀 정보 보기 의 설명대로 먼저 인스턴스의 IP 주소나 연결 이름을 가져와야 합니다.
읽기 풀은 다른 Cloud SQL 인스턴스에서 사용할 수 있는 대부분의 연결 방법을 지원하지만 몇 가지 제한사항 이 있습니다.
Cloud SQL 인증 프록시나 Cloud SQL 커넥터를 사용하여 연결하는 경우 최신 버전으로 업데이트해야 합니다. 읽기 풀 지원의 경우 필요한 최소 버전은 다음을 포함합니다.
Cloud SQL 인증 프록시: v2.15.2
Cloud SQL Python 커넥터: v1.18.0
Cloud SQL Go 커넥터: v1.16.0
Cloud SQL Node 커넥터: v1.7.0
Cloud SQL Java 커넥터: v1.24.0
읽기 풀 삭제
gcloud
gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치 를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용 을 참조하세요.
다음 gcloud sql instances delete
명령어를 사용하여 읽기 풀을 삭제합니다.
gcloud sql instances delete READ_POOL_NAME
다음을 바꿉니다.
READ_POOL_NAME : 삭제할 읽기 풀의 이름
REST v1
delete
메서드를 사용하여 읽기 풀을 삭제합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
delete
메서드를 사용하여 읽기 풀을 삭제합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT : 읽기 풀이 있는 프로젝트의 이름
READ_POOL_NAME : 읽기 풀 이름(예: my-read-pool
)
HTTP 메서드 및 URL:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-18(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-18(UTC)"],[],[],null,[]]