sp_helpfilegroup (Transact-SQL)
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 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 AdventureWorks2008R2.
USE AdventureWorks2008R2;
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 AdventureWorks2008R2.
USE AdventureWorks2008R2;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO
Consulte também