Skip to Content

In this blog, I will be providing an overview of the Python Client API for machine learning which was recently released in SAP HANA 2.0, Express Edition Support Package 03, Revision 033

What’s New for Machine Learning in SAP HANA, express edition

SAP HANA, express edition now supports a set of client-side Python functions which can be used for developing machine learning models, thereby making it easy for Python users to use SAP HANA, express edition for machine learning purposes.

It consists of ML API, which are a set of machine learning APIs for different algorithms and the SAP HANA dataframe which consists of a set of functions for accessing and manipulating SAP HANA data. I will provide an overview of the key capabilities and a sample application along with pointers how you can get started.

This capability is complementary to the Predictive Analysis Library (PAL) in SAP HANA, express edition which enables users to build machine learning models using a SQL interface.


The Python Client API for ML makes use of the HANA Python driver, as shown below in the diagram. Users first need to install the Python driver (hdbcli) and then the Python Client API for machine learning algorithms. Instructions are available in “How to Get Started” section below.



SAP HANA Dataframe

The SAP HANA dataframe provides a way to view and manipulate the data stored in SAP HANA without physically moving any data between HANA and the Python client application. SAP HANA dataframe hides the underlying SQL statement, providing users with a Python interface to SAP HANA data. Once the HANA dataframe is created, it can be used in the Python Client ML APIs (which contain various machine learning algorithms) as input for training and scoring purposes.

The SAP HANA dataframe functions provide capabilities for a variety of different operations for creating and manipulating dataframes. Some sample functions include: adding an ID column, casting columns into new type, dropping columns, filling null values, joining dataframes, sorting dataframes, renaming columns, statistics relating to the data, showing distinct values, creating dataframes with top n values, copying the HANA dataframe to a Pandas data frame, creating a table from a HANA dataframe, etc. For details refer to the documentation

To create a SAP HANA dataframe, first create the “ConnectionContext” object and then use the methods provided in the library for creating a SAP HANA dataframe.


The ML API are a set of APIs to the SAP HANA Machine Learning algorithms.

These algorithms cover classification, clustering, decomposition, metric functions, neural network, pre-processing, regression, statistics functions, neighborhood-based algorithms, decision trees and support vector machines. For details on which specific algorithms are available in this release, please refer to the documentation

These client-side Python functions require a HANA dataframe and parameters as inputs in order to train the model. The model training executes in HANA, and no data is brought back to the client side for training the model. The Python machine learning APIs invoke SQL functions within SAP HANA for performing the training and scoring, using data within HANA. Hence, data movement from the server to the client, or vice-versa is avoided, resulting in high performance.

This approach is open, allowing users to not only use the ML API functions provided, but also use Python libraries of their choice, in conjunction with what is available in SAP HANA, express edition. Users can convert a HANA dataframe to a Pandas dataframe, and after that use their Python library of choice for their applications.

An end-to-end example using the HANA dataframe and ML API is provided in the section “End to End Example: Using The Python Client API for ML”.

How to Get Started

  • The first step is to install the SAP HANA Python Client API for Machine Learning Algorithms. This API requires the SAP HANA Python driver as pre-requisite. For detailed steps on how to install the Python Client API for ML (and the Python driver) refer to the tutorial.
  • If you would like to do your development in a Jupyter notebook (or JupyterLab), and use the ML API in the notebook environment, you can do so. Instructions on how to use JupyterLab with SAP HANA can be found here.
  • Now, you are ready to start using the SAP HANA Python Client API for Machine Learning Algorithms. The example below shows a sample end-to-end scenario.

Note: in case you need to install SAP HANA,  express edition (or need to update your existing installation) please follow the steps below:

End to End Example: Using The Python Client API for ML

Shown below is an example where the RandomForestClassifier model is being trained, using data in a HANA table.

In the use case below, the user wants to predict if a game will be played or not on a given day, using the weather conditions for that day. For training purposes, the user has access to historical data where the weather conditions and outcome is known. The historical information contains information on outlook (sunny, overcast, rain), temperature, humidity, windy(yes, no) and the actual historical outcome that took place on  that day, namely, whether the game was played or not. The historical outcome is captured in the column named Label(PLAY, DO NOT PLAY).

Using the features such as outlook, temperature, humidity, windy, and label (as outcome), the user will train a randomforestclassifier model. Once trained, this model will be used for predicting if a game will be played or not on a given day, based on knowing the outlook, temperature, humidity and wind conditions for that specific day.

Note: In the example below, the user is connecting to a HANA database, and using a table named DATA_TBL_RFT (for training), and DATA_TBL_RFTPredict (for prediction).


Step 1: Import the Python Client API Library and Dataframe Library (dataframe, trees)
from hana_ml import dataframe
from hana_ml.algorithms import trees

Step 2: Instantiate the Connection Object (conn)
conn = dataframe.ConnectionContext('<address>', <port>, '<user>',  '<password>')

Step 3: Create the HANA Dataframe (df1) which references the "DATA_TBL_RFT" Table.
df1 = conn.table("DATA_TBL_RFT")

Step 4: Inspect the Data

Sunny    75.0    70.0       Yes    Play
Sunny    60.0    90.0       Yes    Do not Play
Sunny    85.0    75.0       No     Do not Play
Sunny    72.0    95.0       No     Do not Play

Step 5: Create the RandomForestClassifier instance and specify the parameters
rfc = RandomForestClassifier(conn_context=conn, n_estimators=3,
                             max_features=3, random_state=2,
                             split_threshold=0.00001, calculate_oob=True,
                             min_samples_leaf=1, thread_ratio=1.0)

Step 6: Store the necessary features in a List and Invoke the fit method, features=['OUTLOOK', 'TEMP', 'HUMIDITY', 'WINDY'], label='LABEL',)

Step 7: Create the HANA dataframe (df2) which references the "DATA_TBL_RFTPredict" Table.
df2 = conn.table("DATA_TBL_RFTPredict")

Step 8: Preview the dataframe before predicting

0   Overcast  75.0   100.0     Yes
1   Rain      78.0   70.0      Yes

Step 9: Invoke the Prediction Method ("predict()") and inspect the result
result = rfc.predict(df2, key='ID', verbose=False)


0   Play   0.666667
1   Play   0.666667


Summary and Next Steps

SAP HANA Python Client API For Machine Learning Algorithms provides a set of Python APIs for creating and manipulating HANA dataframes and training and scoring machine learning models.

While ensuring there is no data transfer between the client and server, these functions enable the  model training/prediction to occur in SAP HANA, thereby providing high performance as execution occurs close to the data.  The HANA dataframe allows conversion to a Pandas dataframe in situations where users may want to download the data (or subset of it), and use it with other Python libraries, along with what’s provided in SAP HANA, express edition for machine learning.

So, give this new capability a try by downloading SAP HANA, express edition and getting started !

Links to references

  1. SAP HANA, express edition documentation:,_EXPRESS_EDITION/2.0.03/en-US
  2. SAP HANA, express edition Python Client API for machine learning algorithms documentation:
  3. Tutorial on using JupyterLab with HANA:
  4. Tutorial on installing the Python Client API for machine learning algorithms:
To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

Leave a Reply