Partilhar via

  • Artigo

FILEPROPERTY (Transact-SQL)

Retorna o valor de propriedade de nome de arquivo especificado quando são especificados um nome de arquivo e nome de propriedade.

Ícone de vínculo de tópicoConvenções de sintaxe 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 de 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 = 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 name da exibição do catálogo sys.master_files ou sys.database_files.

Exemplos

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

USE AdventureWorks;
GO
SELECT FILEPROPERTY('AdventureWorks_Data', 'IsPrimaryFile')AS [Primary File];
GO

Conjunto de resultados.

Primary File 
-------------
1
(1 row(s) affected)