インプレースアップグレードを使用してインスタンスを 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 エディションにアップグレードすると、いくつかの利点とパフォーマンスの向上がもたらされます。詳細については、Cloud SQL for SQL Server のエディションの概要をご覧ください。

既存の Cloud SQL Enterprise エディションインスタンスを強化できるようにするには、Cloud SQL Enterprise Plus エディションにアップグレードする必要があります。アップグレードプロセスが完了するまでに数分かかります

また、このアップグレードプロセスでは、アプリケーションが接続するエンドポイントを変更する必要はありません。

始める前に

Cloud SQL Enterprise エディションインスタンスを SQL Server Enterprise 2019 または SQL Server Enterprise 2022 で実行していることを確認します。

注: max server memory (mb) フラグを設定した場合は、インスタンスを Cloud SQL Enterprise Plus エディションにアップグレードした後に、フラグを削除することをおすすめします。これにより、Cloud SQL はフラグの値を自動的に管理できるようになります。ただし、値を設定する場合は、インスタンスのアップグレード後にフラグの値を再確認し、VM のサイズに応じて値を調整できます。
ネットワークプロジェクトが 2021 年 8 月以降に作成されているか、新しいネットワークアーキテクチャに完全にアップグレードされていることを確認します。

インスタンスを 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 プライマリインスタンスの IP アドレスに自動的に解決されるグローバルドメイン名サービス（DNS）名です。レプリカのフェイルオーバーオペレーションの場合、このエンドポイントは着信接続を新しいプライマリインスタンスに自動的にリダイレクトします。SQL 接続文字列で IP アドレスの代わりに書き込みエンドポイントを使用できます。書き込みエンドポイントを使用すると、リージョンが停止した場合にアプリケーション接続を変更する必要がなくなります。

新しいネットワークアーキテクチャでプライベート IP アドレスを持つインスタンスを Cloud SQL Enterprise Plus エディションにアップグレードし、Google Cloud プロジェクトで DNS API を有効にすると、Cloud SQL は書き込みエンドポイントを自動的に生成します。ただし、インスタンスに関連付けられているサーバー証明書には、書き込みエンドポイント（グローバル DNS 名）が追加されません。したがって、DNS 名を確認するには、証明書をローテーションする必要があります。この証明書のローテーションが完了すると、Cloud SQL は DNS 名を証明書に追加します。DNS 名は、サーバー ID の検証に使用できます。

次のステップ

Cloud SQL Enterprise Plus エディションの詳細を確認する。

インプレース アップグレードを使用してインスタンスを 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）

書き込みエンドポイントを自動的に生成する

次のステップ

インプレースアップグレードを使用してインスタンスを Cloud SQL Enterprise Plus エディションにアップグレードする
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。