導入
データベース管理の現場において、外部テキストファイルの内容を一括でテーブルに取り込みたいというニーズは少なくありません。MySQLのLOAD_FILE関数は、サーバー上のファイルを直接読み込み、その内容を文字列として取得できる強力な関数です。しかし、セキュリティ制限や設定値の影響を受けやすいため、正しく理解していないとエラーでつまずくことが多い機能でもあります。今回は、実務でスムーズに利用するためのポイントを解説します。
基礎知識
LOAD_FILE関数は、指定したパスのファイルを読み込み、その内容を文字列として返します。主な制限事項として、以下の3点が重要です。
1. max_allowed_packet: 読み込むファイルサイズがこの設定値を超えるとエラーになります。
2. secure_file_priv: セキュリティ保護のため、ファイルを読み込めるディレクトリはMySQL側で厳格に制限されています。
3. ファイル権限: MySQLサーバーが稼働しているOSユーザーに、対象ファイルへの読み取り権限が必要です。
実装/解決策
実務で利用する際は、まず環境変数の確認と調整が不可欠です。
1. ディレクトリ確認: `SHOW VARIABLES LIKE ‘secure_file_priv’;` を実行し、ファイル配置可能なディレクトリを特定します。
2. 権限設定: 指定ディレクトリにファイルを移動し、MySQLプロセスがアクセスできるよう権限を付与します。
3. サイズ確認: `SHOW VARIABLES LIKE ‘max_allowed_packet’;` で、読み込むファイルサイズが制限内か確認します。不足している場合は、設定ファイル（my.cnfやmy.ini）を修正しMySQLを再起動します。
サンプルプログラム
以下は、特定のテキストファイルの内容を読み込み、テーブルに格納する一連のSQL例です。
— 1. ファイル格納用テーブルの作成
CREATE TABLE imports (
id INT AUTO_INCREMENT PRIMARY KEY,
content TEXT,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
— 2. LOAD_FILE関数を使用してデータをテーブルに挿入
— ※パスはsecure_file_privで指定されたディレクトリ配下である必要があります
INSERT INTO imports (content)
VALUES (LOAD_FILE(‘/var/lib/mysql-files/data_import.txt’));
— 3. 実行結果の確認
SELECT FROM imports;
— 4. もし結果がNULLになる場合、ファイルパスや権限、secure_file_privの設定を再確認してください
— ファイルが存在しない、あるいは読み取り権限がない場合はNULLが返されます
応用・注意点
現場で最も陥りやすいのは、「ファイルは存在するのにNULLが返ってくる」というケースです。原因の多くは以下の通りです。
・OSレベルの権限: MySQLサーバーを実行しているOSユーザー（例: mysqlユーザー）が、対象のファイルやディレクトリにアクセスできるか確認してください。
・絶対パスの指定: LOAD_FILEには常にフルパスを指定してください。
・バイナリデータへの注意: LOAD_FILEは文字列を返すため、画像などのバイナリデータをそのまま扱う場合は、LOAD_FILEで読み込んだ後に適切にエンコードするか、あるいは専用のバイナリ取り込みツールを検討することをお勧めします。
セキュリティリスクを避けるため、secure_file_privの設定値は必ず確認し、不必要に広範なディレクトリを許可しないよう注意してください。
コメント