接続プロファイルの管理

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

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

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

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

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

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

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

コンソール

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

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

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

• 表示名
• ソース接続プロファイルの場合: ホスト名または IP アドレス、ポート、ユーザー名、パスワード、データベース名、SSL / TLS 証明書
• 移行先の接続プロファイル（既存のクラスタのみ）: 移行先の AlloyDB for PostgreSQL クラスタ ID

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

コンソール

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

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

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

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

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

gcloud

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

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

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

• REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
• （省略可）CONNECTION_PROFILE_NAME: 接続プロファイルの人が読める名前。この値は Google Cloud コンソールに表示されます。
• ソース接続プロファイルの場合: --host、--port、--username、--password などのフラグを渡して、ソース データベースの接続の詳細を更新することもできます。サポートされているフラグの完全なリストについては、 gcloud database-migration connection-profiles update リファレンスをご覧ください。
• 移行先の接続プロファイル（既存のクラスタのみ）: ALLOYDB_CLUSTER_ID は、移行先の AlloyDB for PostgreSQL クラスタのクラスタ ID に置き換えます。AlloyDB for PostgreSQL クラスタの詳細を表示する方法については、AlloyDB for PostgreSQL ドキュメントの クラスタの詳細を表示するをご覧ください。

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

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

Linux、macOS、Cloud Shell

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

gcloud database-migration connection-profiles \
update CONNECTION_PROFILE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows（PowerShell）

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

gcloud database-migration connection-profiles `
update CONNECTION_PROFILE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows（cmd.exe）

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

gcloud database-migration connection-profiles ^
update CONNECTION_PROFILE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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: CONNECTION_PROFILE_ID
  verb: update
name: OPERATION_ID

オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、接続プロファイルの詳細を確認します。

• gcloud database-migration connection-profiles describe コマンドを使用して、更新された接続プロファイルの詳細を表示します。
• gcloud database-migration operations describe コマンドに 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 フラグを使用します。