Integration Services (SSIS) 스케일 아웃에 패키지를 실행 합니다.Run packages in Integration Services (SSIS) Scale Out

패키지를 Integration Services 서버에 배포한 후 규모 확장에서 실행할 수 있습니다.After the packages are deployed to the Integration Services server, you can execute them in Scale Out.

실행 패키지의 스케일 아웃 대화 상자와 패키지를 실행 합니다.Run packages with Execute Package In Scale Out dialog

  1. 규모 확장 시 패키지 실행 대화 상자 열기Open the Execute Package In Scale Out dialog box

    SQL Server Management StudioSQL Server Management Studio에서 Integration Services 서버에 연결합니다.In SQL Server Management StudioSQL Server Management Studio, connect to the Integration Services server. 개체 탐색기에서 트리를 확장하여 Integration Services 카탈로그아래의 노드를 표시합니다.In Object Explorer, expand the tree to display the nodes under Integration Services Catalogs. SSISDB 노드 또는 실행하려는 프로젝트나 패키지를 마우스 오른쪽 단추로 클릭한 다음 Execute in Scale Out(규모 확장 시 실행)을 클릭합니다.Right-click the SSISDB node or the project or the package you want to run, and then click Execute in Scale Out.

  2. 패키지를 선택하고 옵션 설정Select packages and set the options

    패키지 선택 페이지에서 실행하려는 여러 패키지를 선택하고 각 패키지에 대해 환경, 매개 변수, 연결 관리자 및 고급 옵션을 설정합니다.On the Package Selection page, you select multiple packages to run and set the environment, parameters, connection managers, and advanced options for each package. 이러한 옵션을 설정할 패키지를 클릭합니다.Click a package to set these options.

    고급 탭에서 다시 시도 횟수라는 규모 확장 옵션을 설정합니다.In the Advanced tab, you set a Scale Out option called Retry count. 이 옵션을 패키지 실행이 실패할 경우 다시 시도하는 횟수를 설정합니다.It sets the number of times a package execution will retry if it fails.

    참고

    오류 덤프 스케일 아웃 Worker 서비스를 실행 하는 계정 관리자가 로컬 컴퓨터의 경우만 옵션 적용 됩니다.The Dump on errors option only takes effect when the account running Scale Out Worker service is an administrator of local computer.

  3. 컴퓨터 선택Select machines

    컴퓨터 선택 페이지에서 패키지를 실행할 규모 확장 작업자 컴퓨터를 선택합니다.On the Machine Selection page, you select the Scale Out Worker machines to run the packages. 기본적으로 모든 컴퓨터에서 패키지를 실행할 수 있습니다.By default, any machine is allowed to run the packages.

    참고

    패키지는 컴퓨터 선택 페이지에 표시되는 규모 확장 작업자 서비스의 사용자 계정 자격 증명을 사용하여 실행됩니다.The packages are executed with the credential of the user accounts of the Scale Out Worker services, which are shown on the Machine Selection page. 기본적으로 이 계정은 NT Service\SSISScaleOutWorker140입니다.By default, the account is NT Service\SSISScaleOutWorker140. 고유한 랩 계정으로 변경할 수 있습니다.You may want to change to your own lab accounts.

    경고

    패키지 실행 시 서로 다른 사용자는 동일한 작업자에 의해 트리거되는 동일한 계정으로 실행 됩니다.Package executions triggered by different users on the same worker are run with the same account. 그중에서 없는 보안 경계가 있습니다.There is no security boundary among them.

  4. 패키지를 실행하고 보고서 보기Run the packages and view reports

    확인 을 클릭하여 패키지 실행을 시작합니다.Click OK to start the package executions. 패키지에 대한 실행 보고서를 보려면 개체 탐색기에서 패키지를 마우스 오른쪽 단추로 클릭하고 보고서, 모든 실행을 차례로 클릭한 다음 실행을 찾습니다.To view the execution report for a package, right-click the package in Object Explorer, click Reports, click All Executions, and find the execution.

저장 프로시저를 사용하여 패키지 실행Run packages with stored procedures

  1. 실행 만들기Create executions

    각 패키지에 대해 [catalog].[create_execution]을 호출합니다.Call [catalog].[create_execution] for each package. @runinscaleout 매개 변수를 True로 설정합니다.Set parameter @runinscaleout to True. 일부 규모 확장 작업자 컴퓨터에서 패키지를 실행할 수 없는 경우 @useanyworker 매개 변수를 False로 설정합니다.If not all Scale Out Worker machines are allowed to run the package, set parameter @useanyworker to False.

  2. 실행 매개 변수 설정Set execution parameters

    각 실행에 대해 [catalog].[set_execution_parameter_value]를 호출합니다.Call [catalog].[set_execution_parameter_value] for each execution.

  3. 규모 확장 작업자 설정Set Scale Out Workers

    [catalog].[add_execution_worker]를 호출합니다.Call [catalog].[add_execution_worker]. 모든 컴퓨터에서 패키지를 실행할 수 있는 경우 이 저장 프로시저를 호출할 필요가 없습니다.If any machine is allowed to run the package, you do not need to call this stored procedure.

  4. 실행 시작Start executions

    [catalog].[start_execution]을 호출합니다.Call [catalog].[start_execution]. @retry_count 매개 변수를 설정하여 패키지 실행이 실패할 경우 다시 시도하는 횟수를 설정합니다.Set parameter @retry_count to set the number of times a package execution will retry if it fails.

예제Example

다음 예제에서는 규모 확장 시 하나의 규모 확장 작업자에서 package1.dtsx와 package2.dtsx라는 두 개의 패키지를 실행합니다.The following example runs two packages, package1.dtsx and package2.dtsx, in Scale Out with one Scale Out Worker.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'package1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'folder1', @project_name=N'project1', @use32bitruntime=False, @reference_id=Null, @useanyworker=False, @runinscaleout=True
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0
EXEC [SSISDB].[catalog].[add_execution_worker] @execution_id,  @workeragent_id=N'64c020e2-f819-4c2d-a22f-efb31a91e70a'
EXEC [SSISDB].[catalog].[start_execution] @execution_id,  @retry_count=0
GO

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'package2.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'folder2', @project_name=N'project2', @use32bitruntime=False, @reference_id=Null, @useanyworker=False, @runinscaleout=True
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0
EXEC [SSISDB].[catalog].[add_execution_worker] @execution_id,  @workeragent_id=N'64c020e2-f819-4c2d-a22f-efb31a91e70a'
EXEC [SSISDB].[catalog].[start_execution] @execution_id,  @retry_count=0
GO

PermissionsPermissions

규모 확장 시 패키지를 실행하려면 다음 권한 중 하나가 필요합니다.Running packages in Scale Out requires one the following permissions:

  • ssis_admin 데이터베이스 역할의 멤버 자격Membership in the ssis_admin database role

  • ssis_cluster_executor 데이터베이스 역할의 멤버 자격Membership in the ssis_cluster_executor database role

  • sysadmin 서버 역할의 멤버 자격Membership in the sysadmin server role

기본 실행 모드 설정Set default execution mode

"스케일 아웃"를 기본 실행 모드를 설정 하려면 마우스 오른쪽 단추로 클릭는 SSISDB 선택한 SSMS의 개체 탐색기의 노드 속성합니다.To set default execution mode to "Scale Out", right-click the SSISDB node in Object Explorer of SSMS and select Properties. 카탈로그 속성 대화 상자에서 서버 차원의 기본 실행 모드스케일 아웃합니다.In the Catalog Properities dialog, set Server-wide Default execution mode to Scale Out.

이 설정은 이후에 지정할 필요가 없습니다는 @runinscaleout 매개 변수가 [catalog]. [ create_execution]입니다.After this setting, there's no need to specify the @runinscaleout parameter for [catalog].[create_execution]. 스케일 아웃에 실행 될 때 자동으로 실행 됩니다.Executions are executed in Scale Out automatically.

Exe 모드

기본 실행 모드에는 비-스케일 아웃 모드로 다시 전환할 설정할 서버 차원의 기본 실행 모드서버합니다.To switch default execution mode back to non-Scale Out mode, just set Server-wide Default execution mode to Server.

SQL 에이전트 작업에서 패키지를 실행 합니다.Run package in SQL agent job

Sql 에이전트 작업에서 작업의 한 단계로 SSIS 패키지를 실행 하도록 선택할 수 있습니다.In Sql agent job, you can choose to run a SSIS package as one step of the job. 스케일 아웃에 패키지를 실행 하려면 위의 기본 실행 모드를 활용할 수 있습니다.To run the package in Scale Out, you can leverage the above default execution mode. 기본 실행 모드를 설정 "스케일 아웃"를, 한 후 Sql 에이전트 작업에서 패키지 범위 확장에서 실행 됩니다.After setting default execution mode to "Scale Out", packages in Sql agent jobs will be run in Scale Out.