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

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

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

## 開始する前に

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

* YAML ファイルで参照されているすべての接続が、ターゲットスペースに存在すること。YAML ファイル内の接続名は、完全に一致している必要があります。

* パイプラインにプロジェクト間参照が含まれている場合 (例: あるプロジェクトのランディング タスクからデータを読み取るパイプライン タスク)、先にアップストリームのプロジェクトをインポートしていること。

* 設定ファイルを検証し、エラーがないこと。「[パイプライン設定を検証する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)」を参照してください。

## UI からのインポート

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

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

1. [データ統合] > [パイプライン プロジェクト] で、 [新規作成] をクリックします。

2. [プロジェクトをインポート] を選択します。

3. ターゲット スペースを選択します。

4. 設定を含む ZIP ファイルをアップロードします。

5. [インポート] をクリックします。

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

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

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

1. [データ統合] > [パイプライン プロジェクト] で、プロジェクトの the More icon をクリックして、 [インポート] を選択します。

2. 更新された設定を含む ZIP ファイルをアップロードします。

3. [インポート] をクリックします。

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

## API を使用したインポート

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

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

ヒント メモCI/CD パイプラインでは、Import API を実行する前に Validate-project-definitions API を使用することをお勧めします。「[パイプライン設定を検証する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)」を参照してください。

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

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

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

バージョン管理の設定方法については、「[バージョン管理によるパイプライン プロジェクトの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm)」を参照してください。

## インポート エラーの処理

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

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

各エラー タイプの説明および解決方法については、「[パイプライン設定を検証する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)」を参照してください。

## 関連トピック

* [パイプライン設定を検証する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

* [パイプライン設定の取得と編集](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

* [データ パイプラインのエクスポートとインポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm)