When the BFILE extension is enabled, you can create a
DIRECTORY object. These objects are required
before you can store a pointer to a file in a
BFILE column.
DIRECTORY objects are stored
in a special table called BFILE_DIRECTORY.
This table is automatically created for you when it is needed.
You should not manually create this table.
You manage DIRECTORY objects using the
following SQL functions:
| BFILE_CREATE_DIRECTORY |
| BFILE_REPLACE_DIRECTORY |
| BFILE_DROP_DIRECTORY |
The following sections describe the SQL functions that you can use when the BFILE extension is enabled.
BFILE_CREATE_DIRECTORY(directory, path)
Creates a DIRECTORY object as a path.
The specified path must not already exist, or
Directory already exists
is returned.
BFILE_REPLACE_DIRECTORY(directory, path)
Replaces the named DIRECTORY object using the specified path.
If the object does not exist, Directory does not exist
is returned.
BFILE_DROP_DIRECTORY(directory)
Drops the named DIRECTORY object. If
the object does not exist,
Directory does not exist is returned.
BFILE_OPEN(column)
Extracts the directory and file names from the BFILE
locator, and then opens that file. On success, a BFILE
handle is returned. Otherwise, 0
is returned.
BFILE_READ(BFILE handle, amt, offset)
Reads at most amt data from the BFILE
handle, starting at offset. On success,
Data is returned. Otherwise,
0 is returned to indicate that no more
valid data is available.