웹 서비스 태스크

  • 아티클

적용 대상: Azure Data Factory SSIS Integration Runtime SQL Server

웹 서비스 태스크는 웹 서비스 메서드를 실행합니다. 웹 서비스 태스크는 다음 용도로 사용할 수 있습니다.

  • 웹 서비스 메서드에서 반환되는 값을 변수에 기록합니다. 예를 들어 웹 서비스 메서드로부터 그 날의 최고 기온을 가져온 다음 이 값을 사용하여 열 값을 설정하는 식에 사용된 변수를 업데이트할 수 있습니다.

  • 웹 서비스 메서드에서 반환되는 값을 파일에 기록합니다. 예를 들어 잠재 고객 목록을 파일에 기록하고 패키지에서 이 파일을 데이터 원본으로 사용하여 데이터베이스에 파일을 기록하기 전에 데이터를 정리할 수 있습니다.

WSDL 파일

웹 서비스 태스크는 HTTP 연결 관리자를 사용하여 웹 서비스에 연결합니다. HTTP 연결 관리자는 웹 서비스 태스크와 별도로 구성되고 태스크에서 참조됩니다. HTTP 연결 관리자는 서버 URL과 같은 서버 프록시 설정, 웹 서비스 서버 액세스를 위한 자격 증명 및 제한 시간 길이를 지정합니다. 자세한 내용은 HTTP 연결 관리자를 참조하세요.

중요

HTTP 연결 관리자는 익명 인증과 기본 인증만 지원하며 Windows 인증은 지원하지 않습니다.

HTTP 연결 관리자는 웹 사이트 또는 WSDL(Web Service Description Language) 파일로 연결할 수 있습니다. WSDL 파일로 연결하는 HTTP 연결 관리자의 URL에는 ?WSDL 매개 변수가 포함됩니다(예: https://MyServer/MyWebService/MyPage.asmx?WSDL).

디자이너에서 제공하는 웹 서비스 태스크 편집기 SSIS 대화 상자를 사용하여 웹 서비스 태스크를 구성하려면 WSDL 파일을 로컬에서 사용할 수 있어야 합니다.

  • HTTP 연결 관리자가 웹 사이트로 연결하는 경우 WSDL 파일을 로컬 컴퓨터로 수동으로 복사해야 합니다.

  • HTTP 연결 관리자가 WSDL 파일로 연결하는 경우 웹 서비스 태스크에서 웹 사이트의 파일을 로컬 파일로 다운로드할 수 있습니다.

WSDL 파일에는 웹 서비스에서 제공하는 메서드, 메서드에 필요한 입력 매개 변수, 메서드가 반환하는 응답 및 웹 서비스와 통신하는 방법이 나열되어 있습니다.

메서드에서 입력 매개 변수가 사용되는 경우 웹 서비스 태스크에는 매개 변수 값이 필요합니다. 예를 들어 자신의 신장을 기준으로 구입할 스키의 길이를 보여 주는 웹 서비스 메서드에서는 입력 매개 변수로 자신의 신장을 제공해야 합니다. 매개 변수 값은 태스크 내에 정의된 문자열이나 태스크 또는 부모 컨테이너의 범위에 정의된 변수에서 제공할 수 있습니다. 변수를 사용할 경우에는 패키지 구성 또는 스크립트를 사용하여 매개 변수 값을 동적으로 업데이트할 수 있는 이점이 있습니다. 자세한 내용은 Integration Services(SSIS) 변수 및 패키지 구성을 참조하세요.

여러 웹 서비스 메서드에서는 입력 매개 변수가 사용되지 않습니다. 예를 들어 현재 달에 태어난 대통령의 이름을 가져오는 웹 서비스 메서드의 경우에는 웹 서비스가 로컬에서 현재 달을 논리적으로 확인할 수 있기 때문에 입력 매개 변수가 필요하지 않습니다.

웹 서비스 메서드의 결과는 변수나 파일로 기록될 수 있습니다. 파일 연결 관리자를 사용하면 결과를 기록할 파일을 지정하거나 변수 이름을 제공할 수 있습니다. 자세한 내용은 파일 연결 관리자 및 Integration Services(SSIS) 변수를 참조하세요.

웹 서비스 태스크에 사용할 수 있는 사용자 지정 로깅 메시지

다음 표에서는 웹 서비스 태스크에 사용할 수 있는 사용자 지정 로그 항목을 보여 줍니다. 자세한 내용은 SSIS(Integration Services) 로깅을 참조하세요.

로그 항목 Description
WSTaskBegin 태스크에서 웹 서비스 액세스를 시작했습니다.
WSTaskEnd 태스크에서 웹 서비스 메서드를 완료했습니다.
WSTaskInfo 태스크에 대한 설명 정보입니다.

웹 서비스 태스크 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

SSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목을 클릭하십시오.

SSIS 디자이너에서 이러한 속성을 설정하는 방법을 보려면 다음 항목을 클릭하십시오.

프로그래밍 방식으로 웹 서비스 태스크 구성

이러한 속성을 프로그래밍 방식으로 설정하는 방법을 보려면 다음 항목 중 하나를 클릭하십시오.

웹 서비스 태스크 편집기(일반 페이지)

웹 서비스 태스크 편집기 대화 상자의 일반 페이지를 사용하여 HTTP 연결 관리자를 지정하고, 웹 서비스 태스크에 사용하는 WSDL(웹 서비스 기술 언어) 파일의 위치를 지정하고, 웹 서비스 태스크를 설명하고, WSDL 파일을 다운로드할 수 있습니다.

옵션

HTTPConnection
목록에서 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 새 연결 관리자를 만듭니다.

중요

HTTP 연결 관리자는 익명 인증과 기본 인증만 지원하며 Windows 인증은 지원하지 않습니다.

관련 항목:HTTP 연결 관리자, HTTP 연결 관리자 편집기(서버 페이지)

WSDLFile
컴퓨터에 로컬인 WSDL 파일의 정규화된 경로를 입력하거나 찾아보기 단추 (...) 를 클릭하여 이 파일을 찾습니다.

WSDL 파일을 컴퓨터에 이미 수동으로 다운로드한 경우에는 이 파일을 선택하고, WSDL 파일을 아직 다운로드하지 않은 경우에는 다음 단계를 수행합니다.

  • 파일 이름 확장명이 ".wsdl"인 빈 파일을 만듭니다.

  • WSDLFile 옵션으로 이 빈 파일을 선택합니다.

  • OverwriteWSDLFile 값을 True 로 설정하여 이 빈 파일을 실제 WSDL 파일로 덮어쓸 수 있도록 합니다.

  • WSDL 다운로드 를 클릭하여 실제 WSDL 파일을 다운로드하고 빈 파일을 덮어씁니다.

    참고

    WSDL 다운로드 옵션은 WSDLFile 상자에 기존 로컬 파일의 이름을 입력할 때까지 사용할 수 없습니다.

OverwriteWSDLFile
웹 서비스 태스크에 대한 WSDL 파일을 덮어쓸지 여부를 나타냅니다.

WSDL 다운로드 단추를 사용하여 WSDL 파일을 다운로드하려면 이 값을 True로 설정합니다.

이름
웹 서비스 태스크에 사용할 고유 이름을 제공합니다. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.

설명
웹 서비스 태스크에 대한 설명을 입력합니다.

WSDL 다운로드
WSDL 파일을 다운로드합니다.

이 단추는 WSDLFile 상자에 기존 로컬 파일의 이름을 입력할 때까지 사용할 수 없습니다.

웹 서비스 태스크 편집기(입력 페이지)

웹 서비스 태스크 편집기 대화 상자의 입력 페이지를 사용하여 웹 서비스, 웹 메서드 및 웹 메서드에 입력으로 제공할 값을 지정할 수 있습니다. 문자열을 값 열에 직접 입력하거나 값 열에서 변수를 선택하여 값을 지정할 수 있습니다.

옵션

서비스
목록에서 웹 메서드를 실행하는 데 사용할 웹 서비스를 선택합니다.

메서드
목록에서 실행할 태스크에 사용할 웹 메서드를 선택합니다.

WebMethodDocumentation
웹 방식에 대한 설명을 입력하거나 찾아보기 단추 (...) 를 클릭하여 웹 메서드 설명서 대화 상자에 설명을 입력합니다.

이름
웹 메서드에 대한 입력의 이름을 나열합니다.

형식
입력의 데이터 형식을 나열합니다.

참고

웹 서비스 태스크는 정수 및 문자열과 같은 기본 형식, 기본 형식의 배열 및 시퀀스, 열거 등과 같은 데이터 형식의 매개 변수만 지원합니다.

변수
확인란을 선택하여 입력을 제공하기 위한 변수를 사용합니다.

값
Variable 확인란이 선택된 경우 목록에서 변수를 선택하여 입력을 제공하고 선택되지 않은 경우 입력에 사용할 값을 입력합니다.

웹 서비스 태스크 편집기(출력 페이지)

웹 서비스 태스크 편집기 대화 상자의 출력 페이지를 사용하여 웹 메서드에서 반환하는 결과를 저장할 위치를 지정할 수 있습니다.

정적 옵션

OutputType
결과를 저장할 때 사용할 스토리지 유형을 선택합니다. 이 속성의 옵션은 다음 표에 나열되어 있습니다.

값 Description
파일 연결 결과를 파일에 저장합니다. 이 값을 선택하면 동적 옵션 File이 표시됩니다.
변수 결과를 변수에 저장합니다. 이 값을 선택하면 동적 옵션 Variable이 표시됩니다.

OutputType 동적 옵션

OutputType = 파일 연결

최근에 사용한 파일
목록에서 파일 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 새 연결 관리자를 만듭니다.

관련 항목:File Connection Manager, File Connection Manager Editor

OutputType = 변수

변수
목록에서 변수를 선택하거나 <새 변수...>를 클릭하여 새 변수를 만듭니다.

관련 항목: Integration Services(SSIS) 변수, 변수 추가

관련 내용

MSDN Library의 비디오 - 방법: 웹 서비스 태스크를 사용하여 웹 서비스 호출(SQL Server 비디오)을 참조하세요.