---
title: ファイル転送プロトコル（SFTP、FTPS）コネクタ構成ガイド
description: この記事では、ファイル転送プロトコルコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/ftp-connector/
---
## バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
* 最大リクエスト数：100,000
* 最古のリクエストからの最大時間：60分
* リクエストの最大サイズ：200 MB
## 構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。
コネクタを追加した後、以下の構成を構成します：
* **接続タイプ**：（必須）接続タイプを指定します。
* SFTP
* FTPS
* **ホスト**：（必須）リモートホストを指定します。
* **ユーザー名**：（必須）ユーザー名を指定します。
* **パスワード**：（必須）ユーザーパスワードを指定します。
* **ポート**：（オプション）ポートを指定します。ポートが指定されていない場合、以下のデフォルトポートが使用されます：
* SFTP：22
* FTPS：990
## アクション
| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| 全イベントデータ送信 | ✗ | ✓ |
| カスタムイベントデータ送信 | ✗ | ✓ |
| 全訪問データ送信 | ✓ | ✗ |
| カスタム訪問データ送信 | ✓ | ✗ |
| ログイベント送信 | ✗ | ✓ |
| 全ログイベント送信 | ✗ | ✓ |
アクションの名前を入力し、アクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
### 全イベントデータ送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名生成 | 有効にすると、配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用してファイル名が生成され、バッチングを崩さずに一意のファイル名が保証されます。日付型のファイルパスサフィックスエントリはファイル名から除外され、バッチバッファキーを安定させます。バッチ出力を少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
| ファイルパスサフィックス | 動的にファイルパスにサフィックスを追加する値をマッピングします。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| 既存のファイルを上書き | ファイルが既に存在する場合、現在のデータで上書きします。チェックされていない場合、データは追加されます。データを追加する場合、各ブロックはTealiumから送信されたデータを含む単一のJSONオブジェクトまたはCSV行の配列で構成されます。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |
#### バッチ構成
| **パラメータ** | **説明** |
| --- | --- |
| バッチの有効期間 | バッチアクションが送信される頻度を指定するための有効期間（TTL）を構成します。値は`1`から`60`の間で入力します。デフォルト：`15`。 |
| 最大ファイルサイズ | 最大非圧縮ファイルサイズをMBで構成します。値は`1`から`200`の間で構成します。デフォルト値は`90`です。 |
| 属性名を印刷 | デフォルトでは、オブジェクトデータのキーとして属性IDが使用されます。このオプションを選択して、代わりに属性名をキーとして使用します。属性の名前を変更すると、保存されたデータのキーがファイル間で異なる場合があり、一貫性が損なわれる可能性があります。 |
### カスタムイベントデータ送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名生成 | 有効にすると、配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用してファイル名が生成され、バッチングを崩さずに一意のファイル名が保証されます。日付型のファイルパスサフィックスエントリはファイル名から除外され、バッチバッファキーを安定させます。バッチ出力を少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
#### メッセージデータ
| **パラメータ** | **説明** |
| --- | --- |
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| ファイルパスサフィックス | 動的にファイルパスにサフィックスを追加する値をマッピングします。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| 既存のファイルを上書き | ファイルが既に存在する場合、現在のデータで上書きします。チェックされていない場合、データは追加されます。データを追加する場合、各ブロックはTealiumから送信されたデータを含む単一のJSONオブジェクトまたはCSV行の配列で構成されます。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |
#### バッチ構成
| **パラメータ** | **説明** |
| --- | --- |
| バッチの有効期間 | バッチアクションが送信される頻度を指定するための有効期間（TTL）を構成します。値は`1`から`60`の間で入力します。デフォルト：`15`。 |
| 最大ファイルサイズ | 最大非圧縮ファイルサイズをMBで構成します。値は`1`から`200`の間で構成します。デフォルト値は`90`です。 |
| テンプレート変数 | **テンプレート**のデータ入力としてテンプレート変数を提供します。
使用例については、[テンプレート変数ガイド](https://docs.tealium.com/ja/server-side/connectors/templates/template-variables/)を参照してください。
ドット表記でネストされたテンプレート変数に名前を付けます。例：`items.name`。
ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | メッセージデータで参照されるテンプレートを提供します。詳細については、[テンプレートガイド](https://docs.tealium.com/ja/server-side/connectors/templates/about/)を参照してください。
テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます。例：`{{SomeTemplateName}}`。 |
### 全訪問データ送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名生成 | 有効にすると、配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用してファイル名が生成され、バッチングを崩さずに一意のファイル名が保証されます。日付型のファイルパスサフィックスエントリはファイル名から除外され、バッチバッファキーを安定させます。バッチ出力を少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
| ファイルパスサフィックス | 動的にファイルパスにサフィックスを追加する値をマッピングします。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| 既存のファイルを上書き | ファイルが既に存在する場合、現在のデータで上書きします。チェックされていない場合、データは追加されます。データを追加する場合、各ブロックはTealiumから送信されたデータを含む単一のJSONオブジェクトまたはCSV行の配列で構成されます。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |
#### バッチ構成
| **パラメータ** | **説明** |
| --- | --- |
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための時間（TTL）を構成します。`1`から`60`の間の値を入力してください。デフォルト：`15`。 |
| 最大ファイルサイズ | 圧縮されていない最大ファイルサイズをMBで構成します。`1`から`200`の間の値を構成します。デフォルト値は`90`です。 |
| 属性名の印刷 | デフォルトでは、オブジェクトデータのキーとして属性IDが使用されます。このオプションを選択すると、キーとして属性名が使用されます。属性の名前を変更すると、保存されたデータのキーがファイル間で異なる可能性があり、一貫性が損なわれる可能性があります。 |
| 現在の訪問データを含む | 訪問データに現在の訪問データを含めます。 |
### カスタム訪問データの送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名を生成 | 有効にすると、ファイル名は配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用して生成され、バッチングを崩すことなく一意のファイル名を保証します。日付型のファイルパスサフィックスエントリは、バッチバッファキーを安定させるためにファイル名から除外されます。バッチ出力を多くの小さなファイルではなく、少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
#### メッセージデータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルパスサフィックス | 動的にファイルパスにサフィックスを追加するための値をマッピングします。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| 既存のファイルを上書き | ファイルが既に存在する場合、現在のデータで上書きします。チェックが外れている場合、データは追加されます。データを追加する場合、各ブロックはTealiumから送信されたデータを含む単一のJSONオブジェクトまたはCSV行の配列で構成されます。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |
#### バッチ構成
| **パラメータ** | **説明** |
| --- | --- |
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための時間（TTL）を構成します。`1`から`60`の間の値を入力してください。デフォルト：`15`。 |
| 最大ファイルサイズ | 圧縮されていない最大ファイルサイズを`MB`で構成します。`1`から`200`の間の値を構成します。デフォルト値は`90`です。 |
| テンプレート変数 | **テンプレート**のデータ入力としてテンプレート変数を提供します。
使用例については、[テンプレート変数ガイド](https://docs.tealium.com/ja/server-side/connectors/templates/template-variables/)を参照してください。
ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：`items.name`。
ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | メッセージデータで参照されるテンプレートを提供します。詳細については、[テンプレートガイド](https://docs.tealium.com/ja/server-side/connectors/templates/about/)を参照してください。
テンプレートは、サポートされているフィールドに名前で二重中括弧を使用して注入されます。例：`{{SomeTemplateName}}`。 |
### ログイベントの送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名を生成 | 有効にすると、ファイル名は配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用して生成され、バッチングを崩すことなく一意のファイル名を保証します。日付型のファイルパスサフィックスエントリは、バッチバッファキーを安定させるためにファイル名から除外されます。バッチ出力を多くの小さなファイルではなく、少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
#### メッセージデータ
| **パラメータ** | **説明** |
| --- | --- |
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| ファイルパスサフィックス | 動的にファイルパスにサフィックスを追加するための値をマッピングします。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| 既存のファイルを上書き | ファイルが既に存在する場合、現在のデータで上書きします。チェックが外れている場合、データは追加されます。データを追加する場合、各ブロックはTealiumから送信されたデータを含む単一のJSONオブジェクトまたはCSV行の配列で構成されます。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |
### ログイベント全体の送信
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| ファイルタイプ | ファイルタイプを指定します。可能な値：`CSV`または`JSON`。 |
| ファイルパス | データが追加されるファイルのパスを指定します。 |
| 配信時にファイル名を生成 | 有効にすると、ファイル名は配信（フラッシュ）時に処理タイムスタンプとパーティション識別子を使用して生成され、バッチングを崩すことなく一意のファイル名を保証します。日付型のファイルパスサフィックスエントリは、バッチバッファキーを安定させるためにファイル名から除外されます。バッチ出力を多くの小さなファイルではなく、少数の大きなファイルとして配信する必要がある場合にこのオプションを使用します。 |
| レコードサフィックス | 各レコードの末尾に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行（`\n`）。JSON形式のファイルにのみ適用されます。 |
| ファイルを圧縮 | gzipを使用してファイルを圧縮するように構成します。このオプションは、**既存のファイルを上書き**が`false`に構成されている場合は無視されます。 |