Share via


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 (실패).

결과 집합

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