BFILENAME

📖 Описание

Функция Oracle/PLSQL BFILENAME возвращает локатор BFILE, соответствующий физическому файлу на сервере базы данных.


🧩 Синтаксис

BFILENAME(directory, filename)

⚙️ Параметры и аргументы

directory — имя объекта DIRECTORY, который служит псевдонимом каталога серверной файловой системы. filename — имя файла в этом каталоге.

Имя DIRECTORY передаётся с учётом регистра в словаре данных: некавыченный идентификатор Oracle хранит в верхнем регистре. BFILENAME создаёт локатор, а не файл и не копию его содержимого в базе.


💻 Пример

Для учебной среды администратор заранее создаёт каталог /srv/oracle/workshop_media и размещает в нём файл clay-guide.png. Затем пользователь с нужными правами создаёт объект DIRECTORY:

CREATE DIRECTORY workshop_media AS '/srv/oracle/workshop_media';

CREATE DIRECTORY не создаёт каталог в ОС. Для чтения нужны права READ на объект и доступ процесса Oracle к файлу на уровне ОС.

SELECT BFILENAME('WORKSHOP_MEDIA', 'clay-guide.png') AS guide_file
FROM dual;

Результат — локатор BFILE; способ его отображения зависит от клиента. Строка WORKSHOP_MEDIA написана в верхнем регистре, потому что объект создан без двойных кавычек.

См. документацию Oracle: BFILENAME.

См. документацию Oracle: CREATE DIRECTORY.