sp_delete_backup (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Exclui todos os instantâneos e o arquivo de backup que compõem um conjunto de backup de instantâneo do banco de dados especificado. Esse procedimento armazenado do sistema é o único método recomendado para gerenciar conjuntos de backup de snapshot. Para obter mais informações, consulte Backups de instantâneo de arquivo para arquivos de banco de dados no Azure.

Convenções de sintaxe de Transact-SQL

Sintaxe

sys.sp_delete_backup
    [ @backup_url = ] N'backup_metadata_file_url'
    , [ [ @db_name = ] N'database_name' | NULL ]

Argumentos

@backup_url [ = ] N'backup_meta_file_url'

A URL do backup a ser excluído, que exclui todos os instantâneos que compõem o conjunto de backup especificado, incluindo o próprio arquivo de backup.

@db_name [ = ] N'database_name'

O nome do banco de dados que contém o instantâneo a ser excluído. Quando um nome de banco de dados é fornecido, o sistema verifica se a URL de backup fornecida é uma URL de backup para o banco de dados especificado e usa sp_delete_backup_file_snapshot (Transact-SQL) para excluir cada instantâneo. Se nenhum nome de banco de dados for fornecido, essa verificação de banco de dados não será executada.

Permissões

Requer permissão ALTER ANY DATABASE ou permissão ALTER no banco de dados especificado.