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