Azure Data Factory 또는 Azure Synapse 파이프라인을 사용하여 이메일 보내기

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

파이프라인을 실행 중 또는 실행 후에 알림을 보내야 하는 경우가 많습니다. 알림은 사전 경고를 제공하고 문제를 발견하기 위한 사후 모니터링의 필요성을 줄여줍니다.  이 문서에서는 Azure Data Factory 또는 Azure Synapse 파이프라인에서 이메일 알림을 구성하는 방법을 보여줍니다. 

필수 조건

• Azure 구독. Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
• 표준 논리 앱 워크플로. 파이프라인에서 이메일 보내기를 트리거하려면 Azure Logic Apps를 사용하여 워크플로를 정의합니다. 표준 논리 앱 워크플로를 만드는 방법에 대한 자세한 내용은 예 표준 논리 앱 워크플로 만들기를 참조하세요.

논리 앱에서 이메일 워크플로 만들기

SendEmailFromPipeline이라는 표준 논리 앱 워크플로를 만듭니다. When an HTTP request is received라는 요청 트리거를 추가하고 Send an email (V2)라는 Office 365 Outlook 작업을 추가합니다.

요청 트리거에서 Request Body JSON Schema 속성에 대해 이 JSON을 제공합니다.

{
    "properties": {
        "dataFactoryName": {
            "type": "string"
        },
        "message": {
            "type": "string"
        },
        "pipelineName": {
            "type": "string"
        },
        "receiver": {
            "type": "string"
        }
    },
    "type": "object"
}

워크플로 디자이너의 요청 트리거는 다음과 같아야 합니다.

이메일 보내기(V2) 작업의 경우 요청 본문 JSON 스키마의 속성을 사용하여 이메일의 형식을 지정하는 방법을 사용자 지정합니다.

워크플로를 저장합니다. 워크플로에 대한 개요 페이지로 이동합니다. 아래 이미지에 강조 표시된 워크플로 URL을 기록해 둡니다.

참고 항목

워크플로 URL을 찾으려면 단지 워크플로가 포함된 논리 앱이 아니라 워크플로 자체로 이동해야 합니다. 논리 앱 인스턴스의 워크플로 페이지에서 워크플로를 선택한 다음 해당 개요 페이지로 이동합니다.

논리 앱 워크플로를 트리거하는 파이프라인 만들기

이메일을 보내는 논리 앱 워크플로를 만든 후에는 웹 활동을 사용하여 파이프라인에서 트리거할 수 있습니다.

1. 새 파이프라인을 만들고 일반 범주에서 웹 활동을 찾아 편집 캔버스로 끌어옵니다.

2. 새 Web1 활동을 선택한 다음, 설정 탭을 선택합니다.

   URL 필드에서 이전에 만든 논리 앱 워크플로의 URL을 제공합니다.

   본문에 다음 JSON을 제공합니다.

      {
       "message" : "This is a custom dynamic message from your pipeline with run ID @{pipeline().RunId}.",
       "dataFactoryName" : "@{pipeline().DataFactory}", 
       "pipelineName" : "@{pipeline().Pipeline}", 
       "receiver" : "@{pipeline().parameters.receiver}"
      }
   

   동적 식을 사용하여 파이프라인의 이벤트에 대한 유용한 메시지를 생성합니다. 여기서 JSON 형식은 논리 앱에서 정의한 JSON 형식과 일치하며, 필요에 따라 사용자 지정할 수도 있습니다.

   

3. 파이프라인 디자이너의 배경 영역을 선택하여 파이프라인 속성 페이지를 선택하고 수신자라는 새 매개 변수를 추가하여 이메일 주소를 기본값으로 제공합니다.

   이 예제에서는 임의로 정의한 파이프라인 매개 변수에서 수신자 이메일을 제공합니다. 수신자 값은 모든 식 또는 연결된 데이터 원본에서 가져올 수 있습니다.

   

4. 파이프라인을 게시한 다음, 수동으로 트리거하여 이메일이 예상대로 전송되는지 확인합니다.

   

시스템 변수 및 식을 사용하여 동적 메시지 추가

시스템 변수 및 식을 사용하여 메시지를 동적으로 만들 수 있습니다. 예:

• @activity("CopyData").output.errors[0].Message

• @activity("DataFlow").error.Message

위의 식은 복사 작업 실패에서 관련 오류 메시지를 반환합니다. 이 메시지는 이메일을 전송하는 웹 작업으로 리디렉션될 수 있습니다. 자세한 내용은 복사 작업 출력 속성 문서를 참조하세요.

관련 콘텐츠

파이프라인에서 Teams 알림을 보내는 방법