Compartilhar via


xp_sqlmaint (Transact-SQL)

Aplica-se: SQL Server

Chama o utilitário sqlmaint com uma cadeia de caracteres que contém opções sqlmaint (também conhecidas como opções). O utilitário sqlmaint executa um conjunto de operações de manutenção em um ou mais bancos de dados.

Observação

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Convenções de sintaxe de Transact-SQL

Sintaxe

xp_sqlmaint 'switch_string'

Argumentos

'switch_string'

Uma cadeia de caracteres que contém as opções do utilitário sqlmaint . As opções e seus valores devem ser separados por um espaço.

A -? opção não é válida para xp_sqlmaint.

Valores do código de retorno

Nenhum. Retorna um erro se o utilitário sqlmaint falhar.

Comentários

Se esse procedimento for chamado por um usuário conectado com a Autenticação do SQL Server, as opções e -P "<password>" serão anexadas a switch_string antes da -U "<login_id>" execução. Se o usuário estiver conectado com a Autenticação do Windows, switch_string será passado sem alteração para sqlmaint.

Permissões

Requer associação na função de servidor fixa sysadmin ou permissão de execução diretamente nesse procedimento armazenado.

Exemplos

No exemplo a seguir, xp_sqlmaint chama sqlmaint para executar verificações de integridade, criar um arquivo de relatório e atualizar msdb.dbo.sysdbmaintplan_historyarquivos .

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';

Veja a seguir o conjunto de resultados.

The command(s) executed successfully.