GetFileNamespacePath(Transact-SQL)
FileTable의 파일 또는 디렉터리에 대한 UNC 경로를 반환합니다.
구문
<column-name>.GetFileNamespacePath(is_full_path, @option)
인수
column-name
FileTable에 있는 VARBINARY(MAX) file_stream 열의 열 이름입니다.column-name 값은 유효한 열 이름이어야 합니다. 식이나 다른 데이터 형식의 열에서 변환 또는 캐스팅된 값은 사용할 수 없습니다.
is_full_path
상대 경로를 반환할지 절대 경로를 반환할지 지정하는 정수 식입니다. is_full_path에는 다음 값 중 하나를 사용할 수 있습니다.값
설명
0
데이터베이스 수준 디렉터리 내에서의 상대 경로를 반환합니다.
기본값입니다.
1
\\computer_name으로 시작하는 전체 UNC 경로를 반환합니다.
@option
경로에 있는 서버 구성 요소의 형식을 지정하는 방법을 정의하는 정수 식입니다. @option에는 다음 값 중 하나를 사용할 수 있습니다.값
설명
0
NetBIOS 형식으로 변환된 서버 이름을 반환합니다. 예를 들면 다음과 같습니다.
\\SERVERNAME\MSSQLSERVER\MyDocumentDB
기본값입니다.
1
서버 이름을 변환하지 않고 반환합니다. 예를 들면 다음과 같습니다.
\\ServerName\MSSQLSERVER\MyDocumentDB
2
전체 서버 경로를 반환합니다. 예를 들면 다음과 같습니다.
\\ServerName.MyDomain.com\MSSQLSERVER\MyDocumentDB
반환 형식
nvarchar(max)
SQL Server 인스턴스가 장애 조치(Failover) 클러스터에 클러스터된 경우 이 경로의 일부로 반환된 컴퓨터 이름은 클러스터형 인스턴스의 가상 호스트 이름입니다.
데이터베이스가 AlwaysOn 가용성 그룹에 속하는 경우 FileTableRootPath 함수가 컴퓨터 이름 대신 VNN(가상 네트워크 이름)을 반환합니다.
일반적인 주의
GetFileNamespacePath 함수가 반환하는 경로는 다음과 같은 형식의 논리 디렉터리 또는 파일 경로입니다.
\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\...
이 논리 경로는 물리적 NTFS 경로에 직접적으로 대응되지는 않습니다. 이 논리 경로는 FILESTREAM의 파일 시스템 필터 드라이버 및 FILESTREAM 에이전트에 의해 물리적 경로로 변환됩니다. 논리 경로와 물리적 경로를 구분하면 SQL Server에서 경로 유효성에 영향을 주지 않고 내부적으로 데이터를 다시 구성할 수 있습니다.
최선의 구현 방법
코드와 응용 프로그램을 현재 컴퓨터 및 데이터베이스 외에서도 사용할 수 있도록 하려면 코드를 작성할 때 절대 파일 경로를 사용하지 않는 것이 좋습니다. 대신 다음 예와 같이 FileTableRootPath 및 GetFileNamespacePath 함수를 함께 사용하여 런타임에 파일의 전체 경로를 가져옵니다. 기본적으로 GetFileNamespacePath 함수는 데이터베이스의 루트 경로 아래에 있는 파일의 상대 경로를 반환합니다.
USE MyDocumentDB;
@root varchar(100)
SELECT @root = FileTableRootPath();
@fullPath = varchar(1000);
SELECT @fullPath = @root + file_stream.GetFileNamespacePath() FROM DocumentStore
WHERE Name = N’document.docx’;
예
다음 예에서는 GetFileNamespacePath 함수를 호출하여 FileTable의 파일 또는 디렉터리에 대한 UNC 경로를 가져오는 방법을 보여 줍니다.
-- returns the relative path of the form “\MyFileTable\MyDocDirectory\document.docx”
SELECT file_stream.GetFileNamespacePath() AS FilePath FROM DocumentStore
WHERE Name = N’document.docx’;
-- returns “\\MyServer\MSSQLSERVER\MyDocumentDB\MyFileTable\MyDocDirectory\document.docx”
SELECT file_stream.GetFileNamespacePath(1, Null) AS FilePath FROM DocumentStore
WHERE Name = N’document.docx’;