sp_add_log_shipping_primary_database (Transact-SQL)

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 rubriqueConventions 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. L'argument 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. 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 réseau 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_job_name= ] 'backup_job_name'
    Nom du travail de l'Agent SQL Server sur le serveur principal qui copie la sauvegarde dans le dossier de sauvegarde. 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. 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= ] 'monitor_server'
    Nom du serveur moniteur. L'argument Monitor_server est de type sysname et ne peut pas prendre la valeur 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. L'argument backup_threshold est de type int, avec 60 minutes comme valeur par défaut.

  • [ @threshold_alert= ] threshold_alert
    Alerte à déclencher lorsque le seuil de sauvegarde est dépassé. L'argument 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. threshold_alert_enabled est de type bit.

  • [ @history_retention_period= ] history_retention_period
    Durée en minutes pendant laquelle l'historique doit être conservé. 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 SQL Server Agent associé au travail de sauvegarde sur le serveur principal. backup_job_id est de type uniqueidentifier et ne peut pas prendre la valeur 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 sa valeur 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ées. Toujours compresser des sauvegardes de journal.

    2 = Utiliser le paramètre de l'option de configuration de serveur compression de la sauvegarde par défaut. Il s'agit de la valeur par défaut.

Valeurs des codes de retour

0 (succès) 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 AdventureWorks 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