sp_addpullsubscription_agent (Transact-SQL)sp_addpullsubscription_agent (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Ajoute un nouveau travail de l'Agent planifié, utilisé pour synchroniser un abonnement par extraction de données (pull) avec une publication transactionnelle.Adds a new scheduled agent job used to synchronize a pull subscription to a transactional publication. Cette procédure stockée est exécutée sur la base de données d'abonnement de l'Abonné.This stored procedure is executed at the Subscriber on the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_addpullsubscription_agent [ @publisher = ] 'publisher'  
    [ , [ @publisher_db = ] 'publisher_db' ]          , [ @publication = ] 'publication'  
    [ , [ @subscriber = ] 'subscriber' ]  
    [ , [ @subscriber_db = ] 'subscriber_db' ]  
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]  
    [ , [ @subscriber_login = ] 'subscriber_login' ]  
    [ , [ @subscriber_password = ] 'subscriber_password' ]  
    [ , [ @distributor = ] 'distributor' ]  
    [ , [ @distribution_db = ] 'distribution_db' ]  
    [ , [ @distributor_security_mode = ] distributor_security_mode ]  
    [ , [ @distributor_login = ] 'distributor_login' ]  
    [ , [ @distributor_password = ] 'distributor_password' ]  
    [ , [ @optional_command_line = ] 'optional_command_line' ]  
    [ , [ @frequency_type = ] frequency_type ]  
    [ , [ @frequency_interval = ] frequency_interval ]  
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]  
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]  
    [ , [ @frequency_subday = ] frequency_subday ]  
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]  
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]  
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]  
    [ , [ @active_start_date = ] active_start_date ]  
    [ , [ @active_end_date = ] active_end_date ]  
    [ , [ @distribution_jobid = ] distribution_jobid OUTPUT ]  
    [ , [ @encrypted_distributor_password = ] encrypted_distributor_password ]  
    [ , [ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' ]  
    [ , [ @ftp_address = ] 'ftp_address' ]  
    [ , [ @ftp_port = ] ftp_port ]  
    [ , [ @ftp_login = ] 'ftp_login' ]  
    [ , [ @ftp_password = ] 'ftp_password' ]  
    [ , [ @alt_snapshot_folder = ] 'alternate_snapshot_folder' ]  
    [ , [ @working_directory = ] 'working_directory' ]  
    [ , [ @use_ftp = ] 'use_ftp' ]  
    [ , [ @publication_type = ] publication_type ]  
    [ , [ @dts_package_name = ] 'dts_package_name' ]  
    [ , [ @dts_package_password = ] 'dts_package_password' ]  
    [ , [ @dts_package_location = ] 'dts_package_location' ]  
    [ , [ @reserved = ] 'reserved' ]  
    [ , [ @offloadagent = ] 'remote_agent_activation' ]  
    [ , [ @offloadserver = ] 'remote_agent_server_name']  
    [ , [ @job_name = ] 'job_name' ]  
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

ArgumentsArguments

[ @publisher = ] 'publisher'Nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. Publisher est de type sysname, sans valeur par défaut.publisher is sysname, with no default.

[ @publisher_db = ] 'publisher_db'_Nom de la base de données du serveur de publication.[ @publisher_db = ] 'publisher_db'_ Is the name of the Publisher database. publisher_db est de type sysname, avec NULL comme valeur par défaut.publisher_db is sysname, with a default value of NULL. publisher_db est ignoré par les serveurs de publication Oracle.publisher_db is ignored by Oracle Publishers.

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @subscriber = ] 'subscriber'Nom de l’instance de l’abonné ou nom de l’écouteur GA si la base de données de l’abonné se trouve dans un groupe de disponibilité.[ @subscriber = ] 'subscriber' Is the name of the Subscriber instance or the name of the AG listener if the subscriber database is in an availability group. Subscriber est de type sysname, avec NULL comme valeur par défaut.subscriber is sysname, with a default of NULL.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts.

[ @subscriber_db = ] 'subscriber_db'Nom de la base de données d’abonnement.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. subscriber_db est de type sysname, avec NULL comme valeur par défaut.subscriber_db is sysname, with a default of NULL.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts.

[ @subscriber_security_mode = ] subscriber_security_modeMode de sécurité à utiliser lors de la connexion à un abonné au cours d’une synchronisation.[ @subscriber_security_mode = ] subscriber_security_mode Is the security mode to use when connecting to a Subscriber when synchronizing. subscriber_security_mode est de type int, avec NULL comme valeur par défaut.subscriber_security_mode is int, with a default of NULL. 0 spécifie SQL ServerSQL Server l’authentification.0 specifies SQL ServerSQL Server Authentication. 1 spécifie l’authentification Windows.1 specifies Windows Authentication.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. L'Agent de distribution se connecte toujours à l'Abonné local à l'aide de l'authentification Windows.The Distribution Agent always connects to the local Subscriber using Windows Authentication. Si une valeur autre que NULL ou 1 est spécifiée pour ce paramètre, un message d’avertissement est retourné.If a value other than NULL or 1 is specified for this parameter, a warning message is returned.

[ @subscriber_login = ] 'subscriber_login'Connexion de l’abonné à utiliser lors de la connexion à un abonné au cours d’une synchronisation. subscriber_login est de type sysname, avec NULL comme valeur par défaut.[ @subscriber_login = ] 'subscriber_login' Is the Subscriber login to use when connecting to a Subscriber when synchronizing.subscriber_login is sysname, with a default of NULL.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. Si une valeur est précisée pour ce paramètre, un message d'avertissement est retourné mais la valeur reste ignorée.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @subscriber_password = ] 'subscriber_password'Mot de passe de l’abonné.[ @subscriber_password = ] 'subscriber_password' Is the Subscriber password. subscriber_password est obligatoire si subscriber_security_mode est défini sur 0.subscriber_password is required if subscriber_security_mode is set to 0. subscriber_password est de type sysname, avec NULL comme valeur par défaut.subscriber_password is sysname, with a default of NULL. Si un mot de passe d'abonné est utilisé, il est automatiquement chiffré.If a subscriber password is used, it is automatically encrypted.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. Si une valeur est précisée pour ce paramètre, un message d'avertissement est retourné mais la valeur reste ignorée.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @distributor = ] 'distributor'Nom du serveur de distribution.[ @distributor = ] 'distributor' Is the name of the Distributor. Distributor est de type sysname, avec la valeur par défaut spécifiée par le serveur de publication.distributor is sysname, with a default of the value specified by publisher.

[ @distribution_db = ] 'distribution_db'Nom de la base de données de distribution.[ @distribution_db = ] 'distribution_db' Is the name of the distribution database. distribution_db est de type sysname, avec NULL comme valeur par défaut.distribution_db is sysname, with a default value of NULL.

[ @distributor_security_mode = ] distributor_security_modeMode de sécurité à utiliser lors de la connexion à un serveur de distribution lors de la synchronisation.[ @distributor_security_mode = ] distributor_security_mode Is the security mode to use when connecting to a Distributor when synchronizing. distributor_security_mode est de type int, avec 1comme valeur par défaut.distributor_security_mode is int, with a default of 1. 0 spécifie SQL ServerSQL Server l’authentification.0 specifies SQL ServerSQL Server Authentication. 1 spécifie l’authentification Windows.1 specifies Windows Authentication.

Important

Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows authentication.

[ @distributor_login = ] 'distributor_login'Connexion du serveur de distribution à utiliser lors de la connexion à un serveur de distribution lors de la synchronisation.[ @distributor_login = ] 'distributor_login' Is the Distributor login to use when connecting to a Distributor when synchronizing. distributor_login est obligatoire si distributor_security_mode est défini sur 0.distributor_login is required if distributor_security_mode is set to 0. distributor_login est de type sysname, avec NULL comme valeur par défaut.distributor_login is sysname, with a default of NULL.

[ @distributor_password = ] 'distributor_password'Est le mot de passe du serveur de distribution.[ @distributor_password = ] 'distributor_password' Is the Distributor password. distributor_password est obligatoire si distributor_security_mode est défini sur 0.distributor_password is required if distributor_security_mode is set to 0. distributor_password est de type sysname, avec NULL comme valeur par défaut.distributor_password is sysname, with a default of NULL.

Important

N'utilisez pas de mot de passe vide.Do not use a blank password. Utilisez un mot de passe fort.Use a strong password. Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

[ @optional_command_line = ] 'optional_command_line'Est une invite de commandes facultative fournie au Agent de distribution.[ @optional_command_line = ] 'optional_command_line' Is an optional command prompt supplied to the Distribution Agent. Par exemple, -DefinitionFile C:\Distdef.txt ou -CommitBatchSize 10.For example, -DefinitionFile C:\Distdef.txt or -CommitBatchSize 10. optional_command_line est de type nvarchar (4000) , avec une chaîne vide comme valeur par défaut.optional_command_line is nvarchar(4000), with a default of empty string.

[ @frequency_type = ] frequency_typeFréquence de planification de l’Agent de distribution.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the Distribution Agent. frequency_type est de type intet peut prendre l’une des valeurs suivantes.frequency_type is int, and can be one of the following values.

ValueValue DescriptionDescription
11 Une foisOne time
2 (par défaut)2 (default) À la demandeOn demand
44 Tous les joursDaily
88 SemaineWeekly
1616 MoisMonthly
3232 Mensuelle relativeMonthly relative
6464 Démarrage automatiqueAutostart
128128 PériodiqueRecurring

Notes

Si vous spécifiez la valeur 64 , le agent de distribution s’exécute en mode continu.Specifying a value of 64 causes the Distribution Agent to run in continuous mode. Cela correspond à la définition du paramètre -Continuous pour l’agent.This corresponds to setting the -Continuous parameter for the agent. Pour plus d'informations, consultez Replication Distribution Agent.For more information, see Replication Distribution Agent.

[ @frequency_interval = ] frequency_intervalValeur à appliquer à la fréquence définie par frequency_type.[ @frequency_interval = ] frequency_interval Is the value to apply to the frequency set by frequency_type. frequency_interval est de type int, avec 1 comme valeur par défaut.frequency_interval is int, with a default of 1.

[ @frequency_relative_interval = ] frequency_relative_intervalDate de la Agent de distribution.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the Distribution Agent. Ce paramètre est utilisé lorsque frequency_type a la valeur 32 (mensuelle relative).This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_interval est de type intet peut prendre l’une des valeurs suivantes.frequency_relative_interval is int, and can be one of the following values.

ValueValue DescriptionDescription
1 (par défaut)1 (default) PremièreFirst
22 SecondeSecond
44 TroisièmeThird
88 QuatrièmeFourth
1616 DernièreLast

[ @frequency_recurrence_factor = ] frequency_recurrence_factorFacteur de récurrence utilisé par frequency_type.[ @frequency_recurrence_factor = ] frequency_recurrence_factor Is the recurrence factor used by frequency_type. frequency_recurrence_factor est de type int, avec 1comme valeur par défaut.frequency_recurrence_factor is int, with a default of 1.

[ @frequency_subday = ] frequency_subdayFréquence de replanification au cours de la période définie.[ @frequency_subday = ] frequency_subday Is how often to reschedule during the defined period. frequency_subday est de type intet peut prendre l’une des valeurs suivantes.frequency_subday is int, and can be one of the following values.

ValueValue DescriptionDescription
1 (par défaut)1 (default) Une foisOnce
22 SecondeSecond
44 MinuteMinute
88 HeureHour

[ @frequency_subday_interval = ] frequency_subday_intervalIntervalle de frequency_subday.[ @frequency_subday_interval = ] frequency_subday_interval Is the interval for frequency_subday. frequency_subday_interval est de type int, avec 1comme valeur par défaut.frequency_subday_interval is int, with a default of 1.

[ @active_start_time_of_day = ] active_start_time_of_dayHeure de la journée à laquelle le Agent de distribution est planifié pour la première fois, au format HHMMSS.[ @active_start_time_of_day = ] active_start_time_of_day Is the time of day when the Distribution Agent is first scheduled, formatted as HHMMSS. active_start_time_of_day est de type int, avec 0comme valeur par défaut.active_start_time_of_day is int, with a default of 0.

[ @active_end_time_of_day = ] active_end_time_of_dayHeure de la journée à laquelle le Agent de distribution cesse d’être planifié, au format HHMMSS.[ @active_end_time_of_day = ] active_end_time_of_day Is the time of day when the Distribution Agent stops being scheduled, formatted as HHMMSS. active_end_time_of_day est de type int, avec 0comme valeur par défaut.active_end_time_of_day is int, with a default of 0.

[ @active_start_date = ] active_start_dateDate à laquelle le Agent de distribution est planifié pour la première fois, au format AAAAMMJJ.[ @active_start_date = ] active_start_date Is the date when the Distribution Agent is first scheduled, formatted as YYYYMMDD. active_start_date est de type int, avec 0comme valeur par défaut.active_start_date is int, with a default of 0.

[ @active_end_date = ] active_end_dateDate à laquelle le Agent de distribution cesse d’être planifié, au format AAAAMMJJ.[ @active_end_date = ] active_end_date Is the date when the Distribution Agent stops being scheduled, formatted as YYYYMMDD. active_end_date est de type int, avec 0comme valeur par défaut.active_end_date is int, with a default of 0.

[ @distribution_jobid = ] _distribution_jobidOUTPUTID de la Agent de distribution pour ce travail.[ @distribution_jobid = ] _distribution_jobidOUTPUT Is the ID of the Distribution Agent for this job. distribution_jobid est de type Binary (16) , avec NULL comme valeur par défaut. il s’agit d’un paramètre de sortie.distribution_jobid is binary(16), with a default of NULL, and it is an OUTPUT parameter.

[ @encrypted_distributor_password = ] encrypted_distributor_passwordLa définition de encrypted_distributor_password n’est plus prise en charge.[ @encrypted_distributor_password = ] encrypted_distributor_password Setting encrypted_distributor_password is no longer supported. Si vous tentez de définir ce paramètre de bit sur 1 , une erreur se produit.Attempting to set this bit parameter to 1 will result in an error.

[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'Indique si l’abonnement peut être synchronisé via MicrosoftMicrosoft le gestionnaire de synchronisation.[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' Is whether the subscription can be synchronized through MicrosoftMicrosoft Synchronization Manager. enabled_for_syncmgr est de type nvarchar (5) , avec false comme valeur par défaut.enabled_for_syncmgr is nvarchar(5), with a default of FALSE. Si la valeurest false, l’abonnement n’est pas inscrit auprès du gestionnaire de synchronisation.If false, the subscription is not registered with Synchronization Manager. Si la valeur est true, l’abonnement est inscrit auprès du gestionnaire de synchronisation et peut SQL Server Management StudioSQL Server Management Studioêtre synchronisé sans démarrage.If true, the subscription is registered with Synchronization Manager and can be synchronized without starting SQL Server Management StudioSQL Server Management Studio.

[ @ftp_address = ] 'ftp_address'À des fins de compatibilité descendante uniquement.[ @ftp_address = ] 'ftp_address' For backward compatibility only.

[ @ftp_port = ] ftp_portÀ des fins de compatibilité descendante uniquement.[ @ftp_port = ] ftp_port For backward compatibility only.

[ @ftp_login = ] 'ftp_login'À des fins de compatibilité descendante uniquement.[ @ftp_login = ] 'ftp_login' For backward compatibility only.

[ @ftp_password = ] 'ftp_password'À des fins de compatibilité descendante uniquement.[ @ftp_password = ] 'ftp_password' For backward compatibility only.

[ @alt_snapshot_folder = ] 'alternate_snapshot_folder'_Spécifie l’emplacement du dossier de remplacement pour l’instantané.[ @alt_snapshot_folder = ] 'alternate_snapshot_folder'_ Specifies the location of the alternate folder for the snapshot. alternate_snapshot_folder est de type nvarchar (255) , avec NULL comme valeur par défaut.alternate_snapshot_folder is nvarchar(255), with a default of NULL.

[ @working_directory = ] 'working_director'Nom du répertoire de travail utilisé pour stocker les fichiers de données et de schéma de la publication.[ @working_directory = ] 'working_director' Is the name of the working directory used to store data and schema files for the publication. working_directory est de type nvarchar (255) , avec NULL comme valeur par défaut.working_directory is nvarchar(255), with a default of NULL. Le nom doit être indiqué au format UNC.The name should be specified in UNC format.

[ @use_ftp = ] 'use_ftp'Spécifie l’utilisation de FTP au lieu du protocole normal pour récupérer des instantanés.[ @use_ftp = ] 'use_ftp' Specifies the use of FTP instead of the regular protocol to retrieve snapshots. use_ftp est de type nvarchar (5) , avec false comme valeur par défaut.use_ftp is nvarchar(5), with a default of FALSE.

[ @publication_type = ] publication_typeSpécifie le type de réplication de la publication.[ @publication_type = ] publication_type Specifies the replication type of the publication. publication_type est de type tinyint , avec 0comme valeur par défaut.publication_type is a tinyint with a default of 0. Si la valeur est 0, la publication est un type de transaction.If 0, publication is a transaction type. Si la variable est 1, la publication est de type instantané.If 1, publication is a snapshot type. Si la condition est 2, la publication est de type fusion.If 2, publication is a merge type.

[ @dts_package_name = ] 'dts_package_name'Spécifie le nom du package DTS.[ @dts_package_name = ] 'dts_package_name' Specifies the name of the DTS package. dts_package_name est de type sysname , avec NULL comme valeur par défaut.dts_package_name is a sysname with a default of NULL. Par exemple, pour spécifier un package nommé DTSPub_Package, le paramètre est le suivant : @dts_package_name = N'DTSPub_Package'.For example, to specify a package of DTSPub_Package, the parameter would be @dts_package_name = N'DTSPub_Package'.

[ @dts_package_password = ] 'dts_package_password'Spécifie le mot de passe du package, le cas échéant.[ @dts_package_password = ] 'dts_package_password' Specifies the password on the package, if there is one. dts_package_password est de type sysname , avec NULL comme valeur par défaut, ce qui signifie qu’aucun mot de passe n’est présent sur le package.dts_package_password is sysname with a default of NULL, which means a password is not on the package.

Notes

Vous devez spécifier un mot de passe si dts_package_name est spécifié.You must specify a password if dts_package_name is specified.

[ @dts_package_location = ] 'dts_package_location'Spécifie l’emplacement du package.[ @dts_package_location = ] 'dts_package_location' Specifies the package location. dts_package_location est de type nvarchar (12) , avec l' abonnécomme valeur par défaut.dts_package_location is a nvarchar(12), with a default of subscriber. L’emplacement du package peut être Distributor ou Subscriber.The location of the package can be distributor or subscriber.

[ @reserved = ] 'reserved' Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @reserved = ] 'reserved' Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

[ @offloadagent = ] 'remote_agent_activation'

Notes

L'activation d'agent distant est déconseillée et n'est plus prise en charge.Remote agent activation has been deprecated and is no longer supported. Ce paramètre est uniquement pris en charge pour assurer la compatibilité descendante des scripts.This parameter is supported only to maintain backward compatibility of scripts. La définition de remote_agent_activation sur une valeur autre que false génère une erreur.Setting remote_agent_activation to a value other than false will generate an error.

[ @offloadserver = ] 'remote_agent_server_name'

Notes

L'activation d'agent distant est déconseillée et n'est plus prise en charge.Remote agent activation has been deprecated and is no longer supported. Ce paramètre est uniquement pris en charge pour assurer la compatibilité descendante des scripts.This parameter is supported only to maintain backward compatibility of scripts. Si vous affectez à remote_agent_server_name une valeur non null, une erreur est générée.Setting remote_agent_server_name to any non-NULL value will generate an error.

[ @job_name = ] 'job_name'Nom d’un travail d’agent existant.[ @job_name = ] 'job_name' Is the name of an existing agent job. nom_du_travail est de type sysname, avec NULL comme valeur par défaut.job_name is sysname, with a default value of NULL. Ce paramètre n'est indiqué que lorsque l'abonnement est synchronisé grâce à un travail existant plutôt qu'un nouveau travail (étant le comportement par défaut).This parameter is only specified when the subscription will be synchronized using an existing job instead of a newly created job (the default). Si vous n’êtes pas membre du rôle serveur fixe sysadmin , vous devez spécifier job_login et job_password lorsque vous spécifiez nom_du_travail.If you are not a member of the sysadmin fixed server role, you must specify job_login and job_password when you specify job_name.

[ @job_login = ] 'job_login'Nom de connexion du compte Windows sous lequel l’agent s’exécute.[ @job_login = ] 'job_login' Is the login for the Windows account under which the agent runs. job_login est de type nvarchar (257) , sans valeur par défaut.job_login is nvarchar(257), with no default. C'est ce compte Windows qui est destiné à toujours être utilisé pour les connexions des Agents à l'Abonné.This Windows account is always used for agent connections to the Subscriber.

[ @job_password = ] 'job_password'Mot de passe du compte Windows sous lequel l’agent s’exécute.[ @job_password = ] 'job_password' Is the password for the Windows account under which the agent runs. job_password est de type sysname, sans valeur par défaut.job_password is sysname, with no default.

Important

Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_addpullsubscription_agent est utilisé dans la réplication d’instantané et la réplication transactionnelle.sp_addpullsubscription_agent is used in snapshot replication and transactional replication.

ExempleExample

-- 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'AdventureWorks2012';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2012Replica]
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

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_addpullsubscription_agent.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addpullsubscription_agent.

Voir aussiSee Also

Créer un abonnement par extraction de données Create a Pull Subscription
S’abonner aux Publications Subscribe to Publications
sp_addpullsubscription (Transact-SQL) sp_addpullsubscription (Transact-SQL)
sp_change_subscription_properties (Transact-SQL) sp_change_subscription_properties (Transact-SQL)
sp_droppullsubscription (Transact-SQL) sp_droppullsubscription (Transact-SQL)
sp_helppullsubscription (Transact-SQL) sp_helppullsubscription (Transact-SQL)
sp_helpsubscription_properties (Transact-SQL)sp_helpsubscription_properties (Transact-SQL)