Skip to content

Commit 6ca3322

Browse files
authored
Latest updates to data lake client, autopilot, and dbx tutorials (#18447)
* Automatic commit: Move 'hana-cloud-alerts-autopilot', 'hana-cloud-dl-clients-node', 'hana-cloud-dl-clients-odbc', 'hana-cloud-dl-clients-overview', 'hana-cloud-dl-clients-python', 'hana-dbx-connections', 'hana-dbx-create-schema', 'hana-dbx-export-import', 'hana-dbx-remote-sources' from QA to Production * Automatic commit: Move 'hana-cloud-dl-clients-overview' from QA to Production
1 parent 1c53c46 commit 6ca3322

File tree

23 files changed

+28
-16
lines changed

23 files changed

+28
-16
lines changed

tutorials/hana-cloud-alerts-autopilot/hana-cloud-alerts-autopilot.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -311,7 +311,8 @@ This step will configure the SAP Alert Notification Service to invoke the previo
311311

312312
>---
313313

314-
>Note, that multiple alerts will be triggered. For example, alerts are sent with a status of CREATE, UPDATE, or CLOSE. Some alerts also have different thresholds or severity values such as ERROR, WARNING, or NOTICE. See also [Alerts in SAP HANA Cloud](https://help.sap.com/viewer/f9c5015e72e04fffa14d7d4f7267d897/Cloud/en-US/8eca57e7e82e4b788246b6d9db020937.html).
314+
>Note, that multiple alerts will be triggered. For example, alerts are sent with a status of CREATE, UPDATE, or CLOSE. Some alerts also have different thresholds or severity values such as ERROR, WARNING, or NOTICE. See also [Alerts in SAP HANA Cloud](https://help.sap.com/docs/HANA_CLOUD_DATABASE/f9c5015e72e04fffa14d7d4f7267d897/8eca57e7e82e4b788246b6d9db020937.html).
315+
315316

316317
6. In the SAP HANA database explorer, trigger the test alert.
317318

-4.53 KB
Loading
Loading
22 Bytes
Loading
Loading
Loading

tutorials/hana-cloud-dl-clients-odbc/hana-cloud-dl-clients-odbc.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ For additional details see [Connection Properties](https://help.sap.com/viewer/a
137137
[DONE]
138138
[ACCORDION-END]
139139
140-
[ACCORDION-BEGIN [Step 3: ](Use data lake data source from Microsoft Excel)]
140+
[ACCORDION-BEGIN [Step 3: ](Use a data lake data source from Microsoft Excel)]
141141
142142
An application that supports ODBC can now make use of the created data source. One example on Windows is Microsoft Excel.
143143
Loading
Loading

tutorials/hana-cloud-dl-clients-overview/hana-cloud-dl-clients-overview.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@ primary_tag: software-product-function>sap-hana-cloud\,-data-lake
99

1010
## Prerequisites
1111
- A Microsoft Windows or Linux computer.
12-
- An SAP HANA Cloud trial or free tier.
1312

1413
## Details
1514
### You will learn
@@ -38,15 +37,14 @@ SAP HANA Cloud is composed of multiple components.
3837

3938
>Note, that the data lake Files component is currently not available in trial accounts.
4039
41-
For additional details see [How & When to Use the New SAP HANA Cloud Database Instances](https://saphanajourney.com/hana-cloud/resources/sap-hana-cloud-new-services-adaptive-server-enterprise-and-data-lake/).
4240

4341
[DONE]
4442
[ACCORDION-END]
4543

4644

4745
[ACCORDION-BEGIN [Step 2: ](Create a data lake instance and connect to it)]
4846

49-
>To complete the tutorials in this group, an SAP HANA Cloud, data lake instance is needed. There are two different free options including SAP HANA Cloud free tier and free trial. For instructions on registering, see [Set Up Your SAP HANA Cloud, SAP HANA Database (free tier or trial) and Understand the Basics](group.hana-cloud-get-started-1-trial).
47+
>To complete the tutorials in this group, a SAP HANA Cloud, data lake instance is needed, which is created within the SAP Business Technology Platform (BTP). There are two different free options available, which are the SAP BTP free-tier and SAP BTP trial. For instructions on registering, see [Start Using SAP HANA Cloud Free Tier Model or Trial in SAP BTP Cockpit](hana-cloud-mission-trial-1).
5048
5149
The following steps provide instructions on how to create a data lake instance in the SAP Business Technology Platform (BTP) trial. Additional content on this topic is available at [Quick Start Tutorial for Data Lake](https://help.sap.com/viewer/a89a80f984f21015b2b2c84d2498d36d/latest/en-US/b62bc948ad684e3a94b9e14b68318f2a.html).
5250

@@ -267,6 +265,8 @@ In this step, a sample HOTEL dataset will be created comprising tables, a view,
267265
GRANT ROLE HOTEL TO USER1;
268266
```
269267

268+
Select **Tables**, and set the schema filter to be **HOTEL** to limit the returned tables to be those that were just created in the HOTEL schema.
269+
270270
![DBX Create](sql-commands.png)
271271

272272
Additional details on the SQL used above can be found at [CREATE TABLE Statement for Data Lake Relational Engine](https://help.sap.com/viewer/19b3964099384f178ad08f2d348232a9/latest/en-US/a619764084f21015b8039a8346dc622c.html), [CREATE VIEW Statement for Data Lake Relational Engine](https://help.sap.com/viewer/19b3964099384f178ad08f2d348232a9/latest/en-US/a61a051684f210158cced2d83231bd8a.html), and [CREATE PROCEDURE Statement for Data Lake Relational Engine](https://help.sap.com/viewer/19b3964099384f178ad08f2d348232a9/latest/en-US/a6185b2184f21015b2419a5444b55609.html).
@@ -391,13 +391,13 @@ The data lake client install includes [Interactive SQL Client (DBISQL)](https://
391391
>DBISQL can also be started without a GUI.
392392
>
393393
>```Shell (Windows)
394-
dbisql -hdl -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" -nogui
394+
dbisql -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" -nogui
395395
>```
396396
>
397397
> Note that in a Bash shell, strings in double quotes versus single quotes are treated [differently](https://stackoverflow.com/questions/6697753/difference-between-single-and-double-quotes-in-bash).
398398
>
399399
>```Shell (Linux)
400-
dbisql -hdl -c 'uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)' -nogui
400+
dbisql -c 'uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)' -nogui
401401
>```
402402

403403
>![DBISQL connected nogui](dbisql-nogui.png)
@@ -421,7 +421,7 @@ The data lake client install includes [Interactive SQL Client (DBISQL)](https://
421421

422422
1. Execute the following insert statements to provide some sample data.
423423

424-
>If you do not wish to use the GUI mode, paste the insert statements into a file first and then run `dbisql -hdl -c "uid..." sql.sql`.
424+
>If you do not wish to use the GUI mode, paste the insert statements into a file first and then run `dbisql -c "uid..." sql.sql`.
425425

426426
```SQL
427427
INSERT INTO HOTEL.HOTEL VALUES(10, 'Congress', '155 Beechwood St.', 'Seattle', 'WA', '20005');
@@ -550,8 +550,8 @@ The data lake client install includes [Interactive SQL Client (DBISQL)](https://
550550
3. DBISQL can also execute SQL from the command line or from a provided file. A few examples are shown below.
551551

552552
```Shell
553-
dbisql -hdl -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" "select * from HOTEL.CUSTOMER;"
554-
dbisql -hdl -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" sql.sql
553+
dbisql -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" "select * from HOTEL.CUSTOMER;"
554+
dbisql -c "uid=USER1;pwd=Password1;host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC=TLS(tls_type=rsa;direct=yes)" sql.sql
555555
```
556556

557557
![DBISQL in batch mode](dbisql-batch.png)
Loading
Loading
Loading

tutorials/hana-cloud-dl-clients-python/hana-cloud-dl-clients-python.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -80,9 +80,9 @@ The `sqlanydb` package is the python driver for the data lake Relational Engine
8080

8181
This should create additional build directories in the current folder.
8282

83-
2. On Microsoft Windows, set the environment variable `SQLANY_API_DLL`.
83+
2. On Microsoft Windows, create a user environment variable named `SQLANY_API_DLL` and set it to `%IQDIR17%\Bin64\dbcapi.dll`.
8484

85-
Navigate to your system environment variables and set `SQLANY_API_DLL=%IQDIR17%\Bin64\dbcapi.dll`.
85+
![add a variable named SQLANY_API_DLL](add-variable.png)
8686

8787
[DONE]
8888
[ACCORDION-END]
Loading
Loading
Loading
-10.7 KB
Loading
1.34 KB
Loading

tutorials/hana-dbx-create-schema/hana-dbx-create-schema.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,21 @@ The following steps will create sample objects for a hotel database using create
3939
CREATE USER USER2 PASSWORD Password2 no force_first_password_change SET USERGROUP DEFAULT;
4040
>```
4141

42-
>--
42+
>---
4343

44-
>It is recommended to not use the DBADMIN user for day to day operations in production environments. For additional details see [Deactivate the DBADMIN User](https://help.sap.com/docs/HANA_CLOUD_DATABASE/f9c5015e72e04fffa14d7d4f7267d897/c511ddf1767947f0adfc9636148718d9.html).
44+
>The following shows an example of creating a USERGROUP, assigning USER1 to the group, and querying the password policy of the user.
4545

46-
For additional detail on creating users see [CREATE USER Statement (Access Control)](https://help.sap.com/viewer/c1d3f60099654ecfb3fe36ac93c121bb/latest/en-US/20d5ddb075191014b594f7b11ff08ee2.html). Note that the user USER1 will be used in tutorial 5 and tutorial 7 of this tutorial group.
46+
>```SQL
47+
CREATE USERGROUP HOTEL_USER_GROUP SET PARAMETER 'minimal_password_length' = '8', 'force_first_password_change' = 'FALSE';
48+
ALTER USER USER1 SET USERGROUP HOTEL_USER_GROUP;
49+
SELECT * from "PUBLIC"."M_EFFECTIVE_PASSWORD_POLICY" where USER_NAME = 'USER1';
50+
>```
51+
52+
>---
53+
54+
>It is recommended to not use the DBADMIN user for day to day operations in production environments. For additional details see [Deactivate the DBADMIN User](https://help.sap.com/docs/HANA_CLOUD_DATABAS/f9c5015e72e04fffa14d7d4f7267d897/c511ddf1767947f0adfc9636148718d9.html).
55+
56+
For additional detail on creating users see [CREATE USER Statement (Access Control)](https://help.sap.com/viewer/c1d3f60099654ecfb3fe36ac93c121bb/latest/en-US/20d5ddb075191014b594f7b11ff08ee2.html) and [CREATE USERGROUP Statement](https://help.sap.com/docs/HANA_CLOUD_DATABASE/c1d3f60099654ecfb3fe36ac93c121bb/9869125ea93548009820702f5bd897d8.html). Note that the user USER1 will be used in tutorial 5 and tutorial 7 of this tutorial group.
4757

4858
3. The list of users can be seen by executing the following statement:
4959

Loading

tutorials/hana-dbx-export-import/hana-dbx-export-import.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,7 @@ The following steps walk through the process of exporting to and importing data
197197
10. A Google Storage SSL certificate is required to connect to the Google Cloud Storage bucket via the SAP HANA Cloud, SAP HANA database. Open your SQL console within SAP HANA database explorer, and run the first 3 commands. Then replace \<SELECTED_CERTIFICATE_ID> with the value returned from the previous select statement.
198198

199199
```SQL[27]
200+
SELECT * FROM PSES;
200201
CREATE PSE HTTPS;
201202
CREATE CERTIFICATE FROM '-----BEGIN CERTIFICATE-----
202203
MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQsw

tutorials/hana-dbx-remote-sources/hana-dbx-remote-sources.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ A benefit of a virtual table is that there is no data movement. There is only o
180180
181181
[ACCORDION-BEGIN [Step 2: ](Connect from SAP HANA Cloud to SAP HANA Cloud, data lake Relational Engine)]
182182
183-
[SAP HANA Cloud, data lake](https://help.sap.com/viewer/product/SAP_HANA_DATA_LAKE/cloud/en-US) can be used to store large amounts of data that is not accessed frequently. The following steps create the table `tourist_reviews` in SAP HANA Cloud, data lake Relational Engine and access the table from the associated SAP HANA Cloud instance.
183+
[SAP HANA Cloud, data lake](https://help.sap.com/viewer/product/SAP_HANA_DATA_LAKE/cloud/en-US) can be used to store large amounts of data that is not accessed and updated as frequently as data in an SAP HANA database. The following steps create the table `tourist_reviews` in SAP HANA Cloud, data lake Relational Engine and access the table from the associated SAP HANA database instance.
184184
185185
1. If needed, in SAP HANA Cloud Central, add an SAP HANA Cloud, data lake instance to your SAP HANA Cloud instance, by choosing **Actions > Add Data Lake**.
186186

0 commit comments

Comments
 (0)