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 zeichnet die Anwendung die Historie des Sicherungsvorgangs auf dem primären Server und dem Überwachungsserver auf. 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 protokolliert die Anwendung den Verlauf des Wiederherstellungsvorgangs auf dem sekundären Server und dem Überwachungsserver. Schließlich führt die Anwendung sp_cleanup_log_shipping_history aus, wodurch alte Verlaufsinformationen gemäß dem Aufbewahrungszeitraum gelöscht werden.

-verboselevel Stufe

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 ist mit dem Verlauf durchsetzt, der von den Protokollversand-Sicherungs-, -Kopier- und -Wiederherstellungsaufträgen erstellt wird. 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 Deaktivieren oder Aktivieren eines Jobs.

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 -backup, -copy oder -restore 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)