Share via


xp_sqlmaint (Transact-SQL)

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

ObservaçãoObservação

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

xp_sqlmaint 'switch_string'   

Argumentos

  • 'switch_string'
    É uma cadeia de caracteres contendo as opções de 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 de 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 à Autenticação do SQL Server, as opções -U "login_id" e -P "password" precederão switch_string antes da execução. Se o usuário estiver conectado à Autenticação do Windows, switch_string será passado sem alteração em sqlmaint.

Permissões

Requer associação à função de servidor fixa sysadmin.

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_history.

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

Aqui está o conjunto de resultados.

The command(s) executed successfully.