다음을 통해 공유

워크플로에서 외부 API 사용

  • 아티클

참고

Microsoft Purview 데이터 카탈로그(클래식) 및 Data Health Insights(클래식)는 더 이상 새 고객을 이용하지 않으며 이러한 서비스(이전의 Azure Purview)는 이제 고객 지원 모드에 있습니다.

중요

이 기능은 현재 미리 보기로 제공됩니다. Microsoft Azure Preview에 대한 추가 사용 약관에는 베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 추가 법적 조건이 포함됩니다.

워크플로를 사용하여 Microsoft Purview를 통해 일부 비즈니스 프로세스를 자동화할 수 있으며 HTTP 커넥터 및 JSON 구문 분석 작업을 통해 워크플로를 외부 애플리케이션과 통합할 수 있습니다.

HTTP 커넥터

HTTP 커넥터는 REST(Representational State Transfer) 아키텍처를 사용하여 Microsoft Purview 워크플로가 웹 요청을 사용하여 비 Microsoft 애플리케이션과 직접 상호 작용할 수 있도록 합니다.

HTTP 커넥터는 모든 워크플로 템플릿에서 사용할 수 있습니다.

참고

워크플로를 만들거나 편집하려면 Microsoft Purview에서 워크플로 관리자 역할이 필요합니다. 컬렉션의 워크플로 관리자에게 문의하거나 컬렉션 관리자에게 권한을 문의할 수도 있습니다.

  1. HTTP 커넥터를 추가하려면 추가할 템플릿의 아이콘을 선택하고 + HTTP 커넥터를 선택합니다.

    HTTP 커넥터를 추가하는 방법의 스크린샷

  2. HTTP 커넥터를 선택하면 다음 매개 변수를 채웁니다.

    1. 호스트 - 이 커넥터가 실행될 때 호출하려는 요청 URL입니다.
    2. 메서드 - 다음 메서드 중 하나를 선택합니다. GET, PUT, PATCH, POST 및 DELETE. 이러한 메서드는 만들기, 읽기, 업데이트 및 삭제 작업에 해당합니다.
    3. 경로 - 필요에 따라 요청 URL 경로를 입력할 수 있습니다. 이 매개 변수에 동적 콘텐츠를 사용할 수 있습니다.
    4. 헤더 - 필요에 따라 HTTP 헤더를 입력할 수 있습니다. HTTP 헤더를 사용하면 클라이언트와 서버가 HTTP 요청 또는 응답을 사용하여 추가 정보를 전달할 수 있습니다.
    5. 쿼리 - 필요에 따라 쿼리를 전달할 수 있습니다.
    6. 본문 - 필요에 따라 URL을 호출하는 동안 HTTP 본문을 전달할 수 있습니다.
    7. 인증 - HTTP 커넥터는 Microsoft Purview 자격 증명과 통합됩니다. URL에 따라 다음 세 가지 유형 중 하나를 호출할 수 있습니다.
      1. 없음 (인증 없음)
      2. 기본 인증 - 이미 만든 기본 인증 자격 증명을 사용합니다.
      3. 서비스 주체 - 이미 만든 서비스 주체 자격 증명 및 대상 그룹을 사용합니다. 대상 그룹은 액세스 토큰의 의도된 소비자입니다. 예를 들어 Microsoft Purview 대상 그룹: https://purview.azure.net/.default 서비스 주체가 ARM과 같은 해당 서비스를 호출할 권한이 있는지 확인합니다.

    HTTP 커넥터 속성을 추가하는 방법의 스크린샷

  3. 기본적으로 HTTP 커넥터에 대한 보안 설정이 설정됩니다. 보안 입력 및 출력을 끄려면 줄임표 아이콘(...)을 선택하여 설정으로 이동합니다.

    HTTP 커넥터 설정을 추가하는 방법의 스크린샷

  4. 이제 HTTP 커넥터에 대한 설정이 표시되고 보안 입력 및 출력을 OFF로 전환할 수 있습니다.

    HTTP 커넥터 보안 입력 및 출력을 추가하는 방법의 스크린샷

JSON 구문 분석 작업

워크플로의 JSON 구문 분석 작업을 사용하면 HTTP(또는 다른 작업/커넥터)에서 들어오는 JSON을 가져와서 JSON을 구문 분석하여 워크플로에서 사용할 값을 추출할 수 있습니다.

구문 분석 JSON 작업은 모든 워크플로에서 사용할 수 있습니다.

샘플 데이터로 채워진 매개 변수를 보여 주는 워크플로 구문 분석 JSON 작업의 스크린샷

JSON 구문 분석 작업에는 두 개의 매개 변수가 있습니다.

  • 콘텐츠 - 구문 분석하려는 JSON을 포함해야 하는 변수입니다.
  • 스키마 - 들어오는 JSON의 스키마로, 워크플로에서 들어오는 정보를 구문 분석할 수 있습니다. 직접 제공하거나 샘플에서 생성 단추를 사용할 수 있습니다. 샘플에서 생성하는 경우 샘플 JSON 페이로드를 입력하고 스키마가 자동으로 생성됩니다.

JSON 구문 분석 작업 후 워크플로의 작업 및 커넥터는 모든 매개 변수에 대해 동적 콘텐츠 추가 를 선택하여 JSON에서 추출된 값을 사용할 수 있습니다.

JSON 구문 분석 작업의 값이 추가된 다른 커넥터의 스크린샷

다음 단계

워크플로에 대한 자세한 내용은 다음 문서를 참조하세요.