FILEPROPERTY(Transact-SQL)
적용 대상: 
SQL Server Azure SQL Managed Instance
현재 데이터베이스의 파일 이름과 속성 이름이 지정되면 지정된 파일 이름 속성 값을 반환합니다. 현재 데이터베이스에 없는 파일에 대해서는 NULL을 반환합니다.
구문
FILEPROPERTY ( file_name , property )
인수
file_name
속성 정보를 반환할 현재 데이터베이스에 관련된 파일 이름이 포함된 식입니다. file_name은 nchar (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_name은 sys.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)