sp_repladdcolumn (Transact-SQL)

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

Adiciona uma coluna a um artigo de tabela existente que foi publicado. Permite que a nova coluna seja adicionada a todos os Publicadores que publicam essa tabela, ou simplesmente adiciona a coluna a uma publicação específica que publica a tabela. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Importante

Esse procedimento armazenado foi preterido e tem suporte para compatibilidade com versões anteriores. Ele só deve ser usado com Publicadores do Microsoft SQL Server 2000 (8.x) e Assinantes de republicação do SQL Server 2000 (8.x). Esse procedimento não deve ser usado em colunas com tipos de dados que foram introduzidos no SQL Server 2005 (9.x) ou superior.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_repladdcolumn [ @source_object = ] 'source_object', [ @column = ] 'column' ]  
    [ , [ @typetext = ] 'typetext' ]  
    [ , [ @publication_to_add = ] 'publication_to_add' ]  
    [ , [ @from_agent = ] from_agent ]  
    [ , [ @schema_change_script = ] 'schema_change_script' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  

Argumentos

@source_object [ =] 'source_object'
É o nome do artigo de tabela que contém a nova coluna a ser adicionada. source_object é nvarchar(358), sem padrão.

@column [ =] 'coluna'
É o nome da coluna na tabela a ser adicionada para replicação. é sysname, sem padrão.

@typetext [ =] 'texto tipográfico'
É a definição da coluna que está sendo adicionada. typetext é nvarchar(3000), sem padrão. Por exemplo, se a coluna order_filled está sendo adicionada, e é um campo de caractere único, não NULL, e tem um valor padrão de N, order_filled seria o parâmetro column, enquanto a definição da coluna, char(1) NOT NULL CONSTRAINT constraint_name DEFAULT 'N' seria o valor do parâmetro typetext.

@publication_to_add [ =] 'publication_to_add'
É o nome da publicação à qual a nova coluna é adicionada. publication_to_add é nvarchar(4000), com um padrão de ALL. Se ALL, todas as publicações que contêm esta tabela são afetadas. Se publication_to_add for especificado, somente esta publicação terá a nova coluna adicionada.

@from_agent [ = ] from_agent
Se o procedimento armazenado estiver sendo executado por um agente de replicação. from_agent é int, com um padrão de 0, em que um valor de 1 é usado quando esse procedimento armazenado está sendo executado por um agente de replicação e, em todos os outros casos, o valor padrão de 0 deve ser usado.

@schema_change_script [ =] 'schema_change_script'
Especifica o nome e o caminho de um script do SQL Server usado para modificar os procedimentos armazenados personalizados gerados pelo sistema. schema_change_script é nvarchar(4000), com um padrão de NULL. A replicação permite procedimentos armazenados personalizados definidos pelo usuário, para substituir um ou mais dos procedimentos padrão usados em replicação transacional. schema_change_script é executada depois que uma alteração de esquema é feita em um artigo de tabela replicada usando sp_repladdcolumn e pode ser usada para executar um dos seguintes procedimentos:

• Se os procedimentos armazenados personalizados forem regenerados automaticamente, schema_change_script poderão ser usados para descartar esses procedimentos armazenados personalizados e substituí-los por procedimentos armazenados personalizados definidos pelo usuário que ofereçam suporte ao novo esquema.

• Se os procedimentos armazenados personalizados não forem regenerados automaticamente, schema_change_scriptpoderão ser usados para regenerar esses procedimentos armazenados ou para criar procedimentos armazenados personalizados definidos pelo usuário.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot
Habilita ou desabilita a capacidade de ter um instantâneo invalidado. force_invalidate_snapshot é um pouco, com um padrão de 1.

1 especifica que as alterações no artigo podem fazer com que o instantâneo seja inválido e, se for esse o caso, um valor de 1 dá permissão para que o novo instantâneo ocorra.

0 especifica que as alterações no artigo não fazem com que o instantâneo seja inválido.

@force_reinit_subscription [ = ] force_reinit_subscription
Habilita ou desabilita a capacidade de fazer com que a assinatura seja reinicializada. force_reinit_subscription é um pouco com um padrão de 0.

0 especifica que as alterações no artigo não fazem com que a assinatura seja reinicializada.

1 especifica que as alterações no artigo podem fazer com que a assinatura seja reinicializada e, se for esse o caso, um valor de 1 dá permissão para que a reinicialização da assinatura ocorra.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Permissões

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

Confira também

Recursos preteridos na Replicação do SQL Server
Procedimentos armazenados do sistema (Transact-SQL)