Integration Services (SSIS) 패키지 및 프로젝트 매개 변수Integration Services (SSIS) Package and Project Parameters

SSIS( Integration ServicesIntegration Services 매개 변수를 사용하여 패키지 실행 시 패키지 내의 속성에 값을 할당할 수 있습니다. Integration ServicesIntegration Services (SSIS) parameters allow you to assign values to properties within packages at the time of package execution. 프로젝트 수준에서 프로젝트 매개 변수 를 만들고 패키지 수준에서 패키지 매개 변수 를 만들 수 있습니다.You can create project parameters at the project level and package parameters at the package level. 프로젝트 매개 변수는 프로젝트가 수신하는 외부 입력을 프로젝트 내 하나 이상의 패키지에 제공하기 위해 사용됩니다.Project parameters are used to supply any external input the project receives to one or more packages in the project. 패키지 매개 변수를 사용하면 패키지를 편집하여 다시 배포할 필요 없이 패키지 실행을 수정할 수 있습니다.Package parameters allow you to modify package execution without having to edit and redeploy the package.

SQL Server Data ToolsSQL Server Data Tools 에서 Project.params 창을 사용하여 프로젝트 매개 변수를 만들거나, 수정하거나, 삭제합니다.In SQL Server Data ToolsSQL Server Data Tools you create, modify, or delete project parameters by using the Project.params window. **** 디자이너의 매개 변수 SSISSSIS 탭을 사용하여 패키지 매개 변수를 만들고, 수정하고, 삭제합니다.You create, modify, and delete package parameters by using the Parameters tab in the SSISSSIS Designer. 매개 변수화 대화 상자를 사용하여 새 매개 변수나 기존 매개 변수를 태스크 속성과 연결합니다.You associate a new or an existing parameter with a task property by using the Parameterize dialog box. Project.params 창 및 매개 변수 탭을 사용하는 방법은 Create Parameters를 참조하십시오.For more about using the Project.params window and the Parameters tab, see Create Parameters. 매개 변수화 대화 상자에 대한 자세한 내용은 Parameterize Dialog Box를 참조하십시오.For more information about the Parameterize dialog box, see Parameterize Dialog Box.

매개 변수 및 패키지 배포 모델Parameters and Package Deployment Model

일반적으로 패키지 배포 모델을 사용하여 패키지를 배포하려면 매개 변수 대신 구성을 사용해야 합니다.In general, if you are deploying a package using the package deployment model, you should use configurations instead of parameters.

패키지 배포 모델을 사용하여 매개 변수가 포함된 패키지를 배포한 다음 패키지를 실행할 경우 실행 중에는 매개 변수가 호출되지 않습니다.When you deploy a package that contains parameters using the package deployment model and then execute the package, the parameters are not called during execution. 패키지에 패키지 매개 변수가 포함되고 있고 패키지 내의 식에 매개 변수가 사용되는 경우 결과 값은 런타임에 적용됩니다.If the package contains package parameters and expressions within the package use the parameters, the resulting values are applied at runtime. 패키지에 프로젝트 매개 변수가 포함되어 있는 경우 패키지 실행이 실패할 수 있습니다.If the package contains project parameters, the package execution may fail.

매개 변수 및 프로젝트 배포 모델Parameters and Project Deployment Model

Integration Services(SSIS) 서버에 프로젝트를 배포하는 경우 뷰, 저장 프로시저 및 SQL Server Management StudioSQL Server Management Studio UI를 사용하여 프로젝트 및 패키지 매개 변수를 관리합니다.When you deploy a project to the Integration Services (SSIS) server, you use views, stored procedures, and the SQL Server Management StudioSQL Server Management Studio UI to manage project and package parameters. 자세한 내용은 다음 항목을 참조하십시오.For more information, see the following topics.

매개 변수 값Parameter Values

매개 변수에는 최대 세 가지 서로 다른 유형의 값을 지정할 수 있습니다.You can assign up to three different types of values to a parameter. 패키지 실행이 시작되면 매개 변수에 대해 단일 값이 사용되고 매개 변수가 해당 최종 리터럴 값으로 확인됩니다.When a package execution is started, a single value is used for the parameter, and the parameter is resolved to its final literal value.

다음 표에서는 값 유형을 나열합니다.The following table lists the types of values.

값 이름Value Name 설명Description 값 유형Type of value
실행 값Execution Value 특정 패키지 실행 인스턴스에 할당되는 값입니다.The value that is assigned to a specific instance of package execution. 이 할당은 다른 모든 값을 재정의하지만 단일 패키지 실행 인스턴스에만 적용됩니다.This assignment overrides all other values, but applies to only a single instance of package execution. 리터럴Literal
서버 값Server Value 프로젝트를 Integration Services 서버에 배포한 후 프로젝트 범위 내에서 매개 변수에 지정된 값입니다.The value assigned to the parameter within the scope of the project, after the project is deployed to the Integration Services server. 이 값은 디자인 기본값을 재정의합니다.This value overrides the design default. 리터럴 또는 환경 변수 참조Literal or Environment Variable Reference
디자인 값Design Value SQL Server Data ToolsSQL Server Data Tools에서 프로젝트가 생성되거나 편집될 때 매개 변수에 지정되는 값입니다.The value assigned to the parameter when the project is created or edited in SQL Server Data ToolsSQL Server Data Tools. 이 값은 프로젝트와 함께 지속됩니다.This value persists with the project. 리터럴Literal

단일 매개 변수를 사용하여 여러 패키지 속성에 값을 지정할 수 있습니다.You can use a single parameter to assign a value to multiple package properties. 단일 패키지 속성은 단일 매개 변수로부터의 값만 지정할 수 있습니다.A single package property can be assigned a value only from a single parameter.

실행 및 매개 변수 값 Executions and Parameter Values

실행 은 단일 패키지 실행 인스턴스를 나타내는 개체입니다.The execution is an object that represents a single instance of package execution. 실행을 만들 때는 실행 매개 변수 값과 같이 패키지를 실행하는 데 필요한 모든 세부 정보를 지정합니다.When you create an execution, you specify all of the details necessary to run a package such as execution parameter values. 기존 실행에 대한 매개 변수 값을 수정할 수도 있습니다.You can also modify the parameters values for existing executions.

실행 매개 변수 값을 명시적으로 설정할 때는 해당 실행 인스턴스에만 값을 적용할 수 있습니다.When you explicitly set an execution parameter value, the value is applicable only to that particular instance of execution. 실행 값은 서버 값 또는 디자인 값 대신 사용됩니다.The execution value is used instead of a server value or a design value. 실행 값을 명시적으로 설정하지 않고 서버 값이 지정된 경우 서버 값이 사용됩니다.If you do not explicitly set an execution value, and a server value has been specified, the server value is used.

매개 변수가 필수로 표시된 경우 해당 매개 변수에 대해 서버 값 또는 실행 값을 지정해야 합니다.When a parameter is marked as required, a server value or execution value must be specified for that parameter. 그렇지 않으면 해당 패키지가 실행되지 않습니다.Otherwise, the corresponding package does not execute. 디자인 타임에는 매개 변수에 기본값이 있지만 프로젝트를 배포하면 기본값이 사용되지 않습니다.Although the parameter has a default value at design time, it will never be used once the project is deployed.

환경 변수Environment Variables

매개 변수가 환경 변수를 참조하는 경우 해당 변수의 리터럴 값이 지정된 환경 참조를 통해 확인되고 매개 변수에 적용됩니다.If a parameter references an environment variable, the literal value from that variable is resolved through the specified environment reference and applied to the parameter. 패키지 실행에 사용되는 최종 리터럴 매개 변수 값은 실행 매개 변수 값으로 참조됩니다.The final literal parameter value that is used for package execution is referred to as the execution parameter value. 실행 대화 상자를 사용하여 실행에 대한 환경 참조를 지정합니다.You specify the environment reference for an execution by using the Execute dialog box

프로젝트 매개 변수가 환경 변수를 참조하고, 변수의 리터럴 값을 실행 시 확인할 수 없으면 디자인 값이 사용됩니다.If a project parameter references an environment variable and the literal value from the variable cannot be resolved at execution, the design value is used. 서버 값이 사용되지 않습니다.The server value is not used.

매개 변수 값에 지정된 환경 변수를 보려면 catalog.object_parameters 뷰를 쿼리합니다.To view the environment variables that are assigned to parameter values, query the catalog.object_parameters view. 자세한 내용은 참조 catalog.object_parameters ( SSISDB 데이터베이스 ) .For more information, see catalog.object_parameters (SSISDB Database).

실행 매개 변수 값 확인Determining Execution Parameter Values

매개 변수 값을 표시 및 설정하는 데 사용할 수 있는 Transact-SQL 뷰 및 저장 프로시저는 다음과 같습니다.The following Transact-SQL views and stored procedure can be used to display and set parameter values.

catalog.execution_parameter_values ( SSISDB 데이터베이스 ) (view)catalog.execution_parameter_values (SSISDB Database)(view)
특정 실행에 사용될 실제 매개 변수 값을 보여 줍니다.Shows the actual parameter values that will be used by a specific execution

catalog.get_parameter_values ( SSISDB 데이터베이스 ) (저장 프로시저)catalog.get_parameter_values (SSISDB Database) (stored procedure)
지정된 패키지와 환경 참조의 실제 값을 확인하고 보여 줍니다.Resolves and shows the actual values for the specified package and environment reference

catalog.object_parameters ( SSISDB 데이터베이스 ) (view)catalog.object_parameters (SSISDB Database) (view)
디자인 기본값 및 서버 기본값을 포함하여 Integration ServicesIntegration Services 카탈로그의 모든 패키지 및 속성에 대한 매개 변수와 속성을 표시합니다.Displays the parameters and properties for all packages and projects in the Integration ServicesIntegration Services catalog, including the design default and server default values.

catalog.set_execution_parameter_value ( SSISDB 데이터베이스 )catalog.set_execution_parameter_value (SSISDB Database)
Integration ServicesIntegration Services 카탈로그의 실행 인스턴스에 대한 매개 변수 값을 설정합니다.Sets the value of a parameter for an instance of execution in the Integration ServicesIntegration Services catalog.

또한 **** 의 패키지 실행 SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) 대화 상자를 사용하여 매개 변수 값을 수정할 수 있습니다.You can also use the Execute Package dialog box in SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) modify the parameter value. 자세한 내용은 Execute Package Dialog Box을 참조하세요.For more information, see Execute Package Dialog Box.

dtexec /Parameter 옵션을 사용하여 매개 변수 값을 수정할 수도 있습니다.You can also use the dtexec /Parameter option to modify a parameter value. 자세한 내용은 dtexec Utility을 참조하세요.For more information, see dtexec Utility.

매개 변수 유효성 검사Parameter Validation

매개 변수 값을 확인할 수 없는 경우 해당 패키지 실행이 실패합니다.If parameter values cannot be resolved, the corresponding package execution will fail. 오류를 방지하려면 **** 의 유효성 검사 SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)대화 상자를 사용하여 프로젝트 및 패키지의 유효성을 검사합니다.To help avoid failures, you can validate projects and packages by using the Validate dialog box in SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT). 유효성 검사를 통해 모든 매개 변수가 필요한 값을 가지고 있는지 확인하거나 특정 환경 참조에 필요한 값을 확인할 수 있습니다.Validation allows you to confirm that all parameters have the necessary values or can resolve the necessary values with specific environment references. 유효성 검사는 또한 다른 일반적인 패키지 문제도 확인합니다.Validation also checks for other common package issues.

자세한 내용은 Validate Dialog Box을 참조하세요.For more information, see Validate Dialog Box.

매개 변수 예Parameter Example

이 예에서는 패키지의 옵션을 지정하는 데 사용되는 pkgOptions 라는 매개 변수를 설명합니다.This example describes a parameter named pkgOptions that is used to specify options for the package in which it resides.

디자인 타임에 SQL Server Data ToolsSQL Server Data Tools에서 매개 변수가 생성될 때 매개 변수에 기본값 1이 할당되었습니다.During design time, when the parameter was created in SQL Server Data ToolsSQL Server Data Tools, a default value of 1 was assigned to the parameter. 이 기본값을 디자인 기본값이라고 합니다.This default value is referred to as the design default. 프로젝트가 SSISDB 카탈로그에 배포되고 이 매개 변수에 다른 값이 할당되지 않은 경우 패키지 실행 시 pkgOptions 매개 변수에 해당하는 패키지 속성에 값 1이 할당됩니다.If the project was deployed to the SSISDB catalog and no other values were assigned to this parameter, the package property corresponding to the pkgOptions parameter would be assigned the value of 1 during package execution. 디자인 기본값은 프로젝트와 함께 프로젝트 수명 주기 내내 지속됩니다.The design default persists with the project throughout its life cycle.

특정 패키지 실행 인스턴스를 준비하는 경우 pkgOptions 매개 변수에 값 5가 할당됩니다.While preparing a specific instance of package execution, a value of 5 is assigned to the pkgOptions parameter. 이 값은 특정 실행 인스턴스에 대한 매개 변수에만 적용되므로 실행 값이라고 합니다.This value is referred to as the execution value because it applies to the parameter only for that particular instance of execution. 실행이 시작되면 pkgOptions 매개 변수에 해당하는 패키지 속성에 값 5가 할당됩니다.When execution starts, the package property corresponding to the pkgOptions parameter is assigned the value of 5.

Create ParametersCreate parameters

SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) 를 사용하여 프로젝트 매개 변수 및 패키지 매개 변수를 만들 수 있습니다.You use SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) to create project parameters and package parameters. 다음 절차에서는 패키지/프로젝트 매개 변수를 만드는 단계별 지침을 제공합니다.The following procedures provide step-by-step instructions for creating package/project parameters.

참고: 이전 버전의 Integration ServicesIntegration Services를 사용하여 만든 프로젝트를 프로젝트 배포 모델로 변환하는 경우 Integration Services 프로젝트 변환 마법사를 사용하여 구성에 따라 매개 변수를 만들 수 있습니다.NOTE: If you are converting a project that you created using an earlier version of Integration ServicesIntegration Services to the project deployment model, you can use the Integration Services Project Conversion Wizard to create parameters based on configurations. 자세한 내용은 참조 배포할 Integration Services (SSIS) 프로젝트 및 패키지합니다.For more information, see Deploy Integration Services (SSIS) Projects and Packages.

패키지 매개 변수 만들기Create package parameters

  1. SQL Server Data ToolsSQL Server Data Tools에서 패키지를 열고 SSIS 디자이너에서 매개 변수 탭을 클릭합니다.Open the package in SQL Server Data ToolsSQL Server Data Tools, and then click the Parameters tab in the SSIS Designer.

    패키지 매개 변수 탭Package Parameters Tab

  2. 도구 모음에서 매개 변수 추가 단추를 클릭합니다.Click the Add Parameter button on the toolbar.

    도구 모음 단추 추가Add Toolbar Button

  3. 목록 자체에서 또는 속성창에서 이름, 데이터 형식, , 구분필수 속성의 값을 입력합니다.Enter values for the Name, Data Type, Value, Sensitive, and Required properties in the list itself or in the Properties window. 다음 표에서는 이러한 속성을 설명합니다.The following table describes these properties.

    속성Property DescriptionDescription
    속성Name 매개 변수의 이름입니다.The name of the parameter.
    이름Data type 매개 변수의 데이터 형식입니다.The data type of the parameter.
    기본값Default value 디자인 타임에 할당되는 매개 변수의 기본값입니다.The default value for the parameter assigned at design time. 디자인 기본값이라고도 합니다.This is also known as the design default.
    Sensitive 중요한 매개 변수 값은 카탈로그에서 암호화되고 Transact-SQL 또는 SQL Server Management Studio를 사용하여 볼 경우 NULL 값으로 나타납니다.Sensitive parameter values are encrypted in the catalog and appear as a NULL value when viewed with Transact-SQL or SQL Server Management Studio.
    필수임Required 패키지를 실행하기 전에 반드시 지정해야 하는 디자인 기본값 이외의 값입니다.Requires that a value, other than the design default, is specified before the package can execute.
    DescriptionDescription 유지 관리의 편의를 위한 매개 변수 설명입니다.For maintainability, the description of the parameter. SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)의 경우 Visual Studio 속성 창의 해당 매개 변수 창에서 매개 변수를 선택할 때 매개 변수 설명을 설정합니다.In SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT), set the parameter description in the Visual Studio Properties window when the parameter is selected in the applicable parameters window.

    참고: 프로젝트를 카탈로그에 배포하면 몇 가지 추가 속성이 프로젝트와 연결됩니다.NOTE: When you deploy a project to the catalog, several more properties become associated with the project. 카탈로그의 모든 매개 변수에 대한 모든 속성을 보려면 catalog.object_parameters(SSISDB 데이터베이스) 뷰를 참조하세요.To see all properties for all parameters in the catalog, use the catalog.object_parameters (SSISDB Database) view.

  4. 프로젝트를 저장하여 매개 변수 변경 내용을 저장합니다.Save the project to save changes to parameters. 매개 변수 값은 프로젝트 파일에 저장됩니다.Parameter values are stored in the project file.

    경고!!WARNING!! 목록에서 직접 편집하거나 속성 창을 사용하여 매개 변수 속성의 값을 수정할 수 있습니다.You can in-place edit in the list or use the Properties window to modify the values of parameter properties. 삭제(X) 도구 모음 단추를 사용하여 매개 변수를 삭제할 수 있습니다.You can delete a parameter by using the Delete (X) toolbar button. 마지막 도구 모음 단추를 사용하면 SQL Server Data ToolsSQL Server Data Tools에서 패키지를 실행할 때만 사용되는 매개 변수의 값을 지정할 수 있습니다.Using the last toolbar button, you can specify a value for a parameter that is used only when you execute the package in SQL Server Data ToolsSQL Server Data Tools.

    참고: SQL Server Data ToolsSQL Server Data Tools에서 프로젝트를 열지 않고 패키지 파일을 다시 열면 매개 변수 탭이 비어 있고 비활성화된 상태로 나타납니다.NOTE: If you re-open the package file without opening the project in SQL Server Data ToolsSQL Server Data Tools, the Parameters tab will be empty and disabled.

프로젝트 매개 변수 만들기Create project parameters

  1. SQL Server Data ToolsSQL Server Data Tools에서 프로젝트를 엽니다.Open the project in SQL Server Data ToolsSQL Server Data Tools.

  2. 솔루션 탐색기에서 Project.params를 마우스 오른쪽 단추로 클릭한 다음 열기를 클릭하거나 Project.params를 두 번 클릭하여 이 항목을 엽니다.Right-click Project.params in Solution Explorer, and then click Open (OR) double-click Project.params to open it.

    프로젝트 매개 변수 창Project Parameters Window

  3. 도구 모음에서 매개 변수 추가 단추를 클릭합니다.Click the Add Parameter button on the toolbar.

    도구 모음 단추 추가Add Toolbar Button

  4. 이름, 데이터 형식, , 구분필수 속성의 값을 입력합니다.Enter values for the Name, Data Type, Value, Sensitive, and Required properties.

    속성Property DescriptionDescription
    속성Name 매개 변수의 이름입니다.The name of the parameter.
    이름Data type 매개 변수의 데이터 형식입니다.The data type of the parameter.
    기본값Default value 디자인 타임에 할당되는 매개 변수의 기본값입니다.The default value for the parameter assigned at design time. 디자인 기본값이라고도 합니다.This is also known as the design default.
    Sensitive 중요한 매개 변수 값은 카탈로그에서 암호화되고 Transact-SQL 또는 SQL Server Management Studio를 사용하여 볼 경우 NULL 값으로 나타납니다.Sensitive parameter values are encrypted in the catalog and appear as a NULL value when viewed with Transact-SQL or SQL Server Management Studio.
    필수임Required 패키지를 실행하기 전에 반드시 지정해야 하는 디자인 기본값 이외의 값입니다.Requires that a value, other than the design default, is specified before the package can execute.
    DescriptionDescription 유지 관리의 편의를 위한 매개 변수 설명입니다.For maintainability, the description of the parameter. SQL Server Data ToolsSQL Server Data Tools의 경우 Visual Studio 속성 창의 해당 매개 변수 창에서 매개 변수를 선택할 때 매개 변수 설명을 설정합니다.In SQL Server Data ToolsSQL Server Data Tools, set the parameter description in the Visual Studio Properties window when the parameter is selected in the applicable parameters window.
  5. 프로젝트를 저장하여 매개 변수 변경 내용을 저장합니다.Save the project to save changes to parameters. 매개 변수 값은 프로젝트 파일의 구성에 저장됩니다.Parameter values are stored in configurations in the project file. 매개 변수 값의 모든 변경 사항을 디스크에 커밋하려면 프로젝트 파일을 저장합니다.Save the project file to commit to disk any changes in the parameter values.

    경고!WARNING!!! 목록에서 직접 편집하거나 속성 창을 사용하여 매개 변수 속성의 값을 수정할 수 있습니다.You can in-place edit in the list or use the Properties window to modify the values of parameter properties. 삭제(X) 도구 모음 단추를 사용하여 매개 변수를 삭제할 수 있습니다.You can delete a parameter by using the Delete (X) toolbar button. 마지막 도구 모음 단추를 사용하여 매개 변수 값 관리 대화 상자를 열면 SQL Server Data ToolsSQL Server Data Tools에서 패키지를 실행할 때만 사용되는 매개 변수의 값을 지정할 수 있습니다.Using the last toolbar button to open the Manage Parameter Values dialog box, you can specify a value for a parameter that is used only when you execute the package in SQL Server Data ToolsSQL Server Data Tools.

매개 변수화 대화 상자Parameterize Dialog Box

매개 변수화 대화 상자에서는 새 데이터베이스 또는 기존 매개 변수는 태스크의 속성과 연결할 수 있습니다.The Parameterize dialog box lets you associate a new or an existing parameter with a property of a task. 태스크나 SSISSSIS 디자이너의 제어 흐름 탭을 마우스 오른쪽 단추로 클릭한 다음 매개 변수화를 클릭하여 이 대화 상자를 엽니다.You open the dialog box by right-clicking a task or the Control Flow tab in SSISSSIS Designer and then by clicking Parameterize. 다음 목록에서는 이 대화 상자의 UI 요소에 대해 설명합니다.The following list describes UI elements in the dialog box. 매개 변수에 대한 자세한 내용은 SSIS(Integration Services) 매개 변수를 참조하세요.For more information about parameters, see Integration Services (SSIS) Parameters.

옵션Options

속성Property
매개 변수와 연결할 태스크의 속성을 선택합니다.Select the property of the task that you want to associate with a parameter. 이 목록은 매개 변수화할 수 있는 모든 속성으로 채워집니다.This list is populated with all the properties that can be parameterized.

기존 매개 변수 사용Use existing parameter
이 옵션을 선택하여 태스크의 속성을 기존 매개 변수와 연결한 다음 드롭다운 목록에서 매개 변수를 선택합니다.Select this option to associate the property of task with an existing parameter and then select the parameter from drop-down list.

매개 변수를 사용 하지 마십시오Do not use parameter
매개 변수에 대한 참조를 제거하려면 이 옵션을 선택합니다.Select this option to remove a reference to a parameter. 매개 변수는 삭제되지 않습니다.The parameter is not deleted.

새 매개 변수 만들기Create new parameter
이 옵션을 선택하여 태스크의 속성과 연결할 새 매개 변수를 만듭니다.Select this option to create a new parameter that you want to associate with the property of the task.

이름Name
만들려는 매개 변수의 이름을 지정합니다.Specify the name of the parameter you want to create.

설명Description
매개 변수에 대한 설명을 지정합니다.Specify the description for parameter.

Value
매개 변수의 기본값을 지정합니다.Specify the default value for the parameter. 이 값은 디자인 기본값이라고도 하며 나중에 배포할 때 재정의할 수 있습니다.This is also known as the design default, which can be overridden later at the deployment time.

범위Scope
프로젝트 또는 패키지 옵션을 선택하여 매개 변수의 범위를 지정합니다.Specify the scope of the parameter by selecting either Project or Package option. 프로젝트 매개 변수는 프로젝트가 수신하는 외부 입력을 프로젝트 내 하나 이상의 패키지에 제공하기 위해 사용됩니다.Project parameters are used to supply any external input the project receives to one or more packages in the project. 패키지 매개 변수를 사용하면 패키지를 편집하여 다시 배포할 필요 없이 패키지 실행을 수정할 수 있습니다.Package parameters allow you to modify package execution without having to edit and redeploy the package.

중요 한Sensitive
확인란을 선택하거나 선택 취소하여 매개 변수가 중요한지 여부를 지정합니다.Specify whether the parameter is a sensitive by checking or clearing the check box. 구분 매개 변수 값은 카탈로그에서 암호화되고 Transact-SQL 또는 SQL Server Management Studio를 사용하여 볼 경우 NULL 값으로 나타납니다.Sensitive parameter values are encrypted in the catalog and appear as a NULL value when viewed with Transact-SQL or SQL Server Management Studio.

필수Required
매개 변수 사용 시 디자인 기본값 이외의 값을 지정해야 패키지를 실행할 수 있는지 여부를 지정합니다.Specify whether the parameter requires that a value, other than the design default, is specified before the package can execute.

프로젝트를 배포한 후 매개 변수 값을 설정Set parameter values after the project is deployed

카탈로그에 프로젝트를 배포할 때 배포 마법사를 사용하여 서버 기본 매개 변수 값을 설정할 수 있습니다.The Deployment Wizard allows you to set server default parameter values when you deploy your project to the catalog. 프로젝트가 카탈로그에 배포된 후 SSMS(SQL Server Management Studio) 개체 탐색기 또는 Transact-SQL을 사용하여 서버 기본값을 설정할 수 있습니다.After your project is in the catalog, you can use SQL Server Management Studio (SSMS) Object Explorer or Transact-SQL to set server default values.

SSMS 개체 탐색기로 서버 기본값 설정Set server defaults with SSMS Object Explorer

  1. Integration Services 노드 아래에서 프로젝트를 선택하고 마우스 오른쪽 단추로 클릭합니다.Select and right-click the project under the Integration Services node.

  2. 속성 을 클릭하여 프로젝트 속성 대화 상자를 엽니다.Click Properties to open the Project Properties dialog window.

  3. 페이지 선택 에서 매개 변수를 클릭하여 매개 변수 페이지를 엽니다.Open the parameters page by clicking Parameters under Select a page.

  4. 매개 변수 목록에서 원하는 매개 변수를 선택합니다.Select the desired parameter in the Parameters list. 참고: 컨테이너 열을 통해 패키지 매개 변수와 프로젝트 매개 변수를 구별할 수 있습니다.Note: The Container column helps distinguish project parameters from package parameters.

  5. 열에 원하는 서버 기본 매개 변수 값을 지정합니다.In the Value column, specify the desired server default parameter value.

Transact SQL로 서버 기본값 설정Set server defaults with Transact-SQL

Transact-SQL로 서버 기본값을 설정하려면 catalog.set_object_parameter_value(SSISDB 데이터베이스) 저장 프로시저를 사용합니다.To set server defaults with Transact-SQL, use the catalog.set_object_parameter_value (SSISDB Database) stored procedure. 현재 서버 기본값을 보려면 catalog.object_parameters(SSISDB 데이터베이스) 뷰를 쿼리합니다.To view current server defaults, query the catalog.object_parameters (SSISDB Database) view. 서버 기본값을 지우려면 catalog.clear_object_parameter_value(SSISDB 데이터베이스) 저장 프로시저를 사용합니다.To clear a server default value, use the catalog.clear_object_parameter_value (SSISDB Database) stored procedure.

mattmasson.com의 블로그 항목, SSIS 빠른 팁: 필수 매개 변수.Blog entry, SSIS Quick Tip: Required Parameters, on mattmasson.com.