sp_helpfilegroup (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server

Возвращает имена и атрибуты файловых групп, связанных с текущей базой данных.

Синтаксис

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Аргументы

[ @filegroupname = ] 'name' Логическое имя любой файловой группы в текущей базе данных. имя — sysname с значением NULL по умолчанию. Если имя не указано, отображаются все файловые группы в текущей базе данных и отображается только первый результирующий набор, показанный в разделе результирующих наборов.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Имя столбца	Тип данных	Описание:
Groupname	sysname	Имя файловой группы.
groupid	smallint	Числовой идентификатор файловой группы.
filecount	int	Количество файлов в файловой группе.

Если указано имя , возвращается одна строка для каждого файла в файловой группе.

Имя столбца	Тип данных	Описание:
file_in_group	sysname	Логическое имя файла в файловой группе.
fileid	smallint	Числовой идентификатор файла.
filename	nchar(260)	Физическое имя, включающее путь к каталогу.
size	nvarchar(15)	Размер файла в килобайтах.
Maxsize	nvarchar(15)	Максимальный размер файла. Максимальный размер, до которого может вырасти файл. Значение UNLIMITED в этом поле означает, что файл может расти, пока диск не будет заполнен.
Роста	nvarchar(15)	Значение прироста размера файла. Параметр задает объем пространства, добавляемого к файлу каждый раз, когда требуется дополнительное пространство. 0 = файл имеет фиксированный размер и не может расти.

Разрешения

Необходимо быть членом роли public.

Примеры

О. Возвращать все файловые группы в базе данных

В приведенном ниже примере возвращаются сведения о файловых группах в образце базы данных AdventureWorks2022.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup;  
GO

B. Возвращать все файлы в файловой группе

В приведенном ниже примере возвращаются сведения обо всех файлах файловой группы PRIMARY в образце базы данных AdventureWorks2022.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO

См. также

Хранимые процедуры ядра СУБД (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)
Файлы и файловые группы базы данных