xp_sqlメインt (Transact-SQL)

適用対象:SQL Server

sqlメインt オプション (スイッチとも呼ばれます) を含む文字列で sqlメインt ユーティリティを呼び出します。 sqlメインt ユーティリティは、1 つ以上のデータベースに対して一連のメインテナント操作を実行します。

Note

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

Transact-SQL 構文表記規則

構文

xp_sqlmaint 'switch_string'

引数

'switch_string'

sqlメインt ユーティリティ スイッチを含む文字列。 スイッチとその値は、空白で区切る必要があります。

スイッチが -? 無効です xp_sqlmaint。

リターン コードの値

なし。 sqlメインt ユーティリティが失敗した場合にエラーを返します。

解説

この手順が SQL Server 認証でログオンしているユーザーによって呼び出された場合、-U "<login_id>"スイッチは-P "<password>"実行前に switch_string の前に付加されます。 ユーザーが Windows 認証でログオンしている場合、switch_stringは sqlメインt に変更されずに渡されます。

アクセス許可

sysadmin 固定サーバー ロールのメンバーシップが必要です。または、このストアド プロシージャに対して直接アクセス許可を実行する必要があります。

例

次の例では、 xp_sqlmaint sqlメインt を呼び出して整合性チェックを実行し、レポート ファイルを作成して更新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';

結果セットは次のようになります。

The command(s) executed successfully.

関連するコンテンツ

• sqlmaint ユーティリティ
• システム ストアド プロシージャ (Transact-SQL)