sys.sp_MSchange_distribution_agent_properties (Transact-SQL)

Van toepassing op:SQL Server

Verandert de eigenschappen van een Distribution Agent-taak die draait op een SQL Server 2005 (9.x) of latere versie van Distributor. Deze opgeslagen procedure wordt gebruikt om eigenschappen te wijzigen wanneer de Publisher draait op een instantie van SQL Server 2000 (8.x). Deze opgeslagen procedure wordt uitgevoerd bij de distributeur in de distributiedatabase.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_MSchange_distribution_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @subscriber = ] N'subscriber'
    , [ @subscriber_db = ] N'subscriber_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
[ ; ]

Arguments

[ @publisher = ] N'uitgever'

De naam van de uitgever. @publisher is sysname, zonder standaardinstelling.

[ @publisher_db = ] N'publisher_db'

De naam van de publicatiedatabase. @publisher_db is systeemnaam, zonder standaard.

[ @publication = ] N'publicatie'

De naam van de publicatie. @publication is sysname, zonder standaard.

[ @subscriber = ] N'abonnee'

De naam van de abonnee. @subscriber is een systeemnaam, zonder standaard.

[ @subscriber_db = ] N'subscriber_db'

De naam van de abonnementsdatabase. @subscriber_db is sysname, zonder standaard.

[ @property = ] N'eigenschap'

De publicatie-eigenschap om te veranderen. @property is een systeemnaam, zonder standaard.

[ @value = ] N'waarde'

De nieuwe eigenschapswaarde. @value is nvarchar(524), zonder standaard.

Deze tabel beschrijft de eigenschappen van de Distribution Agent-taak die kunnen worden gewijzigd, en beperkingen op de waarden voor die eigenschappen.

Property Value Description
distrib_job_login Log in op het Microsoft Windows account waaronder de agent werkt.
distrib_job_password Wachtwoord voor het Windows-account waaronder de agent-taak draait.
subscriber_catalog 1 Catalogus te gebruiken bij het maken van een verbinding met de OLE DB-provider.
subscriber_datasource 1 Naam van de gegevensbron zoals begrepen door de OLE DB-provider.
subscriber_location 1 Locatie van de database zoals begrepen door de OLE DB-provider.
subscriber_login Log in om te gebruiken wanneer je verbinding maakt met een abonnee om het abonnement te synchroniseren.
subscriber_password Wachtwoord van de abonnee.

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord.
subscriber_provider 1 Unieke programmatische identificatie (PROGID) waarmee de OLE DB-provider voor de niet-SQL Server databron is geregistreerd.
subscriber_providerstring 1 OLE DB provider-specifieke verbindingsreeks die de databron identificeert.
subscriber_security_mode 1 Windows-authenticatie.

Gebruik waar mogelijk Windows-verificatie.
0 SQL Server-verificatie.
subscriber_type 0 SQL Server-abonnee
1 ODBC databronserver
3 OLE DB-provider
subscriptionstreams 2 Geeft het aantal verbindingen aan dat per Distribution Agent is toegestaan om batches van wijzigingen parallel toe te passen op een abonnee.

1 Alleen geldig voor niet-SQL Server-abonnees.

2 Niet ondersteund voor niet-SQL Server-abonnees, Oracle Publishers of peer-to-peer abonnementen.

Opmerking

Na het wijzigen van een agent-login of wachtwoord moet je de agent stoppen en opnieuw starten voordat de wijziging van kracht wordt.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_MSchange_distribution_agent_properties wordt gebruikt bij snapshotreplicatie en transactionele replicatie.

Je kunt sp_changesubscription gebruiken op een Publisher om eigenschappen van een Merge Agent taak te wijzigen die een push-abonnement synchroniseert dat bij de distributeur draait.

toestemmingen

Alleen leden van de sysadmin-vaste serverrol bij de Distributor kunnen uitvoeren sp_MSchange_distribution_agent_properties.