sp_change_log_shipping_primary_database (Transact-SQL)
Modifie les paramètres de la base de données primaire.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe 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. 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. backup_directory est de type nvarchar(500), sans valeur par défaut ; sa valeur ne peut pas être NULL.[ @backup_share = ] 'backup_share'
Chemin d'accès réseau au répertoire de sauvegarde sur le serveur principal. backup_share est de type nvarchar(500), sans valeur par défaut ; sa valeur 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. backup_retention_period est de type int, sans valeur par défaut ; sa valeur 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. backup_threshold est de type int, avec une valeur par défaut de 60 minutes.[ @threshold_alert = ] 'threshold_alert'
Alerte à déclencher lorsque le seuil de sauvegarde est dépassé. 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. 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é. Toujours compresser des sauvegardes de journal.
2 = Utilise le paramètre Afficher ou configurer l'option de configuration du serveur valeur par défaut de compression de la sauvegarde. Il s'agit de la valeur par défaut.
Valeurs des code de retour
0 (réussite) 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 :
Modification des paramètres dans l'enregistrement log_shipping_primary_database, si nécessaire.
Modification de l'enregistrement local dans log_shipping_monitor_primary sur le serveur principal en utilisant les arguments fournis, si nécessaire.
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.
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 AdventureWorks2012 .
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
,@backup_compression = 1
Voir aussi
Référence
Procédures stockées système (Transact-SQL)
log_shipping_primary_databases (Transact-SQL)