SSIS(Integration Services) 매개 변수를 사용하면 패키지 실행 시 패키지 내의 속성에 값을 할당할 수 있습니다. 프로젝트 수준에서 프로젝트 매개 변수를 만들고 패키지 수준에서 패키지 매개 변수를 만들 수 있습니다. 프로젝트 매개 변수는 프로젝트 내의 하나 이상의 패키지에 외부 입력을 공급하는 데 사용됩니다. 패키지 매개 변수를 사용하면 패키지를 편집하고 다시 배포하지 않고도 패키지 실행을 수정할 수 있습니다.
SQL Server Data Tools에서 Project.params 창을 사용하여 프로젝트 매개 변수를 만들거나 수정하거나 삭제합니다. SSIS 디자이너의 매개 변수 탭을 사용하여 패키지 매개 변수 를 만들고 수정하고 삭제합니다. 매개 변수화 대화 상자를 사용하여 새 매개 변수 또는 기존 매개 변수를 작업 속성과 연결합니다. Project.params 창 및 매개 변수 탭을 사용하는 방법에 대한 자세한 내용은 매개 변수 만들기를 참조하세요. 매개 변수화 대화 상자에 대한 자세한 내용은 매개 변수화 대화 상자를 참조하세요.
매개 변수 및 패키지 배포 모델
일반적으로 패키지 배포 모델을 사용하여 패키지를 배포하는 경우 매개 변수 대신 구성을 사용해야 합니다.
패키지 배포 모델을 사용하여 매개 변수가 포함된 패키지를 배포한 다음 패키지를 실행하는 경우 실행 중에 매개 변수가 호출되지 않습니다. 패키지에 패키지 매개 변수가 포함되어 있고 패키지 내의 식이 매개 변수를 사용하는 경우 결과 값은 런타임에 적용됩니다. 패키지에 프로젝트 매개 변수가 포함된 경우 패키지 실행이 실패할 수 있습니다.
매개 변수 및 프로젝트 배포 모델
Integration Services 서버에 프로젝트를 배포하는 경우 뷰, 저장 프로시저 및 SQL Server Management Studio UI를 사용하여 프로젝트 및 패키지 매개 변수를 관리합니다. 자세한 내용은 다음 항목을 참조하세요.
매개 변수 값
매개 변수에 최대 세 가지 형식의 값을 할당할 수 있습니다. 패키지 실행이 시작되면 매개 변수에 단일 값이 사용되고 매개 변수가 최종 리터럴 값으로 확인됩니다.
다음 표에서는 값 형식을 나열합니다.
| 값 이름 | 설명 | 값 형식 |
|---|---|---|
| 실행 값 | 패키지 실행의 특정 인스턴스에 할당된 값입니다. 이 할당은 다른 모든 값을 재정의하지만 패키지 실행의 단일 인스턴스에만 적용됩니다. | 리터럴 |
| 서버 값 | 프로젝트가 Integration Services 서버에 배포된 후 프로젝트의 범위 내에서 매개 변수에 할당된 값입니다. 이 값은 디자인 기본값을 재정의합니다. | 리터럴 또는 환경 변수 참조 |
| 디자인 기준값 | SQL Server Data Tools에서 프로젝트를 만들거나 편집할 때 매개 변수에 할당된 값입니다. 이 값은 프로젝트와 함께 유지됩니다. | 리터럴 |
단일 매개 변수를 사용하여 여러 패키지 속성에 값을 할당할 수 있습니다. 단일 패키지 속성은 단일 매개 변수에서만 값을 할당할 수 있습니다.
실행 및 매개 변수 값
실행 객체는 패키지를 실행하는 단일 인스턴스를 나타냅니다. 실행을 만들 때 실행 매개 변수 값과 같은 패키지를 실행하는 데 필요한 모든 세부 정보를 지정합니다. 기존 실행에 대한 매개 변수 값을 수정할 수도 있습니다.
실행 매개 변수 값을 명시적으로 설정하는 경우 해당 값은 특정 실행 인스턴스에만 적용됩니다. 실행 값은 서버 값이나 디자인 값 대신 사용됩니다. 실행 값을 명시적으로 설정하지 않고 서버 값을 지정한 경우 서버 값이 사용됩니다.
매개 변수가 필수로 표시되면 해당 매개 변수에 대해 서버 값 또는 실행 값을 지정해야 합니다. 그렇지 않으면 해당 패키지가 실행되지 않습니다. 디자인 타임에 매개 변수에 기본값이 있지만 프로젝트가 배포된 후에는 사용되지 않습니다.
환경 변수
매개 변수가 환경 변수를 참조하는 경우 해당 변수의 리터럴 값은 지정된 환경 참조를 통해 확인되고 매개 변수에 적용됩니다. 패키지 실행에 사용되는 최종 리터럴 매개 변수 값을 실행 매개 변수 값이라고 합니다. 실행 대화 상자를 사용하여 실행에 대한 환경 참조를 지정합니다.
프로젝트 매개 변수가 환경 변수를 참조하고 실행 시 변수의 리터럴 값을 확인할 수 없는 경우 디자인 값이 사용됩니다. 서버 값이 사용되지 않습니다.
매개 변수 값에 할당된 환경 변수를 보려면 catalog.object_parameters 뷰를 쿼리합니다. 자세한 내용은 catalog.object_parameters(SSISDB 데이터베이스)를 참조하세요.
실행 매개 변수 값 결정
다음 Transact-SQL 보기 및 저장 프로시저를 사용하여 매개 변수 값을 표시하고 설정할 수 있습니다.
catalog.execution_parameter_values (SSISDB 데이터베이스) (보기)
특정 실행에서 사용할 실제 매개 변수 값을 표시합니다.
catalog.get_parameter_values(SSISDB 데이터베이스) (저장 프로시저)
지정된 패키지 및 환경 참조의 실제 값을 확인하고 표시합니다.
catalog.object_parameters(SSISDB 데이터베이스) (보기)
디자인 기본값 및 서버 기본값을 포함하여 Integration Services 카탈로그의 모든 패키지 및 프로젝트에 대한 매개 변수 및 속성을 표시합니다.
catalog.set_execution_parameter_value (SSISDB 데이터베이스)
Integration Services 카탈로그의 실행 인스턴스에 대한 매개 변수 값을 설정합니다.
SSDT(SQL Server Data Tools)에서 패키지 실행 대화 상자를 사용하여 매개 변수 값을 수정할 수도 있습니다. 자세한 내용은 패키지 실행 대화 상자를 참조하세요.
dtexec /Parameter 옵션을 사용하여 매개 변수 값을 수정할 수도 있습니다. 자세한 내용은 dtexec Utility를 참조하세요.
매개 변수 유효성 검사
매개 변수 값을 확인할 수 없는 경우 해당 패키지 실행이 실패합니다. 오류를 방지하려면 SSDT(SQL Server Data Tools)의 유효성 검사 대화 상자를 사용하여 프로젝트 및 패키지의 유효성을 검사 할 수 있습니다. 유효성 검사를 사용하면 모든 매개 변수에 필요한 값이 있는지 확인하거나 특정 환경 참조를 사용하여 필요한 값을 확인할 수 있습니다. 유효성 검사에서는 다른 일반적인 패키지 문제도 확인합니다.
자세한 내용은 유효성 검사 대화 상자를 참조하세요.
매개 변수 예제
이 예제에서는 패키지가 있는 패키지에 대한 옵션을 지정하는 데 사용되는 pkgOptions 라는 매개 변수를 설명합니다.
디자인 타임 동안 SQL Server Data Tools에서 매개 변수를 만들 때 기본값 1이 매개 변수에 할당되었습니다. 이 기본값을 디자인 기본값이라고 합니다. 프로젝트가 SSISDB 카탈로그에 배포되었고 다른 값이 이 매개 변수에 할당되지 않은 경우 패키지 실행 중에 pkgOptions 매개 변수에 해당하는 패키지 속성에 1 값이 할당됩니다. 디자인 기본값은 수명 주기 내내 프로젝트와 함께 유지됩니다.
패키지 실행의 특정 인스턴스를 준비하는 동안 pkgOptions 매개 변수에 값 5가 할당됩니다. 이 값은 해당 특정 실행 인스턴스에 대해서만 매개 변수에 적용되므로 실행 값이라고 합니다. 실행이 시작되면 pkgOptions 매개 변수에 해당하는 패키지 속성에 값 5가 할당됩니다.
관련 작업
관련 내용
블로그 항목, SSIS 빠른 팁: 필수 매개 변수, mattmasson.com.