xp_sqlmaint (Transact-SQL)

Artykuł
2025-03-11

Wywołuje narzędzie sqlmaint z ciągiem zawierającym opcje sqlmaint (znane również jako przełączniki ). Narzędzie sqlmaint wykonuje zestaw operacji konserwacji na co najmniej jednej bazie danych.

Nuta

Ta funkcja zostanie usunięta w przyszłej wersji programu SQL Server. Unikaj używania tej funkcji w nowych pracach programistycznych i zaplanuj modyfikowanie aplikacji, które obecnie korzystają z tej funkcji.

Transact-SQL konwencje składni

Składnia

xp_sqlmaint 'switch_string'

Argumenty

Ważny

Argumenty dla rozszerzonych procedur składowanych należy wprowadzić w określonej kolejności zgodnie z opisem w sekcji składni. Jeśli parametry są wprowadzane poza kolejnością, wystąpi komunikat o błędzie.

'switch_string'

Ciąg zawierający przełączniki narzędzi sqlmaint. Przełączniki i ich wartości muszą być oddzielone spacją.

Przełącznik -? nie jest prawidłowy dla xp_sqlmaint.

Zwracanie wartości kodu

Żaden. Zwraca błąd, jeśli narzędzie sqlmaint kończy się niepowodzeniem.

Uwagi

Jeśli ta procedura jest wywoływana przez użytkownika zalogowanego przy użyciu uwierzytelniania programu SQL Server, przełączniki -U "<login_id>" i -P "<password>" są poprzedzone switch_string przed wykonaniem. Jeśli użytkownik jest zalogowany przy użyciu uwierzytelniania systemu Windows, switch_string jest przekazywany bez zmiany na sqlmaint.

Uprawnienia

Wymaga członkostwa w sysadmin stałej roli serwera lub wykonywania uprawnień bezpośrednio w tej procedurze składowanej.

Przykłady

W poniższym przykładzie xp_sqlmaint wywołuje sqlmaint w celu przeprowadzenia kontroli integralności, utworzenia pliku raportu i zaktualizowania 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';

Oto zestaw wyników.

The command(s) executed successfully.

Udostępnij za pośrednictwem