Поделиться через


sp_helpfilegroup (Transact-SQL)

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

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

Синтаксис

sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Аргументы

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

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

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

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

Имя столбца

Тип данных

Описание

groupname

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.

Примеры

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

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

USE AdventureWorks2012;
GO
EXEC sp_helpfilegroup;
GO

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

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

USE AdventureWorks2012;
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)

Основные понятия

Файлы и файловые группы базы данных