sys.sp_changesubscription (Transact-SQL)

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

Ändrar egenskaperna hos en snapshot- eller transaktionell push-prenumeration eller en pull-prenumeration som är involverad i köad uppdatering av transaktionell replikering. För att ändra egenskaper för alla andra typer av pull-prenumerationer, använd sp_change_subscription_properties. sp_changesubscriptionkörs på Publisher i publikationsdatabasen.

Important

När en Publisher konfigureras med en fjärrdistributör skickas värdena för alla parametrar, inklusive @job_login och @job_password, till distributören som klartext. Du bör kryptera anslutningen mellan Utgivaren och dess fjärranslutna distributör innan du kör den här lagrade proceduren. Mer information finns i Konfigurera Databasmotor för SQL Server för kryptering av anslutningar.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_changesubscription
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @subscriber = ] N'subscriber'
    , [ @destination_db = ] N'destination_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @publication = ] N'publicering'

Namnet på publikationen ska ändras. @publication är sysname, utan standard.

[ @article = ] Inte en artikel'

Namnet på artikeln ska ändras. @article är sysname, utan standard.

[ @subscriber = ] N'prenumerant'

Namnet på prenumeranten. @subscriber är sysname, utan standard.

[ @destination_db = ] N'destination_db'

Namnet på prenumerationsdatabasen. @destination_db är sysname, utan standard.

[ @property = ] N'property'

Egenskapen ändras för den givna prenumerationen. @property är nvarchar(30) och kan vara ett av värdena i tabellen.

[ @value = ] N'value'

Det nya värdet för den angivna @property. @value är nvarchar(4000) och kan vara ett av värdena i tabellen.

Property Value Description
distrib_job_login Logga in för Windows-kontot som agenten körs under.
distrib_job_password Lösenord för Windows-kontot som agenten körs under.
subscriber_catalog 1 Katalog som ska användas vid anslutning till OLE DB-leverantören.
subscriber_datasource 1 Namnet på datakällan så som OLE DB-leverantören förstår.
subscriber_location 1 Databasens plats så som OLE DB-leverantören förstår.
subscriber_login Logga in namn hos Prenumeranten.
subscriber_password Starkt lösenord för den angivna inloggningen.
subscriber_security_mode 1 Använd Windows-autentisering när du ansluter till prenumeranten.
0 Använd SQL Server-autentisering när du ansluter till prenumeranten.
subscriber_provider 1 Unik programmatisk identifierare (PROGID) som OLE DB-leverantören för den icke-SQL Server-datakällan är registrerad med.
subscriber_providerstring 1 OLE DB leverantörsspecifik reťazec pripojenia som identifierar datakällan.
subscriptionstreams Antalet anslutningar som tillåts per Distribution Agent att applicera batcher av ändringar parallellt med en abonnent. Ett värdeintervall från 1 till 64 stöds för SQL Server Publishers. Denna egenskap måste gälla 0 för icke-SQL Server-prenumeranter, Oracle Publishers eller peer-to-peer-prenumerationer.
subscriber_type 1 ODBC datakällaserver
3 OLE DB-provider
memory_optimized bit Indikerar att prenumerationen stöder minnesoptimerade tabeller. memory_optimized är bit, där 1 är true (prenumerationen stödjer minnesoptimerade tabeller).

1 Denna egenskap gäller endast för icke-SQL Server-prenumeranter.

[ @publisher = ] N'publisher'

Specificerar en icke-SQL Server Publisher. @publisher är sysname, med standardvärdet .NULL

@publisher bör inte specificeras för en SQL Server Publisher.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_changesubscription används i ögonblicksbilder och transaktionsreplikering.

sp_changesubscription kan endast användas för att modifiera egenskaperna hos push-prenumerationer eller pull-prenumerationer som är involverade i köad uppdatering av transaktionell replikering. För att ändra egenskaper för alla andra typer av pull-prenumerationer, använd sp_change_subscription_properties.

Efter att ha bytt agentinloggning eller lösenord måste du stoppa och starta om agenten innan ändringen träder i kraft.

Permissions

Endast medlemmar av sysadmin-fasta serverrollen eller db_owner fasta databasrollen kan köra sp_changesubscription.

Relaterat innehåll

  • Last updated on