FUZZY Archives - Cadaxo GmbH

ABAP CDS Table Function

Hier ist der Ausgangspunkt eine Data Definition – mittels DDL wird die Table Funktion als Datasource definiert und über die Felder die Struktur festgelegt. Table Functions können auch Parameter besitzen.

@ClientDependent: false
@EndUserText.label: 'ui38 - demo - Orders'
define table function /CADAXO/UI38D_DEMO_ORDER_SH
  with parameters
    name_search :abap.char( 50 )
returns
{
  key OrderId     : /cadaxo/ui38_dmo_order_id;
      CustomerId  : /cadaxo/ui38_dmo_customer_id;
      ProductId   : /cadaxo/ui38_dmo_product_id;
      OrderDate   : /cadaxo/ui38_dmo_order_date;
      Quantity    : /cadaxo/ui38_dmo_quantity;
      Unit        : /cadaxo/ui38_dmo_unit;
      TotalPrice  : /cadaxo/ui38_dmo_price;
      Currency    : /cadaxo/ui38_dmo_currency;
      Description : /cadaxo/ui38_dmo_description;
      Name        : /cadaxo/ui38_dmo_name;
      Score       : /cadaxo/ui38_dmo_score;
}
implemented by method /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS;

@ClientDependent: false

@EndUserText.label: 'ui38 - demo - Orders'

define table function /CADAXO/UI38D_DEMO_ORDER_SH

with parameters

name_search :abap.char( 50 )

returns

{

key OrderId : /cadaxo/ui38_dmo_order_id;

CustomerId : /cadaxo/ui38_dmo_customer_id;

ProductId : /cadaxo/ui38_dmo_product_id;

OrderDate : /cadaxo/ui38_dmo_order_date;

Quantity : /cadaxo/ui38_dmo_quantity;

Unit : /cadaxo/ui38_dmo_unit;

TotalPrice : /cadaxo/ui38_dmo_price;

Currency : /cadaxo/ui38_dmo_currency;

Description : /cadaxo/ui38_dmo_description;

Name : /cadaxo/ui38_dmo_name;

Score : /cadaxo/ui38_dmo_score;

}

implemented by method /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS;

Auffallend ist das returns vor der Feldlist. Damit wird die Struktur der Datensource festgelegt. Wichtiger ist aber der implemented by method Teil, hier /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS

Wenn die Klasse schon existiert, kann die Methode einfach per Quick-Fix angelegt werden!

AMDP Klasse und Methode anlegen

Auch Table Function AMDP werden als spezielle Methode in einer ABAP Klasse implementiert – die Definition erfolgt wie bei jeder anderen Klasse.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.
    INTERFACES if_amdp_marker_hdb.

    CLASS-METHODS search_orders_CDS FOR TABLE FUNCTION /cadaxo/ui38d_demo_order_sh.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_amdp_marker_hdb.

CLASS-METHODS search_orders_CDS FOR TABLE FUNCTION /cadaxo/ui38d_demo_order_sh.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

Durch das Interface IF_AMDP_MARKER_HDB wird die Klasse besonders, was bei der Schnittstellendefinition der statischen Methode search_orders_CDS erkennbar ist: „Verwende alle Parameter der Table Function als Importing Parameter und die Feldliste als Struktur der Return Tabelle“. Aber auch im Implementierungs-Teil erkennt man den Sonderstatus.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders_CDS BY DATABASE FUNCTION
                           FOR HDB LANGUAGE SQLSCRIPT
                           OPTIONS READ-ONLY
                           USING /cadaxo/ui38d_demo_orders.
    RETURN SELECT OrderId,
                  CustomerId,
                  ProductId,
                  OrderDate,
                  Quantity,
                  Unit,
                  TotalPrice,
                  Currency,
                  Description,
                  Name,
                  score( ) as Score
                  from "/CADAXO/UI38D_DEMO_ORDERS"
                  WHERE contains( Name, :name_search, fuzzy( 0.0 ) );

  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders_CDS BY DATABASE FUNCTION

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

RETURN SELECT OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

WHERE contains( Name, :name_search, fuzzy( 0.0 ) );

ENDMETHOD.

ENDCLASS.

BY DATABASE FUNCTION	„Ich bin eine AMDP.“
FOR HDB	Derzeit nur „HDB“ – Kommen auch andere Datenbanken?!?!
LANGUAGE SQLSCRIPT	Wir nehmen SQLSCRIPT.
OPTIONS READ-ONLY	Wir lesen nur, geändert wird nicht!
USING /cadaxo/ui38d_demo_orders	Wir wollen die Bestellungen aus /cadaxo/ui38d_demo_orders

Details zur Fuzzy Search findet man hier: https://help.sap.com/docs/SAP_HANA_PLATFORM/691cb949c1034198800afde3e5be6570/ce619608bb5710148a42ebb92208b5cd.html?locale=en-US

Daten selektieren

Auf Table Functions wird ganz normal mittels ABAP SQL zugegriffen

    SELECT FROM /cadaxo/ui38d_demo_order_sh( name_search = 'Hat Nägel' ) 
           fields OrderId,
                  CustomerId, 
                  ProductId,  
                  OrderDate,  
                  Quantity,   
                  Unit,       
                  TotalPrice, 
                  Currency,   
                  Description,
                  Name,       
                  Score      
           INTO TABLE @DATA(orders).

SELECT FROM /cadaxo/ui38d_demo_order_sh( name_search = 'Hat Nägel' )

fields OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

Score

INTO TABLE @DATA(orders).

Die SAP HANA Datenbank bietet viele nützliche und coole Funktionen, die über openSQL/ABAP SQL hinaus gehen. Um auf diese Features zuzugreifen und die ganze Power der HANA Datenbank nutzen zu können, gibt es ABAP Managed Database Procedures – AMDP. Damit kann man, ähnlich wie mit EXEC SQL bzw. ADBC (ABAP Database Connectivity), native Datenbank Statements absetzen. In diesem Blogbeitrag beschäftigen wir uns mit den nötigen Anlage- und Implementierungsschritten.

AMDP Klasse und Methode anlegen

AMDP werden als spezielle Methode in einer ABAP Klasse implementiert – die Definition erfolgt wie bei jeder anderen Klasse:

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.

    INTERFACES if_amdp_marker_hdb.

    TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

    METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string
                          EXPORTING VALUE(e_orders)      TYPE ty_orders.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_amdp_marker_hdb.

TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string

EXPORTING VALUE(e_orders) TYPE ty_orders.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

Durch das Interface IF_AMDP_MARKER_HDB wird die Klasse besonders, was man im Implementierungs-Teil sehen kann:

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders BY DATABASE PROCEDURE
                       FOR HDB LANGUAGE SQLSCRIPT
                       OPTIONS READ-ONLY
                       USING /cadaxo/ui38d_demo_orders.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      from "/CADAXO/UI38D_DEMO_ORDERS";
  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders BY DATABASE PROCEDURE

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

from "/CADAXO/UI38D_DEMO_ORDERS";

ENDMETHOD.

ENDCLASS.

Die Methodenimplementierung hat einige zusätzliche Statements – Details dazu gibt es auf https://help.sap.com/doc/abapdocu_750_index_htm/7.50/de-de/abapmethod_by_db_proc.htm

BY DATABASE PROCEDURE	„Ich bin eine AMDP.“
FOR HDB	Derzeit nur „HDB“ – Kommen auch andere Datenbanken?!?!
LANGUAGE SQLSCRIPT	Wir nehmen SQLSCRIPT.
OPTIONS READ-ONLY	Wir lesen nur, geändert wird nicht!
USING /cadaxo/ui38d_demo_orders	Wir wollen die Bestellungen aus /cadaxo/ui38d_demo_orders.

AMDP Method aufrufen

Aufgerufen wir die AMDP Methode wie jede andere auch:

    new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'
                                                          IMPORTING e_orders      = data(orders) ).

1 2	new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel' IMPORTING e_orders = data(orders) ).

Fuzzy Search

Ok, der SELECT ist nicht gerade spektakulär – das geht auch mit ABAP SQL. Aber eine fehlertolerante Fuzzy Search?!?

Wir wollen Bestellungen zu Kundennamen finden, auch wenn wir den nicht so ganz genau kennen. Dabei hilft uns CONTAINS und FUZZY – https://help.sap.com/docs/SAP_HANA_PLATFORM/691cb949c1034198800afde3e5be6570/9a4da8f6f23b4ebf95c98f1104a56db4.html?&locale=en-US

Wir erweitern den SELECT um eine WHERE Klausel und suchen wie folgt nach dem Namen:

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.5 ) );

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.5 ) );

Die FUZZY Funktion liefert alle Namen zurück, deren Vergleich mit dem I_Search_Term mindestens einen Score von 0.5 ergibt. Das klingt erstmal einfach, kann aber ziemlich knifflig werden, vor allem, wenn man die Treffermenge, Genauigkeit und Relevanz für Benutzer optimieren möchte. Der passende Schwellenwert ist dann oft nur empirisch ermittelbar.

SCORE

Um den errechneten Wert der Übereinstimmung anzuzeigen und danach zu sortieren, gibt es die Funktion SCORE. Mit FUZZY( 0.0) werden alle Namen mit einem ermittelten Score größer 0 ausgegeben.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      score( ) as Score
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.0 ) );

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.0 ) );

Eine Suche nach „Hat Nägel“ ergibt dann z.B. folgende Trefferliste:

Komplettes Coding

Das ganze Coding sieht folgendermaßen aus:

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.

    INTERFACES if_oo_adt_classrun.

    INTERFACES if_amdp_marker_hdb.

    TYPES: ty_score TYPE p LENGTH 3 DECIMALS 2.
    TYPES: BEGIN OF ty_order.
             INCLUDE TYPE /CADAXO/UI38D_Demo_Orders.
    TYPES:   Score TYPE ty_score,
           END OF ty_order.


    TYPES: ty_orders TYPE STANDARD TABLE OF ty_order WITH DEFAULT KEY.

    METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string
                          EXPORTING VALUE(e_orders)      TYPE ty_orders.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.



CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders BY DATABASE PROCEDURE
                       FOR HDB LANGUAGE SQLSCRIPT
                       OPTIONS READ-ONLY
                       USING /cadaxo/ui38d_demo_orders.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      score( ) as Score
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.0 ) );
  ENDMETHOD.

  METHOD if_oo_adt_classrun~main.

    new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'
                                                          IMPORTING e_orders      = data(orders) ).

    out->write( name = 'Bestellungen zur Suche:' && '`Hat Nägel`' data = orders ).

  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_oo_adt_classrun.

INTERFACES if_amdp_marker_hdb.

TYPES: ty_score TYPE p LENGTH 3 DECIMALS 2.

TYPES: BEGIN OF ty_order.

INCLUDE TYPE /CADAXO/UI38D_Demo_Orders.

TYPES: Score TYPE ty_score,

END OF ty_order.

TYPES: ty_orders TYPE STANDARD TABLE OF ty_order WITH DEFAULT KEY.

METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string

EXPORTING VALUE(e_orders) TYPE ty_orders.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders BY DATABASE PROCEDURE

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.0 ) );

ENDMETHOD.

METHOD if_oo_adt_classrun~main.

new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'

IMPORTING e_orders = data(orders) ).

out->write( name = 'Bestellungen zur Suche:' && '`Hat Nägel`' data = orders ).

ENDMETHOD.

ENDCLASS.

Cookie	Dauer	Beschreibung
cookielawinfo-checkbox-analytics	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics".
cookielawinfo-checkbox-functional	11 months	The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
cookielawinfo-checkbox-necessary	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
cookielawinfo-checkbox-others	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other.
cookielawinfo-checkbox-performance	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
viewed_cookie_policy	11 months	The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.

Tag Archives: FUZZY

ABAP® CDS Table Functions – AMDP – Fuzzy Search für ABAP® SQL mit SAP HANA®

ABAP CDS Table Function

AMDP Klasse und Methode anlegen

Daten selektieren

AMDP – Fuzzy Search im ABAP® mit SAP HANA®

AMDP Klasse und Methode anlegen

AMDP Method aufrufen

Fuzzy Search

SCORE

Komplettes Coding