sp_helpfilegroup(Transact-SQL)

아티클
08/21/2023

적용 대상:SQL Server

현재 데이터베이스와 연결된 파일 그룹의 이름과 특성을 반환합니다.

구문

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

인수

[ @filegroupname = ] 'name' 현재 데이터베이스에 있는 파일 그룹의 논리적 이름입니다. 이름은 sysname이며 기본값은 NULL입니다. 이름을 지정하지 않으면 현재 데이터베이스의 모든 파일 그룹이 나열되고 결과 집합 섹션에 표시된 첫 번째 결과 집합만 표시됩니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

열 이름	데이터 형식	설명
Groupname	sysname	파일 그룹의 이름입니다.
Groupid	smallint	숫자 파일 그룹 식별자입니다.
filecount	int	파일 그룹의 파일 수입니다.

이름을 지정하면 파일 그룹의 각 파일에 대해 하나의 행이 반환됩니다.

열 이름	데이터 형식	설명
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

참고 항목

데이터베이스 엔진 저장 프로시저(Transact-SQL)
sp_helpfile(Transact-SQL)
sys.database_files(Transact-SQL)
sys.master_files(Transact-SQL)
sys.filegroups(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
데이터베이스 파일 및 파일 그룹