Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:SQL Server
Instâ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