Partilhar via


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