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.

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