DeleteDBJob

Kurzbeschreibung

Dieser Job löscht alle Einträge älter als ein konfigurierter Zeitpunkt aus der Datenbank. Grundsätzlich ist empfohlen, Nachrichten nicht länger als 4 Wochen bis 12 Wochen in der B2B zu belassen. Werden die Nachrichten beibehalten (z. B. weil keine Archivierung konfiguriert ist), wird dringen empfohlen, zumindest obsolete Aktionen, Attribute und Fehlermeldungen mit der Option B3P_COMPRESS_ACTIONS zu entfernen.

Wahlweise können die Tabellen B2BBP_DATA_ATTRIBUTE (Nachrichtenattribute), B2BBP_DATA_ERROR (Fehlermeldungen zu ausgeführten Aktionen), B2BBP_DATA_ACTION (ausgeführte Aktionen einschließlich aller Attribute und Fehlermeldungen), B2BBP_DATA_MESSAGE (vollständige Nachrichten) zum Löschen ausgewählt werden. Für die Tabelle B2BBP_DATA_ACTION ist es möglich, nur solche Aktionen zu löschen, zu denen keine zu archivierende Attribute (z. B. der eigentliche Nachrichtentext) existieren. Dies lässt sich durch Setzen der Option B3P_COMPRESS_ACTIONS (standardmäßig gesetzt) erreichen.

Beim Löschen aus den B2BBP_DATA_MESSAGE und B2BBP_DATA_ACTION Tabellen werden automatisch alle abhängigen Daten gelöscht.

Der DeleteDBJob erlaubt das Löschen größerer Datenmengen. Um dabei einzelne Tabellen nicht zu lange zu sperren, wird das Löschen Blockweise durchgeführt. Dabei ist konfigurierbar, in welcher zeitlichen Stückelung gelöscht werden soll (standardmäßig wird nur ein Datentag auf einmal gelöscht). Weiterhin kann eine maximale Laufzeit für den DeleteDBJob angegeben werden, nach welcher der DeleteDBJob automatisch beendet wird. Dies erlaubt es, dem DeleteDBJob definierte Zeitfenster zur Arbeit zuzuweisen.

Der DeleteDBJob gibt nach seiner Ausführung (neben dem eingestellten Löschzeitraum für den Job) den Zeitraum der innerhalb des Job-Runs tatsächlich gelöschten Nachrichten in der B2BBP_DATA_MESSAGE-Tabelle an.

Der DeleteDBJob kann auf Systemen, die den SwitchPartitionJob verwenden konfiguriert werden, in ausgewählten Partitionen zu löschen.

Einrichtung

Der DeleteDBJob ist ein Job, der über einen Scheduler eingerichtet wird. Zunächst wird daher gemäß der Dokumentation zu Scheduler Services ein Scheduler für den DeleteDBJob eingerichtet. Als Service Eigenschaft B3P_SCHEDULER_REGISTER_CLASSNAME wird der Klassenname org.b2bbp.service.inbound.scheduled.DeleteDBJob gesetzt.

Alle weiteren Einstellungen sind der nachstehenden Tabellen von Service Eigenschaften zu entnehmen.

Service Eigenschaften (Standard)

Die hier angegebenen Service Eigenschaften werden bei Ausführung des Services automatisch mit ihren Standardwerten initialisiert, wenn sie nicht zuvor vom Benutzer gesetzt worden sind.

Name der Eigenschaft erlaubte Werte Beschreibung
B3P_DEL_ACTION_DATE_BEFORE Eine durch Leerzeichen getrennte Liste von additiven Zeitabständen. (Default: 'B3P_DEL_MESSAGE_DATE_BEFORE')
Beispiel:
Ab Version 1.14.1_0.x: '1y 2m 3d 4h 5min 6sec' für 1 Jahr, 2 Monate, 3 Tage, 4 Stunden, 5 Minuten, 6 Sekunden
Vor Version 1.14.1_0.x: '1y 2M 3d 4h 5m 6s'.
Achtung: ab Version 1.14.1_0.x sind die Angaben der Zeitabstände case insensitive. Sowohl "M" als auch "m" geben nun den Monat an, "min" die Minuten und "sec" die Sekunden. "m" gibt nicht mehr die Minuten an!
Diese Eigenschaft gibt das Mindestalter von Aktionen an, die gelöscht werden sollen. Ein Wert von '90d' würde Aktionen von Nachrichten erfassen, die aktuell (zum Zeitpunkt des Job-Starts) älter als 90 Tage sind, ein Wert von '5M 2h' erfasst Nachrichten, die älter als 5 Kalendermonate und zwei Stunden sind. Das Löschen von Aktionen wirkt sich ebenfalls auf abhängige Attribute und Fehlermeldungen aus. Ist die Eigenschaft B3P_COMPRESS_ACTIONS gesetzt, so werden aber keine zu archivierenden Attribute (und infolgedessen auch nicht die Aktionen von denen sie abhängen) gelöscht.
Ein leerer Wert gibt an, dass keine Aktionen gelöscht werden sollen!
Zur Rückwärtskompatibilität wird noch das vor der Version 1.9.2 verwendete Format aus sechs Ganzzahlen in der folgenden Darstellung unterstützt: '<Jahre> <Monate> <Tage> <Stunden> <Minuten> <Sekunden>'.
Beispiel: 0 3 2 10 0 0 für alle Nachrichten, die älter sind als 0 Jahre, 3 Monate, 2 Tage, 10 Stunden , 0 Minuten, 0 Sekunden.
B3P_DEL_ATTRIBUTE_DATE_BEFORE eine durch Leerzeichen getrennte Liste von additiven Zeitabständen. (Default: 'B3P_DEL_MESSAGE_DATE_BEFORE')
Beispiel:
Ab Version 1.14.1_0.x: '1y 2m 3d 4h 5min 6sec' für 1 Jahr, 2 Monate, 3 Tage, 4 Stunden, 5 Minuten, 6 Sekunden
Vor Version 1.14.1_0.x: '1y 2M 3d 4h 5m 6s'.
Achtung: ab Version 1.14.1_0.x sind die Angaben der Zeitabstände case insensitive. Sowohl "M" als auch "m" geben nun den Monat an, "min" die Minuten und "sec" die Sekunden. "m" gibt nicht mehr die Minuten an!
Diese Eigenschaft gibt das Mindestalter von Attributen an, die gelöscht werden sollen. Ein Wert von '90d' würde Attribute von Nachrichten erfassen, die aktuell (zum Zeitpunkt des Job-Starts) älter als 90 Tage sind, ein Wert von '5M 2h' erfasst Nachrichten, die älter als 5 Kalendermonate und zwei Stunden sind.
Ein leerer Wert gibt an, dass keine Attribute gelöscht werden sollen!
Zur Rückwärtskompatibilität wird noch das vor der Version 1.9.2 verwendete Format aus sechs Ganzzahlen in der folgenden Darstellung unterstützt: '<Jahre> <Monate> <Tage> <Stunden> <Minuten> <Sekunden>'.
Beispiel: 0 3 2 10 0 0 für alle Nachrichten, die älter sind als 0 Jahre, 3 Monate, 2 Tage, 10 Stunden , 0 Minuten, 0 Sekunden.
B3P_DEL_ERROR_DATE_BEFORE eine durch Leerzeichen getrennte Liste von additiven Zeitabständen. (Default: 'B3P_DEL_MESSAGE_DATE_BEFORE')
Beispiel:
Ab Version 1.14.1_0.x: '1y 2m 3d 4h 5min 6sec' für 1 Jahr, 2 Monate, 3 Tage, 4 Stunden, 5 Minuten, 6 Sekunden
Vor Version 1.14.1_0.x: '1y 2M 3d 4h 5m 6s'.
Achtung: ab Version 1.14.1_0.x sind die Angaben der Zeitabstände case insensitive. Sowohl "M" als auch "m" geben nun den Monat an, "min" die Minuten und "sec" die Sekunden. "m" gibt nicht mehr die Minuten an!
Diese Eigenschaft gibt das Mindestalter von Fehlermeldungen an, die gelöscht werden sollen. Ein Wert von '90d' würde Fehlermeldungen von Nachrichten erfassen, die aktuell (zum Zeitpunkt des Job-Starts) älter als 90 Tage sind, ein Wert von '5M 2h' erfasst Nachrichten, die älter als 5 Kalendermonate und zwei Stunden sind.
Ein leerer Wert gibt an, dass keine Fehlermeldungen gelöscht werden sollen!
Zur Rückwärtskompatibilität wird noch das vor der Version 1.9.2 verwendete Format aus sechs Ganzzahlen in der folgenden Darstellung unterstützt: '<Jahre> <Monate> <Tage> <Stunden> <Minuten> <Sekunden>'.
Beispiel: 0 3 2 10 0 0 für alle Nachrichten, die älter sind als 0 Jahre, 3 Monate, 2 Tage, 10 Stunden , 0 Minuten, 0 Sekunden.
B3P_DEL_DATA_DATE_AFTER eine durch Leerzeichen getrennte Liste von additiven Zeitabständen. (Default: 'B3P_DEL_MESSAGE_DATE_BEFORE')
Beispiel:
Ab Version 1.14.1_0.x: '1y 2m 3d 4h 5min 6sec' für 1 Jahr, 2 Monate, 3 Tage, 4 Stunden, 5 Minuten, 6 Sekunden
Vor Version 1.14.1_0.x: '1y 2M 3d 4h 5m 6s'.
Achtung: ab Version 1.14.1_0.x sind die Angaben der Zeitabstände case insensitive. Sowohl "M" als auch "m" geben nun den Monat an, "min" die Minuten und "sec" die Sekunden. "m" gibt nicht mehr die Minuten an!
Diese Eigenschaft gibt das Maxmimalalter von Nachrichten an, die gelöscht werden sollen. Ein Wert von '120d' würde Nachrichten erfassen, die aktuell (zum Zeitpunkt des Job-Starts) nicht älter als 120 Tage sind. Ein leerer Wert setzt diesen mit B3P_DEL_MESSAGE_DATE_BEFORE gleich und unterbindet damit, dass Nachrichten gelöscht werden.
B3P_DEL_MAX_DURATION_SECS positive Ganzzahl (default: 3600). Diese Eigenschaft gibt, wie lange der Job laufen darf, bis er nach Beendigung der aktuellen Operation abbricht.
B3P_DATABASE DEFAULT (default), SQLSERVER, ORACLE, MYSQL Hier kann der Datenbanktyp angegeben werden, auf dem gelöscht werden soll. Die Einstellung DEFAULT soll für alle Datenbanken funktionieren. Die anderen Einstellungen verwenden Vendorspezifischen Syntax um die Performance zu erhöhen.

Service Eigenschaften (Experte)

Experteneigenschaften werden in der Regel nicht benötigt. Sie sind daher nur in Ausnahmefällen zu setzen.

Name der Eigenschaft erlaubte Werte Beschreibung
B3P_DEL_MESSAGE_DATE_BEFORE eine durch Leerzeichen getrennte Liste von additiven Zeitabständen. (Default: '01.01.1970')
Beispiel:
Ab Version 1.14.1_0.x: '1y 2m 3d 4h 5min 6sec' für 1 Jahr, 2 Monate, 3 Tage, 4 Stunden, 5 Minuten, 6 Sekunden
Vor Version 1.14.1_0.x: '1y 2M 3d 4h 5m 6s'.
Achtung: ab Version 1.14.1_0.x sind die Angaben der Zeitabstände case insensitive. Sowohl "M" als auch "m" geben nun den Monat an, "min" die Minuten und "sec" die Sekunden. "m" gibt nicht mehr die Minuten an!
Diese Eigenschaft gibt das Mindestalter von Nachrichten an, die gelöscht werden sollen. Ein Wert von '90d' würde Nachrichten erfassen, die aktuell (zum Zeitpunkt des Job-Starts) älter als 90 Tage sind, ein Wert von '5M 2h' erfasst Nachrichten, die älter als 5 Kalendermonate und zwei Stunden sind.
Ein leerer Wert gibt an, dass keine Nachrichten gelöscht werden sollen!
Dieser Job löscht auch nicht archivierte Nachrichten unwiderbringlich. Diese Einstellung soll daher nur mit Vorsicht gesetzt werden.
Zur Rückwärtskompatibilität wird noch das vor der Version 1.9.2 verwendete Format aus sechs Ganzzahlen in der folgenden Darstellung unterstützt: '<Jahre> <Monate> <Tage> <Stunden> <Minuten> <Sekunden>'.
Beispiel: 0 3 2 10 0 0 für alle Nachrichten, die älter sind als 0 Jahre, 3 Monate, 2 Tage, 10 Stunden , 0 Minuten, 0 Sekunden.
B3P_ACTION_TABLES Durch Semikolons getrennte Liste von Tabellennamen der Länge 1..1000 (Default: 'B2BBP_DATA_ACTION'). Die Eigenschaft definiert die Tabellen, in denen Aktionen standardmäßig gespeichert werden.
B3P_ATTRIBUTE_ARCHIVE_TABLE Zeichenkette 1..1000 (Default. 'B2BBP_DATA_ATTRIBUTE_ARCHIVE'). Die Eigenschaft definiert die Tabelle, in der nach zu archivierenden Daten gesucht werden, um das Löschen von Aktionen einzuschränken.
B3P_ATTRIBUTE_TABLES Durch Semikolons getrennte Liste von Tabellennamen der Länge 1..1000 (Default: 'B2BBP_DATA_ATTRIBUTE'). Die Eigenschaft definiert die Tabellen, in denen Attribute standardmäßig gespeichert werden.
B3P_DEL_BATCH_WINDOW_SECS eine positive Ganzzahl (Default: 86400). Die Eigenschaft definiert das Zeitfenster, indem eine atomare Löschoperation ausgeführt werden soll. Ist dieses Zeitfenster zu klein gewählt, kann das Löschen ineffizient werden. Ist es zu groß gewählt kommt es zu langen blockierenden Operationen auf der Datenbank. Der Wert ist in der Einheit Sekunden angegeben.
B3P_COMPRESS_ACTIONS true (default), false Diese Eigenschaft schränkt das Löschen von Aktionen standardmäßig so ein, dass keine zu archiverenden Daten gelöscht werden.
B3P_MESSAGE_TABLE Zeichenkette 1..1000 (Default. 'B2BBP_DATA_MESSAGE'). Die Eigenschaft definiert den Namen der Nachrichtentabelle, in der Nachrichtentyp und -startdatum definiert sind.
B3P_PARTITIONS Durch Semikolons getrennte Liste von Partitionen: ACTIVE SQLSERVER, ORACLE, MYSQL (Default. 'ACTIVE') Hier kann der Datenbanktyp angegeben werden, auf dem gelöscht werden soll. Die Einstellung DEFAULT soll für alle Datenbanken funktionieren. Die anderen Einstellungen verwenden Vendorspezifischen Syntax um die Performance zu erhöhen.
View Me   Edit Me