sp_helpfilegroup (Transact-SQL)
Aplica-se a: 
SQL Server
Retorna os nomes e os atributos de grupos de arquivos associados ao banco de dados atual.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]
Argumentos
@filegroupname [ = ] N'nome do grupo de arquivos'
@filegroupname é sysname, com um padrão de NULL.
O nome lógico de qualquer grupo de arquivos no banco de dados atual. @filegroupname é sysname, com um padrão de NULL. Se @filegroupname não for especificado, todos os grupos de arquivos no banco de dados atual serão listados e somente o primeiro conjunto de resultados mostrado na seção Conjuntos de Resultados será exibido.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
groupname |
sysname | Nome do grupo de arquivos. |
groupid |
smallint | Identificador de grupo de arquivos numérico. |
filecount |
int | Número de arquivos no grupo de arquivos. |
Se @filegroupname for especificado, uma linha para cada arquivo no grupo de arquivos será retornada.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
file_in_group |
sysname | Nome lógico do arquivo no grupo de arquivos. |
fileid |
smallint | Identificador de arquivos numérico. |
filename |
Número(260) | O nome físico do arquivo que inclui o caminho de diretório. |
size |
nvarchar(15) | Tamanho do arquivo em kilobytes. |
maxsize |
nvarchar(15) | Tamanho máximo do arquivo. É o tamanho máximo até o qual o arquivo pode crescer. Um valor de UNLIMITED neste 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 adicionada ao arquivo sempre que um novo espaço é necessário.0 = O arquivo tem um tamanho fixo e não cresce. |
Permissões
Requer associação à função pública .
Exemplos
R. Retornar todos os grupos de arquivos em um banco de dados
O exemplo a seguir retorna informações sobre os grupos de arquivos no banco de dados de exemplo AdventureWorks2022.
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO
B. Retornar todos os arquivos em um grupo de arquivos
O exemplo a seguir retorna informações para todos os arquivos no grupo de arquivos PRIMARY do banco de dados de exemplo AdventureWorks2022.
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO