Partager via

  • Article

sp_MSchange_distribution_agent_properties (Transact-SQL)

Modifie les propriétés d'un travail d'Agent de distribution exécuté sur un serveur de distribution MicrosoftSQL Server 2005 ou version ultérieure. Cette procédure stockée est utilisée pour modifier des propriétés lorsque le serveur de publication s'exécute sur une instance de SQL Server 2000. Cette procédure stockée est exécutée sur la base de données de distribution du serveur de distribution.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication' 
        , [ @subscriber = ] 'subscriber' 
        , [ @subscriber_db = ] 'subscriber_db' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value' ]

Arguments

  • [ @publisher = ] 'publisher'
    Nom du serveur de publication. L'argument publisher est de type sysname et n'a pas de valeur par défaut.

  • [ @publisher_db= ] 'publisher_db'
    Nom de la base de données de publication. L'argument publisher_db est de type sysname et n'a pas de valeur par défaut.

  • [ @publication=] 'publication'
    Nom de la publication. publication est de type sysname et n'a pas de valeur par défaut.

  • [ @subscriber= ] 'subscriber'
    Nom de l'Abonné. L'argument subscriber est de type sysname et n'a pas de valeur par défaut.

  • [ @subscriber_db= ] 'subscriber_db'
    Nom de la base de données d'abonnement. L'argument subscriber_db est de type sysname et n'a pas de valeur par défaut.

  • [ @property=] 'property'
    Nom de la propriété de publication à modifier. property est de type sysname, sans valeur par défaut.

  • [ @value=] 'value'
    Nouvelle valeur de la propriété. value est de type nvarchar(524). Sa valeur par défaut est NULL.

    Le tableau ci-dessous décrit les propriétés modifiables du travail de l'Agent de distribution et les limites liées aux valeurs de ces propriétés.

    Propriété

    Valeur

    Description

    distrib_job_login

    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.

    subscriber_catalog

    Catalogue utilisé lors d’une connexion à un fournisseur OLE DB. Cette propriété est uniquement valide pour les Abonnés non-SQL Server.

    subscriber_datasource

    Nom de la source de données tel que reconnu par le fournisseur OLE DB. Cette propriété est uniquement valide pour les Abonnés non-SQL Server.

    subscriber_location

    Emplacement de la base de données tel que reconnu par le fournisseur OLE DB. Cette propriété est uniquement valide pour les Abonnés non-SQL Server.

    subscriber_login

    Nom de connexion à utiliser lors de la connexion à un Abonné afin de synchroniser l'abonnement.

    subscriber_password

    Mot de passe de l'Abonné.

    N'utilisez pas de mot de passe vide. Utilisez un mot de passe fort.

    subscriber_provider

    Identificateur programmatique (PROGID) avec lequel est inscrit le fournisseur OLE DB de la source de données non-SQL Server. Cette propriété est uniquement valide pour les Abonnés non-SQL Server.

    subscriber_providerstring

    Chaîne de connexion spécifique au fournisseur OLE DB qui identifie la source de données. Cette propriété est uniquement valide pour les Abonnés non-SQL Server.

    subscriber_security_mode

    1

    Authentification Windows.

    Lorsque c'est possible, utilisez l'authentification Windows.

    0

    Authentification SQL Server.

    subscriber_type

    0

    Abonné SQL Server

    1

    Serveur de la source de données ODBC

    3

    Fournisseur OLE DB

    subscriptionstreams

    Indique le nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné. Propriété non prise en charge pour les Abonnés non-SQL Server, les serveurs de publication Oracle ou les abonnements d'égal à égal.

    [!REMARQUE]

    Après avoir modifié une connexion ou un mot de passe d'Agent, vous devez arrêter puis redémarrer l'Agent pour que les modifications prennent effet.

Valeurs des codes de retour

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

Notes

sp_MSchange_distribution_agent_properties est utilisée dans la réplication de capture instantanée et dans la réplication transactionnelle.

Lorsque le serveur de publication s'exécute sur une instance de SQL Server 2005 ou version ultérieure, vous devez utiliser sp_changesubscription pour modifier les propriétés d'un travail d'Agent de fusion qui synchronise un abonnement par émission de données (push) qui s'exécute sur le serveur de distribution.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de distribution peuvent exécuter sp_MSchange_distribution_agent_properties.