sp_change_subscription_properties (Transact-SQL)

Article
05/07/2013

Met à jour les informations pour les abonnements par extraction de données (pull). Cette procédure stockée est exécutée sur la base de données d'abonnement au niveau de l'Abonné.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_change_subscription_properties [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value'
    [ , [ @publication_type = ] publication_type ]

Arguments

[ @publisher=] 'publisher'
Nom du serveur de publication. publisher est de type sysname, sans valeur par défaut.
[ @publisher_db=] 'publisher_db'
Nom de la base de données du serveur de publication. publisher_db est de type sysname, sans valeur par défaut.
[ @publication=] 'publication'
Nom de la publication. publication est de type sysname, sans valeur par défaut.
[ @property=] 'property'
Nom de la propriété à modifier. property est de type sysname.
[ @value=] 'value'
Nouvelle valeur de la propriété. value est de type nvarchar(1000), sans valeur par défaut.

[ @publication_type = ] publication_type
Indique le type de réplication de la publication. publication_type est de type int et peut prendre l'une des valeurs suivantes.

Valeur	Type de publication
0	Transactionnelle
1	Snapshot
2	Merge
NULL (par défaut)	La réplication détermine le type de publication. La procédure stockée devant consulter plusieurs tables, cette option est plus lente que lorsque le type de publication exact est fourni.

Le tableau ci-dessous décrit les propriétés des articles et les valeurs de ces propriétés.

Propriété	Valeur	Description
alt_snapshot_folder		Spécifie l'emplacement du dossier alternatif de l'instantané. Si l'argument est défini à NULL, les fichiers d'instantané sont prélevés à l'emplacement par défaut spécifié par le serveur de publication.
distrib_job_login		Nom de connexion du compte Microsoft Windows sous lequel l'Agent s'exécute.
distrib_job_password		Mot de passe du compte Windows sous lequel l'Agent s'exécute.
distributor_login		Nom de connexion du serveur de distribution.
distributor_password		Mot de passe du serveur de distribution.
distributor_security_mode	1	Utilise l'authentification Windows pour la connexion au serveur de distribution.
	0	Utilise l'authentification SQL Server pour la connexion au serveur de distribution.
dts_package_name		Définit le nom du package DTS (Data Transformation Services) SQL Server 2000. Cette valeur peut être définie seulement s'il s'agit d'une publication transactionnelle ou d'instantané.
dts_package_password		Spécifie le mot de passe du package. dts_package_password est de type sysname avec la valeur par défaut NULL qui indique que la propriété de mot de passe ne doit pas être modifiée. [!REMARQUE] Un package DTS doit avoir un mot de passe. Cette valeur peut être spécifiée seulement s'il s'agit d'une publication transactionnelle ou d'instantané.
dts_package_location		Emplacement où le package DTS est stocké. Cette valeur peut être spécifiée seulement s'il s'agit d'une publication transactionnelle ou d'instantané.
dynamic_snapshot_location		Indique le chemin d'accès au dossier dans lequel les fichiers d'instantané sont enregistrés. Cette valeur peut être spécifiée seulement s'il s'agit d'une publication de fusion.
ftp_address		Pour compatibilité descendante uniquement.
ftp_login		Pour compatibilité descendante uniquement.
ftp_password		Pour compatibilité descendante uniquement.
ftp_port		Pour compatibilité descendante uniquement.
hostname		Nom d'hôte utilisé pour la connexion au serveur de publication
internet_login		Connexion que l'Agent de fusion utilise pour se connecter, à l'aide de l'authentification de base, au serveur Web qui héberge la synchronisation Web.
internet_password		Mot de passe qu'utilise l'Agent de fusion lors de la connexion au serveur Web qui héberge la synchronisation Web avec l'authentification de base.
internet_security_mode	1	Utilise l'authentification intégrée Windows pour la synchronisation Web. Il est recommandé d'utiliser l'authentification de base pour la synchronisation Web. Pour plus d'informations, consultez Configurer la synchronisation Web.
	0	Utiliser l'authentification de base pour la synchronisation Web. [!REMARQUE] La synchronisation Web nécessite une connexion SSL au serveur Web.
internet_timeout		Délai en secondes avant l'expiration d'une demande de synchronisation Web.
internet_url		URL qui représente l'emplacement de l'écouteur de réplication de la synchronisation Web.
merge_job_login		Nom de connexion du compte Windows sous lequel l'Agent s'exécute.
merge_job_password		Mot de passe du compte Windows sous lequel l'Agent s'exécute.
publisher_login		Nom de connexion du serveur de publication La modification de publisher_login n'est possible qu'avec les abonnements aux publications de fusion.
publisher_password		Mot de passe du serveur de publication. La modification de publisher_password n'est possible qu'avec les abonnements aux publications de fusion.
publisher_security_mode	1	Utiliser l'authentification Windows pour la connexion au serveur de publication. La modification de publisher_security_mode n'est possible qu'avec les abonnements aux publications de fusion.
	0	Utiliser l'authentification SQL Server pour la connexion au serveur de publication.
use_ftp	true	Utiliser FTP au lieu du protocole standard pour extraire les instantanés.
	false	Utiliser le protocole standard pour extraire les instantanés.
use_web_sync	true	Active la synchronisation Web.
	false	Désactive la synchronisation Web.
working_directory		Nom du répertoire de travail utilisé pour stocker temporairement les fichiers de données et de schéma de la publication lorsque le protocole FTP (File Transfer Protocol) est utilisé pour transférer des fichiers d'instantané.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_change_subscription_properties est utilisé dans tous les types de réplications.

sp_change_subscription_properties est utilisé avec les abonnements par extraction de données (pull).

Pour les serveurs de publication Oracle, la valeur de publisher_db est ignorée du fait que Oracle n'autorise qu'une seule base de données par instance du serveur.

Autorisations

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_change_subscription_properties.