sp_helpfilegroup (Transact-SQL)

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ = ] @filegroupname N'filegroupname'

@filegroupname — sysname с значением по умолчаниюNULL.

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

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

0 (успешно) или 1 (сбой).

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

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

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

Имя столбца Тип данных Description
file_in_group sysname Логическое имя файла в файловой группе.
fileid smallint Числовой идентификатор файла.
filename nchar(260) Физическое имя, включающее путь к каталогу.
size nvarchar(15) Размер файла в килобайтах.
maxsize nvarchar(15) Максимальный размер файла.

Максимальный размер, до которого может вырасти файл. Значение UNLIMITED в этом поле указывает, что файл растет до тех пор, пока диск не будет заполнен.
growth nvarchar(15) Значение прироста размера файла. Это значение указывает объем пространства, добавляемого в файл каждый раз, когда требуется новое пространство.

0 = Файл является фиксированным размером и не растет.

Разрешения

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

Примеры

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

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

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO

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

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

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO