GetPathLocator (Transact-SQL)

Returns the path locator ID value for the specified file or directory in a FileTable.

Syntax

GetPathLocator(filenamespace_path)

Arguments

  • filenamespace_path
    A namespace path in the FileTable. The namespace path is of type nvarchar(max).

    When the database belongs to an AlwaysOn availability group, then the GetPathLocator function accepts the virtual network name (VNN) or the computer name.

Return Type

hierarchyid

General Remarks

For more information, see Work with Directories and Paths in FileTables.

Examples

You can use the GetPathLocator function when you are migrating files from a file server to a FileTable. In this scenario, you want to move the files into the FileTable, and then replace the original UNC path for each file with the FileTable UNC path. For a complete example, see Load Files into FileTables.

See Also

Concepts

Work with Directories and Paths in FileTables