• Article

sp_change_log_shipping_primary_database (Transact-SQL)

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

Icône Lien de rubriqueConventions de syntaxe de Transact-SQL

Syntaxe

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] 'backup_share'] 
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @backup_threshold = ] 'backup_threshold'] 
[, [ @threshold_alert = ] 'threshold_alert'] 
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled'] 
[, [ @history_retention_period = ] 'history_retention_period']
[, [ @backup_compression = ] backup_compression_option ]

Arguments

  • [ @database = ] '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.

  • [ @backup_directory = ] 'backup_directory'
    Chemin d'accès au dossier de sauvegarde sur le serveur principal. L'argument backup_directory est de type nvarchar(500), il n'a pas de valeur par défaut et ne peut pas être NULL.

  • [ @backup_share = ] 'backup_share'
    Chemin d'accès réseau au répertoire de sauvegarde sur le serveur principal. L'argument backup_share est de type nvarchar(500), il n'a pas de valeur par défaut et ne peut pas être NULL.

  • [ @backup_retention_period = ] 'backup_retention_period'
    Durée, en minutes, de conservation du fichier de sauvegarde de fichier journal dans le répertoire de sauvegarde sur le serveur principal. L'argument backup_retention_period est de type int ; il n'a pas de valeur par défaut et ne peut pas être NULL.

  • [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
    Mode de sécurité utilisé pour la connexion au serveur moniteur.

    1 = Authentification Windows.

    0 = Authentification SQL Server.

    L'argument monitor_server_security_mode est de type bit et ne peut pas être NULL.

  • [ @monitor_server_login = ] 'monitor_server_login'
    Nom d'utilisateur du compte utilisé pour accéder au serveur moniteur.

  • [ @monitor_server_password = ] 'monitor_server_password'
    Mot de passe du compte utilisé pour accéder au serveur moniteur.

  • [ @backup_threshold = ] 'backup_threshold'
    Durée écoulée (en minutes) depuis la dernière sauvegarde avant qu'une erreur threshold_alert ne soit générée. L'argument backup_threshold est de type int, avec 60 minutes comme valeur par défaut.

  • [ @threshold_alert = ] 'threshold_alert'
    Alerte à générer lorsque le seuil de sauvegarde est atteint. L'argument threshold_alert est de type int et ne peut pas être NULL.

  • [ @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.

    1 = Activé.

    0 = Désactivé.

    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. L'argument history_retention_period est de type int. Si aucune durée n'est spécifiée, 14 420 est utilisé.

  • [ @backup_compression = ] backup_compression_option
    Spécifie si une configuration de la copie des journaux de transaction utilise la compression de sauvegarde. Ce paramètre est pris en charge uniquement dans le SQL Server 2008 Enterprise (ou une version ultérieure).

    0 = Désactivées. Ne jamais compresser des sauvegardes de journal.

    1 = Activées. Toujours compresser des sauvegardes de journal.

    2 = Utiliser le paramètre de l'option de configuration de serveur compression de la sauvegarde par défaut. Il s'agit de la valeur par défaut.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Jeux de résultats

Non

Notes

La procédure stockée sp_change_log_shipping_primary_database doit être exécutée dans la base de données master sur le serveur principal. Cette procédure effectue les opérations suivantes :

  1. Modification des paramètres dans l'enregistrement log_shipping_primary_database, si nécessaire.

  2. Modification de l'enregistrement local dans log_shipping_monitor_primary sur le serveur principal en utilisant les arguments fournis, si nécessaire.

  3. Lorsque le serveur moniteur n'est pas le serveur principal, modification de l'enregistrement dans log_shipping_monitor_primary sur le serveur moniteur à l'aide des 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 la procédure sp_change_log_shipping_primary_database pour mettre à jour les paramètres associés à la base de données primaire AdventureWorks2008R2.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks2008R2' 
, @backup_directory = N'c:\LogShipping' 
, @backup_share = N'\\tribeca\LogShipping' 
, @backup_retention_period = 1440 
, @backup_threshold = 60 
, @threshold_alert = 0 
, @threshold_alert_enabled = 1 
, @history_retention_period = 1440 
,@monitor_server_security_mode = 1
,@backup_compression = 1