sp_helpfilegroup (Transact-SQL)sp_helpfilegroup (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 e os atributos de grupos de arquivos associados ao banco de dados atual.Returns the names and attributes of filegroups associated with the current database.

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

SintaxeSyntax

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]  

ArgumentosArguments

[ @filegroupname = ] 'name' É o nome lógico de qualquer grupo de arquivos de banco de dados atual.[ @filegroupname = ] 'name' Is the logical name of any filegroup 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 for especificado, todos os grupos de arquivos no banco de dados atual são listados e somente o primeiro conjunto de resultados mostrado na seção conjuntos de resultados é exibido.If name is not specified, all filegroups in the current database are listed and only the first result set shown in the Result Sets section is displayed.

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
groupnamegroupname sysnamesysname Nome do grupo de arquivos.Name of the filegroup.
groupidgroupid smallintsmallint Identificador de grupo de arquivos numérico.Numeric filegroup identifier.
filecountfilecount intint Número de arquivos no grupo de arquivos.Number of files in the filegroup.

Se nome é uma linha para cada arquivo no grupo de arquivos especificado, será retornada.If name is specified, one row for each file in the filegroup is returned.

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
file_in_groupfile_in_group sysnamesysname Nome lógico do arquivo no grupo de arquivos.Logical name of the file in the filegroup.
fileidfileid smallintsmallint Identificador de arquivos numérico.Numeric file identifier.
filenamefilename nchar(260)nchar(260) O nome físico do arquivo que inclui o caminho de diretório.Physical name of the file including the directory path.
sizesize nvarchar(15)nvarchar(15) Tamanho do arquivo em kilobytes.File size in kilobytes.
maxsizemaxsize nvarchar(15)nvarchar(15) Tamanho máximo do arquivo.Maximum size of the file.

É o tamanho máximo até o qual o arquivo pode crescer.This is the 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. Isso 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 new space is required.

0 = Arquivo tem um tamanho fixo e não crescerá.0 = File is a fixed size and will not grow.

PermissõesPermissions

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

ExemplosExamples

A.A. Retornando todos os grupos de arquivos de um banco de dadosReturning all filegroups in a database

O exemplo a seguir retorna informações sobre os grupos de arquivos no banco de dados de exemplo AdventureWorks2012AdventureWorks2012.The following example returns information about the filegroups in the AdventureWorks2012AdventureWorks2012 sample database.

USE AdventureWorks2012;  
GO  
EXEC sp_helpfilegroup;  
GO  

B.B. Retornando todos os arquivos de um grupo de arquivosReturning all files in a filegroup

O exemplo a seguir retorna informações para todos os arquivos no grupo de arquivos PRIMARY do banco de dados de exemplo AdventureWorks2012AdventureWorks2012.The following example returns information for all files in the PRIMARY filegroup in the AdventureWorks2012AdventureWorks2012 sample database.

USE AdventureWorks2012;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO  

Consulte tambémSee Also

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sp_helpfile (Transact-SQL) sp_helpfile (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