Compartilhar via


FILEPROPERTY (Transact-SQL)

Aplica-se a:SQL ServerInstâ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 informações de propriedade. file_name é nchar(128).

propriedade

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

Valor Descrição Valor retornado
IsReadOnly O arquivo é somente leitura. 1 = Verdadeiro
0 = Falso
NULL = A entrada não é válida.
IsPrimaryFile Arquivo é o arquivo primário. 1 = Verdadeiro
0 = Falso
NULL = A entrada não é válida.
IsLogFile Arquivo é um arquivo de log. 1 = Verdadeiro
0 = Falso
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 de nome no modo de exibição ou sys.master_files catálogosys.database_files.

Exemplos

O exemplo a seguir retorna a configuração para a IsPrimaryFile propriedade do AdventureWorks_Data nome do arquivo no AdventureWorks2025, o banco de dados.

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

Veja a seguir o conjunto de resultados.

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