FILEPROPERTY (Transact-SQL)
Aplica-se a: 
SQL Server Instância Gerenciada de SQL do Azure
Retorna o valor de propriedade de nome de arquivo especificado quando são especificados um nome de arquivo no banco de dados atual e um nome de propriedade. Retorna NULL para arquivos que não estão no banco de dados atual.
Convenções de sintaxe de Transact-SQL
Sintaxe
FILEPROPERTY ( file_name , property )
Argumentos
file_name
É uma expressão que contém o nome do arquivo associado ao banco de dados atual para o qual retornar as informações de propriedade. file_name é nchar(128).
property
É uma expressão que contém o nome da propriedade do arquivo a ser retornada. property é varchar(128) e pode ser um dos valores a seguir.
| Valor | Descrição | Valor retornado |
|---|---|---|
| IsReadOnly | O grupo de arquivos é somente leitura. | 1 = True 0 = False NULL = A entrada não é válida. |
| IsPrimaryFile | Arquivo é o arquivo primário. | 1 = True 0 = False NULL = A entrada não é válida. |
| IsLogFile | Arquivo é um arquivo de log. | 1 = True 0 = False NULL = A entrada não é válida. |
| SpaceUsed | Quantidade de espaço usado pelo arquivo especificado. | Número de páginas alocadas no arquivo |
Tipos de retorno
int
Comentários
file_name corresponde à coluna name da exibição do catálogo sys.master_files ou sys.database_files.
Exemplos
O exemplo a seguir retorna a configuração da propriedade IsPrimaryFile para o nome de arquivo AdventureWorks_Data no banco de dados AdventureWorks2022.
SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile')AS [Primary File];
GO
Veja a seguir o conjunto de resultados.
Primary File
-------------
1
(1 row(s) affected)
Confira também
FILEGROUPPROPERTY (Transact-SQL)
funções de metadados (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)