Oracle BFILE 是只读外部文件引用，不存储二进制数据而仅保存指向操作系统文件的路径（需 DIRECTORY 对象），仅支持通过 DBMS_LOB.FILEOPEN 等 PL/SQL 过程读取，不可 INSERT/UPDATE；.NET 中须用 OracleBFile 类分块流式读取，绑定参数时必须指定 OracleType.BFile 并确保 DIRECTORY 和文件存在。
Oracle BFILE 是只读的外部文件引用
bfile 数据类型在 oracle 中不存储实际二进制内容，而是保存一个指向操作系统文件的路径引用（需配合 directory 对象）。这意味着你无法通过 insert 或 update 直接写入 bfile 字段，只能用 dbms_lob.fileopen 等 pl/sql 过程打开并读取——且仅限只读。任何尝试用 oraclecommand 执行 update table set bfile_col = :val 都会失败，错误信息类似 ora-22285: non-existent directory or file for fileopen operation。
- 必须提前在数据库中创建
DIRECTORY对象，例如：CREATE DIRECTORY MY_FILES AS '/u01/app/oracle/files'，并授予权限：GRANT READ ON DIRECTORY MY_FILES TO your_user - BFILE 值在 .NET 中对应
OracleBFile类型，不能用byte[]或Stream直接赋值 -
OracleBFile实例必须显式调用Open()和Close()，否则可能泄漏 OS 文件句柄
从 OracleDataReader 读取 BFILE 的正确姿势
用 OracleDataReader.GetValue() 拿到的是 byte[]，但这不是文件内容，而是空数组或引发异常；必须改用 GetOracleValue() 获取 OracleBFile 实例，再调用其 Read() 方法流式读取。
- 确保连接字符串启用 LOB 支持（ODP.NET 默认开启，但旧版
System.Data.OracleClient需确认） - 读取前检查
OracleBFile.IsNull，避免对 NULL BFILE 调用Open() - 不要一次性
Read()全量数据到内存——BFILE 可达 4 GB，应分块处理，例如每次读取 8192 字节 - 示例关键代码：
var bfile = reader.GetOracleValue(0) as OracleBFile;<br>if (!bfile.IsNull) {<br> bfile.Open();<br> using (var fs = File.Create("local_copy.bin")) {<br> var buffer = new byte[8192];<br> int read;<br> while ((read = bfile.Read(buffer, 0, buffer.Length)) > 0) {<br> fs.Write(buffer, 0, read);<br> }<br> }<br> bfile.Close();<br>}
绑定 BFILE 参数时只能传 OracleBFile 实例
向存储过程传递 BFILE 参数时，不能用 DbType.Object 或 DbType.AnsiString，必须指定 OracleType.BFile 并赋值为 OracleBFile 对象——且该对象必须已关联有效 DIRECTORY 名和文件名。
- 构造
OracleBFile需要三个参数：连接、DIRECTORY名（字符串）、文件名（字符串），例如：new OracleBFile(conn, "MY_FILES", "report.pdf") - 若传入的文件名在指定
DIRECTORY下不存在，执行时抛出ORA-22285 - 不支持用
OracleParameter.Value = null清空 BFILE 字段；BFILE 本身不可更新，只能通过 PL/SQL 过程重置为 NULL - 注意：
System.Data.OracleClient已被标记为弃用，新项目应迁移到 Oracle 官方 ODP.NET（Oracle.ManagedDataAccess），后者对 BFILE 的Open()/Read()行为更稳定
BFILE vs BLOB：别在备份场景误选 BFILE
BFILE 的核心代价是绕过数据库一致性机制——文件删了、权限变了、路径改了，Oracle 不知道，查询时才报错。而 BLOB 把数据全存库内，备份、复制、RAC 故障转移都自动覆盖。
- 适用 BFILE 的典型场景：日志归档文件、原始扫描图像、第三方系统生成的只读报告，且这些文件由独立运维流程管理
- 如果业务要求“数据库导出即包含全部数据”，或需要跨平台迁移，BFILE 会让 DBA 头疼——你得同步拷贝文件系统目录 + 数据库元数据
- 性能上，小数据量随机读（如取文件头 1KB）BFILE 更快；整文件读取或频繁访问，BLOB 的缓存和网络传输优化更优
- 最易忽略的一点：BFILE 的
DIRECTORY是数据库级对象，不同环境（开发/测试/生产）必须手动创建同名DIRECTORY并映射到各自路径，CI/CD 流水线里容易漏掉这步
