다음을 통해 공유

FTP 태스크

  • 아티클

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

FTP 작업이 데이터 파일을 다운로드 및 업로드하고 서버의 디렉터리를 관리합니다. 예를 들어 패키지는 Integration Services 패키지 워크플로의 일부로 원격 서버 또는 인터넷 위치에서 데이터 파일을 다운로드할 수 있습니다. FTP 작업은 다음 용도로 사용할 수 있습니다.

  • 데이터를 이동하고 변환을 데이터에 적용하기 전이나 후에 디렉터리 및 데이터 파일을 다른 디렉터리로 복사합니다.

  • 원본 FTP 위치에 로그인하고 파일 또는 패키지를 대상 디렉터리로 복사합니다.

  • 데이터베이스에 데이터를 로드하기 전에 FTP 위치에서 파일을 다운로드하고 열 데이터에 변환을 적용합니다.

런타임에 FTP 작업은 FTP 연결 관리자를 사용하여 서버에 연결합니다. FTP 연결 관리자는 FTP 태스크와 별도로 구성된 후 FTP 태스크에서 참조됩니다. FTP 연결 관리자에는 서버 설정, FTP 서버에 액세스하기 위한 자격 증명을 비롯해 시간 제한 및 서버에 연결하기 위한 재시도 횟수와 같은 옵션이 포함됩니다. 자세한 내용은 FTP 연결 관리자를 참조하세요.

Important

FTP 연결 관리자는 익명 인증 및 기본 인증만 지원합니다. Windows 인증은 지원하지 않습니다.

로컬 파일 또는 로컬 디렉터리에 액세스할 때 FTP 작업은 변수에 저장된 파일 연결 관리자 또는 경로 정보를 사용합니다. 반면 원격 파일이나 원격 디렉터리에 액세스할 때는 직접 지정된 원격 서버의 경로, FTP 연결 관리자에 지정된 경로 또는 변수에 저장된 경로 정보를 사용합니다. 자세한 내용은 파일 연결 관리자 및 Integration Services(SSIS) 변수를 참조하세요.

이는 FTP 태스크에서 여러 개의 파일을 받고 여러 개의 원격 파일을 삭제할 수 있다는 것을 의미합니다. 그러나 파일 연결 관리자는 하나의 파일만 액세스할 수 있기 때문에 연결 관리자를 사용할 경우 하나의 파일만 보내고 하나의 로컬 파일만 삭제할 수 있습니다. 여러 로컬 파일에 액세스하려면 FTP 작업에서 변수를 사용하여 경로 정보를 제공해야 합니다. 예를 들어 "C:\Test*.txt"가 포함된 변수는 Test 디렉터리에서 .txt 확장명을 가진 모든 파일 삭제 또는 보내기를 지원하는 경로를 제공합니다.

여러 파일을 보내고 여러 로컬 파일 및 디렉터리에 액세스하려면 Foreach 루프에 작업을 포함하여 FTP 작업을 여러 번 실행할 수도 있습니다. Foreach 루프는 For Each File 열거자를 사용하여 디렉터리의 여러 파일을 열거할 수 있습니다. 자세한 내용은 Foreach 루프 컨테이너을 참조하십시오.

FTP 태스크는 경로에서 ? 및 * 와일드카드 문자를 지원합니다. 이렇게 하면 작업이 여러 파일에 액세스할 수 있습니다. 그러나 파일 이름을 지정하는 경로의 일부에서만 와일드카드 문자를 사용할 수 있습니다. 예를 들어 C:\MyDirectory\*.txt는 유효한 경로이지만 C:\*\MyText.txt는 유효하지 않습니다.

작업 실패 시 파일 시스템 태스크를 중지하거나 ASCII 모드로 파일을 전송하도록 FTP 작업을 구성할 수 있습니다. 파일 복사본을 보내고 받는 작업은 대상 파일과 디렉터리를 덮어쓰도록 구성할 수 있습니다.

미리 정의된 FTP 작업

FTP 작업에는 미리 정의된 작업 집합이 포함됩니다. 다음 표에서는 이러한 작업을 설명합니다.

연산 설명
파일 전송 로컬 컴퓨터의 파일을 FTP 서버로 보냅니다.
파일 받기 FTP 서버의 파일을 로컬 컴퓨터에 저장합니다.
로컬 디렉터리 만들기 로컬 컴퓨터에 폴더를 만듭니다.
원격 디렉터리 만들기 FTP 서버에 폴더를 만듭니다.
로컬 디렉터리 제거 로컬 컴퓨터의 폴더를 삭제합니다.
원격 디렉터리 제거 FTP 서버의 폴더를 삭제합니다.
로컬 파일 삭제 로컬 컴퓨터의 파일을 삭제합니다.
원격 파일 삭제 FTP 서버의 파일을 삭제합니다.

FTP 태스크에 사용할 수 있는 사용자 지정 로그 항목

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

로그 항목 설명
FTPConnectingToServer 태스크가 FTP 서버에 대한 연결을 시작했음을 나타냅니다.
FTPOperation 태스크에서 수행하는 FTP 작업의 시작 부분과 유형을 보고합니다.

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

SSIS 디자이너에서 이러한 속성을 설정하는 방법에 대한 자세한 내용은 태스크 또는 컨테이너의 속성 설정을 참조하세요.

이 서버 속성을 프로그래밍 방식으로 설정하는 방법에 대한 자세한 내용은 FtpTask를 참조하세요.

FTP 태스크 편집기(일반 페이지)

FTP 태스크 편집기 대화 상자의 일반 페이지를 사용하여 태스크가 통신하는 FTP 서버에 연결하는 FTP 연결 관리자를 지정할 수 있습니다. FTP 작업의 이름을 지정하고 설명할 수도 있습니다.

옵션

FtpConnection
기존 FTP 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.

Important

FTP 연결 관리자는 익명 인증 및 기본 인증만 지원합니다. Windows 인증은 지원하지 않습니다.

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

StopOnFailure
FTP 작업이 실패할 때 FTP 작업이 종료되는지 여부를 나타냅니다.

이름
FTP 작업에 사용할 고유 이름을 제공합니다. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.

참고

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

설명
FTP 작업에 대한 설명을 입력합니다.

FTP 작업 편집기(파일 전송 페이지)

FTP 작업 편집기 대화 상자의 파일 전송 페이지를 사용하여 작업이 수행하는 FTP 작업을 구성합니다.

옵션

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

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

OverwriteFileAtDestination
대상의 파일을 덮어쓸 수 있는지 여부를 지정합니다.

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

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

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

값 설명
파일 전송 파일을 보냅니다. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPathRemoteVariable, RemotePath가 표시됩니다.
파일 받기 파일을 받습니다. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPathRemoteVariable, RemotePath가 표시됩니다.
로컬 디렉터리 만들기 로컬 디렉터리를 만듭니다. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPath가 표시됩니다.
원격 디렉터리 만들기 원격 디렉터리를 만듭니다. 이 값을 선택하면 동적 옵션 RemoteVariable, RemotelPath가 표시됩니다.
로컬 디렉터리 제거 로컬 디렉터리를 제거합니다. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPath가 표시됩니다.
원격 디렉터리 제거 원격 디렉터리를 제거합니다. 이 값을 선택하면 동적 옵션 RemoteVariable 및 RemotePath가 표시됩니다.
로컬 파일 삭제 로컬 파일을 삭제합니다. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPath가 표시됩니다.
원격 파일 삭제 원격 파일을 삭제합니다. 이 값을 선택하면 동적 옵션 RemoteVariable 및 RemotePath가 표시됩니다.

IsTransferASCII
원격 FTP 서버와 파일을 주고 받을 때 ASCII 모드로 파일을 전송할지 여부를 나타냅니다.

IsRemotePathVariable 동적 옵션

IsRemotePathVariable = True

RemoteVariable
기존 사용자 정의 변수를 선택하거나 <새 변수...>를 클릭하여 사용자 정의 변수를 만듭니다.

관련 주제: Integration Services(SSIS) 변수, 변수 추가

IsRemotePathVariable = False

RemotePath
기존 FTP 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.

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

IsLocalPathVariable 동적 옵션

IsLocalPathVariable = True

LocalVariable
기존 사용자 정의 변수를 선택하거나 <새 변수...>를 클릭하여 변수를 만듭니다.

관련 주제: Integration Services(SSIS) 변수, 변수 추가

IsLocalPathVariable = False

LocalPath
기존 파일 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.

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

참고 항목

Integration Services 태스크
제어 흐름