Partilhar via


xp_sqlmaint (Transact-SQL)

Aplica-se a:SQL Server

Chama o utilitário sqlmaint com uma cadeia de caracteres que contém opções de 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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso.

Transact-SQL convenções de sintaxe

Sintaxe

xp_sqlmaint 'switch_string'

Argumentos

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção de sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

'switch_string'

Uma cadeia de caracteres que contém os switches do utilitário sqlmaint. Os interruptores 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

Nenhuma. 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 -U "<login_id>" e -P "<password>" serão preparadas 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 para sqlmaint.

Permissões

Requer associação ao sysadmin função de servidor fixa ou permissão de execução diretamente neste 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_history.

EXECUTE xp_sqlmaint '-D AdventureWorks2022 -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.