DbaKeyRebuild

DbaKeyRebuild(int1[, int2, int3]) : int

Schlüssel reorganisieren

Details

• int1: Dateinummer
• int2: Schlüsselnummer (optional)
• int3:
  • Optionen (optional):
  • _KeyWait
  • _KeyNoBreak
  • _KeyOnlyEmpty
• Resultat: int Reorganisationsresultat _rOk Reorganisation erfolgreich _rNoKey Kein leerer Schlüssel vorhanden _rUserBreak Abbruch durch Benutzer _ErrGeneric Schlüsselwertkollision aufgetreten
• Siehe: Verwandte Befehle

Mit diesem Befehl wird die Reorganisation von Schlüsseln durchgeführt.

Bei der Schlüsselreorganisation werden alle Datensätze einer Datei gelesen und die Schlüsselwerte erzeugt. Müssen mehr als 10.000 Datensätze reorganisiert werden, parallelisiert der CONZEPT 16-Server diese Aufgabe über mehrere Benutzer. Der Server kann nur dann mehrere Benutzer verwenden, wenn die Anweisung nicht innerhalb einer Transaktion (siehe DtaBegin ()) aufgerufen wird. Ob eine Transaktion gestartet wurde, kann mit der Anweisung DbaInfo ( _DbaDtaLevel ) ermittelt werden.

Beispiele:

// Alle Schlüssel der Datenbank reorganisieren
DbaKeyRebuild(0);

// Alle leeren Schlüssel der Datenbank reorganisieren
DbaKeyRebuild(0, 0,_KeyOnlyEmpty | _KeyWait);

// Alle Schlüssel der Datei 10 reorganisieren
DbaKeyRebuild(10, 0);

// Schlüssel 2 der Datei tblAdrAdressen reorganisieren
DbaKeyRebuild(tblAdrAdressen, 2);