Dela via

sp_repladdcolumn (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Lägger till en kolumn i en befintlig publicerad tabellartikel. Gör att den nya kolumnen kan läggas till i alla utgivare som publicerar den här tabellen, eller bara lägga till kolumnen i en specifik publikation som publicerar tabellen. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Viktigt!

Den här lagrade proceduren är inaktuell och stöds för bakåtkompatibilitet. Den bör endast användas med SQL Server 2000 (8.x) Publishers och SQL Server 2000 (8.x) som publicerar prenumeranter på nytt. Den här proceduren bör inte användas för kolumner med datatyper som introducerades i SQL Server 2005 (9.x) och senare versioner.

Transact-SQL syntaxkonventioner

Syntax

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'

Namnet på den tabellartikel som innehåller den nya kolumn som ska läggas till. @source_object är nvarchar(358), utan standard.

[ @column = ] N'column'

Namnet på kolumnen i tabellen som ska läggas till för replikering. @column är sysname, utan standard.

[ @typetext = ] N'typetext'

Definitionen av kolumnen som läggs till. @typetext är nvarchar(3000), utan standard. Om kolumnen order_filled till exempel läggs till och det är ett fält med ett enda tecken, inte null, och har standardvärdet N, skulle order_filled vara kolumnparametern, medan definitionen av kolumnen, char(1) NOT NULL CONSTRAINT constraint_name DEFAULT 'N' skulle vara @typetext parametervärdet.

[ @publication_to_add = ] N'publication_to_add'

Namnet på publikationen som den nya kolumnen läggs till i. @publication_to_add är nvarchar(4000), med standardvärdet all. Om allpåverkas alla publikationer som innehåller den här tabellen. Om @publication_to_add anges har endast den här publikationen den nya kolumnen tillagd.

[ @from_agent = ] from_agent

Anger om den lagrade proceduren körs av en replikeringsagent. @from_agent är int, med standardvärdet 0. Ett värde 1 för används när den här lagrade proceduren körs av en replikeringsagent, och i alla andra fall ska standardvärdet 0 för användas.

[ @schema_change_script = ] N'schema_change_script'

Anger namnet och sökvägen för ett SQL Server-skript som används för att ändra systemgenererade anpassade lagrade procedurer. @schema_change_script är nvarchar(4000), med standardvärdet NULL. Med replikering kan användardefinierade anpassade lagrade procedurer ersätta en eller flera av de standardprocedurer som används vid transaktionsreplikering. @schema_change_script körs efter att en schemaändring har gjorts i en replikerad tabellartikel med hjälp av sp_repladdcolumn, och kan användas på följande sätt:

  • Om anpassade lagrade procedurer återskapas automatiskt kan @schema_change_script användas för att släppa dessa anpassade lagrade procedurer och ersätta dem med användardefinierade anpassade lagrade procedurer som stöder det nya schemat.

  • Om anpassade lagrade procedurer inte återskapas automatiskt kan @schema_change_script användas för att återskapa dessa lagrade procedurer eller för att skapa användardefinierade anpassade lagrade procedurer.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Aktiverar eller inaktiverar möjligheten att få en ögonblicksbild ogiltig. @force_invalidate_snapshot är bit, med standardvärdet 1.

  • 1 anger att ändringar i artikeln kan leda till att ögonblicksbilden blir ogiltig, och i så fall ger värdet 1 för ger behörighet för den nya ögonblicksbilden att ske.

  • 0 anger att ändringar i artikeln inte gör att ögonblicksbilden blir ogiltig.

[ @force_reinit_subscription = ] force_reinit_subscription

Aktiverar eller inaktiverar möjligheten att få prenumerationen initierad på nytt. @force_reinit_subscription är lite, med standardvärdet 0.

  • 0 anger att ändringar i artikeln inte gör att prenumerationen initieras på nytt.

  • 1 anger att ändringar i artikeln kan leda till att prenumerationen initieras på nytt, och om så är fallet ger värdet 1 för ger behörighet för prenumerationens återinitiering att ske.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Permissions

Endast medlemmar i den fasta serverrollen sysadmin och den db_owner fasta databasrollen kan köra sp_repladdcolumn.

Relaterat innehåll