sys.sp_addpullsubscription (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Voegt een pull-abonnement toe aan een snapshot of transactionele publicatie. Deze opgeslagen procedure wordt uitgevoerd bij de abonnee op de database waar het pull-abonnement wordt aangemaakt.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_addpullsubscription
    [ @publisher = ] N'publisher'
    [ , [ @publisher_db = ] N'publisher_db' ]
    , [ @publication = ] N'publication'
    [ , [ @independent_agent = ] N'independent_agent' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @description = ] N'description' ]
    [ , [ @update_mode = ] N'update_mode' ]
    [ , [ @immediate_sync = ] immediate_sync ]
[ ; ]

Arguments

[ @publisher = ] N'uitgever'

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

[ @publisher_db = ] N'publisher_db'

De naam van de Publisher-database. @publisher_db is een systeemnaam, met als standaard NULL. @publisher_db wordt genegeerd door Oracle Publishers.

[ @publication = ] N'publicatie'

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

[ @independent_agent = ] N'independent_agent'

Geeft aan of er een zelfstandige Distribution Agent voor deze publicatie is. @independent_agent is nvarchar(5), met als standaard .true

• Als true, is er een zelfstandige Distribution Agent voor deze publicatie.
• Als false, is er één Distribution Agent voor elk Publisher-database/Subscriber database-paar.

@independent_agent is een eigendom van de publicatie en moet dezelfde waarde hebben als de Publisher.

[ @subscription_type = ] N'subscription_type'

Het soort abonnement. @subscription_type is nvarchar(9), met een standaard van anonymous. Je moet een waarde van pull voor @subscription_type specificeren, tenzij je een abonnement wilt aanmaken zonder het abonnement op de Publisher te registreren. In dit geval moet je een waarde van anonymousspecificeren. Dit is noodzakelijk in gevallen waarin je tijdens het abonnement geen SQL Server-verbinding met de Publisher kunt opzetten.

[ @description = ] Beschrijving van'

De beschrijving van de publicatie. @description is nvarchar(100), met een standaard van NULL.

[ @update_mode = ] N'update_mode'

Het type update. @update_mode is nvarchar(30) en kan een van de volgende waarden zijn.

[ @immediate_sync = ] immediate_sync

Hiermee geeft u op of de synchronisatiebestanden worden gemaakt of opnieuw worden gemaakt telkens wanneer de momentopnameagent wordt uitgevoerd. @immediate_sync is bit, met een standaard van 1, en moet worden ingesteld op dezelfde waarde als @immediate_sync in sp_addpublication. @immediate_sync is een eigendom van de publicatie en moet dezelfde waarde hebben als de Publisher.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_addpullsubscription wordt gebruikt bij snapshotreplicatie en transactionele replicatie.

Als de MSreplication_subscriptions-tabel niet bestaat bij de Abonnee, sp_addpullsubscription maakt hij deze aan. Het voegt ook een rij toe aan de MSreplication_subscriptions tabel. Voor pull-abonnementen moet sp_addsubscription eerst op de Publisher worden aangeroepen.

Examples

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2022Replica]
EXEC sp_addpullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

-- Add an agent job to synchronize the pull subscription.
EXEC sp_addpullsubscription_agent 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication, 
  @distributor = @publisher, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

Permissions

Alleen leden van de sysadmin-vaste serverrol of db_owner vaste databaserol kunnen uitvoeren sp_addpullsubscription.

Verwante inhoud

• Maak een Pull-abonnement aan
• Een updatable abonnement maken op een transactionele publicatie
• Abonneren op publicaties
• sp_addpullsubscription_agent (Transact-SQL)
• sp_change_subscription_properties (Transact-SQL)
• sp_droppullsubscription (Transact-SQL)
• sp_helppullsubscription (Transact-SQL)
• sp_helpsubscription_properties (Transact-SQL)
• systeemopslagprocedures (Transact-SQL)