移行アシスタントを使用して、定期タスクやテーブルなどのオブジェクトを移行するには、まず DataWorks export 機能を使用してソースワークスペースからエクスポートし、次に DataWorks import 機能を使用して宛先ワークスペースにインポートします。このトピックでは、インポートタスクを作成する方法について説明します。
制限事項
次の表に、各移行アシスタントエディションでサポートされている 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 では、移行アシスタントの機能に違いがあります。詳細については、以下の各操作セクションの注記をご参照ください。
レガシー Data Studio ワークスペースからのエクスポート パッケージは、新しい Data Studio ワークスペースにインポートできません。
前提条件
DataWorks インポートタスクを作成する前に、次の準備を完了してください。
エクスポートタスクが作成されている。
DataWorks Migration Assistant を使用して、スケジュールされたタスクやテーブルなど、移行対象のオブジェクトのエクスポートタスクを作成する必要があります。 詳細については、「DataWorks エクスポートタスクの作成と表示」をご参照ください。
インポートファイルが準備されている。
DataWorks では、ローカルコンピューターまたは Object Storage Service (OSS) からインポートファイルをアップロードできます。選択するアップロード方法に基づいてファイルを準備してください。
ローカルアップロード： 前の手順で生成されたエクスポートパッケージをローカルコンピューターにダウンロードします。詳細については、「エクスポートパッケージをダウンロードする」をご参照ください。
OSS アップロード (新しい Data Studio ではサポートされていません)：前の手順で生成されたエクスポートパッケージをローカルコンピューターにダウンロードしてから、パッケージを OSS にアップロードします。詳細については、「シンプルアップロード」をご参照ください。
移行アシスタントへの移動
DataWorks コンソールにログインし、対象リージョンに切り替え、左側のナビゲーションペインで [その他] > Migration Assistant をクリックして、移行アシスタントの Homepage に移動します。
インポートタスクの作成
新しい Data Studio
Migration Assistant の左側のナビゲーションペインで、 をクリックします。
インポートタスク一覧ページで、右上隅のCreate Import Taskをクリックします。
Create Import Task ダイアログボックスで、パラメーターを設定します。
パラメータ
説明
[Import Package Name]
インポート名には、英字、中国語文字、数字、アンダースコア (_)、ピリオド (.) のみを含めることができます。
[Upload Method]
ローカルコンピューターまたは OSS からインポートファイルをアップロードできます。次のオプションが使用可能です。
[Local Upload]: Upload File をクリックし、画面の指示に従ってローカルファイルをアップロードして検証します。
説明アップロードできるローカルファイルの最大サイズは 30 MB です。
The resource package passes verification.と表示されたら、Preview Fileをクリックしてインポート対象のファイルの詳細を表示できます。
[Remarks]
インポートタスクの簡単な説明を入力します。
OK をクリックして Import Task Settings ページに移動します。
タスクをインポートする前に、インポートファイルの形式と内容を検証する必要があります。検証に合格した後にのみ OK をクリックできます。
インポートタスクを設定します。
インポートタスクを設定する際は、コンピューティングリソースマッピング を設定する必要があります (次の図では MaxCompute コンピューティングエンジンを例として使用しています)。その他の設定はオプションです。ビジネス要件に基づいて設定できます。
説明同じリージョン内の同じ Alibaba Cloud アカウント下の異なるワークスペース間でインポートおよびエクスポートを行う場合、エンジンインスタンスマッピングのみの設定が必要です。
Computing Resource Mapping セクションで、ソースワークスペースと宛先ワークスペース間のコンピューティングリソースマッピングを設定します。
Computing Resources in Destination Workspace フィールドには、計算リソースの作成に使用したプロジェクト名ではなく、宛先ワークスペースの Data Studio にバインドされている計算リソースの表示名が表示されます。 Data Studio に移動し、左側のナビゲーションペインで
アイコンをクリックして、[計算リソース] 一覧ページに移動すると、計算リソースの表示名を確認できます。ソースワークスペースの Data Studio が複数のタイプのコンピューティングリソースにバインドされているが、宛先ワークスペースが 1 つのタイプのコンピューティングリソースのみにバインドされている場合、宛先ワークスペースには他のタイプのノードを作成する権限がないため、インポートタスクは失敗します。
任意：Resource Group Mapping セクションで、タスクの実行時にリソースグループが見つからなくなるのを防ぐには、ソースワークスペースと宛先ワークスペース間のリソースグループマッピングを変更します。
任意： Dependency Mapping セクションで、関連ノードのプロジェクトマッピングを設定します。
タスクをインポートする際、タスクがソースワークスペース名を使用している場合 (たとえば、タスクコード、現在のノードの入力名、または現在のノードの出力名にソースワークスペース名が含まれている場合) 、New Project Name を変更すると、関連する名前を新しいワークスペース名にすばやく置き換え、タスクのインポート後に依存関係が正しいことを確認できます。
任意: Configure Import Policy セクションで、データソースの競合ポリシーを設定します。
インポートされたデータソースの名前が宛先ワークスペースの既存のデータソースと競合する場合、[スキップ] (デフォルト。宛先ワークスペースの既存のデータソースを保持) または [置き換え] (インポート パッケージ内のデータソースで既存のデータソースを上書き) を選択できます。競合をプレビューして、影響範囲を確認できます。
任意: Committing Rule セクションでは、Change Owner ができます。
説明同じ名前のオブジェクトが宛先ワークスペースに既に存在する場合、コミットは失敗します。
所有者を変更せず、ソースタスクに所有者がいない場合、送信者がタスク所有者として設定されます。
左下隅のStart Importをクリックします。
Prompt ダイアログボックスで、OK をクリックします。
レガシー Data Studio
Migration Assistant の左側のナビゲーションペインで、 をクリックします。
「インポートタスク一覧」ページで、右上隅のCreate Import Taskをクリックします。
Create Import Task ダイアログボックスで、パラメーターを設定します。
パラメータ
説明
[Import Package Name]
インポート名には、英字、中国語文字、数字、アンダースコア (_)、ピリオド (.) のみを含めることができます。
[Upload Method]
ローカルコンピューターまたは OSS からインポートファイルをアップロードできます。次のオプションが使用可能です。
[Local Upload]：Upload File をクリックし、画面の指示に従ってローカルファイルをアップロードして検証します。
説明アップロードできるローカルファイルの最大サイズは 30 MB です。
[OSS Object]: OSS Endpoint を入力し、Check をクリックします。OSS コンソールにログインし、次の手順に従ってファイルの URL を取得できます。
説明OSS アップロードは、DataWorks Professional Edition 以上でサポートされています。
左側メニューで、バケットリストをクリックします。対象のバケットに移動し、左側のメニューで [ファイル管理] > [ファイルリスト] を選択します。対象のファイルをクリックします。右側の詳細パネルで、URL フィールドを見つけ、ファイル URL のコピーをクリックして URL を取得します。
The resource package passes verification. が表示されたら、Preview File をクリックしてインポートするファイルの詳細を表示できます。
[Remarks]
インポートタスクの簡単な説明を入力します。
OK をクリックして、Import Task Settings ページに移動します。
タスクをインポートする前に、インポートファイルの形式と内容を検証する必要があります。検証に合格した後にのみ、OK をクリックできます。
インポートタスクを設定します。
インポートタスクを設定する際は、コンピューティングリソースマッピング を設定する必要があります (次の図では MaxCompute コンピューティングエンジンを例として使用しています)。 その他の設定はオプションです。ビジネス要件に基づいて設定できます。
説明同じリージョン内の同じ Alibaba Cloud アカウント下の異なるワークスペース間でインポートおよびエクスポートを行う場合、エンジンインスタンスマッピングのみの設定が必要です。
Computing Resource Mapping セクションで、ソースワークスペースと宛先ワークスペース間のコンピューティングリソースマッピングを設定します。
Computing Resources in Destination Workspace フィールドには、コンピューティングリソースの作成に使用されたプロジェクト名ではなく、宛先ワークスペースの Data Studio に関連付けられたコンピューティングリソースの表示名が表示されます。 Data Studio に移動し、左側のナビゲーションペインで
アイコンをクリックして、[コンピューティングリソース]の一覧ページに移動すると、コンピューティングリソースの表示名を表示できます。ソースワークスペースの Data Studio が複数のタイプのコンピューティングリソースにバインドされているが、宛先ワークスペースが 1 つのタイプのコンピューティングリソースのみにバインドされている場合、宛先ワークスペースには他のタイプのノードを作成する権限がないため、インポートタスクは失敗します。
任意: Resource Group Mapping セクションで、ソースワークスペースと移行先ワークスペース間のリソースグループマッピングを変更して、タスクの実行時にリソースグループが見つからなくなるのを防ぎます。
任意: Dependency Mapping セクションで、関連ノードのプロジェクトマッピングを設定します。
タスクをインポートする際、タスクコード、現在のノードの入力名、または現在のノードの出力名などにソースワークスペース名が使用されている場合は、New Project Name を変更することで、関連する名前を新しいワークスペース名にすばやく置換し、タスクのインポート後に依存関係が正しくなるようにできます。
オプション： [競合ルール] セクションで、データソースとワークフローパラメータの競合ポリシーを設定します。
インポートされたデータソースまたはワークフローの名前が宛先ワークスペースの既存のデータソースと競合する場合、[スキップ] (デフォルト。宛先ワークスペースの既存のデータソースを保持) または [置き換え] (インポート パッケージ内のデータソースで既存のデータソースを上書き) を選択できます。競合をプレビューして、影響範囲を確認できます。
オプション: Dry-run Property セクションで、対応するノードの横にある Set to Dry-run をクリックします。
ドライランに設定する複数のノードを選択し、Batch Set to Dry-run をクリックすることもできます。
この設定は、スケジュールされたタスクのスケジューリングパラメータで時間プロパティを設定するために使用されます。ノードがドライランに設定されると、データを生成せずに正常に実行されます。
オプション: DataService Studio Settings セクションで、対応する DataService Studio インスタンスに対して Specify Mappings for DataService Studio Business Processes します。
任意: Committing Rule セクションでは、Resource、Function、Table、および Change Owner のコミットルールを設定できます。
説明同じ名前のオブジェクトが宛先ワークスペースに既に存在する場合、コミットは失敗します。
所有者を変更せず、ソースタスクに所有者がいない場合、送信者がタスク所有者として設定されます。
左下隅にあるStart Importをクリックします。
Prompt ダイアログボックスで、OK をクリックします。
インポートタスクの表示
Import Task List ページでは、タスクの状態によって異なる操作が表示されます：
タスクのインポート後、Import Task List ページでタスクの横にある View Import Report をクリックして、インポートタスクの Basic Information、Import Results、Details、および Import Settings を表示できます。
Editing 状態のタスクでは、次の操作を実行できます。
タスクの横にあるContinue to Edit をクリックすると、Import Task Settings ページでタスク設定を変更できます。
タスクの横にあるPreviewをクリックすると、インポートファイルのBasic Information、Overview、およびDetailsを表示できます。
タスクの横にあるDeleteをクリックし、確認ダイアログボックスでOKをクリックして、インポートタスクを削除します。
Import Failed 状態のタスクについては、タスクの横にある Import Again をクリックできます (レガシー Data Studio でのみサポートされています)。 Import Progress ダイアログボックスで、インポートが完了したら、Return to Import Task List をクリックします。 新しい Data Studio (Data Studio) は再インポートをサポートしていません。 インポートが失敗した場合は、新しいインポートタスクを作成する必要があります。
新しい Data Studio (Data Studio) では、進行中のインポートタスクを 終了 できます。