---
schema_version: "1"
id: 096ee81a0804042edb160ba0d911474b3cf90482806b2442ba3da7e806c6edb0
title: SFTP Connector を使用したファイルの読み取りの例
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/sftp-connector/2.0/sftp-read.md
canonical_url: https://docs.mulesoft.com/jp/sftp-connector/2.0/sftp-read
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 84d781ea8d742e86be7020a7f9e7d1fb85d1ac250c2ef495181f5725406e485b
description: MuleSoft Documentation Site
release: "2.0"
latest: false
---
# SFTP Connector を使用したファイルの読み取りの例

SFTP 用 Anypoint Connector (SFTP Connector) の ​**Read**​ 操作では、フローの任意の時点でファイルを読み取ることができます。この操作は、特定のパスのファイルを読み取り、次の属性が含まれる Mule メッセージを返します。

- ペイロードとしてのファイルのコンテンツ
- ファイルのメタデータをメッセージ属性内に含む。
- ファイルが存在しない場合、​`SFTP:ILLEGAL_PATH`​ エラーになる。
    
    この操作では、ディレクトリを読み取りません。

## [](#studio-で-read-操作を設定する)Studio で Read 操作を設定する

Studio で ​**Read**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`sftp`​」を検索し、​**\[Read\]**​ 操作を選択します。
2. **\[Read\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. 接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[General (一般)\]**​ タブで、​**\[File Path (ファイルパス)\]**​ 項目を、読み取るファイルのパスに設定します (例: `#[path]`​)。
6. **\[Advanced (詳細)\]**​ タブで、​**\[MIME Type (MIME タイプ)\]**​ 項目を ​`application/xml`​、​**\[Encoding (エンコード)\]**​ 項目を ​`ISO 10646/Unicode(UTF-8)`​ に設定します。

次のスクリーンショットは、​**Read**​ 操作の設定を示しています。

![Studio の Read 操作の設定](/mulesoft/current/ja-jp/sftp-connector/2.0/_images/sftp-read-operation.png)

Figure 1. Read 操作の設定

XML エディターでは、​`<sftp:read>`​ 設定は次のように記述されます。

```xml
<sftp:read path="#[path]"
  lock="true|false"
  outputEncoding="UTF-8"
  outputMimeType="application/xml" />
```

## [](#1-秒あたりのトランザクション)1 秒あたりのトランザクション

次の表では、SFTP Connector の各バージョンの ​**Read**​ 操作の 1 秒あたりの合計要求数 (TPS) と平均成功 TPS を比較しています。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コネクタバージョン</th>
<th class="tableblock halign-left valign-top">Mule Runtime Engine バージョン</th>
<th class="tableblock halign-left valign-top">v1.6.1 の合計要求数</th>
<th class="tableblock halign-left valign-top">v2.0.1 の合計要求数</th>
<th class="tableblock halign-left valign-top">v1.6.1 の平均成功 TPS</th>
<th class="tableblock halign-left valign-top">v2.0.0 の平均成功 TPS</th>
<th class="tableblock halign-left valign-top">非推奨 TPS パフォーマンスの割合</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.6.1 vs 2.0.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.4.1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">301,377.40</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">247,614.40</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1,674</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1,375.60</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-18</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">1.6.1 vs 2.0.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.5.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">326,915.80</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">247,296.20</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1,816</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1,374</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-24</p></td>
</tr>
</tbody>
</table>

## [](#mime-タイプおよび文字コード)MIME タイプおよび文字コード

各コネクタはファイルの MIME タイプをその拡張子から判別しようとします。​**MIME Type (MIME タイプ)**​ (​`outputMimeType`​) パラメーターを使用して強制的に MIME タイプを別の値に変更できます。

同じプロセスが文字コードでも機能します。デフォルトでは、コネクタは、Mule Runtime のデフォルトの文字コードがファイルの MIME タイプに一致するものとみなします。ただし、文字コードは ​**Encoding (エンコード)**​ (​`outputEncoding`​) パラメーターで設定できます。

## [](#mime-タイプが重要な理由)MIME タイプが重要な理由

ペイロードと他の値を生成する操作内に DataWeave 式を埋め込むことができます。適切な MIME タイプを設定することで、DataWeave は型を自動で割り当てることができるほか、適切な出力を生成できます。また、DataSense の機能を最大限活用することで、ユーザーエクスペリエンスが向上します。

## [](#ファイルロック)ファイルロック

FTP または SFTP ではファイルシステムレベルのロックができないため、同じ Mule アプリケーション内の他のフローからのみファイルを保護する Mule ロックを各操作で使用します。ファイルは外部システムからは保護されません。ただし、Mule アプリケーションがクラスターで実行されている場合、ロックは分散します。

次のいずれかの状況が発生した場合、ファイルロックは自動的にリリースされます。

- ファイルをロックしていた Mule フローが終了した
- ファイルのコンテンツが完全に読み取られた

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ファイルが他のユーザーによりすでにロックされている場合、コネクタはファイルをロック解除できず、​<code>FTP:FILE_LOCK</code>​ エラーが発生します。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [SFTP Connector の例](https://docs.mulesoft.com/jp/sftp-connector/2.0/sftp-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)