移行アシスタントを使用すると、定期タスク、手動タスク、リソース、関数、テーブルメタデータ、データソース、コンポーネントなどのオブジェクトをエクスポートできます。このトピックでは、エクスポートタスクの作成と表示方法、および Data Studio と以前の Data Studio の違いについて説明します。
背景情報
移行アシスタントでは、Full Export、Incremental Export、Custom Export を使用してタスクをエクスポートできます。各エクスポートタイプのユースケースは次のとおりです。
Full Export は、ワークスペース内のタスクの完全なバックアップを作成するのに適しています。一般的なユースケースには、コードのバックアップやテスト環境の迅速なクローン作成などがあります。このオプションは、開発環境から最後に保存されたバージョンをエクスポートします。
[フルエクスポート] には、正常に保存されたオブジェクトのみが含まれます。タスクに開発バージョンや本番バージョンなどの複数のバージョンがある場合、フルエクスポートでは開発環境に保存されているバージョンが優先されます。詳細な手順については、「フルエクスポートタスクの作成」をご参照ください。
Incremental Export は、最終更新時間に基づいてオブジェクトをフィルターしてエクスポートします。詳細な手順については、「増分エクスポートタスクの作成」をご参照ください。
説明増分エクスポートではブラックリストを設定できません。
Custom Export は、共通のビジネスワークフローを抽象化して簡単にレプリケーションするのに適しています。開発クラスターと本番クラスターが完全に分離された環境では、[カスタムエクスポート] を使用してタスクのデプロイをシミュレートできます。詳細な手順については、「カスタムエクスポートタスクの作成」をご参照ください。
制限事項
次の表に、各移行アシスタントエディションでサポートされている DataWorks 移行機能を示します。
DataWorks 移行機能
Basic Edition
Standard Edition
Professional Edition
Enterprise Edition
テナントごとにサポートされる DataWorks エクスポートパッケージの数
説明エクスポートタスクを作成し、エクスポートが成功すると、エクスポートパッケージが生成されます。
エクスポートパッケージの数がエディションの上限を超えた場合、エディションをアップグレードしてより多くのエクスポートパッケージを取得することしかできません。追加のエクスポートパッケージを別途購入することはできません。
最大 10 (累積)
最大 30 (累積)
最大 100 (累積)
無制限
DataWorks インポートパッケージのサイズ制限
ローカルファイルアップロード
30 MB
30 MB
30 MB
30 MB
OSS ファイルアップロード
非対応
非対応
無制限
無制限
DataWorks インポート時の自動コミットと自動デプロイのサポート有無
非対応
非対応
対応
対応
インポートおよびエクスポート操作を実行できるのは、Alibaba Cloud アカウント (root ユーザー) とワークスペース管理者のみです。他のロールを持つメンバーは、インポートおよびエクスポートタスクリストの表示のみ可能で、操作権限はありません。
Data Quality ルール (以前の Data Studio でのみサポート) をエクスポートおよびインポートする際は、次の点にご注意ください。
Data Quality ルールをエクスポートする場合、サブスクリプション管理 (アラート関連の設定) はエクスポートされません。
インポートされた Data Quality ルールに関連付けられたテーブルが移行先ワークスペースに存在しない場合、インポートされたルールは Data Quality ルールページに表示されません。Data Quality ルールをインポートした後に移行先テーブルを作成すると、インポートされたルールがテーブルのルール詳細ページに表示されます。
Data Quality のインポートステップは、定期タスクのインポートステップが正常に完了することに依存します。インポートパッケージに Data Quality ルールと関連するスケジューリングノード情報の両方が含まれている場合、スケジューリングノードを Data Quality ルールに正しく関連付けるには、まず関連ノードを移行先ワークスペースにインポートし、正常にコミットおよびデプロイする必要があります。
関連するスケジューリングノードをインポートせずに Data Quality ルールのみをインポートした場合でも、Data Quality ルールは正常にインポートされますが、関連するスケジューリングノード情報は含まれません。関連するスケジューリングノード情報をインポートしてコミットおよびデプロイした後、Data Quality ルールを再インポートすると、DataWorks はルールを更新し、スケジューリングノードに関連付けます。
Data Studio と以前の Data Studio では、移行アシスタントの機能に違いがあります。詳細については、以下の各操作セクションの注記をご参照ください。
移行アシスタントへの移動
DataWorks コンソールにログインし、対象のリージョンに切り替えてから、左側のナビゲーションウィンドウで [その他] > Migration Assistant をクリックして、移行アシスタントの Homepage ページに移動します。
フルエクスポートタスクの作成
DataWorks export ページで、右上の Create Export Task をクリックします。
Create Export Task ダイアログボックスで、パラメーターを設定します。
Data Studio
パラメーター
Description
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Full Export を選択すると、下の Export Scope を設定して、選択したオブジェクトの全コンテンツをエクスポートできます。
Export ScopeおよびExport Object
Export Scope は以下をサポートします。
All Objects：このオプションを選択すると、現在のワークスペース内のすべてのオブジェクトがエクスポートされます。オブジェクトには、定期タスク、手動タスク、リソース、関数、テーブル DDL 文 (MaxCompute のみ)、データソース、コンポーネントが含まれます。
Selected Objects：このオプションを選択すると、下の Export Object ドロップダウンリストから、定期タスク、リソース、DataService Studio など、完全にエクスポートしたいオブジェクトを選択できます。
Export Object Status
エクスポートするオブジェクトの状態を選択できます。
Saved：エクスポートオブジェクトの保存されたコンテンツをエクスポートします。
Deployed：エクスポートオブジェクトのデプロイされたコンテンツをエクスポートします。
Remarks
エクスポートタスクの簡単な説明を入力します。
以前の Data Studio
パラメーター
説明
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Full Export を選択すると、下の Export Scope を設定して、選択したオブジェクトの全コンテンツをエクスポートできます。
Export ScopeおよびExport Object
Export Scope は以下をサポートします。
All Objects：このオプションを選択すると、現在のワークスペース内のすべてのオブジェクトがエクスポートされます。以前の Data Studio では、オブジェクトには定期タスク、手動タスク、リソース、関数、テーブル DDL 文 (MaxCompute のみ)、データソース、DataService Studio、アドホッククエリ、コンポーネント、Data Quality ルールが含まれます。
Selected Objects：このオプションを選択すると、下の Export Object ドロップダウンリストから、定期タスク、リソース、DataService Studio など、完全にエクスポートしたいオブジェクトを選択できます。
Export Object Status
エクスポートするオブジェクトの状態を選択できます。
Saved：エクスポートオブジェクトの保存されたコンテンツをエクスポートします。
Committed：エクスポートオブジェクトのコミットされたコンテンツをエクスポートします。
Blacklist
ビジネス要件に基づいて Add to Blacklist を選択するかどうかを決定し、フルエクスポート中にエクスポートする必要がないタスクやリソースを除外できます。
Export Package Version and Format of Files in Export Package
オプションには、[標準フォーマット]、[Apsara Stack (V3.12 以降)]、[Apsara Stack (V3.6.1 から V3.11)] があります。データフォーマットは DataWorks のバージョンによって異なります。まず、移行先のインポート環境の DataWorks バージョンを確認してください。
Remarks
エクスポートタスクの簡単な説明を入力します。
Start Export をクリックします。
Export Progress ダイアログボックスで、エクスポートの進捗状況を確認します。エクスポートが成功したら、Return to Export Task List をクリックします。
増分エクスポートタスクの作成
DataWorks export ページで、右上の Create Export Task をクリックします。
Create Export Task ダイアログボックスで、パラメーターを設定します。
Data Studio
パラメーター
Description
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Incremental Export を選択すると、指定した日付以降に変更されたファイルがエクスポートされます。これには、保存およびコミットされた定期タスク、手動タスク、テーブルメタデータ、データソースが含まれます。
Export Scope と Export Object
All Objects：このオプションを選択すると、現在のワークスペース内のすべてのオブジェクトがエクスポートされます。オブジェクトには、定期タスク、手動タスク、リソース、関数、テーブル DDL 文 (MaxCompute のみ)、データソース、コンポーネントが含まれます。
Selected Objects：このオプションを選択すると、下の Export Object ドロップダウンリストから、定期タスク、リソース、DataService Studio など、完全にエクスポートしたいオブジェクトを選択できます。
Export Object Status
エクスポートするオブジェクトの状態を選択できます。
Saved：エクスポートオブジェクトの保存されたコンテンツをエクスポートします。
Deployed：エクスポートオブジェクトのデプロイされたコンテンツをエクスポートします。
Modified At
増分エクスポートは最終更新時間に基づきます。
Remarks
エクスポートタスクの簡単な説明を入力します。
以前の Data Studio
パラメーター
Description
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Incremental Export を選択すると、指定した日付以降に変更されたファイルがエクスポートされます。これには、保存およびコミットされた定期タスク、手動タスク、テーブルメタデータ、データソースが含まれます。
Export Scope と Export Object
All Objects：このオプションを選択すると、現在のワークスペース内のすべてのオブジェクトがエクスポートされます。以前の Data Studio では、オブジェクトには定期タスク、手動タスク、リソース、関数、テーブル DDL 文 (MaxCompute のみ)、データソース、DataService Studio、アドホッククエリ、コンポーネント、Data Quality ルールが含まれます。
Selected Objects：このオプションを選択すると、下の Export Object ドロップダウンリストから、定期タスク、リソース、DataService Studio など、完全にエクスポートしたいオブジェクトを選択できます。
Export Object Status
エクスポートするオブジェクトの状態を選択できます。
Saved：エクスポートオブジェクトの保存されたコンテンツをエクスポートします。
Committed：エクスポートオブジェクトのコミットされたコンテンツをエクスポートします。
Modified At
増分エクスポートは最終更新時間に基づきます。
Export Package Version and Format of Files in Export Package
オプションには、[標準フォーマット]、[Apsara Stack (V3.12 以降)]、[Apsara Stack (V3.6.1 から V3.11)] があります。
説明このパラメーターは 以前の Data Studio でのみサポートされています。Data Studio は統一された Spec フォーマットを使用するため、エクスポートバージョンのフォーマットを選択する必要はありません。
Remarks
エクスポートタスクの簡単な説明を入力します。
Start Export をクリックします。
カスタムエクスポートタスクの作成
DataWorks export ページで、右上の Create Export Task をクリックします。
Create Export Task ダイアログボックスで、パラメーターを設定します。
Data Studio
パラメーター
Description
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Custom Export を選択すると、エクスポートしたいファイルを自由に選択できます。これには、保存およびコミットされた定期タスク、手動タスク、テーブルメタデータ、データソースが含まれます。
Remarks
エクスポートタスクの簡単な説明を入力します。
以前の Data Studio
パラメーター
Description
Export Package Name
エクスポート名には、英字、漢字、数字、アンダースコア (_)、ピリオド (.) のみ使用できます。
Export Type
Custom Export を選択すると、エクスポートしたいファイルを自由に選択できます。これには、保存およびコミットされた定期タスク、手動タスク、テーブルメタデータ、データソースが含まれます。
Export Package Version and Format of Files in Export Package
オプションには、[標準フォーマット]、[Apsara Stack (V3.12 以降)]、[Apsara Stack (V3.6.1 から V3.11)] があります。
説明このパラメーターは 以前の Data Studio でのみサポートされています。Data Studio は統一された Spec フォーマットを使用するため、エクスポートバージョンのフォーマットを選択する必要はありません。
Remarks
エクスポートタスクの簡単な説明を入力します。
Select Export Content をクリックします。
Custom Export List ページで、Export Object タイプでエクスポートするオブジェクトをフィルターします。
移行アシスタントでサポートされている Export Object タイプには、Table、Auto Triggered Task、Resource、Manually Triggered Task、Function、Data Quality、DataService Studio、Data Source、Component、Ad Hoc Query があります。このうち、Data Quality、DataService Studio、アドホッククエリは以前の Data Studio でのみサポートされています。Data Studio はこれら 3 種類のオブジェクトのエクスポートをサポートしていません。
エクスポートするオブジェクトを選択した後、Add to Export Package をクリックします。
また、Export Object、Object Type、Object Name などの条件でオブジェクトをフィルターし、Add Filter Results to Export Package をクリックして、フィルターされたすべての結果を追加することもできます。
ページ右上の Start Export をクリックします。
タスクのステータス
Export Task List ページでは、エクスポートタスクの Export Task Name、Export Type、Task Creator、Status、Update Time、Remarks を表示できます。異なるステータスのタスクに対して異なる操作を実行できます。
Data Studio では、[一部成功] と [キャンセル済み] の 2 つの新しいタスクステータスが導入され、進行中のエクスポートタスクのキャンセルがサポートされています。
エクスポートタスクの Status が Exported の場合、次の操作が可能です。
View Export Report をクリックして、エクスポートタスクの Basic Information、Overview、Details を表示します。
Download Export Package をクリックして、エクスポートパッケージをローカルマシンにダウンロードします。
説明ダウンロードリンクは 30 日間有効です。有効期間が終了する前にパッケージをダウンロードすることを推奨します。有効期間が終了した後、パッケージをダウンロードしたい場合は、プロジェクトを再エクスポートする必要があります。
Clone Export Task (以前の Data Studio でのみサポートされています。Data Studio はクローンに対応しておらず、新しいタスクを作成する必要があります)：
Export Type が Full Export で、ブラックリストが設定されていないタスクの Clone Export Task をクリックします。Clone Export Task ダイアログボックスで、Export Package Name を入力し、Start Export をクリックします。
Export Type が Full Export で、ブラックリストが設定されているタスクの Clone Export Task をクリックします。Clone Export Task ダイアログボックスで、Export Package Name を入力し、Add to Blacklist をクリックします。
Select Blacklist ページで、エクスポートする必要のないオブジェクトを選択し、Add to Blacklist をクリックしてから、ページ右上の Start Export をクリックします。
Export Type が Custom Export のタスクの Clone Export Task をクリックします。Clone Export Task ダイアログボックスで、Export Package Name を入力し、Select Export Content をクリックします。
Custom Export List ページで、エクスポートするオブジェクトを選択し、Add to Export Package をクリックしてから、ページ右上の Start Export をクリックします。
エクスポートタスクの Status が Export Failed の場合、View Export Report と Download Export Package に加えて、Retry をクリックしてタスクを再エクスポートできます (以前の Data Studio でのみサポートされています。Data Studio は再試行に対応しておらず、新しいタスクを作成する必要があります)。
エクスポートタスクの Export Type が Custom Export で、Status が Editing の場合、次の操作が可能です。
Continue to Edit をクリックして編集ページに移動し、エクスポートタスクのタイプに基づいて操作を実行します。
View Export Package をクリックして、Export Package Details ページでエクスポートタスクの Basic Information、Overview、Details を表示します。
Delete をクリックします。Delete ダイアログボックスで、OK をクリックします。
エクスポートタスクの Export Type が Full Export で、Status が Editing の場合、Continue to Edit と Delete に加えて、View Blacklist をクリックできます (以前の Data Studio でのみサポート)。ブラックリストのプレビューダイアログボックスで、ブラックリストのエントリを確認し、Start Export または Close をクリックします。
次のステップ
ワークスペース間でタスクを移行するには、Export Task List ページから Download Export Package をローカルマシンに行い、その後 DataWorks インポートタスクを作成 して、タスクを移行先ワークスペースにインポートします。
よくある質問
エクスポートされたタスクが存在しない場合は、対応するワークスペースに移動して、タスクが誤って削除されたか、保存およびコミットされていないかを確認してください。タスクが誤って削除された場合は、ごみ箱 に移動してタスクが存在するかどうかを確認し、復元してください。