웹 서비스 태스크

아티클
07/12/2024

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

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

웹 서비스 메서드가 반환하는 값을 변수에 기록합니다. 예를 들어 웹 서비스 메서드에서 하루 중 가장 높은 온도를 가져온 다음 해당 값을 사용하여 열 값을 설정하는 식에 사용되는 변수를 업데이트할 수 있습니다.
웹 서비스 메서드가 반환하는 값을 파일에 기록합니다. 예를 들어 잠재 고객 목록을 파일에 쓸 수 있으며, 이 파일은 데이터베이스에 기록되기 전에 데이터를 정리하는 패키지의 데이터 원본으로 사용할 수 있습니다.

WSDL 파일

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

Important

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

HTTP 연결 관리자는 웹 사이트 또는 WSDL(웹 서비스 설명 언어) 파일을 가리킬 수 있습니다. 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) 로깅을 참조하세요.

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

웹 서비스 작업 구성

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

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

식 페이지

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

태스크 또는 컨테이너의 속성 설정

웹 서비스 작업의 프로그래밍 방식 구성

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

WebServiceTask

웹 서비스 작업 편집기(일반 페이지)

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

옵션

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

Important

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

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

WSDL 파일을 컴퓨터에 수동으로 다운로드한 경우 이 파일을 선택합니다. 그러나 WSDL 파일이 아직 다운로드되지 않은 경우 다음 단계를 수행합니다.

".wsdl" 파일 이름 확장명을 포함하는 빈 파일을 만듭니다.
WSDLFile 옵션으로 이 빈 파일을 선택합니다.
빈 파일을 실제 WSDL 파일로 덮어쓸 수 있도록 OverwriteWSDLFile의 값을 True로 설정합니다.
WSDL 다운로드를 클릭하여 실제 WSDL 파일을 다운로드하고 빈 파일을 덮어씁니다.

참고 항목

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

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

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

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

참고

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

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

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

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

웹 서비스 작업 편집기(입력 페이지)

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

옵션

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

방법
실행할 작업의 목록에서 웹 메서드를 선택합니다.

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

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

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

참고 항목

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

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

값
변수 확인란을 선택한 경우 목록에서 변수를 선택하여 입력을 제공합니다. 그렇지 않으면 입력에 사용할 값을 입력합니다.