Partage via

sp_change_log_shipping_primary_database (Transact-SQL)

S'applique à :SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'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 ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Les arguments

[ @database = ] « base de données »

Nom de la base de données sur le serveur principal. @primary_database est sysname, sans valeur par défaut.

[ @backup_directory = ] N’backup_directory'

Chemin d’accès au dossier de sauvegarde sur le serveur principal. @backup_directory est nvarchar(500), sans valeur par défaut et ne peut pas être NULL.

[ @backup_share = ] N’backup_share'

Chemin d’accès réseau au répertoire de sauvegarde sur le serveur principal. @backup_share est nvarchar(500), sans 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. @backup_retention_period est int, sans 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

@monitor_server_security_mode est bit et la valeur par défaut est 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, en minutes, après la dernière sauvegarde avant qu’une erreur de @threshold_alert soit générée. @backup_threshold est 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é. @threshold_alert est int et ne peut pas être NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Spécifie si une alerte est déclenchée lorsque @backup_threshold est dépassé.

  • 1:Activé
  • 0:handicapé

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. La valeur 14420 est utilisée si aucune valeur n’est spécifiée.

[ @backup_compression = ] backup_compression_option

Spécifie si une configuration de copie des journaux de transaction utilise la compression de sauvegarde. Ce paramètre est pris en charge dans l’édition Entreprise pour SQL Server 2008 (10.0.x) (et versions ultérieures) et toutes les éditions de SQL Server 2016 (13.x) avec Service Pack 1 (et versions ultérieures).

  • 0:Handicapé. Ne jamais compresser les sauvegardes de journaux

  • 1:Activé. Compresser toujours les sauvegardes de journaux

  • 2 (par défaut) : utilisez l’option de configuration du serveur par défaut de compression de sauvegarde .

[ @monitor_connection_options = ] '<key_value_pairs> ;[ ...]'

S’applique à : SQL Server 2025 (17.x) et versions ultérieures

Spécifie des options de connectivité supplémentaires pour la connexion de serveur lié lors de l’utilisation d’un moniteur distant, sous la forme de paires clé-valeur. @monitor_connection_options est nvarchar(4000) et a la valeur par défaut NULL.

Le tableau suivant répertorie les options de connectivité disponibles :

Key Value
Encrypt strict, , mandatoryoptional, , truefalse
TrustServerCertificate true, , falseyes, ,no
ServerCertificate Chemin d’accès du système de fichiers au certificat de serveur. Cela a une longueur maximale de 260 caractères.
HostNameInCertificate Remplacement du nom d’hôte pour le certificat. Cela a une longueur maximale de 255 caractères.

Valeurs des codes de retour

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

Jeu de résultats

Aucune.

Notes

sp_change_log_shipping_primary_database doit être exécuté à partir de la master base de données sur le serveur principal. Elle effectue les actions suivantes :

  1. Modifie les paramètres de l’enregistrement log_shipping_primary_database , si nécessaire.

  2. Modifie l’enregistrement log_shipping_monitor_primary local sur le serveur principal à l’aide d’arguments fournis, si nécessaire.

  3. Si le serveur moniteur est différent du serveur principal, modifiez l’enregistrement log_shipping_monitor_primary sur le serveur moniteur à 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 de la mise à jour des sp_change_log_shipping_primary_database paramètres associés à la base de données AdventureWorks2025primaire.

EXECUTE 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;

Contenu connexe

  • Last updated on