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 pour les fichiers qui ne figurent pas dans la base de données active.

Conventions de la syntaxe Transact-SQL

Syntaxe

FILEPROPERTY ( file_name , property )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

file_name
Expression composée du nom du fichier associé à celui de la base de données actuelle dont les informations de propriété doivent être retournées. file_name est de type nchar(128).

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

Value Description Valeur retournée
IsReadOnly Groupe de fichiers en lecture seule. 1 = Vrai

0 = Faux

NULL = Entrée non valide.
IsPrimaryFile Le fichier est le fichier principal. 1 = Vrai

0 = Faux

NULL = Entrée non valide.
IsLogFile Le fichier est un fichier journal. 1 = Vrai

0 = Faux

NULL = Entrée non 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 name de la vue de catalogue sys.master_files ou sys.database_files.

Exemples

L’exemple suivant retourne la valeur de la propriété IsPrimaryFile pour le nom du fichier AdventureWorks_Data dans la base de données AdventureWorks2022.

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

Voici le jeu de résultats obtenu.

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

Voir aussi

FILEGROUPPROPERTY (Transact-SQL)
Fonctions de métadonnées (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)