sp_helpfilegroup (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

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 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 na seção Conjunto de Resultados será exibido.

Valores de 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 name 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

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. Ele 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 na função pública.

Exemplos

A. Retornando 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 AdventureWorks.

USE AdventureWorks;
GO
EXEC sp_helpfilegroup;
GO

B. Retornando 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 AdventureWorks.

USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO