Application sqllogship
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 a lieu sur une instance spécifique de Microsoft SQL Server pour une base de données spécifique.
Pour les conventions de syntaxe, consultez Référence de l’utilitaire d’invite de commandes (moteur de base de données).
Syntaxe
sqllogship
-server
instance_name { -backupprimary_id | -copysecondary_id | -restoresecondary_id } [ -verboselevellevel ] [ -logintimeouttimeout_value ] [ -querytimeouttimeout_value ]
Arguments
-server instance_name
Spécifie l'instance de SQL Server où va s'exécuter l'opération. 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 correspondre au nom du serveur principal dans une configuration d’envoi de journaux. Pour -copy ou -restore, instance_name doit correspondre au nom d’un serveur secondaire dans une configuration d’envoi de journaux.
-backup 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.
-copy 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 procédure stockée sp_help_log_shipping_secondary_database .
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 exécute sp_cleanup_log_shipping_historyqui nettoie les anciennes informations d’historique en fonction de la période de rétention.
-verboselevel level
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 | Envoie en sortie des messages de gestion des erreurs, d'avertissement et d'information. Il s’agit de la valeur par défaut. |
| 4 | Envoie en sortie tous les messages de traçage et de débogage. |
-logintimeout timeout_value
Spécifie le délai accordé pour se connecter à l'instance de serveur avant l'expiration de la tentative. La valeur par défaut est 15 secondes. timeout_value a la valeur 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 a la valeur int.
Notes
Il est recommandé d'utiliser les travaux de sauvegarde, de copie et de restauration pour effectuer les opérations correspondantes quand 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 , SqlLogShip.exe, est installée dans le répertoire x :\Program Files\Microsoft SQL Server\120\Tools\Binn.
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 . La configuration requise dépend de l’option spécifiée par la commande sqllogship : -backup, -copyou -restore .
| 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 (Transact-SQL). |
| -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 RESTORE (Transact-SQL). |
Notes
Pour connaître les chemins des répertoires de sauvegarde et de copie, exécutez la procédure stockée sp_help_log_shipping_secondary_database ou consultez la table log_shipping_secondary dans msdb. Les chemins du répertoire de sauvegarde et du répertoire de destination sont dans les colonnes backup_source_directory et backup_destination_directory respectivement.
Voir aussi
À propos de la copie des journaux de transaction (SQL Server)
log_shipping_primary_databases (Transact-SQL)
log_shipping_secondary (Transact-SQL)
sp_cleanup_log_shipping_history (Transact-SQL)
sp_help_log_shipping_primary_database (Transact-SQL)
sp_help_log_shipping_secondary_database (Transact-SQL)
sp_start_job (Transact-SQL)