sp_helpfilegroup (Transact-SQL)
Retorna os nomes e os atributos de grupos de arquivos associados ao banco de dados atual.
Convençõ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. |
nome do arquivo |
nchar(260) |
O nome físico do arquivo que inclui o caminho de diretório. |
tamanho |
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 de um banco de dados
O exemplo a seguir retorna informações sobre os grupos de arquivos no banco de dados de exemplo AdventureWorks2012 .
USE AdventureWorks2012;
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 AdventureWorks2012 .
USE AdventureWorks2012;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO
Consulte também
Referência
Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)