Partager via

l'application sqllogship

S'applique à :SQL Server

L’application sqllogship effectue une opération de sauvegarde, de copie ou de restauration, ainsi que les tâches de nettoyage associées pour une configuration d’envoi de journaux. L’opération est effectuée sur une instance spécifique de SQL Server pour une base de données spécifique.

Pour connaître les conventions de syntaxe, consultez les utilitaires de ligne de commande SQL (moteur de base de données).

Syntaxe

sqllogship
-server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id }
[ -verboselevel level ]
[ -logintimeout timeout_value ]
[ -querytimeout timeout_value ]
[ -connectionoptions "<key_value_pairs>; [ ... ]" ]

Arguments

-serveur instance_name

Spécifie l’instance de SQL Server où l’opération s’exécute. L'instance de serveur à spécifier dépend du type de l'opération d'envoi de journaux spécifié. Pour -backup, instance_name doit être le nom du serveur principal dans une configuration de copie des journaux de transaction. Pour -copy ou -restore, instance_name doit être le nom d’un serveur secondaire dans une configuration de copie des journaux de transaction.

-sauvegarde primary_id

Effectue une opération de sauvegarde pour la base de données principale dont l’ID principal est spécifié par primary_id. Vous pouvez obtenir cet ID en le sélectionnant dans la table système log_shipping_primary_databases ou en utilisant la procédure stockée sp_help_log_shipping_primary_database .

L'opération de sauvegarde crée la sauvegarde du journal dans le répertoire de sauvegarde. L'application sqllogship nettoie ensuite les anciens fichiers de sauvegarde en fonction de la durée de rétention des fichiers. Puis, l'application enregistre l'historique de l'opération de sauvegarde sur le serveur principal et le serveur moniteur. Enfin, l’application exécute sp_cleanup_log_shipping_historyqui nettoie les anciennes informations d’historique en fonction de la période de rétention.

-copier secondary_id

Effectue une opération de copie afin de copier des sauvegardes du serveur secondaire spécifié pour la ou les bases de données secondaires dont l’ID secondaire est spécifié par secondary_id. Vous pouvez obtenir cet ID en le sélectionnant dans la table système log_shipping_secondary ou en utilisant la procédure stockée sp_help_log_shipping_secondary_database .

L'opération copie les fichiers de sauvegarde du répertoire de sauvegarde vers le répertoire de destination. L'application sqllogship enregistre ensuite l'historique de l'opération de copie sur le serveur secondaire et le serveur moniteur.

-restore secondary_id

Effectue une opération de restauration sur le serveur secondaire spécifié pour la ou les bases de données secondaires dont l’ID secondaire est spécifié par secondary_id. Vous pouvez obtenir cet ID à l’aide de la sp_help_log_shipping_secondary_database procédure stockée.

Les fichiers de sauvegarde du répertoire de destination créés après le point de restauration le plus récent sont restaurés dans la ou les bases de données secondaires. L'application sqllogship nettoie ensuite les anciens fichiers de sauvegarde en fonction de la durée de rétention des fichiers. Puis, l'application enregistre l'historique de l'opération de restauration sur le serveur secondaire et le serveur moniteur. Enfin, l’application s’exécute sp_cleanup_log_shipping_history, qui nettoie les anciennes informations d’historique, en fonction de la période de rétention.

-verboselevel niveau

Spécifie le niveau des messages ajoutés à l'historique d'envoi des journaux. level est l'un des entiers suivants :

Level Description
0 N'envoie en sortie aucun message de traçage et de débogage.
1 Envoie en sortie des messages de gestion des erreurs.
2 Envoie en sortie des messages de gestion des erreurs et d'avertissement.
3 (valeur par défaut) Envoie en sortie des messages de gestion des erreurs, d'avertissement et d'information.
4 Envoie en sortie tous les messages de traçage et de débogage.

-logintimeout timeout_value

Spécifie le délai imparti pour la tentative de connexion à l’instance de serveur avant l’expiration de la tentative. La valeur par défaut est de 15 secondes. timeout_value est int.

-querytimeout timeout_value

Spécifie le délai alloué au démarrage de l'opération spécifiée avant l'expiration de la tentative. Le paramètre par défaut est l'absence de délai d'attente. timeout_value est int.

-connectionoptions "<key_value_pairs> ; [ ... n ] "

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

Spécifie des options de connectivité supplémentaires sous la forme de paires clé-valeur.

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

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

Notes

Utilisez les travaux de sauvegarde, de copie et de restauration pour effectuer la sauvegarde, la copie et la restauration lorsque cela est possible. Pour démarrer ces travaux à partir d’une opération de traitement ou d’une autre application, appelez la procédure stockée sp_start_job .

L'historique d'envoi de journaux créé par sqllogship comprend également l'historique des travaux de restauration, de copie et de sauvegarde de l'envoi de journaux. Si vous envisagez d'utiliser sqllogship de manière répétée pour effectuer des opérations de restauration, de copie ou de sauvegarde pour une configuration de l'envoi de journaux, pensez à désactiver le ou les travaux d'envoi de journaux correspondants. Pour plus d’informations, consultez Disable or Enable a Job.

L’application sqllogship , est SqlLogShip.exeinstallée dans le <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn répertoire.

Autorisations

sqllogship utilise l'authentification Windows. Le compte d'authentification Windows où s'exécute la commande nécessite un accès au répertoire Windows et des autorisations SQL Server . L’exigence varie selon que la commande sqllogship spécifie le -backup, -copyou -restore l’option.

Option Accès au répertoire Autorisations
-backup Nécessite un accès en lecture/écriture au répertoire de sauvegarde. Nécessite les mêmes autorisations que l’instruction BACKUP . Pour plus d’informations, consultez BACKUP.
-copy Nécessite l'accès en lecture au répertoire de sauvegarde et l'accès en écriture au répertoire de copie. Nécessite les mêmes autorisations que la procédure stockée sp_help_log_shipping_secondary_database .
-restore Nécessite un accès en lecture/écriture au répertoire de copie. Nécessite les mêmes autorisations que l’instruction RESTORE . Pour plus d’informations, consultez instructions RESTORE.

Pour connaître les chemins d’accès des répertoires de sauvegarde et de copie, vous pouvez exécuter la sp_help_log_shipping_secondary_database procédure stockée ou afficher la log_shipping_secondary table dans msdb. Les chemins d’accès du répertoire de sauvegarde et du répertoire de destination se trouvent respectivement dans les colonnes et backup_source_directory les backup_destination_directory colonnes.

Contenu connexe

  • Last updated on