• Article

sp_change_log_shipping_secondary_database (Transact-SQL)

Modifie les paramètres de la base de données secondaire.

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

Syntaxe

sp_change_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[, [ @restore_delay = ] 'restore_delay']
[, [ @restore_all = ] 'restore_all']
[, [ @restore_mode = ] 'restore_mode']
[, [ @disconnect_users = ] 'disconnect_users']
[, [ @block_size = ] 'block_size']
[, [ @buffer_count = ] 'buffer_count']
[, [ @max_transfer_size = ] 'max_transfer_size']
[, [ @restore_threshold = ] 'restore_threshold'] 
[, [ @threshold_alert = ] 'threshold_alert'] 
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled'] 
[, [ @history_retention_period = ] 'history_retention_period']

Arguments

  • [ @restore_delay = ] 'restore_delay'
    Temps d'attente, en minutes, de la base de données secondaire avant de restaurer un fichier de sauvegarde donné. L'argument restore_delay est de type int et sa valeur ne peut pas être NULL. La valeur par défaut est 0.

  • [ @restore_all = ] 'restore_all'
    Avec la valeur 1, le serveur secondaire restaure toutes les sauvegardes des journaux des transactions disponibles lors de l'exécution du travail de restauration. Sinon, il s'arrête après la restauration d'un fichier. L'argument restore_all est de type bit et ne peut pas être NULL.

  • [ @restore_mode = ] 'restore_mode'
    Mode de restauration pour la base de données secondaire.

    0 = restaurer le journal avec NORECOVERY.

    1 = restaurer le journal avec STANDBY.

    L'argument restore est de type bit et ne peut pas être NULL.

  • [ @disconnect_users = ] 'disconnect_users'
    Avec la valeur 1, les utilisateurs sont déconnectés de la base de données secondaire lors de l'exécution d'une opération de restauration. Valeur par défaut = 0. disconnect_users est de type bit et ne peut pas être NULL.

  • [ @block_size = ] 'block_size'
    Taille, en octets, utilisée pour les blocs de l'unité de sauvegarde. L'argument block_size est de type int, avec -1 comme valeur par défaut.

  • [ @buffer_count = ] 'buffer_count'
    Nombre total de mémoires tampons utilisées par les opérations de sauvegarde et de restauration. L'argument buffer_count est de type int, avec -1 comme valeur par défaut.

  • [ @max_transfer_size = ] 'max_transfer_size'
    Taille maximale en octets de la requête entrante ou sortante qui est émise par SQL Server à destination de l'unité de sauvegarde. L'argument max_transfersize est de type int et sa valeur peut être NULL.

  • [ @restore_threshold = ] 'restore_threshold'
    Nombre de minutes autorisées entre les opérations de restauration avant la génération d'une alerte. L'argument restore_threshold est de type int et sa valeur ne peut pas être NULL.

  • [ @threshold_alert = ] 'threshold_alert'
    Alerte à déclencher lorsque le seuil de sauvegarde est dépassé. L'argument threshold_alert est de type int, avec 14420 comme valeur par défaut.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Indique si une alerte doit être générée lors d'un dépassement de la valeur de backup_threshold. 1 = oui ; 0 = non. L'argument threshold_alert_enabled est de type bit et ne peut pas être NULL.

  • [ @history_retention_period = ] 'history_retention_period'
    Période de rétention, en minutes, de l'historique. L'argument history_retention_period est de type int. En l'absence de valeur spécifiée, 1440 sera utilisé.

Valeurs des codes de retour

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

Ensembles de résultats

Aucun

Notes

La procédure sp_change_log_shipping_secondary_database doit être exécutée à partir de la base de données master sur le serveur secondaire. Cette procédure stockée effectue les actions suivantes :

  1. Elle modifie les paramètres des enregistrements log_shipping_secondary_database selon les besoins.

  2. Elle modifie l'enregistrement du moniteur local dans log_shipping_monitor_secondary sur le serveur secondaire en utilisant, le cas échéant, les arguments fournis.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure.

Exemples

Cet exemple illustre l'utilisation de sp_change_log_shipping_secondary_database pour mettre à jour les paramètres de la base de données secondaire LogShipAdventureWorks.

EXEC master.dbo.sp_change_log_shipping_secondary_database 
 @secondary_database =  'LogShipAdventureWorks'
,  @restore_delay = 0
,  @restore_all = 1
,  @restore_mode = 0
,  @disconnect_users = 0
,  @threshold_alert = 14420
,  @threshold_alert_enabled = 1
,  @history_retention_period = 14420