웹 서비스 태스크
적용 대상: 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 비디오)을 참조하세요.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기