스크립트 태스크에서 변수 사용

  • 아티클

스크립트 태스크에서는 변수를 통해 패키지의 다른 개체와 데이터를 교환할 수 있습니다. 자세한 내용은 Integration Services(SSIS) 변수를 참조하십시오.

스크립트 태스크에서는 Dts 개체의 Variables 속성을 사용하여 패키지의 Variable 개체를 읽고 씁니다.

[!참고]

Variable 클래스의 Value 속성은 Object 형식을 사용합니다. 스크립트 태스크에는 Option Strict가 설정되어 있으므로 스크립트 태스크를 사용하려면 먼저 Value 속성을 적절한 형식으로 캐스팅해야 합니다.

스크립트 태스크 편집기의 ReadOnlyVariables 및 ReadWriteVariables 목록에 기존 변수를 추가하여 사용자 지정 스크립트에서 해당 변수를 사용할 수 있게 할 수 있습니다. 변수 이름은 대/소문자를 구분합니다. 스크립트 내에서는 Dts 개체의 Variables 속성을 통해 두 유형의 변수에 액세스합니다. 개별 변수를 읽고 쓰는 데는 Value 속성을 사용합니다. 스크립트 태스크에서는 스크립트가 변수 값을 읽고 수정할 때 잠금을 투명하게 관리합니다.

Variables 속성에서 반환된 Variables 컬렉션의 Contains 메서드를 사용하여 코드에서 변수를 사용하기 전에 해당 변수가 있는지 여부를 확인할 수 있습니다.

VariableDispenser 속성(Dts.VariableDispenser)을 사용하여 스크립트 태스크에서 변수를 사용할 수도 있습니다. VariableDispenser를 사용하는 경우 개발자가 자신의 고유 코드에서 잠금 의미 체계와 변수 값에 대한 데이터 형식 캐스팅을 모두 처리해야 합니다. 디자인 타임에는 사용할 수 없지만 런타임에 프로그래밍 방식으로 만들어지는 변수를 사용하려면 Variables 속성 대신 VariableDispenser 속성을 사용해야 합니다.

Foreach 루프 컨테이너 내에서 스크립트 태스크 사용

스크립트 태스크가 Foreach 루프 컨테이너 내에서 반복적으로 실행되는 경우 스크립트는 일반적으로 열거자에서 현재 항목의 내용을 사용해야 합니다. 예를 들어 Foreach File 열거자를 사용하는 경우에는 스크립트에서 현재 파일 이름을 알고 있어야 하며, Foreach ADO 열거자를 사용하는 경우에는 스크립트에서 현재 데이터 행의 열 내용을 알고 있어야 합니다.

변수는 Foreach 루프 컨테이너와 스크립트 태스크 간의 이 통신을 가능하게 해 줍니다. Foreach 루프 편집기의 변수 매핑 페이지에서는 열거된 단일 항목에서 반환된 각 데이터 항목에 변수를 할당합니다. 예를 들어 Foreach File 열거자는 인덱스 0 위치의 파일 이름만 반환하므로 변수 매핑이 하나만 필요한 반면, 각 행의 여러 데이터 열을 반환하는 열거자의 경우에는 스크립트 태스크에서 사용할 각 열에 서로 다른 변수를 매핑해야 합니다.

열거된 항목을 변수에 매핑한 후에는 스크립트 태스크 편집기의 스크립트 페이지에서 매핑된 변수를 ReadOnlyVariables 속성에 추가하여 스크립트에서 사용할 수 있게 해야 합니다. 폴더의 이미지 파일을 처리하는 Foreach 루프 컨테이너 내에서의 스크립트 태스크 예는 스크립트 태스크를 사용한 이미지 작업을 참조하십시오.

변수 예

다음 예에서는 스크립트 태스크에서 변수에 액세스하고 이를 사용하여 패키지 워크플로의 경로를 확인하는 방법을 보여 줍니다. 이 예제에서는 CustomerCount와 MaxRecordCount라는 정수 변수를 만들고 스크립트 태스크 편집기에서 해당 변수를 ReadOnlyVariables 컬렉션에 추가했다고 가정합니다. CustomerCount 변수에는 가져올 고객 레코드 수가 들어 있습니다. 이 값이 MaxRecordCount 값보다 크면 스크립트 태스크에서 실패가 보고됩니다. MaxRecordCount 임계값 초과로 인해 실패할 경우 워크플로의 오류 경로에서 필요한 정리 작업을 구현할 수 있습니다.

이 예제를 컴파일하려면 Microsoft.SqlServer.ScriptTask 어셈블리에 대한 참조를 추가해야 합니다.

Public Sub Main()

    Dim customerCount As Integer
    Dim maxRecordCount As Integer

    If Dts.Variables.Contains("CustomerCount") = True AndAlso _
        Dts.Variables.Contains("MaxRecordCount") = True Then

        customerCount = _
            CType(Dts.Variables("CustomerCount").Value, Integer)
        maxRecordCount = _
            CType(Dts.Variables("MaxRecordCount").Value, Integer)

    End If

    If customerCount > maxRecordCount Then
            Dts.TaskResult = ScriptResults.Failure
    Else
            Dts.TaskResult = ScriptResults.Success
    End If

End Sub

using System;
using System.Data;
using Microsoft.SqlServer.Dts.Runtime;

public class ScriptMain
{



    public void Main()
    {
        int customerCount;
        int maxRecordCount;

        if (Dts.Variables.Contains("CustomerCount")==true&&Dts.Variables.Contains("MaxRecordCount")==true)

        {
            customerCount = (int) Dts.Variables["CustomerCount"].Value;
            maxRecordCount = (int) Dts.Variables["MaxRecordCount"].Value;

        }

        if (customerCount>maxRecordCount)
        {
            Dts.TaskResult = (int)ScriptResults.Failure;
        }
        else
        {
            Dts.TaskResult = (int)ScriptResults.Success;
        }

    }

}
Integration Services 아이콘(작은 아이콘) Integration Services 관련 최신 정보 얻기

Microsoft의 최신 다운로드, 아티클, 예제 및 비디오와 커뮤니티의 정선된 솔루션을 보려면 MSDN의 Integration Services 페이지를 방문하십시오.


이러한 업데이트에 대한 자동 알림을 받으려면 해당 페이지에서 제공하는 RSS 피드를 구독하십시오.

참고 항목

태스크

패키지에서 변수 사용

개념

Integration Services(SSIS) 변수