در SQL Server می توانید از تابع FILEPROPERTY برای بازگرداندن مقدار Property برای یک فایل دیتابیس مشخص شده استفاده کنید. مقدار خروجی می تواند 1 یا 0 باشد(اگر ورودی نامعتبر باشد، در خروجی NULL دریافت خواهید کرد). برای این منظور به logical file name و property ای که در خروجی می خواهید آن را مشاهده کنید، باید به تابع FILEPROPERTY پاس دهید.


اسکریپت زیر، یک مثال ساده برای استفاده از تابع FILEPROPERTY می باشد:

USE WideWorldImporters;

SELECT FILEPROPERTY('WWI_Primary', 'SpaceUsed') AS Result;

+----------+

| Result   |

|----------|

| 1152     |

+----------+

Property مورد نظر، SpaceUsed می باشد که تعداد page های اختصاص یافته در فایل است. بنابراین، این مثال به ما می گوید که فایل WWI_Primary دارای 1152 page اختصاص یافته است. اگر Log File را بررسی کنیم، نتیجه متفاوتی را در خروجی دریافت خواهید کرد:

SELECT FILEPROPERTY('WWI_Log', 'SpaceUsed') AS Result;

+----------+

| Result   |

|----------|

| 14762    |

+----------+

اگر از نام فایل مطمئن نیستید ولی ID آن را می دانید، می توانید با استفاده از تابع FILE_NAME نام فایل را بر اساس ID آن برگردانید.

SELECT FILEPROPERTY(FILE_NAME(3), 'SpaceUsed') AS Result;

+----------+

| Result   |

|----------|

| 52872    |

+----------+

خروجی کوئری فوق را با مثال زیر هم می توانید دریافت کنید:

SELECT

  FILE_NAME(3) AS [File Name],

  FILEPROPERTY(FILE_NAME(3), 'SpaceUsed') AS [Space Used];

+--------------+--------------+

| File Name    | Space Used   |

|--------------+--------------|

| WWI_UserData | 52872        |

+--------------+--------------+

اگر فایل مشخص شده که به تابع FILEPROPERTY پاس می دهید، وجود نداشته باشد، مقدار Null را دریافت می کنید:

SELECT FILEPROPERTY('OOPS', 'SpaceUsed') AS Result;

+----------+

| Result   |

|----------|

| NULL     |

+----------+

وقتی نام فایل را صحیح وارد کنید ولی property را اشتباه درج کنید، باز هم خروجی NULL خواهد بود:

SELECT FILEPROPERTY('WWI_Log', 'Oops') AS Result;

+----------+

| Result   |

|----------|

| NULL     |

+----------+

FILEPROPERTY این چهار Property که در اسکریپت زیر مشاهده می کنید را می پذیرد و به این ترتیب شما هم به همین صورت می توانید از تابع مذکور و Property های مورد قبول آن استفاده کنید:

DECLARE @file_name varchar(50) = 'WWI_Log';

SELECT

  FILEPROPERTY(@file_name, 'IsReadOnly') AS IsReadOnly,

  FILEPROPERTY(@file_name, 'IsPrimaryFile') AS IsPrimaryFile,

  FILEPROPERTY(@file_name, 'IsLogFile') AS IsLogFile,

  FILEPROPERTY(@file_name, 'SpaceUsed') AS SpaceUsed;

+--------------+-----------------+-------------+-------------+

| IsReadOnly   | IsPrimaryFile   | IsLogFile   | SpaceUsed   |

|--------------+-----------------+-------------+-------------|

| 0            | 0               | 1           | 14763       |

+--------------+-----------------+-------------+-------------+