接続プロファイルの管理

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

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

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

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

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

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

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

Console

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

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

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

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

gcloud

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

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

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

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

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

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 Storage バケット名
• （宛先プロファイルのみ）宛先 Cloud SQL for MySQL インスタンス ID、データベースのユーザー名とパスワード

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

Console

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

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

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

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

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

gcloud

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

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

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

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

• REGION は、接続プロファイルが保存されているリージョン の ID に置き換えます。
• 省略可: 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 \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows（PowerShell）

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

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows（cmd.exe）

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

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

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

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

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

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

接続プロファイルを削除する

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

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

Console

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

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

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

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

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

gcloud

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

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

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

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

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

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

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)?

省略可能な --quiet フラグを使用すると、Google Cloud CLI のインタラクティブな確認プロンプトをスキップできます。