FILEPROPERTY (Transact-SQL)
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
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.
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)