接続プロファイルの管理

このページでは、接続プロファイルの表示、更新、削除の操作を行う方法について説明します。

接続プロファイルを表示する

接続プロファイルに関する次の情報を確認できます。

• プロファイルの作成時に指定したすべての構成の詳細。詳細については、 接続プロファイルの概要をご覧ください。

• 接続プロファイルの作成日時と最終更新日時。

• この接続プロファイルを使用する移行ジョブのリスト。

接続プロファイルの詳細を表示する手順は次のとおりです。

コンソール

1. Google Cloud コンソールで、[接続プロファイル] ページに移動します。

   [接続プロファイル] に移動する

2. 表示する接続プロファイルの表示名をクリックします。

   接続プロファイルの概要ページが表示されます。

gcloud

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

• REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
• CONNECTION_PROFILE_ID は、接続プロファイルの ID に置き換えます。

  識別子がわからない場合は、 gcloud database-migration connection-profiles list コマンドを使用して、特定のリージョン内のすべてのプロファイルを一覧表示し、その識別子を確認できます。

これらの値の詳細については、 接続プロファイルの概要をご覧ください。

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

Linux、macOS、Cloud Shell

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

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows（PowerShell）

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

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows（cmd.exe）

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

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

接続プロファイルを更新する

次の接続プロファイルの詳細を変更できます。

• 表示名
• （宛先プロファイルのみ）宛先の Cloud SQL for PostgreSQL インスタンス ID、データベースのユーザー名とパスワード

接続プロファイルを更新する手順は次のとおりです。

コンソール

1. Google Cloud コンソールで、[接続プロファイル] ページに移動します。

   [接続プロファイル] に移動する

2. 変更する接続プロファイルの表示名をクリックします。

   接続プロファイルの概要ページが表示されます。

3. [編集] をクリックして、接続プロファイルを更新します。
4. [保存] をクリックします。

gcloud

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

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

• CONNECTION_PROFILE_ID は、接続プロファイルの ID に置き換えます。

  識別子がわからない場合は、 gcloud database-migration connection-profiles list コマンドを使用して、特定のリージョン内のすべてのプロファイルを一覧表示し、その識別子を確認できます。

• REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
• （省略可）CONNECTION_PROFILE_NAME: 接続プロファイルの人が読める名前。この値は Google Cloud コンソールに表示されます。
• 宛先接続プロファイルのみ: CLOUDSQL_INSTANCE_ID は、宛先 Cloud SQL インスタンスのインスタンス ID に置き換えます。Cloud SQL インスタンスの詳細を表示する方法については、Cloud SQL ドキュメントの インスタンス情報を表示するをご覧ください。

これらの値の詳細については、 接続プロファイルの概要をご覧ください。

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

Linux、macOS、Cloud Shell

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

gcloud database-migration connection-profiles update postgresql \
  CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows（PowerShell）

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

gcloud database-migration connection-profiles update postgresql `
  CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows（cmd.exe）

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

gcloud database-migration connection-profiles update postgresql ^
  CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

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

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

接続プロファイルの削除

接続プロファイルを削除できるのは、そのプロファイルを使用する移行ジョブがない場合のみです。移行ジョブで使用されている接続プロファイルを削除する場合は、まず、接続プロファイルにリンクされている すべての移行ジョブを削除します。

接続プロファイルを削除する手順は次のとおりです。

コンソール

1. Google Cloud コンソールで、[接続プロファイル] ページに移動します。

   [接続プロファイル] に移動する

2. 削除する接続プロファイルの表示名をクリックします。

   接続プロファイルの概要ページが表示されます。

3. [削除] をクリックします。
4. ダイアログで [削除] をクリックします。

gcloud

このコマンドは、完了するために入力が必要なインタラクティブな確認プロンプトを返します。確認プロンプトをスキップするには、 オプションの --quiet フラグを使用します。

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

• REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
• CONNECTION_PROFILE_ID は、接続プロファイルの ID に置き換えます。

  識別子がわからない場合は、 gcloud database-migration connection-profiles list コマンドを使用して、特定のリージョン内のすべてのプロファイルを一覧表示し、その識別子を確認できます。

これらの値の詳細については、 接続プロファイルの概要をご覧ください。

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

Linux、macOS、Cloud Shell

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

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows（PowerShell）

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

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows（cmd.exe）

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

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION

結果

delete は、アクションを確認するインタラクティブなプロンプトを返します。「Y」と入力して、接続プロファイルを削除します。

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?

Google Cloud CLI のインタラクティブな確認プロンプトをスキップするには、 オプションの --quiet フラグを使用します。