sp_helpfilegroup (Transact-SQL)

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

Значок ссылки на разделСоглашения о синтаксисе в Transact-SQL

Синтаксис

sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Аргументы

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

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

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

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

Имя столбца

Тип данных

Описание

Имя группы

sysname

Имя файловой группы.

groupid

smallint

Числовой идентификатор файловой группы.

filecount

int

Количество файлов в файловой группе.

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

Имя столбца

Тип данных

Описание

file_in_group

sysname

Логическое имя файла в файловой группе.

fileid

smallint

Числовой идентификатор файла.

filename

nchar(260)

Физическое имя, включающее путь к каталогу.

size

nvarchar(15)

Размер файла в килобайтах.

maxsize

nvarchar(15)

Максимальный размер файла.

Максимальный размер, до которого может вырасти файл. Значение UNLIMITED в этом поле означает, что файл может расти, пока диск не будет заполнен.

growth

nvarchar(15)

Значение прироста размера файла. Параметр задает объем пространства, добавляемого к файлу каждый раз, когда требуется дополнительное пространство.

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

Разрешения

Необходимо членство в роли public.

Примеры

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

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

USE AdventureWorks;
GO
EXEC sp_helpfilegroup;
GO

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

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

USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO