xp_sqlmaint (Transact-SQL)

S'applique à : SQL Server

Appelle l’utilitaire sqlmaint avec une chaîne qui contient des options sqlmaint (également appelées commutateurs). L’utilitaire sqlmaint effectue un ensemble d’opérations de maintenance sur une ou plusieurs bases de données.

Remarque

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Conventions de la syntaxe Transact-SQL

Syntaxe

xp_sqlmaint 'switch_string'

Arguments

'switch_string'

Chaîne contenant les commutateurs de l’utilitaire sqlmaint . Les commutateurs et leurs valeurs doivent être séparés par un espace.

Le -? commutateur n’est pas valide pour xp_sqlmaint.

Valeurs des codes de retour

Aucune. Retourne une erreur si l’utilitaire sqlmaint échoue.

Notes

Si cette procédure est appelée par un utilisateur connecté avec l’authentification SQL Server, les -U "<login_id>" commutateurs sont -P "<password>" ajoutés à switch_string avant l’exécution. Si l’utilisateur est connecté avec l’authentification Windows, switch_string est passé sans modification à sqlmaint.

autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin ou exécutez l’autorisation directement sur cette procédure stockée.

Exemples

Dans l’exemple suivant, xp_sqlmaint appelle sqlmaint pour effectuer des vérifications d’intégrité, créer un fichier de rapport et mettre à jour 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';

Voici le jeu de résultats.

The command(s) executed successfully.