## backup_start

### Verwendung

Sie sichern den Daten- oder den Log-Bereich der Datenbankinstanz.

Nachdem das System dieses DBM-Kommando ausgeführt hat, werden die Informationen über die Sicherung ausgegeben. Dies erfolgt erst dann, wenn der Sicherungsvorgang beendet ist oder unterbrochen wurde. Die Antwort auf dieses DBM-Kommando kann deshalb sehr lange dauern. Den Fortschritt des Sicherungsvorganges können Sie sich währenddessen mit Hilfe des DBM-Kommandos backup_state anzeigen lassen.

Wenn sich aus der Meldungsnummer ergibt, dass der Sicherungsvorgang nur unterbrochen wurde, müssen Sie ihn innerhalb derselben Datenbanksitzung mit einem Folgekommando fortsetzen (backup_replace, backup_ignore) oder beenden (backup_cancel).

Siehe auch:

Tutorial Datenbankverwaltung, Sichern

Konzepte des Datenbanksystems, Daten sichern, Log-Einträge sichern

### Voraussetzungen

● Sie haben die Serverberechtigung Backup.

● Sie haben eine Datenbanksitzung eröffnet (Siehe: db_connect).

● Wenn Sie eine interaktive Log-Sicherung durchführen wollen, müssen Sie zuvor mindestens einmal eine Datensicherung der entsprechenden Datenbankinstanz durchgeführt haben.

### Syntax

backup_start <medium_name> [<backup_type>] [AUTOIGNORE]

Optionen

Option | Beschreibung
<medium_name> | Name der Sicherungsvorlage Beim Sichern auf eine Gruppe paralleler Datenträger ist hier der Name der Gruppe anzugeben.
<backup_type> | Art der Sicherung Diese Angabe müssen Sie nur dann machen, wenn Sie bei der Definition der verwendeten Sicherungsvorlage die Sicherungsart nicht angegeben haben (Vorlagendefinitionen in früheren Versionen). Mögliche Werte sind: DATA: vollständige Datensicherung PAGES: inkrementelle Datensicherung LOG: interaktive Log-Sicherung Andernfalls verwendet das System den Wert der bei der Definition der Sicherungsvorlage angegebenen Sicherungsart.
AUTOIGNORE | Die Sicherung soll automatisch ohne den zuletzt als voll gemeldeten Datenträger fortgesetzt werden (Siehe: backup_ignore)

### Antwort

OK

Returncode <value>

Date [<value>]

Time [<value>]

Server [<value>]

Database [<value>]

Kernel Version [<value>]

Pages Transferred [<value>]

Pages Left [<value>]

Volume Count [<value>]

Medianame [<value>]

Location [<value>]

Errortext [<value>]

Label [<value>]

Is Consistent [<value>]

First LOG Page [<value>]

Last LOG Page [<value>]

DB Stamp 1 Date [<value>]

DB Stamp 1 Time [<value>]

DB Stamp 2 Date [<value>]

DB Stamp 2 Time [<value>]

Page Count [<value>]

Devices Used [<value>]

Werte für die Felder der Antwort

Wert | Beschreibung
Date | Datum
Time | Anfangszeitpunkt des Erstellens der Sicherung
Server | Name des Datenbankrechners
Database | Name der Datenbankinstanz
Kernel Version | Version des Datenbankkerns
Pages Transferred | Anzahl der übertragenen Seiten
Pages Left | Anzahl noch zu übertragender Seiten
Volumes | Anzahl der verwendeten Datenträger
Medianame | Name der Sicherungsvorlage
Location | Datei- oder Gerätename
Errortext | Text der Fehlermeldung
Label | Sicherungskennung
Is Consistent | nur für Datensicherung: Sicherung ist in sich konsistent
First LOG Page | bei Datensicherung: erste einzulesende Seite der Log-Sicherung bei Log-Sicherung: erste gesicherte Seite im Log
Last LOG Page | nur für Log-Sicherung: letzte gesicherte Seite im Log
DB Stamp 1 Date DB Stamp 1 Time | Zeitstempel der ersten Seite der Log-Sicherung
DB Stamp 2 Date DB Stamp 2 Time | Zeitstempel der letzten Seite der Log-Sicherung
Page Count | Gesamtzahl der gesicherten Seiten
Devices Used | Anzahl der verwendeten Sicherungsgeräte
Database ID | Datenbankkennung (zur Identifikation zueinandergehöriger Daten- und Log-Sicherungen)

### Antwort im Fehlerfall

Wenn bei der Verwendung eines Sicherungswerkzeugs eines anderen Anbieters ein Fehler auftritt, erhalten Sie eine Antwort in folgender Form:

ERR

<errcode>, <err_description>

[<extended_description>]

Werte für die Felder der Antwort

Wert | Beschreibung
<errcode> | Nummer der Fehlermeldung Siehe: Dokumentation Meldungen
<err_description> | Beschreibung des Fehlers
<extended_description> | Fehlerursache

Es können folgende Fehler auftreten:

Nummer der Fehlermeldung | Text der Fehlermeldung | Erläuterung
-24927 | ERR_TOOLCHK: the external backup tool was not found | Das Sicherungswerkzeug wurde nicht gefunden oder ist nicht korrekt installiert.
-24926 | ERR_MEDIUMCHK: the medium cannot be used with this external backup tool | Die angegebene Sicherungsvorlage kann mit diesem Sicherungswerkzeug nicht verwendet werden.
-24925 | ERR_PREPARE: prepare of the backup operation failed | Die für die Verwendung des Sicherungswerkzeugs notwendigen Vorbereitungen konnten nicht erfolgreich abgeschlossen werden.
-24924 | ERR_DBREQ: cannot start database kernel request | Die Datenbankinstanz konnte den Sicherungsvorgang nicht starten.
-24923 | ERR_TOOLREQ: cannot start external backup tool correctly | Das Sicherungswerkzeug konnte nicht korrekt gestartet werden.
-24922 | ERR_OPCHK: cannot check state of backup operation | Es war nicht möglich, die Zustände der Datenbankinstanz oder des Sicherungswerkzeugs zu überprüfen.
-24921 | ERR_POSTOP: cannot finish backup operation correctly | Obwohl die Sicherung erfolgreich war, konnten die notwendigen Nachbearbeitungsschritte nicht durchgeführt werden.
-24920 | ERR_BACKUPOP: backup operation was unsuccessful | Die Sicherung ist wegen eines Datenbankproblems oder eines Problemes des Sicherungswerkzeuges fehlgeschlagen.
-24919 | ERR_CLEANUP: cannot clean up correctly after backup operation | Obwohl die Sicherung erfolgreich war, konnten die in Anspruch genommenen temporären Systemressourcen nicht wieder freigegeben werden.