Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
Showing results for 
Search instead for 
Did you mean: 


The SAP HANA Multitenant Database Containers (MDC) feature enables hosting multiple SAP HANA databases on a single SAP HANA system. All tenant databases in the same system share the same system resources (memory and CPU cores) but each tenant database is fully isolated with its own database users, catalog, repository, persistence (data files and log files) and services. And now you can use all this on a trial landscape.

Note: You can have only one tenant database per account.

Create a tenant database on trial landscape

To be able to access a trial landscape, you need to have a developer account first. If you still need to create a developer account, you can start from here: Signing Up for a Developer Account.

To create and configure a trial tenant database, follow these steps:

  1. Log on to the SAP HANA Cloud Platform cockpit and select an account.
  2. Choose Persistence and then Databases & Schemas from the menu on the left. Choose New.
  3. In the Database ID enter a unique ID that contains lower-case letters and numbers.
  4. In the Database System field select the HANA MDC (<trial>) option. Fill in the SYSTEM User Password field. Choose Save.
    The Events page is displayed. It shows the progress of the database creation.
  5. Wait until the tenant database is in state Started. It might take a while.

Note: If there are no free resources available you will not be able to create a tenant database. You should try again later.

Now you have your tenant database created and configured.

Web IDE scenario

In case you want to work with your tenant database from the Web IDE, you have to do an additional configuration after the tenant database is started:

  1. In the overview of the new tenant database, open the link SAP HANA Cockpit.
  2. Enter SYSTEM in the Username field and the password you have set in the Password field. When you choose Log On, an Information dialog appears. It says you are not authorized to open the SAP HANA Cockpit and you will be assigned the necessary role. Just choose OK and proceed. Another dialog appears. Choose Continue.
  3. The SAP HANA Cockpit opens for the new tenant database.
  4. Go back to the SAP HANA Cloud Platform cockpit and then go to the tenant database page in Databases & Schemas. Open the link SAP HANA Web-based Development Workbench.
  5. (Optional) Choose the Security option. Add all the roles described here: Roles Required for Web-based Tools. To assign the roles to the SYSTEM user, you have to:
      1. Go to Users and then SYSTEM.
      2. In the Granted Roles tab, choose Add.
      3. In the Search field enter the required roles and choose OK.
      4. Save the changes.
  6. To work with the Web IDE Editor, you need a database user first. Here you can find out how to create a database user with permissions for working with Web IDE: SAP HANA Cloud Platform

To open the Web IDE, you have to go to SAP HANA Web-based Development Workbench for this tenant database. Select the Editor option and now you have the Web IDE ready to work.

Eclipse IDE scenario

If you want to use Eclipse IDE to try out the tenant database on the trial landscape, you can use your own test application. This is what you have to do:

  1. Install the SAP HANA Tools in the Eclipse IDE. If you haven’t done this already, read this procedure: Installing SAP HANA Tools for Eclipse.
  2. If you want to import your test application delivery unit (DU), continue with the procedure.
  3. Go to Eclipse and open the SAP HANA Development perspective.
  4. In the System view, choose Add Cloud System.
  5. In the Account Information page, enter your developer account details. Choose Next.
  6. In the SAP HANA Schemas and Databases, enter the tenant database details you have set when you created it. Choose Finish.
  7. To import the DU, choose File and then Import.
  8. Expand SAP HANA Content and then choose Delivery Unit. Choose Next.
  9. The target system is your tenant database in the trial landscape. Choose Next.
  10. Browse to the YOUR_DU.tgz file you have downloaded in the File field and choose Finish.


When you create a tenant database, you can use it for 12 hours. After that it will be automatically shut down to free resources. You can start it again from the SAP HANA Cloud Platform Cockpit. Have in mind that if you don’t use this tenant database for 7 days it will be automatically deleted.

For more information, you can check out the Databases documentation and the Creating as SAP HANA Database from the Cockpit tutorial.