sp_change_log_shipping_primary_database (Transact-SQL)

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

Conventions de la 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']

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 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 du 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é.

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 de serveur fixe sysadmin peuvent exécuter cette procédure.

Valeurs des codes renvoyés

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

Exemple

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

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks' 
, @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

Voir aussi

Référence

Procédures stockées système (Transact-SQL)
log_shipping_primary_databases (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