sp_changesubscriber (Transact-SQL)

Modifie les options d'un Abonné. Toute tâche de distribution destinée aux Abonnés à ce serveur de publication est mise à jour. Cette procédure stockée écrit dans la table MSsubscriber_info de la base de données de distribution Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication.

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

Syntaxe


sp_changesubscriber [ @subscriber= ] 'subscriber'
    [ , [ @type= ] type ]
    [ , [ @login= ] 'login' ]
    [ , [ @password= ] 'password' ]
    [ , [ @commit_batch_size= ] commit_batch_size ]
    [ , [ @status_batch_size= ] status_batch_size ]
    [ , [ @flush_frequency= ] flush_frequency ]
    [ , [ @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 ]
    [ , [ @description= ] 'description' ]
    [ , [ @security_mode= ] security_mode ]
    [ , [ @publisher = ] 'publisher' ]

Arguments

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

  • [ @type=] type
    Type de l'Abonné. typecorrespond à tinyint, avec la valeur par défaut NULL. 0 indique un Abonné MicrosoftSQL Server. 1 spécifie un abonné non-SQL Server ou un autre Abonné de serveur de source de données ODBC.

  • [ @login=] 'login'
    ID de connexion pour l'authentification SQL Server. login est de type sysname et sa valeur par défaut est NULL.

  • [ @password=] 'password'
    Mot de passe d'authentification SQL Server. password est de type sysname, avec la valeur par défaut %. % indique que la propriété de mot de passe n'est pas modifiée.

  • [ @commit_batch_size=] commit_batch_size
    Pris en charge uniquement pour des raisons de compatibilité descendante.

  • [ @status_batch_size=] status_batch_size
    Pris en charge uniquement pour des raisons de compatibilité descendante.

  • [ @flush_frequency=] flush_frequency
    Pris en charge uniquement pour des raisons de compatibilité descendante.

  • [ @frequency_type=] frequency_type
    Fréquence de planification de la tâche de distribution. frequency_type est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Une fois

    2

    À la demande

    4

    Tous les jours

    8

    Toutes les semaines

    16

    Tous les mois

    32

    Relative mensuelle

    64

    Démarrage automatique

    128

    Périodique

  • [ @frequency_interval=] frequency_interval
    Intervalle pour frequency_type. L'argument frequency_interval est de type int. Sa valeur par défaut est NULL.

  • [ @frequency_relative_interval=] frequency_relative_interval
    Date de la tâche de distribution. Ce paramètre est utilisé lorsque l'argument frequency_type a la valeur 32 (fréquence mensuelle relative). frequency_relative_interval est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Première

    2

    Deuxième

    4

    Troisième

    8

    Quatrième

    16

    Dernière

  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    Fréquence de récurrence de la tâche pendant la période définie par frequency_type. frequency_recurrence_factor est de type int, avec la valeur par défaut NULL.

  • [ @frequency_subday=] frequency_subday
    Fréquence de replanification au cours de la période définie. frequency_subday est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Une fois

    2

    Seconde

    4

    Minute

    8

    Heure

  • [ @frequency_subday_interval=] frequency_subday_interval
    Intervalle pour frequence_subday. L'argument frequency_subday_interval est de type int. Sa valeur par défaut est NULL.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Heure du jour de la première planification de la tâche de distribution, au format HHMMSS. active_start_time_of_day est de type int, avec la valeur par défaut NULL.

  • [ @active_end_time_of_day=] active_end_time_of_day
    Heure à laquelle la tâche de distribution cesse d'être planifiée, exprimée au format HHMMSS. L'argument active_end_time_of_dayest de type int, avec NULL comme valeur par défaut.

  • [ @active_start_date = ] active_start_date
    Date de première planification de la tâche de distribution, au format AAAAMMJJ. L'argument active_start_date est de type int. Sa valeur par défaut est NULL.

  • [ @active_end_date = ] active_end_date
    Date à laquelle la tâche de distribution cesse d'être planifiée, exprimée au format AAAAMMJJ. L'argument active_end_date est de type int, avec NULL comme valeur par défaut.

  • [ @description = ] 'description'
    Description de texte facultative. description est de type nvarchar(255), avec la valeur par défaut NULL.

  • [ @security_mode=] security_mode
    Mode de sécurité implémenté. security_mode est de type int et peut avoir l'une des valeurs suivantes.

    Valeur

    Description

    0

    Authentification SQL Server

    1

    Authentification Windows

  • [ @publisher= ] 'publisher'
    Spécifie un serveur de publication non-SQL Server. publisher est de type sysname. Sa valeur par défaut est NULL.

    [!REMARQUE]

    publisher ne doit pas être utilisé lors de la modification des propriétés d'article sur un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

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

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_changesubscriber.