sp_change_log_shipping_secondary_database (Transact-SQL)
Modifie les paramètres de la base de données secondaire.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe 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'
Durée, en minutes, de l'attente du serveur secondaire avant de restaurer un fichier de sauvegarde donné. L'argument restore_delay est de type int et 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. Dans le cas contraire, le serveur s'arrête une fois qu'un fichier a été restauré. 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. Par défaut = 0. L'argument disconnect_users est de type bit et ne peut pas être NULL.[ @block_size = ] 'block_size'
Taille, en octets, qui définit la taille des blocs pour l'unité de sauvegarde. 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 l'opération de sauvegarde ou de restauration. buffer_count est de type int avec -1 comme valeur par défaut.[ @max_transfer_size = ] 'max_transfer_size'
Taille, en octets, de la demande d'entrée ou de sortie maximale émise par SQL Server à l'unité de sauvegarde. max_transfersize est de type int et peut avoir la valeur NULL.[ @restore_threshold = ] 'restore_threshold'
Nombre de minutes pouvant s'écouler entre les opérations de restauration avant qu'une alerte ne soit générée. L'argument restore_threshold est de type int et ne peut pas être NULL.[ @threshold_alert = ] 'threshold_alert'
Alerte à déclencher lorsque le seuil de sauvegarde est dépassé. 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 = activées ; 0 = désactivées. 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. 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 :
Elle modifie les paramètres des enregistrements log_shipping_secondary_database selon les besoins.
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
Voir aussi
Référence
Procédures stockées système (Transact-SQL)