Ansicht
Dokumentation
BAL_DB_DELETE - Anwendungs-Log: Datenbank: Protokolle auf der Datenbank löschen
BAL Application Log Documentation Fill RESBD Structure from EBP Component StructureDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Möchte man aus der Applikation heraus Protokolle löschen, so steht zu diesem Zweck der Funktionsbaustein BAL_DB_DELETE zur Verfügung.
Die zu löschenden Protokolle können dem Funktionsbaustein auf drei verschiedene Arten übergeben werden (nur alternativ):
- I_T_LOG_HANDLE: Tabelle mit Protokollhandles.
Diese Angabe eignet sich besonders, wenn man in der eigenen Anwendung das LOG_HANDLE aufbewahrt hat.
- I_T_LOGNUMBER: Tabelle mit Protokollnummern.
Diese Tabelle kann genutzt werden, wenn man in der Anwendungstabelle als Referenz auf das Protokoll nicht das LOG_HANDLE sondern die Protokollnummer LOGNUMBER stehen hat (vielleicht noch aus älteren Releases)
- I_T_LOGS_TO_DELETE: Tabelle mit Protokollköpfen.
Diese Tabelle ist der Rückgabewert des Funktionsbausteins BAL_DB_SEARCH. Diesen Funktionsbaustein nutzt man, wenn man in seiner Anwendungstabelle keine Referenz auf das Protokoll hat, sondern die Verbindung über das Feld EXTNUMBER im Protokollkopf hergestellt wird. In diesem Fall ist das Application Log Objekt/Subobjekt und die externe Nummer im dem Filter für BAL_DB_SERACH anzugeben.
BAL_DB_DELETE arbeitet mandantenübergreifend:
- Bei Angabe von I_T_LOG_HANDLE werden Protokolle auch in anderen Mandanten gelöscht (dies ist unkritisch, da das Protokollhandle eindeutig ist)
- Bei Angabe von I_T_LOGNUMBER wird in dem Mandanten I_CLIENT gelöscht. Wird I_CLIENT nicht angegeben, dann wird im aktuellen Mandanten gelöscht
- Bei Angabe von I_T_LOG_HEADER wird der im Feld MANDANT anegebene Mandant berücksichtigt (wird von Funktionsbaustein BAL_DB_SEARCH automatisch gefüllt).
Weitere Parameter:
Der Parameter I_IN_UPDATE_TASK im Funktionsbaustein BAL_DB_DELETE gibt an, ob das Löschen in Update Task durchgeführt werden soll.
Der Parameter I_WITH_COMMIT_WORK gibt an, ob der Funktionsbaustein BAL_DB_DELETE einen COMMIT WORK auslösen soll. Dies ist von Vorteil, wenn man sehr viele Protokolle mit sehr vielen Daten löschen will. Bei den Datenbanken gibt es normalerweise Begrenzungen bezüglich des Rollback-Segments bzw. der Anzahl der DB-Sperren für zu löschende Tabelleneinträge. Um diese Grenzen nicht zu überschreiten, arbeitet BAL_DB_DELETE blockweise, wenn I_WITH_COMMIT_WORK = "X" ist.
Hinweise:
Der Funktionsbaustein BAL_DB_DELETE führt keine Prüfungen durch, ob ein Protokoll löschbar ist (Verfalldatum, etc.). Diese Prüfungen müssen in der Applikation erfolgen.
Weitere Informationen
Weiterführende Informationen
Übersicht der wichtigsten Funktionsgruppen
Application Log: Technische Dokumentation
Parameter
I_CLIENTI_IN_UPDATE_TASK
I_PACKAGE_SIZE
I_T_LOGNUMBER
I_T_LOGS_TO_DELETE
I_T_LOG_HANDLE
I_WITH_COMMIT_WORK
Ausnahmen
NO_LOGS_SPECIFIEDFunktionsgruppe
SBAL_DBPERFORM Short Reference General Data in Customer Master
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 4286 Date: 20240523 Time: 091602 sap01-206 ( 70 ms )