FILEPROPERTY (Transact-SQL)

2025-06-06

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengembalikan nilai properti nama file yang ditentukan saat nama file dalam database saat ini dan nama properti ditentukan. Mengembalikan NULL untuk file yang tidak ada dalam database saat ini.

Konvensi sintaks transact-SQL

Sintaks

FILEPROPERTY ( file_name , property )

Argumen

file_name

Ekspresi yang berisi nama file yang terkait dengan database saat ini untuk mengembalikan informasi properti. file_name adalah nchar(128).

harta benda

Ekspresi yang berisi nama properti file yang akan dikembalikan. properti adalah varchar(128), dan bisa menjadi salah satu nilai berikut.

Nilai	Deskripsi	Nilai yang dikembalikan
`IsReadOnly`	File bersifat baca-saja.	1 = Benar 0 = False NULL = Input tidak valid.
`IsPrimaryFile`	File adalah file utama.	1 = Benar 0 = False NULL = Input tidak valid.
`IsLogFile`	File adalah file log.	1 = Benar 0 = False NULL = Input tidak valid.
`SpaceUsed`	Jumlah ruang yang digunakan oleh file yang ditentukan.	Jumlah halaman yang dialokasikan dalam file

Tipe pengembalian

Int

Keterangan

file_name sesuai dengan kolom nama dalam sys.master_files tampilan katalog atau sys.database_files .

Contoh

Contoh berikut mengembalikan pengaturan untuk IsPrimaryFile properti untuk AdventureWorks_Data nama file di AdventureWorks2022 database.

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

Berikut set hasilnya.

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

Bagikan melalui