FILEPROPERTY (Transact-SQL)

Viene restituito il valore specificato di una proprietà di un file quando vengono indicati il nome di un file nel database corrente e il nome di una proprietà. Viene restituito il valore NULL per i file non contenuti nel database corrente.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

FILEPROPERTY (file_name ,property )

Argomenti

  • file_name
    Espressione contenente il nome del file associato al database corrente per cui si desidera restituire le informazioni sulla proprietà. file_name è di tipo nchar(128).

  • property
    Espressione contenente il nome della proprietà del file da restituire. property è di tipo varchar(128) e i possibili valori sono i seguenti.

    Valore

    Descrizione

    Valore restituito

    IsReadOnly

    Filegroup di sola lettura.

    1 = True

    0 = False

    NULL = Input non valido.

    IsPrimaryFile

    File primario.

    1 = True

    0 = False

    NULL = Input non valido.

    IsLogFile

    File di log.

    1 = True

    0 = False

    NULL = Input non valido.

    SpaceUsed

    Quantità di spazio utilizzata dal file specificato.

    Numero di pagine allocate nel file

Tipi restituiti

int

Osservazioni

file_name corrisponde alla colonna name nella vista del catalogo sys.master_files o sys.database_files.

Esempi

Nell'esempio seguente viene restituita l'impostazione della proprietà IsPrimaryFile per il file AdventureWorks2008R2_Data nel database AdventureWorks2008R2.

USE AdventureWorks2008R2;
GO
SELECT FILEPROPERTY('AdventureWorks2008R2_Data', 'IsPrimaryFile')AS [Primary File];
GO

Set di risultati:

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