sp_addsynctriggers (Transact-SQL)

Cria gatilhos no Assinante usados com todos os tipos de assinaturas atualizáveis (Imediata, Enfileirada e Atualização imediata com atualização enfileirada como failover). Esse procedimento armazenado é executado no Assinante, no banco de dados de assinatura.

Importante
O procedimento sp_script_synctran_commands deve ser usado, em vez de sp_addsynctrigger. sp_script_synctran_commands gera um script que contém as chamadas sp_addsynctrigger.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_addsynctriggers [ @sub_table = ] 'sub_table' 
        , [ @sub_table_owner = ] 'sub_table_owner' 
        , [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication'  
        , [ @ins_proc = ] 'ins_proc'  
        , [ @upd_proc = ] 'upd_proc'  
        , [ @del_proc = ] 'del_proc'  
        , [ @cftproc = ] 'cftproc'
        , [ @proc_owner = ] 'proc_owner'
    [ , [ @identity_col = ] 'identity_col' ]
    [ , [ @ts_col = ] 'timestamp_col' ]
    [ , [ @filter_clause = ] 'filter_clause' ] 
        , [ @primary_key_bitmap = ] 'primary_key_bitmap'
    [ , [ @identity_support = ] identity_support ]
    [ , [ @independent_agent = ] independent_agent ]
        , [ @distributor = ] 'distributor' 
    [ , [ @pubversion = ] pubversion

Argumentos

• [ @sub_table=] 'sub_table'
  É o nome da tabela do Assinante. sub_table é sysname, sem padrão.

• [ @sub_table_owner=] 'sub_table_owner'
  Corresponde ao nome do proprietário da tabela do Assinante. sub_table_owner é sysname, sem padrão.

• [ @publisher = ] 'publisher'
  É o nome do servidor do Publicador. publisher é sysname, sem padrão.

• [ @publisher_db=] 'publisher_db'
  É o nome do banco de dados Publicador. publisher_db é sysname, sem padrão. Se NULL, será usado o banco de dados atual.

• [ @publication=] 'publication'
  É o nome da publicação. Publication é sysname, sem padrão.

• [ @ ins_proc =] 'ins_proc'
  É o nome do procedimento armazenado que oferece suporte às inserções de transação síncrona no Publicador. ins_proc é sysname, sem padrão.

• [ @ upd_proc =] 'upd_proc'
  É o nome do procedimento armazenado que oferece suporte às atualizações de transação síncrona no Publicador. ins_proc é sysname, sem padrão.

• [ @ del_proc =] 'del_proc'
  É o nome do procedimento armazenado que oferece suporte às exclusões de transação síncrona no Publicador. ins_proc é sysname, sem padrão.

• [ @ cftproc = ] 'cftproc'
  É o nome do procedimento gerado automaticamente usado por publicações que permitem a atualização enfileirada. cftproc é sysname, sem padrão. Para publicações que permitem atualização imediata, este valor é o NULL. Este parâmetro se aplica a publicações que permitem atualização feita fila (Atualização Feita fila e Atualização Imediata com Atualização Feita fila como Failover).

• [ @proc_owner = ] 'proc_owner'
  Especifica a conta de usuário no Publicador na qual todos os procedimentos armazenados gerados automaticamente para a publicação de atualização (enfileirada e/ou imediata) foram criados. proc_owner é sysname, sem padrão.

• [ @identity_col=] 'identity_col'
  É o nome da coluna de identidade no Publicador. identity_col é sysname, com um padrão de NULL.

• [ @ ts_col =] 'timestamp_col'
  É o nome da coluna timestamp no Publicador. timestamp_col é sysname, com um padrão de NULL.

• [ @filter_clause=] 'filter_clause'
  É uma cláusula de restrição (WHERE) que define um filtro horizontal. Ao inserir a cláusula de restrição, omita a palavra-chave WHERE. filter_clauseé nvarchar(4000), com um padrão de NULL.

• [ @ primary_key_bitmap =] 'primary_key_bitmap'
  É um mapa de bits das colunas de chave primária na tabela. primary_key_bitmap é varbinary(4000), sem padrão.

• [ @identity_support = ] identity_support
  Ativa e desativa o tratamento do intervalo de identidade automático quando a atualização na fila é usada. identity_support é um bit, com um padrão de 0. 0 significa não há suporte para intervalo de identidade; 1 ativa o tratamento do intervalo de identidade automático.

• [ @independent_agent = ] independent_agent
  Indica se há um único Distribution Agent (um agente independente) para esta publicação ou um Distribution Agent por par de banco de dados de publicação e banco de dados de assinatura (um agente compartilhado). Esse valor reflete o valor da propriedade ndependent_agent da publicação definida no Publicador. independent_agent é um bit com um padrão de 0. Se 0, o agente é um Compartilhado Agente. Se 1, o agente é um independente.

• [ @distributor = ] 'distributor'
  É o nome do Distribuidor. distributor é sysname, sem padrão.

• [ @ pubversion=] pubversion
  Indica a versão do Publicador. pubversion é int, com um valor padrão 1. 1 significa que a versão do Publicador é Microsoft SQL Server 2000 Service Pack 2 ou anterior; 2 significa que o Publicador é SQL Server 2000 Service Pack 3 (SP3) ou posterior. pubversion deve ser definido explicitamente como 2 quando a versão do Publicador for SQL Server 2000 SP3 ou posterior.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_addsynctriggers é usado pelo Distribution Agent como parte de inicialização da assinatura. Esse procedimento armazenado não é executado com frequência pelos usuários, mas pode ser útil se o usuário precisar configurar manualmente uma assinatura “no-sync”.

Permissões

Somente membros da função de servidor fixa sysadmin ou db_owner podem executar sp_addsynctriggers.

Consulte também

Referência

sp_script_synctran_commands (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

Conceitos

Assinaturas atualizáveis para replicação transacional