Einführung in AMDP (ABAP Managed Database Procedure)

Eine Anleitung zum Schreiben von Code auf Datenbankebene, indem die Leistungsfähigkeit der HANA-Datenbank direkt in objektorientierten ABAP-Klassen (OOP) genutzt wird.

Eine der flexibelsten und leistungsstärksten Komponenten der Code Pushdown-Philosophie in der SAP HANA-Architektur sind die AMDP (ABAP Managed Database Procedure)-Strukturen. Bei komplexen Prozeduren, zyklischer Datenbanklogik oder intensiven Datenverarbeitungsprozessen, bei denen CDS Views nicht ausreichen, maximieren wir die Leistung, indem wir unseren Code auf der HANA-Datenbankebene (in der SQLScript-Sprache) ausführen.

Der größte Vorteil von AMDP besteht darin, dass all diese Datenbankprozeduren vollständig innerhalb von Standard-ABAP-Klassen (`SE24` / ADT) verwaltet und kompiliert werden, ohne dass eine externe Datenbankschnittstelle erforderlich ist.

💡 AMDP-Entwicklungsansätze & Regeln

Marker Interface: Damit eine Klasse AMDP-Methoden enthalten kann, muss die Schnittstelle if_amdp_marker_hdb zwingend im `PUBLIC SECTION` definiert werden.
Pass-by-Value-Anforderung: Alle in AMDP-Methoden verwendeten IMPORTING- und EXPORTING-Parameter müssen zwingend als Wert (VALUE(...)) und nicht als Referenz übergeben werden.
USING-Deklaration: Alle ABAP Dictionary (DDIC)-Tabellen und -Views, die in SQLScript abgefragt werden sollen, müssen in der Signatur der Methode explizit mit der Anweisung USING deklariert werden.
Mandt (Mandanten)-Verwaltung: AMDP-Methoden führen keine automatische Mandantenisolierung (mandt) wie Open SQL durch. Daher müssen in den `JOIN`-Bedingungen innerhalb der Abfrage Mandantenabgleiche geschrieben und die aktive Sitzung mit dem Ausdruck `SESSION_CONTEXT('CLIENT')` gefiltert werden.

💻 AMDP Implementierungs- & Ausführungsreferenz

1. AMDP-Klassen- & Methodendefinition

Bei der Erstellung der Klassenarchitektur ist der praktischste Ansatz, die Methodenstruktur als statisch (CLASS-METHODS) zu konzipieren, um die Notwendigkeit der Instanzerstellung aus einem externen Programm zu eliminieren.

CLASS zcl_demo_amdp_simple DEFINITION PUBLIC FINAL CREATE PUBLIC .

  PUBLIC SECTION.
    INTERFACES if_amdp_marker_hdb .

    TYPES: BEGIN OF ty_sales_report,
             vbeln TYPE vbak-vbeln,
             erdat TYPE vbak-erdat,
             kunnr TYPE vbak-kunnr,
             posnr TYPE vbap-posnr,
             matnr TYPE vbap-matnr,
             netwr TYPE vbap-netwr,
             waerk TYPE vbap-waerk,
           END OF ty_sales_report.

    TYPES: tt_sales_report TYPE STANDARD TABLE OF ty_sales_report WITH EMPTY KEY.

    CLASS-METHODS get_sales_data_by_customer
      IMPORTING
        VALUE(iv_kunnr)        TYPE vbak-kunnr
      EXPORTING
        VALUE(et_sales_report) TYPE tt_sales_report.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

2. Datenbankprozedur-Implementierung (HDB SQLScript)

Im Implementierungsteil der Klasse geben wir mit dem BY DATABASE PROCEDURE FOR HDB LANGUAGE SQLSCRIPT-Block an, dass die Methode eine HANA-DB-Prozedur und keine ABAP-Methode ist. Ab diesem Zeitpunkt unterliegt der geschriebene Code vollständig den SQLScript-Syntaxregeln.

CLASS zcl_demo_amdp_simple IMPLEMENTATION.

  METHOD get_sales_data_by_customer
    BY DATABASE PROCEDURE FOR HDB
    LANGUAGE SQLSCRIPT
    OPTIONS READ-ONLY
    USING vbak vbap.

    et_sales_report =
        SELECT
            h.vbeln,
            h.erdat,
            h.kunnr,
            i.posnr,
            i.matnr,
            i.netwr,
            h.waerk
        FROM vbak AS h
        INNER JOIN vbap AS i ON h.mandt = i.mandt
                            AND h.vbeln = i.vbeln
        WHERE h.mandt = SESSION_CONTEXT('CLIENT')
          AND h.kunnr = :iv_kunnr;
  ENDMETHOD.
ENDCLASS.

3. Nutzung von AMDP aus einem ABAP-Report mit SALV

Das Auslösen der vorbereiteten AMDP-Methode mit einem Selektionsbild-Parameter über Open SQL und die Anzeige der zurückgegebenen Ergebnisse mit der objektorientierten SALV-Architektur ist eine der stabilsten Nutzungsmethoden.

REPORT z_demo_amdp_script.

SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE TEXT-001.
  PARAMETERS: p_kunnr TYPE vbak-kunnr.
SELECTION-SCREEN END OF BLOCK b1.

START-OF-SELECTION.

  zcl_demo_amdp_simple=>get_sales_data_by_customer(
    EXPORTING
      iv_kunnr        = |{ p_kunnr ALPHA = IN }|
    IMPORTING
      et_sales_report = DATA(lt_report_data)
  ).

  IF lt_report_data IS NOT INITIAL.
    TRY.
        cl_salv_table=>factory(
          IMPORTING
            r_salv_table = DATA(lo_alv)
          CHANGING
            t_table      = lt_report_data
        ).

        lo_alv->get_functions( )->set_all( abap_true ).
        lo_alv->get_display_settings( )->set_list_header( 'AMDP Simple Demo - Sales Report' ).
        lo_alv->display( ).

      CATCH cx_salv_msg INTO DATA(lx_msg).
        MESSAGE lx_msg->get_text( ) TYPE 'E'.
    ENDTRY.ELSE.
    MESSAGE 'The sales document for the entered customer could not be found!' TYPE 'E' DISPLAY LIKE 'I'.
  ENDIF.

Verpassen Sie nicht den neuen Code in der Bibliothek!

Abonnieren Sie den Newsletter, um sofort über wöchentlich aktualisierte unternehmensweite ABAP-Komponenten, Leistungstipps und Architekturentwürfe informiert zu werden.