sp_deletetracertokenhistory (Transact-SQL)

Remove registros de token de rastreamento das tabelas de 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.

Convenções da 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 de 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 prazo da qual são removidos todos os tokens de rastreamento inseridos na publicação antes daquela data. cutoff_date é datetime, com um valor padrão de NULL.

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

  Observação
  Esse parâmetro só deve ser especificado para Editores 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 de 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.

Consulte também

Referência

sp_helptracertokenhistory (Transact-SQL)

Conceitos

Medir a latência e validar as conexões para a replicação transacional