FILEPROPERTY (Transact-SQL)

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.

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

    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.

Exemples

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 AdventureWorks2012;
GO
SELECT FILEPROPERTY('AdventureWorks2012_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)