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

파이프라인의 YAML 구성 파일은 프로젝트를 내보내거나 버전 제어에서 검색하여 가져올 수 있습니다.그런 다음 개발 환경에서 YAML 파일을 편집하여 변경 사항을 적용할 수 있습니다.

시작할 때 세 가지 옵션이 있습니다.

프로젝트를 YAML로 내보내기

프로젝트를 내보내면 모든 작업, 데이터 세트 및 프로젝트 설정에 대한 YAML 파일이 포함된 ZIP 파일이 생성됩니다.자세한 내용은 데이터 파이프라인 내보내기 및 가져오기을 참조하십시오.

팁 메모먼저 최소화된 형식으로 내보내세요.최소화된 파일은 기본값과 다른 부분만 보여주므로 읽기 쉽고 프로젝트 전반에 걸쳐 복제하기 쉽습니다.최소화된 파일을 가져올 때, Qlik Talend Data Integration 지정된 값을 적용하고 나머지 모든 항목에는 기본값을 사용합니다.사용 가능한 속성 및 해당 기본값의 전체 목록을 확인해야 하는 경우, 동일한 프로젝트를 전체 형식으로 내보내기하여 참고하십시오.
버전 제어에서 프로젝트 가져오기

자세한 내용은 버전 제어에서 프로젝트 가져오기을 참조하십시오.
필요한 폴더 구조와 일치하는 YAML 파일을 작성하여 파이프라인 구성을 처음부터 만들 수도 있지만, 기존 템플릿에서 시작하는 것을 권장합니다.

프로젝트를 YAML 형식으로 마이그레이션

선언적 파이프라인 관리가 도입되기 전에 생성된 프로젝트는 레거시 JSON 파일을 사용하여 버전 제어에 저장됩니다.

레거시 JSON 형식은 2027년 6월 말까지 지원되므로, 프로젝트를 원활하게 계획하고 마이그레이션할 시간을 가질 수 있습니다.

이 프로젝트들을 YAML 기반 구조로 마이그레이션하여 최소화된 파일과 선언적 파이프라인 워크플로의 이점을 활용할 수 있습니다.

이 작업은 레거시 JSON 형식으로 저장된 프로젝트에서만 사용할 수 있습니다.이미 YAML 파일을 사용하는 프로젝트에는 이 옵션이 표시되지 않습니다.

프로젝트를 YAML 형식으로 마이그레이션하려면:

프로젝트를 열고 버전 제어 메뉴를 엽니다.
YAML 형식으로 마이그레이션을 클릭합니다.
확인 메시지를 검토하고 마이그레이션을 클릭합니다.

정보 메모마이그레이션 프로세스는 현재 프로젝트 상태를 JSON으로 커밋하고 푸시한 다음, 파일을 새 YAML 구조로 변환하고 다시 커밋합니다.폴더 구조 및 파일 이름이 변환 중에 변경되므로, 마이그레이션 전 버전 기록은 마이그레이션 후 기록과 직접 비교할 수 없을 수 있습니다.

마이그레이션이 완료되면 프로젝트는 현재 브랜치에 YAML 형식으로 저장됩니다.JSON 파일을 여전히 포함하는 다른 브랜치는 다음에 해당 브랜치로 전환할 때 마이그레이션 옵션을 표시합니다.

모든 환경 브랜치를 순서대로 — 개발 브랜치부터 시작하여 — 마이그레이션하여, 브랜치 간에 풀 리퀘스트를 열기 전에 일관된 구조를 유지하세요.

파일 구조 이해

추출된 폴더에는 다음 파일이 포함되어 있습니다.모든 작업 유형에서 파일 내용이 동일합니다.

qtcp_project.yaml qtcp_tasks/ <task-name>/ task.yaml sourceSelection.yaml schedule.yaml (only if a schedule is configured) model.yaml (only if relationships are defined) transformationRules.yaml (only if task-level rules are defined) datasets/ <dataset-name>.yaml newTaskDefaults.yaml (only if custom task defaults are defined)

qtcp_project.yaml

qtcp_project.yaml에는 프로젝트 수준 정의가 포함되어 있으며, 이름, 플랫폼, 기본 스키마 처리 방식과 같은 속성을 담고 있습니다.

task.yaml

task.yaml에는 태스크 수준 정의가 포함되어 있으며, 태스크 이름, 유형, 연결, 그리고 전체 로드 및 변경 캡처 동작과 같은 속성을 포함합니다.

sourceSelection.yaml

sourceSelection.yaml은(는) 작업에 대해 선택된 소스 테이블을 정의합니다.각 항목은 스키마 및 테이블 선택 패턴을 지정합니다.

소스 선택은 랜딩과 다른 작업 유형 간에 다릅니다.

데이터세트 파일

각 데이터 집합에는 해당 데이터 집합의 이름을 딴 YAML 파일이 하나 있으며, 이 파일은 datasets/ 폴더에 바로 있습니다.파일은 데이터 집합 정의와 명시적인 변환 규칙을 결합합니다.

데이터 세트 파일은 랜딩 작업을 제외한 모든 작업에 필요하며, 다른 작업에서 데이터 세트를 참조하려면 데이터 세트 ID를 포함해야 합니다.

schedule.yaml

schedule.yaml은 작업 실행 시기를 정의합니다.파일에는 스케줄 구성이 있는 scheduling 배열이 포함되어 있습니다.이 파일은 프로젝트에 일정이 설정된 경우에만 포함됩니다.

model.yaml

model.yaml은 작업에 대한 데이터 모델 관계를 정의합니다.파일에 relationships 배열이 포함되어 있습니다.

변환 규칙.yaml

transformationRules.yaml에는 모든 작업 수준 변환 규칙이 배열로 포함되어 있습니다.

구성 파일 편집

IDE에서 추출된 폴더를 열고 필요에 따라 YAML 파일을 편집합니다.일반적인 수정 사항은 다음과 같습니다:

다른 환경을 가리키도록 연결 이름을 변경합니다.
sourceSelection.yaml에서 소스 테이블 추가 또는 제거
로드 유형 또는 스키마 처리와 같은 작업 설정 업데이트.
데이터 집합 파일에 변환 규칙 추가
작업에 일정을 추가합니다.

대상 공간에 정의된 연결 이름을 정확히 참조하십시오.연결 이름이 일치하지 않으면 가져오기 오류가 발생합니다.

YAML 파일의 개체 ID

참조된 개체의 경우(예: 다른 작업의 소스 정의에서 참조되는 작업 ID) 고유 ID를 정의하고 파일 전체에서 일관되게 사용해야 합니다.

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

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

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