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.
Aplica-se a: SQL Server (SQL Server 2008 à versão atual). |
.gif "Ícone de vínculo de tópico")
Convenções da 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 AdventureWorks2012.
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)