インプレースアップグレードを使用してインスタンスをアップグレードする

MySQL | PostgreSQL | SQL Server

このページでは、インプレースアップグレード方法を使用して、Cloud SQL Enterprise エディションのインスタンスを Cloud SQL Enterprise Plus エディションにアップグレードする方法について説明します。また、Cloud SQL Enterprise Plus エディションのインスタンスを Cloud SQL Enterprise エディションにダウングレードする手順についても説明します。

Cloud SQL Enterprise Plus エディションにアップグレードすると、いくつかの利点とパフォーマンスの向上がもたらされます。詳細については、Cloud SQL for MySQL のエディションの概要をご覧ください。

既存の Cloud SQL Enterprise エディションインスタンスを強化できるようにするには、Cloud SQL Enterprise Plus エディションにアップグレードする必要があります。アップグレードプロセスは数分で完了し、予想されるダウンタイムは 60 秒未満です。また、このプロセスでは、接続先のエンドポイントをアプリケーションで変更する必要はありません。

要件

MySQL バージョン 8.0.31 以降で Cloud SQL Enterprise エディションインスタンスを実行していることを確認します。

インスタンスが以前のバージョンの MySQL にある場合は、Cloud SQL Enterprise Plus エディションにアップグレードする前に、インスタンスを MySQL 8.0.31 以降にアップグレードする必要があります。詳細については、データベースのメジャーバージョンをインプレースでアップグレードするとデータベースのマイナーバージョンをアップグレードするをご覧ください。

インスタンスでソリッドステートドライブ（SSD）が使用されていることを確認します。

インスタンスを 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

注: Cloud SQL では、アップグレードプロセス中に、インスタンスのデータキャッシュがデフォルトで有効になります。無効にするには、--no-enable-data-cache フラグを追加します。

次のように置き換えます。

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 エディションインスタンスのマシンタイプをご覧ください。

注: Cloud SQL では、アップグレードプロセス中に、インスタンスのデータキャッシュがデフォルトで有効になります。無効にするには、dataCacheEnabled パラメータを false に設定します。

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）

リクエスト本文を 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 エディションの詳細を確認する。

インプレース アップグレードを使用してインスタンスをアップグレードする

要件

インスタンスを Cloud SQL Enterprise Plus エディションにアップグレードする

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

Cloud SQL Enterprise エディションに切り替える

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

次のステップ

インプレースアップグレードを使用してインスタンスをアップグレードする