パイプライン設定を展開する

YAML 設定ファイルを含む ZIP ファイルをインポートすることで、パイプライン設定を展開します。UI または Import API を使用して、新しいプロジェクトを作成したり、既存のプロジェクトを更新したりできます。どちらも、最小化された YAML 形式およびレガシー JSON 形式を受け付けます。

バージョン管理を使用している場合は、変更内容をコミットし、リモートから適用を実行して、Qlik Talend Data Integration に変更を反映できます。

開始する前に

インポートする前に、次を確認してください。

YAML ファイルで参照されているすべての接続が、ターゲットスペースに存在すること。YAML ファイル内の接続名は、完全に一致している必要があります。
パイプラインにプロジェクト間参照が含まれている場合 (例: あるプロジェクトのランディングタスクからデータを読み取るパイプラインタスク)、先にアップストリームのプロジェクトをインポートしていること。
設定ファイルを検証し、エラーがないこと。「パイプライン設定を検証する」を参照してください。

UI からのインポート

新しいプロジェクトを作成する

設定ファイルから新しいプロジェクトを作成するには、次を実行します。

[データ統合] > [パイプラインプロジェクト] で、 [新規作成] をクリックします。
[プロジェクトをインポート] を選択します。
ターゲットスペースを選択します。
設定を含む ZIP ファイルをアップロードします。
[インポート] をクリックします。

インポートが成功すると、プロジェクトが開きます。エラーがある場合は、検証メッセージの一覧が表示されます。設定ファイルのエラーを修正し、もう一度実行してください。

既存のプロジェクトを更新する

既存のプロジェクトを新しい設定で更新するには、次を実行します。

[データ統合] > [パイプラインプロジェクト] で、プロジェクトのをクリックして、 [インポート] を選択します。
更新された設定を含む ZIP ファイルをアップロードします。
[インポート] をクリックします。

設定をインポートすると、現在のプロジェクト設定は YAML ファイル内の値で上書きされます。インポートするファイルに含まれていない設定は、最小化形式でエクスポートした場合は変更されず、完全形式でエクスポートした場合は既定値にリセットされます。

API を使用したインポート

Import API は、ZIP ファイルとターゲットスペース ID を受け入れます。成功した場合は更新後のプロジェクトを返し、検証に失敗した場合はエラーの一覧を返します。

Import API は、YAML (最小化形式または完全形式) とレガシー JSON の両方のエクスポート形式をサポートしています。インポートする前に、既存の JSON エクスポートを変換する必要はありません。

CI/CD パイプラインでは、Import API を実行する前に Validate-project-definitions API を使用することをお勧めします。「パイプライン設定を検証する」を参照してください。

バージョン管理からの変更の適用

プロジェクトがバージョン管理リポジトリに接続されている場合は、プロジェクトから直接リモートの変更を適用できます。変更を適用すると、Qlik Talend Data Integration は接続されたブランチから現在の YAML ファイルを読み込んでインポートします。

変更が適用される前に検証が実行されます。エラーがある場合は、手動インポートと同じエラーメッセージが表示されます。

バージョン管理の設定方法については、「バージョン管理によるパイプラインプロジェクトの管理」を参照してください。

インポートエラーの処理

インポートに失敗した場合、Qlik Talend Data Integration は検証エラーのリストを返します。各エラーには、エラータイプと、問題が検出されたファイルまたはプロパティへのパスが含まれます。

1 回のインポート試行につき、最大 50 個のエラーが返されます。表示されたエラーを修正し、再度インポートすることで、追加の問題を確認できます。

各エラータイプの説明および解決方法については、「パイプライン設定を検証する」を参照してください。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください