sys.sp_deletetracertokenhistory (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Remove registos de tokens traçadores das tabelas de sistema MStracer_tokens e MStracer_history . Este procedimento armazenado é executado no Publisher na base de dados de publicações ou no Distribuidor na base de dados de distribuição.

Transact-SQL convenções de sintaxe

Syntax

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

Arguments

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

O nome da publicação onde o token traçador foi inserido. @publication é sysname, sem padrão. Este parâmetro é obrigatório.

[ @tracer_id = ] tracer_id

O ID do token rastreador a eliminar. @tracer_id é int, com um padrão de NULL. Se NULL, todos os tokens traçadores pertencentes à publicação são eliminados.

[ @cutoff_date = ] cutoff_date

Os tokens traçadores inseridos na publicação antes desta data são eliminados. @cutoff_date é datatime, com um padrão de NULL.

@publisher [ = ] N'editor'

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

Note

Este parâmetro deve ser especificado apenas para publicadores que não sejam SQL Server ou ao executar o procedimento armazenado a partir do distribuidor.

[ @publisher_db = ] N'publisher_db'

O nome da base de dados de publicações. @publisher_db é sysname, com um padrão de NULL. Este parâmetro é ignorado se o procedimento armazenado for executado no Publisher.

Note

Este parâmetro deve ser especificado ao executar o procedimento armazenado a partir do distribuidor.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_deletetracertokenhistory é usado na replicação transacional.

Ocorre um erro se especificar ambos os parâmetros @tracer_id e @cutoff_date.

Se não executar sp_deletetracertokenhistory a eliminação dos metadados do token de rastreador, a informação é apagada quando ocorre a limpeza do histórico programada regularmente.

Os IDs dos tokens traçadores podem ser determinados executando sp_helptracertokens ou consultando a tabela do sistema MStracer_tokens .

Permissions

Apenas o seguinte pessoal tem autoridade para executar sp_deletetracertokenhistory:

  • Membros do replmonitor , na base de dados de distribuição.
  • Os membros do sysadmin fixaram o papel de servidor.
  • Os membros do db_owner papel fixo na base de dados de publicações.
  • A db_owner da base de dados fixa.