선언형 파이프라인

마지막 업데이트: 2026. 9. 8.

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

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

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

공동 작업
지속적 통합 / 지속적 제공
다른 환경으로 반복 가능한 배포
API 기반 자동화

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

지속적인 통합 및 개발 자동화를 위해 코드에서 파이프라인을 정의합니다.
동일한 파이프라인 구성을 여러 환경(개발, 검증, 프로덕션)에 배포합니다.
프로젝트 또는 팀 간에 파이프라인 정의를 재사용하고 공유합니다.
수동 작업 없이 대규모 프로젝트 생성을 Automate합니다.

작동 방식

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

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

YAML 파일 구조에 대한 자세한 내용은 다음을 참조하십시오. 파이프라인 구성 가져오기 및 편집.

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

일반적인 워크플로

시작하기 전에, 개발 환경 및 버전 제어를 설정해야 합니다.자세한 내용은 다음을 참조하십시오. 선언형 파이프라인 시작하기.

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

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

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

파이프라인 구성 가져오기 및 편집
파이프라인 구성 수정

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

개발자 가이드: 선언형 파이프라인
파이프라인 구성 유효성 검사

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

파이프라인 구성의 유효성 검사
파이프라인 구성 배포

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

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

파이프라인 구성 배포

버전 제어와의 관계

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

프로젝트를 버전 제어에 연결하는 방법에 대한 정보는 버전 제어로 파이프라인 프로젝트 관리을(를) 참조하십시오.

기존 프로젝트가 버전 제어에 연결되어 있고 레거시 JSON 형식을 사용하는 경우, YAML로 마이그레이션할 수 있습니다.자세한 내용은 다음을 참조하십시오. 프로젝트를 YAML 형식으로 마이그레이션.

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

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

고성능 모델 선택 — 복잡한 YAML 생성 및 스키마 준수를 위해 표준 또는 '자동' 모델 대신 프리미엄, 대규모 컨텍스트 모델(예: Anthropic Claude Sonnet 4.6 이상)을 사용하세요.고급 모델은 복잡한 파이프라인 스키마를 정확하게 해석하고 더욱 정확한 구성을 생성합니다.
프로젝트별 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 비서는 파이프라인 프로젝트를 구성 및 관리하는 데 다음 기능을 사용할 수 있습니다.

공간 검색 — 사용 가능한 공간 목록을 가져옵니다.
연결 검색 — 사용 가능한 데이터 연결 목록을 가져옵니다.
프로젝트 검색 — 기존 파이프라인 프로젝트 목록을 가져옵니다.
연결 개체 검색 — 데이터 소스에서 사용 가능한 테이블 및 뷰를 찾습니다.
파이프라인 프로젝트 세부 정보 가져오기 — 프로젝트 바인딩 값을 검색합니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.