sp_repladdcolumn (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Adiciona uma coluna a um artigo de tabela publicado existente. Permite que a nova coluna seja adicionada a todos os editores que publicam esta tabela ou apenas adicione a coluna a uma publicação específica que publica a tabela. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

@source_object [ = ] N'source_object'

O nome do artigo da tabela que contém a nova coluna a ser adicionada. @source_object é nvarchar(358), sem padrão.

@column [ = ] N'coluna'

O nome da coluna na tabela a ser adicionada para replicação. @column é sysname, sem padrão.

@typetext [ = ] N'texto-tipo'

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 nulo, 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 [ = ] N'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, então 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

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

@schema_change_script [ = ] N'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 que procedimentos armazenados personalizados definidos pelo usuário substituam um ou mais dos procedimentos padrão usados na replicação transacional. @schema_change_script é executado depois que uma alteração de esquema é feita em um artigo de tabela replicado usando sp_repladdcolumno , e pode ser usado da seguinte maneira:

• 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_script poderã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 invalidar um snapshot. @force_invalidate_snapshot é bit, 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 ter a assinatura reinicializada. @force_reinit_subscription é bit, 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 Dá permissão para que a reinicialização da 1 assinatura ocorra.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Permissions

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

Conteúdo relacionado

• Funcionalidades obsoletas no SQL Server Replication
• Procedimentos armazenados do sistema (Transact-SQL)