Partilhar via


sp_helpfilegroup (Transact-SQL)

Aplica-se a:SQL Server

Devolve os nomes e atributos dos grupos de ficheiros associados à base de dados atual.

Transact-SQL convenções de sintaxe

Sintaxe

sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]

Arguments

[ @filegroupname = ] N'nome do grupo de ficheiro'

@filegroupname é sysname, com um padrão de NULL.

O nome lógico de qualquer grupo de ficheiros na base de dados atual. @filegroupname é sysname, com um padrão de NULL. Se @filegroupname não for especificado, todos os grupos de ficheiros na base de dados atual são listados e apenas o primeiro conjunto de resultados mostrado na secção de Conjuntos de Resultados é exibido.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nome da coluna Tipo de dados Description
groupname sysname Nome do grupo de ficheiros.
groupid smallint Identificador numérico de grupo de ficheiros.
filecount int Número de ficheiros no grupo de ficheiros.

Se @filegroupname for especificado, uma linha para cada ficheiro do grupo de ficheiros é devolvida.

Nome da coluna Tipo de dados Description
file_in_group sysname Nome lógico do ficheiro no grupo de ficheiros.
fileid smallint Identificador numérico de ficheiro.
filename nchar(260) Nome físico do ficheiro, incluindo o caminho da diretoria.
size nvarchar(15) Tamanho do ficheiro em kilobytes.
maxsize nvarchar(15) Tamanho máximo do ficheiro.

Este é o tamanho máximo a que o ficheiro pode crescer. Um valor de UNLIMITED neste campo indica que o ficheiro cresce até o disco estar cheio.
growth nvarchar(15) Incremento de crescimento do ficheiro. Este valor indica a quantidade de espaço adicionada ao ficheiro sempre que é necessário novo espaço.

0 = Ficheiro tem um tamanho fixo e não cresce.

Permissions

Requer adesão à função pública de .

Examples

A. Devolver todos os grupos de ficheiros numa base de dados

O exemplo seguinte devolve informações sobre os grupos de ficheiros na AdventureWorks2025 base de dados de exemplo.

USE AdventureWorks2022;
GO

EXECUTE sp_helpfilegroup;
GO

B. Devolver todos os ficheiros num grupo de ficheiros

O exemplo seguinte devolve informações para todos os ficheiros do PRIMARY grupo de ficheiros na AdventureWorks2025 base de dados de exemplo.

USE AdventureWorks2022;
GO

EXECUTE sp_helpfilegroup 'PRIMARY';
GO