Skip to Content

Add Databases to the SAP HANA Database Explorer

0 %
Add Databases to the SAP HANA Database Explorer

Add Databases to the SAP HANA Database Explorer

October 4, 2021
Created by
October 20, 2020
This tutorial will explore different database connections types, such as SAP HANA Cockpit Database, SAP HANA, Data Lake IQ, and SAP HANA Deployment Infrastructure (HDI), along with the different operations that can be performed on them.

You will learn

  • How to add different database types in the SAP HANA database explorer
  • Additional operations that can be performed on a database
QR code


  • An SAP HANA database such as SAP HANA Cloud trial or the SAP HANA, express edition that includes the SAP HANA database explorer

Database connections in the database explorer represent SAP HANA or Data Lake IQ databases that you browse and interact with.

SAP HANA Connections

SQL consoles are associated with a database connection.

sql console connection
Step 1: Add an SAP HANA cockpit database connection

Databases defined in the SAP BTP cockpit or the SAP HANA cockpit can be opened in the SAP HANA database explorer.

  1. From SAP HANA Cloud Central, choose Open SAP HANA Database Explorer.Open in the database explorer

    You may be prompted to enter database login credentials at this point. Enter the DBADMIN or SYSTEM user credentials that were set during the SAP HANA Cloud trial or express edition setup process, or the credentials provided by your database administrator.

    Note that the credentials can be saved so they do not need to be re-entered if they are entered into the SAP HANA Cockpit.

    Notice that when the SAP HANA database explorer opens, the selected database is the one from the selected tile or administered database. Also note that the URL contains a ?databaseid=.

    If this URL is saved as a bookmark, each time the page is opened, the matching database will be selected.

    databaseid parameter

    Hover over the database to see a summary and note that the type is Cockpit Database.

Log on to answer question
Step 2: Add an SAP HANA database connection

Databases can also be added directly to the SAP HANA database explorer. To connect to an SAP HANA Cloud or on-premise database, the host, port, user name, and password must be provided.

  1. In the SAP HANA database explorer, press the + button to add a new database.

    Add a new database
  2. For database type, choose SAP HANA Database.

    Database types

    Note that an SAP HANA, express edition or on-premise database can have two types of databases; system and tenant. This is known as multitenant. System databases are used to manage one or more tenant databases and are only applicable to on-premise systems. For further details, see Server Architecture of Tenant Databases.

  3. Provide the host, port, user name, password, and name to show in display.

    encrypted connection

    Remember to remove the colon and port number from the host name and add the port to the port field.

    When connecting to an SAP HANA Cloud instance, the database connection must use TLS.

    connect using TLS

    The public root certificate of the certificate authority (CA) that signed the SAP HANA Cloud instance’s server certificate is required. This certificate is likely already available in the system certificate store on the operating system and accessible by the browser, but if not, it can be pasted into the UI. For more information see Secure Communication Between SAP HANA Cloud and JDBC/ODBC Clients.

    For a HANA Cloud database, the host and port values can be copied from SAP HANA Cloud Central.

    copy host and port

    If you are using an SAP HANA, express edition or on-premise database, the port numbers for a system or tenant database can be determined by running the following query against the System database.

    SQL port query
  4. After pressing OK, a new database will appear whose type is SAP HANA Database.

    new database

    Advanced options can be used to specify database properties.

    advanced options

    An example of what can be configured is shown below.


    These values can be seen by opening a SQL console and noticing the schema that the database is using or by executing the following queries.


    For additional details, see Add Instances to the SAP HANA Database Explorer.

Log on to answer question
Step 3: Add a Data Lake IQ database

A Data Lake IQ is a column oriented, disk based relational store that can be used to economically store data that is not updated frequently. Additional details can be found at What is SAP HANA Cloud, Data Lake.

  1. Add a Data Lake.

    add a data lake

    Ensure that the allowed connections list is set to Allow all IP addresses.

    allowed connections
  2. In the database explorer, choose to add a new connection of type Data Lake, IQ.

    add database

    The user name is HDLADMIN.

    Add Data Lake IQ

    The connection details can be copied from the instance tile.

    Copy SQL Endpoint
  3. The catalog browser can be used to view database objects and a SQL Console can be opened to query the database.

    A few queries
Log on to answer question
Step 4: Additional database connection features

Databases have additional actions that can be performed on them such as renaming, connecting as a different user, changing the connection of a SQL console, and viewing an overview of the connected database.

  1. To rename a connection, right-click a database and choose Properties.

    database properties

    You may wish to rename the default database display name. Press OK to save the changes and close the window.

    renaming a connection
  2. To connect to the same database but with different credentials, right-click a database and choose Add Database with Different User. This can be useful when you wish to connect to the same SAP HANA database but with a different set of credentials perhaps because you need elevated permissions.

    connecting as a different user
  3. When a SQL console opens, it connects to the currently selected database connection and displays the current schema and connection.

    SQL Console connections

    It is possible to connect, disconnect, or change the connection via the toolbar items highlighted above.

    Subsequent tutorials assume the connected user is DBADMIN or SYSTEM.

  4. To see information about a database, right-click a database and choose Show Overview. This provides a quick overview of the database that you are connected to.

    database overview
  5. Groups and filters can be used to organize and quickly find databases.

    Using groups
Log on to answer question
Step 5: Database usage

An SAP HANA database can be set to have a specified usage, such as development or production. The following SQL statements will display the current usage value and then change it to production.

ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'DATABASE') SET ('system_information', 'usage') = 'production' WITH RECONFIGURE;

After refreshing the page, there will be indicators that the database instance being worked with is a production database as shown below and care should be taken before executing operations that may affect performance or make unintentional changes to the database.

production label

For additional details on this parameter, see the system_information usage parameter in SAP HANA Configuration Parameter Reference.

Log on to answer question
Step 6: Database groups (Optional)

SAP HANA Cockpit databases can be grouped together. This enables SQL statements to be run against a group of databases.

run on multiple
  1. With SAP HANA Cloud, all databases created in a space are placed in a group. As seen below, the space name is dev.

    group by space

    SAP HANA Cloud Cockpit or SAP HANA Cloud Central contain in their URL, a parameter that indicates the unique name (GUID) for the space.


    The spaces that contain SAP HANA Cloud instances appear when running SQL against multiple databases. Executing commands in the SQL console will be covered in a subsequent tutorial.

    run on multiple

    The space dev is represented by its GUID in the selection dialog below.

    run on multiple databases in HXE
  2. With SAP HANA, express edition or an on-premise install, a tool called SAP HANA cockpit manager can be used to register databases and organize them into groups.

    registered resources

    Two user defined groups are shown below.


    These groups appear when running SQL against multiple databases. There are also three predefined groups named DEVELOPMENT, ALL, and PRODUCTION.

    run on multiple

    run on multiple databases in HXE

    Note that the ability to see groups in the SAP HANA database explorer that have been created using the SAP HANA cockpit manager requires the SAP HANA database explorer to be opened from the SAP HANA Cockpit.

Log on to answer question
Step 7: Native HANA development with HDI (Optional)

An SAP HANA Deployment Infrastructure (HDI) container can be created by using the SAP HANA Web IDE or Business Application Studio. An HDI container can contain database objects such as tables, views, functions, stored procedures, and calculation views. HDI containers support the use case where multiple versions of the same data model are deployed into the same database instance. This might be done by multiple developers working on a project. Objects within an HDI container all share the same schema and are accessed by a technical user.

The SAP Business Application Studio is the recommended tool for SAP HANA native application development with SAP HANA Cloud HANA databases while the SAP HANA Web IDE is the recommended tool for HANA 2.0 on-premise databases. For additional details see SAP Business Application Studio and SAP Web IDE Full-Stack.

The following steps demonstrate how to use the SAP Business Application Studio or the SAP HANA Web IDE to create and deploy an HDI container containing a table and then view container in the SAP HANA database explorer.

Log on to answer question
Step 8: Create and deploy an HDI container with the SAP Business Application Studio (Optional)
  1. Open the SAP BTP cockpit and from the Service Marketplace under the subaccount level (named trial in the screenshot below) find and open the SAP Business Application Studio.

    service marketplace
  2. Create a new SAP HANA Native Application dev space.

    create a dev space
  3. Once the dev space has been created, open it.

  4. Set the cloud foundry org and space by pressing F1 or Ctrl + Shift + P to open the command palette. Search for the command CF Set Org and Space.

    set CF org and space

    The endpoint value can be found in the SAP BPT Cockpit.

    api endpoint
  5. From the Welcome tab (can be opened from the command palette if it is not open), choose Start from template.

    start from template
  6. Select SAP HANA Database Project.

    SAP HANA Database Application
  7. Provide the following values and click Finish.

    Setting Value
    Project name: myHANAProj
    Module name: db
    Schema name: mySchema
    SAP HANA Database Version: HANA Cloud
  8. Once the project generation finishes, open the tool palette (F1) and choose SAP HANA: Create SAP HANA Database Artifact. Provide the following values and click Finish.

    Setting Value
    Path: /home/user/projects/myHANAProj/db/src
    Version: HANA Cloud
    Type: Table (hdbtable)
    Name: myTable
  9. Paste the below content into the file.

    COLUMN TABLE myTable
        "ID" INTEGER,
        "VALUE" VARCHAR(50)
  10. Use the SAP HANA Projects Explorer to deploy the table.

    deploy the table
  11. Open the database explorer to view the deployed HDI container and table.

    view the hdi container

    A new HDI container with the table is shown.

    hdi container and table
Log on to answer question
Step 9: Create and deploy an HDI container with the SAP HANA Web IDE (Optional)
  1. Open SAP HANA Web IDE for SAP HANA if using SAP HANA, express edition or an on-premise install.

    open web ide on-premise

    An alternative way to determine the URL for the SAP Web IDE for SAP HANA is to run the below command on the machine where SAP HANA on-premise is installed.

    xs apps
  2. Ensure that the SAP HANA extensions are enabled.

    SAP HANA plugins
  3. Open the development pane.

    Development pane
  4. Create a new HANA database project.

    Right-click Workspace and choose New | Project from Template.

    In the Search field, enter HANA.

    If you are using SAP HANA Cloud, in the Environment dropdown, select Cloud Foundry.

    Select the template SAP HANA Database Application.

    new HANA proj

    Fill in the following values and press Finish.

    Setting Value
    Project Name: myHANAProj
    Space: development
    SAP HANA Database Version: Choose the appropriate version such as HANA Cloud or 2.0 SPS 04
  5. After the wizard finishes, create a table by right-clicking on the src folder and choosing New | Database Artifact.

    Specify a file name of test and a file type of .hdbtable.

    Paste the below content into the file and choose File | Save.

        "ID" INTEGER,
        "VALUE" VARCHAR(50)
    test table
  6. Deploy the HDI container. Right-click the db folder and choose Build | Build.

    Build and deploy the HDI container

    The Console window will show the result of the build process.

  7. Once complete, the HDI container can be opened in the SAP HANA database explorer by right-clicking on the db folder and choosing Open HDI Container.

    Alternatively, it can be added via the Add Database dialog.

    Add HDI

    Notice, above, that a user name and password are not requested. The connection will use a technical user, which was generated when the HDI container was created.

    In the database browser and in the SQL console, notice that the schema name is not shown.

    test table

    It is also possible to connect to an HDI container as an admin, which enables the ability to grant additional permissions in the HDI container. For an example of where this might be used, see Grant a Support User Access to an SAP HDI Container. Note, never use the Admin connection to perform DDL (such as create, update, or delete) operations.

    connect as admin

For an example of creating a calculation view inside an HDI container, see the video titled Develop Apps at the end of the blog post Getting Started with SAP HANA Cloud II | Basics

The mission Get Started with XS Advanced Development provides further examples of using an HDI container.

In the next tutorial, additional tables, views, functions, and procedures that will be used in subsequent tutorials in this group will be created directly in the database rather than in an HDI container.

Congratulations! You have added different databases to the SAP HANA database explorer.

Which of the following are operations that can be performed on an SAP HANA database explorer connection?

Next Steps

Back to top