FILEPROPERTY (Transact-SQL)

Retourne la valeur de la propriété du nom de fichier spécifié lorsqu'un nom de fichier et un nom de propriété sont fournis.

Conventions de syntaxe de 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 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	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.

Notes

file_name correspond à la colonne name de l'affichage catalogue sys.master_files ou sys.database_files.

Types de retour

int

Exemple

Cet exemple retourne la valeur de la propriété IsPrimaryFile pour le nom du fichier AdventureWorks_Data dans la base de données AdventureWorks.

USE AdventureWorks;
GO
SELECT FILEPROPERTY('AdventureWorks_Data', 'IsPrimaryFile')AS [Primary File];
GO

Voici l'ensemble des résultats.

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

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005