コンバージョン ワークスペースを管理する

このページでは、プロジェクトで複数のコンバージョン ワークスペースを管理する方法について説明します。コンバージョン ワークスペースのリストから、次の操作を行うことができます。

  • 特定のコンバージョン ワークスペースを選択して、コンバージョン エディタにアクセスし、ワークスペースの詳細を表示して変更します。生成されたスキーマとコードを移行先データベースに適用し、移行ジョブを作成します。

  • ワークスペースを削除するには、 [その他] メニューを使用します。

コンバージョン ワークスペースの詳細を表示する

変換ワークスペースの詳細を表示するには、 Google Cloud コンソールまたは Google Cloud CLI の [変換ワークスペース] ページを使用します。

コンソール

  1. Google Cloud コンソールで [コンバージョン ワークスペース] に移動します。

[コンバージョン ワークスペース] に移動

  1. 利用可能なワークスペースのリストから、操作するワークスペースを選択します。

    コンバージョン ワークスペースのエディタページが表示されます。

  2. [構成を編集] > [詳細を表示] を選択します。

[コンバージョン ワークスペースの詳細] パネルが開きます。

gcloud

  1. 特定のリージョンで使用可能なすべてのワークスペースを一覧表示して、その識別子を取得します。

    gcloud database-migration conversion-workspaces list \
    --region=REGION

    次のように置き換えます。

    • REGION は、コンバージョン ワークスペースが配置されているリージョンの名前に置き換えます。

    例:

    gcloud database-migration conversion-workspaces list \
    --region=us-central1

    使用可能なワークスペースとその識別子のリストが標準出力に出力されます。

  2. 特定のワークスペースの詳細を取得します。

    gcloud database-migration conversion-workspaces describe CONVERSION_WORKSPACE \
  --region=REGION

    次のように置き換えます。

    • CONVERSION_WORKSPACE は、コンバージョン ワークスペースの ID または完全修飾名に置き換えます。

    • REGION は、コンバージョン ワークスペースが配置されているリージョンの名前に置き換えます。

    例:

    gcloud database-migration conversion-workspaces describe my-conversion-workspace-id \
  --region=us-central1

コンバージョン ワークスペースの設定を変更する

コンバージョン ワークスペースで変更できる情報には、表示名、ソース構成（ソース接続プロファイルまたは Cloud Storage フォルダ）、カスタム コンバージョン マッピング ファイルなどがあります。

  1. Google Cloud コンソールの [コンバージョン ワークスペース] ページに移動します。

    [コンバージョン ワークスペース] に移動

  2. 変更するコンバージョン ワークスペースの表示名をクリックします。

    コンバージョン ワークスペース エディタが開きます。

  3. ワークスペースの表示名を変更するには:
    1. [構成を編集] > [詳細を表示] を選択します。 [コンバージョン ワークスペースの詳細] パネルが開きます。
    2. [コンバージョン ワークスペース名] 行で、編集アイコンをクリックします。
    3. [コンバージョン ワークスペース名] フィールドに、コンバージョン ワークスペースの新しい表示名を入力します。
    4. [保存] をクリックします。
  4. ワークスペースのソース構成を変更するには:

    接続プロファイルの編集

    ワークスペースが接続プロファイルを使用してソース データベースに直接接続している場合は、既存の接続プロファイルの設定を調整するか、ワークスペースのソース構成を変更して別の接続プロファイルを使用するか、Cloud Storage バケットに保存されているスキーマ ファイルを提供するようにインフライトで切り替えることができます。

    • 既存のソース接続プロファイルの接続設定を調整するには:
      1. [構成を編集] > [詳細を表示] を選択します。
      2. [ソース接続プロファイル] 行で、ワークスペースに関連付けられている接続プロファイルのリンクをクリックします。
      3. 接続プロファイル ページで、必要に応じて詳細を調整します。詳細については、 接続プロファイルを管理するをご覧ください。
    • 別の接続プロファイルを選択するか、Cloud Storage バケットに保存されているスキーマ ファイルを使用するように移行中に切り替えるには:
      1. [構成を編集] > [ソース構成を編集] を選択します。
      2. 確認ダイアログで [プロフィールを編集] をクリックします。
      3. [ソースの定義とスキーマ スナップショットの pull] ページで、別のソース接続プロファイルを選択するか、[Cloud Storage] を選択してフォルダパスを指定し、[スキーマ スナップショットを pull して続行] をクリックして、変換するオブジェクトを選択します。

    Cloud Storage を編集する

    ワークスペースで Cloud Storage に保存されているスキーマ ファイルを使用している場合は、ソース構成を変更して別の Cloud Storage フォルダを指すようにするか、接続プロファイルを使用して直接接続を介してスキーマ ファイルを提供するように切り替えることができます。

    1. [構成を編集] > [ソース構成を編集] を選択します。
    2. 確認ダイアログで [プロフィールを編集] をクリックします。
    3. [ソースの定義とスキーマ スナップショットの pull] ページで、別の Cloud Storage フォルダパスを選択するか、[接続プロファイル] を選択してソース データベースに直接接続し、[スキーマ スナップショットを pull して続行] をクリックして、変換するオブジェクトを選択します。
  5. ワークスペースで使用されるカスタム コンバージョン マッピング ファイルを変更することもできます。詳細については、 カスタム コンバージョン マッピングを使用するをご覧ください。

コンバージョン ワークスペースを削除する

コンバージョン ワークスペースを削除できるのは、アクティブな移行ジョブで使用されていない場合のみです。

アクティブな移行ジョブにリンクされているコンバージョン ワークスペースを削除するには、まず、コンバージョン ワークスペースにリンクされているすべてのアクティブな移行ジョブを削除します。次に、コンバージョン ワークスペースを削除します。

  1. Google Cloud コンソールで [コンバージョン ワークスペース] に移動します。

    [コンバージョン ワークスペース] に移動

  2. 削除するコンバージョン ワークスペースの横にある [その他] > [削除] をクリックします。

  3. 確認のダイアログ ボックスで、[削除] をクリックします。

すべてのコンバージョン ワークスペースを確認する

すべてのコンバージョン ワークスペースは、 ページで確認できます。このリストには、各変換ワークスペースのデフォルトの概要情報が表示されます。

  • コンバージョン ワークスペースの表示名と ID。
  • 保存されているコンバージョン ワークスペースの最新バージョンのバージョン ID。コンバージョン ワークスペースのバージョンが複数あると、それぞれのワークスペースのオブジェクトを比較して、ワークスペース間の違いを識別できます。バージョニングは、トラッキング目的にも使用できます。
  • このコンバージョン ワークスペースを使用してソースからオブジェクトを pull して変換したかどうかを表すコンバージョン状態。
  • [アクティビティ] は、コンバージョン ワークスペースが 1 つ以上のアクティブな移行ジョブで使用されているかどうかを示します。アクティブな移行ジョブとは、COMPLETED ステータスではない移行ジョブです。ステータスの横にあるジョブの数は、コンバージョン ワークスペースを参照しているジョブの合計数（アクティブと非アクティブの両方）を示します。
  • コンバージョン ワークスペースが構成されている移行元と移行先のデータベース エンジン（データベース タイプ）。
  • コンバージョン ワークスペースが作成されたとき。