의견 보내기
읽기 풀 만들기 및 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Preview
This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section
of the Service Specific Terms .
You can process personal data for this feature as outlined in the
Cloud Data Processing
Addendum , subject to the obligations and restrictions described in the agreement under
which you access Google Cloud.
Pre-GA features are available "as is" and might have limited support.
For more information, see the
launch stage descriptions .
이 페이지에서는 대규모 읽기 워크로드의 읽기 풀 을 만들고 관리하는 방법을 설명합니다.
시작하기 전에
읽기 풀에는 기본 인스턴스의 사본이 포함됩니다. 아직 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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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": "[email protected] ",
"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-04-22(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-04-22(UTC)"],[],[]]