> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP HANA Connector

## Intro

SAP HANA is an in-memory, column-oriented, relational database management system developed and marketed by SAP SE. Use Domo's SAP HANA connector to retrieve data from an SAP HANA database using a SQL query. To learn more about SAP HANA, visit their web page ([https://www.sap.com/products/hana.html](https://www.sap.com/products/hana.html "https://www.sap.com/products/hana.html") ).

You connect to your SAP HANA account in the Data Center. This topic discusses the fields and menus that are specific to the SAP HANA connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Prerequisites

To connect to your SAP HANA account and create a DataSet, you must have the following:

* The username and password you use to log into your SAP HANA account
* The database name
* The host name for the database
* The port number for the database

CA certificate text or URL path is required **only** if you select ****Certificate text**** or ****URL path****, respectively, in the ****Certificate type**** menu.

Before you can connect to an SAP database, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see [Whitelisting IP Addresses for Connectors](/s/article/360043630093 "Whitelisting IP Addresses for Connectors").

## Connecting to Your SAP HANA Account

This section enumerates the options in the **Credentials** and **Details** panes in the SAP HANA Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your SAP HANA account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Host </p></td><td colspan="1" rowspan="1"><p> Enter the host name for the SAP database. </p><p> Example: <span class="mt-font-courier-new"><a href="http://db.company.com" rel="noopener" target="_blank"> db.company.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Port </p></td><td colspan="1" rowspan="1"><p> Enter the port number for the database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database </p></td><td colspan="1" rowspan="1"><p> Enter the name of the database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter your SAP HANA account username. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter your SAP HANA account password. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate </p></td><td colspan="1" rowspan="1"><p> Paste the text for your CA certificate or enter the URL where your certificate is located. This is optional. If you do not want to include a certificate, select <b><b> No certificate </b></b> in the <b><b> Certificate Type </b></b> menu. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate Type </p></td><td colspan="1" rowspan="1"><p> Select a certificate type. If you do not want to include a certificate, select <b><b> No certificate </b></b>. If you select Certificate text, you must paste the text for your certificate in the <b><b> Certificate </b></b> field. If you select <b><b> URL path </b></b>, you must enter the URL where your certificate is located in the <b><b> Certificate </b></b> field. </p></td></tr></tbody></table>

Once you have entered valid SAP HANA credentials, you can use the same account any time you go to create a new SAP HANA DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

In this pane you create an SQL query to pull data from your database. The **Query** parameter is required. The other three parameters are here to help you construct this query if you choose.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><table border="1"><thead><tr><td colspan="1" rowspan="1"> Query Type </td><td colspan="1" rowspan="1"> Description </td></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"><span> Enter the query to execute. </span></td></tr><tr><td colspan="1" rowspan="1"> Query Builder </td><td colspan="1" rowspan="1"><span> Select the table and fields to auto-generate your query. </span></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><span> Query </span></td><td colspan="1" rowspan="1"> Enter an SQL query for selecting the data you want to pull into Domo. <p> Example: <span class="mt-font-courier-new"> select \* from Employee </span></p></td></tr><tr><td colspan="1" rowspan="1"><span> Schema Names </span></td><td colspan="1" rowspan="1"> Select a schema. </td></tr><tr><td colspan="1" rowspan="1"><span> Database Object </span></td><td colspan="1" rowspan="1"> Select a database object. </td></tr><tr><td colspan="1" rowspan="1"><span> Database Table </span></td><td colspan="1" rowspan="1"> Select the table containing the data you want to pull into Domo. </td></tr><tr><td colspan="1" rowspan="1"><span> Table Columns </span></td><td colspan="1" rowspan="1"> Select the table columns with data you want to pull into Domo. </td></tr><tr><td colspan="1" rowspan="1"><span> Query Helper </span></td><td colspan="1" rowspan="1"> Copy and paste this query into the <b> Query </b> field if you need help building a query. <span> This query is generated based on the selected <b> Database Columns </b> and <b> Table Columns </b>. </span></td></tr><tr><td colspan="1" rowspan="1"><span> View </span></td><td colspan="1" rowspan="1"> Select a view. </td></tr><tr><td colspan="1" rowspan="1"> View Columns </td><td colspan="1" rowspan="1"><span> Select the view columns that you would like to include in your report. </span></td></tr><tr><td colspan="1" rowspan="1"><span> View Query Helper </span></td><td colspan="1" rowspan="1"> Copy and paste this query into the <b> Query </b> field if you need help building a query. <span> This query is generated based on the selected <b> View </b> and <b> View Columns </b>. You need to provide the actual user values in the <b> '\<to be filled>' </b> fields for the placeholders and variables. </span><p><span> Example: </span></p><ul><li><span> PLACEHOLDER = ('$IP_Product_Category$', '\<to be filled>') </span></li><li><span> PLACEHOLDER = ('$IP_Product_Category$', 'Keyboards') </span></li></ul> <Note><div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><b> Note </b>: The placeholders and variables will only populate for the views that have the input parameters and variables configured already. </div></div></div> </Note></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).
