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

Ícone de vínculo de tópico Convençõ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 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 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 AdventureWorks_Data no banco de dados AdventureWorks.

USE AdventureWorks2012;
GO
SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];
GO

Aqui está o conjunto de resultados.

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

Consulte também

Referência

FILEGROUPPROPERTY (Transact-SQL)

funções de metadados (Transact-SQL)

sp_spaceused (Transact-SQL)

sys.database_files (Transact-SQL)

sys.master_files (Transact-SQL)