Technical Articles
Access SAP ERP data from SAP HANA through SDI ABAP Adapter
Do you want to use data residing in SAP ERP for analytics or machine learning ?
SAP offers several options to extract data residing in ABAP-based systems. We will explore one of these options in this blog : SAP HANA smart data integration (SDI). SDI provides tools to access source data and provision, replicate, and transform that data in SAP HANA on-premise or in the cloud. You can efficiently connect to many sources to provision and cleanse data for loading into SAP HANA. For supported systems, you can also write back from HANA to the original source.
In this blog, we will set up the ABAP Adapter for a real time data replication from SAP ERP to SAP HANA as a Service.
Sources : SAP SQL Data Warehousing with HANA
Extraction from SAP S/4HANA and other ABAP sources into HANA SQL DW with SDI
Notes : In this scenario we are replication data from SAP ERP to SAP HANA for reporting. If you want to migrate an ERP system to S/4HANA, or replicate data in real time from ERP to S/4HANA, there are other solutions available, such as SAP Data Services, SAP Landscape Transformation Replication Server, and SAP S/4HANA Migration Cockpit.
Have a look at Migrating data to your (new) SAP S/4HANA
Which SDI adapter should you use to extract data from SAP ERP/SAP BW ?
When you want to access data residing in SAP ERP or SAP BW, SDI offers two categories of adapters :
ABAP adapter accesses the Application server : you do not require access to the database to use it. It retrieves data from virtual tables through RFC for ABAP tables and ODP extractors.
Full-use license from the database is not required.
The ABAP Adapter supports change data capture (CDC) only for ODP extractors.
IBM Db2 Log Reader, Microsoft SQL Server Log Reader, Oracle Log Reader, SAP ASE adapters access the Database : Full-use license is required from the database vendor. You need to have access as an admin user to the database. Of course it gives you access to all information residing in the database (even non-SAP tables). SAP ERP ECC adapters are a set of data provisioning adapters to provide access to SAP ECC data and metadata built on top of Data Provisioning log reader adapters for the same database.
I explained here how to use Oracle adapter to access data residing in an Oracle database. You can set-up the other database adapters in a similar way.
SDI Standard adapters as of SAP HANA 2.0SPS04 | |
Database | SAP HANA SAP ASE IBM Db2 IBM Informix Oracle Microsoft SQL Server Microsoft Office Access Teradata PostgreSQL JDBC |
Application | SAP ABAP (tables / BAPI / ODP) SAP ECC (based on SAP ASE / IBM DB2 / Microsoft SQL Server / Oracle) SAP BW (BEx query) |
API | Facebook OData SOAP |
Big data | Cassandra (NoSQL) Impala Hive |
File | Microsoft Excel File (Sharepoint, HDFS) Outlook (PST file) |
Steps
1) Set up your SAP ERP system
2) Set up your HANA system
3) Download DP agent from SAP Service Marketplace as a ZIP file
4) Configure DP agent
5) Create a remote source
6) Create a replication task
7) Execute the replication task
8) Check the results
Set up your SAP ERP system
Your SAP system PI_BASIS component must be version 701 or higher to use the ABAP Adapter fully. Refer to note 2166986
You can use RFC streaming to extract data with the ABAP adapter.
When you are NOT using RFC streaming, the whole data set is extracted as one batch through the ABAP Application server. That process is somewhat faster than using RFC streaming.
So, non-RFC streaming is faster on small queries, however extracting a whole recordset at once comes with the obvious requirement to have enough memory for the whole recordset.
A general rule (depending on the record length) is 1 GB of RAM on the Data Provisioning Agent machine per 1 million records.
As the data set we wanted to load comprised several million records, it did not fit in the RAM of the source SAP ERP system and we chose to use RFC streaming. We recommend using RFC streaming based on the fact that it works for many different scenarios, small or large queries, multiple concurrent sessions, and so on. Even though the performance is slower for small queries and it requires extra configuration on the ECC side.
SAP systems based on ABAP technology provide Operational Data Provisioning Extractors (ODP Extractors) which allow users to extract data for reporting. They contain pre-delivered business logic built into the source system to fetch the right data and preprocess it. They also have a built-in delta mechanism to deliver only the changes. Learn more about Operational Data Provisioning.
In our case, we wanted to extract data from ABAP tables in real-time, se we had to wrap an ODP extractor around these particular tables. Extraction directly from ABAP tables is also supported by the SDI ABAP adapter, but it does not leverage ODP technology and therefore we cannot have real-time data replication.
To use ODP, the source system should adhere to the requirements posed in SAP Note 2232584 – Release of SAP extractors for operational data.
- Create an ODP extractor in your Development landscape (Note 2350464, Note 2232584, Note 1521883, How to create a generic datasource
- Transfer the objects to the QC landscape, or Production landscape where you want replication to happen.
- Set-up the Gateway service ECC Client and Gateway Service Configuration
- Configure the Access Control List (ACL) that controls which host can connect to the gateway. That file should contain something similar to the following syntax: <permit> <ip-address[/mask]> [tracelevel] [# comment]
- Configure a reginfo file to control permissions to register external programs.
- The host where the Data Provisioning agent is running must have a service configured with the name matching the remote SAP gateway name.
- Finally you need an ERP user with all necessary roles to access data. Find a list of necessary ERP roles and their details on page 459 of this guide.
To start replicating data in real time from your SAP ERP system, you must have a data source registered on your SAP Gateway, pointing to an ODP extractor.Make sure it is real-time enabled.
Set up your HANA system
We use SAP HANA as a service on SAP Cloud Platform for this tutorial.
To replicate the same steps, you will need an SAP Cloud Platform account with HANA entitlements (You cannot replicate this in a trial account as of March 2020). Set up the HANA service in SAP Cloud Platform Cloud Foundry
Once the setup is done, access the space where you deployed the SAP HANA service. It should be similar to this. Click on the dashboard button for the SAP HANA service.
From the SAP HANA service dashboard, enable the Data Provisioning Server. Click Edit and enable.
From this dashboard, you can see all the information relevant to your SAP HANA database tenant, and you can access the SAP HANA cockpit to perform all database administrator activities.
At this stage, I accessed the SAP HANA cockpit to create a HANA user for Agent Messaging, which will be used when setting up the DP agent.
Download DP agent from SAP Service Marketplace as a ZIP file
The next step is to install DP agent on the server which will be used to replicate data from SAP ERP to your SAP HANA database. It can be installed on the ERP server, on a cloud server, or on your own local computer. For this tutorial, we used an AWS virtual windows machine.
SAP Software Download Center > Software Downloads > Support Packages & Patches > By Alphabetical Index (A-Z) > H > SAP HANA SDI > SAP HANA SDI <version_number> > Comprised Software Component Versions > HANA DP AGENT <version_number>
If you download it as a SAR file, you need to extract the SAR archive with SAPCAR, using the following command:
SAPCAR -xvf IMDB_DPAGENT200_03P_20-70002517.SAR
Note: DP Agent version must match the Hana version. Which version to use is best found out by looking at the Product Availability Matrix for Hana SDI.
You must use the Administrator user to install and configure DP Agent.
Find hdbsetup.exe and right click to run as administrator.
Choose install new SAP HANA Data Provisioning Agent and specify the installation path. I left installation with default setting. -> C:\usr\sap\dataprovagent
Configure DP agent
Configuring the Agent in Command-Line Interactive Mode
Open a terminal in windows.
The command-line agent configuration tool requires the DPA_INSTANCE environment variable to be set to the installation root location (<DPAgent_root>).
On windows, open a command prompt.
Set the DPA_INSTANCE
set DPA_INSTANCE=C:\usr\sap\dataprovagent
Navigate to <DPAgent_root>\bin
Start the configuration tool with the –configAgent parameter.
agentcli.bat --configAgent
Make sure the agent is started with option 1. If needed, start the agent with option 2.
Connect the DP agent to SAP HANA with option 6.
- Select option 3. Connect to SAP HANA via JDBC.
- Select True for the encrypted JDBC connection.
- Select True for the WebSocket connection
- Enter the Websocket as /service/<service instance ID>. You can find your <service instance ID> on the SAP HANA service dashboard.
- Enter the Websocket host found on the SAP HANA service dashboard, without the port.
- Enter the Websocket port.
- You will need an Agent Admin HANA User used for communication between DP agent and dpserver. The Agent Admin HANA User must have the System privileges : AGENT ADMIN and ADAPTER ADMIN
- You will also need a HANA User for Agent Messaging with the same roles when doing a JDBC connection. In this case, my HANA user for Agent Messaging is called JDBCUSR and I created it beforehand within the HANA cockpit.
Come back to the main menu, then register the agent to dpserver active in your tenant of SAP HANA, by using option 7. You must provide a name for your DP Agent and the IP address of your Windows host.
Go back to the main menu, then register the adapter that you will use with SAP HANA by using option 8. You can display all available adapters and register the one you want to use. Just input its name and it’s done!
The ABAPAdapter gets registered in dpserver.
Create a remote source
The next step is to create a remote source, connecting our HANA database to the source ERP system.
For this task, I use the SAP Web IDE Full-Stack on SAP Cloud Platform.
Go back to your SAP Cloud Platform cockpit, and select the SAP Web IDE Full-Stack service.
First, configure your Web IDE to enable the Enterprise Information Management plug-in and the SAP HANA Database Explorer plugin. This will allow you to create the replication task later.
Then, you can switch to the database explorer, select your HANA Database and verify that your agent and adapter are correctly registered.
If no database shows up, check your Cloud Foundry settings in the Web IDE Workspace preferences.
Now, right-click on remote source and select “create”.
Look at SAP Help to find more information about the ABAP Adapter remote source parameters.
Make sure to enable streaming read to use RFC Streaming.
The following parameters must be set to have RFC streaming work: Gateway Server, Gateway Host, RFC Destination
Once your remote source is up and running, you can see ODP extractors and remote ABAP tables in the Database Explorer.
Create a replication task
Now that your SAP ERP is effectively connected to your SAP HANA database, you can access data through virtual tables, and you can replicate data to SAP HANA, through replication tasks and.
Here, we will create a replication task to replicate data in real time from our source.
Switch to the development perspective of the Web IDE.
Right-click on your Workspace folder, and select New > Project from Template.
Select SAP HANA database application as a template, and give your project a name. Choose your version of SAP HANA, and complete the wizard.
In my case, I created a role GEN_GRANTOR_ROLE through the SAP HANA cockpit which gives access to the remote source. Then I created a new user GRANTOR_USER, and granted it the role GEN_GRANTOR_ROLE.
Finally I created a user-provided service remote_system_grant_service in the SAP Cloud Platform Cockpit, which contains the user GRANTOR_USER and its password.
Since I call a user-provided service from my .hdbgrants file, I need to add it to the mta.yaml file.
Once you create the .hdbgrants file and edited your mta.yaml file, right-click your db module and Build it. This will create the HDI container and give it the permission to access your remote source.
In case you did not understand how to use the user-provided service and hdbgrants, have a look at this helpful video.
Right-click on the src folder and select New > Replication Task.
When creating the replication task, you first need to select which remote source you are replicating.
Select the remote source you created earlier.
Click on the + on the right side of the screen to select the objects you want to replicate.
Here I replicate the ODP extractor ZSDITEST004. You can choose the replication behavior, and the name of the Target table for the replication.
Behavior | Description |
Initial load only | Performs a one-time data load without any real-time replication. Always available. |
Initial + Realtime | Performs the initial data load and enables real-time replication. Available when CDC is supported, for tables and virtual tables. |
Realtime | Enables real-time replication without performing an initial data load. Available when CDC is supported, for tables and virtual tables. |
No data transfer | Replicates only the object structure without transferring any data. Always available. |
Initial + realtime with structure | Performs the initial data load, enables real-time replication, and tracks object-level changes. Available when CDC is supported and for tables. |
Realtime only with structure | Enables real-time replication and tracks object-level changes without performing an initial data load. Available when CDC is supported and for tables. |
This replication task will create 2 tables on SAP HANA: a virtual table for the remote object and a physical target table. Set the replication behavior to Initial + real time if you want to replicate data in near-real time from your ERP system.
Before running the task, you need to set-up some parameters. You can also add one or more replication objects by selecting the objects and making changes at the bottom of the screen.
You can partition, create filters, define target options such as truncating or dropping the target table or changing the load behavior. Partitioning data can be helpful when you are initially loading a large data set, because it can improve performance and assist in managing memory usage.
If you choose to create an Initial + realtime task, two separate replication tasks will take place.
The initial load will happen first, then the ABAP adapter uses a periodic pull operation to retrieve changed data from the source. You can retrieve changes either by using a remote subscription or by creating a SELECT statement.
When using a remote subscription, in order to correctly initialize the delta extraction process, you need to set the extraction name parameter to the remote subscription value of the subscription, which can be found in the M_REMOTE_SUBSCRIPTIONS view. You can modify the time interval between pulls using the extraction period parameter.
When using a SELECT statement to implement change data capture, you need to include the extraction name and extraction mode parameters.
In the projection area, you can add, edit or remove columns.
Use the Expression Editor to create an expression to enhance or filter the data during replication. Select the columns that you want to use in your expression. You can drag and drop the column names from the list and place it in the filter expression box. Select any operators to complete the expression.
Finally you can choose whether you drop/truncate the table at the beginning of the execution of the replication task and the load behavior.
Save the replication task, and build the db module again.
This will generate the following objects in your HDI container :
- Virtual table(s): Generated in the specified virtual table schema. You can display the contents of the virtual table in SAP HANA studio.
- Remote subscription(s): Generated in the schema selected for the virtual table. This is generated when options including a real time replication are selected.
- Task(s): Generated in the same schema as the target table.
- Target table(s): Populated with the content after execution.
- Procedure: Generated in the schema of the target table, the procedure performs three functions.
Execute the replication task
Right-click on your .reptask file and select Run > Execute Reptask.
This executes the procedure of the replication task, performs the initial data load and then starts the remote subscription to replicate data in real time.
Check the results
Switch to the Database explorer, and click the + to add a new container.
Select the container you just created, and choose a name to show in Display.
I called this one “replication”.
You can see the tables and virtual tables created. Click open data to verify that your data is correctly being replicated.
This is the task which starts the remote subscription.
Finally, by opening the remote subscription, you can check the replicated data count and the time since the last message arrived.
By right clicking remote subscriptions, you can select “Show Remote subscriptions”.
This gives you more detail about the current state of the subscription.
Learn more about monitoring data provisioning with SAP Web IDE.
You can measure trends by issuing the following SQL statements.
ALTER REMOTE SOURCE <remote_source_name> START LATENCY MONITORING <latency_ticket_name> [INTERVAL <interval_in_seconds>]
It collects latency statistics one time or at regular intervals. You can specify a target latency ticket in the monitoring view. You can see the result with the following statement :
SELECT * From "SYS"."M_REMOTE_SOURCE_LATENCY_HISTORY"
And now that your data is replicated in real-time, you can use it within SAP HANA for reporting or analytics. For us, the next step was to create calculation views, a connection to SAP Analytics Cloud, and dashboards in SAC.
Here is a video of a flowgraph replicating data from S/4HANA ACDOCA to HANA Cloud, using the ABAP Adapter.
You created a replication task and it didn’t work as expected !? Start searching for a solution here :
2781923 – How to use ABAPAdapter and ODP Extractors in SDI realtime subscriptions
BW Extractors, CDS Views Extraction into Native HANA via SDI – Part I
Special thanks to Michio Tateishi and Keerthi Arekapudi for their precious help.
Maxime Simon
Hi Maxime
Very informative blog.
I am working on SDI where I’m trying to connect the ECC system using ASE Adapter and found that realtime with structure changes are not supported, thus ABAP adapter support this feature?
Regards
Ajay
Real time with structure change is not supported with the ABAP adapter.
Find here the list of adapters which support schema structure change replication :
https://help.sap.com/viewer/71c4a6e6b4dc4a5ab3e17bb1d7e98104/2.0_SPS04/en-US/e9d2bb9dd8ab4c0180e69b8a7e1a1e93.html
Hi Maxime
In this blog you didn't mention. where is your SAP ERP system? is on premise or its in cloud? how could you connect from the HCP Database explorer to an SAP ERP on premise (for example). I see it asks for parameters like application server, client, sysnumber etc. But it only will be possible to reach if you are in the On premise system network or if it was a public direction. Thats my question. How could you create the Remote Data Sources if you are on SCP and your remote/backend is an on-premise system.
Hello, for this blog I used 3 different systems
The ERP system communicates only with the SDI Data Provisioning Agent. The Data Provisioning Agent communicates with ERP, and via JDBC with SAP HANA.
As you said, it is only possible to reach the ERP system if the Data Provisioning Agent is installed on the same on-premise network.
Hi Maxime,
With the ABAPAdapter created, i don't see an option to input SAPRouterString in addition to Application Server.
Is this the expected behaviour and is by design.
Regards,
RL
Hello,
according to this help page, A route string describes a connection required between two hosts using one or more SAProuters.
When extracting data from an SAP ERP through the SDI ABAP Adapter, HANA does not use an SAP router.
If you check the list of parameters available in the ABAP Adapter, there is no mention of SAPRouterString. It is the expected behavior.
Valuable information provide, thanks for your great help.
Hi Maxime, great blog! I am missing something. So far I have the exact same setup. Connections are working. Replication task created and when executed it also fetches data. Now if I change sth im ECC, I do not get any changes. besides that the ODQMON gets a growing number of subscriptions on my data source. Do you have any hints?
Best Regards, Florian
Thanks Maxime, I understand that using ABAP adapter, I can pull data either from Business content Extractors or direct from ABAP tables. In case of extractor, it comes up with predefined logic which can help to reduce the processing work in HANA, In other case of ABAP tables, will be doing all joins and etc. in HANA.
If my reporting requirement is more standard and it is fulfilled by Extractor logic, then ODP-extractor option is more feasible one than other? or considering the future direction for extractors, is it more safe and flexibility to use ABAP table extraction?
Thanks
Sreekanth
Hi Maxime,
great guide and great tool this ABAP Adapter. We are using it intensively and it's a brilliant peace of software.
But would you be able to tell if there is a similar Adapter to connect to the DB behind the S4 HANA Cloud?
Thanks,
Julian
Hello,
a quick google search showed you already asked the question here, and the answers provided are correct : the underlying HANA database of S/4HANA Cloud is not exposed.
With HANA Smart Data Integration, we recommend using the Odata adapter or the Cloud Data Integration adapter to access OData services on S/4HANA Cloud.
Hi Maxime,
correct. I asked a similar question before.
But you answer is different and much better: The DB is not accessible (fair!) but the OData adapter does the trick. I have some concerns about performance, but we're going to check this out.
Thank you!
Hi Maxime,
We are following your blog to have the realtime replication (delta changes) in HANA cloud from ABAP backend system.
We found that there is entry being created for the delta records in remote subscription. But when we are executing the replication task it only executes the full load procedure function (<reptask>.START_REPLICATION). That means only the full load task is being executed.
So, I’m trying to execute the other procedure (<reptask>.RS_SP) manually in SQL console, which I believe responsible for delta (real time) changes.
There I need some input, what I can use as ACTION parameter value '???'
CALL "<container_name>"."<namespace>.<folder>::<reptask>.RS_SP"(SUBSCRIPTIONNAMES => array(‘REMOTE_SUBSCRIPTION_NAME'),ACTION => '???')
FYI.. when executing reptask from BAS, the realtime (delta) task is not being created automatically, that’s why I’m trying to execute it manually as above.
Your inputs would be much appreciated, thanks!
Hello,
I do not have experience with executing both procedures manually.
If replication tasks do not get created/executed properly from Business Application Studio, I recommend you create an incident with SAP Support explaining the situation. Support will provide you a solution.