Afficher et modifier les propriétés d’un abonnement par émission de données

Article
04/26/2023

S’applique à :SQL Server Azure SQL Database

Cette rubrique explique comment afficher et modifier les propriétés d’abonnement Push dans SQL Server à l’aide de SQL Server Management Studio, Transact-SQL ou Replication Management Objects (RMO).

Remarque

Azure SQL Managed Instance peut être un serveur de publication, un serveur de distribution et un abonné pour la réplication transactionnelle et d’instantané. Les bases de données dans Azure SQL Database peuvent uniquement être des abonnés de type push pour la réplication transactionnelle et d’instantané. Pour plus d’informations, consultez Réplication transactionnelle avec Azure SQL Database et Réplication transactionnelle avec Azure SQL Managed Instance.

Utilisation de SQL Server Management Studio

Affichez et modifiez les propriétés d'abonnement par envoi de données (push) du serveur de publication dans :

Propriétés de l’abonnement - <Éditeur> : <Boîte de dialogue PublicationDatabase> , disponible à partir de SQL Server Management Studio.
L'onglet Tous les abonnements , disponible dans le Moniteur de réplication. Pour plus d’informations sur le démarrage du Moniteur de réplication, consultez Démarrer le Moniteur de réplication.

Pour afficher et modifier les propriétés d'abonnement par envoi de données (push) dans Management Studio

Connecter au serveur de publication dans Management Studio, puis développez le nœud du serveur.
Développez le dossier Réplication , puis développez le dossier Publications locales .
Développez la publication appropriée, cliquez avec le bouton droit sur un abonnement puis cliquez sur Propriétés.
Modifiez les propriétés si nécessaire, puis cliquez sur OK.

Pour afficher et modifier les propriétés d'abonnement par envoi de données (push) dans le Moniteur de réplication

Développez un groupe Serveur de publication dans le volet gauche du moniteur de réplication, développez un serveur de publication puis cliquez sur une publication.
Cliquez sur l'onglet Tous les abonnements .
Cliquez avec le bouton droit sur un abonnement, puis cliquez sur Propriétés.
Modifiez les propriétés si nécessaire, puis cliquez sur OK.

Utilisation de Transact-SQL

Il est possible de modifier des abonnements par émission de données et d'accéder à leurs propriétés, par programme, à l'aide des procédures stockées de réplication. Les procédures stockées utilisées dépendent du type de publication auquel l'abonnement appartient.

Pour afficher les propriétés d'un abonnement par émission de données à une publication transactionnelle ou d'instantané

Exécutez sp_helpsubscriptionsur la base de données de publication du serveur de publication. Spécifiez @publication, @subscriberet la valeur all pour @article.
Exécutez sp_helpsubscriberinfo, en spécifiant @subscribersur la base de données de publication du serveur de publication.

Pour modifier les propriétés d'un abonnement par émission de données à une publication transactionnelle ou d'instantané

Exécutez sp_changesubscribersur la base de données de publication du serveur de publication, en spécifiant @subscriber et tous les paramètres des propriétés d'Abonné en cours de modification.
Exécutez sp_changesubscriptionsur la base de données de publication du serveur de publication. Spécifiez @publication, @subscriber, @destination_db, la valeur all pour @article, la propriété d'abonnement qui est changée pour @propertyet la nouvelle valeur pour @value. Cela modifie les paramètres de sécurité de l'abonnement par émission de données.
(Facultatif) Pour modifier les propriétés des packages DTS (Data Transformation Services) d'un abonnement, exécutez sp_changesubscriptiondtsinfo sur la base de données d'abonnement de l'Abonné. Spécifiez l'ID du travail de l'Agent de distribution pour @jobid et les propriétés de package DTS suivantes :
- @dts_package_name
- @dts_package_password
- @dts_package_location
Cela modifie les propriétés de package DTS d'un abonnement.

Remarque

L'ID de travail peut être obtenu en exécutant sp_helpsubscription.

Pour afficher les propriétés d'un abonnement par émission de données à une publication de fusion

Exécutez sp_helpmergesubscriptionsur la base de données de publication du serveur de publication. Spécifiez @publication et @subscriber.
Sur le serveur de publication, exécutez sp_helpsubscriberinfo, en spécifiant @subscriber.

Pour modifier les propriétés d'un abonnement par émission de données à une publication de fusion

Exécutez sp_changemergesubscriptionsur la base de données de publication du serveur de publication. Spécifiez @publication, @subscriber, @subscriber_db, la propriété de l'abonnement modifiée pour @propertyet la nouvelle valeur pour @value.

Exemple (Transact-SQL)

Utilisation d'objets RMO (Replication Management Objects)

Les classes RMO à utiliser pour afficher ou modifier les propriétés d'un abonnement par émission de données dépendent du type de publication auquel l'abonnement par émission de données a été souscrit.

Pour afficher ou modifier les propriétés d'un abonnement par émission de données à une publication transactionnelle ou d'instantané

Créez une connexion au serveur de publication en utilisant la classe ServerConnection .
Créez une instance de la classe TransSubscription.
Définissez les propriétés PublicationName, DatabaseName, SubscriberNameet SubscriptionDBName .
Définissez la classe ServerConnection créée à l'étape 1 pour le paramètre de propriété ConnectionContext .
Appelez la méthode LoadProperties pour obtenir les propriétés de l'objet. Si cette méthode retourne false, soit les propriétés de l'abonnement ont été définies de manière incorrecte à l'étape 3, soit l'abonnement n'existe pas.
(Facultatif) Pour modifier des propriétés, modifiez la valeur d'une des propriétés TransSubscription qui peuvent être définies, puis appelez la méthode CommitPropertyChanges .
(Facultatif) Pour afficher les nouveaux paramètres, appelez la méthode Refresh pour recharger les propriétés pour l'abonnement.

Pour afficher ou modifier les propriétés d'un abonnement par émission de données à une publication de fusion

Créez une connexion à l'Abonné en utilisant la classe ServerConnection .
Créez une instance de la classe MergeSubscription.
Définissez les propriétés PublicationName, DatabaseName, SubscriberNameet SubscriptionDBName .
Définissez la classe ServerConnection créée à l'étape 1 pour le paramètre de propriété ConnectionContext .
Appelez la méthode LoadProperties pour obtenir les propriétés de l'objet. Si cette méthode retourne false, soit les propriétés de l'abonnement ont été définies de manière incorrecte à l'étape 3, soit l'abonnement n'existe pas.
(Facultatif) Pour modifier des propriétés, modifiez la valeur d'une des propriétés MergeSubscription qui peuvent être définies, puis appelez la méthode CommitPropertyChanges .
(Facultatif) Pour afficher les nouveaux paramètres, appelez la méthode Refresh pour recharger les propriétés pour l'abonnement.

Voir aussi

Afficher des informations et effectuer des tâches à l’aide du moniteur de réplication
Bonnes pratiques en matière de sécurité de la réplication
S’abonner aux Publications