이 페이지에서는 Cloud Data Fusion에서 배포된 일괄 파이프라인을 수정하는 방법을 설명합니다.
파이프라인을 수정하면 다음 작업을 할 수 있습니다.
중복을 만들지 않고 배포된 파이프라인에 기능을 점진적으로 추가합니다. 예를 들어 플러그인을 추가, 삭제 또는 수정한 후 파이프라인을 재배포할 수 있습니다. 파이프라인을 수정하면 동일한 파이프라인의 새 버전이 생성되므로 파이프라인이 급증하지 않아 조직화가 개선됩니다. 파이프라인을 복제하면 다른 이름의 새 파이프라인이 생성됩니다.
수정된 버전의 기록을 유지합니다.
이전 버전의 파이프라인을 보고 복원합니다.
파이프라인 구조, 구성, 메타데이터, 환경설정, 댓글과 같은 파이프라인의 모든 부분을 수정합니다.
배포된 파이프라인의 수정된 JSON 파일을 내보냅니다.
파이프라인을 수정하면 Cloud Data Fusion이 새 초안을 만들며 이 초안이 최신 버전이 됩니다. 파이프라인 이름은 동일하게 유지됩니다. 고유한 이름으로 중복 파이프라인을 만들지 않고 파이프라인을 반복적으로 개발합니다. 최신 버전은 이전 버전의 트리거, 파이프라인 구성, 런타임 인수, 메타데이터, 댓글, 일정을 유지합니다.
최신 버전은 파이프라인의 활성 버전으로서 실행할 수 있으며 실행을 예약할 수도 있습니다.
시작하기 전에
Cloud Data Fusion은 버전 6.9.1 이상에서 배포된 일괄 파이프라인의 수정을 지원합니다. 최신 버전으로 업그레이드하려면 Cloud Data Fusion 환경 업그레이드를 참고하세요.
Cloud Data Fusion은 배포된 실시간 파이프라인 또는 복제 작업의 수정을 지원하지 않습니다.
파이프라인 수정
Cloud Data Fusion에서 배포된 일괄 파이프라인을 수정하려면 다음 단계를 따르세요.
인스턴스로 이동합니다.
Google Cloud 콘솔에서 Cloud Data Fusion 페이지로 이동합니다.
Cloud Data Fusion Studio에서 인스턴스를 열려면 인스턴스를 클릭한 다음 인스턴스 보기를 클릭합니다.
변경사항 요약 입력 대화상자에 파이프라인에 적용한 변경사항에 대한 설명을 입력하고 배포를 클릭합니다. 배포된 파이프라인이 파이프라인 페이지에서 열립니다.
이전 버전의 파이프라인 보기 또는 복원
이전 버전의 일괄 처리 파이프라인을 보거나 배포하려면 다음 단계를 따르세요.
Cloud Data Fusion 인터페이스에서 인스턴스를 엽니다.
목록 > 배포됨을 클릭합니다.
파이프라인을 선택합니다. 파이프라인이 파이프라인 페이지에 표시됩니다.
history기록을 클릭합니다.
버전 기록 목록이 표시됩니다.
선택사항: 이전 버전의 파이프라인을 보려면 보기를 클릭합니다.
선택사항: 이전 버전의 파이프라인을 최신 버전으로 복원하려면 복원을 클릭합니다.
Cloud Data Fusion이 파이프라인의 새 버전을 만들고 파이프라인 페이지에서 해당 버전을 엽니다. 이제 이 버전이 최신 버전입니다.
수정된 버전의 배포된 파이프라인 내보내기
배포된 파이프라인의 수정된 버전을 JSON 파일로 내보내 다른 개발자와 공유하거나 버전 제어에 추가하거나 개발 환경에서 테스트 또는 프로덕션 환경으로 이동시킬 수 있습니다. 예를 들어 개발 및 디버깅 단계에서 파이프라인을 수정한 후 JSON 파일을 내보낸 다음 가져와서 프로덕션 환경에 배포합니다.
최신 버전 내보내기
최신 버전의 파이프라인을 내보내려면 다음 단계를 따르세요.
Cloud Data Fusion 인터페이스에서 인스턴스를 엽니다.
목록 > 배포됨을 클릭합니다.
내보낼 파이프라인을 선택하고 more_vert더보기 > 내보내기를 클릭합니다.
최신 버전의 파이프라인 구성이 있는 JSON 파일이 로컬에 저장됩니다.
이전 버전 내보내기
이전 버전의 파이프라인을 내보내려면 다음 단계를 따르세요.
Cloud Data Fusion 인터페이스에서 인스턴스를 엽니다.
목록 > 배포됨을 클릭합니다.
파이프라인을 선택합니다. 최신 버전이 파이프라인 페이지에서 열립니다.
history기록을 클릭합니다.
내보내려는 파이프라인 버전을 선택하고 보기
> 작업 > 내보내기를 클릭합니다.
수정된 버전의 배포된 파이프라인 가져오기
모든 파이프라인은 Draft 상태로 내보내집니다. 배포된 파이프라인의 수정된 버전도 Draft 상태로 가져옵니다.
자세한 내용은 파이프라인 가져오기를 참고하세요.
수정된 버전의 파이프라인 삭제
배포된 파이프라인의 최신 버전을 삭제하면 배포된 파이프라인의 모든 버전이 삭제됩니다. 초안 버전은 삭제되지 않습니다.
대신 초안 파이프라인 버전에는 고아 상태가 있습니다. 이 상태를 해결하려면 초안 파이프라인을 배포합니다. Cloud Data Fusion이 최신 버전인 새 파이프라인을 만듭니다.
수정된 파이프라인의 상태
파이프라인을 수정하면 파이프라인 초안 페이지에 다음 상태가 표시될 수 있습니다.
상태
설명
진행 중
파이프라인에 수정사항을 저장했습니다.
분리됨
파이프라인의 최신 버전이 삭제되었고 연결된 초안이 더 이상 기존 파이프라인에 속하지 않습니다. 누군가 DELETE/v3/namespaces/NAMESPACE_ID/apps/APP_ID 엔드포인트로 파이프라인을 삭제하면 이 상태가 표시될 수 있습니다.
사용되지 않음
수정 작업이 진행되는 동안 최신 버전이 배포되었습니다.
수정을 완료하기 전에 다른 개발자가 파이프라인을 배포하면 이 상태가 표시될 수 있습니다. 이는 파이프라인 페이지에 표시되는 초안 오래됨과 동일합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eDeployed batch pipelines in Cloud Data Fusion can be edited, allowing for incremental feature additions without creating duplicate pipelines.\u003c/p\u003e\n"],["\u003cp\u003eEditing a pipeline in Cloud Data Fusion generates a new version, maintaining a history of changes and enabling users to view or restore previous versions.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of an edited pipeline is the active one, inheriting configurations and schedules from previous versions, and can be run or scheduled to run.\u003c/p\u003e\n"],["\u003cp\u003eEdited versions of pipelines can be exported as JSON files, facilitating sharing, version control, or movement between development and production environments.\u003c/p\u003e\n"],["\u003cp\u003eDeleting the latest version of a deployed pipeline removes all its versions, while drafts become orphaned and require redeployment to become active again.\u003c/p\u003e\n"]]],[],null,["# Edit pipelines\n\nThis page describes how to edit deployed batch pipelines in Cloud Data Fusion.\n\nEditing a pipeline lets you do the following:\n\n- Incrementally add features to a deployed pipeline without creating duplicates. For example, you can add, remove, or modify plugins, then redeploy the pipeline. Editing a pipeline creates a new version of the same pipeline, which prevents a proliferation of pipelines, allowing for better organization. Duplicating a pipeline creates a new pipeline with a different name.\n- Maintain a history of the edited versions.\n- View and restore old versions of a pipeline.\n- Edit any part of the pipeline, such as the pipeline structure, configuration, metadata, preferences, and comments.\n- Export an edited JSON file for a deployed pipeline.\n\nWhen you edit the pipeline, Cloud Data Fusion creates a new draft, which\nbecomes the *latest version*. The name of the pipeline remains the same. You\ndevelop the pipeline iteratively, without creating duplicate pipelines with\nunique names. The latest version retains the triggers, pipeline configurations,\nruntime arguments, metadata, comments, and schedules from the previous version.\nThe latest version is the active version of the pipeline: it can be run or\nscheduled to run.\n\nBefore you begin\n----------------\n\n- Cloud Data Fusion supports editing deployed batch pipelines in version 6.9.1 and later. To upgrade to the latest version, see [Upgrade your Cloud Data Fusion environment](/data-fusion/docs/how-to/upgrading).\n- Cloud Data Fusion doesn't support editing deployed real-time pipelines or replication jobs.\n\nEdit the pipeline\n-----------------\n\nTo edit a deployed batch pipeline in Cloud Data Fusion, follow these steps:\n\n1. Go to your instance:\n 1. In the Google Cloud console, go to the Cloud Data Fusion page.\n\n 2. To open the instance in the Cloud Data Fusion Studio,\n click **Instances** , and then click **View instance**.\n\n [Go to Instances](https://console.cloud.google.com/data-fusion/locations/-/instances)\n2. Click **List \\\u003e Deployed**.\n3. Go to the pipeline that you want to edit and click\n more_vert **More \\\u003e Edit**.\n\n A new draft of the pipeline appears on\n the **Studio** page.\n4. Edit your pipeline. For example, add a new analytics node, or\n edit the properties of a source.\n\n5. Optional: To finish editing the pipeline later, click **Save**.\n\n6. After you finish editing the pipeline, click **Deploy**.\n\n7. In the **Enter change summary** dialog, enter a description of the changes\n you made to the pipeline and click **Deploy** . The deployed pipeline opens\n on the **Pipeline** page.\n\n| **Note:** You can also edit the pipeline from the **Pipeline** page by clicking **Actions \\\u003e Edit**.\n\nView or restore a previous version of the pipeline\n--------------------------------------------------\n\nTo view or deploy a previous version of a batch pipeline, follow these steps:\n\n1. Open your instance in the Cloud Data Fusion interface.\n2. Click **List \\\u003e Deployed**.\n3. Select a pipeline. The pipeline appears on the **Pipeline** page.\n4. Click history **History**.\n\n A version history list appears.\n5. Optional: To view a previous version of a pipeline, click **View**.\n\n6. Optional: To restore an older version of the pipeline to the latest\n version, click **Restore**.\n\n Cloud Data Fusion creates a new version of the pipeline and opens\n it on the **Pipeline** page. It's now the latest version.\n\nExport an edited version of a deployed pipeline\n-----------------------------------------------\n\nYou can export the edited version of a deployed pipeline as a JSON file to share\nwith other developers, add it to version control, or move it from a development\nenvironment to a test or production environment. For example, after you edit a\npipeline during development and debugging phases, you export the JSON file, and\nthen import and deploy it in a production environment.\n| **Note:** Cloud Data Fusion exports pipelines in the `Draft` state.\n\n### Export the latest version\n\nTo export the latest version of the pipeline, follow these steps:\n\n1. Open your instance in the Cloud Data Fusion interface.\n2. Click **List \\\u003e Deployed**.\n3. Select the pipeline that you want to export and click\n more_vert **More \\\u003e Export**.\n\n A JSON file with the pipeline configurations from the latest version is\n saved locally.\n\n### Export a previous version\n\nTo export previous versions of the pipeline, follow these steps:\n\n1. Open your instance in the Cloud Data Fusion interface.\n2. Click **List \\\u003e Deployed**.\n3. Select the pipeline. The latest version opens on the **Pipelines** page.\n4. Click history **History**.\n5. Select the pipeline version that you want to export and click **View\n \\\u003e Actions \\\u003e Export**.\n\nImport an edited version of a deployed pipeline\n-----------------------------------------------\n\nAll pipelines are exported in the `Draft` state. Edited versions of a deployed\npipeline are also imported in the `Draft` state.\nFor more information,\nsee [Import a pipeline](/data-fusion/docs/how-to/exporting-pipelines#import).\n\nDelete an edited version of a pipeline\n--------------------------------------\n\nWhen you delete the latest version of a deployed pipeline, all versions of the\ndeployed pipeline are deleted. Draft versions aren't deleted.\n\nInstead, the draft pipeline version has the **Orphaned** status. To resolve this\nstatus, deploy the draft pipeline. Cloud Data Fusion creates a new\npipeline, which is the latest version.\n\nStatuses for edited pipelines\n-----------------------------\n\nWhen you edit pipelines, the following statuses might appear on the **Pipeline\nDrafts** page.\n\nWhen you edit pipelines, the following statuses might appear on the **Studio**\npage.\n\nWhat's next\n-----------\n\n- Learn how to [export and import pipelines](/data-fusion/docs/how-to/exporting-pipelines)."]]
