Compartir a través de


sp_helpfilegroup (Transact-SQL)

Se aplica a: SQL Server

Devuelve los nombres y los atributos de los grupos de archivos asociados con la base de datos actual.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]

Argumentos

[ @filegroupname = ] N'filegroupname'

@filegroupname es sysname, con un valor predeterminado de NULL.

Nombre lógico de cualquier grupo de archivos de la base de datos actual. @filegroupname es sysname, con un valor predeterminado de NULL. Si no se especifica @filegroupname , se muestran todos los grupos de archivos de la base de datos actual y solo se muestra el primer conjunto de resultados que se muestra en la sección Conjuntos de resultados.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
groupname sysname Nombre del grupo de archivos.
groupid smallint Identificador numérico del grupo de archivos.
filecount int Número de archivos del grupo de archivos.

Si se especifica @filegroupname , se devuelve una fila para cada archivo del grupo de archivos.

Nombre de la columna Tipo de datos Descripción
file_in_group sysname Nombre lógico del campo en el grupo de archivos.
fileid smallint Identificador numérico del archivo.
filename nchar(260) Nombre físico del archivo, incluida la ruta de acceso del directorio.
size nvarchar(15) Tamaño del archivo en kilobytes.
maxsize nvarchar(15) Tamaño máximo del archivo.

Es el tamaño máximo que puede alcanzar el archivo. Un valor de UNLIMITED en este campo indica que el archivo crece hasta que el disco está lleno.
growth nvarchar(15) Incremento de crecimiento del archivo. Este valor indica la cantidad de espacio agregado al archivo cada vez que se requiere espacio nuevo.

0 = El archivo es un tamaño fijo y no crece.

Permisos

Debe pertenecer al rol public .

Ejemplos

A Devolver todos los grupos de archivos de una base de datos

En el siguiente ejemplo se devuelve información sobre los grupos de archivos de la base de datos de ejemplo AdventureWorks2022.

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO

B. Devolver todos los archivos de un grupo de archivos

En el siguiente ejemplo se devuelve información para todos los archivos del grupo de archivos PRIMARY de la base de datos de ejemplo AdventureWorks2022.

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO