接続プロファイルの管理

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

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

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

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

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

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

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

コンソール

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

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

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

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

gcloud

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

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

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

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

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

Linux、macOS、Cloud Shell

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

Windows（PowerShell）

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

Windows（cmd.exe）

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

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

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

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

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

コンソール

  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 コンソールに表示されます。
  • （省略可、ソース接続プロファイルのみ）SOURCE_STORAGE_BUCKET_NAME は、フルバックアップ、差分バックアップ、トランザクション ログ ファイルを保持する親データベース フォルダを含む Cloud Storage バケット名に置き換えます。
  • （省略可、宛先接続プロファイルのみ）
    • CLOUDSQL_INSTANCE_ID は、移行先の Cloud SQL for SQL Server インスタンスのインスタンス ID に置き換えます。Cloud SQL インスタンスの詳細を表示する方法については、Cloud SQL のドキュメントの インスタンス情報を表示するをご覧ください。
    • 移行ユーザーの詳細: 移行先インスタンスの専用データベース ユーザー アカウントの詳細を指定します。このユーザー アカウントの詳細については、 Cloud SQL for SQL Server の移行先インスタンスを作成して構成するをご覧ください。
      • CLOUD_SQL_DB_USERNAME は、移行ユーザー名に置き換えます。
      • CLOUD_SQL_DB_USER_PASSWORD は、移行アカウントのパスワードに置き換えます。
これらの値の詳細については、 接続プロファイルの概要をご覧ください。

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

Linux、macOS、Cloud Shell

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

Windows（PowerShell）

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

Windows（cmd.exe）

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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]

接続プロファイルの削除

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

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

コンソール

  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

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

Windows（PowerShell）

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

Windows（cmd.exe）

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 フラグを使用します。