Документация iSZN

pkInstFileInt.sql

Внешние файлы

GetExtFileDirServerPath

FUNCTION GetExtFileDirServerPath(sRootDir VARCHAR2, sPathDelim VARCHAR2, rHash RAW) RETURN VARCHAR2 deterministic;

Описание

Возвращает путь к каталогу для внешнего файла экземпляра Системы.
Параметры:

  • sRootDir - корневой каталог для файлов экземпляра Системы (должен браться из настроек Системы);
  • sPathDelim - разделитель между каталогами в путях (зависит от ОС);
  • rHash - хеш-сумма файла

Если необходимые параметры не заданы, возникает exception.

GetExtFileDirectoryName

FUNCTION GetExtFileDirectoryName(rHash RAW) RETURN VARCHAR2;

Описание

Возвращает имя объекта DIRECTORY для внешнего файла с заданными свойствами.
Параметры:

  • rHash - контрольная сумма (SHA1) файла.

Если необходимые параметры не заданы, возникает exception.

GetExtFileName

FUNCTION GetExtFileName(iID PLS_INTEGER, rHash RAW) RETURN VARCHAR2;

Описание

Возвращает имя для внешнего файла с заданными свойствами.
Параметры:

  • iID - ID файла;
  • rHash - контрольная сумма (SHA1) файла.

Если необходимые параметры не заданы, возникает exception.

GetExtFileStorageInfo

PROCEDURE GetExtFileStorageInfo(iID PLS_INTEGER, rHash RAW, sDirectoryName OUT VARCHAR2, sFileName OUT VARCHAR2);

Описание

Определяет имя объекта DIRECTORY и имя файла для внешнего файла.
Входные параметры:

  • iID - ID файла;
  • rHash - хеш-сумма файла (SHA1).

Выходные параметры:

  • sDirectoryName - имя объекта DIRECTORY;
  • sFileName - имя файла в файловой системе сервера.

Если необходимые параметры не заданы, возникает exception.
Физическое наличие каталога и файла и привилегии пользователя не проверяются; функция только предоставляет
информацию, где должен храниться данный файл и как он должен называться.

GetExtFileStorageInfoEx

PROCEDURE GetExtFileStorageInfoEx(iID PLS_INTEGER, rHash RAW, sDirectoryName OUT VARCHAR2, sFileName OUT VARCHAR2, sFilePath OUT VARCHAR2);

Описание

Определяет расширенный набор информации для внешнего файла.
Входные параметры:

  • iID - ID файла;
  • rHash - хеш-сумма файла (SHA1).

Выходные параметры:

  • sDirectoryName - имя объекта DIRECTORY;
  • sFileName - имя файла в файловой системе сервера;
  • sFilePath - путь к файлу в файловой системе сервера.

Если необходимые параметры не заданы, возникает exception.
Физическое наличие каталога и файла и привилегии пользователя не проверяются; функция только предоставляет
информацию, где должен храниться данный файл и как он должен называться.

GetExternalFileName

FUNCTION GetExternalFileName(iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Описание

Возвращает полное имя внешнего файла (с путём) в файловой системе сервера.
Параметры:

  • iID - ID файла;
  • iStrict - определяет поведение при отсутствии файла.

Значение возвращается независимо от того, является ли файл внешним.
Если параметры внешнего хранения файлов не заданы, возникает exception, независимо от значения параметра iStrict.