PathName(Transact-SQL)

FILESTREAM BLOB(Binary Large Object)의 경로를 반환합니다. OpenSqlFilestream API는 응용 프로그램이 Win32 API를 통해 BLOB 데이터 작업을 수행하는 데 사용할 수 있는 핸들을 이 경로를 사용하여 반환합니다. PathName은 읽기 전용입니다.

Transact-SQL 구문 표기 규칙

구문

column_name.PathName ( @option [ , use_replica_computer_name ] )

인수

• column_name
  varbinary(max) FILESTREAM 열의 열 이름입니다. column_name은 열 이름이어야 합니다. 식이나 CAST 또는 CONVERT 문의 결과일 수 없습니다.

  다른 모든 데이터 형식의 열 또는 FILESTREAM 저장소 특성이 없는 varbinary(max) 열 에 대해 PathName을 요청하면 쿼리 컴파일 시간 오류가 발생합니다.

• @option
  경로에 있는 서버 구성 요소의 형식을 지정하는 방법을 정의하는 정수 식입니다. @option은 다음 값 중 하나일 수 있습니다. 기본값은 0입니다.

  값	설명
  0	BIOS 형식으로 변환된 서버 이름을 반환합니다. 예를 들면 다음과 같습니다. \\SERVERNAME\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F19F7-38EA-4AB0-BB89-E6C545DBD3F9
  1	서버 이름을 변환하지 않고 반환합니다. 예를 들면 다음과 같습니다. \\ServerName\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F1
  2	전체 서버 경로를 반환합니다. 예를 들면 다음과 같습니다. \\ServerName.MyDomain.com\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F19F7-38EA-4AB0-BB89-E6C545DBD3F9

• use_replica_computer_name
  AlwaysOn 가용성 그룹에서 서버 이름을 반환하는 방법을 정의하는 비트 값입니다.

  데이터베이스가 AlwaysOn 가용성 그룹에 속하지 않으면 이 인수 값이 무시됩니다. 컴퓨터 이름은 항상 경로에 사용됩니다.

  데이터베이스가 AlwaysOn 가용성 그룹에 속할 경우 use_replica_computer_name 값은 PathName 함수의 출력에 다음과 같은 영향을 줍니다.

  값	설명
  지정 안 됨	함수가 경로에 VNN(가상 네트워크 이름)을 반환합니다.
  0	함수가 경로에 VNN(가상 네트워크 이름)을 반환합니다.
  1	함수가 경로에 컴퓨터 이름을 반환합니다.

반환 형식

nvarchar(max)

반환 값

반환되는 값은 BLOB의 정규화된 논리적 또는 NETBIOS 경로입니다. PathName은 IP 주소를 반환하지 않습니다. FILESTREAM BLOB가 만들어지지 않은 경우 NULL이 반환됩니다.

주의

ROWGUID 열은 PathName을 호출하는 모든 쿼리에 표시되어야 합니다.

FILESTREAM BLOB는 Transact-SQL을 사용해서만 만들 수 있습니다.

예

1.FILESTREAM BLOB의 경로 읽기

다음 예에서는 nvarchar(max) 변수에 PathName을 할당합니다.

DECLARE @PathName nvarchar(max)
SET @PathName = (
    SELECT TOP 1 photo.PathName()
    FROM dbo.Customer
    WHERE LastName = 'CustomerName'
    );

2.테이블에 FILESTREAM BLOB 경로 표시

다음 예에서는 3개의 FILESTREAM BLOB에 대한 경로를 만들고 표시합니다.

-- Create a FILESTREAM-enabled database.
-- The c:\data directory must exist.
CREATE DATABASE PathNameDB
ON
PRIMARY ( NAME = ArchX1,
    FILENAME = 'c:\data\archdatP1.mdf'),
FILEGROUP FileStreamGroup1 CONTAINS FILESTREAM( NAME = ArchX3,
    FILENAME = 'c:\data\filestreamP1')
LOG ON  ( NAME = ArchlogX1,
    FILENAME = 'c:\data\archlogP1.ldf');
GO

USE PathNameDB;
GO

-- Create a table, add some records, and
-- create the associated FILESTREAM
-- BLOB files.

CREATE TABLE TABLE1
    (
        ID int,
        RowGuidColumn UNIQUEIDENTIFIER
                      NOT NULL UNIQUE ROWGUIDCOL,
        FILESTREAMColumn varbinary(MAX) FILESTREAM
    );
GO

INSERT INTO TABLE1 VALUES(1, NEWID(), 0x00);
INSERT INTO TABLE1 VALUES(2, NEWID(), 0x00);
INSERT INTO TABLE1 VALUES(3, NEWID(), 0x00);
GO

SELECT FILESTREAMColumn.PathName() AS 'PathName' FROM TABLE1;

--Results
--PathName
------------------------------------------------------------------------------------------------------------
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\DD67C792-916E-4A76-8C8A-4A85DC5DB908
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\2907122B-2560-4CB9-86DC-FBE7ABA1843B
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\922BE0E0-CAB9-4403-90BF-945BD258E4BC
--
--(3 row(s) affected)
GO

--Drop the database to clean up.
USE MASTER
GO
DROP DATABASE PathNameDB

참고 항목

참조

GET_FILESTREAM_TRANSACTION_CONTEXT(Transact-SQL)

OpenSqlFilestream을 사용하여 FILESTREAM 데이터 액세스

개념

BLOB(Binary Large Object) 데이터(SQL Server)