FILEPROPERTY(Transact-SQL)

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Managed Instance

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

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

FILEPROPERTY ( file_name , property )  

참고

SQL Server 2014 이전 버전의 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 카탈로그 뷰의 이름 열에 해당됩니다.

예제

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

SELECT FILEPROPERTY('AdventureWorks2012_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)