このページでは、Cloud Data Fusion でデプロイされたバッチ パイプラインを編集する方法について説明します。
パイプラインを編集すると、次のことができます。
- 重複の発生なしで、デプロイされたパイプラインに機能を段階的に追加します。たとえば、プラグインを追加、削除、変更してから、パイプラインを再デプロイできます。パイプラインを編集すると、同じパイプラインの新しいバージョンが作成され、それがパイプラインの急増を防ぎ、より適切に編成できます。パイプラインを複製すると、別の名前の新しいパイプラインが作成されます。
- 編集されたバージョンの履歴を維持します。
- 古いバージョンのパイプラインを表示して復元します。
- パイプラインの構造、構成、メタデータ、設定、コメントなど、パイプラインの任意の部分を編集できます。
- デプロイされたパイプライン用の編集された JSON ファイルをエクスポートします。
パイプラインを編集すると、Cloud Data Fusion によって新しい下書きが作成され、これが最新バージョンになります。パイプラインの名前は同じままです。一意の名前を持つ重複するパイプラインを作成せずに、パイプラインを反復的に開発します。最新バージョンでは、以前のバージョンのトリガー、パイプライン構成、ランタイム引数、メタデータ、コメント、スケジュールが保持されます。最新バージョンはパイプラインのアクティブなバージョンです。実行することも、実行をスケジュールすることもできます。
準備
- Cloud Data Fusion では、バージョン 6.9.1 以降のデプロイされたバッチ パイプラインの編集をサポートします。最新バージョンにアップグレードするには、Cloud Data Fusion 環境をアップグレードするをご覧ください。
- Cloud Data Fusion は、デプロイされたリアルタイム パイプラインまたはレプリケーション ジョブの編集をサポートしていません。
パイプラインを編集する
Cloud Data Fusion でデプロイされたバッチ パイプラインを編集するには、次の手順に従います。
- インスタンスに移動します:
Google Cloud コンソールで、Cloud Data Fusion のページに移動します。
Cloud Data Fusion Studio でインスタンスを開くには、[インスタンス]、[インスタンスを表示] の順にクリックします。
- [List] > [Deployed] をクリックします。
編集するパイプラインに移動し、（その他アイコン）> [編集] をクリックします。
パイプラインの新しい下書きが [スタジオ] ページに表示されます。
パイプラインを編集します。たとえば、新しい分析ノードの追加、またはソースのプロパティの編集を行います。
省略可: パイプラインの編集を後で完了するには、[Save] をクリックします。
パイプラインの編集が完了したら、[Deploy] をクリックします。
[変更の概要を入力する] ダイアログで、パイプラインに対して行った変更の説明を入力し、[デプロイ] をクリックします。デプロイされたパイプラインが [パイプライン] ページで開きます。
パイプラインの以前のバージョンを表示または復元する
以前のバージョンのバッチ パイプラインを表示またはデプロイするには、以下の手順に従います。
- Cloud Data Fusion インターフェースでインスタンスを開きます。
- [List] > [Deployed] をクリックします。
- パイプラインを選択します。パイプラインが [パイプライン] ページに表示されます。
[履歴] をクリックします。
バージョン履歴のリストが表示されます。
省略可: 以前のバージョンのパイプラインを表示するには、[表示] をクリックします。
省略可: 古いバージョンのパイプラインを最新バージョンに復元するには、[復元] をクリックします。
Cloud Data Fusion によって新しいバージョンのパイプラインが作成され、[パイプライン] ページで開きます。最新バージョンになりました。
デプロイされたパイプラインの編集済みバージョンをエクスポートする
デプロイされたパイプラインの編集済みバージョンを JSON ファイルとしてエクスポートして、他のデベロッパーと共有したり、バージョン管理に追加したり、開発環境からテスト環境または本番環境に移動したりできます。たとえば、開発フェーズとデバッグ フェーズでパイプラインを編集した後、JSON ファイルをエクスポートし、本番環境にインポートしてデプロイします。
最新バージョンをエクスポートする
パイプラインの最新バージョンをエクスポートするには、次の手順に従います。
- Cloud Data Fusion インターフェースでインスタンスを開きます。
- [List] > [Deployed] をクリックします。
エクスポートするパイプラインを選択し、（その他アイコン > [エクスポート]）をクリックします。
最新バージョンのパイプラインの構成を含む JSON ファイルがローカルに保存されます。
以前のバージョンをエクスポートする
以前のバージョンのパイプラインをエクスポートするには、次の手順に従います。
- Cloud Data Fusion インターフェースでインスタンスを開きます。
- [List] > [Deployed] をクリックします。
- パイプラインを選択します。最新バージョンが [パイプライン] ページで開きます。
- [履歴] をクリックします。
- エクスポートするパイプラインのバージョンを選択して、[表示] > [操作] > [エクスポート] の順にクリックします。
デプロイされたパイプラインの編集済みバージョンをインポートする
すべてのパイプラインは Draft 状態でエクスポートされます。デプロイされたパイプラインの編集済みバージョンも、Draft 状態としてインポートされます。詳細については、パイプラインをインポートするをご覧ください。
編集したバージョンのパイプラインを削除する
デプロイされたパイプラインの最新バージョンを削除すると、デプロイされたパイプラインのすべてのバージョンが削除されます。下書きバージョンは削除されません。
代わりに、ドラフト パイプラインのバージョンは Orphaned（孤立）ステータスになります。このステータスを解消するには、下書きパイプラインをデプロイします。Cloud Data Fusion は、最新バージョンの新しいパイプラインを作成します。
編集済みのパイプラインのステータス
パイプラインを編集すると、[パイプラインの下書き] ページに次のステータスが表示される場合があります。
| ステータス | 説明 |
|---|---|
| 進行中 | パイプラインの編集を保存しました。 |
| 親のない | パイプラインの最新バージョンが削除され、関連する下書きが既存のパイプラインにもう属しなくなりました。このステータスは、誰かがエンドポイント DELETE/v3/namespaces/NAMESPACE_ID/apps/APP_ID
を使用してパイプラインを削除すると発生します。 |
| 廃止 | 編集の進行中に、新しいバージョンがデプロイされています。このステータスは、編集が終了する前に別のデベロッパーがパイプラインをデプロイした場合に表示されます。これは、パイプライン ページに表示される [下書きが期限切れ] と同じです。 |
パイプラインを編集すると、[スタジオ] ページに次のステータスが表示される場合があります。
| ステータス | 説明 |
|---|---|
| 編集が進行中です | ドラフト パイプラインを編集している。 |
| 孤立した下書き | パイプラインの編集中に誰かが新しいバージョンをデプロイしました。 |
次のステップ
- パイプラインをエクスポート、インポートする方法について説明します。