Compartilhar via


sp_deletetracertokenhistory (Transact-SQL)

Remove registros de token de rastreamento das tabelas do sistema MStracer_tokens (Transact-SQL) e MStracer_history (Transact-SQL). Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação, ou no Distribuidor, no banco de dados de distribuição.

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

Sintaxe

sp_deletetracertokenhistory [ @publication = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumentos

  • [ @publication= ] 'publication'
    É o nome da publicação na qual o token de rastreamento foi inserido. publication é sysname, sem padrão.

  • [ @tracer_id= ] tracer_id
    É a ID do token de rastreamento a ser excluído. tracer_id é int, com um valor padrão NULL. Se for null, todos os tokens de rastreamento que pertencem à publicação serão excluídos.

  • [ @cutoff_date= ] cutoff_date
    Especifica uma data de corte em que todos os tokens de rastreamento inseridos na publicação antes daquela data são removidos. cutoff_date é data e hora, com um valor padrão NULL.

  • [ @publisher= ] 'publisher'
    O nome do Publicador. publisher é sysname, com um padrão NULL.

    ObservaçãoObservação

    Esse parâmetro só deve ser especificado para Publicadores não-Microsoft SQL Server.

  • [ @publisher_db= ] 'publisher_db'
    O nome do banco de dados de publicação. publisher_db é sysname, com um valor padrão NULL. Esse parâmetro será ignorado se o procedimento armazenado for executado no Publicador.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_deletetracertokenhistory é usado em replicação transacional.

Ao executar sp_deletetracertokenhistory, você pode especificar apenas um tracer_id ou cutoff_date. Um erro ocorre quando você especifica ambos os parâmetros.

Se você na executar sp_deletetracertokenhistory para remover metadados de token de rastreamento, as informações serão removidas quando a limpeza de histórico agendada regularmente ocorrer.

IDs de token de rastreamento podem ser determinadas executando sp_helptracertokens (Transact-SQL) ou consultando a tabela do sistema MStracer_tokens (Transact-SQL).

Permissões

Somente membros da função de servidor fixa sysadmin, da função de banco de dados fixa no banco de dados de publicação db_owner, da função de banco de dados fixa db_owner ou das funções replmonitor no banco de dados de distribuição podem executar sp_deletetracertokenhistory.