FILEPROPERTY (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server Istanza 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 sono nel database corrente.

Convenzioni di sintassi Transact-SQL

Sintassi

FILEPROPERTY ( file_name , property )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

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 riportati di seguito.

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 IsPrimaryFile proprietà per il nome del AdventureWorks_Data file in AdventureWorks2022 del database.

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

Questo è il set di risultati.

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

Vedi anche

FILEGROUPPROPERTY (Transact-SQL)
Funzioni dei metadati (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)