FTP タスク

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

FTP タスクは、データ ファイルをダウンロードまたはアップロードし、サーバー上のディレクトリを管理します。 たとえば、パッケージは、リモート サーバーまたはインターネット サイトから、Integration Services パッケージ ワークフローの一部としてデータ ファイルをダウンロードできます。 FTP タスクは、次の目的で使用できます。

• データを移動し、変換をデータに適用する前または後で、あるディレクトリから別のディレクトリに、ディレクトリやデータ ファイルをコピーします。

• コピー元の FTP サイトにログインし、ファイルやパッケージをコピー先のディレクトリにコピーします。

• データをデータベースに読み込む前に、FTP サイトからファイルをダウンロードし、変換を列データに適用します。

実行時には、FTP タスクは FTP 接続マネージャーを使用してサーバーに接続します。 FTP 接続マネージャーは、FTP タスクとは別に構成され、FTP タスク内で参照されます。 FTP 接続マネージャーには、サーバーの設定、FTP サーバーへのアクセス資格情報、および、サーバーへの接続のタイムアウトや再試行回数などのオプションが含まれています。 詳細については、「 FTP 接続マネージャー」を参照してください。

ローカル ファイルまたはローカル ディレクトリにアクセスする場合、FTP タスクは、ファイル接続マネージャー、または変数に格納されたパス情報を使用します。 それに対し、リモート ファイルまたはリモート ディレクトリにアクセスする場合、FTP タスクは、FTP 接続マネージャーで直接指定されたリモート サーバーのパス、または変数に格納されたパス情報を使用します。 詳細については、「ファイル接続マネージャー」および「Integration Services (SSIS) の変数」を参照してください。

したがって、FTP タスクは複数のファイルを受信し、複数のリモート ファイルを削除できます。ただし、FTP タスクが接続マネージャーを使用している場合には、1 つのファイルのみを送信し、1 つのローカル ファイルのみを削除できます。ファイル接続マネージャーがアクセスできるのは 1 ファイルのみであるためです。 複数のローカル ファイルにアクセスするには、FTP タスクで変数を使用してパス情報を指定する必要があります。 たとえば、"C:\Test*42.txt" を含む変数は、Test ディレクトリ内で .txt 拡張子を持つすべてのファイルの削除または送信をサポートするパスを提供します。

複数のファイルを送信したり、複数のローカル ファイルまたはディレクトリにアクセスするには、Foreach ループに FTP タスクを含めて、複数回実行する方法もあります。 Foreach ループは、For Each File 列挙子を使用して、ディレクトリ内のファイル全体を列挙します。 詳細については、「 Foreach ループ コンテナー」を参照してください。

FTP タスクでは、パス内で ? および * ワイルドカード文字がサポートされます。 これによってタスクは複数のファイルにアクセスできます。 ただし、ワイルドカードが使用できるのは、パスのファイル名を指定する部分のみです。 たとえば、C:\MyDirectory\*.txt は有効なパスですが、C:\*\MyText.txt は無効なパスです。

操作に失敗した場合にファイル システムに関するタスクを停止したり、ファイルを ASCII モードで転送するように FTP 操作を構成できます。 ファイルのコピーを送受信する操作は、コピー先のファイルおよびディレクトリを上書きするように構成できます。

定義済みの FTP 操作

FTP タスクには、定義済みの操作のセットが含まれています。 次の表では、これらの操作について説明します。

FTP タスクで使用できるカスタム ログ エントリ

次の表は、FTP タスクのカスタム ログ エントリの一覧です。 詳細については、「 Integration Services (SSIS) のログ記録」を参照してください。

Related Tasks

プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。

これらのプロパティを SSIS デザイナーで設定する方法の詳細については、「タスクまたはコンテナーのプロパティを設定する」を参照してください。

プログラムによってこれらのプロパティを設定する方法の詳細については、「 FtpTask」を参照してください。

[FTP タスク エディター] ([全般] ページ)

[FTP タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、タスクの通信先の FTP サーバーに接続する FTP 接続マネージャーを指定できます。 また、FTP タスクの名前と説明を入力することもできます。

Options

[FtpConnection]
既存の FTP 接続マネージャーを選択するか、[新しい接続] をクリックして接続マネージャーを作成します。

関連トピック:FTP 接続マネージャー、FTP 接続マネージャー エディター

[StopOnFailure]
FTP 操作が失敗した場合に FTP タスクを終了するかどうかを示します。

名前
FTP タスクの一意な名前を指定します。 この名前は、タスク アイコンのラベルとして使用されます。

説明
FTP タスクの説明を入力します。

[FTP タスク エディター] ([ファイル転送] ページ)

[FTP タスク エディター] ダイアログ ボックスの [ファイル転送] ページを使用すると、タスクで実行される FTP 操作を構成できます。

Options

[IsRemotePathVariable]
リモート パスが変数に格納されているかどうかを表します。 このプロパティのオプションを次の表に示します。

[OverwriteFileAtDestination]
転送先でファイルを上書きできるかどうかを指定します。

[IsLocalPathVariable]
ローカル パスが変数に格納されているかどうかを表します。 このプロパティのオプションを次の表に示します。

操作
実行する FTP 操作を選択します。 このプロパティのオプションを次の表に示します。

[IsTransferASCII]
リモート FTP サーバーへ転送されるファイル、およびリモート 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 タスク
制御フロー