Работа с каталогами и путями в таблицах FileTable

Описывает структуру каталогов, в которой файлы хранятся в таблицах FileTable.

Как Работа с каталогами и путями в таблицах FileTable

Следующие 3 функции можно использовать для работы с каталогами FileTable в Transact-SQL:

Чтобы получить этот результат, выполните следующее. Воспользуйтесь этой функцией Получите корневой путь UNC для конкретной таблицы FileTable или для текущей базы данных. FileTableRootPath (Transact-SQL) Получите абсолютный или относительный путь UNC к файлу или каталогу в таблице FileTable. GetFileNamespacePath (Transact-SQL) Получите значение идентификатора path_locator для заданного файла или каталога в таблице FileTable, указав путь к нему. GetPathLocator (Transact-SQL)

Как Как использовать относительные пути для переносимого кода

Чтобы код и приложения были независимы от текущего компьютера и базы данных, следует избегать создания кода с использованием абсолютных путей. Вместо этого рекомендуется получать полный путь к файлу во время выполнения с помощью функций FileTableRootPath (Transact-SQL) и GetFileNamespacePath (Transact-SQL), как показано в приведенном ниже примере. По умолчанию функция GetFileNamespacePath возвращает относительный путь к файлу, находящемуся внутри корневого пути к базе данных.

Важные ограничения

ВАЖНО! Нельзя хранить более 15 уровней вложенных каталогов в каталоге FileTable. Если сохранено 15 уровней вложенных каталогов, каталог самого нижнего уровня не сможет содержать файлы, так как эти файлы представляют собой дополнительный уровень.

ВАЖНО! Файловая система NTFS поддерживает пути, намного превышающие ограничение в 260 символов, установленное в оболочке Windows и большинстве других функций Windows API. Поэтому можно создавать файлы в файловой иерархии FileTable с помощью Transact-SQL, которые нельзя будет просмотреть или открыть в Проводнике Windows и многих других приложениях Windows, поскольку полный путь превышает 260 символов. Однако с этими файлами вы можете продолжать работать с помощью инструкций Transact-SQL.

Полный путь к элементу, хранящемуся в таблице FileTable

Полный путь к файлу или каталогу, сохраненный в таблице FileTable, начинается со следующих элементов.

Общий ресурс с поддержкой доступа файлового ввода-вывода к данным FILESTREAM на уровне экземпляра SQL Server .

Имя DIRECTORY_NAME на уровне базы данных.

FILETABLE_DIRECTORY на уровне таблицы FileTable.

В итоге иерархия выглядит следующим образом.

\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\

Данная иерархия каталогов образует корень пространства имен файлов FileTable. В этой иерархии каталогов данные FILESTREAM для FileTable хранятся в виде файлов и в виде вложенных каталогов, которые также могут содержать файлы и вложенные каталоги.

Важно иметь в виду, что иерархия каталогов, созданная в общем ресурсе FILESTREAM на уровне экземпляра, является виртуальной иерархией каталогов. Иерархия хранится в базе данных SQL Server и не представлена физически в файловой системе NTFS. Все операции, осуществляющие доступ к файлам и каталогам в общем ресурсе FILESTREAM в таблицах FileTable, перехватываются и обрабатываются компонентом SQL Server , внедренным в файловую систему.

Семантика корневых каталогов на уровне экземпляра, базы данных и таблицы FileTable

Эта иерархия каталогов имеет следующую семантику.

Общий ресурс FILESTREAM на уровне экземпляра настраивается администратором и хранится в виде свойства сервера. Этот общий ресурс можно переименовать с помощью диспетчера конфигурации SQL Server . Операция переименования вступает в силу только после перезапуска сервера.

Параметр DIRECTORY_NAME уровня базы данных при создании базы данных по умолчанию имеет значение null. Администратор может задать или изменить это имя с помощью инструкции ALTER DATABASE . Это имя должно быть уникальным (при сравнении без учета регистра) в этом экземпляре.

Обычно имя FILETABLE_DIRECTORY указывается в составе инструкции CREATE TABLE при создании таблицы FileTable. Это имя можно изменить с помощью команды ALTER TABLE .

Эти корневые каталоги нельзя переименовать с помощью операций файлового ввода-вывода.

Эти корневые каталоги нельзя открыть с использованием дескрипторов файлов для монопольного доступа.

Столбец is_directory в схеме FileTable

В приведенной ниже таблице описывается взаимодействие между столбцом is_directory и столбцом file_stream , в котором находятся данные FILESTREAM в таблице FileTable.

is_directory значение file_stream значение Поведение FALSE NULL Это недопустимое сочетание, которое будет перехвачено системным ограничением. FALSE <value> Этот элемент представляет файл. TRUE NULL Этот элемент представляет каталог. TRUE <value> Это недопустимое сочетание, которое будет перехвачено системным ограничением.

Использование имен виртуальной сети для групп доступности AlwaysOn

Если база данных, содержащая данные FILESTREAM или FileTable, принадлежит группе доступности:

Функции FILESTREAM и FileTable принимают или возвращают имена виртуальной сети, а не имена компьютеров. Дополнительные сведения об этих функциях см. в разделе Функции Filestream и FileTable (Transact-SQL).

При осуществлении любого доступа к данным FILESTREAM или FileTable посредством API-интерфейса файловой системы будут использоваться имена виртуальной сети, а не имена компьютеров. Дополнительные сведения см. в разделе FILESTREAM и FileTable с группами доступности AlwaysOn (SQL Server).