sp_repladdcolumn (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Voegt een kolom toe aan een bestaand gepubliceerd tabelartikel. Hiermee kan de nieuwe kolom worden toegevoegd aan alle uitgevers die deze tabel publiceren of voegt u de kolom toe aan een specifieke publicatie die de tabel publiceert. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Transact-SQL syntaxis-conventies

Syntaxis

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'

De naam van het tabelartikel dat de nieuwe kolom bevat die u wilt toevoegen. @source_object is nvarchar(358), zonder standaardinstelling.

[ @column = ] N'column'

De naam van de kolom in de tabel die moet worden toegevoegd voor replicatie. @column is sysname, zonder standaardinstelling.

[ @typetext = ] N'typetekst'

De definitie van de kolom die wordt toegevoegd. @typetext is nvarchar(3000), zonder standaardinstelling. Als de kolom order_filled wordt toegevoegd en het een veld met één teken is, niet null, en een standaardwaarde van N heeft, is order_filled de kolomparameter , terwijl de definitie van de kolom char(1) NOT NULL CONSTRAINT constraint_name DEFAULT 'N' de parameterwaarde @typetext parameterwaarde is.

[ @publication_to_add = ] N'publication_to_add'

De naam van de publicatie waaraan de nieuwe kolom wordt toegevoegd. @publication_to_add is nvarchar(4000), met een standaardwaarde van all. Als all, dan worden alle publicaties met deze tabel beïnvloed. Als @publication_to_add is opgegeven, wordt alleen de nieuwe kolom toegevoegd aan deze publicatie.

[ @from_agent = ] from_agent

Hiermee geeft u op of de opgeslagen procedure wordt uitgevoerd door een replicatieagent. @from_agent is int, met een standaardwaarde van 0. Er wordt een waarde 1 gebruikt wanneer deze opgeslagen procedure wordt uitgevoerd door een replicatieagent en in elk ander geval moet de standaardwaarde worden 0 gebruikt.

[ @schema_change_script = ] N'schema_change_script'

Hiermee geeft u de naam en het pad op van een SQL Server-script dat wordt gebruikt om de door het systeem gegenereerde aangepaste opgeslagen procedures te wijzigen. @schema_change_script is nvarchar(4000), met een standaardwaarde van NULL. Met replicatie kunnen door de gebruiker gedefinieerde aangepaste opgeslagen procedures een of meer van de standaardprocedures vervangen die worden gebruikt in transactionele replicatie. @schema_change_script wordt uitgevoerd nadat een schemawijziging is aangebracht in een gerepliceerd tabelartikel met behulp van sp_repladdcolumnen kan als volgt worden gebruikt:

• Als aangepaste opgeslagen procedures automatisch opnieuw worden gegenereerd, kunt @schema_change_script worden gebruikt om deze aangepaste opgeslagen procedures te verwijderen en te vervangen door door de gebruiker gedefinieerde aangepaste opgeslagen procedures die ondersteuning bieden voor het nieuwe schema.

• Als aangepaste opgeslagen procedures niet automatisch opnieuw worden gegenereerd, kan @schema_change_script worden gebruikt om deze opgeslagen procedures opnieuw te genereren of om door de gebruiker gedefinieerde aangepaste opgeslagen procedures te maken.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Hiermee schakelt u de mogelijkheid in of uit om een momentopname ongeldig te maken. @force_invalidate_snapshot is bit, met een standaardwaarde van 1.

• 1 geeft aan dat wijzigingen in het artikel ertoe kunnen leiden dat de momentopname ongeldig is en als dat het geval is, wordt een waarde van het verlenen van 1 machtigingen voor de nieuwe momentopname toegestaan.

• 0 geeft aan dat wijzigingen in het artikel niet ertoe leiden dat de momentopname ongeldig is.

[ @force_reinit_subscription = ] force_reinit_subscription

Hiermee schakelt u de mogelijkheid in of uit om het abonnement opnieuw te laten initialiseren. @force_reinit_subscription is bit, met een standaardwaarde van 0.

• 0 geeft aan dat wijzigingen in het artikel niet ertoe leiden dat het abonnement opnieuw wordt geïnitialiseerd.

• 1 geeft aan dat wijzigingen in het artikel ertoe kunnen leiden dat het abonnement opnieuw wordt geïnitialiseerd en als dat het geval is, wordt een waarde van het verlenen van toestemming voor het opnieuw initialiseren van 1 het abonnement.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Permissions

Alleen leden van de vaste serverfunctie sysadmin en de db_owner vaste databaserol kunnen worden uitgevoerd sp_repladdcolumn.

Verwante inhoud

• Verouderde functies in SQL Server-replicatie
• systeemopslagprocedures (Transact-SQL)