接続プロファイルの管理

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

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

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

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

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

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

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

コンソール

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

注: 認証とプロジェクトを使用して 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 \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 `
  --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）

注: 認証とプロジェクトを使用して 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 ^
  --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

注: 認証とプロジェクトを使用して 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 のインタラクティブな確認プロンプトをスキップできます。