sp_helpfile (Transact-SQL)sp_helpfile (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retorna os nomes físicos e os atributos de arquivos associados ao banco de dados atual.Returns the physical names and attributes of files associated with the current database. Use este procedimento armazenado para determinar os nomes de arquivos a serem anexados ou desanexados do servidor.Use this stored procedure to determine the names of files to attach to or detach from the server.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
sp_helpfile [ [ @filename= ] 'name' ]  

ArgumentosArguments

[ @filename = ] 'name' É o nome lógico de qualquer arquivo no banco de dados atual.[ @filename = ] 'name' Is the logical name of any file in the current database. nome da está sysname, com um padrão NULL.name is sysname, with a default of NULL. Se nome não é especificado, os atributos de todos os arquivos de banco de dados atual serão retornados.If name is not specified, the attributes of all files in the current database are returned.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
namename sysnamesysname Nome do arquivo lógico.Logical file name.
fileidfileid smallintsmallint Identificador numérico do arquivo.Numeric identifier of the file. Não é retornada se nome for especificado .Is not returned if name is specified .
filenamefilename nchar(260)nchar(260) Nome do arquivo físico.Physical file name.
filegroupfilegroup sysnamesysname Grupo de arquivos ao qual o arquivo pertence.Filegroup in which the file belongs.

NULL = Ele é um arquivo de log.NULL = File is a log file. Ele nunca faz parte de um grupo de arquivos.This is never a part of a filegroup.
sizesize nvarchar(15)nvarchar(15) Tamanho do arquivo em kilobytes.File size in kilobytes.
maxsizemaxsize nvarchar(15)nvarchar(15) Tamanho máximo até o qual o arquivo pode crescer.Maximum size to which the file can grow. Um valor UNLIMITED neste campo indica que o arquivo cresce até o disco ficar cheio.A value of UNLIMITED in this field indicates that the file grows until the disk is full.
growthgrowth nvarchar(15)nvarchar(15) Incremento de crescimento do arquivo.Growth increment of the file. Ele indica a quantidade de espaço adicionada ao arquivo sempre que um novo espaço é necessário.This indicates the amount of space added to the file every time that new space is required.

0 = Arquivo tem um tamanho fixo e não crescerá.0 = File is a fixed size and will not grow.
Usousage varchar(9)varchar(9) Para o arquivo de dados, o valor será 'dados' e para o arquivo de log é o valor 'log apenas' .For data file, the value is 'data only' and for the log file the value is 'log only'.

PermissõesPermissions

Requer associação à função pública .Requires membership in the public role.

ExemplosExamples

O exemplo a seguir retorna informações sobre os arquivos no AdventureWorks2012AdventureWorks2012.The following example returns information about the files in AdventureWorks2012AdventureWorks2012.

USE AdventureWorks2012;  
GO  
EXEC sp_helpfile;  
GO  

Consulte tambémSee Also

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sp_helpfilegroup (Transact-SQL) sp_helpfilegroup (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL) sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL) sys.filegroups (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
Arquivos e grupos de arquivos do banco de dadosDatabase Files and Filegroups