Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions tutorials/hana-clients-cf/hana-clients-cf.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition, programming-tool>node-js, software-product>sap-btp--cloud-foundry-runtime-and-environment, software-product>sap-business-technology-platform, software-product>sap-connectivity-service]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, programming-tool>node-js, software-product>sap-btp--cloud-foundry-runtime-and-environment, software-product>sap-business-technology-platform, software-product>sap-connectivity-service]
primary_tag: software-product>sap-hana-cloud
---

Expand All @@ -24,15 +24,15 @@

## Intro

In the previous tutorials, applications that queried SAP HANA were run on a local machine. In this tutorial, a simple application will be run within the SAP BTP which uses Cloud Foundry or within the SAP HANA, express edition which uses XS advanced (and is also based on Cloud Foundry).
In the previous tutorials, applications that queried SAP HANA were run on a local machine. In this tutorial, a simple application will be run within the SAP BTP which uses Cloud Foundry or within the SAP HANA on-premise which uses XS advanced (and is also based on Cloud Foundry).

For additional details, consult [Developing Applications on SAP BTP, Cloud Foundry runtime](https://learning.sap.com/learning-journeys/developing-applications-on-sap-btp-cloud-foundry-runtime) or [The XS Advanced Programming Model](https://help.sap.com/docs/SAP_HANA_PLATFORM/4505d0bdaf4948449b7f7379d24d0f0d/df19a03dc07e4ba19db4e0006c1da429.html).

---

### Get started with the Command Line Interface (CLI)

The command line interface (CLI) for Cloud Foundry is named `cf` while the CLI used for apps running in SAP HANA, express edition is named `xs`.
The command line interface (CLI) for Cloud Foundry is named `cf` while the CLI used for apps running in SAP HANA on-premise is named `xs`.

1. Check to see if you have the CF CLI installed and verify the version.

Expand Down Expand Up @@ -154,7 +154,7 @@

4. Add the code below to `server.js`. Be sure to update the `serverNode` value (SQL Endpoint from your instance) and user credentials if necessary.

```JavaScript

Check warning on line 157 in tutorials/hana-clients-cf/hana-clients-cf.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD009

Trailing spaces
var express = require('express');
var hana = require('@sap/hana-client');
var app = express();
Expand Down Expand Up @@ -226,7 +226,7 @@
```Shell (Linux or Mac)
cd ..
pico manifest.yml
```

Check warning on line 229 in tutorials/hana-clients-cf/hana-clients-cf.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD009

Trailing spaces

Add the code below to `manifest.yml`.

Expand All @@ -245,7 +245,7 @@

2. Deploy the app to Cloud Foundry or XS advanced.

Before deploying the app to Cloud Foundry, ensure that you have the **Cloud Foundry Runtime Environment** entitlement enabled for your subaccount. You can find the Entitlements page in the left-hand side menu of SAP BTP Cockpit.

Check warning on line 248 in tutorials/hana-clients-cf/hana-clients-cf.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD009

Trailing spaces

![Entitlement for CF runtime](cf-runtime-entitlement.png)

Expand Down Expand Up @@ -372,7 +372,7 @@

### Connect from the Node.js app running in the cloud to an on-premise database (optional)

The [Cloud Connector](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/cloud-connector#loioe6c7616abb5710148cfcf3e75d96d596__context) enables communication from the SAP BTP running in the public internet to securely connect to a configured on-premise system such as SAP HANA, express edition. The following steps demonstrate how to do this with the previously deployed app `nodeQueryCF`.
The [Cloud Connector](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/cloud-connector#loioe6c7616abb5710148cfcf3e75d96d596__context) enables communication from the SAP BTP running in the public internet to securely connect to a configured on-premise system such as SAP HANA on-premise. The following steps demonstrate how to do this with the previously deployed app `nodeQueryCF`.

1. Follow step 3 in [Access Remote Sources with SAP HANA Database Explorer](hana-dbx-remote-sources) to install and configure the Cloud Connector.

Expand Down Expand Up @@ -509,7 +509,6 @@
})
})
}

```

6. Redeploy the app.
Expand All @@ -519,7 +518,7 @@
cf push
```

7. The application running in the cloud, is now accessing data from an on-premise SAP HANA, express instance.
7. The application running in the cloud, is now accessing data from an on-premise SAP HANA instance.

![Result](proxy-result.png)

Expand All @@ -527,3 +526,3 @@

Congratulations, you have built, deployed, and run an app that queries SAP HANA in Cloud Foundry and XS advanced as well as become familiar with the command line interface.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
author_profile: https://github.com/danielva
auto_validation: true
time: 20
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down Expand Up @@ -42,10 +42,10 @@

There are multiple versions of SAP HANA. The information below is a list of links for the documentation of each version.

| Version | Notes
| :------------- | :-------------
| [SAP HANA Platform 2.0](https://help.sap.com/docs/SAP_HANA_PLATFORM) | Released in November 2016. Current version is 2.0 SPS 08, which was released on Nov 20th, 2024.
| **[SAP HANA Cloud](https://help.sap.com/docs/hana-cloud)** | Released in March 2020. New features are released quarterly.
| Version | Notes
| -------- | ------ |

Check warning on line 46 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD055

Table pipe style
| [SAP HANA Platform 2.0](https://help.sap.com/docs/SAP_HANA_PLATFORM) | Released in November 2016. Current version is 2.0 SPS 08, which was released on Nov 20th, 2024. |

Check warning on line 47 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD060

Table column style

Check warning on line 47 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD060

Table column style

Check warning on line 47 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD055

Table pipe style
| **[SAP HANA Cloud](https://help.sap.com/docs/hana-cloud)** | Released in March 2020. New features are released quarterly. |

Check warning on line 48 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD060

Table column style

Check warning on line 48 in tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

View workflow job for this annotation

GitHub Actions / checks / checks

markdown/MD055

Table pipe style

### SAP HANA Cloud

Expand Down Expand Up @@ -149,7 +149,7 @@

>This step only needs to be completed if you currently do not have access to an SAP HANA Instance and did not set up an SAP HANA instance using the SAP HANA Cloud free tier as explained in step 3.

A default installation will contain one [system](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/39da3d057f56427ab1bb7f738ca9e7ce.html) database named **SYSTEMDB** and one [tenant](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/623afd167e6b48bf956ebb7f2142f058.html) database named **HXE**.
A default installation will contain one [system](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/39da3d057f56427ab1bb7f738ca9e7ce.html) database named **SYSTEMDB** and one [tenant](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/623afd167e6b48bf956ebb7f2142f058.html) database which in this example is 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](https://help.sap.com/docs/SAP_HANA_PLATFORM/78209c1d3a9b41cd8624338e42a12bf6/0ba9f43aed594a449d497fabf6bc381e.html).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down Expand Up @@ -104,7 +104,7 @@ In order for the shell to recognize that the .NET SDK is installed and for any `
// encrypt and sslValidateCertificate should be true for HANA Cloud connections
// As of SAP HANA Client 2.6, connections on port 443 enable encryption by default
// sslValidateCertificate should be set to false when connecting
// to an SAP HANA, express edition instance that uses a self-signed certificate.
// to an on-premise SAP HANA instance that uses a self-signed certificate.

{
conn.Open();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down
2 changes: 1 addition & 1 deletion tutorials/hana-clients-golang/hana-clients-golang.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down
12 changes: 6 additions & 6 deletions tutorials/hana-clients-hdbsql/hana-clients-hdbsql.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition, programming-tool>sql]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, programming-tool>sql]
primary_tag: software-product>sap-hana-cloud
---

Expand All @@ -23,7 +23,7 @@ primary_tag: software-product>sap-hana-cloud

## Intro

HDBSQL is used in this tutorial as it is part of the SAP HANA client install. HDBSQL is a basic tool for executing SQL scripts and providing an interface for interactive queries. Another option to execute SQL operations is the [SQL Console](hana-dbx-hcc) that is part of SAP HANA Cloud Central or the [SAP HANA database explorer](group.hana-cloud-get-started) which is part of an on-premise install of the SAP HANA Cockpit or a server + applications SAP HANA, express edition install.
HDBSQL is used in this tutorial as it is part of the SAP HANA client install. HDBSQL is a basic tool for executing SQL scripts and providing an interface for interactive queries. Another option to execute SQL operations is the [SQL Console](hana-dbx-hcc) that is part of SAP HANA Cloud Central or the [SAP HANA database explorer](group.hana-cloud-get-started) which is part of an on-premise install of the SAP HANA Cockpit.

---

Expand All @@ -37,7 +37,7 @@ This step demonstrates how to connect to a SAP HANA instance using [HDBSQL](http
hdbsql -h | more
```

2. Connect to either SAP HANA Cloud or SAP HANA, express edition using host, port, and credentials. Details on where to find these values are covered in the third and fifth steps of the [first tutorial](hana-clients-choose-hana-instance) in this mission.
2. Connect to either SAP HANA Cloud or SAP HANA on-premise instance using host, port, and credentials. Details on where to find these values are covered in the third and fifth steps of the [first tutorial](hana-clients-choose-hana-instance) in this mission.

- To connect to SAP HANA Cloud, see the following general command.

Expand All @@ -53,15 +53,15 @@ This step demonstrates how to connect to a SAP HANA instance using [HDBSQL](http

![Connect with hdbsql](connect-with-hdbsql.png)

- For SAP HANA, express edition, there are two options shown below to connect.
- For SAP HANA on-premise, there are two options shown below to connect.

```Shell
hdbsql -n <ip address>:39015 -u <user> -p <password>
or
hdbsql -n <ip address> -d <database name> -i <instance number> -u <user> -p <password>
```

Below are two connection examples for SAP HANA, express edition.
Below are two connection examples for an on-premise SAP HANA instance.

```Shell
hdbsql -n <ip address>:39015 -u SYSTEM -p your_password
Expand Down Expand Up @@ -149,7 +149,7 @@ This step demonstrates how to connect to a SAP HANA instance using [HDBSQL](http

![Connect to HANA Cloud](Connect-to-host-server-cloud.png)

Notice that for the HANA, express edition, the version number is 2.x.
Notice that for the on-premise instance, the version number is 2.x.

![Connect to HXE](Connect-to-host-server.png)

Expand Down
2 changes: 1 addition & 1 deletion tutorials/hana-clients-install/hana-clients-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 10
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down
6 changes: 3 additions & 3 deletions tutorials/hana-clients-jdbc/hana-clients-jdbc.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud\,-sap-hana-database, software-product>sap-hana, software-product>sap-hana\,-express-edition, programming-tool>java]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, programming-tool>java]
primary_tag: software-product>sap-hana-cloud
---

Expand Down Expand Up @@ -144,7 +144,7 @@ See [JDBC Command-Line Connection Options](https://help.sap.com/docs/SAP_HANA_CL

//As of SAP HANA Client 2.6, connections on port 443 enable encryption by default
//validateCertificate should be set to false when connecting
//to an SAP HANA, express edition instance that uses a self-signed certificate.
//to an SAP HANA on-premise instance that uses a self-signed certificate.

//As of SAP HANA Client 2.7, it is possible to direct trace info to stdout or stderr
//"jdbc:sap://10.11.123.134:39015/?encrypt=true&validateCertificate=false&traceFile=stdout&traceOptions=CONNECTIONS", "User1", "Password1");
Expand Down Expand Up @@ -241,7 +241,7 @@ Visual Studio Code provides plugins for Java and can be used to debug an applica

`DBeaver` is a free and open-source database tool and can be used with the SAP HANA JDBC driver.

The following steps demonstrate how to configure `DBeaver` to connect to SAP HANA Cloud or SAP HANA, express edition using the JDBC driver.
The following steps demonstrate how to configure `DBeaver` to connect to SAP HANA Cloud or SAP HANA on-premise instance using the JDBC driver.

1. [Download](https://dbeaver.io/download/), install or unzip, and run the community edition of `DBeaver`.

Expand Down
10 changes: 5 additions & 5 deletions tutorials/hana-clients-node/hana-clients-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 20
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition, programming-tool>node-js]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, programming-tool>node-js]
primary_tag: software-product>sap-hana-cloud
---

Expand Down Expand Up @@ -211,7 +211,7 @@ Node.js packages are available using [NPM](https://www.npmjs.com/), which is the

//As of SAP HANA client 2.6, connections on port 443 enable encryption by default (HANA Cloud).
//encrypt: 'true', //Must be set to true when connecting to HANA as a Service
sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA, express edition instance that uses a self-signed certificate.
sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA on-premise instance that uses a self-signed certificate.

//For encrypted connections, the default crypto provider is mscrypto on Windows or openSSL on Linux or macos
//To use the SAP crypto provider, uncomment the below line.
Expand Down Expand Up @@ -442,7 +442,7 @@ Asynchronous programming enables non-blocking code execution which is demonstrat
//UID: 'USER1',
//PWD: 'Password1',

sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA, express edition instance that uses a self-signed certificate.
sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA on-premise instance that uses a self-signed certificate.
};

//Asynchronous example calling a stored procedure with callbacks
Expand Down Expand Up @@ -500,7 +500,7 @@ Asynchronous programming enables non-blocking code execution which is demonstrat
}
```

4. Run the app.
3. Run the app.

```Shell
node nodeQueryCallback.js
Expand Down Expand Up @@ -543,7 +543,7 @@ The Node.js driver for the SAP HANA client added support for promises in the 2.1
//UID: 'USER1',
//PWD: 'Password1',

sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA, express edition instance that uses a self-signed certificate.
sslValidateCertificate: 'false', //Must be set to false when connecting to an SAP HANA on-premise instance that uses a self-signed certificate.
};

//Asynchronous example calling a stored procedure that uses the promise module
Expand Down
14 changes: 4 additions & 10 deletions tutorials/hana-clients-odbc/hana-clients-odbc.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author_name: Dan van Leeuwen
author_profile: https://github.com/danielva
auto_validation: true
time: 15
tags: [ tutorial>beginner, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana, software-product>sap-hana--express-edition]
tags: [ tutorial>beginner, software-product>sap-hana-cloud, software-product-function>sap-hana-cloud--sap-hana-database, software-product>sap-hana]
primary_tag: software-product>sap-hana-cloud
---

Expand Down Expand Up @@ -58,11 +58,11 @@ The ODBC Data Source Administrator lists the installed ODBC drivers and the conf

![ODBC HANA Cloud](ODBC-HC.png)

7. Example data source configuration for SAP HANA, express edition.
7. Example data source configuration for SAP HANA on-premise instance.

![ODBC HXE](ODBC-HXE.png)

To connect to SAP HANA, express edition, **Multitenant** should be checked and the **Validate TLS/SSL certificate** option can be unchecked. For more information on this topic, see [How to Configure TLS/SSL in SAP HANA 2.0](https://blogs.sap.com/2018/11/13/how-to-configure-tlsssl-in-sap-hana-2.0/).
To connect to SAP HANA on-premise, **Multitenant** should be checked and the **Validate TLS/SSL certificate** option can be unchecked. For more information on this topic, see [How to Configure TLS/SSL in SAP HANA 2.0](https://blogs.sap.com/2018/11/13/how-to-configure-tlsssl-in-sap-hana-2.0/).

8. Click **Test connection**.

Expand Down Expand Up @@ -118,7 +118,7 @@ The following instructions demonstrate how [unixODBC](http://www.unixodbc.org/)
encrypt = true
sslValidateCertificate = true

[HANA_Express]
[HANA_OnPremise]
servernode = hxehost:39015
driver = /home/dan/sap/hdbclient/libodbcHDB.so
databasename = HXE
Expand Down Expand Up @@ -182,10 +182,4 @@ The following steps demonstrate how to use Microsoft Excel to query data in SAP

Congratulations! You have configured an ODBC data source to contain connection information for a SAP HANA database and used that data source from Microsoft Excel.







---
Loading
Loading