フィルタ

フィルタのメカニズムを使用すると、エージェントは、データの読み取り、処理、および書き込みを実行できます。ファイルおよびパーセルのフィルタは、テキストデータおよびバイナリデータを読み取り、データの圧縮、データの暗号化、バイナリデータの書き込み、データの展開、データの復号化を実行できます。

エージェントは、パーセルと呼ばれるデータの塊を使用して、エージェント間のデータの読み取りおよび送信を行います。パーセルは、送信側エージェントがパーセルフィルタを適用する前、およびネットワーク経由で受信側エージェントにデータを送信する前に、送信側エージェントが読み取る未使用データです。パーセルのデフォルトサイズは、約 500 KB です。したがって、たとえば、10 MB のデータ転送処理には、20 パーセルの読み取りおよび送信を伴います。

転送時に、使用するフィルタおよび対応するフィルタオブジェクトを作成できます。または、定義済みのファイルおよびパーセルフィルタを複数使用することもできます。

有効な DTSCLI ファイルフィルタには次のタイプがあります。

ディレクトリフィルタ
暗号化フィルタ
ファイル属性フィルタ

ファイルフィルタを追加する場合、パーセルフィルタも必要な場合があります。ディレクトリを転送するには、ファイルフィルタを dtscli コマンドに追加する必要があります。ディレクトリフィルタを追加せずにディレクトリを転送しようとすると、以下のエラーメッセージが表示されます。

「入力データ <c:\dtstemp> error=<Permission denied> のオープンが失敗しました。」

有効な DTSCLI パーセルフィルタには、次のタイプがあります。

バイナリ（デフォルト）またはテキスト
圧縮
暗号化

使用される 2 つの主要なパーセルフィルタは、バイナリまたはテキストです。タイプの異なる 2 台のコンピュータ間（Windows と UNIX など）でテキストファイルを転送する場合は、テキストフィルタを使用します。これにより、テキスト形式が保持されます。それ以外の場合は、常にバイナリフィルタを使用します。

注：バイナリフィルタとテキストファイルは相互排他的です。転送は、テキストかバイナリのいずれかであり、両方はありません。

フィルタは通常、組み合わされて機能します。読み取りフィルタによって実行されたアクションの逆のアクションが、書き込みフィルタによって実行される必要があります。フィルタは以下の順序で適用されます。

ファイルの読み取り - ソースデータの読み取り時に、ファイル上で動作します。
パーセルの読み取り - ソースデータの読み取り時に、データのバッファ上で動作します。
パーセルの書き込み - 宛先データの書き込み時に、データのバッファ上で動作します。
パーセルの書き込み - 宛先データの書き込み時に、ファイル上で動作します

同じタイプのフィルタ（ファイルまたはパーセル）の読み取りは、コマンドラインで指定する場合と同じ順序で適用されます。同じタイプのフィルタの書き込みは、コマンドラインで指定する場合と反対の順序で適用されます。

また、DTS は、外部ファイルおよびパーセルフィルタをサポートします。

例：ディレクトリの転送

以下の例では、ディレクトリフィルタの短い形式を使用してディレクトリを転送します。
```
dtscli -agent ipath=Gold::c:\dtstemp 
```
```
"rpath=Silver::c:\dtstemp" 
"f_filters=dir"
```

以下の例では同じ操作を実行しますが、長い形式を使用しています。

dtscli -agent "ipath=Gold::c:\dtstemp"

"rpath=Silver::c:\dtstemp" 
"f_filters=DIRTREE_READ:DIRTREE_WRITE"
"p_filters=binary"

例：テキストとしてのファイルの転送

以下の例では、ファイルは Gold から Silver に、テキストフィルタおよび短い形式を使用して転送されます。
```
dtscli -agent "ipath=Gold::c:\dtstemp\file.src" 
```
```
"rpath=Silver::c:\dtstemp\file.dest" 
"p_filters=text"
```
以下の例では同じ操作を実行しますが、長い形式を使用しています。
```
dtscli -agent "ipath=Gold::c:\dtstemp\file.src" 
```
```
"rpath=Silver::c:\dtstemp\file.dest" 
"p_filters=TEXT_READ:TEXT_WRITE"
```
注：テキストファイルの転送にはテキストフィルタのみを使用します。

注：詳細については、「DTSCLI コマンドリファレンスガイド」を参照してください。