Share via

sqllogship-toepassing

van toepassing op:SQL Server-

De sqllogship-toepassing voert een back-up-, kopieer- of herstelbewerking uit en bijbehorende opschoontaken voor een configuratie voor logboekverzending. De bewerking wordt uitgevoerd op een specifiek exemplaar van SQL Server voor een specifieke database.

Zie SQL-opdrachtregelprogramma's (Database Engine) voor de syntaxisconventies.

Syntaxis

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

Argumenten

- server instance_name

Hiermee geeft u het exemplaar van SQL Server waarop de bewerking wordt uitgevoerd. Het serverexemplaren dat moet worden opgegeven, is afhankelijk van welke bewerking voor het verzenden van logboeken wordt opgegeven. Voor -backupmoet instance_name de naam van de primaire server in een logboekverzendingsconfiguratie zijn. Voor -copy of -restoremoet instance_name de naam zijn van een secundaire server in een configuratie voor logboekverzending.

-back-up primary_id

Voert een back-upbewerking uit voor de primaire database waarvan de primaire id is opgegeven door primary_id. U kunt deze id verkrijgen door deze te selecteren in de log_shipping_primary_databases systeemtabel of met behulp van de sp_help_log_shipping_primary_database opgeslagen procedure.

De back-upbewerking maakt de logboekback-up in de back-upmap. De sqllogship-toepassing schoont vervolgens alle oude back-upbestanden op op basis van de bewaarperiode voor bestanden. Vervolgens registreert de toepassing de geschiedenis van de back-upbewerking op de primaire server en de monitorserver. Ten slotte wordt de toepassing uitgevoerd sp_cleanup_log_shipping_history, waarmee oude geschiedenisgegevens worden opgeschoond op basis van de bewaarperiode.

- kopieer secondary_id

Voert een kopieerbewerking uit om back-ups te kopiëren van de opgegeven secundaire server voor de secundaire database of databases, waarvan de secundaire id is opgegeven door secondary_id. U kunt deze id verkrijgen door deze te selecteren in de log_shipping_secondary systeemtabel of met behulp van de sp_help_log_shipping_secondary_database opgeslagen procedure.

De bewerking kopieert de back-upbestanden van de back-upmap naar de doelmap. De sqllogship-toepassing registreert vervolgens de geschiedenis voor de kopieerbewerking op de secundaire server en de monitorserver.

-herstel secondary_id

Voert een herstelbewerking uit op de opgegeven secundaire server voor de secundaire database of databases waarvan de secundaire id is opgegeven door secondary_id. U kunt deze id verkrijgen met behulp van de sp_help_log_shipping_secondary_database opgeslagen procedure.

Back-upbestanden in de doelmap die zijn gemaakt na het meest recente herstelpunt, worden hersteld naar de secundaire database of databases. De sqllogship-toepassing schoont vervolgens alle oude back-upbestanden op op basis van de bewaarperiode voor bestanden. Vervolgens registreert de toepassing de geschiedenis van de herstelbewerking op de secundaire server en de monitorserver. Ten slotte wordt de toepassing uitgevoerd sp_cleanup_log_shipping_history, waarmee oude geschiedenisgegevens worden opgeschoond op basis van de bewaarperiode.

-uitgebreid niveau

Hiermee geeft u het niveau op van berichten die zijn toegevoegd aan de verzendgeschiedenis van het logboek. niveau is een van de volgende gehele getallen:

Niveau Beschrijving
0 Voer geen tracerings- en foutopsporingsberichten uit.
1 Foutberichten voor het verwerken van uitvoerfouten.
2 Uitvoerwaarschuwingen en foutberichten.
3 (standaard) Informatieve berichten, waarschuwingen en foutberichten uitvoeren.
4 Voer alle foutopsporings- en traceringsberichten uit.

- logintimeout-timeout_value

Hiermee geeft u de hoeveelheid tijd die is toegewezen voor het aanmelden bij het serverexemplaren voordat er een time-out optreedt. De standaardwaarde is 15 seconden. timeout_value is int.

- querytimeout-timeout_value

Hiermee geeft u de hoeveelheid tijd die is toegewezen voor het starten van de opgegeven bewerking voordat er een time-out optreedt voor de poging. De standaardwaarde is geen time-outperiode. timeout_value is int.

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

Van toepassing op: SQL Server 2025 (17.x) en latere versies.

Hiermee geeft u extra connectiviteitsopties in de vorm van sleutel-waardeparen.

De volgende tabel bevat de beschikbare connectiviteitsopties:

Key Waarde
Encrypt strict mandatory, optional, truefalse
TrustServerCertificate true,false,yes,no
ServerCertificate Pad op het bestandssysteem naar het servercertificaat. Deze optie heeft een maximale lengte van 260 tekens.
HostNameInCertificate Hostnaam overschrijven voor het certificaat. Deze optie heeft een maximale lengte van 255 tekens.

Opmerkingen

Gebruik de back-up-, kopieer- en hersteltaken om deze handelingen uit te voeren, wanneer mogelijk. Als u deze taken vanuit een batchbewerking of een andere toepassing wilt starten, roept u de sp_start_job opgeslagen procedure aan.

De logboekverzendingsgeschiedenis die door sqllogship is gemaakt, wordt met elkaar verbonden met de geschiedenis die is gemaakt door back-up van logboekverzending, kopieer- en hersteltaken. Als u sqllogship herhaaldelijk wilt gebruiken om back-up-, kopieer- of herstelbewerkingen uit te voeren voor een logboekverzendingsconfiguratie, kunt u overwegen de bijbehorende logboekverzendingstaak of -taken uit te schakelen. Zie Een taak uitschakelen of inschakelen voor meer informatie.

De sqllogship-toepassing , SqlLogShip.exewordt geïnstalleerd in de <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn map.

Machtigingen

sqllogship maakt gebruik van Windows-verificatie. Voor het Windows-verificatieaccount waarop de opdracht wordt uitgevoerd, zijn toegang tot Windows-mappen en SQL Server-machtigingen vereist. De vereiste is afhankelijk van of de sqllogship-opdracht de -backup, -copyof -restore optie aangeeft.

Optie Adreslijsttoegang Machtigingen
-backup Vereist lees-/schrijftoegang tot de back-upmap. Vereist dezelfde machtigingen als de BACKUP instructie. Zie BACKUP voor meer informatie.
-copy Vereist leestoegang tot de back-upmap en schrijftoegang tot de kopiemap. Vereist dezelfde machtigingen als de sp_help_log_shipping_secondary_database opgeslagen procedure.
-restore Vereist lees-/schrijftoegang tot de kopieermap. Vereist dezelfde machtigingen als de RESTORE instructie. Zie RESTORE-instructies voor meer informatie.

Als u de paden van de back-up en het kopiëren van mappen wilt achterhalen, kunt u de sp_help_log_shipping_secondary_database opgeslagen procedure uitvoeren of de log_shipping_secondary tabel bekijken in msdb. De paden van de back-upmap en doelmap bevinden zich respectievelijk in de backup_source_directory en backup_destination_directory kolommen.

Verwante inhoud

  • Last updated on