【Node.js24.x】Object::fdatasync()メソッドの使い方

fdatasyncメソッドは、ファイルに書き込まれたデータが確実に物理ストレージへ同期されることを実行するメソッドです。通常、オペレーティングシステムはファイルへの書き込み操作を効率化するため、データを一時的にメモリ上のバッファに保持します。これにより、実際のディスクへの書き込みは遅延されたり、まとめて行われたりすることがあります。しかし、システムクラッシュや予期せぬ電源喪失が発生した場合、バッファ内のデータは失われ、ファイルの整合性が損なわれる可能性があります。

fdatasyncメソッドを使用すると、指定されたファイルのデータ部分がカーネルのバッファから物理ディスクへ強制的に書き込まれることを保証できます。このメソッドの大きな特徴は、ファイルのデータ内容のみを同期し、ファイルサイズや更新時刻といったメタデータ（付随情報）の同期は行わない点です。これにより、データの一貫性を確保しつつ、メタデータの同期が不要な場合には、メタデータも同期するfsyncメソッドと比較して、より高速に処理を完了できる可能性があります。

Node.jsのfsモジュールの一部として提供されており、データベースのトランザクションログの保存や、重要な設定ファイルの書き込みなど、データの永続性が非常に重要となるが、ファイル属性の更新は必須ではない場面で活用されます。システムの信頼性を高めるために重要な役割を果たすメソッドの一つです。

Copy
1import { open } from 'node:fs/promises';
2
3async function demonstrateFdatasync() {
4  let filehandle;
5  try {
6    // ファイルを開く（例: 既存ファイルを読み書きモードで開く）
7    filehandle = await open('path/to/your/file.txt', 'r+');
8
9    // ファイルディスクリプタのデータとメタデータを物理ストレージに同期
10    await filehandle.fdatasync();
11
12  } catch (error) {
13    // エラー処理
14    console.error('fdatasync中にエラーが発生しました:', error);
15  } finally {
16    // ファイルハンドルが開いている場合は必ず閉じる
17    if (filehandle) {
18      await filehandle.close();
19    }
20  }
21}

fd, callback

• fd: number: 同期したいファイルディスクリプタ
• callback: Function: 操作完了後に呼び出されるコールバック関数

戻り値なし

戻り値はありません