sp_change_log_shipping_secondary_database (Transact-SQL)

  • Article

S’applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_change_log_shipping_secondary_database
    [ @secondary_database = ] N'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 ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

Arguments

[ @secondary_database = ] N’secondary_database'

Nom de la base de données sur le serveur secondaire. @secondary_database est 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é. @restore_delay est int, avec une valeur par défaut 0, et ne peut pas être NULL.

[ @restore_all = ] restore_all

Si la valeur est définie 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 est restauré. @restore_all est bit et ne peut pas être NULL.

[ @restore_mode = ] restore_mode

Mode de restauration pour la base de données secondaire. @restore_mode est bit et ne peut pas être NULL.

  • 0 = restaurer le journal avec NORECOVERY.
  • 1 = restaurer le journal avec STANDBY.

[ @disconnect_users = ] disconnect_users

Si la valeur est définie 1, les utilisateurs sont déconnectés de la base de données secondaire lorsqu’une opération de restauration est effectuée. @disconnect_users est bit, avec une valeur par défaut 0, 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 int, avec la valeur par défaut -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 la valeur par défaut -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_transfer_size est int, avec la valeur par défaut 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. @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_threshold est dépassé.

  • 1 = activé
  • 0 = désactivé.

@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 est conservé. @history_retention_period est int, avec la valeur par défaut 1440.

[ @ignoreremotemonitor = ] ignoreremotemonitor

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Aucune.

Notes

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

  1. Modifie les paramètres dans les log_shipping_secondary_database enregistrements si nécessaire.

  2. Modifie l’enregistrement log_shipping_monitor_secondary du moniteur local 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 sp_change_log_shipping_secondary_database de la mise à jour des 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;

Contenu connexe