インスタンスのクローンを作成する

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスのクローンの作成方法について説明します。

Cloud SQL インスタンスのクローンを作成すると、ソースインスタンスのコピーであるが完全に独立した新しいインスタンスが作成されます。クローン作成の完了後にソースインスタンスを変更してもクローンに反映されることはなく、その逆も同様です。

ソースインスタンスの構成（アクティベーションポリシー、データベースフラグ、接続など）はクローンにコピーされます。インスタンス IP アドレスとレプリカはコピーされません。これらのアイテムは明示的にクローンで構成する必要があります。インスタンスのクローンを作成しても、既存のバックアップのクローンは作成されません。

レプリカのクローンを作成することはできません。別のインスタンスからクローン作成されたインスタンスのクローンを作成することは可能です。

過去の時点におけるインスタンスのクローンを作成できます。これは、破壊的なイベントからデータベースを回復するのに役立ちます。詳しくは、ポイントインタイムリカバリを行うをご覧ください。

第 2 世代インスタンスのクローンを作成する

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
Cloud SQL インスタンスページに移動
クローン作成元のインスタンスを見つけ、そのリストの右端にあるその他の操作メニューを開きます。
[クローンを作成] をクリックします。
[クローンの作成] ページで、必要に応じてインスタンス ID を更新し、[クローンを作成] をクリックします。[最新状態のインスタンスを複製] は選択されたままにしておきます。
クローンの初期化中に、インスタンスの一覧ページに戻ります。

gcloud

インスタンスのクローンを作成します。

    gcloud sql instances clone [SOURCE_INSTANCE_NAME] [TARGET_INSTANCE_NAME]

REST

インスタンスのクローンを作成します。

以下のリクエストのデータを使用する前に、次のように置き換えます。

project-id: プロジェクト ID
source-instance-id: ソースインスタンス ID
target-instance-id: ターゲットインスタンス ID

HTTP メソッドと URL:

POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

JSON 本文のリクエスト

    {
      "cloneContext":
      {
        "destinationInstanceName": "target-instance-id"
      }
    }

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 以下のコマンドでは、ご利用のユーザーアカウントで gcloud を認証する際に gcloud init または gcloud auth login を使用していることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を 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://www.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

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://www.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

    {
      "kind": "sql#operation",
      "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
      "status": "PENDING",
      "user": "user@example.com",
      "insertTime": "2020-01-21T22:43:37.981Z",
      "operationType": "CLONE",
      "name": "operation-id",
      "targetId": "target-instance-id",
      "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
      "targetProject": "project-id"
    }

第 1 世代インスタンスを作成する

gcloud

インスタンスの詳細を取得します。

    gcloud sql instances describe [INSTANCE_NAME]

backupConfiguration の下で binaryLogEnabled と enabled の値を見つけます。
値のいずれも有効になっていない場合は、すぐに有効にします。
1. バックアップを有効にします。
```
    gcloud sql instances patch [INSTANCE_NAME] --backup-start-time [HH:MM]
    
```
2. バイナリログを有効にします。
```
    gcloud sql instances patch [INSTANCE_NAME] --enable-bin-log
    
```
バックアップまたはバイナリログが有効になっていなかった場合は、バックアップが取得されるのを待ちます。
バックアップ期間によっては、これに最長で 1 日かかることがあります。

インスタンスのクローンを作成します。

    gcloud sql instances clone [SOURCE_INSTANCE_NAME] [TARGET_INSTANCE_NAME]

cURL

現在のバックアップ構成の値を取得します。

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         -X GET \
         https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[SOURCE_INSTANCE_NAME]?fields=settings

出力には backupConfiguration が含まれます。

    "backupConfiguration": [
     {
        "kind": "sql#backupConfiguration",
        "startTime": "12:00",
        "enabled": false,
        "binaryLogEnabled": false
     }

enabled または binaryLogEnabled のいずれかが false の場合、インスタンスリソースの patch メソッドを使用して、両方を有効にします。バックアップ構成のプロパティについて、現状を維持するものと、変更するものを指定します。
バックアップを有効にするには、enabled を true に設定し、startTime をバックアップウィンドウの開始値に設定します。バイナリロギングを有効にするには、binaryLogEnabled を true に設定します。
```
    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data '{"settings" : {"backupConfiguration" : {"startTime": "[HH:MM]", "enabled": true, "binaryLogEnabled": true}}}' \
         -X PATCH \
         https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[SOURCE_INSTANCE_NAME]
    
```
バックアップまたはバイナリログが有効になっていなかった場合は、バックアップが取得されるのを待ちます。
バックアップ期間によっては、これに最長で 1 日かかることがあります。

インスタンスのクローンを作成します。

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data '{"cloneContext": {"kind": "sql#cloneContext",
                  "destinationInstanceName": "[TARGET_INSTANCE_NAME]" }}' \
         -X POST \
         https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[SOURCE_INSTANCE_NAME]/clone