sp_helpfilegroup (Transact-SQL)

  • Artículo

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 = ] 'name' ]

Argumentos

[ @filegroupname = ] 'name' Es el nombre lógico de cualquier grupo de archivos de la base de datos actual. name es sysname, con un valor predeterminado de NULL. Si no se especifica name , 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 (error)

Conjuntos 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 name , 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. El valor UNLIMITED en este campo indica que el archivo puede aumentar hasta que el disco esté lleno.
growth nvarchar(15) Incremento de crecimiento del archivo. Indica la cantidad de espacio que se agrega al archivo cada vez que se necesita espacio.

0 = El archivo tiene un tamaño fijo y no aumenta.

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

Consulte también

Procedimientos almacenados del motor de base de datos (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
Archivos y grupos de archivos de base de datos