> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-ja/paipurain/paipurain-1/paipurain-dta.md). # パイプライン操作: データ移行 {% hint style="warning" %} #### 旧UI向けに作成 この記事は旧UI向けに作成されました。手順は今でも使用できますが、スクリーンショットは古くなっています。場合によっては、手順で参照されている項目が移動または変更されていることがあります。項目が見つからない場合は、 [どこに行ったのか](/devops/devops-ja/shii-uiux-heno/dokonittanoka.md) 記事。 {% endhint %} ## ![](https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) 概要 その **データ移行** この操作は、DevOps パイプラインのステップとして Data Migrator の移行ジョブを実行します。Data Migrator テンプレートを使用してソース組織とターゲット組織の間でレコードを転送するため、パイプライン内で自動的にデータを移行でき、後から手動で移行を実行する必要がありません。 移行は Data Migrator アプリ内で実行されるため、この操作では既存のテンプレートを使用します。これらのテンプレートでは、転送するオブジェクトとレコード、および各種フィルターやレコードマッピングを指定します。 {% hint style="info" %} #### ベストプラクティス * DevOps パイプラインに追加する前に、Data Migrator アプリで Data Migrator テンプレートをテストしてください。 * この操作を使用して、デプロイ後に構成データや参照データでターゲット組織を初期化します。 * Migrate Data 操作を含めることで、環境間でレコードの整合性を保ちます。 * 繰り返しの移行では、データの重複を避けるためにテンプレートでレコードマッピングを使用します。 * Data Migrator テンプレートでデータマスキングを適用し、機密データをランダムなシード値に置き換えて、実データがターゲット組織に表示されないようにします。 {% endhint %} ### Data Migrator の前提条件 Migrate Data 操作を追加する前に、Data Migrator アプリでいくつかの項目を設定する必要があります。以下の各セクションでは、これらの前提条件を説明し、関連する記事へのリンクを示します。 ### テンプレート すべてのデータ移行は、移行されるオブジェクトとレコード、さらに各種フィルターとレコードマッピングを定義するテンプレートから実行されます。パイプラインのような自動処理で使用する前に、テンプレートが正しいレコードをコピーすることを確認してください。Data Migrator テンプレートの詳細については、以下の記事を参照してください。 * [テンプレートの概要](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/tenpurtono.md) * [テンプレートの作成](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/tenpurtono-1.md) * [テンプレートにオブジェクトを追加する](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/tenpurtoniobujekutowosuru.md) * [オブジェクトにフィールドを追加する](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/obujekutonifrudowosuru.md) * [オブジェクトにフィルターを追加する](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/obujekutonifirutwosuru.md) * [オブジェクトレコードマッピングの設定](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/obujekutorekdomappinguno.md) #### 組織 データ移行は、Data Migrator アプリが割り当てられている組織間でのみ実行できます。使用したい組織が一覧にない場合は、Global Settings アプリでその組織に Data Migrator を割り当ててください。詳細は、組織へのアプリ割り当てに関する次の記事を参照してください。 * [組織へのアプリの割り当て](/global-settings/global-settings-docs-ja/huan-jing/zu-zhi/henoapurinorite.md) ### Migrate Data 操作と Data Migrator の移行の違い Migrate Data 操作は Data Migrator を使用して移行の作成と実行を行うため、最終的な結果は同じです。ただし、2 つには重要な違いがあります。 Data Migrator では、移行の作成、確認、実行を含む複数ステップのプロセスになります。 DevOps パイプラインでは、Migrate Data 操作は、移行の作成と実行の両方を自動化する単一のプロセスです。パイプラインは自動化されているため、確認ステップはスキップされます。このため、重要なパイプラインに含める前に、移行が正しく機能することを確認してください。 ## Migrate Data 操作の設定 {% hint style="info" %} 以下の手順は、このパイプライン操作の構成に適用されます。パイプラインステップの追加と次のステップの設定に関する一般的な手順については、次の記事を参照してください。 [パイプラインステップの追加](/devops/devops-ja/paipurain/paipurainsuteppuno/paipurainsuteppuno.md) {% endhint %} {% stepper %} {% step %} ### 操作とジョブ名を選択 1. 次をクリックします **操作** のドロップダウンメニュー。 2. 次を選択 **データ移行**.
3. 〜の **ジョブ名** テキストフィールドに、Data Migrator で実行される移行ジョブの名前を入力します。
{% endstep %} {% step %} ### ソース組織とターゲット組織を選択 {% hint style="info" %} Data Migrator アプリが割り当てられている組織のみが、データ移行のソースおよびターゲットとして利用できます。DevOps のみが割り当てられている組織にデータを移行する、またはその組織から移行する場合は、まず Global Settings アプリでその組織に Data Migrator を割り当ててください。詳細は、組織へのアプリ割り当てに関する次の記事を参照してください。 * [組織へのアプリの割り当て](/global-settings/global-settings-docs-ja/huan-jing/zu-zhi/henoapurinorite.md) {% endhint %} 1. 次をクリックします **ソース組織** のドロップダウンメニュー。 2. 移行のソースとして使用する組織を選択します。
3. 次をクリックします **ターゲット組織** のドロップダウンメニュー。 4. 移行のターゲットとして使用する組織を選択します。 {% endstep %} {% step %} ### Data Migrator テンプレートを選択 {% hint style="info" %} DevOps では Data Migrator テンプレートを表示できないため、この移行で使用する Data Migrator テンプレートの名前を把握しておく必要があります。よくわからない場合は、Data Migrator を開いて正しいテンプレート名を確認してください。Data Migrator テンプレートの詳細については、次の記事を参照してください。 * [テンプレートの概要](/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/tenpurtono.md) {% endhint %} 1. 次をクリックします **テンプレート** のドロップダウンメニュー。 2. データ移行に使用するテンプレートを選択します。
{% endstep %} {% endstepper %} ## Migrate Data の結果 {% hint style="info" %} パイプラインが開始されると、その進行状況と結果は、 **アクティビティ** タブで、パイプラインを実行したブランチから確認できます。以下の手順では、この操作の結果を確認する方法を示します。ブランチからパイプライン結果にアクセスする一般的な手順については、次の記事を参照してください。 * [パイプライン結果の表示](/devops/devops-ja/paipurain/paipurain/paipurainno-1.md) {% endhint %} {% stepper %} {% step %} ### サマリーとログ Migrate Data ジョブが完了したら、次を選択して結果のサマリーを表示できます。 **データ移行** パイプライン結果のステップ。
その **サマリー** Migrate Data の結果には、次の情報が表示されます：
項目説明
ステータス

完了 移行ジョブの実行が終了している場合。移行は、たとえ次の状態であっても完了と見なされます。 失敗したレコード.

例外 問題により移行ジョブを実行できなかった場合。トラブルシューティングするにはログを確認してください。

所要時間Migrate Data ジョブの完了にかかった時間。時間、分、秒で表示されます。
開始日/終了日Migrate Data ジョブの開始日時と終了日時。
オブジェクトの合計移行に含まれるオブジェクトの総数。
レコードの合計移行に含まれるレコードの総数。成功したレコードと失敗したレコードの両方を含みます。
失敗したレコード移行に失敗したレコードの数。
ログMigrate Data ジョブのログエントリ。ログを使用して、ジョブのステータスやエラーメッセージを確認します。
Migrate Data ログの例： {% code overflow="wrap" expandable="true" %} ``` [2026年6月1日 午後4:00]: [info] ジョブを開始 [2026年6月1日 午後4:02]: [info] ジョブが完了 ``` {% endcode %} {% endstep %} {% step %} ### 結果を表示 移行の詳細を表示するには、結果を開きます。 1. 次をクリックします **結果を表示**.
2. 新しい Data Migrator タブが開き、移行ジョブの結果が表示されます。
3. 移行結果の確認手順の詳細については、以下の記事を参照してください。 1. [移行結果の表示](/data-migrator/data-migrator-ja/l-li/no.md) {% hint style="info" %} Data Migrator アプリからデータ移行をロールバックできます。手順については、以下の記事を参照してください。 * [移行をロールバックする](/data-migrator/data-migrator-ja/l-li/worrubakkusuru.md) {% endhint %} {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.flosum.com/devops/devops-ja/paipurain/paipurain-1/paipurain-dta.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.