FILEPROPERTY (Transact-SQL)

Artikel
12/22/2023

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

Sintaksis

FILEPROPERTY ( file_name , property )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

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

property
Adalah 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	Grup 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

Jenis Kembalian

int

Keterangan

file_name sesuai dengan kolom nama dalam tampilan katalog sys.master_files 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 adalah hasil yang ditetapkan.

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

Lihat Juga

FILEGROUPPROPERTY (Transact-SQL)
Fungsi Metadata (Transact-SQL)
sp_spaceused (T-SQL)
sys.database_files (Transact-SQL)
sys.master_files (T-SQL)