파일 시스템 태스크

  • 아티클

적용 대상: Azure Data Factory의 SQL Server SSIS Integration Runtime

파일 시스템 태스크는 파일 시스템의 파일 및 디렉터리에 대한 작업을 수행합니다. 예를 들어 파일 시스템 태스크를 사용하여 패키지에서 디렉터리 및 파일을 만들거나 이동하거나 삭제할 수 있습니다. 파일 시스템 작업을 사용하여 파일 및 디렉터리에 특성을 설정할 수도 있습니다. 예를 들어 파일 시스템 태스크는 파일에 숨김 또는 읽기 전용 특성을 설정할 수 있습니다.

모든 파일 시스템 작업에서는 파일 또는 디렉터리일 수 있는 원본을 사용합니다. 예를 들어 태스크에서 복사한 파일이나 삭제한 디렉터리가 원본입니다. 원본은 디렉터리 또는 파일을 가리키는 파일 연결 관리자를 사용하거나 원본 경로가 포함된 변수의 이름을 제공하여 지정할 수 있습니다. 자세한 내용은 파일 연결 관리자 및 Integration Services(SSIS) 변수를 참조하세요.

파일 및 디렉터리를 복사 및 이동하고 파일 이름을 바꾸는 작업은 대상과 원본을 사용합니다. 대상은 파일 연결 관리자나 변수를 사용하여 지정합니다. 대상 파일 및 디렉터리 덮어쓰기를 허용하도록 파일 시스템 작업 작업을 구성할 수 있습니다. 지정된 이름을 가진 디렉터리가 이미 존재할 경우 실패하는 대신에 해당 디렉터리를 사용하도록 새 디렉터리를 만드는 작업을 구성할 수 있습니다.

미리 정의된 파일 시스템 작업

파일 시스템 태스크에는 미리 정의된 작업 집합이 포함됩니다. 다음 표에서는 이러한 작업을 설명합니다.

연산 설명
디렉터리 복사 폴더를 다른 위치에 복사합니다.
파일 복사 파일을 다른 위치에 복사합니다.
디렉터리 만들기 지정된 위치에 폴더를 만듭니다.
디렉터리 삭제 지정한 위치의 폴더를 삭제합니다.
디렉터리 내용 삭제 폴더의 모든 파일과 폴더를 삭제합니다.
파일 삭제 지정한 위치의 파일을 삭제합니다.
디렉터리 이동 폴더를 다른 위치로 이동합니다.
파일 이동 파일을 다른 위치로 이동합니다.
파일 이름 바꾸기 지정한 위치의 파일 이름을 바꿉니다.
특성 설정 파일과 폴더의 특성을 설정합니다. 특성에는 Archive, Hidden, Normal, ReadOnly, System이 포함됩니다. Normal은 특성의 부족이며 다른 특성과 결합할 수 없습니다. 그 외 다른 특성은 조합에서 사용할 수 있습니다.

파일 시스템 태스크는 단일 파일 또는 디렉터리에서 작동합니다. 따라서 이 태스크는 와일드카드 문자를 사용하여 여러 파일에 대해 동일한 작업을 수행하는 것을 지원하지 않습니다. 파일 시스템 태스크가 여러 파일 또는 디렉터리에 대해 작업을 반복하도록 하려면 다음 단계에 설명된 대로 파일 시스템 태스크를 Foreach 루프 컨테이너에 배치합니다.

  • Foreach 루프 컨테이너 구성 Foreach 루프 편집기의 컬렉션 페이지에서 열거자를 Foreach File 열거자 로 설정하고 와일드카드 식을 파일에 대한 열거자 구성으로 입력하십시오. Foreach 루프 편집기의 변수 매핑 페이지에서 파일 이름을 한 번에 하나씩 파일 시스템 작업에 전달하는 데 사용할 변수를 매핑합니다.

  • 파일 시스템 태스크 추가 및 구성 파일 시스템 태스크를 Foreach 루프 컨테이너에 추가합니다. 파일 시스템 태스크 편집기의 일반 페이지에서 SourceVariable 또는 DestinationVariable 속성을 Foreach 루프 컨테이너에 정의한 변수로 설정합니다.

파일 시스템 태스크에 사용할 수 있는 사용자 지정 로그 항목

다음 표에서는 파일 시스템 태스크에 대한 사용자 지정 로그 항목을 설명합니다. 자세한 내용은 SSIS(Integration Services) 로깅을 참조하세요.

로그 항목 설명
FileSystemOperation 태스크를 수행하는 작업을 보고합니다. 로그 항목은 파일 시스템 작업이 시작될 때 작성되며 원본 및 대상에 대한 정보를 포함합니다.

파일 시스템 태스크 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

SSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용은 다음 항목을 참조하세요.

SSIS 디자이너에서 이러한 속성을 설정하는 방법은 다음 주제를 참조하세요.

이러한 속성을 프로그래밍 방식으로 설정하는 방법에 대한 자세한 내용은 다음 항목을 참조하세요.

Integration Services에는 데이터 파일을 다운로드 및 업로드하고 서버의 디렉터리를 관리하는 태스크가 있습니다. 자세한 내용은 FTP 작업을 참조하세요.

파일 시스템 태스크 편집기(일반 페이지)

파일 시스템 태스크 편집기 대화 상자의 일반 페이지를 사용하여 태스크가 수행하는 파일 시스템 작업을 구성합니다.

SourceConnection 및 DestinationConnection 속성을 설정하여 원본 및 대상 연결 관리자를 지정해야 합니다. 태스크에서 원본 또는 대상으로 사용하는 파일을 가리키는 파일 연결 관리자의 이름을 입력하거나 파일 경로가 변수에 저장되어 있는 경우 변수 이름을 입력할 수 있습니다. 변수를 사용하여 파일 경로를 저장하려면 먼저 원본 연결을 위한 IsSourcePathVariable 옵션 및 대상 연결을 위한 IsDestinationPatheVariable 옵션을 True로 설정해야 합니다. 그런 다음 사용할 기존 시스템 또는 사용자 정의 변수를 선택하거나 새 변수를 만들 수 있습니다. 변수 추가 대화 상자에서 변수의 범위를 구성하고 지정할 수 있습니다. 범위는 파일 시스템 태스크 또는 부모 컨테이너여야 합니다. 자세한 내용은 Integration Services(SSIS) 변수 및 패키지에서 변수 사용을 참조하세요.

참고 항목

SourceConnection 및 DestinationConnection 속성에 대해 선택한 변수를 재정의하려면 원본 및 대상 속성에 대한 식을 입력합니다. 파일 시스템 태스크 편집기 의 식페이지에 식을 입력합니다. 예를 들어 태스크에서 대상으로 사용하는 파일의 경로를 설정하려면 특정 조건에서 변수 A를 사용하고 다른 조건에서는 변수 B를 사용할 수 있습니다.

참고 항목

파일 시스템 태스크는 단일 파일 또는 디렉터리에서 작동합니다. 따라서 이 태스크는 와일드카드 문자를 사용하여 여러 파일 또는 디렉터리에 대해 동일한 작업을 수행하는 것을 지원하지 않습니다. 파일 시스템 태스크가 여러 파일 또는 디렉터리에 대해 작업을 반복하도록 하려면 파일 시스템 태스크를 Foreach 루프 컨테이너에 배치합니다. 자세한 내용은 파일 시스템 태스크를 참조하세요.

식을 사용하여 다른 변수를 사용할 수 있습니다.

옵션

IsDestinationPathVariable
대상 경로가 변수에 저장되는지 여부를 나타냅니다. 이 속성의 옵션은 다음 테이블에 나열되어 있습니다.

값 설명
True 대상 경로는 변수에 저장됩니다. 이 값을 선택하면 동적 옵션 DestinationVariable이 표시됩니다.
False 대상 경로는 파일 연결 관리자에서 지정됩니다. 이 값을 선택하면 동적 옵션 DestinationConnection이 표시됩니다.

OverwriteDestination
작업이 대상 디렉터리의 파일을 덮어쓸 수 있는지 여부를 지정합니다.

이름
파일 시스템 태스크에 사용할 고유 이름을 제공합니다. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.

설명
파일 시스템 태스크에 대한 설명을 입력합니다.

연산
수행할 파일 시스템 작업을 선택합니다. 이 속성의 옵션은 다음 테이블에 나열되어 있습니다.

값 설명
디렉터리 복사 디렉터리를 복사합니다. 이 값을 선택하면 원본 및 대상에 대한 동적 옵션이 표시됩니다.
파일 복사 파일을 복사합니다. 이 값을 선택하면 원본 및 대상에 대한 동적 옵션이 표시됩니다.
디렉터리 만들기 디렉터리 만들기 이 값을 선택하면 원본 및 대상 디렉터리에 대한 동적 옵션이 표시됩니다.
디렉터리 삭제 디렉터리를 삭제합니다. 이 값을 선택하면 원본에 대한 동적 옵션이 표시됩니다.
디렉터리 내용 삭제 디렉터리의 내용을 삭제합니다. 이 값을 선택하면 원본에 대한 동적 옵션이 표시됩니다.
파일 삭제 파일을 삭제합니다. 이 값을 선택하면 원본에 대한 동적 옵션이 표시됩니다.
디렉터리 이동 디렉터리를 이동합니다. 이 값을 선택하면 원본 및 대상에 대한 동적 옵션이 표시됩니다.
파일 이동 파일을 이동합니다. 이 값을 선택하면 원본 및 대상에 대한 동적 옵션이 표시됩니다. 파일을 이동할 때는 대상으로 제공하는 디렉터리 경로에 파일 이름을 포함하지 마세요.
파일 이름 바꾸기 파일 이름을 바꿉니다. 이 값을 선택하면 원본 및 대상에 대한 동적 옵션이 표시됩니다. 파일 이름을 바꾸는 경우 대상에 대해 제공하는 디렉터리 경로에 새 파일 이름을 포함합니다.
특성 설정 파일 또는 디렉터리의 특성을 설정합니다. 이 값을 선택하면 원본 및 작업에 대한 동적 옵션이 표시됩니다.

IsSourcePathVariable
대상 경로가 변수에 저장되는지 여부를 나타냅니다. 이 속성의 옵션은 다음 테이블에 나열되어 있습니다.

값 설명
True 대상 경로는 변수에 저장됩니다. 이 값을 선택하면 동적 옵션 SourceVariable이 표시됩니다.
False 대상 경로는 파일 연결 관리자에서 지정됩니다. 이 값을 선택하면 동적 옵션 DestinationVariable이 표시됩니다.

IsDestinationPathVariable 동적 옵션

IsDestinationPathVariable = True

DestinationVariable
목록에서 변수 이름을 선택하거나 <새 변수...>를 클릭하여 새 변수를 만듭니다.

관련 항목: Integration Services(SSIS) 변수, 변수 추가

IsDestinationPathVariable = False

DestinationConnection
목록에서 파일 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 새 연결 관리자를 만듭니다.

관련 주제: 파일 연결 관리자, 파일 연결 관리자 편집기

IsSourcePathVariable 동적 옵션

IsSourcePathVariable = True

SourceVariable
목록에서 변수 이름을 선택하거나 <새 변수...>를 클릭하여 새 변수를 만듭니다.

관련 항목: Integration Services(SSIS) 변수, 변수 추가

IsSourcePathVariable = False

SourceConnection
목록에서 파일 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 새 연결 관리자를 만듭니다.

관련 주제: 파일 연결 관리자

작업 동적 옵션

Operation = 특성 설정

숨겨짐
파일 또는 디렉터리가 표시되는지 여부를 나타냅니다.

읽기 전용
파일이 읽기 전용인지 여부를 나타냅니다.

보관
파일 또는 디렉터리의 기록 지원 여부를 나타냅니다.

시스템
파일이 운영 체제 파일인지 여부를 나타냅니다.

작업 = 디렉터리 만들기

UseDirectoryIfExists
디렉터리 만들기 작업에서 새 디렉터리를 만드는 대신 지정된 이름의 기존 디렉터리를 사용하는지 여부를 나타냅니다.

참고 항목

Integration Services 태스크
제어 흐름