FILEPROPERTY(Transact-SQL)

적용 대상:SQL ServerAzure SQL Managed Instance

현재 데이터베이스의 파일 이름과 속성 이름이 지정되면 지정된 파일 이름 속성 값을 반환합니다. 현재 데이터베이스에 없는 파일에 대해서는 NULL을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

FILEPROPERTY ( file_name , property )  

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

file_name
속성 정보를 반환할 현재 데이터베이스에 관련된 파일 이름이 포함된 식입니다. file_namenchar (128)입니다.

property
반환할 파일 속성의 이름이 포함된 식입니다. 속성varchar(128)이며 다음 값 중 하나일 수 있습니다.

Description 반환 값
IsReadOnly 파일 그룹이 읽기 전용입니다. 1 = True

0 = False

NULL = 입력이 잘못되었습니다.
IsPrimaryFile 파일이 주 파일입니다. 1 = True

0 = False

NULL = 입력이 잘못되었습니다.
IsLogFile 파일이 로그 파일입니다. 1 = True

0 = False

NULL = 입력이 잘못되었습니다.
SpaceUsed 지정된 파일이 사용하는 공간의 크기입니다. 파일에 할당된 페이지 수

반환 형식

int

설명

file_namesys.master_files 또는 sys.database_files 카탈로그 뷰의 이름 열에 해당됩니다.

예제

다음 예제에서는 데이터베이스 AdventureWorks2022의 파일 이름에 대한 AdventureWorks_Data 속성 설정을 IsPrimaryFile 반환합니다.

SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile')AS [Primary File];  
GO  

결과 집합은 다음과 같습니다.

Primary File   
-------------  
1  
(1 row(s) affected)  

참고 항목

FILEGROUPPROPERTY(Transact-SQL)
메타데이터 함수(Transact-SQL)
sp_spaceused(Transact-SQL)
sys.database_files(Transact-SQL)
sys.master_files(Transact-SQL)