FILEPROPERTY (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Retorna o valor da propriedade de nome de arquivo especificado quando um nome de arquivo no banco de dados atual e um nome de propriedade são especificados. Retorna NULL para arquivos que não estão no banco de dados atual.

Transact-SQL convenções de sintaxe

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 informações de propriedade. file_name é nchar(128).

propriedade

Uma expressão que contém o nome da propriedade de arquivo a ser retornada. propriedade é varchar(128) e pode ser um dos seguintes valores.

Valor	Descrição	Valor devolvido
IsReadOnly	O arquivo é somente leitura.	1 = Verdadeiro 0 = Falso NULL = A entrada não é válida.
IsPrimaryFile	Arquivo é o arquivo principal.	1 = Verdadeiro 0 = Falso NULL = A entrada não é válida.
IsLogFile	O ficheiro é um ficheiro de registo.	1 = Verdadeiro 0 = Falso NULL = A entrada não é válida.
SpaceUsed	Quantidade de espaço usada pelo arquivo especificado.	Número de páginas alocadas no arquivo

Tipos de devolução

Int

Observações

file_name corresponde à coluna de nome na sys.master_files visualização ou sys.database_files catálogo.

Exemplos

O exemplo seguinte devolve a definição para a IsPrimaryFile propriedade do AdventureWorks_Data nome do ficheiro no AdventureWorks2025, a base de dados.

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

Aqui está o conjunto de resultados.

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

Conteúdo relacionado

• FILEGROUPPROPERTY (Transact-SQL)
• Funções de metadados (Transact-SQL)
• sp_spaceused
• sys.database_files
• sys.master_files