Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

クイックスタート移行を使用して Cloud SQL に移行する

このページでは、Cloud SQL for PostgreSQL への同種の PostgreSQL 移行でクイックスタート移行を実行する方法について説明します。

概要

クイックスタート移行は、同種の PostgreSQL シナリオ向けの軽量な継続的移行フローです。クイックスタート移行を使用すると、Database Migration Service は、データベースの移行に必要なすべてのもの（ネットワークコンポーネント（ネットワークアタッチメント、サブネット、プライベート接続構成）、接続プロファイル、移行ジョブ）を自動的に設定できます。

クイックスタート移行を使用すると、データを既存の Cloud SQL インスタンスに移動したり、移行の構成時に新しいインスタンスを作成したりできます。クイックスタート移行は、次の場合に最適です。

データダンプの並列処理設定を正確に制御する必要がない基本的な移行。
データベースをある Google Cloud プロジェクトから別のプロジェクトに移行する。クイックスタート移行を構成するときに、移行元とは異なるプロジェクトに移行先インスタンスを作成し、別のプロジェクトの Virtual Private Cloud（VPC）ネットワークにネットワークアタッチメントとサブネットを作成するように Database Migration Service を設定できます。
Google CloudVirtual Private Cloud（VPC）ネットワークにプライベート IP アドレスを持つソース（Compute Engine 上のセルフマネージドデータベースや、プライベートネットワーキングが有効になっている Cloud SQL for PostgreSQL インスタンスなど）から移行する。

Google Cloud の外部でホストされているソースは、VPC ネットワーク内のプライベート IP アドレスでアクセスできるように、追加のネットワークコンポーネント（Cloud VPN 接続など）が必要になる場合があります。
ソースデータベースには、VPC ネットワークで割り当てられたプライベート IP アドレスが必要です。Database Migration Service は、Private Service Connect インターフェース（ネットワークアタッチメント）を使用して移行元データベースに接続します。クイックスタート移行では、パブリック IP 接続はサポートされていません。

クイックスタート移行の詳細については、Database Migration Service のメインドキュメントのクイックスタート移行の概要をご覧ください。

始める前に

クイックスタート移行がシナリオを完全にサポートできるかどうかを確認します。クイックスタート移行の制限事項をご覧ください。
Google Cloud コンソールのプロジェクトセレクタページで、 Google Cloud プロジェクトを選択または作成します。
プロジェクトセレクタに移動
Database Migration Service、Compute Engine、Network Connectivity Center、Cloud SQL Admin API を有効にします。
API を有効にする

必要なロール

Database Migration Service を使用して Cloud SQL へのクイックスタート移行を実行するために必要な権限を取得するには、関連するプロジェクトの移行に関係するアカウントに必要な Identity and Access Management（IAM）ロールを付与するよう管理者に依頼してください。ロールの付与の詳細については、IAM ドキュメントのアクセス権の管理をご覧ください。

ソースプロジェクトのロールと権限

ソース データベースが存在する Google Cloud プロジェクトの特定のアカウントに、次のロールを付与します。

移行を実行するユーザーアカウントの場合: Compute ネットワーク管理者ロール（roles/compute.networkAdmin）
宛先プロジェクトの Database Migration Service サービスアカウントの場合: Compute ネットワーク閲覧者（roles/compute.networkViewer）
Database Migration Service サービスアカウントは、Database Migration Service API を有効にすると作成されます。このサービスアカウントに関連付けられたメールアドレスは自動的に生成され、変更できません。このメールアドレスの形式は次のとおりです。
```
service-DESTINATION_PROJECT_NUMBER@gcp-sa-datamigration.iam.gserviceaccount.com
```

これらの事前定義ロールには、Database Migration Service を使用したクイックスタート移行の一環として、ソース データベースプロジェクトで接続を設定するために必要な権限が含まれています。必要な権限を正確に確認するには、[必要な権限（ソース）] セクションを開いてください。

必要な権限（ソース）

Database Migration Service を使用して同種のクイックスタート移行を実行するには、次の権限が必要です。

移行を実行するユーザーアカウントの場合:

compute.networks.*
compute.subnetworks.*
compute.networkAttachments.*

宛先プロジェクトの Database Migration Service サービスアカウントの場合: compute.networkAttachments.get。

宛先プロジェクトのロールと権限

移行先データベースが存在する Google Cloud プロジェクトで移行を実行するユーザーアカウントに、次のロールを付与します。

データベース移行管理者（roles/datamigration.admin）
Cloud SQL 管理者（roles/cloudsql.admin）

これらの事前定義ロールには、Database Migration Service を使用したクイックスタート移行の一環として、移行先データベースプロジェクトに必要な移行コンポーネントを設定するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限（宛先）」セクションを開いてご確認ください。

必要な権限（宛先）

Database Migration Service を使用して同種のクイックスタート移行を実行するには、次の権限が必要です。

datamigration.*
cloudsql.instances.create
cloudsql.instances.delete
cloudsql.instances.get
cloudsql.instances.list
cloudsql.instances.update
cloudsql.instances.connect
cloudsql.instances.executeSql
cloudsql.instances.export
cloudsql.instances.import
cloudsql.instances.login
cloudsql.operations.get
cloudsql.users.get
cloudsql.users.list
cloudsql.users.create
cloudsql.users.update
cloudsql.users.delete

ソースデータベースの構成

ソース PostgreSQL データベースを構成するには、次の操作を行います。

インスタンスに移行専用のユーザーアカウントを作成します。
- Cloud SQL for PostgreSQL ソースについては、Cloud SQL ドキュメントのユーザーを作成するをご覧ください。
- その他のソースについては、データベースプロバイダのドキュメントまたは PostgreSQL のドキュメントのユーザーの作成と管理をご覧ください。
移行専用のユーザーアカウントに必要な権限を割り当てます。移行するデータベースごとに次のコマンドを実行します。
```
-- Grant the REPLICATION attribute
ALTER ROLE MIGRATION_USER REPLICATION;

-- Grant database-level permissions.
-- Repeat for each database you want to migrate.
GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;

-- Grant schema-level usage.
-- Repeat for each schema in each database you want to migrate.
GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;
```
次のように置き換えます。
- MIGRATION_USER は、移行ユーザーアカウントの名前に置き換えます。
- DATABASE_NAME は、移行するデータベースの名前に置き換えます。
- SCHEMA_NAME は、移行するデータベースのスキーマの名前に置き換えます。
移行ユーザーアカウントには、移行するテーブルに対するオーナー権限が必要です。このレベルのアクセス権を付与するには、次のいずれかを行います。
- Cloud SQL for PostgreSQL 以外のソースの場合のみ: 移行アカウントに SUPERUSER PostgreSQL ロールを割り当てます。
- すべてのソースの場合: 移行ユーザーアカウントを、テーブルを所有するユーザーグループに追加します。次のコマンドを実行します。
```
-- Grant table ownership.
GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;
```
  次のように置き換えます。
  - TABLE_OWNER_GROUP_NAME は、移行する各テーブルを所有するユーザーグループの名前に置き換えます。
  - MIGRATION_USER は、移行ユーザーアカウントの名前に置き換えます。
主キーのないテーブルの場合: Database Migration Service は、変更データキャプチャ（CDC）フェーズで主キーのないテーブルの UPDATE オペレーションまたは DELETE オペレーションを複製しません。このようなオペレーションをレプリケーションに含める場合は、REPLICA IDENTITY を使用して主キーのないテーブルを変更します。
```
ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;
```
次のように置き換えます。
- TABLE_NAME は、主キーのないテーブルの名前です。
- INDEX_NAME は、主キーのないテーブルの行を追跡できる一意のインデックスです。
データベースフラグを使用してレプリケーション設定を構成します。
セルフマネージドソース

データベースフラグの変更を保存するには、データベースを完全に再起動する必要があります。次の例では、SQL クエリを使用してフラグ値を変更します。SQL クエリを直接実行できない場合は、プロバイダのドキュメントでこれらのフラグを変更する手順を確認してください。
1. wal_level パラメータを logical に設定します。次のコマンドを実行します。
  ALTER SYSTEM SET wal_level = 'logical';
2. wal_sender_timeout パラメータを 0 に設定します。この値は、非アクティブなレプリケーション接続を終了するために使用するタイムアウトメカニズムを無効にします。次のコマンドを実行します。
  ALTER SYSTEM SET wal_sender_timeout = 0;
3. max_replication_slots パラメータを使用して、レプリケーションスロットの最大数を構成します。このパラメータは、移行ジョブごとに移行するデータベースの数に、テーブル同期用の予約分を加えた値以上に設定する必要があります。
  たとえば、5 つのデータベースを移行し、移行元インスタンスに 2 つの移行ジョブが作成されている場合、レプリケーションスロットの数は 5 * 2 = 10 以上にする必要があります。これに、すでに使用されているレプリケーションスロットの数を加えます。
  
  このパラメータを設定するには、次のコマンドを実行します。
  
  ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
  ここで、NUMBER_OF_SLOTS はレプリケーションスロットの最大数を表します。
4. max_wal_senders パラメータを、少なくとも max_replication_slots と同じ値に、インスタンスですでに使用されている送信者の数を加えた値に構成します。
  たとえば、max_replication_slots パラメータが 10 に設定されていて、すでに 2 つの送信者を使用している場合、同時に実行される WAL 送信者プロセスの数は 10 + 2 = 12 になります。
  
  このパラメータを設定するには、次のコマンドを実行します。
  
  ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
  ここで、NUMBER_OF_SENDERS は同時に実行される WAL 送信者プロセスの数を表します。
5. max_worker_processes は、移行するデータベースの数と、インスタンスですでに使用されている max_worker_processes の数の合計以上に設定します。このパラメータを設定するには、次のコマンドを実行します。
  ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
  ここで、NUMBER_OF_PROCESSES は移行されるデータベースの数を表します。
Cloud SQL for PostgreSQL ソース

Cloud SQL ソースの場合、 Google Cloud コンソールでデータベースフラグを構成します。設定を有効にするには、データベースフラグを変更した後にインスタンスを再起動する必要があります。Cloud SQL でデータベースフラグを設定する方法については、Cloud SQL ドキュメントのデータベースフラグを構成するをご覧ください。
1. cloudsql.logical_decoding フラグを on に設定します。このフラグを有効にすると、設定を有効にするためにインスタンスの再起動が必要になります。
2. wal_sender_timeout パラメータを 0 に設定します。この値は、非アクティブなレプリケーション接続を終了するために使用するタイムアウトメカニズムを無効にします。
3. max_replication_slots パラメータを使用して、レプリケーションスロットの最大数を構成します。このパラメータは、移行ジョブごとに移行するデータベースの数に、テーブル同期用の予約分を加えた値以上に設定する必要があります。
  たとえば、5 つのデータベースを移行し、移行元インスタンスに 2 つの移行ジョブが作成されている場合、レプリケーションスロットの数は 5 * 2 = 10 以上にする必要があります。これに、すでに使用されているレプリケーションスロットの数を加えます。
4. max_wal_senders パラメータを、少なくとも max_replication_slots と同じ値に、インスタンスですでに使用されている送信者の数を加えた値に構成します。
  たとえば、max_replication_slots パラメータが 10 に設定されていて、すでに 2 つの送信者を使用している場合、同時に実行される WAL 送信者プロセスの数は 10 + 2 = 12 になります。
5. max_worker_processes は、移行するデータベースの数と、インスタンスですでに使用されている max_worker_processes の数の合計以上に設定します。

クイックスタート移行を作成して実行する

コンソール

Google Cloud コンソールを使用してクイックスタート移行を作成して実行するには、次の操作を行います。

Google Cloud コンソールで、[使ってみる] ページに移動します。
[スタートガイド] に移動
[ソースエンジン] メニューで [PostgreSQL] を選択します。
[移行先エンジン] メニューで、[Cloud SQL for PostgreSQL] を選択します。
[クイックスタート PostgreSQL 移行の紹介] セクションが表示されます。
[クイックスタート PostgreSQL 移行の紹介] セクションで、[移行を開始] をクリックします。
[Cloud SQL for PostgreSQL への移行] ページが開きます。
[移行を構成する] セクションで、次の操作を行います。
1. [宛先リージョン] メニューから、宛先 Cloud SQL インスタンスのリージョンを選択します。
2. [移行接頭辞] ボックスに、クイックスタート移行用に作成されたすべての移行エンティティ（接続プロファイル、プライベート接続構成、ネットワークアタッチメントとそのサブネット、移行ジョブ）の名前に追加される、わかりやすい文字列を入力します。
3. [構成タイプ] メニューから、次のいずれかを選択します。
  1. 既存の接続構成: ネットワークアタッチメントと、Private Service Connect インターフェースメソッドを使用するプライベート接続構成がすでにある場合は、このオプションを選択します。このオプションは、以前にクイックスタート移行を使用し、同じネットワーキングリソースを再利用する場合に最適です。
  2. 新しい接続構成: このオプションを選択すると、ソースデータベースの VPC ネットワークに新しいネットワークアタッチメントとネットワークアタッチメントサブネットが作成されます。プライベート接続構成は、宛先インスタンスと同じプロジェクトに作成されます。
4. [続行] をクリックします。
[ソースを接続] セクションで、次の操作を行います。
1. ソースデータベースのホスト名またはプライベート IP アドレスを入力します。ソースデータベースアドレスは、ソース VPC ネットワークから到達可能である必要があります。
2. ホストへのアクセスに使用するポートを入力します。デフォルトの PostgreSQL ポートは 5432 です。
3. 移行元データベースの専用移行アカウントのユーザー名とパスワードを入力します。
4. [暗号化タイプ] メニューから、次のいずれかを選択します。
  - なし: ソースデータベースで SSL/TLS 暗号化接続が必要ない場合。
  - 必須: ソースデータベースで SSL/TLS 暗号化接続が必要な場合。このオプションでは、証明書の検証は必要ありません。
5. [移行するデータベース] メニューで、[カスタマイズ] をクリックします。サイドパネルを使用して、Cloud SQL に移行するデータベースのみを選択します。
6. [続行] をクリックします。
[宛先を構成する] セクションで、新しい宛先インスタンスを作成するか、既存の宛先インスタンスを選択します。
新しいインスタンス

新しい宛先インスタンスを作成する場合は、次の操作を行います。
1. [移行先インスタンスのタイプ] メニューから、[新しいインスタンス] を選択します。
  Database Migration Service は、新しいインスタンスにデフォルトの Cloud SQL 構成を使用します。[カスタマイズ] をクリックして、マシンタイプ、ゾーンの可用性、データ保護設定などのインスタンス機能を調整します。インスタンス構成の詳細については、Cloud SQL ドキュメントのインスタンスの作成をご覧ください。
2. [パスワード] フィールドに、デフォルトの postgres 管理者ユーザーのパスワードを入力します。Database Migration Service は、このユーザーとして接続してデータを移行します。
既存のインスタンス

データベースは、既存のインスタンスに移行できます。宛先インスタンスで Private Service Connect が有効になっていて、mTLS 接続が適用されていないことを確認します。次のように対応します。
1. [移行先インスタンスのタイプ] メニューから、[既存のインスタンス] を選択します。
2. [既存のインスタンス ID] メニューから、インスタンス ID を選択します。
[移行を開始] をクリックします。
Database Migration Service が移行ジョブを作成し、移行プロセスを開始します。移行の進行状況は、Database Migration Service の移行ジョブの詳細でモニタリングできます。詳細については、移行ジョブを管理するをご覧ください。

gcloud

gcloud CLI を使用してクイックスタート移行を作成して実行するには、次の操作を行います。

ネットワークアタッチメントを構成する。
新しいネットワークアタッチメントを作成するか、既存のネットワークアタッチメントを再利用するかを決定します。ソースデータベースのプライベート IP に到達できるネットワークにネットワークアタッチメントが必要です。
- 新しいネットワークアタッチメントを作成する場合は、次のコマンドを実行します（クリックすると詳細が表示されます）。
  gcloud compute network-attachments create
  
  後述のコマンドデータを使用する前に、次のように置き換えます。
  - NETWORK_ATTACHMENT は、作成するネットワークアタッチメントの名前に置き換えます。
  - REGION は、ネットワークアタッチメントのリージョンに置き換えます。
  - DEST_PROJECT_ID は、宛先プロジェクトのプロジェクト ID に置き換えます。
  - SOURCE_PROJECT_ID は、ソースネットワークが存在するプロジェクトの ID に置き換えます。
  次のコマンドを実行します。
  Linux、macOS、Cloud Shell
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments create NETWORK_ATTACHMENT \ --region=REGION \ --connection-preference=ACCEPT_MANUAL \ --producer-accept-list=DEST_PROJECT_ID \ --subnets=default \ --project=SOURCE_PROJECT_ID
  Windows（PowerShell）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments create NETWORK_ATTACHMENT ` --region=REGION ` --connection-preference=ACCEPT_MANUAL ` --producer-accept-list=DEST_PROJECT_ID ` --subnets=default ` --project=SOURCE_PROJECT_ID
  Windows（cmd.exe）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments create NETWORK_ATTACHMENT ^ --region=REGION ^ --connection-preference=ACCEPT_MANUAL ^ --producer-accept-list=DEST_PROJECT_ID ^ --subnets=default ^ --project=SOURCE_PROJECT_ID
- 既存のネットワークアタッチメントを再利用する場合は、次のステップに進みます。
Database Migration Service テナントプロジェクトにネットワークアタッチメントへのアクセスを許可する。
ネットワークアタッチメントで、Database Migration Service テナントプロジェクトからの接続を許可する必要があります。次の手順を行います。
1. プライベート接続の作成をドライランで実行して、Database Migration Service テナントプロジェクト ID を取得します（クリックして展開）。
  gcloud database-migration private-connections create --validate-only
  
  後述のコマンドデータを使用する前に、次のように置き換えます。
  - PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。
  - REGION は、プライベート接続のリージョンに置き換えます。
  - NETWORK_ATTACHMENT_URI は、ネットワークアタッチメントの URI に置き換えます。
  次のコマンドを実行します。
  Linux、macOS、Cloud Shell
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration private-connections create PRIVATE_CONN \ --region=REGION \ --network-attachment=NETWORK_ATTACHMENT_URI \ --display-name=PRIVATE_CONN \ --format="value(metadata.metadata.tenant_project_id)" \ --validate-only
  Windows（PowerShell）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration private-connections create PRIVATE_CONN ` --region=REGION ` --network-attachment=NETWORK_ATTACHMENT_URI ` --display-name=PRIVATE_CONN ` --format="value(metadata.metadata.tenant_project_id)" ` --validate-only
  Windows（cmd.exe）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration private-connections create PRIVATE_CONN ^ --region=REGION ^ --network-attachment=NETWORK_ATTACHMENT_URI ^ --display-name=PRIVATE_CONN ^ --format="value(metadata.metadata.tenant_project_id)" ^ --validate-only
  返されたテナントプロジェクト ID を保存して、次のコマンドで使用します。
2. Database Migration Service テナントプロジェクトと宛先プロジェクトがネットワークアタッチメントに接続できるようにします（クリックして展開）。
  gcloud compute network-attachments update
  
  後述のコマンドデータを使用する前に、次のように置き換えます。
  - NETWORK_ATTACHMENT は、ネットワークアタッチメントの名前に置き換えます。
  - REGION はリージョンに置き換えます。
  - DEST_PROJECT_ID は、宛先プロジェクトのプロジェクト ID に置き換えます。
  - DMS_TENANT_ID は、取得した Database Migration Service テナントプロジェクト ID に置き換えます。
  - SOURCE_PROJECT_ID は、ソースネットワークが存在するプロジェクト ID に置き換えます。
  次のコマンドを実行します。
  Linux、macOS、Cloud Shell
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments update NETWORK_ATTACHMENT \ --region=REGION \ --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \ --project=SOURCE_PROJECT_ID
  Windows（PowerShell）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments update NETWORK_ATTACHMENT ` --region=REGION ` --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID ` --project=SOURCE_PROJECT_ID
  Windows（cmd.exe）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud compute network-attachments update NETWORK_ATTACHMENT ^ --region=REGION ^ --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID ^ --project=SOURCE_PROJECT_ID
Database Migration Service のプライベート接続リソースを作成する。
次のコマンドを実行します（クリックして展開）。
gcloud database-migration private-connections create

後述のコマンドデータを使用する前に、次のように置き換えます。
- PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。
- REGION は、プライベート接続のリージョンに置き換えます。
- NETWORK_ATTACHMENT_URI は、ネットワークアタッチメントの URI に置き換えます。
次のコマンドを実行します。
Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration private-connections create PRIVATE_CONN \ --region=REGION \ --network-attachment=NETWORK_ATTACHMENT_URI \ --display-name=PRIVATE_CONN
Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration private-connections create PRIVATE_CONN ` --region=REGION ` --network-attachment=NETWORK_ATTACHMENT_URI ` --display-name=PRIVATE_CONN
Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration private-connections create PRIVATE_CONN ^ --region=REGION ^ --network-attachment=NETWORK_ATTACHMENT_URI ^ --display-name=PRIVATE_CONN
ソース接続プロファイルを作成します。
次のコマンドを実行します（クリックして展開）。
gcloud database-migration connection-profiles create postgresql

このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。
- SOURCE_CONN_ID は、ソース接続プロファイル ID に置き換えます。
- REGION は、接続プロファイルを保存するリージョンに置き換えます。
- SOURCE_PRIVATE_IP は、ソースデータベースのプライベート IP アドレスに置き換えます。
- SOURCE_PORT は、ソースデータベースのポートに置き換えます（デフォルトは 5432）。
- SOURCE_USER は、ソースデータベースの移行ユーザーのユーザー名に置き換えます。
- SOURCE_PASSWORD は、移行元データベースの移行ユーザーのパスワードに置き換えます。
- PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。
次のコマンドを実行します。
Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration connection-profiles create postgresql \ SOURCE_CONN_ID \ --region=REGION \ --role=SOURCE \ --host=SOURCE_PRIVATE_IP \ --port=SOURCE_PORT \ --username=SOURCE_USER \ --password=SOURCE_PASSWORD \ --private-connection=PRIVATE_CONN \ --no-async
Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration connection-profiles create postgresql ` SOURCE_CONN_ID ` --region=REGION ` --role=SOURCE ` --host=SOURCE_PRIVATE_IP ` --port=SOURCE_PORT ` --username=SOURCE_USER ` --password=SOURCE_PASSWORD ` --private-connection=PRIVATE_CONN ` --no-async
Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration connection-profiles create postgresql ^ SOURCE_CONN_ID ^ --region=REGION ^ --role=SOURCE ^ --host=SOURCE_PRIVATE_IP ^ --port=SOURCE_PORT ^ --username=SOURCE_USER ^ --password=SOURCE_PASSWORD ^ --private-connection=PRIVATE_CONN ^ --no-async
宛先接続プロファイルを作成します。
新しい Cloud SQL インスタンスに移行するか、既存の Cloud SQL インスタンスに移行するかに応じて、タブを選択します。
新しいインスタンス

クイックスタート移行で新しい移行先インスタンスを使用するには、まず Cloud SQL Google Cloud CLI でインスタンスを作成してから、移行先接続プロファイルを作成します。手順は次のとおりです。
1. Cloud SQL Google Cloud CLI を使用してインスタンスを作成します。 --enable-private-service-connect フラグを使用して、移行先インスタンスで Private Service Connect を有効にしてください。クイックスタート移行では、Private Service Connect が有効なインスタンスのみがサポートされます。
2. 新しいインスタンスの宛先接続プロファイルを作成します。コマンドの詳細については、次のセクションを開いてください。
  
  gcloud database-migration connection-profiles create postgresql
  
  このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。
  
  後述のコマンドデータを使用する前に、次のように置き換えます。
  
  DEST_CONN_ID は、宛先接続プロファイルの識別子に置き換えます。
  
  REGION は、接続プロファイルを保存するリージョンに置き換えます。このリージョンは、宛先インスタンスのリージョンと同じにする必要があります。
  
  DEST_INSTANCE は、事前に作成した移行先の Cloud SQL インスタンスの ID に置き換えます。
  
  DEST_USER は、移行先データベースの移行ユーザーのユーザー名に置き換えます。
  
  DEST_PASSWORD は、移行先データベースの移行ユーザーのパスワードに置き換えます。
  
  次のコマンドを実行します。
  
  Linux、macOS、Cloud Shell
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \ --region=REGION \ --cloudsql-instance=DEST_INSTANCE \ --username=DEST_USER \ --password=DEST_PASSWORD \ --role=DESTINATION \ --no-async
  
  Windows（PowerShell）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ` --region=REGION ` --cloudsql-instance=DEST_INSTANCE ` --username=DEST_USER ` --password=DEST_PASSWORD ` --role=DESTINATION ` --no-async
  
  Windows（cmd.exe）
  
  注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
  
  gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^ --region=REGION ^ --cloudsql-instance=DEST_INSTANCE ^ --username=DEST_USER ^ --password=DEST_PASSWORD ^ --role=DESTINATION ^ --no-async
  
  次のようなレスポンスが返されます。
  
  Waiting for connection profile [CONNECTION_PROFILE_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
既存のインスタンス

既存の移行先インスタンスに移行するには、事前に作成したインスタンスを指す接続プロファイルを作成します。次のコマンドを実行します（クリックして展開）。
gcloud database-migration connection-profiles create postgresql

このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。

DEST_CONN_ID は、宛先接続プロファイルの識別子に置き換えます。

REGION は、接続プロファイルを保存するリージョンに置き換えます。このリージョンは、宛先インスタンスのリージョンと同じにする必要があります。

DEST_INSTANCE は、事前に作成した移行先の Cloud SQL インスタンスの ID に置き換えます。

DEST_USER は、移行先データベースの移行ユーザーのユーザー名に置き換えます。

DEST_PASSWORD は、移行先データベースの移行ユーザーのパスワードに置き換えます。

次のコマンドを実行します。

Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \ --region=REGION \ --cloudsql-instance=DEST_INSTANCE \ --username=DEST_USER \ --password=DEST_PASSWORD \ --role=DESTINATION \ --no-async

Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ` --region=REGION ` --cloudsql-instance=DEST_INSTANCE ` --username=DEST_USER ` --password=DEST_PASSWORD ` --role=DESTINATION ` --no-async

Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^ --region=REGION ^ --cloudsql-instance=DEST_INSTANCE ^ --username=DEST_USER ^ --password=DEST_PASSWORD ^ --role=DESTINATION ^ --no-async

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

Waiting for connection profile [CONNECTION_PROFILE_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
移行ジョブを作成します。
次のコマンドを実行します（クリックして展開）。
gcloud database-migration migration-jobs create

このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。
- MIGRATION_JOB_ID は、移行ジョブ ID に置き換えます。
- REGION は、移行ジョブを保存するリージョンに置き換えます。
- SOURCE_CONN_ID は、ソース接続プロファイルの ID に置き換えます。
- DEST_CONN_ID は、宛先接続プロファイルの ID に置き換えます。
- DATABASES_LIST は、移行するデータベースのカンマ区切りのリストに置き換えます。
次のコマンドを実行します。
Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs create \ MIGRATION_JOB_ID \ --region=REGION \ --type=CONTINUOUS \ --source=SOURCE_CONN_ID \ --destination=DEST_CONN_ID \ --use-postgres-native \ --postgres-max-additional-subscriptions=10 \ --databases-filter=DATABASES_LIST \ --no-async
Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs create ` MIGRATION_JOB_ID ` --region=REGION ` --type=CONTINUOUS ` --source=SOURCE_CONN_ID ` --destination=DEST_CONN_ID ` --use-postgres-native ` --postgres-max-additional-subscriptions=10 ` --databases-filter=DATABASES_LIST ` --no-async
Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs create ^ MIGRATION_JOB_ID ^ --region=REGION ^ --type=CONTINUOUS ^ --source=SOURCE_CONN_ID ^ --destination=DEST_CONN_ID ^ --use-postgres-native ^ --postgres-max-additional-subscriptions=10 ^ --databases-filter=DATABASES_LIST ^ --no-async
次のようなレスポンスが返されます。
Waiting for migration job [MIGRATION_JOB_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created migration job MIGRATION_JOB_ID [OPERATION_ID]
移行ジョブを実行します。
移行ジョブを開始する（クリックして展開）:
gcloud database-migration migration-jobs start

このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。
- MIGRATION_JOB_ID は、移行ジョブ ID に置き換えます。
  識別子がわからない場合は、 gcloud database-migration migration-jobs list コマンドを使用して、特定のリージョン内のすべての移行ジョブを一覧表示し、その識別子を確認できます。
- REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
次のコマンドを実行します。
Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs \ start MIGRATION_JOB_ID \ --region=REGION
Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs ` start MIGRATION_JOB_ID ` --region=REGION
Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
gcloud database-migration migration-jobs ^ start MIGRATION_JOB_ID ^ --region=REGION
結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す Operation エンティティを返します。
done: false metadata: '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata apiVersion: v1 createTime: '2024-02-20T12:20:24.493106418Z' requestedCancellation: false target: MIGRATION_JOB_ID verb: start name: OPERATION_ID
オペレーションが成功したかどうかを確認するには、返されたオペレーションオブジェクトをクエリするか、移行ジョブのステータスを確認します。
- gcloud database-migration migration-jobs describe コマンドと MIGRATION_JOB_ID を使用して、移行ジョブのステータスを表示します。
- OPERATION_ID を指定して gcloud database-migration operations describe コマンドを使用し、オペレーション自体のステータスを確認します。

移行を完了する

アプリケーションを新しい Cloud SQL インスタンスに切り替える場合は、次の手順に沿って移行を完了します。

ソースデータベースに対するすべての書き込みオペレーションを停止します。読み取り専用モードに切り替えて、運用機能を維持できます。
移行ジョブをプロモートする。クイックスタート移行の場合、移行プロセス中も移行先インスタンスは書き込み可能なままです。移行ジョブをプロモートすると、レプリケーションが終了するだけで、移行先インスタンスには影響しません。
省略可: 移行データの完全性を検証します。

次のステップ

Cloud SQL for PostgreSQL の機能の詳細。

クイック スタート移行を使用して Cloud SQL に移行する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

概要

始める前に

必要なロール

ソース プロジェクトのロールと権限

必要な権限（ソース）

宛先プロジェクトのロールと権限

必要な権限（宛先）

ソース データベースの構成

セルフマネージド ソース

Cloud SQL for PostgreSQL ソース

クイック スタート移行を作成して実行する

コンソール

新しいインスタンス

既存のインスタンス

gcloud

gcloud compute network-attachments create

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud database-migration private-connections create --validate-only

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud compute network-attachments update

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud database-migration private-connections create

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud database-migration connection-profiles create postgresql

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

新しいインスタンス

gcloud database-migration connection-profiles create postgresql

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

既存のインスタンス

gcloud database-migration connection-profiles create postgresql

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud database-migration migration-jobs create

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

gcloud database-migration migration-jobs start

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

結果

移行を完了する

次のステップ

クイックスタート移行を使用して Cloud SQL に移行する

ソースプロジェクトのロールと権限

ソースデータベースの構成

セルフマネージドソース

クイックスタート移行を作成して実行する

`gcloud compute network-attachments create`

`gcloud database-migration private-connections create --validate-only`

`gcloud compute network-attachments update`

`gcloud database-migration private-connections create`

`gcloud database-migration connection-profiles create postgresql`

`gcloud database-migration connection-profiles create postgresql`

`gcloud database-migration connection-profiles create postgresql`

`gcloud database-migration migration-jobs create`

`gcloud database-migration migration-jobs start`