Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

인플레이스 업그레이드

MySQL | PostgreSQL | SQL Server

이 페이지에서는 Cloud SQL 인스턴스의 인플레이스 업그레이드 및 다운그레이드를 실행하는 방법을 설명합니다.

Cloud SQL 인스턴스에 인플레이스 변경하기

인플레이스 변경을 사용하여 Cloud SQL 인스턴스의 버전, 머신 유형, 스토리지 유형 또는 데이터베이스 버전을 업그레이드하거나 다운그레이드할 수 있습니다. 인플레이스 변경은 인스턴스를 재구성하는 가장 쉽고 오류가 발생할 가능성이 낮은 방법입니다.

시작하기 전에

인스턴스가 PostgreSQL 12 이상에서 실행 중인지 확인합니다.

인스턴스가 이전 버전의 PostgreSQL에서 실행되는 경우 PostgreSQL 12 이상으로 업그레이드해야 합니다. 자세한 내용은 데이터베이스 주 버전 인플레이스 업그레이드를 참조하세요.

머신 유형과 관련된 잠재적 스토리지 변경사항에 유의하기

버전마다 다른 스토리지 옵션을 사용하는 다른 머신 유형을 지원합니다. 고성능 C4 및 C4A 머신 유형은 Hyperdisk Balanced 스토리지를 이전 머신 유형에서 사용되는 영구 디스크 옵션 중 하나가 아닌 사용합니다.

사용 중인 버전 또는 머신 유형을 변경하면 스토리지 유형도 변경될 수 있으며, 이로 인해 다운타임이 발생하고 스토리지 비용이 변경될 수 있습니다. Google Cloud Hyperdisk Balanced로 이동할 때 지정할 수 있는 추가 구성 옵션이 있습니다. 자세한 내용은 스토리지 변경을 참조하세요.

PITR 트랜잭션 로그 스토리지 변경사항에 유의하기

디스크에 PITR에 사용되는 미리 쓰기 로그를 저장하는 Cloud SQL Enterprise 버전 인스턴스를 업그레이드하는 경우 Cloud SQL Enterprise Plus 버전으로의 업그레이드 프로세스에서 이러한 로그의 스토리지 위치를 디스크에서 Cloud Storage로 이동합니다. 인스턴스의 PITR 미리 쓰기 로그의 현재 위치를 확인하려면 PITR에 사용되는 트랜잭션 로그의 스토리지 위치 확인을 참조하세요.

인플레이스 업그레이드가 미리 쓰기 로그의 위치에 미치는 영향에 대한 자세한 설명은 다음 항목을 참조하세요. PITR의 미리 쓰기 로그의 스토리지 위치 변경

인스턴스 버전을 인플레이스로 변경하기

이 섹션에서는 Cloud SQL 인스턴스의 버전을 Cloud SQL Enterprise Plus 버전으로 또는 Cloud SQL Enterprise Plus 버전에서 인플레이스로 변경하는 방법을 보여줍니다. Cloud SQL Enterprise Plus 버전은 Cloud SQL Enterprise 버전에는 없는 몇 가지 이점과 성능 개선사항을 제공합니다. Cloud SQL 버전에 대한 자세한 내용은 Cloud SQL 버전 개요를 참조하세요.

Cloud SQL Enterprise Plus 버전으로 업그레이드하는 데 몇 분 정도 걸리며 다운타임은 거의 없습니다. Cloud SQL Enterprise 버전으로 다시 전환하면 다운타임이 더 길어집니다. 두 프로세스 모두 애플리케이션이 연결하는 엔드포인트를 변경할 필요가 없습니다.

이 섹션의 절차를 사용하여 Cloud SQL Enterprise 버전 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하거나 Cloud SQL Enterprise Plus 버전 인스턴스를 Cloud SQL Enterprise 버전으로 다운그레이드합니다.

콘솔

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
수정 을 클릭합니다.
인스턴스에서 Cloud SQL Enterprise 버전을 사용하는 경우 Cloud SQL 버전 선택 섹션에서 업그레이드 를 클릭하고, 인스턴스에서 Cloud SQL Enterprise Plus 버전을 사용하는 경우 Enterprise로 전환 을 클릭합니다.
열리는 패널을 사용하여 새 버전을 사용하여 인스턴스의 구성을 지정합니다. [인플레이스 변경 시 옵션](#change-options)을 참조하세요.
인스턴스 ID를 입력하여 이러한 선택사항을 확인한 후 업그레이드 또는 다운그레이드 여부에 따라 버전 업그레이드 또는 버전 전환 을 클릭합니다.

인스턴스의 작업 열에서 수정 을 선택하면 인스턴스 페이지에서 버전 변경을 시작할 수도 있습니다.

또한 인스턴스가 Cloud SQL Enterprise 버전에 있는 경우 인스턴스 페이지의 구성 섹션에 있는 버전 필드 옆에 있는 업그레이드 링크를 클릭하여 업그레이드를 시작할 수 있습니다.

gcloud

다음 [`gcloud sql instance patch`](/sdk/gcloud/reference/sql/instances/patch) 코드 샘플에서는 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하는 방법을 보여줍니다.

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

(선택사항) --enable-data-cache플래그를 추가하여 인스턴스에 데이터 캐시를 사용 설정할 수도 있습니다.

다음을 바꿉니다.

PROJECT_ID: 업그레이드할 인스턴스의 프로젝트 ID
INSTANCE_ID: 업그레이드할 인스턴스의 이름
MACHINE_TYPE: 업그레이드하려는 인스턴스의 머신 유형. Cloud SQL Enterprise Plus 버전의 머신 유형에 대한 자세한 내용은 머신 유형 Cloud SQL Enterprise Plus 버전 인스턴스의을 참조하세요.

REST

다음 명령어는 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하고 다시 시작 작업을 트리거합니다.

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

PROJECT_ID: 업그레이드할 인스턴스의 프로젝트 ID
INSTANCE_ID: 업그레이드할 인스턴스의 인스턴스 ID
MACHINE_TYPE: 업그레이드하려는 인스턴스의 머신 유형. Cloud SQL Enterprise Plus 버전의 머신 유형에 대한 자세한 내용은 Cloud SQL Enterprise Plus 버전 인스턴스의 머신 유형을 참조하세요.

(선택사항) dataCacheEnabled 파라미터를 true로 설정하여 데이터 캐시를 사용 설정할 수 있습니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 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_ID/instances/INSTANCE_ID"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 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_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

다음 명령어는 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하고 다시 시작 작업을 트리거합니다.

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

PROJECT_ID: 업그레이드할 인스턴스의 프로젝트 ID
INSTANCE_ID: 업그레이드할 인스턴스의 인스턴스 ID
MACHINE_TYPE: 업그레이드하려는 인스턴스의 머신 유형. Cloud SQL Enterprise Plus 버전의 머신 유형에 대한 자세한 내용은 Cloud SQL Enterprise Plus 버전 인스턴스의 머신 유형을 참조하세요.

(선택사항) dataCacheEnabled 파라미터를 true로 설정하여 데이터 캐시를 사용 설정할 수 있습니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

인플레이스 변경 옵션

Cloud SQL 인스턴스의 버전을 변경하려면 머신 시리즈를 변경해야 할 수 있으며, 이는 스토리지 유형에 영향을 미칩니다.

머신 변경

버전을 변경할 때는 머신 유형도 변경해야 합니다. Cloud SQL에서 지원하는 머신 시리즈에 대한 자세한 내용은 머신 시리즈 선택을 참조하세요.

Cloud SQL Enterprise 버전에서 Cloud SQL Enterprise Plus 버전으로 업그레이드할 때는 N2, C4A, 및 C4 머신 시리즈 중에서 선택할 수 있습니다.

Cloud SQL Enterprise Plus 버전에서 Cloud SQL Enterprise 버전으로 다운그레이드할 때는 범용 전용 코어와 N4 머신 시리즈 중에서 선택할 수 있습니다.

버전을 변경하지 않고 머신 유형을 변경할 수도 있습니다. 인스턴스 수정을 선택한 후 인스턴스 맞춤설정 영역의 머신 구성 에서 머신 하위 섹션으로 이동합니다. 드롭다운을 사용하여 다른 머신 유형을 선택할 수 있습니다. 또한 적절한 경우 다른 VCPU 수를 선택하고 데이터 캐시를 사용 설정하거나 사용 중지할 수 있습니다.

일반적인 정보는 Compute Engine 문서에서 N2, C4A, C4, N4 머신 시리즈에 대한 내용도 참조하세요.

스토리지 변경

범용 또는 N2 머신 시리즈에서 N4, C4A 또는 C4 머신 시리즈로 변경하는 경우 스토리지가 솔리드 스테이트 드라이브 (SSD) 에서 Google Cloud Hyperdisk Balanced 스토리지로 마이그레이션됩니다. 이 업그레이드에는 일반적으로 최소한의 다운타임이 필요합니다.

Google Cloud Hyperdisk Balanced 스토리지는 다음을 설정하여 사용 사례에 맞게 맞춤설정할 수 있습니다.

스토리지 용량
프로비저닝된 IOPS
프로비저닝된 처리량

Google Cloud Hyperdisk Balanced는 머신 유형과 스토리지 용량을 포함한 인스턴스의 구성을 기반으로 기본 IOPS 및 처리량 값과 한도를 설정합니다. 스토리지 용량은 기본값을 제한하고 머신 유형은 IOPS 및 처리량의 최댓값을 설정합니다. 자세한 내용은 스토리지 옵션 선택 을 참조하세요.

PITR의 미리 쓰기 로그의 위치 변경

Cloud SQL Enterprise 버전 인스턴스에서 PITR의 트랜잭션 로그를 디스크에 저장하는 경우 Cloud SQL Enterprise Plus 버전으로 업그레이드 프로세스를 시작하면 이러한 로그의 스토리지 위치가 Cloud Storage로 전환됩니다.

위치 변경에는 다음 조건이 적용됩니다.

이 프로세스는 Cloud Storage로의 전환을 완료하는 데 대략 transactionLogRetentionDays PITR 구성 설정 기간이 걸립니다.
Cloud Storage로 전환하는 동안에는 transactionLogRetentionDays PITR 구성 설정을 수정하지 않는 것이 좋습니다. transactionLogRetentionDays를 증가시키더라도 미리 쓰기 로그는 Cloud SQL Enterprise 버전 인스턴스의 기본 7일보다 오래 디스크에 보관되지 않습니다.

Cloud SQL Enterprise Plus 버전 백업 및 로그 스토리지 기본값

Cloud SQL Enterprise 버전으로 변경해도 PITR에 사용되는 트랜잭션 로그의 스토리지 위치는 전환되지 않습니다. Cloud SQL Enterprise Plus 버전 인스턴스에서 PITR의 트랜잭션 로그를 Cloud Storage에 저장하면 로그는 Cloud Storage에 있습니다. 하지만 기본적으로 PITR의 트랜잭션 로그를 14일 동안 저장하는 대신 기본값이 7일로 변경됩니다. 백업 구성은 변경되지 않습니다.

인플레이스 업그레이드 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Cloud SQL 인스턴스에 인플레이스 변경하기

시작하기 전에

머신 유형과 관련된 잠재적 스토리지 변경사항에 유의하기

PITR 트랜잭션 로그 스토리지 변경사항에 유의하기

인스턴스 버전을 인플레이스로 변경하기

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

인플레이스 변경 옵션

머신 변경

스토리지 변경

PITR의 미리 쓰기 로그의 위치 변경

Cloud SQL Enterprise Plus 버전 백업 및 로그 스토리지 기본값

인플레이스 업그레이드