Choose an SAP HANA Database

1. Follow the instructions at Create an SAP HANA Cloud Instance Using the Cloud Cockpit or SAP HANA Cloud Trial.

   You should now have a new SAP HANA Cloud instance created in the SAP Cloud Platform.

   For more information on the SAP Cloud Platform see the following:

   • https://cloudplatform.sap.com/index.html

   • https://developers.sap.com/topics/cloud-platform.html

   • https://help.sap.com/viewer/product/CP/Cloud/en-US

   Once the SAP HANA Cloud instance is created, take note of the admin user as well as the endpoint (host:port) needed to connect to the database. This will be needed in subsequent tutorials in this mission.

2. Open the Database Explorer by choosing Open In, Database Explorer.

   

   You will be asked to enter the credentials for the database. Enter DBADMIN and the password that was specified when the instance was created.

   

   The Database Explorer provides the ability to browse catalog objects and execute SQL statements from the SQL console. For more information, see Getting Started With the SAP HANA Database Explorer.

3. Open a SQL console by clicking the Open SQL Console toolbar item in the top-left of the screen.

   

4. Run the following query to see the name of the database you are currently connected to. Notice it is H00.

   SELECT * FROM M_DATABASE;
   

   

5. In the Database Explorer, the current schema shows DBADMIN. A schema is a container for other database objects such as tables and views.

   

   Another way to see the current schema and the connected user is via SQL as shown below. The DUMMY table is available in every HANA database that has one column and one row. It provides a convenient way to call a function or perform a simple test.

   SELECT CURRENT_USER, CURRENT_SCHEMA FROM DUMMY;
   

6. To see the list of services, enter the following SQL statement:

   SELECT * FROM M_SERVICES;
   

7. To see information about the database server, enter the following SQL statement:

   SELECT * FROM M_HOST_INFORMATION;
   

Congratulations! You have connected to SAP HANA Cloud and performed a few queries.

A default installation will contain one system database named SYSTEMDB and one tenant database named HXE.

The system database contains information about the tenant database(s) and is used for overall administration. The default port for the system database is 39013. Later in this tutorial mission, a connection to the tenant database will be made and tables will be created and populated with data. For more information, see SAP HANA Tenant Databases Operations Guide.

The SAP HANA, express edition VM install includes a command line tool (part of the SAP HANA client install) called HDBSQL that can be used to query the database.

The following steps will demonstrate connecting to and examining a SAP HANA, express edition database.

1. Determine the IP address of the machine that is running SAP HANA, express edition. Record the value as it will be needed in later tutorials in this mission.

   ip addr
   

2. Enter the following to connect to the system database:

   hdbsql -n localhost:39013 -u SYSTEM -p Your_Password
   

   

   Notice that the database being connected to is SYSTEMDB.

   The example above uses localhost since hdbsql is running on the same machine that the database is trying to connect to. It is important to note the IP address or host name of the machine, as this will be needed in later tutorials. The host name hxehost, is seen in the terminal above.

   If hdbsql is not found and you are logged in with another user, try connecting as the user hxeadm and run the command again.

   su hxeadm
   

   If the hdbsql command cannot be found, simply read through the following examples. The installation and further examples of running HDBSQL will be covered in subsequent tutorials.

3. The following are a couple examples of commands followed by a SQL query, which when run against SYSTEMDB returns information about the databases running on the SAP HANA instance.

   \al
   \s
   SELECT * FROM SYS_DATABASES.M_SERVICES WHERE SQL_PORT != 0;
   

   

   The \al or align interactive option when enabled increases the readability of the output.

   The \s command shows status information. It shows that that the SAP System Identification (SID) is HXE, that the connected database is SYSTEMDB, and the currently logged in user is SYSTEM.

   The result of the SELECT against the M_SERVICES table shows that there are two databases, named SYSTEMDB and HXE and that they are accessible on ports 39013 and 39015.

   The instance number can be derived from a port number using the second and third numbers in the port number 39013. In this case, the instance number is 90.

   If the SQL statement returns more than one screen of text, entering a space will show the next screen of results. See also the pager option \pa.

4. Enter one of the below commands to exit from viewing the results of the select statement. Note that commands can be prefixed with a forward slash(\) or a colon(:).

   \q
   :q
   

5. Connect using the instance number and database name as shown below.

   hdbsql -n localhost -i 90 -d HXE -u SYSTEM -p Your_Password
   

6. Enter the following to display database connection information.

   \s
   

   Notice that this time the database connected to is HXE.

   

For further information, see Port Assignment in Tenant Databases and Connecting to SAP HANA Databases and Servers.

Congratulations! You now have access to an SAP HANA instance and understand some of the differences between SAP HANA Cloud and SAP HANA, express edition.