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

sys.sp_change_log_shipping_primary_database
    [ @database = ] N'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 = ] N'monitor_server_login' ]
    [ , [ @monitor_server_password = ] N'monitor_server_password' ]
    [ , [ @backup_threshold = ] backup_threshold ]
    [ , [ @threshold_alert = ] threshold_alert ]
    [ , [ @threshold_alert_enabled = ] threshold_alert_enabled ]
    [ , [ @history_retention_period = ] history_retention_period ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
    [ , [ @backup_compression = ] backup_compression ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Les arguments

[ @database = ] N’database'

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 = ] N’monitor_server_login'

Nom d’utilisateur du compte utilisé pour accéder au serveur moniteur.

[ @monitor_server_password = ] N’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_enabledest mordu et ne peut pas l’ê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.

[ @ignoreremotemonitor = ] ignorer le moniteur à distance

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

[ @backup_compression = ] backup_compression

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 :

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

• À propos de la copie des journaux de transaction (SQL Server)
• Procédures stockées système (Transact-SQL)
• log_shipping_primary_databases (Transact-SQL)