sp_helpfilegroup (Transact-SQL)

Articolo
05/24/2023

Si applica a:SQL Server

Restituisce i nomi e gli attributi dei filegroup associati al database corrente.

Sintassi

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Argomenti

[ @filegroupname = ] 'name' Nome logico di qualsiasi filegroup nel database corrente. name è sysname, con valore predefinito NULL. Se il nome non viene specificato, vengono elencati tutti i filegroup nel database corrente e viene visualizzato solo il primo set di risultati visualizzato nella sezione Set di risultati.

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Set di risultati

Nome colonna	Tipo di dati	Descrizione
Groupname	sysname	Nome del filegroup
groupid	smallint	Identificatore numerico del filegroup.
filecount	int	Numero di file del filegroup.

Se si specifica il nome , viene restituita una riga per ogni file nel filegroup.

Nome colonna	Tipo di dati	Descrizione
file_in_group	sysname	Nome logico del file nel filegroup.
fileid	smallint	Identificatore numerico del file.
filename	nchar(260)	Nome fisico del file che include il percorso di directory.
size	nvarchar(15)	Dimensione del file in kilobyte.
Maxsize	nvarchar(15)	Dimensione massima del file. Valore massimo fino a cui possono aumentare le dimensioni del file. Se questo campo include il valore UNLIMITED, le dimensioni del file possono aumentare fino a riempire il disco.
Crescita	nvarchar(15)	Incremento per l'aumento delle dimensioni del file. Indica la quantità di spazio aggiunta al file ogni volta che è necessario spazio aggiuntivo. 0 = la dimensione del file è fissa e non aumenterà.

Autorizzazioni

È richiesta l'appartenenza al ruolo public .

Esempi

R. Restituzione di tutti i filegroup in un database

Nell'esempio seguente vengono restituite le informazioni sui filegroup nel database di esempio AdventureWorks2022.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup;  
GO

B. Restituzione di tutti i file in un filegroup

Nell'esempio seguente vengono restituite le informazioni relative a tutti i file nel filegroup PRIMARY nel database di esempio AdventureWorks2022.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO

Vedi anche

Stored procedure del motore di database (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Stored procedure di sistema (Transact-SQL)
Filegroup e file di database