sp_deletetracertokenhistory (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Remove os registros de token de rastreamento das tabelas do sistema MStracer_tokens e MStracer_history. 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 de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@publication [ = ] N'publicação'

O nome da publicação na qual o token de rastreamento foi inserido. @publication é sysname, sem padrão. Este parâmetro é obrigatório.

@tracer_id [ = ] tracer_id

A ID do token de rastreamento a ser excluído. @tracer_id é int, com um padrão de NULL. Se NULL, todos os tokens de rastreamento pertencentes à publicação serão excluídos.

@cutoff_date [ = ] cutoff_date

Os tokens de rastreamento inseridos na publicação antes dessa data são excluídos. @cutoff_date é datetime, com um padrão de NULL.

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname, com um padrão de NULL.

Observação

Esse parâmetro só deve ser especificado para Publicadores não SQL Server ou ao executar o procedimento armazenado do distribuidor.

@publisher_db [ = ] N'publisher_db'

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

Observação

Esse parâmetro deve ser especificado ao executar o procedimento armazenado do distribuidor.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_deletetracertokenhistory é usado na replicação transacional.

Ocorrerá um erro se você especificar os parâmetros @tracer_id e @cutoff_date.

Se você não executar sp_deletetracertokenhistory para excluir metadados de token de rastreamento, as informações serão excluídas quando ocorrer a limpeza de histórico agendada regularmente.

As IDs de token de rastreamento podem ser determinadas executando sp_helptracertokens ou consultando a tabela do sistema MStracer_tokens .

Permissões

Apenas o seguinte pessoal tem autoridade para executar sp_deletetracertokenhistory:

  • Membros das funções replmonitor , no banco de dados de distribuição.
  • Membros da função de servidor fixa sysadmin .
  • Os membros da função de banco de dados fixa db_owner , no banco de dados de publicação.
  • O db_owner do banco de dados fixo.

Conteúdo relacionado