FTP 工作

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

FTP 工作會下載和上傳資料檔以及管理伺服器上的目錄。 例如，套件可從遠端伺服器或網際網路位置下載資料檔，此工作可視為 Integration Services 套件工作流程的一部分。 您可將 FTP 工作用於下列用途：

  • 在移動資料之前或之後於目錄之間複製目錄和資料檔，以及將轉換套用至資料。

  • 登入來源 FTP 位置並複製檔案或封裝至目的地目錄。

  • 從 FTP 位置下載檔案，並在將資料載入資料庫之前，將轉換套用至資料行的資料。

在執行階段中，FTP 工作會使用 FTP 連接管理員連接到伺服器。 FTP 連接管理員會在 FTP 工作以外另行設定，然後在 FTP 中參考。 FTP 連接管理員包含伺服器設定、存取 FTP 伺服器的認證，以及一些選項如逾時和連接伺服器的重試次數。 如需詳細資訊，請參閱 FTP Connection Manager。

重要

FTP 連接管理員僅支援匿名驗證和基本驗證， 而不支援 Windows 驗證。

存取本機檔案或本機目錄時，FTP 工作會使用「檔案」連接管理員或變數中儲存的路徑資訊。 但 FTP 工作存取遠端檔案或遠端目錄時則相反，是使用遠端伺服器上直接指定的路徑 (如 FTP 連接管理員中所指定)，或變數中儲存的路徑資訊。 如需詳細資訊，請參閱檔案連線管理員和 Integration Services (SSIS) 變數。

這表示，FTP 工作可接收多個檔案和刪除多個遠端檔案；而如果此工作使用連接管理員，則只能傳送一個檔案且只能刪除一個本機檔案，因為「檔案」連接管理員只能存取一個檔案。 若要存取多個本機檔案，FTP 工作必須使用變數提供路徑資訊。 例如，變數如果含有 "C:\Test*.txt"，其提供的路徑便可支援刪除或傳送 [測試] 目錄中所有副檔名為 .txt 的檔案。

若要傳送多個檔案及存取多個本機檔案和目錄，您也可以將 FTP 工作加入「Foreach 迴圈」中，藉此多次執行 FTP 工作。 「Foreach 迴圈」可使用 For Each File 列舉值，於目錄中跨檔案列舉。 如需詳細資訊，請參閱 Foreach 迴圈容器＞。

FTP 工作支援在路徑中使用 ? 和 * 萬用字元。 如此即可讓工作存取多個檔案。 不過，您只能在指定檔名的路徑部分使用萬用字元。 例如，C:\MyDirectory\*.txt 是有效的路徑，而 C:\*\MyText.txt 則無效。

FTP 作業可設定成在作業失敗時停止「檔案系統」工作，或以 ASCII 模式傳送檔案。 傳送和接收檔案副本的作業可設定成覆寫目的地檔案和目錄。

預先定義的 FTP 作業

FTP 工作包括一組預先定義的作業。 下表描述這些作業。

作業 描述
傳送檔案 從本機電腦將檔案傳送到 FTP 伺服器。
接收檔案 從 FTP 伺服器將檔案儲存到本機電腦。
建立本機目錄 在本機電腦上建立資料夾。
建立遠端目錄 在 FTP 伺服器上建立資料夾。
移除本機目錄 刪除本機電腦上的資料夾。
移除遠端目錄 刪除 FTP 伺服器上的資料夾。
刪除本機檔案 刪除本機電腦上的檔案。
刪除遠端檔案 刪除 FTP 伺服器上的檔案。

FTP 工作上可用的自訂記錄項目

下表列出 FTP 工作的自訂記錄項目。 如需詳細資訊，請參閱 Integration Services (SSIS) 記錄。

記錄項目 描述
FTPConnectingToServer 指出工作已經起始與 FTP 伺服器的連接。
FTPOperation 報告工作執行之 FTP 作業的開始及其類型。

您可以透過 SSIS 設計師或以程式設計方式設定屬性。

如需如何在 SSIS 設計工具中設定這些屬性的詳細資訊，請參閱設定工作或容器的屬性。

如需以程式設計方式設定這些屬性的詳細資訊，請參閱 FtpTask。

FTP 工作編輯器 (一般頁面)

使用 [FTP 工作編輯器] 對話方塊的 [一般] 頁面，即可指定 FTP 連接管理員，以連接到工作進行通訊的 FTP 伺服器。 您也可以命名和描述 FTP 工作。

選項。

FtpConnection
選取現有的 FTP 連線管理員，或按一下 [新增連線...]<> 建立連線管理員。

重要

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 工作
控制流程