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
См. также
Справочник
Хранимые процедуры ядра СУБД (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)
Другие ресурсы
Основные сведения о файлах и файловых группах