A FileTable is a specialized user table that has a pre-defined and fixed schema. This schema stores FILESTREAM data, file and directory information, and file attributes. For information about the FileTable schema, see FileTable Schema.
You can create a new FileTable by using Transact-SQL or SQL Server Management Studio. Since a FileTable has a fixed schema, you do not have to specify a list of columns. The simple syntax for creating a FileTable lets you specify:
A directory name. In the FileTable folder hierarchy, this table-level directory becomes the child of the database directory specified at the database level, and the parent of the files or directories stored in the table.
The name of the collation to be used for file names in the Name column of the FileTable.
The names to be used for the 3 primary key and unique constraints that are automatically created.
How To: Create a FileTable
Create a FileTable by Using Transact-SQL
Create a FileTable by calling the CREATE TABLE (SQL Server) statement with the AS FileTable option. Since a FileTable has a fixed schema, you do not have to specify a list of columns. You can specify the following settings for the new FileTable:
FILETABLE_DIRECTORY. Specifies the directory that serves as the root directory for all the files and directories stored in the FileTable. This name should be unique among all the FileTable directory names in the database. Comparison for uniqueness is case-insensitive, regardless of the current collation settings.
This value has a data type of nvarchar(255) and uses a fixed collation of Latin1_General_CI_AS_KS_WS.
The directory name that you provide must comply with the requirements of the file system for a valid directory name.
This name should be unique among all the FileTable directory names in the database. Comparison for uniqueness is case-insensitive, regardless of the current collation settings.
If you do not provide a directory name when you create the FileTable, then the name of the FileTable itself is used as the directory name.
FILETABLE_COLLATE_FILENAME. Specifies the name of the collation to be applied to the Name column in the FileTable.
The specified collation must be case-insensitive to comply with Windows file naming semantics.
If you do not provide a value for FILETABLE_COLLATE_FILENAME, or you specify database_default, the column inherits the collation of the current database. If the current database collation is case-sensitive, an error is raised and the CREATE TABLE operation fails.
You can also specify the names to be used for the 3 primary key and unique constraints that are automatically created. If you do not provide names, then the system generates names as described later in this topic.
The following example creates a new FileTable and specifies user-defined values for both FILETABLE_DIRECTORY and FILETABLE_COLLATE_FILENAME.
CREATE TABLE DocumentStore AS FileTable
FileTable_Directory = 'DocumentTable',
FileTable_Collate_Filename = database_default
The following example also creates a new FileTable. Since user-defined values are not specified, the value of FILETABLE_DIRECTORY becomes the name of the FileTable, the value of FILETABLE_COLLATE_FILENAME becomes database_default, and the primary key and unique contraints receive system-generated names.
Create a FileTable by Using SQL Server Management Studio
In Object Explorer, expand the objects under the selected database, then right-click on the Tables folder, and then select New FileTable.
This option opens a new script window which contains a Transact-SQL script template that you can customize and run to create a FileTable. Use the Specify Values for Template Parameters option on the Query menu to customize the script easily.
Requirements and Restrictions for Creating a FileTable
You cannot alter an existing table to convert it into a FileTable.
The parent directory previously specified at the database level must have a non-null value. For information about specifying the database-level directory, see Enable the Prerequisites for FileTable.
A FileTable requires a valid FILESTREAM filegroup, since a FileTable contains a FILESTREAM column. You can optionally specify a valid FILESTREAM filegroup as part of the CREATE TABLE command for creating a FileTable. If you do not specify a filegroup, then the FileTable uses the default FILESTREAM filegroup for the database. If the database does not have a FILESTREAM filegroup, then an error is raised.
You cannot create a table constraint as part of a CREATE TABLE…AS FILETABLE statement. However you can add the constraint later by using an ALTER TABLE statement.
You cannot create a FileTable in the tempdb database or in any of the other system databases.
You cannot create a FileTable as a temporary table.
When you create a new FileTable, some system-defined indexes and constraints are also created. You cannot alter or drop these objects; they disappear only when the FileTable itself is dropped. To see the list of these objects, query the catalog view sys.filetable_system_defined_objects (Transact-SQL).
--View all objects for all filetables, unsorted
SELECT * FROM sys.filetable_system_defined_objects;
--View sorted list with friendly names
SELECT OBJECT_NAME(parent_object_id) AS 'FileTable', OBJECT_NAME(object_id) AS 'System-defined Object'
ORDER BY FileTable, 'System-defined Object';
Indexes that are created when you create a new FileTable
When you create a new FileTable, the following system-defined indexes are also created:
Primary Key, non-clustered
Constraints that are created when you create a new FileTable
When you create a new FileTable, the following system-defined constraints are also created:
Default constraints on the following columns:
The system-defined default constraints enforce default values for the specified columns.
The system-defined check constraints enforce the following requirements:
Valid file attributes.
Parent object must be a directory.
Namespace hierarchy is locked during file manipulation.
Naming convention for the system-defined constraints
The system-defined constaints described above are named in the format <constraintType>_<tablename>[_<columnname>]_<uniquifier> where:
<constraint_type> is CK (check constraint), DF (default constraint), FK (foreign key), PK (primary key), or UQ (unique constraint).
<uniquifier> is a system-generated string to make the name unique. This string may contain the FileTable name and a unique identifier.