# 선언형 파이프라인

선언형 파이프라인은 YAML 파일을 사용하여 코드로 완전히 Qlik Talend Data Integration 파이프라인 프로젝트를 정의하고, 구성하고, 배포할 수 있게 해줍니다.모든 통합 개발 환경 또는 버전 제어 시스템에서 파일을 편집한 다음, 이를 배포하여 프로젝트를 생성하거나 업데이트합니다.

## 선언형 파이프라인은 언제 사용해야 하나요?

선언적 파이프라인을 사용하여 승격:

* 공동 작업

* 지속적 통합 / 지속적 제공

* 다른 환경으로 반복 가능한 배포

* API 기반 자동화

일반적인 사용 사례는 다음과 같습니다.

* 지속적인 통합 및 개발 자동화를 위해 코드에서 파이프라인을 정의합니다.

* 동일한 파이프라인 구성을 여러 환경(개발, 검증, 프로덕션)에 배포합니다.

* 프로젝트 또는 팀 간에 파이프라인 정의를 재사용하고 공유합니다.

* 수동 작업 없이 대규모 프로젝트 생성을 Automate합니다.

## 작동 방식

파이프라인 프로젝트는 프로젝트의 작업 및 데이터 세트를 반영하는 폴더 구조로 구성된 YAML 파일 세트로 표현됩니다.YAML 파일은 읽기, 차이점 확인, 검토, 재사용 및 자동화 생성이 더 쉽습니다.

기존 프로젝트를 YAML로 내보내기하고, 파일을 편집한 다음 다시 가져와서 변경 사항을 적용할 수 있습니다.프로젝트가 버전 제어에 연결되어 있는 경우, YAML 파일은 GitHub 리포지토리에서 직접 사용할 수 있습니다.

YAML 파일 구조에 대한 자세한 내용은 다음을 참조하십시오. [파이프라인 구성 가져오기 및 편집](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm).

정보 메모바인딩 파일(qtcp\_bindings\_definition.json 및 binding.json)은 바인딩 API와의 호환성을 위해 JSON 형식으로 유지됩니다.레거시 내보내기의 경우 또는 기존 GitHub 프로젝트에서는 파일 이름이 bindingTemplate.json 이고 qtcp\_bindings\_definition.json 이 아닙니다.

## 일반적인 워크플로

시작하기 전에, 개발 환경 및 버전 제어를 설정해야 합니다.자세한 내용은 다음을 참조하십시오. [선언적 파이프라인 시작하기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Getting-started-declarative-pipelines.htm).

전형적인 선언적 파이프라인 워크플로는 다음과 같습니다.

1. 파이프라인 구성을 가져오기

   기존 프로젝트를 YAML로 내보내기하거나, 버전 제어에서 가져오거나, 템플릿에서 시작할 수 있습니다.

   [파이프라인 구성 가져오기 및 편집](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

2. 파이프라인 구성 수정

   개발 환경에서 YAML 파일을 수정하세요.작업을 추가하고, 소스 선택을 변경하며, 설정을 업데이트할 수 있습니다.

   [개발자 가이드: 선언형 파이프라인](http://qlik.dev/manage/di-projects/declarative-pipelines/)

3. 파이프라인 구성 유효성 검사

   파이프라인을 배포하기 전에 파일에서 구문 및 의미 오류를 확인하십시오.

   [파이프라인 구성의 유효성 검사](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

4. 파이프라인 구성 배포

   프로젝트를 생성하거나 업데이트하기 위해 파일을 가져옵니다. Qlik Talend Data Integration.

   파일을 버전 제어에 커밋하고, Qlik Talend Data Integration 프로젝트에서 버전 제어로부터 적용을 수행할 수도 있습니다.

   [파이프라인 구성 배포](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Deploying-pipeline-configuration.htm)

## 버전 제어와의 관계

프로젝트가 버전 제어에 연결되면, YAML 파일은 사용자 GitHub 리포지토리에 직접 저장됩니다.GitHub 또는 모든 IDE에서 YAML 파일을 편집한 다음 변경 사항을 프로젝트에 다시 적용할 수 있습니다.

프로젝트를 버전 제어에 연결하는 방법에 대한 정보는 [버전 제어로 파이프라인 프로젝트 관리](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm)을(를) 참조하십시오.

정보 메모기존 프로젝트가 버전 제어에 연결되어 있고 레거시 JSON 형식을 사용하는 경우, YAML로 마이그레이션할 수 있습니다.자세한 내용은 다음을 참조하십시오. [프로젝트를 YAML 형식으로 마이그레이션](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm#Migrate).

## AI 비서를 사용하여 파이프라인 구성

AI 비서(예: GitHub Copilot 또는 Anthropic Claude)를 사용하여 YAML 구성 생성 및 편집을 간소화하세요.정확도를 보장하고 프로젝트 표준을 준수하려면 다음 모범 사례를 팔로우하세요:

1. **고성능 모델 선택** — 복잡한 YAML 생성 및 스키마 준수를 위해 표준 또는 '자동' 모델 대신 프리미엄, 대규모 컨텍스트 모델(예: Anthropic Claude Sonnet 4.6 이상)을 사용하세요.고급 모델은 복잡한 파이프라인 스키마를 정확하게 해석하고 더욱 정확한 구성을 생성합니다.

2. **프로젝트별 AI 지침 구성** — 모델에 프로젝트 컨텍스트를 제공하여 AI 생성 구성 품질을 향상시킵니다.VS Code 작업 영역의 루트에 지침 파일을 만듭니다.다음 중 하나를 선택합니다.

   * CLAUDE.md (Anthropic Claude Code 확장용)

   * .github/copilot-instructions.md (GitHub Copilot용)

   지시 파일의 내용은 다음과 같아야 합니다:

   ```
   This is a Qlik Talend Cloud Pipeline (QTCP) project. Before any project advice or YAML edits, I MUST read the source of truth first:
   https://raw.githubusercontent.com/qlik-oss/schemas/refs/heads/main/qtcp/ai-instructions.md
   ```

## AI 비서와 함께 Qlik MCP 도구 사용

사용자의 Qlik MCP 서버를 테넌트에 배포할 때, AI 어시스턴트는 전용 MCP 도구를 사용하여 파이프라인 프로젝트를 프로그래밍 방식으로 관리하는 데 도움을 줄 수 있습니다.

### 전제 조건

* Qlik MCP 서버가 사용자의 테넌트에 배포되어 있습니다.

* 사용자에게는 Qlik MCP: 허용됨 권한이 사용자 지정 역할을 통해 할당되었습니다.

* 파이프라인 프로젝트를 생성하거나 편집할 권한이 있습니다.

* MCP 지원을 사용하는 AI 클라이언트(GitHub Copilot이 포함된 VS Code와 같은)는 Qlik MCP 서버를 사용하도록 구성됩니다.

### 데이터 파이프라인용 사용 가능한 MCP 기능

AI 비서는 파이프라인 프로젝트를 구성 및 관리하는 데 다음 기능을 사용할 수 있습니다.

* **공간 검색** — 사용 가능한 공간 목록을 가져옵니다.

* **연결 검색** — 사용 가능한 데이터 연결 목록을 가져옵니다.

* **프로젝트 검색** — 기존 파이프라인 프로젝트 목록을 가져옵니다.

* **연결 개체 검색** — 데이터 소스에서 사용 가능한 테이블 및 뷰를 찾습니다.

* **파이프라인 프로젝트 세부 정보 가져오기** — 프로젝트 바인딩 값을 검색합니다.

### 관련 리소스

* MCP 서버를 배포하려면 [Qlik MCP 서버](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikMCP/Qlik-MCP-server.htm)를 참조하십시오.

* 자세한 MCP 도구 설명서는 다음을 참조하십시오. [Qlik MCP 도구](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikMCP/Qlik-MCP-server-tools.htm)

* 권한 요구 사항은 다음을 참조하십시오. [Qlik MCP 서버 액세스 및 권한](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikMCP/Qlik-MCP-Permissions.htm)