xp_sqlmaint (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Llama a la utilidad sqlmaint con una cadena que contiene opciones de sqlmaint (también conocidas como modificadores). La utilidad sqlmaint realiza un conjunto de operaciones de mantenimiento en una o varias bases de datos.

Nota:

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

Convenciones de sintaxis de Transact-SQL

Sintaxis

xp_sqlmaint 'switch_string'

Argumentos

"switch_string"

Cadena que contiene los modificadores de la utilidad sqlmaint . Los modificadores y sus valores tienen que estar separados por un espacio.

El -? modificador no es válido para xp_sqlmaint.

Valores de código de retorno

Ninguno. Devuelve un error si se produce un error en la utilidad sqlmaint .

Comentarios

Si un usuario inicia sesión con la autenticación de SQL Server llama a este procedimiento, los -U "<login_id>" modificadores y -P "<password>" se anteponen a switch_string antes de la ejecución. Si el usuario ha iniciado sesión con la autenticación de Windows, switch_string se pasa sin cambiar a sqlmaint.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin o ejecutar el permiso directamente en este procedimiento almacenado.

Ejemplos

En el ejemplo siguiente, xp_sqlmaint llama a sqlmaint para realizar comprobaciones de integridad, crear un archivo de informe y actualizar msdb.dbo.sysdbmaintplan_history.

EXEC xp_sqlmaint '-D AdventureWorks2022 -PlanID 02A52657-D546-11D1-9D8A-00A0C9054212
   -Rpt "C:\Program Files\Microsoft SQL Server\MSSQL\LOG\DBMaintPlan2.txt" -WriteHistory -CkDB -CkAl';

El conjunto de resultados es el siguiente:

The command(s) executed successfully.

Contenido relacionado