sp_add_log_shipping_secondary_database (Transact-SQL)
Définit une base de données secondaire pour la copie des journaux de transaction.
.gif "Icône Lien de rubrique")
Conventions de syntaxe Transact-SQL
Syntaxe
sp_add_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[ @primary_server = ] 'primary_server',
[ @primary_database = ] 'primary_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
[ @secondary_database = ] 'secondary_database'
Nom de la base de données secondaire. secondary_database est de type sysname, sans valeur par défaut.[ @primary_server = ] 'primary_server'
Nom de l'instance principale du moteur de base de données Microsoft SQL Server dans la configuration de l'envoi des journaux. L'argument primary_server est de type sysname et ne peut pas être NULL.[ @primary_database = ] 'primary_database'
Nom de la base de données sur le serveur principal. primary_database est de type sysname, sans valeur par défaut.[ @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'
Si la valeur est définie à 1, le serveur secondaire restaure toutes les sauvegardes du journal des transactions disponibles au moment de la restauration. Dans le cas contraire, le serveur s'arrête une fois qu'un fichier est 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 = Restauration du journal avec l'option NORECOVERY.
1 = Restauration du journal avec l'option STANDBY.
L'argument restore est de type bit et ne peut pas être NULL.
[ @disconnect_users = ] 'disconnect_users'
Si la valeur est définie à 1, les utilisateurs sont déconnectés de la base de données secondaire au moment de la 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 14 420 comme valeur par défaut.[ @threshold_alert_enabled = ] 'threshold_alert_enabled'
Indique si une alerte est déclenchée lors d'un dépassement de la valeur de backup_threshold. La valeur 1 par défaut indique que l'alerte sera générée. threshold_alert_enabled est de type bit.[ @history_retention_period = ] 'history_retention_period'
Période de rétention, en minutes, de l'historique. history_retention_period est de type int, avec NULL comme valeur par défaut. La valeur 14 420 est utilisée si aucune autre valeur n'est spécifiée.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Ensembles de résultats
Aucun
Notes
La procédure stockée sp_add_log_shipping_secondary_database doit s'exécuter à partir de la base de données master sur le serveur secondaire. Elle effectue les actions suivantes :
La procédure stockée sp_add_log_shipping_secondary_primary doit préalablement être appelée pour initialiser les informations de la base de données primaire de la copie des journaux de transaction sur le serveur secondaire.
Elle ajoute une entrée pour la base de données secondaire dans log_shipping_secondary_databases à l'aide des arguments fournis.
Elle ajoute un enregistrement moniteur local dans log_shipping_monitor_secondary sur le serveur secondaire à l'aide des arguments fournis.
Si le serveur moniteur est différent du serveur secondaire, elle ajoute un enregistrement moniteur dans log_shipping_monitor_secondary sur le premier serveur à l'aide des arguments fournis.
Autorisations
Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure.
Exemple
Cet exemple illustre l'utilisation de la procédure stockée sp_add_log_shipping_secondary_database pour ajouter la base de données LogShipAdventureWorks comme base de données secondaire dans une configuration de copie des journaux de transaction avec la base de données primaire AdventureWorks2012 résidant sur le serveur principal TRIBECA.
EXEC master.dbo.sp_add_log_shipping_secondary_database
@secondary_database = N'LogShipAdventureWorks'
,@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks'
,@restore_delay = 0
,@restore_mode = 1
,@disconnect_users = 0
,@restore_threshold = 45
,@threshold_alert_enabled = 0
,@history_retention_period = 1440
GO
Voir aussi
Référence
Procédures stockées système (Transact-SQL)