IBX.IBServices.TRestoreOptions

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

TRestoreOptions = set of TRestoreOption;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
set public IBX.IBServices.pas IBX.IBServices IBX.IBServices

Beschreibung

TRestoreOption und TRestoreOptions geben an, welche Operationen bei der Wiederherstellung einer InterBase-Datenbank stattfinden.

TRestoreOptions enthält eine Menge von Werten für TRestoreOption. Die folgende Tabelle enthält die möglichen Werte:



DeactivateIndexes

Normalerweise baut InterBase bei der Wiederherstellung einer Datenbank die Indizes neu auf. Wenn die Datenbank zum Zeitpunkt der Sicherung doppelte Einträge in einem eindeutigen Index enthielt, scheitert die Wiederherstellung. Doppelte Werte können in eine Datenbank gelangen, wenn die Indizes vorübergehend deaktiviert wurden, beispielsweise um die Einfügung vieler Datensätze zu ermöglichen oder um einen Index zu reorganisieren.

Damit auch in solchen Konstellationen eine erfolgreiche Wiederherstellung möglich wird, weisen Sie DeactivateIndexes den Wert True zu. Dadurch werden die Indizes deaktiviert, und deren Neuaufbau wird unterdrückt.

NoShadow

Normalerweise baut InterBase bei der Wiederherstellung einer Datenbank die zuvor definierten Datenbank-Hintergrunddateien neu auf. Um sicherzustellen, dass die Hintergrunddateien nicht neu aufgebaut werden, weisen Sie NoShadow den Wert True zu.

NoValidityCheck

Wenn Sie die Gültigkeitsbeschränkungen in einer Datenbank ändern, die bereits Daten enthält, kann es geschehen, dass die Daten diese Beschränkungen nicht mehr erfüllen. Dies kann so lange unbemerkt bleiben, bis eine Wiederherstellung der Datenbank versucht wird. Erst dann tritt ein Fehler wegen ungültiger Daten auf.

Um eine Datenbank wiederherzustellen, die ungültige Daten enthält, weisen Sie NoValidity den Wert True zu. Dadurch werden die Gültigkeitsbeschränkungen aus den Metadaten gelöscht. Sobald die Datenbank wiederhergestellt ist, ändern Sie die Daten so, dass sie entsprechend den neuen Integritätsbedingungen gültig sind. Fügen Sie dann die gelöschten Beschränkungen wieder hinzu.

Wichtig: Erstellen Sie immer eine Kopie der Metadaten, bevor Sie diese umdefinieren. Hierzu eignet sich beispielsweise die Option MetadataOnly der Eigenschaft Options von TIBBackupService.

OneRelationAtATime

Weisen Sie OneRelationAtATime den Wert True zu, um die Metadaten und die Daten zusammen für jede Tabelle einzeln nacheinander wiederherzustellen.

Diese Option ist besonders dann hilfreich, wenn bei der Wiederherstellung einer Sicherungsdatei Probleme auftauchen, beispielsweise weil die Daten im Sinne der Integritätsbedingungen beschädigt oder ungültig sind.

Replace

Eine Anwendung kann eine vorhandene Datenbankdatei erst dann überschreiben, wenn Replace der Wert True zugewiesen wurde. Wenn Sie die Wiederherstellung mit einem vorhandenen Datenbanknamen versuchen, während dieser Optionswert nicht festgelegt ist, kann die Wiederherstellung nicht durchgeführt werden.

Wichtig: Stellen Sie eine vorhandene Datenbankdatei nicht wieder her, während Clients gerade damit arbeiten. Ein sicherer Ansatz besteht darin, die vorhandene Datenbankdatei umzubenennen, die Datenbank wiederherzustellen und die alte Datenbank zu löschen oder zu archivieren, sobald sie nicht mehr benötigt wird.

CreateNew

Wenn die Datenbank in einer neuen Datei wiederhergestellt werden soll, weisen Sie der Option Create den Wert True zu.

UseAllSpace

Bei der Wiederherstellung einer Datenbank füllt InterBase jede Datenseite standardmäßig mit 80 % ihrer Kapazität. Soll auf den Datenseiten ein Füllgrad von 100 % erreicht werden, weisen Sie der Option UseAllSpace den Wert True zu.