sp_add_log_shipping_primary_database (Transact-SQL)

  • Article

Définit la base de données primaire pour une configuration d'envoi de journaux, y compris du travail de sauvegarde, de l'enregistrement de moniteur local et de l'enregistrement de moniteur distant.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_add_log_shipping_primary_database [ @database = ] 'database', 
[ @backup_directory = ] 'backup_directory', 
[ @backup_share = ] 'backup_share', 
[ @backup_job_name = ] 'backup_job_name', 
[, [ @backup_retention_period = ] backup_retention_period]
[, [ @monitor_server = ] 'monitor_server']
[, [ @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_job_id = ] backup_job_id OUTPUT ]
[, [ @primary_id = ] primary_id OUTPUT]
[, [ @backup_compression = ] backup_compression_option ]

Arguments

  • [ @database= ] 'database'
    Nom de la base de données primaire pour la copie des journaux de transaction. database est de type sysname, sans valeur par défaut ; sa valeur ne peut pas être NULL.

  • [ @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_job_name= ] 'backup_job_name'
    Nom du travail de SQL Server Agent sur le serveur principal qui copie la sauvegarde dans le dossier de sauvegarde. L'argument backup_job_name est de type sysname 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. backup_retention_period est de type int, sans valeur par défaut ; sa valeur ne peut pas être NULL.

  • [ @monitor_server= ] 'monitor_server'
    Nom du serveur moniteur. Monitor_server est de type sysname, 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 = Authentication 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é. threshold_alert est de type int, avec 14 420 comme valeur par défaut.

  • [ @threshold_alert_enabled= ] threshold_alert_enabled
    Indique si une alerte doit être générée lors d'un dépassement de la valeur de backup_threshold. La valeur par défaut zéro (0) indique que l'alerte est désactivée et ne sera pas déclenchée. L'argument threshold_alert_enabled est de type bit.

  • [ @history_retention_period= ] history_retention_period
    Période de rétention, en minutes, de l'historique. history_retention_period est de type int, avec NULL comme valeur par défaut. La valeur 14420 est utilisée si aucune valeur n'est spécifiée.

  • [ @backup_job_id= ] backup_job_id OUTPUT
    ID de travail de l'Agent SQL Server associé au travail de sauvegarde sur le serveur principal. L'argument backup_job_id est de type uniqueidentifier et ne peut pas être NULL.

  • [ @primary_id= ] primary_id OUTPUT
    ID de la base de données primaire pour la configuration de la copie des journaux de transaction. L'argument primary_id est de type uniqueidentifier et ne peut pas être NULL.

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

Aucun

Notes

sp_add_log_shipping_primary_database doit être exécuté à partir de la base de données master sur le serveur primaire. Cette procédure stockée remplit les fonctions suivantes :

  1. Elle génère un ID primaire et ajoute une entrée pour la base de données primaire dans la table log_shipping_primary_databases à l'aide des arguments fournis.

  2. Elle crée un travail de sauvegarde pour la base de données primaire qui est désactivée.

  3. Elle définit l'ID de travail de sauvegarde dans l'entrée log_shipping_primary_databases selon l'ID du travail de sauvegarde.

  4. Elle ajoute un enregistrement de moniteur local dans la table log_shipping_monitor_primary sur le serveur primaire à l'aide des arguments fournis.

  5. Si le serveur moniteur est différent du serveur primaire, il ajoute un enregistrement de moniteur dans log_shipping_monitor_primary sur le serveur moniteur utilisant les arguments fournis.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure.

Exemples

Cet exemple ajoute la base de données AdventureWorks2012 en tant que base de données primaire dans une configuration d'envoi de journaux.

DECLARE @LS_BackupJobId AS uniqueidentifier 
DECLARE @LS_PrimaryId AS uniqueidentifier 

EXEC master.dbo.sp_add_log_shipping_primary_database 
@database = N'AdventureWorks' 
,@backup_directory = N'c:\lsbackup' 
,@backup_share = N'\\tribeca\lsbackup' 
,@backup_job_name = N'LSBackup_AdventureWorks' 
,@backup_retention_period = 1440
,@monitor_server = N'rockaway' 
,@monitor_server_security_mode = 1 
,@backup_threshold = 60 
,@threshold_alert = 0 
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
,@backup_job_id = @LS_BackupJobId OUTPUT 
,@primary_id = @LS_PrimaryId OUTPUT 
,@overwrite = 1 
,@backup_compression = 0
GO

Voir aussi

Référence

Procédures stockées système (Transact-SQL)

Concepts

Vue d'ensemble de la copie des journaux de transaction