Condividi tramite


FILEPROPERTY (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

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 si trovano nel database corrente.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

FILEPROPERTY ( file_name , property )

Argomenti

file_name

Espressione che contiene il nome del file associato al database corrente per cui restituire informazioni sulle proprietà. file_name è di tipo nchar(128).

proprietà

Espressione che contiene il nome della proprietà del file da restituire. property è di tipo varchar(128). I valori possibili sono riportati di seguito.

valore Descrizione Valore restituito
IsReadOnly Il file è di sola lettura. 1 = Vero
0 = Falso
NULL = L'input non è valido.
IsPrimaryFile File primario. 1 = Vero
0 = Falso
NULL = L'input non è valido.
IsLogFile File di log. 1 = Vero
0 = Falso
NULL = L'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 sys.master_files vista del catalogo o sys.database_files .

Esempi

Il seguente esempio restituisce l'impostazione per la IsPrimaryFile proprietà del AdventureWorks_Data nome file in AdventureWorks2025 nel database.

SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile') AS [Primary File];
GO

Il set di risultati è il seguente.

Primary File
-------------
1