Share via


FILEPROPERTY (Transact-SQL)

Restituisce il valore di una proprietà di un file quando vengono indicati il nome di un file nel database corrente e il nome di una proprietà. Restituisce NULL per i file che non sono nel database corrente.

Icona di collegamento a un argomento Convenzioni 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). I valori possibili 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 AdventureWorks_Data nel database AdventureWorks.

USE AdventureWorks2012;
GO
SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];
GO

Set di risultati:

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

Vedere anche

Riferimento

FILEGROUPPROPERTY (Transact-SQL)

Funzioni per i metadati (Transact-SQL)

sp_spaceused (Transact-SQL)

sys.database_files (Transact-SQL)

sys.master_files (Transact-SQL)