sqllogship-Anwendung

Gilt für:SQL Server

Von der Anwendung sqllogship werden ein Sicherungs-, Kopier- oder Wiederherstellungsvorgang und zugeordnete Cleanuptasks für eine Protokollversandkonfiguration ausgeführt. Der Vorgang wird für eine bestimmte Instanz von SQL Server für eine bestimmte Datenbank ausgeführt.

Informationen zu den Syntaxkonventionen finden Sie unter SQL-Befehlszeilenhilfsprogramme (Datenbankmodul).

Syntax

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>; [ ... ]" ]

Argumente

- server-instance_name

Gibt die Instanz von SQL Server an, in der der Vorgang ausgeführt wird. Die anzugebende Serverinstanz hängt vom angegebenen Protokollversandvorgang ab. Für -backup, instance_name muss der Name des primären Servers in einer Protokollversandkonfiguration sein. Für -copy oder -restore, instance_name muss der Name eines sekundären Servers in einer Protokollversandkonfiguration sein.

- Backup-primary_id

Führt einen Sicherungsvorgang für die primäre Datenbank aus, deren primäre ID durch primary_idangegeben ist. Sie können diese ID abrufen, indem Sie sie in der log_shipping_primary_databases -Systemtabelle auswählen oder die gespeicherte Prozedur sp_help_log_shipping_primary_database verwenden.

Bei diesem Sicherungsvorgang wird die Protokollsicherung im Sicherungsverzeichnis erstellt. Für die veralteten Sicherungsdateien wird dann auf der Grundlage der Beibehaltungsdauer der Datei von der Anwendung sqllogship ein Cleanup ausgeführt. Anschließend wird der Verlauf für den Sicherungsvorgang von der Anwendung auf dem primären Server und dem Überwachungsserver protokolliert. Abschließend wird von der Anwendung die Prozedur sp_cleanup_log_shipping_historyausgeführt, sodass auf der Grundlage der Beibehaltungsdauer veraltete Verlaufsinformationen gelöscht werden.

-kopiere secondary_id

Führt einen Kopiervorgang aus, um Sicherungen vom angegebenen sekundären Server für die sekundäre Datenbank bzw. sekundären Datenbanken zu kopieren, deren sekundäre ID durch secondary_idangegeben ist. Sie können diese ID abrufen, indem Sie sie aus der log_shipping_secondary -Systemtabelle auswählen oder die gespeicherte Prozedur sp_help_log_shipping_secondary_database verwenden.

Bei dem Vorgang werden die Sicherungsdateien aus dem Sicherungsverzeichnis in das Zielverzeichnis kopiert. Dann wird der Verlauf für den Kopiervorgang von der Anwendung sqllogship auf dem sekundären Server und dem Überwachungsserver protokolliert.

- secondary_id wiederherstellen

Führt auf dem angegebenen sekundären Server einen Wiederherstellungsvorgang für die sekundäre Datenbank bzw. sekundären Datenbanken aus, deren sekundäre ID durch secondary_idangegeben ist. Sie können diese ID mithilfe der sp_help_log_shipping_secondary_database gespeicherten Prozedur abrufen.

Alle Sicherungsdateien im Zielverzeichnis, die nach dem letzten Wiederherstellungspunkt erstellt wurden, werden in der sekundären Datenbank bzw. in den sekundären Datenbanken wiederhergestellt. Für die veralteten Sicherungsdateien wird dann auf der Grundlage der Beibehaltungsdauer der Datei von der Anwendung sqllogship ein Cleanup ausgeführt. Anschließend wird der Verlauf für den Wiederherstellungsvorgang von der Anwendung auf dem sekundären Server und dem Überwachungsserver protokolliert. Schließlich wird die Anwendung ausgeführt sp_cleanup_log_shipping_history, die alte Verlaufsinformationen basierend auf dem Aufbewahrungszeitraum bereinigt.

-ausführliche Ebene

Gibt die Ebene der dem Protokollversandverlauf hinzugefügten Meldungen an. level entspricht einer der folgenden ganzen Zahlen:

-logintimeout timeout_value

Gibt die Zeitspanne an, die für den Versuch, sich bei der Serverinstanz anzumelden, vor dem Timeout des Versuchs zugewiesen wurde. Der Standardwert ist 15 Sekunden. timeout_value ist int.

- querytimeout-timeout_value

Gibt die für das Starten des angegebenen Vorgangs vorgesehene Zeit an, bevor für den Versuch ein Timeout auftritt. Der Standard ist kein Timeout. timeout_value ist int.

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

Gilt für: SQL Server 2025 (17.x) und neuere Versionen.

Gibt zusätzliche Konnektivitätsoptionen in Form von Schlüsselwertpaaren an.

In der folgenden Tabelle sind die verfügbaren Konnektivitätsoptionen aufgeführt:

Bemerkungen

Verwenden Sie die Sicherungs-, Kopier- und Wiederherstellungsaufträge, um die Sicherung, Kopie und Wiederherstellung nach Möglichkeit auszuführen. Rufen Sie die gespeicherte Prozedur sp_start_job auf, um diese Aufträge aus einem Batchvorgang oder einer anderen Anwendung zu starten.

Der von sqllogship erstellte Protokollversandverlauf wird in den vom Protokollversand-Sicherungsauftrag, -Kopierauftrag und -Wiederherstellungsauftrag erstellten Verlauf eingefügt. Wenn Sie sqllogship wiederholt zum Ausführen von Sicherungs-, Kopier- und Wiederherstellungsvorgängen für eine Protokollversandkonfiguration verwenden möchten, sollten Sie den entsprechenden Protokollversandauftrag bzw. die entsprechenden Protokollversandaufträge deaktivieren. Weitere Informationen finden sie unter Disable or Enable a Job.

Die sqllogship-AnwendungSqlLogShip.exewird im <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn Verzeichnis installiert.

Berechtigungen

Fürsqllogship wird die Windows-Authentifizierung verwendet. Für das Windows-Authentifizierungskonto zum Ausführen des Befehls sind ein Windows-Verzeichniszugriff und SQL Server -Berechtigungen erforderlich. Die Anforderung hängt davon ab, ob der Sqllogship-Befehl die Option , -backupoder -copy die -restoreOption angibt.

Um die Pfade der Sicherungs- und Kopierverzeichnisse zu ermitteln, können Sie die sp_help_log_shipping_secondary_database gespeicherte Prozedur ausführen oder die log_shipping_secondary Tabelle anzeigen in msdb. Die Pfade des Sicherungsverzeichnisses und des Zielverzeichnisses befinden sich in den backup_source_directory bzw backup_destination_directory . spalten.

Verwandte Inhalte

• Über das Protokollversand (SQL Server)
• Log-Versand-Primärdatenbanken (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)