Share via


sp_helpfile (Transact-SQL)

Aplica-se a:SQL Server

Retorna os nomes físicos e os atributos de arquivos associados ao banco de dados atual. Use este procedimento armazenado para determinar os nomes de arquivos a serem anexados ou desanexados do servidor.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helpfile [ [ @filename = ] N'filename' ]
[ ; ]

Argumentos

@filename [ = ] N'nome do arquivo'

O nome lógico de qualquer arquivo no banco de dados atual. @filename é sysname, com um padrão de NULL. Se @filename não for especificado, os atributos de todos os arquivos no banco de dados atual serão retornados.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
name sysname Nome do arquivo lógico.
fileid smallint Identificador numérico do arquivo. Um valor não será retornado se @filename for especificado.
filename Ncar(260) Nome do arquivo físico.
filegroup sysname Grupo de arquivos ao qual o arquivo pertence.

NULL = Arquivo é um arquivo de log. Os arquivos de log nunca fazem parte de um grupo de arquivos.
size Nvarchar(15) Tamanho do arquivo em kilobytes.
maxsize Nvarchar(15) Tamanho máximo até o qual o arquivo pode crescer. Um valor de UNLIMITED nesse campo indica que o arquivo cresce até que o disco esteja cheio.
growth Nvarchar(15) Incremento de crescimento do arquivo. Esse valor indica a quantidade de espaço adicionado ao arquivo sempre que um novo espaço é necessário.

0 = O arquivo tem um tamanho fixo e não cresce.
usage varcar(9) Para o arquivo de dados, o valor é data only, e para o arquivo de log o valor é log only.

Permissões

Requer associação à função pública .

Exemplos

O exemplo a seguir retorna informações sobre os arquivos no AdventureWorks2022.

USE AdventureWorks2022;
GO
EXEC sp_helpfile;
GO