Udostępnij za pomocą


FILEPROPERTY (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Zwraca określoną wartość właściwości nazwy pliku, gdy określono nazwę pliku w bieżącej bazie danych i nazwę właściwości. Zwraca wartość NULL dla plików, które nie są w bieżącej bazie danych.

Transact-SQL konwencje składni

Składnia

FILEPROPERTY ( file_name , property )

Argumenty (w programowaniu)

file_name

Wyrażenie zawierające nazwę pliku skojarzonego z bieżącą bazą danych, dla której mają być zwracane informacje o właściwości. file_name to nchar(128).

właściwość

Wyrażenie zawierające nazwę właściwości pliku do zwrócenia. właściwośćjest varchar(128)i może być jedną z następujących wartości.

Wartość Opis Zwrócona wartość
IsReadOnly Plik jest tylko do odczytu. 1 = prawda
0 = Fałsz
NULL = dane wejściowe są nieprawidłowe.
IsPrimaryFile Plik jest plikiem podstawowym. 1 = prawda
0 = Fałsz
NULL = dane wejściowe są nieprawidłowe.
IsLogFile Plik jest plikiem dziennika. 1 = prawda
0 = Fałsz
NULL = dane wejściowe są nieprawidłowe.
SpaceUsed Ilość miejsca używanego przez określony plik. Liczba stron przydzielonych w pliku

Typy zwracane

Int

Uwagi

file_name odpowiada kolumnie nazwy w sys.master_files widoku katalogu lub sys.database_files .

Przykłady

Poniższy przykład zwraca ustawienie dla IsPrimaryFile właściwości dla AdventureWorks_Data nazwy pliku w bazie AdventureWorks2025.

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

Oto zestaw wyników.

Primary File
-------------
1