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.

Icône Lien de rubriqueConventions 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.

Types de retour

int

Notes

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

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)