인플레이스 업그레이드를 사용하여 Cloud SQL Enterprise Plus 버전으로 인스턴스 업그레이드

MySQL | PostgreSQL | SQL Server

이 페이지에서는 인플레이스 업그레이드 방법을 사용하여 Cloud SQL Enterprise 버전 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하는 방법을 설명합니다. 또한 Cloud SQL Enterprise Plus 버전 인스턴스를 Cloud SQL Enterprise 버전으로 다운그레이드하는 절차도 설명합니다.

Cloud SQL Enterprise Plus 버전으로 업그레이드하면 몇 가지 이점과 성능 개선사항을 활용할 수 있습니다. 자세한 내용은 SQL 서버용 Cloud SQL 버전 소개를 참조하세요.

이러한 기존 Cloud SQL Enterprise 버전 인스턴스 개선사항을 사용 설정하려면 Cloud SQL Enterprise Plus 버전으로 업그레이드해야 합니다. 업그레이드 프로세스를 완료하는 데 몇 분 정도 걸립니다. 또한 이 프로세스에서는 애플리케이션이 연결하는 엔드포인트를 변경할 필요가 없습니다.

시작하기 전에

SQL Server Enterprise 2019 또는 SQL Server Enterprise 2022에서 Cloud SQL Enterprise 버전 인스턴스가 실행 중인지 확인합니다.

참고: max server memory (mb) 플래그를 설정한 경우 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드한 후 플래그를 삭제하는 것이 좋습니다. 이렇게 하면 Cloud SQL이 플래그 값을 자동으로 관리할 수 있습니다. 그러나 값을 설정하려면 인스턴스를 업그레이드한 후 플래그 값을 다시 확인하고 VM 크기에 따라 값을 조정하면 됩니다.

Cloud SQL Enterprise Plus 버전으로 인스턴스 업그레이드

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

콘솔

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

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
수정을 클릭합니다.
Cloud SQL 버전 선택 섹션에서 업그레이드를 클릭합니다.
Enterprise Plus로 업그레이드 패널에서 인스턴스 ID를 입력한 후 버전 업그레이드를 클릭합니다.

또는 인스턴스 개요 페이지의 구성 섹션에서 업그레이드를 클릭하여 인스턴스를 업그레이드할 수도 있습니다.

gcloud

다음 코드 샘플에서는 인스턴스를 Cloud SQL Enterprise Plus 버전으로 업그레이드하는 방법을 보여줍니다.


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

다음을 바꿉니다.

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

REST

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

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

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

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 버전으로 업그레이드하고 다시 시작 작업을 트리거합니다.

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

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

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 Enterprise 버전으로 변경

콘솔

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

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
수정을 클릭합니다.
Cloud SQL 버전 선택 섹션에서 Enterprise로 전환을 클릭합니다.
Enterprise로 전환 패널에서 인스턴스 ID를 입력한 후 버전 전환을 클릭합니다.

또는 인스턴스 개요 페이지의 구성 섹션에서 Enterprise로 전환을 클릭하여 Cloud SQL Enterprise 버전으로 변경할 수도 있습니다.

gcloud

다음 코드 샘플에서는 인스턴스를 Cloud SQL Enterprise 버전으로 변경하는 방법을 보여줍니다.

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

다음을 바꿉니다.

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

REST

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

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

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

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

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_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/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 버전으로 변경하고 다시 시작 작업을 트리거합니다.

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

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

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

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 Enterprise Plus 버전 자세히 알아보기