FTP 태스크FTP Task

FTP 태스크는 데이터 파일을 다운로드 및 업로드하고 서버의 디렉터리를 관리합니다.The FTP task downloads and uploads data files and manages directories on servers. 예를 들어 패키지는 Integration ServicesIntegration Services 패키지 워크플로의 일부로 원격 서버 또는 인터넷 위치에서 데이터 파일을 다운로드할 수 있습니다.For example, a package can download data files from a remote server or an Internet location as part of an Integration ServicesIntegration Services package workflow. FTP 태스크는 다음 용도로 사용할 수 있습니다.You can use the FTP task for the following purposes:

  • 데이터를 이동하고 변환을 데이터에 적용하기 전이나 후에 디렉터리 및 데이터 파일을 다른 디렉터리로 복사합니다.Copying directories and data files from one directory to another, before or after moving data, and applying transformations to the data.

  • 원본 FTP 위치에 로그인하고 파일 또는 패키지를 대상 디렉터리로 복사합니다.Logging in to a source FTP location and copying files or packages to a destination directory.

  • 데이터베이스에 데이터를 로드하기 전에 FTP 위치에서 파일을 다운로드하고 열 데이터에 변환을 적용합니다.Downloading files from an FTP location and applying transformations to column data before loading the data into a database.

    런타임 시 FTP 태스크는 FTP 연결 관리자를 사용하여 서버에 연결합니다.At run time, the FTP task connects to a server by using an FTP connection manager. FTP 연결 관리자는 FTP 태스크와 별도로 구성된 후 FTP 태스크에서 참조됩니다.The FTP connection manager is configured separately from the FTP task, and then is referenced in the FTP task. FTP 연결 관리자에는 서버 설정, FTP 서버 액세스를 위한 자격 증명, 제한 시간 및 서버 연결 다시 시도 횟수와 같은 옵션이 포함되어 있습니다.The FTP connection manager includes the server settings, the credentials for accessing the FTP server, and options such as the time-out and the number of retries for connecting to the server. 자세한 내용은 FTP 연결 관리자를 참조하세요.For more information, see FTP Connection Manager.

중요

FTP 연결 관리자는 익명 인증과 기본 인증만 지원하며The FTP connection manager supports only anonymous authentication and basic authentication. Windows 인증은 지원하지 않습니다.It does not support Windows Authentication.

로컬 파일이나 로컬 디렉터리에 액세스할 때 FTP 태스크는 파일 연결 관리자 또는 변수에 저장된 경로 정보를 사용합니다.When accessing a local file or a local directory, the FTP task uses a File connection manager or path information stored in a variable. 반면 원격 파일이나 원격 디렉터리에 액세스할 때는 직접 지정된 원격 서버의 경로, FTP 연결 관리자에 지정된 경로 또는 변수에 저장된 경로 정보를 사용합니다.In contrast, when accessing a remote file or a remote directory, the FTP task uses a directly specified path on the remote server, as specified in the FTP connection manager, or path information stored in a variable. 자세한 내용은 파일 연결 관리자Integration Services(SSIS) 변수를 참조하세요.For more information, see File Connection Manager and Integration Services (SSIS) Variables.

이는 FTP 태스크에서 여러 개의 파일을 받고 여러 개의 원격 파일을 삭제할 수 있다는 것을 의미합니다. 그러나 파일 연결 관리자는 하나의 파일만 액세스할 수 있기 때문에 연결 관리자를 사용할 경우 하나의 파일만 보내고 하나의 로컬 파일만 삭제할 수 있습니다.This means that the FTP task can receive multiple files and delete multiple remote files; but the task can send only one file and delete only one local file if it uses a connection manager, because a File connection manager can access only one file. 여러 개의 로컬 파일에 액세스하려면 FTP 태스크에 변수를 사용하여 경로 정보를 제공해야 합니다.To access multiple local files, the FTP task must use a variable to provide the path information. 예를 들어 "C:\Test\.txt"가 포함된 변수는 Test 디렉터리에서 .txt 확장명을 가진 모든 파일 삭제 또는 보내기를 지원하는 경로를 제공합니다.For example, a variable that contains "C:\Test\.txt" provides a path that supports deleting or sending all the files that have a .txt extension in the Test directory.

여러 개의 파일을 보내고 여러 개의 로컬 파일 및 디렉터리에 액세스하려면 Foreach 루프에 태스크를 포함하여 FTP 태스크를 여러 번 실행할 수도 있습니다.To send multiple files and access multiple local files and directories, you can also execute the FTP task multiple times by including the task in a Foreach Loop. Foreach 루프는 For Each File 열거자를 사용하여 디렉터리의 모든 파일을 열거할 수 있습니다.The Foreach Loop can enumerate across files in a directory using the For Each File enumerator. 자세한 내용은 Foreach Loop Container을 참조하세요.For more information, see Foreach Loop Container.

FTP 태스크는 경로에서 ?The FTP task supports the ? 및 *** 와일드카드 문자를 지원합니다.and *** wildcard characters in paths. 와일드카드 문자를 사용하면 태스크가 여러 개의 파일에 액세스할 수 있습니다.This lets the task access multiple files. 그러나 와일드카드 문자는 파일 이름을 지정하는 경로 부분에만 사용할 수 있습니다.However, you can use wildcard characters only in the part of the path that specifies the file name. 예를 들어 C:\MyDirectory\.txt는 유효한 경로지만 C:\*\MyText.txt는 유효한 경로가 아닙니다.For example, C:\MyDirectory\.txt is a valid path, but C:\*\MyText.txt is not.

작업 실패 시 파일 시스템 태스크를 중지하거나 ASCII 모드로 파일을 전송하도록 FTP 작업을 구성할 수 있습니다.The FTP operations can be configured to stop the File System task when the operation fails, or to transfer files in ASCII mode. 파일 복사본을 보내고 받는 작업은 대상 파일과 디렉터리를 덮어쓰도록 구성할 수 있습니다.The operations that send and receive files copy can be configured to overwrite destination files and directories.

미리 정의된 FTP 작업Predefined FTP Operations

FTP 태스크에는 미리 정의된 작업 집합이 포함되어 있습니다.The FTP task includes a predefined set of operations. 다음 표에서는 이러한 작업을 설명합니다.The following table describes these operations.

연산Operation DescriptionDescription
파일 보내기Send files 로컬 컴퓨터의 파일을 FTP 서버로 보냅니다.Sends a file from the local computer to the FTP server.
파일 받기Receive files FTP 서버의 파일을 로컬 컴퓨터에 저장합니다.Saves a file from the FTP server to the local computer.
로컬 디렉터리 만들기Create local directory 로컬 컴퓨터에 폴더를 만듭니다.Creates a folder on the local computer.
원격 디렉터리 만들기Create remote directory FTP 서버에 폴더를 만듭니다.Creates a folder on the FTP server.
로컬 디렉터리 제거Remove local directory 로컬 컴퓨터의 폴더를 삭제합니다.Deletes a folder on the local computer.
원격 디렉터리 제거Remove remote directory FTP 서버의 폴더를 삭제합니다.Deletes a folder on the FTP server.
로컬 파일 삭제Delete local files 로컬 컴퓨터의 파일을 삭제합니다.Deletes a file on the local computer.
원격 파일 삭제Delete remote files FTP 서버의 파일을 삭제합니다.Deletes a file on the FTP server.

FTP 태스크에 사용할 수 있는 사용자 지정 로그 항목Custom Log Entries Available on the FTP Task

다음 표에서는 FTP 태스크에 대한 사용자 지정 로그 항목을 나열합니다.The following table lists the custom log entries for the FTP task. 자세한 내용은 Integration Services(SSIS) 로깅을 참조하세요.For more information, see Integration Services (SSIS) Logging.

로그 항목Log entry DescriptionDescription
FTPConnectingToServerFTPConnectingToServer 태스크에서 FTP 서버에 대한 연결을 시작했음을 나타냅니다.Indicates that the task initiated a connection to the FTP server.
FTPOperationFTPOperation 태스크에서 수행하는 FTP 작업의 시작 부분과 유형을 보고합니다.Reports the beginning of and the type of FTP operation that the task performs.

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

SSISSSIS 디자이너에서 이러한 속성을 설정하는 방법에 대한 자세한 내용은 태스크 또는 컨테이너의 속성 설정을 참조하세요.For information about how to set these properties in SSISSSIS Designer, see Set the Properties of a Task or Container.

이러한 속성을 프로그래밍 방식으로 설정하는 방법에 대한 자세한 내용은 FtpTask를 참조하세요.For more information about programmatically setting these properties, see FtpTask.

FTP 태스크 편집기(일반 페이지)FTP Task Editor (General Page)

FTP 태스크 편집기 대화 상자의 일반 페이지를 사용하여 태스크가 통신하는 FTP 서버에 연결하는 FTP 연결 관리자를 지정할 수 있습니다.Use the General page of the FTP Task Editor dialog box to specify the FTP connection manager that connects to the FTP server that the task communicates with. 또한 FTP 태스크를 명명 및 설명할 수 있습니다.You can also name and describe the FTP task.

옵션Options

FtpConnectionFtpConnection
기존 FTP 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.Select an existing FTP connection manager, or click <New connection...> to create a connection manager.

중요

FTP 연결 관리자는 익명 인증과 기본 인증만 지원하며The FTP connection manager supports only anonymous authentication and basic authentication. Windows 인증은 지원하지 않습니다.It does not support Windows Authentication.

관련 항목: FTP Connection Manager, FTP Connection Manager EditorRelated Topics: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailureStopOnFailure
FTP 작업이 실패할 경우 FTP 태스크가 종료될지 여부를 나타냅니다.Indicate whether the FTP task terminates if an FTP operation fails.

이름Name
FTP 태스크에 사용할 고유 이름을 제공합니다.Provide a unique name for the FTP task. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.This name is used as the label in the task icon.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.Task names must be unique within a package.

DescriptionDescription
FTP 태스크에 대한 설명을 입력합니다.Type a description of the FTP task.

FTP 태스크 편집기(파일 전송 페이지)FTP Task Editor (File Transfer Page)

FTP 태스크 편집기 대화 상자의 파일 전송 페이지를 사용하여 태스크에서 수행할 FTP 작업을 구성할 수 있습니다.Use the File Transfer page of the FTP Task Editor dialog box to configure the FTP operation that the task performs.

옵션Options

IsRemotePathVariableIsRemotePathVariable
원격 경로가 변수에 저장되는지 여부를 나타냅니다.Indicate whether the remote path is stored in a variable. 이 속성의 옵션은 다음 표에 나열되어 있습니다.This property has the options listed in the following table.

ValueValue DescriptionDescription
TrueTrue 대상 경로가 변수에 저장됩니다.The destination path is stored in a variable. 이 값을 선택하면 동적 옵션 RemoteVariable이 표시됩니다.Selecting the value displays the dynamic option, RemoteVariable.
FalseFalse 파일 연결 관리자에서 대상 경로를 지정합니다.The destination path is specified in a File connection manager. 이 값을 선택하면 동적 옵션 RemotePath가 표시됩니다.Selecting the value displays the dynamic option, RemotePath.

OverwriteFileAtDestinationOverwriteFileAtDestination
대상 파일을 덮어쓸 수 있는지 여부를 지정합니다.Specify whether a file at the destination can be overwritten.

IsLocalPathVariableIsLocalPathVariable
로컬 경로가 변수에 저장되는지 여부를 나타냅니다.Indicate whether the local path is stored in a variable. 이 속성의 옵션은 다음 표에 나열되어 있습니다.This property has the options listed in the following table.

ValueValue DescriptionDescription
TrueTrue 대상 경로가 변수에 저장됩니다.The destination path is stored in a variable. 이 값을 선택하면 동적 옵션 LocalVariable이 표시됩니다.Selecting the value displays the dynamic option, LocalVariable.
FalseFalse 파일 연결 관리자에서 대상 경로를 지정합니다.The destination path is specified in a File connection manager. 이 값을 선택하면 동적 옵션 LocalPath가 표시됩니다.Selecting the value displays the dynamic option, LocalPath.

연산Operation
수행할 FTP 작업을 선택합니다.Select the FTP operation to perform. 이 속성의 옵션은 다음 표에 나열되어 있습니다.This property has the options listed in the following table.

ValueValue DescriptionDescription
파일 보내기Send files 파일을 보냅니다.Send files. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPathRemoteVariableRemotePath가 표시됩니다.Selecting this value displays the dynamic options, LocalVariable, LocalPathRemoteVariable and RemotePath.
파일 받기Receive files 파일을 받습니다.Receive files. 이 값을 선택하면 동적 옵션 LocalVariable, LocalPathRemoteVariableRemotePath가 표시됩니다.Selecting this value displays the dynamic options, LocalVariable, LocalPathRemoteVariable and RemotePath.
로컬 디렉터리 만들기Create local directory 로컬 디렉터리를 만듭니다.Create a local directory. 이 값을 선택하면 동적 옵션 LocalVariableLocalPath가 표시됩니다.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
원격 디렉터리 만들기Create remote directory 원격 디렉터리를 만듭니다.Create a remote directory. 이 값을 선택하면 동적 옵션 RemoteVariableRemotePath가 표시됩니다.Selecting this value displays the dynamic options, RemoteVariable and RemotelPath.
로컬 디렉터리 제거Remove local directory 로컬 디렉터리를 제거합니다.Removes a local directory. 이 값을 선택하면 동적 옵션 LocalVariableLocalPath가 표시됩니다.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
원격 디렉터리 제거Remove remote directory 원격 디렉터리를 제거합니다.Remove a remote directory. 이 값을 선택하면 동적 옵션 RemoteVariableRemotePath가 표시됩니다.Selecting this value displays the dynamic options, RemoteVariable and RemotePath.
로컬 파일 삭제Delete local files 로컬 파일을 삭제합니다.Delete local files. 이 값을 선택하면 동적 옵션 LocalVariableLocalPath가 표시됩니다.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
원격 파일 삭제Delete remote files 원격 파일을 삭제합니다.Delete remote files. 이 값을 선택하면 동적 옵션 RemoteVariableRemotePath가 표시됩니다.Selecting this value displays the dynamic options, RemoteVariable and RemotePath.

IsTransferASCIIIsTransferASCII
원격 FTP 서버와 파일을 주고 받을 때 ASCII 모드로 파일을 전송할지 여부를 나타냅니다.Indicate whether files transferred to and from the remote FTP server should be transferred in ASCII mode.

IsRemotePathVariable 동적 옵션IsRemotePathVariable Dynamic Options

IsRemotePathVariable = TrueIsRemotePathVariable = True

RemoteVariableRemoteVariable
기존 사용자 정의 변수를 선택하거나 <새 변수...>를 클릭하여 사용자 정의 변수를 만듭니다.Select an existing user-defined variable, or click <New variable...> to create a user-defined variable.

관련 항목: Integration Services(SSIS) 변수, 변수 추가Related Topics: Integration Services (SSIS) Variables, Add Variable

IsRemotePathVariable = FalseIsRemotePathVariable = False

RemotePathRemotePath
기존 FTP 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.Select an existing FTP connection manager, or click <New connection…> to create a connection manager.

관련 항목 FTP 연결 관리자, FTP 연결 관리자 편집기Related Topics: FTP Connection Manager, FTP Connection Manager Editor

IsLocalPathVariable 동적 옵션IsLocalPathVariable Dynamic Options

IsLocalPathVariable = TrueIsLocalPathVariable = True

LocalVariableLocalVariable
기존 사용자 정의 변수를 선택하거나 <새 변수...>를 클릭하여 변수를 만듭니다.Select an existing user-defined variable, or click <New variable...> to create a variable.

관련 항목: Integration Services(SSIS) 변수, 변수 추가Related Topics: Integration Services (SSIS) Variables, Add Variable

IsLocalPathVariable = FalseIsLocalPathVariable = False

LocalPathLocalPath
기존 파일 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 연결 관리자를 만듭니다.Select an existing File connection manager, or click <New connection…> to create a connection manager.

관련 항목: 플랫 파일 연결 관리자Related Topics: Flat File Connection Manager

관련 항목:See Also

Integration Services 태스크 Integration Services Tasks
제어 흐름Control Flow