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 = ] '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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de