How to use SAP HANA database on SAP Business Technology Platform

Official Content

A way to build applications that use SAP HANA database is through the Cloud platform available from SAP, called SAP Business Technology Platform (from now on called SAP BTP).

For trial purposes, a free account may be created at From there, it is possible to work within SAP HANA cloud and create a SAP Hana database.

1. Go to SAP BTP Cockpit and log in with your user credentials.

2. Once logged into the page, select Enter Your Trial Account.


3. Enter the trial Subaccount (if you don't have one, create a New Subaccount).


4. Once in the Subaccount, go to the Cloud Foundry Environment and select your Space ("dev", if you don't have one, enable/create it).


5. Inside the CF space, go to SAP Hana Cloud option.


6. Select Manage SAP HANA Cloud.


7. At this point, you can create a Database Instance.


8. Follow the steps shown in the popup window to configure the Database Instance.

   a. Step 1 is to configure the main information of the Database Instance:


Here, you set up the Organization and the Space associated with the database, the database name (Instance Name), and the administrator user password.

   b. Step 2 is to configure the Instance Space, and it is not allowed in a Free Trial Plan.


   c. Step 3 is to set up from where you can access the Database Instance. You can choose anything you want, but to avoid any problems, for this test situation we recommend selecting Allow all IP addresses.


   d. You don't need to go to Step 4 for extra settings referred to the Data Lake. Then, go directly to the Create Instance button.


9. Once the Instance has been created, go back to the Compact Framework and go to Services > Instances.


10. In the Database Instance created, select the 3 dots and Create Service Key.


11. A popup window will be opened to set up the Service Key; you only have to select a name and click on Create.


12. Once the Service Key has been created, open it or download it to obtain the JSON containing the information needed for the connection from GeneXus. From the JSON, you will need the field Host and URL.


13. After setting up everything with the necessary data, from GeneXus, in the Data Store properties corresponding to Hana DBMS, configure the following:

JDBC driver = Custom Driver
Custom JDBC Driver = (Json driver field of the Service Key)
Custom JDBC URL = (Json url field of the Service Key)
Server Name = (Host field from the Json of the Service Key)
User password = (Password associated with the DBADMIN user, Step 1 of database configuration)
Schema = (It can be any name; GeneXus creates the schema in the database)

14. Once this is configured, GeneXus can use the database created in SAP BTP.