FILEPROPERTY (Transact-SQL)

Article
02/01/2025

S’applique à : SQL Server Azure 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

syntaxsql

FILEPROPERTY ( file_name , property )

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.

SQL

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

Voici le jeu de résultats.

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)

Partager via