Partager via


sp_add_log_shipping_secondary_database (Transact-SQL)

Définit une base de données secondaire pour la copie des journaux de transaction.

Icône Lien de rubriqueConventions de la syntaxe de 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. L'argument secondary_database est de type sysname et n'a pas de valeur par défaut.
  • [ @primary_server = ] 'primary_server'
    Nom de l'instance principale du moteur de base de données SQL Server de Microsoft dans la configuration de la copie des journaux de transaction. L'argument primary_server est de type sysname et sa valeur ne peut pas être NULL.
  • [ @primary_database = ] 'primary_database'
    Nom de la base de données sur le serveur principal. L'argument primary_database est de type sysname et n'a pas de valeur par défaut.
  • [ @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'
    Si la valeur est définie à 1, le serveur secondaire restaure toutes les sauvegardes du journal des transactions disponibles au moment de la 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 = 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. 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 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. Par défaut, la valeur 1 indique que l'alerte est déclenchée. L'argument threshold_alert_enabled est de type bit.
  • [ @history_retention_period = ] 'history_retention_period'
    Durée en minutes pendant laquelle l'historique doit être conservé. 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)

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 :

  1. 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.
  2. Elle ajoute une entrée pour la base de données secondaire dans log_shipping_secondary_databases à l'aide des arguments fournis.
  3. Elle ajoute un enregistrement moniteur local dans log_shipping_monitor_secondary sur le serveur secondaire à l'aide des arguments fournis.
  4. 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.

Ensembles de résultats

Aucun

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 AdventureWorks 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)

Autres ressources

copie des journaux de transaction
Tables et procédures stockées liées à l'envoi de journaux

Aide et Informations

Assistance sur SQL Server 2005