sp_changepublication_snapshot (Transact-SQL)

Mis à jour : 12 décembre 2006

Modifie les propriétés de l'Agent de capture instantanée pour la publication spécifiée. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données de publication.

ms178574.security(fr-fr,SQL.90).gifRemarque relative à la sécurité :
 Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées au serveur de distribution en texte brut. Vous devriez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée. Pour plus d'informations, consultez Chiffrement des connexions à SQL Server.

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

Syntaxe

sp_changepublication_snapshot [ @publication= ] 'publication'
    [ , [ @frequency_type= ] frequency_type ]
    [ , [ @frequency_interval= ] frequency_interval ]
    [ , [ @frequency_subday= ] frequency_subday ]
    [ , [ @frequency_subday_interval= ] frequency_subday_interval ]
    [ , [ @frequency_relative_interval= ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor= ] frequency_recurrence_factor ]
    [ , [ @active_start_date= ] active_start_date ]
    [ , [ @active_end_date= ] active_end_date ]
    [ , [ @active_start_time_of_day= ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day= ] active_end_time_of_day ]
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher = ] 'publisher' ]

Arguments

  • [ **@publication=**\] 'publication'
    Nom de la publication. publication est de type sysname et n'a pas de valeur par défaut.
  • [ **@frequency\_type=**\] frequency_type
    Fréquence de planification de l'Agent. frequency_type est de type int et peut prendre l'une des valeurs suivantes.

    Valeur Description

    1

    Une fois

    2

    À la demande

    4

    Quotidienne

    8

    Hebdomadaire

    16

    Mensuelle

    32

    Mensuelle relative

    64

    Démarrage automatique

    128

    Périodique

    NULL (valeur par défaut)

     

  • [ **@frequency\_interval=**\] frequency_interval
    Jours où l'Agent est exécuté. frequency_interval est de type int et peut prendre l'une des valeurs suivantes.

    Valeur Description

    1

    Dimanche

    2

    Lundi

    3

    Mardi

    4

    Mercredi

    5

    Jeudi

    6

    Vendredi

    7

    Samedi

    8

    Jour

    9

    Jours de la semaine

    10

    Jours de week-end

    NULL (par défaut)

     

  • [ **@frequency\_subday=**\] frequency_subday
    Unités de l'argument freq_subday_interval. L'argument frequency_subday est de type int et peut prendre l'une des valeurs suivantes.

    Valeur Description

    1

    Une fois

    2

    Deuxième

    4

    Minute

    8

    Heure

    NULL (valeur par défaut)

     

  • [ **@frequency\_subday\_interval=**\] frequency_subday_interval
    Intervalle de frequency_subday. L'argument frequency_subday_interval est de type int, avec NULL comme valeur par défaut.
  • [ **@frequency\_relative\_interval=**\] frequency_relative_interval
    Date d'exécution de l'Agent de capture instantanée. L'argument frequency_relative_interval est de type int, avec NULL comme valeur par défaut.
  • [ **@frequency\_recurrence\_factor=**\] frequency_recurrence_factor
    Facteur de récurrence utilisé par l'argument frequency_type. L'argument frequency_recurrence_factor est de type int, avec NULL comme valeur par défaut.
  • [ **@active\_start\_date=**\] active_start_date
    Date à laquelle l'Agent de capture instantanée est planifié pour la première fois, représentée au format AAAAMMJJ. L'argument active_start_date est de type int, avec NULL comme valeur par défaut.
  • [ **@active\_end\_date=**\] active_end_date
    Date à laquelle l'Agent de capture instantanée cesse d'être planifié, représentée au format AAAAMMJJ. L'argument active_end_date est de type int, avec NULL comme valeur par défaut.
  • [ **@active\_start\_time\_of\_day=**\] active_start_time_of_day
    Heure du jour à laquelle l'Agent de capture instantanée est planifié pour la première fois, représentée au format HHMMSS. L'argument active_start_time_of_day est de type int, avec NULL comme valeur par défaut.
  • [ **@active\_end\_time\_of\_day=**\] active_end_time_of_day
    Heure du jour à laquelle l'Agent de capture instantanée cesse d'être planifié, représentée au format HHMMSS. L'argument active_end_time_of_day est de type int, avec NULL comme valeur par défaut.
  • [ @snapshot\_job\_name = ] 'snapshot_agent_name'
    Nom d'un travail existant de l'Agent de capture instantanée, si un travail existant est utilisé. L'argument snapshot_agent_name est de type nvarchar(100), avec NULL comme valeur par défaut.
  • [ **@publisher\_security\_mode**= ] publisher_security_mode
    Mode de sécurité utilisé par l'Agent lors de la connexion au serveur de publication. L'argument publisher_security_mode est de type smallint, avec NULL comme valeur par défaut. La valeur 0 spécifie une authentification SQL Server, tandis que la valeur 1 indique une authentification Windows. La valeur 0 doit être spécifiée pour les serveurs de publication non-SQL Server.

    ms178574.security(fr-fr,SQL.90).gifRemarque relative à la sécurité :
    Utilisez si possible l'authentification Windows.
  • [ **@publisher\_login**= ] 'publisher_login'
    Connexion utilisée pour le serveur de publication. L'argument publisher_login est de type sysname, avec NULL comme valeur par défaut. publisher_login doit être spécifié lorsque publisher_security_mode a 0 pour valeur. Si publisher_login a la valeur NULL et que publisher_security_mode a la valeur 1, le compte Windows spécifié dans job_login est utilisé pour la connexion au serveur de publication.
  • [ **@publisher\_password**= ] 'publisher_password'
    Mot de passe utilisé lors de la connexion au serveur de publication. L'argument publisher_password est de type sysname, avec NULL comme valeur par défaut.

    ms178574.security(fr-fr,SQL.90).gifRemarque relative à la sécurité :
    N'utilisez pas de mot de passe vide, mais un mot de passe fort. Si possible, invitez les utilisateurs à entrer leurs informations d'identification au moment de l'exécution. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser ce fichier pour empêcher un accès non autorisé.
  • [ @job\_login**= ] 'job_login'
    Connexion d'accès pour le compte Windows sous lequel l'Agent s'exécute. L'argument job_login est de type nvarchar(257), avec NULL comme valeur par défaut. Ce compte Windows est toujours utilisé pour les connexions de l'Agent au serveur de distribution. Vous devez fournir ce paramètre lors de la création d'un nouveau travail de l'Agent de capture instantanée. Vous ne pouvez pas le modifier en cas d'utilisation d'un serveur de publication non-SQL Server
    .
  • [ **@job\_password**= ] 'job_password'
    Mot de passe du compte Windows sous lequel l'Agent s'exécute. L'argument job_password est de type sysname, avec NULL comme valeur par défaut. Vous devez fournir ce paramètre lors de la création d'un nouveau travail de l'Agent de capture instantanée.

    ms178574.security(fr-fr,SQL.90).gifRemarque relative à la sécurité :
    Lorsque c'est possible, demandez aux utilisateurs d'entrer leurs informations d'identification au moment de l'exécution. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser ce fichier pour empêcher un accès non autorisé.
  • [ **@publisher**= ] 'publisher'
    Indique un serveur de publication non-SQL Server. L'argument publisher est de type sysname, avec NULL comme valeur par défaut.

    ms178574.note(fr-fr,SQL.90).gifRemarque :
    publisher ne doit pas être utilisé lors de la création d'un Agent de capture instantanée sur un serveur de publication SQL Server.

Notes

sp_changepublication_snapshot est utilisée au cours d'une réplication transactionnelle, de capture instantanée et de fusion.

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 la procédure sp_changepublication_snapshot.

Valeurs des codes renvoyés

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

Voir aussi

Référence

sp_addpublication_snapshot (Transact-SQL)
Procédures stockées système (Transact-SQL)

Autres ressources

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Modification des propriétés des publications et des articles

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version Historique

12 décembre 2006

Contenu mis à jour :
  • Mise à jour des informations concernant les paramètres @frequency_type et @frequency_interval.