Partager via


FILEPROPERTY (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Retourne la valeur de propriété de nom de fichier spécifiée lorsqu'un nom de fichier dans la base de données active et un nom de propriété sont fournis. Retourne NULL les fichiers qui ne se trouvent pas dans la base de données active.

Conventions de la syntaxe Transact-SQL

Syntaxe

FILEPROPERTY ( file_name , property )

Les arguments

file_name

Expression qui contient le nom du fichier associé à la base de données active pour laquelle retourner les informations de propriété. file_name est de type nchar(128).

propriété

Expression qui contient le nom de la propriété de fichier à retourner. property est de type varchar(128) et peut prendre l’une des valeurs suivantes.

Valeur Descriptif Valeur retournée
IsReadOnly Le fichier est en lecture seule. 1 = Vrai
0 = Faux
NULL = L’entrée n’est pas valide.
IsPrimaryFile Le fichier est le fichier principal. 1 = Vrai
0 = Faux
NULL = L’entrée n’est pas valide.
IsLogFile Le fichier est un fichier journal. 1 = Vrai
0 = Faux
NULL = L’entrée n’est pas valide.
SpaceUsed Quantité d'espace occupé par le fichier spécifié. Nombre de pages allouées dans le fichier.

Types de retour

Int

Notes

file_name correspond à la colonne de nom dans l’affichage du catalogue ou sys.master_files du sys.database_files catalogue.

Exemples

L’exemple suivant renvoie le paramètre de la IsPrimaryFile propriété du AdventureWorks_Data nom du fichier dans AdventureWorks2025 la base de données.

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

Voici le jeu de résultats.

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