Compartilhar via


xp_sqlmaint (Transact-SQL)

Chama o utilitário sqlmaint com uma cadeia de caracteres que contém opções de 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ópico Convenções da sintaxe 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 de código de retorno

Nenhum. Retornará um erro se houver falha no utilitário sqlmaint.

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" serão pré-demarcadas para switch_string antes da execução. Se o usuário estiver conectado com a Autenticação do Windows, switch_string será passado sem alteração em para sqlmaint.

Permissões

Exige 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 AdventureWorks2012 -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.

Consulte também

Referência

Utilitário sqlmaint

Procedimentos armazenados do sistema (Transact-SQL)