sp_clean_db_file_free_space (Transact-SQL)

Se aplica a:SQL Server

Quita la información residual que queda en las páginas de base de datos debido a rutinas de modificación de datos en SQL Server. sp_clean_db_file_free_space limpia todas las páginas en un solo archivo de una base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_clean_db_file_free_space   
  [ @dbname = ] 'database_name'   
  , [ @fileid = ] 'file_number'   
  [ , [ @cleaning_delay = ] 'delay_in_seconds' ] [;]  

Argumentos

@dbname = 'database_name'
Es el nombre de la base de datos que se va a limpiar. dbname es sysname y no puede ser NULL.

@fileid = "file_number"
Es el id. del archivo de datos que se va a limpiar. file_number es int y no puede ser NULL.

@cleaning_delay = 'delay_in_seconds'
Especifica un intervalo de retardo entre la limpieza de páginas. Esto ayuda a reducir el efecto en el sistema de E/S. delay_in_seconds es int con un valor predeterminado de 0.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Elimina las operaciones de una tabla o las operaciones de actualización que hacen que una fila que se va a mover pueda liberar inmediatamente espacio en una página quitando las referencias a la fila. Sin embargo, en determinadas circunstancias, la fila puede permanecer físicamente en la página de datos como un registro fantasma. Los registros fantasma se quitan periódicamente mediante un proceso en segundo plano. El motor de base de datos no devuelve estos datos residuales en respuesta a las consultas. Sin embargo, en entornos en los que la seguridad física de los archivos de datos o copia de seguridad está en riesgo, puede usar sp_clean_db_file_free_space para limpiar estos registros fantasma. Para realizar esta operación para todos los archivos de base de datos a la vez, use sp_clean_db_free_space (Transact-SQL).

El período de tiempo necesario para ejecutar sp_clean_db_file_free_space depende del tamaño del archivo, del espacio disponible y de la capacidad del disco. Dado que la ejecución sp_clean_db_file_free_space puede afectar significativamente a la actividad de E/S, se recomienda ejecutar este procedimiento fuera del horario de operación habitual.

Antes de ejecutar sp_clean_db_file_free_space, se recomienda crear una copia de seguridad completa de la base de datos.

El procedimiento almacenado sp_clean_db_free_space relacionado limpia todos los archivos de la base de datos.

Permisos

Requiere la pertenencia al db_owner rol de base de datos.

Ejemplos

En el ejemplo siguiente se limpia toda la información residual del archivo de datos principal de la base de datos AdventureWorks2022.

USE master;  
GO  
EXEC sp_clean_db_file_free_space @dbname = N'AdventureWorks2022', @fileid = 1;  

Consulte también

Procedimientos almacenados del motor de base de datos (Transact-SQL)
Guía del proceso de limpieza fantasma
sp_clean_db_free_space (Transact-SQL)