웹 서비스 태스크Web Service Task

웹 서비스 태스크는 웹 서비스 메서드를 실행합니다.The Web Service task executes a Web service method. 웹 서비스 태스크는 다음 용도로 사용할 수 있습니다.You can use the Web Service task for the following purposes:

  • 웹 서비스 메서드에서 반환되는 값을 변수에 기록합니다.Writing to a variable the values that a Web service method returns. 예를 들어 웹 서비스 메서드로부터 그 날의 최고 기온을 가져온 다음 이 값을 사용하여 열 값을 설정하는 식에 사용된 변수를 업데이트할 수 있습니다.For example, you could obtain the highest temperature of the day from a Web service method, and then use that value to update a variable that is used in an expression that sets a column value.

  • 웹 서비스 메서드에서 반환되는 값을 파일에 기록합니다.Writing to a file the values that a Web service method returns. 예를 들어 잠재 고객 목록을 파일에 기록하고 패키지에서 이 파일을 데이터 원본으로 사용하여 데이터베이스에 파일을 기록하기 전에 데이터를 정리할 수 있습니다.For example, a list of potential customers can be written to a file and the file then used as a data source in a package that cleans the data before it is written to a database.

WSDL 파일WSDL File

웹 서비스 태스크는 HTTP 연결 관리자를 사용하여 웹 서비스에 연결합니다.The Web Service task uses an HTTP connection manager to connect to the Web service. HTTP 연결 관리자는 웹 서비스 태스크와 별도로 구성되고 태스크에서 참조됩니다.The HTTP connection manager is configured separately from the Web Service task, and is referenced in the task. HTTP 연결 관리자는 서버 URL과 같은 서버 프록시 설정, 웹 서비스 서버 액세스를 위한 자격 증명 및 제한 시간 길이를 지정합니다.The HTTP connection manager specifies the server proxy settings such as the server URL, credentials for accessing the Web services server, and time-out length. 자세한 내용은 HTTP 연결 관리자를 참조하세요.For more information, see HTTP Connection Manager.

중요

HTTP 연결 관리자는 익명 인증과 기본 인증만 지원하며The HTTP connection manager supports only anonymous authentication and basic authentication. Windows 인증은 지원하지 않습니다.It does not support Windows Authentication.

HTTP 연결 관리자는 웹 사이트 또는 WSDL(Web Service Description Language) 파일로 연결할 수 있습니다.The HTTP connection manager can point to a Web site or to a Web Service Description Language (WSDL) file. WSDL 파일로 연결하는 HTTP 연결 관리자의 URL에는 ?WSDL 매개 변수가 포함됩니다(예: http://MyServer/MyWebService/MyPage.asmx?WSDL).The URL of the HTTP connection manager that points to a WSDL file includes the ?WSDL parameter: for example, http://MyServer/MyWebService/MyPage.asmx?WSDL.

디자이너에서 제공하는 웹 서비스 태스크 편집기 SSISSSIS 대화 상자를 사용하여 웹 서비스 태스크를 구성하려면 WSDL 파일을 로컬에서 사용할 수 있어야 합니다.The WSDL file must be available locally to configure the Web Service task using the Web Service Task Editor dialog box that SSISSSIS Designer provides.

  • HTTP 연결 관리자가 웹 사이트로 연결하는 경우 WSDL 파일을 로컬 컴퓨터로 수동으로 복사해야 합니다.If the HTTP connection manager points to a Web site, the WSDL file must be copied manually to a local computer.

  • HTTP 연결 관리자가 WSDL 파일로 연결하는 경우 웹 서비스 태스크에서 웹 사이트의 파일을 로컬 파일로 다운로드할 수 있습니다.If the HTTP connection manager points to a WSDL file, the file can be downloaded from the Web site to a local file by the Web Service task.

    WSDL 파일에는 웹 서비스에서 제공하는 메서드, 메서드에 필요한 입력 매개 변수, 메서드가 반환하는 응답 및 웹 서비스와 통신하는 방법이 나열되어 있습니다.The WSDL file lists the methods that the Web service offers, the input parameters that the methods require, the responses that the methods return, and how to communicate with the Web service.

    메서드에서 입력 매개 변수가 사용되는 경우 웹 서비스 태스크에는 매개 변수 값이 필요합니다.If the method uses input parameters, the Web Service task requires parameter values. 예를 들어 자신의 신장을 기준으로 구입할 스키의 길이를 보여 주는 웹 서비스 메서드에서는 입력 매개 변수로 자신의 신장을 제공해야 합니다.For example, a Web service method that recommends the length of skis you should purchase based on your height requires that your height be submitted in an input parameter. 매개 변수 값은 태스크 내에 정의된 문자열이나 태스크 또는 부모 컨테이너의 범위에 정의된 변수에서 제공할 수 있습니다.The parameter values can be provided either by strings that are defined in the task, or by variables defined in the scope of the task or a parent container. 변수를 사용할 경우에는 패키지 구성 또는 스크립트를 사용하여 매개 변수 값을 동적으로 업데이트할 수 있는 이점이 있습니다.The advantage of using variables is that they let you dynamically update the parameter values by using package configurations or scripts. 자세한 내용은 Integration Services(SSIS) 변수패키지 구성을 참조하세요.For more information, see Integration Services (SSIS) Variables and Package Configurations.

    여러 웹 서비스 메서드에서는 입력 매개 변수가 사용되지 않습니다.Many Web service methods do not use input parameters. 예를 들어 현재 달에 태어난 대통령의 이름을 가져오는 웹 서비스 메서드의 경우에는 웹 서비스가 로컬에서 현재 달을 논리적으로 확인할 수 있기 때문에 입력 매개 변수가 필요하지 않습니다.For example, a Web service method that gets the names of presidents who were born in the current month would not require an input parameter because the Web service can determine the current month locally.

    웹 서비스 메서드의 결과는 변수나 파일로 기록될 수 있습니다.The results of the Web service method can be written to a variable or to a file. 파일 연결 관리자를 사용하면 결과를 기록할 파일을 지정하거나 변수 이름을 제공할 수 있습니다.You use the File connection manager either to specify the file or to provide the name of the variable to write the results to. 자세한 내용은 파일 연결 관리자Integration Services(SSIS) 변수를 참조하세요.For more information, see File Connection Manager and Integration Services (SSIS) Variables.

웹 서비스 태스크에 사용할 수 있는 사용자 지정 로깅 메시지Custom Logging Messages Available on the Web Service Task

다음 표에서는 웹 서비스 태스크에 사용할 수 있는 사용자 지정 로그 항목을 보여 줍니다.The following table lists the custom log entries that you can enable for the Web Service task. 자세한 내용은 Integration Services(SSIS) 로깅을 참조하세요.For more information, see Integration Services (SSIS) Logging.

로그 항목Log entry DescriptionDescription
WSTaskBeginWSTaskBegin 태스크에서 웹 서비스 액세스를 시작했습니다.The task began to access a Web service.
WSTaskEndWSTaskEnd 태스크에서 웹 서비스 메서드를 완료했습니다.The task completed a Web service method.
WSTaskInfoWSTaskInfo 태스크에 대한 설명 정보입니다.Descriptive information about the task.

웹 서비스 태스크 구성Configuration of the Web Service Task

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

SSISSSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하십시오.For more information about the properties that you can set in SSISSSIS Designer, click one of the following topics:

프로그래밍 방식으로 웹 서비스 태스크 구성Programmatic Configuration of the Web Service Task

이러한 속성을 프로그래밍 방식으로 설정하는 방법을 보려면 다음 항목 중 하나를 클릭하십시오.For more information about programmatically setting these properties, click one of the following topics:

technet.microsoft.com의 비디오, How to: Call a Web Service by Using the Web Service Task (SQL Server Video)(방법: 웹 서비스 태스크를 사용하여 웹 서비스 호출(SQL Server 비디오))Video, How to: Call a Web Service by Using the Web Service Task (SQL Server Video), on technet.microsoft.com.