Compartilhar via


FILEPROPERTY (Transact-SQL)

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 o NULL para arquivos que não estão no banco de dados atual.

Í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 de 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 AdventureWorks2008R2_Data no banco de dados AdventureWorks2008R2.

USE AdventureWorks2008R2;
GO
SELECT FILEPROPERTY('AdventureWorks2008R2_Data', 'IsPrimaryFile')AS [Primary File];
GO

Aqui está o conjunto de resultados.

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