sp_change_log_shipping_secondary_database (Transact-SQL)

Article
12/22/2023

S’applique à :SQL Server

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

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' Durée, en minutes, pendant laquelle le serveur secondaire attend avant de restaurer un fichier de sauvegarde donné. restore_delay est int et ne peut pas être NULL. La valeur par défaut est 0.

[ @restore_all = ] 'restore_all' Si la valeur est 1, le serveur secondaire restaure toutes les sauvegardes de journal des transactions disponibles lors de l’exécution du travail de restauration. Dans le cas contraire, le serveur s'arrête une fois qu'un fichier a été restauré. restore_all est bit et ne peut pas être NULL.

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

0 = restaurer le journal avec NORECOVERY.

1 = Restauration du journal avec l'option STANDBY.

la restauration est bit et ne peut pas être NULL.

[ @disconnect_users = ] 'disconnect_users' Si la valeur est définie sur 1, les utilisateurs sont déconnectés de la base de données secondaire lorsqu’une opération de restauration est effectuée. Valeur par défaut = 0. disconnect_users est bit et ne peut pas être NULL.

[ @block_size = ] 'block_size' Taille, en octets, utilisée comme taille de bloc pour l’appareil de sauvegarde. block_size est int avec une valeur par défaut de -1.

[ @buffer_count = ] 'buffer_count' Nombre total de mémoires tampons utilisées par l’opération de sauvegarde ou de restauration. buffer_count est int avec une valeur par défaut de -1.

[ @max_transfer_size = ] 'max_transfer_size' Taille, en octets, de la demande maximale d’entrée ou de sortie émise par SQL Server sur l’appareil de sauvegarde. max_transfersize est int et peut être NULL.

[ @restore_threshold = ] 'restore_threshold' Nombre de minutes autorisées à s’écouler entre les opérations de restauration avant la génération d’une alerte. restore_threshold est int et ne peut pas être NULL.

[ @threshold_alert = ] 'threshold_alert' Alerte à déclencher lorsque le seuil de restauration est dépassé. threshold_alert est int, avec la valeur par défaut 14421.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Spécifie si une alerte est déclenchée lorsque restore_thresholdest dépassé. 1 = activées ; 0 = désactivées. threshold_alert_enabled est bit et ne peut pas être NULL.

[ @history_retention_period = ] 'history_retention_period' Durée en minutes pendant laquelle l’historique sera conservé. history_retention_period est int. La valeur 1440 est utilisée si aucune valeur n’est spécifiée.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

None

Notes

sp_change_log_shipping_secondary_database devez être exécuté à partir de la base de données master sur le serveur secondaire. Elle effectue les actions suivantes :

Modifie les paramètres dans les enregistrements log_shipping_secondary_database si nécessaire.
Modifie l’enregistrement du moniteur local dans log_shipping_monitor_secondary sur le serveur secondaire à l’aide d’arguments fournis, si nécessaire.

Autorisations

Seuls les membres du rôle 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 base de données secondaire pour la base de données 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;

Voir aussi

À propos de la copie des journaux de transaction (SQL Server)
Procédures stockées système (Transact-SQL)