インスタンスのクローン作成

MySQL   |  PostgreSQL   |  SQL Server

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

概要

Cloud SQL インスタンスのクローンを作成すると、元のインスタンスのコピーが新しいインスタンスとして作成されます。新しいインスタンスは、元のインスタンスから完全に独立しています。

よくある質問

質問	回答
クローン作成はパフォーマンスに影響しますか？	いいえ。クローンを作成しても、元のインスタンスのパフォーマンスに影響はありません。
バックアップは新しいインスタンスにコピーされますか？	いいえ。新しいインスタンスには新しいバックアップが自動的に作成されます。手動バックアップは元のインスタンスからコピーされません。
新しいインスタンスには同じ IP アドレスが割り振られますか？	いいえ。新しいインスタンスには、新しい IP アドレスが割り振られます。
新しいインスタンスの構成は元のインスタンスと同じですか？	はい。新しいインスタンスの設定（データベース フラグ、接続オプション、マシンタイプ、ストレージとメモリの設定）は元のインスタンスと同じです。
レプリカは新しいインスタンスにコピーされますか？	いいえ。新しいインスタンスに新しいレプリカを作成する必要があります。
レプリカのクローンを作成できますか？	いいえ。レプリカのクローンは作成できません。
過去の時点からクローンを作成できますか？	はい。ポイントインタイム リカバリを行うと、クローンを使用して過去の時点からインスタンスを復元できます。これは、破壊的なイベントからデータベースを回復する際に役立ちます。
クローンを作成したインスタンスのクローンを作成できますか？	はい。別のインスタンスからクローンを作成したインスタンスのクローンを作成できます。

インスタンスのクローンの作成

Console

1. Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。

   [Cloud SQL インスタンス] ページに移動

2. クローンを作成するインスタンスの行を見つけます。行の右端にある [その他の操作] メニューをクリックします。
3. [クローンを作成] をクリックします。
4. [クローンの作成] ページで、必要に応じてインスタンス ID を更新し、[最新状態のインスタンスのクローンを作成] を選択したまま、[クローンを作成] をクリックします。

   クローンの初期化中に、インスタンスの一覧ページに戻ります。

gcloud

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

gcloud sql instances clone [SOURCE_INSTANCE_NAME] [TARGET_INSTANCE_NAME]

REST v1beta4

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

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

• 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）

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

リクエスト本文を 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": "[e-mail]",
  "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"
}

トラブルシューティング

表内のリンクをクリックすると、詳細が表示されます。

この問題については...	次のような問題が考えられます...	次のことを試します...
constraints/sql.restrictAuthorizedNetworks エラーでクローンの作成に失敗する。	承認済みネットワークの構成によってブロックされています。	こちらのいずれかをお試しください。

---

constraints/sql.restrictAuthorizedNetworks エラーでクローンの作成に失敗する

constraints/sql.restrictAuthorizedNetworks エラーが表示され、クローンの作成に失敗します。

次のような問題が考えられます

クローン作成のオペレーションが、Authorized Networks 構成によってブロックされている。Authorized Networks は、Google Cloud Console の [接続] セクションでパブリック IP アドレスに構成されており、セキュリティに関する考慮事項により、クローン作成が許可されていません。

次の方法をお試しください

可能であれば、Cloud SQL インスタンスからすべての Authorized Networks エントリを削除します。それができない場合は、Authorized Networks エントリなしでレプリカを作成します。