sp_helpfilegroup (Transact-SQL)

Artigo
05/11/2023

Aplica-se a:SQL Server

Retorna os nomes e os atributos de grupos de arquivos associados ao banco de dados atual.

Sintaxe

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Argumentos

[ @filegroupname = ] 'name' É o nome lógico de qualquer grupo de arquivos no banco de dados atual. name é sysname, com um padrão de NULL. Se name 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 (êxito) ou 1 (falha)

Conjuntos 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 o nome 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.
Idarquivo	smallint	Identificador de arquivos numérico.
filename	nchar(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 UNLIMITED neste campo indica que o arquivo cresce até o disco ficar cheio.
growth	nvarchar(15)	Incremento de crescimento do arquivo. Isso indica a quantidade de espaço adicionada ao arquivo sempre que um novo espaço é necessário. 0 = Arquivo tem um tamanho fixo e não crescerá.

Permissões

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

Exemplos

a. Retornando todos os grupos de arquivos de 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. Retornando todos os arquivos de 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

Consulte Também

Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Arquivos e grupos de arquivos do banco de dados