검사 점 을 사용 하 여 패키지 다시 시작 | Microsoft Docs 
 검사 점 을 사용 하 여 패키지 다시 시작 Restart Packages by Using Checkpoints 
 Integration ServicesIntegration Services 는 전체 패키지 를 다시 실행 하 지 않 고 오류 발생 시점 에서 실패 한 패키지 를 다시 시작 할 수 있 습니다 . can restart failed packages from the point of failure , instead of rerunning the whole package . 패키지 가 검사 점 을 사용 하 도록 구성 된 경우 패키지 실행 에 대한 정보 는 검사 점 파일 에 기록 됩니다 . If a package is configured to use checkpoints , information about package execution is written to a checkpoint file . 실패 한 패키지 가 다시 실행 될 때 검사 점 파일 은 오류 발생 지점 에서 패키지 를 다시 시작 하 는 데 사용 됩니다 . When the failed package is rerun , the checkpoint file is used to restart the package from the point of failure . 패키지 가 성공 적 으로 실행 된 경우 검사 점 파일 은 삭제 되 고 다음 에 패키지 가 실행 될 때 다시 만들 어 집니다 . If the package runs successfully , the checkpoint file is deleted , and then re - created the next time the package is run . 
 패키지 에서 검사 점 을 사용 하 면 다음 과 같 은 이점 이 있 습니다 . Using checkpoints in a package can provide the following benefits . 
 큰 파일 의 반복 적 인 다운로드 및 업로드 를 피할 수 있 습니다 . Avoid repeating the downloading and uploading of large files . 예 를 들 어 각 다운로드 에 FTP 태 스 크 를 사용 하 여 여러 큰 파일 을 다운로드 하 는 패키지 의 경우 , 특정 파일 에 대한 다운로드 가 실패 하 면 패키지 를 다시 시작 하 여 해당 파일 만 다운로드 할 수 있 습니다 . For example , a package that downloads multiple large files by using an FTP task for each download can be restarted after the downloading of a single file fails and then download only that file . 
 대용량 데이터 의 반복 적 인 로드 를 피할 수 있 습니다 . Avoid repeating the loading of large amounts of data . 예 를 들 어 차원 마다 다른 대량 삽입 태 스 크 를 사용 하 여 데이터 웨어 하우스 의 차원 테이블 로 대량 삽입 을 수행 하 는 패키지 의 경우 , 특정 차원 테이블 에 대한 삽입 이 실패 하 면 패키지 를 다시 시작 할 수 있 으며 해당 차원 만 다시 로드 됩니다 . For example , a package that performs bulk inserts into dimension tables in a data warehouse using a different Bulk Insert task for each dimension can be restarted if the insertion fails for one dimension table , and only that dimension will be reloaded . 
 반복 적 인 값 집계 를 피할 수 있 습니다 . Avoid repeating the aggregation of values . 예 를 들 어 각 집계 를 수행 하 기 위해 별도 의 데이터 흐름 태 스 크 를 사용 하 여 평균 및 합계 와 같 은 많 은 집계 를 계산 하 는 패키지 의 경우 특정 집계 계산 이 실패 하 면 패키지 를 다시 시작 할 수 있 으며 해당 집계 만 다시 계산 됩니다 . For example , a package that computes many aggregates , such as averages and sums , using a separate Data Flow task to perform each aggregation , can be restarted after computing an aggregation fails and only that aggregation will be recomputed . 
 패키지 가 검사 점 을 사용 하 도록 구성 된 경우 Integration ServicesIntegration Services 는 검사 점 파일 에서 다시 시작 지점 을 캡 처 합니다 . If a package is configured to use checkpoints , Integration ServicesIntegration Services captures the restart point in the checkpoint file . 실패 한 컨테이너 유형 및 트랜잭션 과 같 은 기능 의 구현 은 검사 점 파일 에 기록 된 다시 시작 지점 에 영향 을 미칩니다 . The type of container that fails and the implementation of features such as transactions affect the restart point that is recorded in the checkpoint file . 변수 의 현재 값 도 검사 점 파일 에 캡 처 됩니다 . The current values of variables are also captured in the checkpoint file . 그러나 Object 데이터 형식 의 변수 값 은 검사 점 파일 에 저장 되 지 않 습니다 . However , the values of variables that have the Object data type are not saved in checkpoint files . 
 다시 시작 지점 정의 Defining Restart Points 
 단일 태 스 크 를 캡슐 화 하 는 태 스 크 호스트 컨테이너 는 다시 시작 할 수 있 는 가장 작 은 단위 입니다 . The task host container , which encapsulates a single task , is the smallest atomic unit of work that can be restarted . 또한 Foreach Loop 컨테이너 및 트랜잭션 이 적용 된 컨테이너 도 작업 의 최소 단위 로 간주 됩니다 . The Foreach Loop container and a transacted container are also treated as atomic units of work . 
 트랜잭션 이 적용 된 컨테이너 가 실행 중 인 동안 패키지 가 중지 된 경우 트랜잭션 은 중단 되 고 컨테이너 에 의해 수행 된 모든 작업 은 롤백 됩니다 . If a package is stopped while a transacted container is running , the transaction ends and any work performed by the container is rolled back . 실패 한 컨테이너 는 패키지 를 다시 시작 할 때 다시 실행 됩니다 . When the package is restarted , the container that failed is rerun . 트랜잭션 이 적용 된 컨테이너 의 모든 자식 컨테이너 에 대한 작업 완료 는 검사 점 파일 에 기록 되 지 않 습니다 . The completion of any child containers of transacted container is not recorded in the checkpoint file . 그러므로 패키지 를 다시 시작 하 면 트랜잭션 이 적용 된 컨테이너 와 그 자식 컨테이너 가 다시 실행 됩니다 . Therefore , when the package is restarted , the transacted container and its child containers run again . 
 같 은 패키지 에서 검사 점 및 트랜잭션 을 사용 하 면 예기 치 않 은 결과 가 발생 할 수 있 습니다 . Using checkpoints and transactions in the same package could cause unexpected results . 예 를 들 어 패키지 가 실패 하 고 검사 점 에서 다시 시작 되 면 패키지 에서 이미 성공 적 으로 커 밋 한 트랜잭션 을 반복 할 수 있 습니다 . For example , when a package fails and restarts from a checkpoint , the package might repeat a transaction that has already been successfully committed . 
 For Loop 및 Foreach Loop 컨테이너 에 대한 검사 점 데이터 는 저장 되 지 않 습니다 . Checkpoint data is not saved for For Loop and Foreach Loop containers . 패키지 를 다시 시작 할 때 For Loop 및 Foreach Loop 컨테이너 와 그 자식 컨테이너 는 다시 실행 됩니다 . When a package is restarted , the For Loop and Foreach Loop containers and the child containers are run again . 루프 에 있 는 자식 컨테이너 가 성공 적 으로 실행 되 면 검사 점 파일 에 기록 되 지 않 고 다시 실행 됩니다 . If a child container in the loop runs successfully , it is not recorded in the checkpoint file , instead it is rerun . 자세 한 내용 및 해결 방법 은 SSIS 검사 점 이 For Loop 또는 Foreach Loop 컨테이너 항목 에 대해 허용 되 지 않 습니다 . 를 참조 하 십시오 . For more information and a workaround , see SSIS Checkpoints are not honored for For Loop or Foreach Loop container items . 
 패키지 를 다시 시작 하 면 패키지 는 구성 을 다시 로드 하 는 대신 검사 점 파일 에 기록 된 구성 정보 를 사용 합니다 . If the package is restarted the package configurations are not reloaded , instead the package uses the configuration information written to the checkpoint file . 이렇게 하 면 패키지 가 실패 한 시점 과 동일 한 구성 으로 다시 실행 될 수 있 습니다 . This ensures that the package uses the same configurations when it is rerun as the time it failed . 
 패키지 는 제어 흐름 수준 에서 만 다시 시작 할 수 있 습니다 . A package can be restarted only at the control flow level . 데이터 흐름 도중 에 패키지 를 다시 시작 할 수 없 습니다 . You cannot restart a package in the middle of a data flow . 전체 데이터 흐름 을 다시 실행 하 지 않 으려면 패키지 가 여러 데이터 흐름 으로 구성 되 도록 디자인 하 고 각 데이터 흐름 이 서로 다른 데이터 흐름 태 스 크 를 사용 하 도록 해야 합니다 . To avoid rerunning the whole data flow , the package might be designed to include multiple data flows , each one using a different Data Flow task . 이 방법 으로 하나 의 데이터 흐름 태 스 크 만 다시 실행 하 여 패키지 를 다시 시작 할 수 있 습니다 . This way the package can be restarted , rerunning only one Data Flow task . 
 다시 시작 하 도록 패키지 구성 Configuring a Package to Restart 
 다음 표 에서 는 검사 점 을 구현 하 기 위해 설정 하 는 패키지 속성 을 나열 합니다 . The following table lists the package properties that you set to implement checkpoints . 
 C h e c k p o i n t F ileNameCheckpointFileName 검사 점 파일 의 이름 을 지정 합니다 . Specifies the name of the checkpoint file . 
 C h e c k pointUsageCheckpointUsage 검사 점 사용 여부 를 지정 합니다 . Specifies whether checkpoints are used . 
 S a v e C heckpointsSaveCheckpoints 패키지 의 검사 점 저장 여부 를 나타냅니다 . Indicates whether the package saves checkpoints . 오류 발생 시점 에서 패키지 를 다시 시작 하 려면 이 속성 을 True 로 설정 해야 합니다 . This property must be set to True to restart a package from a point of failure . 
 이 밖 에 도 다시 시작 지점 으로 식별 할 패키지 내 의 모든 컨테이너 에 대해 FailPackageOnFailure 속성 을 true 로 설정 해야 합니다 . Additionally , you must set the FailPackageOnFailure property to true for all the containers in the package that you want to identify as restart points . 
 ForceExecutionResult 속성 을 사용 하 여 패키지 에 있 는 검사 점 의 사용 을 테스트 할 수 있 습니다 . You can use the ForceExecutionResult property to test the use of checkpoints in a package . 태 스 크 또는 컨테이너 의 ForceExecutionResult 를 Failure 로 설정 하 면 실시간 오류 와 동일 한 오류 를 만들 수 있 습니다 . By setting ForceExecutionResult of a task or container to Failure , you can imitate real - time failure . 패키지 를 다시 실행 하 면 실패 한 태 스 크 와 컨테이너 가 다시 실행 됩니다 . When you rerun the package , the failed task and containers will be rerun . 
 검사 점 사용 Checkpoint Usage 
 CheckpointUsage 속성 은 다음 값 으로 설정 할 수 있 습니다 . The CheckpointUsage property can be set to the following values : 
 안 함 Never 검사 점 파일 을 사용 하 지 않 고 패키지 가 패키지 워크플로 의 처음 부터 시작 되 도록 지정 합니다 . Specifies that the checkpoint file is not used and that the package runs from the start of the package workflow . 
 항상 Always 검사 점 파일 을 항상 사용 하 고 패키지 가 이전 의 실행 오류 지점 부터 다시 시작 하 도록 지정 합니다 . Specifies that the checkpoint file is always used and that the package restarts from the point of the previous execution failure . 검사 점 파일 을 찾 을 수 없 는 경우 패키지 는 실패 합니다 . If the checkpoint file is not found , the package fails . 
 검사 점 파일 보안 설정 Securing Checkpoint Files 
 패키지 수준 보호 에 는 검사 점 파일 보호 가 포함 되 지 않 으므로 이러 한 파일 에 대해 보안 을 별도 로 설정 해야 합니다 . Package level protection does not include protection of checkpoint files and you must secure these files separately . 검사 점 데이터 는 파일 시스템 에 만 저장 할 수 있 으므로 운영 체제 의 ACL ( 액세스 제어 목록 ) 을 사용 하 여 파일 저장 위치 또는 폴더 를 보호 해야 합니다 . Checkpoint data can be stored only in the file system and you should use an operating system access control list ( ACL ) to secure the location or folder where you store the file . 검사 점 파일 에 는 현재 변수 값 을 비롯 하 여 패키지 상태 에 대한 정보 가 들 어 있 으므로 검사 점 파일 에 대해 보안 을 설정 하 는 것 은 중요 합니다 . It is important to secure checkpoint files because they contain information about the package state , including the current values of variables . 예 를 들 어 변수 에 전화 번호 와 같 은 개인 데이터 행 이 여러 개 있 는 레코드 집합 이 포함 될 수 있 습니다 . For example , a variable may contain a recordset with many rows of private data such as telephone numbers . 자세 한 내용 은 패키지 에서 사용 되 는 파일 액세스 를 참조 하 세요 . For more information , see Access to Files Used by Packages . 
 실패 한 패키지 를 다시 시작 하 는 검사 점 구성 Configure Checkpoints for Restarting a Failed Package 
 검사 점 에 적용 되 는 속성 을 설정 하 여 전체 패키지 를 다시 실행 하 는 대신 장애 지점 에서 Integration ServicesIntegration Services 패키지 를 다시 시작 하 도록 구성 합니다 . You configure Integration ServicesIntegration Services packages to restart from a point of failure , instead of rerunning the entire package , by setting the properties that apply to checkpoints . 
 패키지 를 다시 시작 하 도록 구성 하 려면 To configure a package to restart 
 SaveCheckpoints 속성 을 True 로 설정 합니다 . Set the SaveCheckpoints property to True . 
 CheckpointFileName 속성 에 검사 점 파일 의 이름 을 입력 합니다 . Type the name of the checkpoint file in the CheckpointFileName property . 
 CheckpointUsage 속성 을 다음 두 값 중 하나 로 설정 합니다 . Set the CheckpointUsage property to one of two values : 
 패키지 를 항상 검사 점 에서 다시 시작 하 려면 Always 를 선택 합니다 . Select Always to always restart the package from the checkpoint . 
 검사 점 파일 을 사용 할 수 없 으면 오류 가 발생 합니다 . An error occurs if the checkpoint file is not available . 
 검사 점 파일 이 있 는 경우 에 만 패키지 를 검사 점 에서 다시 시작 하 려면 IfExists 를 선택 합니다 . Select IfExists to restart the package only if the checkpoint file is available . 
 패키지 가 다시 시작 될 수 있 는 태 스 크 및 컨테이너 를 구성 합니다 . Configure the tasks and containers from which the package can restart . 
 태 스 크 또는 컨테이너 를 마우스 오른쪽 단추 로 클릭 하 고 속성 을 클릭 합니다 . Right - click a task or container and click Properties . 
 선택 한 각 태 스 크 및 컨테이너 에 대해 FailPackageOnFailure 속성 을 True 로 설정 합니다 . Set the FailPackageOnFailure property to True for each selected task and container . 
 social . technet . microsoft . com 의 기술 문서 - 장애 조치 ( Failover ) 또는 실패 이후 SSIS 패키지 자동 다시 시작 Technical article , Automatic Restart of SSIS packages after Failover or Failure , on social . technet . microsoft . com 
 support . microsoft . com 의 고객 지원 문서 - SSIS 검사 점 이 For Loop 또는 Foreach Loop 컨테이너 항목 에 대해 허용 되 지 않 습니다 . Support article , SSIS Checkpoints are not honored for For Loop or Foreach Loop container items , on support . microsoft . com .