의견 보내기
읽기 풀 만들기 및 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
프리뷰
이 기능에는 서비스별 약관 의 일반 서비스 약관 섹션에 있는 '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 : 사용할 데이터베이스 버전입니다.
예를 들면 MYSQL_8_0_37
입니다.
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 : 사용할 데이터베이스 버전입니다.
예를 들면 MYSQL_8_0_37
입니다.
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
다음을 바꿉니다.
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"
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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"
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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-07-09(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-09(UTC)"],[],[]]