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)