{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","img","partial","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"},"seo":{"title":"Integrate SAP HANA with Databox","description":"Connect SAP HANA or SAP HANA Cloud to Databox and build custom SQL datasets for reporting and visualization.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-sap-hana-with-databox","__idx":0},"children":["Integrate SAP HANA with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"exclusive"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SAP HANA is an in-memory, column-oriented relational database management system designed for high-performance analytics and transaction processing. It serves as the data foundation for many SAP applications, including SAP S/4HANA, and is available both as a managed cloud service (SAP HANA Cloud) and as an on-premises deployment. Connecting SAP HANA to Databox lets you pull data directly from your database, build datasets using SQL queries, and visualize your business metrics alongside data from your other connected tools."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've already established a connection, you can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["reuse"]}," it to add new data sources to your Databox account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The setup steps differ depending on whether you're using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Cloud"]}," (managed, hosted by SAP) or a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["self-managed SAP HANA"]}," instance (on-premises or self-hosted in the cloud)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-1-sap-hana-cloud","__idx":2},"children":["Path 1: SAP HANA Cloud"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-create-a-read-only-database-user","__idx":3},"children":["Step 1: Create a read-only database user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox only reads data from your database — it never writes to it. Create a dedicated user with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]},"-only privileges. Connect to your SAP HANA Cloud instance using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Database Explorer"]}," or any compatible SQL client, then run:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"CREATE USER DATABOX_USER PASSWORD \"YourSecurePassword1\";\nGRANT SELECT ON SCHEMA \"YOUR_SCHEMA\" TO DATABOX_USER;\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_SCHEMA"]}," with the schema you want to connect. To grant access to multiple schemas, repeat the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GRANT"]}," statement for each one."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["SAP HANA requires passwords to contain at least one uppercase letter, one lowercase letter, and one digit. To prevent a forced password change on first login, append ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO FORCE_FIRST_PASSWORD_CHANGE"]}," to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE USER"]}," statement."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-add-the-databox-ip-to-your-sap-hana-cloud-allowlist","__idx":4},"children":["Step 2: Add the Databox IP to your SAP HANA Cloud allowlist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SAP HANA Cloud restricts inbound connections by IP address. Add the Databox IP to your instance's allowlist:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://hana.ondemand.com/console"},"children":["SAP HANA Cloud Central"]}," and select your SAP HANA Cloud instance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["..."]}," (Actions) > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connections"]}," step."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allowed connections"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow specific IP addresses"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["52.4.198.118"]}," to the list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," and wait for the instance to finish updating."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-enter-your-sap-hana-cloud-connection-details-in-databox","__idx":5},"children":["Step 3: Enter your SAP HANA Cloud connection details in Databox"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Databox, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Sources > + New connection"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fill in the connection form:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source name"]}," — a label for this connection in Databox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host"]}," — your SAP HANA Cloud instance endpoint (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["abc123.hanacloud.ondemand.com"]},"). Find this in SAP HANA Cloud Central under your instance details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["443"]}," (SAP HANA Cloud uses HTTPS/TLS on port 443 by default)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User"]}," — the username created in Step 1 (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DATABOX_USER"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," — the password for that user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database name"]}," — the name of your tenant database."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your instance uses custom TLS certificates, check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use SSL/TLS with custom certificates"]}," and paste in the required certificate content (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ssltls"},"children":["SSL/TLS"]}," below)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-sap-hana-with-databox_1.ba15de3b817b07e8b8384c84c29d44aa41b5cd04e3e1242304d40db4315fa8a6.4783b0ec.png","alt":"connect","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-2-self-managed-sap-hana-on-premises-or-self-hosted","__idx":6},"children":["Path 2: Self-managed SAP HANA (on-premises or self-hosted)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-create-a-read-only-database-user-1","__idx":7},"children":["Step 1: Create a read-only database user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect to your SAP HANA instance using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Database Explorer"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Studio"]},", or any compatible SQL client, then run:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"CREATE USER DATABOX_USER PASSWORD \"YourSecurePassword1\" NO FORCE_FIRST_PASSWORD_CHANGE;\nGRANT SELECT ON SCHEMA \"YOUR_SCHEMA\" TO DATABOX_USER;\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_SCHEMA"]}," with the schema you want to connect. Repeat the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GRANT"]}," statement for each additional schema."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-open-firewall-access-for-the-databox-ip","__idx":8},"children":["Step 2: Open firewall access for the Databox IP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your SAP HANA instance must accept inbound connections from the internet on its SQL port. The SQL port is derived from the instance number: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3[XX]15"]},", where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XX"]}," is the two-digit instance number (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30015"]}," for instance ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["00"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["31515"]}," for instance ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["15"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure your firewall or network security rules to allow inbound TCP traffic on that port from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]}," (the Databox IP)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-enter-your-sap-hana-connection-details-in-databox","__idx":9},"children":["Step 3: Enter your SAP HANA connection details in Databox"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Databox, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Sources > + New connection"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fill in the connection form:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source name"]}," — a label for this connection in Databox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host"]}," — the hostname or IP address of your SAP HANA server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port"]}," — the SQL port for your instance (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30015"]}," for instance number ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["00"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User"]}," — the username created in Step 1."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," — the password for that user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database name"]}," — the tenant database name for MDC systems, or the system SID for single-container systems."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If TLS is enabled on your instance, check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use SSL/TLS with custom certificates"]}," and paste in the required certificate content (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ssltls"},"children":["SSL/TLS"]}," below)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ssltls","__idx":10},"children":["SSL/TLS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use SSL/TLS with custom certificates"]}," checkbox encrypts the connection between Databox and your SAP HANA instance using your own certificate material."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When to use it:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Cloud"]},": TLS is always required. Check this option if your instance is configured with a custom or private CA certificate rather than the standard SAP-issued certificate. If you're using the default SAP HANA Cloud certificate, the connection may succeed without this checkbox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Self-managed SAP HANA"]},": Check this option if your instance has TLS enabled and you want Databox to verify the server certificate or authenticate with a client certificate."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the checkbox is selected, paste the contents of your certificate files into the corresponding fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CA certificate"]}," — the root or intermediate CA certificate used to verify the server's identity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client certificate"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client key"]}," — required only if your SAP HANA instance enforces mutual TLS (mTLS)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For SAP HANA Cloud, the root CA certificate bundle can be downloaded from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/hana-cloud/sap-hana-cloud-getting-started-guide/connect-to-sap-hana-databases-in-sap-hana-cloud"},"children":["SAP Trust Center"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"datasets","__idx":11},"children":["Datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SAP HANA integration supports the creation of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["datasets"]},", which allow you to define and shape the specific data you want to use for reporting in Databox. Datasets make it easier to focus on the most relevant information, enabling you to filter, visualize, and analyze metrics across projects, teams, and clients without writing complex queries each time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps-to-create-a-dataset","__idx":12},"children":["Steps to create a dataset"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select a table"]},": Pick the appropriate schema within that database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select columns"]},": Browse and select the specific columns (fields) from your tables or views to include in your dataset. These columns define the structure and content of your dataset."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-write-sql","__idx":13},"children":["Optional: Write SQL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more advanced use cases, you can write a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom SQL query"]}," instead of selecting columns manually. This allows you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Join multiple tables"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply filters and aggregations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Format or transform data before importing it into Databox"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your query must return a valid tabular result to be used as a dataset."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":14},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/hana-cloud"},"children":["SAP HANA Cloud documentation"]}," — Official SAP docs for SAP HANA Cloud, covering provisioning, connectivity, security, and administration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_HANA_PLATFORM"},"children":["SAP HANA Platform documentation"]}," — Documentation for on-premises SAP HANA, including installation, administration, SQL reference, and security."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":15},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"sap-hana","hideMetrics":true},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"How do I find the SQL port for my SAP HANA instance?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SQL port is derived from the instance number: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3[XX]15"]},", where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XX"]}," is the two-digit instance number. For instance ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["00"]},", the port is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30015"]},". For instance ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]},", it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30115"]},". You can confirm the port by checking the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["nameserver.ini"]}," configuration file or by consulting your SAP HANA administrator. For SAP HANA Cloud, always use port ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["443"]},"."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Can I connect to a specific tenant database in a multi-tenant SAP HANA system?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. For SAP HANA Multi-Database Container (MDC) systems, enter the tenant database name in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database"]}," field when configuring the connection in Databox. If you leave this field blank, Databox will attempt to connect to the SYSTEMDB, which is not recommended for reporting workloads."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What should I do if Databox cannot connect to my SAP HANA instance?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the following in order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firewall or security rules"]},": Confirm that inbound TCP traffic on your SQL port is allowed from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP HANA Cloud allowlist"]},": If using SAP HANA Cloud, verify that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]}," is listed under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allowed connections"]}," in SAP HANA Cloud Central."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port"]},": Double-check that the port matches your instance number (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30015"]}," for instance ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["00"]},"), or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["443"]}," for SAP HANA Cloud."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User status"]},": Confirm the user is not locked and has the required ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]}," privilege. Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT USER_NAME, USER_STATUS FROM SYS.USERS WHERE USER_NAME = 'DATABOX_USER';"]}," to check."]}]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does Databox support connecting to the SAP HANA SYSTEMDB?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox can connect to the SYSTEMDB, but it is not recommended. The SYSTEMDB is used for administrative tasks and contains system-level data rather than business data. For reporting, connect to your tenant database instead."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate SAP HANA with Databox","id":"integrate-sap-hana-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Path 1: SAP HANA Cloud","id":"path-1-sap-hana-cloud","depth":3},{"value":"Step 1: Create a read-only database user","id":"step-1-create-a-read-only-database-user","depth":4},{"value":"Step 2: Add the Databox IP to your SAP HANA Cloud allowlist","id":"step-2-add-the-databox-ip-to-your-sap-hana-cloud-allowlist","depth":4},{"value":"Step 3: Enter your SAP HANA Cloud connection details in Databox","id":"step-3-enter-your-sap-hana-cloud-connection-details-in-databox","depth":4},{"value":"Path 2: Self-managed SAP HANA (on-premises or self-hosted)","id":"path-2-self-managed-sap-hana-on-premises-or-self-hosted","depth":3},{"value":"Step 1: Create a read-only database user","id":"step-1-create-a-read-only-database-user-1","depth":4},{"value":"Step 2: Open firewall access for the Databox IP","id":"step-2-open-firewall-access-for-the-databox-ip","depth":4},{"value":"Step 3: Enter your SAP HANA connection details in Databox","id":"step-3-enter-your-sap-hana-connection-details-in-databox","depth":4},{"value":"SSL/TLS","id":"ssltls","depth":2},{"value":"Datasets","id":"datasets","depth":2},{"value":"Steps to create a dataset","id":"steps-to-create-a-dataset","depth":3},{"value":"Optional: Write SQL","id":"optional-write-sql","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-sap-hana-with-databox","seo":{"title":"Integrate SAP HANA with Databox","description":"Connect SAP HANA or SAP HANA Cloud to Databox and build custom SQL datasets for reporting and visualization."},"keywords":{"includes":["SAP HANA integration","connect SAP HANA to Databox","SAP HANA Cloud Databox","SAP HANA dataset","SAP HANA custom SQL query","SAP HANA read-only user","whitelist Databox IP SAP HANA","SAP HANA port 30015","SAP HANA TLS connection","SAP HANA tenant database","SAP HANA Cloud IP allowlist","SAP HANA cannot connect"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"}},"lastModified":"2026-04-17T19:27:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-sap-hana-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}