Azure Data Factory 및 Azure Synapse Analytics에서 지원하는 시스템 변수
적용 대상: 
Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!
이 문서에서는 Azure Data Factory 및 Azure Synapse에서 지원하는 시스템 변수에 대해 설명합니다. 두 서비스 내에서 엔터티를 정의할 때 식에서 이러한 변수를 사용할 수 있습니다.
파이프라인 범위
이러한 시스템 변수는 파이프라인 JSON의 어디에서나 참조할 수 있습니다.
| 변수 이름 | 설명 |
|---|---|
| @pipeline().DataFactory | 파이프라인 실행이 진행 중인 데이터 또는 Synapse 작업 영역의 이름 |
| @pipeline().Pipeline | 파이프라인 이름입니다. |
| @pipeline().RunId | 특정 파이프라인의 실행 ID |
| @pipeline().TriggerType | 파이프라인을 호출한 트리거의 유형입니다(예: ScheduleTrigger, BlobEventsTrigger). 지원되는 트리거 유형 목록은 파이프라인 실행 및 트리거를 참조하세요. Manual 트리거 유형은 파이프라인이 수동으로 트리거되었음을 나타냅니다. |
| @pipeline().TriggerId | 파이프라인을 호출한 트리거 ID |
| @pipeline().TriggerName | 파이프라인을 호출한 트리거 이름 |
| @pipeline().TriggerTime | 파이프라인을 호출한 트리거 실행 시간. 이는 트리거가 파이프라인 실행을 실제로 실행한 시간이며, 트리거가 예약된 시간과는 약간 다를 수 있습니다. |
| @pipeline().GroupId | 파이프라인 실행이 속한 그룹의 ID입니다. |
| @pipeline()?.TriggeredByPipelineName | 파이프라인 실행을 트리거하는 파이프라인의 이름입니다. ExecutePipeline 활동에 의해 파이프라인 실행이 트리거될 때 적용됩니다. 다른 상황에서 사용하는 경우 Null로 평가합니다. @pipeline() 뒤에 물음표가 있습니다. |
| @pipeline()?.TriggeredByPipelineRunId | 파이프라인 실행을 트리거하는 파이프라인의 실행 ID입니다. ExecutePipeline 활동에 의해 파이프라인 실행이 트리거될 때 적용됩니다. 다른 상황에서 사용하는 경우 Null로 평가합니다. @pipeline() 뒤에 물음표가 있습니다. |
참고 항목
트리거 관련 날짜/시간 시스템 변수(파이프라인 및 트리거 범위 모두에서)는 ISO 8601 형식으로 UTC 날짜를 반환합니다(예: 2017-06-01T22:20:00.4061448Z).
일정 트리거 범위
이 시스템 변수는 트리거가 ScheduleTrigger 유형인 경우, 트리거 JSON의 어디에서나 참조할 수 있습니다.
| 변수 이름 | 설명 |
|---|---|
| @trigger().scheduledTime | 트리거가 파이프라인 실행을 호출하도록 예약된 시간입니다. |
| @trigger().startTime | 트리거가 파이프라인 실행을 실제로 실행한 시간입니다. 트리거가 예약된 시간과는 약간 다를 수 있습니다. |
연속 창 트리거 범위
이 시스템 변수는 트리거가 TumblingWindowTrigger 유형인 경우, 트리거 JSON의 어디에서나 참조할 수 있습니다.
| 변수 이름 | 설명 |
|---|---|
| @trigger().outputs.windowStartTime | 트리거 실행과 관련된 기간의 시작입니다. |
| @trigger().outputs.windowEndTime | 트리거 실행과 관련된 기간의 끝입니다. |
| @trigger().scheduledTime | 트리거가 파이프라인 실행을 호출하도록 예약된 시간입니다. |
| @trigger().startTime | 트리거가 파이프라인 실행을 실제로 실행한 시간입니다. 트리거가 예약된 시간과는 약간 다를 수 있습니다. |
스토리지 이벤트 트리거 범위
이 시스템 변수는 트리거가 BlobEventsTrigger 유형인 경우, 트리거 JSON의 어디에서나 참조할 수 있습니다.
| 변수 이름 | 설명 |
|---|---|
| @triggerBody().fileName | 생성 또는 삭제로 인해 트리거가 실행된 파일의 이름입니다. |
| @triggerBody().folderPath | @triggerBody().fileName로 지정된 파일을 포함하는 폴더의 경로입니다. 폴더 경로의 첫 번째 세그먼트는 Azure Blob Storage 컨테이너의 이름입니다. |
| @trigger().startTime | 트리거가 파이프라인 실행을 실행한 시간입니다. |
참고 항목
Azure Synapse Analytics에서 파이프라인 및 트리거를 만드는 경우 @trigger().outputs.body.fileName 및 @trigger().outputs.body.folderPath를 매개 변수로 사용해야 합니다. 이러한 두 속성은 Blob 정보를 캡처합니다. @triggerBody().fileName 및 @triggerBody().folderPath를 사용하는 대신 이러한 속성을 사용합니다.
사용자 지정 이벤트 트리거 범위
이 시스템 변수는 트리거가 CustomEventsTrigger 유형인 경우, 트리거 JSON의 어디에서나 참조할 수 있습니다.
참고 항목
이 서비스는 사용자 지정 이벤트가 Azure Event Grid 이벤트 스키마를 사용하여 형식이 지정되어 있을 것으로 예상합니다.
| 변수 이름 | 설명 |
|---|---|
| @triggerBody().event.eventType | 사용자 지정 이벤트 트리거 실행을 트리거한 이벤트의 유형입니다. 이벤트 유형은 고객이 정의한 필드이며 문자열 유형의 값을 사용합니다. |
| @triggerBody().event.subject | 트리거가 실행되도록 한 사용자 지정 이벤트의 제목입니다. |
| @triggerBody().event.data._keyName_ | 사용자 지정 이벤트의 데이터 필드는 고객이 메시지와 데이터를 보내기 위해 사용하는 JSON Bob에서 무료로 제공됩니다. data.keyName을 사용하여 각 필드를 참조하세요. 예를 들어 @triggerBody().event.data.callback은 data에 저장된 callback 필드의 값을 반환합니다. |
| @trigger().startTime | 트리거가 파이프라인 실행을 실행한 시간입니다. |
관련 콘텐츠
- 이러한 변수가 식에서 사용되는 방법은 식 언어 및 함수를 참조하세요.
- 파이프라인에서 트리거 범위 시스템 변수를 사용하려면 파이프라인의 참조 트리거 메타데이터를 참조하세요.