sp_helpfilegroup(Transact-SQL)
적용 대상: 
SQL Server
현재 데이터베이스와 연결된 파일 그룹의 이름과 특성을 반환합니다.
구문
sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]
인수
[ @filegroupname = ] N'filegroupname'
@filegroupname sysname이며 기본값은 .입니다NULL.
현재 데이터베이스에 있는 파일 그룹의 논리적 이름입니다. @filegroupname sysname이며 기본값은 .입니다NULL. @filegroupname 지정하지 않으면 현재 데이터베이스의 모든 파일 그룹이 나열되고 결과 집합 섹션에 표시된 첫 번째 결과 집합만 표시됩니다.
반환 코드 값
0(성공) 또는 1(실패).
결과 집합
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
groupname |
sysname | 파일 그룹의 이름입니다. |
groupid |
smallint | 숫자 파일 그룹 식별자입니다. |
filecount |
int | 파일 그룹의 파일 수입니다. |
@filegroupname 지정하면 파일 그룹의 각 파일에 대해 하나의 행이 반환됩니다.
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
file_in_group |
sysname | 파일 그룹에 있는 파일의 논리적 이름입니다. |
fileid |
smallint | 숫자 파일 식별자입니다. |
filename |
nchar(260) | 디렉터리 경로를 포함한 파일의 물리적 이름입니다. |
size |
nvarchar(15) | 파일 크기(킬로바이트)입니다. |
maxsize |
nvarchar(15) | 파일의 최대 크기입니다. 파일이 증가할 수 있는 최대 크기입니다. 이 필드의 UNLIMITED 값은 디스크가 가득 찼을 때까지 파일이 증가한다는 것을 나타냅니다. |
growth |
nvarchar(15) | 파일의 증가 증분입니다. 이 값은 새 공간이 필요할 때마다 파일에 추가되는 공간의 양을 나타냅니다.0 = 파일 크기가 고정되어 증가하지 않습니다. |
사용 권한
public 역할의 멤버 자격이 필요합니다.
예제
A. 데이터베이스의 모든 파일 그룹 반환
다음 예제에서는 샘플 데이터베이스의 파일 그룹에 대한 정보를 반환합니다 AdventureWorks2022 .
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO
B. 파일 그룹의 모든 파일 반환
다음 예제에서는 샘플 데이터베이스의 PRIMARY 파일 그룹에 AdventureWorks2022 있는 모든 파일에 대한 정보를 반환합니다.
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO