# File Access プロファイラーモジュールのリファレンス

> Reference for the File Access module, which collects data about file activity in your application.

File Access プロファイラーモジュールは、Unity が実行する読み取りまたは書き込み操作の数や開いているファイルハンドルの数など、アプリケーションのファイルアクティビティに関する情報を表示します。このモジュールは、この情報を特定のフレームまたはキャプチャ内の全てのフレームについて表示できます。この情報を使用して、アプリケーションがファイル操作をどれだけ効率的に実行するかを確認できます。

File Access モジュールは、ビルドされたアプリケーションのフォルダー構造内、または Unity エディターでプロファイラーを実行する場合は Unity プロジェクトフォルダー内のファイル操作に関する情報をキャプチャできます。このモジュールは、失敗したファイル操作の情報は収集しません。ファイル操作が失敗した場合は、Unity がエラーを表示します。

このモジュールはデフォルトでは有効になっていません。File Access プロファイラーモジュールを有効にするには、[プロファイラーモジュールのアクティベート](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/modules-activate.md) を参照してください。

## チャートのカテゴリ

Profiler ウィンドウの上半分には、以下のカテゴリを含む File Access チャートが表示されます。

| **Chart**             | **説明**                                                                       |
| --------------------- | ---------------------------------------------------------------------------- |
| **Files Opened**      | このフレームの、ローカルファイルシステムで正常に開かれたファイルの合計数です。                                      |
| **Files Closed**      | このフレームの、ローカルファイルシステムで正常に閉じられたファイルの合計数です。                                     |
| **File Seeks**        | このフレームの、ローカルファイルシステムで実行されたファイルシーク操作の数です。ファイルシーク操作には、ファイルのコンテンツ内の検索が含まれます。    |
| **Reads in Flight**   | このフレーム中で進行中だった読み取り操作の合計数です。                                                  |
| **File Handles open** | このフレーム中の任意の時点で開かれていたファイルハンドルの合計数です。これには、Unity が同じフレーム内で開いたり閉じたりするファイルも含まれます。 |

## モジュール詳細ペインのツールバー

File Access プロファイラーモジュールでフレームを選択すると、モジュールの詳細ペインに、キャプチャ中に Unity がアクセスしたファイルに関する詳細情報が表示されます。ツールバーを使用して、以下の機能にアクセスします。

| **プロパティ**           |                  | **説明**                                                            |
| ------------------- | ---------------- | ----------------------------------------------------------------- |
| **View ドロップダウン**    |                  | ドロップダウンを使用して、データの表示を変更します。                                        |
|                     | **File Summary** | 選択したフレーム中に Unity がアクセスした各ファイルの全てのファイルアクティビティのサマリーを表示します。          |
|                     | **Accesses**     | データセット内の各ファイルアクセス操作を、発生した順に表示します。                                 |
| **Frame ドロップダウン**   |                  | ドロップダウンを使用して、ファイル情報を表示するフレーム数を選択します。                              |
|                     | **This Frame**   | 選択したフレームのファイルアクティビティのサマリーを表示します。                                  |
|                     | **All Frames**   | プロファイラーキャプチャの全てのフレームのファイルアクティビティのサマリーを表示します。                      |
| **Analyze Markers** |                  | このモジュールは、詳細ペインに自動入力しません。Analyze Markers ボタンを選択して、詳細ペインにデータを入力します。 |

## File Summary ビュー

File Summary ビューには、キャプチャ中に各ファイルに発生した全てのファイルアクセス操作のサマリーが表示されます。表中の 1 つのエントリーは、1 つのファイルに関する完全なサマリーを表します。

以下の表は、File Summary ビューの表で表示できる全ての統計情報を示しています。全ての統計情報の列がデフォルトで有効になっているわけではありません。列を有効または無効にするには、列ヘッダーが表示されている行のどこかを右クリックしてメニューを表示します。このメニューを使用して、各列の表示を有効または無効にします。

| **値**                      | **説明**                                                   |
| -------------------------- | -------------------------------------------------------- |
| **Filename**               | アクセスされたファイルの名前です。                                        |
| **Total Bytes Read**       | 選択されたフレーム中に Unity がこのファイルから読み取った情報の総バイト数です。              |
| **Read Access Time (ms)**  | 選択されたフレーム中に Unity がこのファイルからの読み取りに費やした合計時間です。             |
| **Access Count**           | 選択されたフレーム中に行われた、このファイルへのあらゆるタイプのアクセスの合計数です。              |
| **First Frame**            | Unity がこのファイルへのアクセスを行った最初のフレームです。                        |
| **Number of Frames**       | Unity がこのファイルへのアクセスを行ったフレームの合計数です。                       |
| **ID**                     | ファイルアクセスマーカーの実行順序を表すインデックスです。                            |
| **Read Bandwidth (MBps)**  | 選択されたフレーム中での、このファイルの読み取り操作の平均帯域幅 (単位: メガバイト/秒) です。       |
| **Open Count**             | 選択されたフレーム中の、このファイルに対する "開く" 操作の合計数です。                    |
| **Close Count**            | 選択されたフレーム中の、このファイルに対する "閉じる" 操作の合計数です。                   |
| **Read Count**             | 選択されたフレーム中の、このファイルに対する読み取り操作の合計数です。                      |
| **Write Count**            | 選択されたフレーム中の、このファイルに対する書き込み操作の合計数です。                      |
| **Seek Count**             | 選択されたフレーム中の、このファイルに対するファイルシーク操作の合計数です。                   |
| **Total Bytes Written**    | 選択されたフレーム中に Unity がこのファイルに書き込んだ総バイト数です。                  |
| **Write Bandwidth (MBps)** | 選択されたフレーム中での、このファイルへの書き込み操作の平均帯域幅 (単位: メガバイト/秒) です。      |
| **Open Access Time (ms)**  | 選択されたフレーム中に Unity がこのファイルを開く操作に費やした合計時間 (単位: ミリ秒) です。    |
| **Close Access Time (ms)** | 選択されたフレーム中に Unity がこのファイルを閉じる操作に費やした合計時間 (単位: ミリ秒) です。   |
| **Write Access Time (ms)** | 選択されたフレーム中に Unity がこのファイルへの書き込み操作に費やした合計時間 (単位: ミリ秒) です。 |
| **Total Access Time (ms)** | 選択したフレーム中に Unity がこのファイルへのアクセスに費やした合計時間 (単位: ミリ秒) です。    |

## Accesses ビュー

Accesses ビューには、キャプチャ内の各ファイルアクセス操作に関する詳細な情報が提供されます。プロファイラーの詳細ペインにある表の各エントリーは、1 つのファイルに対する 1 つのファイルアクセス操作を表します。以下の表には、Accesses ビューで表示可能な全ての列に関する説明が含まれています。

| **値**                        | **説明**                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------- |
| **人差し指**                     | Unity がアクセス操作を実行した順番を表す ID 番号です。                                                            |
| **Filename**                 | この操作中にアクセスされたファイルの名前です。ファイルパス全体を表示するには、ファイル名のエントリーにカーソルを合わせます。                              |
| **タイプ**                      | 実行されたアクセス操作のタイプです。これは、Open (開く)、Close (閉じる)、Seek (シーク)、Read (読み取り)、Write (書き込み) のいずれかになります。 |
| **Access Size**              | (読み取りまたは書き込みの) アクセス中に転送されたバイト数です。アクセスがファイルシークの場合は、サイズはデスティネーションのオフセットになります。                 |
| **Offset**                   | ファイルアクセスの (開始) オフセットです。                                                                     |
| **Duration (ms)**            | このアクセスの実行に費やされた時間 (単位: ミリ秒) です。                                                             |
| **Average Bandwidth (MBps)** | (アクセスタイプが読み取りだった場合の) このアクセスの平均帯域幅です。                                                        |
| **First Frame Index**        | このアクセスが開始されたフレームの ID です。                                                                    |
| **Frames**                   | このアクセスが行われた (目的の) フレームの合計数です。                                                               |
| **Thread**                   | このアクセスが発生したスレッドです。                                                                          |
| **Timestamp (ms)**           | プロファイラーのキャプチャの開始時間を基準とした、このアクセスの相対的な開始時間です。                                                 |

## コンテキストメニュー

任意のファイルアクセスマーカーを右クリックすると、データを別の形で表示する追加オプションのサブメニューが表示されます。利用可能なオプションは以下の通りです。

| **値**                                    | **説明**                                                                                                                     |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Show marker in timeline view**         | このマーカーを [CPU Usage Profiler](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/cpu/cpu.md) モジュールで開きます。 |
| **Go to the first frame of this marker** | マーカーがチャートに初めて表示されるフレームを選択します。マーカーが 1 つのフレームにしか表示されない場合は、このオプションは無効になります。                                                   |
| **Go to the last frame of this marker**  | このマーカーがチャートに最後に表示されるフレームを選択します。マーカーが 1 つのフレームにしか表示されない場合は、このオプションは無効になります。                                                 |
| **Filter the view to this file path**    | 検索バーに **Filename** 列の内容を入力して検索結果をフィルタリングします。                                                                               |

## 追加リソース

* [プロファイラーモジュールの概要](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/modules-introduction.md)
* [Profiler ウィンドウのリファレンス](/engine/6000.0/manual/analysis/profiler/window-reference.md)
* [パフォーマンスデータ収集の概要](/engine/6000.0/manual/analysis/profiler/collect-data/profiling-collect-data-introduction.md)