Mithilfe von Datasphere CLI können Sie die Konsole / Eingabeaufforderung für die Interaktion mit Datasphere nutzen. Für die Einrichtung sind folgende Schritte notwendig:

• Installation
• Host festlegen
• OAuth Client in Datasphere einrichten
• Anmeldung
• Befehle ausführen

Installation

Für die Installation von SAP Datasphere CLI müssen die folgenden Voraussetzungen erfüllt sein:

• Node.js version >= 20 und <=24
• npm version >= 8 und <=11

Diese können Sie mit den folgenden Befehlen prüfen:

node -v
npm -v

Falls Sie statt der Version eine Fehlermeldung bekommen, ist Node.js nicht installiert und muss installiert werden. Wenn die Voraussetzungen erfüllt sind, können Sie Datasphere CLI mit dem folgenden Befehl installieren. Öffnen Sie dazu die Konsole / Eingabeaufforderung.

npm install -g @sap/datasphere-cli

Für Upgrades muss der Befehl wiederholt ausgeführt werden.

Testen Sie die Installation mit:

datasphere –v
# oder
datasphere --version

Host festlegen

Identifizieren Sie Ihren Datasphere Tenant, um Befehle ohne den --host Parameter ausführen zu können.

datasphere config host set <url>

Zum Beispiel:

datasphere config host set https://your-dsp-domain.eu10.hcs.cloud.sap

Die Domain wird in settings.json unter %userprofile%/.@sap/datasphere-cli/.cache gespeichert. Sie können die gespeicherte Domain mit dem folgenden Befehl anzeigen.

datasphere config host show

Falls Sie die gespeicherten Tenant löschen wollen, verwenden Sie

datasphere config host clean

OAuth Client in Datasphere einrichten

Als nächstes müssen Sie einen OAuth Client vom Typ Interactive Usage oder Technical User in Datasphere einrichten. Der Technische Benutzer hat einen eingeschränkten Umfang, so kann dieser zum Beispiel keine Benutzer verwalten. Allerdings erfolgt die Anmeldung einfacher. Es ist keine Authentifizierung erforderlich. Der OAuth-Client enthält die erforderlichen Anmeldeinformationen und Berechtigungen. Im folgenden Beispiel nutze ich Interactive Usage.

Folgen Sie in Datasphere den Menüpfad Datasphere → Administration → App Integration und fügen Sie einen neuen OAuth Client hinzu.

Als Redirect URI können Sie http://localhost:8080 eingeben.

Kopieren Sie nach der Einrichtung die Client ID und Secret. Der Secret Key kann danach nicht mehr angezeigt werden, falls Sie diesen verlieren, müssen Sie einen neuen Client einrichten.

Anmeldung

Nach der Konfiguration des Clients können Sie sich über die Befehlszeile an Datasphere anmelden.

datasphere login

Alternativ können Sie die relevanten Parameter direkt mitgeben:

datasphere login 
    --client-id "<id>" 
    --client-secret "<secret>" 
    --authorization-url "<url>"
    --token-url "<url>"

Zum Beispiel:

datasphere login --client-id "your-id" --client-secret "your-secret" --authorization-url "https://your-dsp-domain.authentication.eu10.hana.ondemand.com/oauth/authorize" --token-url "https://your-dsp-domain.authentication.eu10.hana.ondemand.com/oauth/token"

Wenn Sie einen Interactive Usage Client verwenden, werden Sie zu Beginn Ihrer OAuth-Sitzung aufgefordert, sich mit Ihrem Benutzernamen und Kennwort für SAP Datasphere in einem Browserfenster anzumelden, um Ihre Space-Berechtigungen zu ermitteln. Anschließend sollte sich ein Fenster mit der Meldung Thank you, you can close the window öffnen. Wenn die Verbindung fehlschlägt, überprüfen Sie Ihre Datasphere Berechtigungen.

Bei der erfolgreichen Anmeldung wird unter %userprofile%/.@sap/datasphere-cli/.cache eine secrets.json Datei angelegt.

Sie können den Inhalt auch mit dem folgenden Befehl anzeigen:

datasphere config secrets show

Kopieren Sie die folgenden Werte in eine separate secrets Datei, z.B. dev-secrets.json oder prod-secrets.json. Die access und refresh Tokens sind 30 Tage lang gültig.

{
    "client_id": "<client-id>",
    "client_secret": "<client-secret>",
    "authorization_url": "<authorization-url>",
    "token_url": "<token-url>",
    "access_token": "<access-token>",
    "refresh_token": "<refresh-token>",
    "host": "<url>",
    "authorization_flow": "<flow>"
}

Zum Beispiel:

{
  "client_id": "sb-1331..",
  "client_secret": "1337a..",
  "authorization_url": "https://domain.authentication.eu10.hana.ondemand.com/oauth/authorize",
  "token_url": "https://domain.authentication.eu10.hana.ondemand.com/oauth/token",
  "access_token": "abc1337..",
  "refresh_token": "xyz1337..",
  "authorization_flow": "authorization_code"
}

Befehle ausführen

Nun können Sie über das Terminal Befehle auf Datasphere ausführen, ohne sich vorher anzumelden. Z.B. über den absoluten Pfad:

datasphere spaces list --secrets-file "c:/Users/denis/secrets.json"

Oder aus dem jeweiligen Verzeichnis

datasphere spaces list --secrets-file secrets.json

Viel Spass damit!

• Komanndozeilen Befehle
• Tastenkombinationen

Komanndozeilen Befehle

Die Tabelle deckt die wichtigsten Befehle für die Navigation und Dateiverwaltung ab.

Groß-/Kleinschreibung: Linux ist „case-sensitive“. Datei.txt und datei.txt sind für Linux zwei völlig verschiedene Dinge. Windows ignoriert das meistens.

Slashes: Linux nutzt den Forward-Slash (/) für Pfade, während Windows klassischerweise den Backslash (\) verwendet (auch wenn PowerShell heute oft beides schluckt).

Die Macht von grep: Während der Windows-Befehl findstr eher simpel ist, ist grep unter Linux ein extrem mächtiges Werkzeug für Datenanalyse.

Punkt-Notation: In beiden Welten steht . für das aktuelle Verzeichnis und .. für das übergeordnete Verzeichnis.

Tastenkombinationen

Hier ist eine ergänzende Tabelle mit den wichtigsten Tastenkombinationen (Shortcuts) für das Terminal. Diese funktionieren in fast allen Linux-Shells (wie Bash oder Zsh) und oft auch in modernen Windows-Terminals (wie der PowerShell oder dem Windows Terminal).

Wichtiger Hinweis: In vielen modernen grafischen Terminal-Emulatoren (wie unter Windows oder macOS) wird Strg + S manchmal für die Suche oder das Speichern abgefangen. In einer echten Linux-Konsole (TTY) oder via SSH ist es aber der klassische „Einfrier-Befehl“. Wenn also gar nichts mehr geht: Erstmal Strg + Q drücken!

Nachfolgend führe ich Sie Schritt für Schritt durch die Einrichtung.

• Zertifikate für SSL-Verbindungen zu Remote-Sources importieren
• Remote Datenquelle über SQL anlegen
• Virtuelle Tabelle über SQL anlegen
• Remote Datenquelle über SAP HANA Database Explorer anlegen
• Virtuelle Tabelle über SQL SAP HANA Database Explorer anlegen

Zertifikate für SSL-Verbindungen zu Remote-Sources importieren

Zunächst müssen Sie ein SSL-Zertifikat herunterladen. Führen Sie den folgenden Befehl in der Eingabeaufforderung aus.

curl -O https://dl.cacerts.digicert.com/DigiCertGlobalRootCA.crt.pem

Legen Sie anschließend in der HANA Datenbank eine Zertifikatssammlung an.

CREATE PSE datasphere_ch_pse;

Legen Sie nun mit dem Inhalt des heruntergeladenen Zertifakts einen neuen Zertifikat auf der Datenbank an.

CREATE CERTIFICATE datasphere_ch_cert FROM '
-----BEGIN CERTIFICATE-----
MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
...
-----END CERTIFICATE-----'; 

Fügen Sie nun das angelegte Zertifikat zur Zertifikatssammlung hinzu.

ALTER PSE datasphere_ch_pse ADD CERTIFICATE datasphere_ch_cert;

Setzen Sie schließlich den Zweck der neu angelegten PSE auf REMOTE SOURCE.

SET PSE datasphere_ch_pse PURPOSE REMOTE SOURCE;

Remote Datenquelle über SQL anlegen

Legen Sie nun eine Remote-Quelle an. Nutzen Sie den Hostnamen und den Datasphere Datenbank Benutzer. Für on-premises HANA Datenbank müssen Sie ggf. die Whitelist von Datasphere mit der IP ergänzen. Für HANA Cloud innerhalb derselben BTP Instanz war es nicht notwendig.

CREATE REMOTE SOURCE <remote_source_name> ADAPTER "hanaodbc" 
    CONFIGURATION 'Driver=libodbcHDB.so;ServerNode=<HANA_Cloud_endpoint>;
    encrypt=TRUE;'
    WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=<user_name>;password=<password>';

Zum Beispiel:

CREATE REMOTE SOURCE "DSP_SHARE_TO_HANA" ADAPTER "hanaodbc" 
    CONFIGURATION 'Driver=libodbcHDB.so;ServerNode=dcc5315a-xxx.hna0.prod-eu10.hanacloud.ondemand.com:443;
    encrypt=TRUE;'
    WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=YOURSPACE#YOURUSER;password=YourPassword';

Virtuelle Tabelle über SQL anlegen

Anschließend können Sie die Datenquelle nutzen, um eine Virtuelle Tabelle anzulegen. Dabei können Sie auf der Datasphere Datenbank angelegten Tabellen oder Views nutzen, mit der aktivierten Option „Für die Verwendung verfügbar machen“ (English Expose for Consumption). Diese Views erscheinen automatisch in der Datenbank.

CREATE VIRTUAL TABLE "<target space>"."<target table>" AT "<remote connection>"."<source database>"."<source space>"."<source table or view>";

Zum Beispiel:

CREATE VIRTUAL TABLE "DBADMIN"."VT_ZDR_VW_001" AT "DSP_SHARE_TO_HANA"."<NULL>"."MYSPACE"."ZDR_VW_001";

Diese Tabelle kann nun ganz normal genutzt werden.

SELECT * FROM "DBADMIN"."VT_ZDR_VW_001" LIMIT 100;

Remote Datenquelle über SAP HANA Database Explorer anlegen

Alternativ kann die Datenquelle über die Database Explorer Oberfläche angelegt werden. Selektieren Sie dazu im Catalog den Eintrag Remote Sources und wählen Sie im Untermenü Add Remote Source aus.

Geben Sie nun den Namen der Datenquelle ein und füllen Sie die Felder aus. Nutzen Sie dabei den Hostnamen, Port 443 und den Datasphere Datenbank Benutzer.

Klicken Sie anschließend auf Create. Für on-premises HANA Datenbank müssen Sie ggf. die Whitelist von Datasphere mit der IP ergänzen. Für HANA Cloud innerhalb derselben BTP Instanz war es nicht notwendig.

Virtuelle Tabelle über SQL SAP HANA Database Explorer anlegen

Wählen Sie nun das Schema und den Objekttyp aus und klicken Sie auf Search. Selektieren Sie nun das gewünschte Objekt und klicken Sie auf Create Virtual Object(s).

Geben Sie nun den Namen des Objekts und wählen Sie das Schema aus. Klicken Sie anschließend auf Create.

Nun steht die Tabelle im Database Explorer zur Verfügung.

Ihre User beklagen sich über langsame Berichte?

• In meinem Newsletter lernen Sie, wie Sie Abhilfe schaffen.
• Entdecken Sie die Möglichkeiten der Performanceoptimierung.
• Praktische Anleitungen ermöglichen Ihnen schnelle Erfolge bei der Optimierung von SAP Systemen.
• Viele Tipps und Tricks zu SAP BI Themen.
• Holen Sie die maximale Performance aus Ihrem SAP BI!
• Bei der Anmeldung zu meinem Newsletter erhalten Sie das Buch „High Performance SAP BI“ als Willkommensgeschenk.

Jetzt anfordern!

Vorname

E-Mail *

* Pflichtfeld

 

Kein SPAM. Ich hasse Spam genau so wie du.

Markdown Crashkurs

Alles was du brauchst, auf einen Blick.

Überschriften

Wichtig: Nach # kommt immer ein Leerzeichen. Leerzeilen zwischen Blöcken sorgen für saubere Trennung.

Markdown

# Überschrift 1 (größte)
## Überschrift 2
### Überschrift 3
#### Überschrift 4

Ergebnis

Textformatierung

Listen

Ungeordnet

- Punkt 1
- Punkt 2
  - Unterpunkt
  - Noch einer

Ergebnis

Geordnet

1. Erster
2. Zweiter
3. Dritter

Ergebnis

Checkboxen (To-Do Listen)

- [x] Erledigt
- [ ] Offen
- [ ] Noch zu tun

Ergebnis

Links & Bilder

[Link-Text](https://example.com)
![Bild-Beschreibung](bild.png)

Ergebnis

Zitate

> Das ist ein Zitat
> Zweite Zeile

Ergebnis

Code-Blöcke

```js
const x = 42;
console.log(x);
```

Ergebnis

const x = 42;
console.log(x);

Tabellen

| Spalte 1 | Spalte 2 | Spalte 3 |
|----------|----------|----------|
| Wert A   | Wert B   | Wert C   |
| Wert D   | Wert E   | Wert F   |

Ergebnis

Horizontale Linie

---

Ergebnis

Das Kommunikationssystem stellt über einen Kommunikationsbenutzer die Verbindung her. Es stellt die über eine Kommunikationsvereinbarung zugewiesene (und in Kommunikationsszenarien gebündelte) APIs für den Datenaustausch zur Verfügung.

• Communication System – Kommunikationssystem
• Communication User – Kommunikationsbenutzer
• Communication Scenario – Kommunikationsszenario
• Communication Arrangement – Kommunikationsvereinbarung

Communication System – Kommunikationssystem

Das Kommunikationssystem stellt das Herzstück der Verbindung dar. Es repräsentiert die Gegenpartei in der Kommunikation, zum Beispiel Systeme SAP Analytics Cloud oder SAP Datasphere.

Für eingehende (inbound) Kommunikation ist es das System, das Services aufruft, die von Ihrem System bereitgestellt werden. Aus Sicht von S/4HANA das Zielsystem, z.B. SAP Analytics Cloud, SAP Datasphere oder andere Systeme, die Daten von S/4HANA konsumieren.

Für ausgehende (outbound) Kommunikation ist es das System, das Services bereitstellt, die von Ihrem System aufgerufen werden. Aus Sicht von S/4HANA das Quellsystem, z.B. SAP Integration Suite, SAP Ariba oder andere Systeme, die Daten an S/4HANA liefern.

Das Kommunikationssystem wird in der App Communication Systems (App ID F1762) angelegt.

Bei dem Namen des Kommunikationssystems sollten Sie den Typ sowie die ID des Systems nutzen. Zum Beispiel SAC_CH_DEV

Die Authentifizierung der Kommunikation zwischen den Systemen erfolgt über einen Kommunikationsbenutzer.

Communication User – Kommunikationsbenutzer

Die Kommunikationssysteme nutzen Kommunikationsbenutzer, um sich für die Datenbereitstellung zu authentifizieren. Eine Datenübermittlung ist nur möglich, wenn das jeweilige System die von Ihnen hinterlegten Anmeldedaten verwendet. Dabei ist der Kommunikationsbenutzer einem Kommunikationssystem zugeordnet.

Die Kommunikationsbenutzer werden mithilfe der App Maintain Communication Users (App ID F1338) verwaltet.

Ich schlage folgende Namenskonvention für Kommunikationsbenutzer vor: <system>_<user inbound/outbound>

Zum Beispiel: SAC_CH_DEV_COM_IN

Communication Scenario – Kommunikationsszenario

Kommunikationsszenarien bündeln ein- und ausgehende APIs bzw. Services, die für bestimmte Prozesse erforderlich sind. Jede Kommunikationsvereinbarung muss auf einem Kommunikationsszenario basieren. Für alle Standard-APIs stellt SAP S/4HANA Cloud vordefinierte Kommunikationsszenarios bereit. Zum Beispiel für Finance.

Jedes API im SAP Business Accelerator Hub ist mit mindestens einem Kommunikationsszenario verknüpft. Zum Beispiel Company Code. Wenn Sie ein Standard-Kommunikationsszenario nicht im System sehen, müssen Sie prüfen, ob das entsprechende Scope-Item aktiviert ist. Darüber hinaus können Sie auch eigene CDS Views als APIs definieren.

Kommunikationsszenarien können in der App Display Communication Scenarios (App ID F3707) angezeigt werden.

Communication Arrangement – Kommunikationsvereinbarung

Kommunikationsvereinbarung verknüpft ein Kommunikationsszenario mit dem Kommunikationssystem. Das eingehende Kommunikationsvereinbarung definiert, wie Daten vom Kommunikationspartner (das Kommunikationssystem) empfangen werden, während die ausgehende Kommunikationsvereinbarung definiert, wie Daten an den Kommunikationspartner (das Kommunikationssystem) gesendet werden. Das Kommunikationsszenario legt die Berechtigungen, die ein- und ausgehenden Services sowie die unterstützten Authentifizierungsmethoden fest, die für die Kommunikation erforderlich sind.

Kommunikationsvereinbarungen werden in der App Communication Arrangements (App ID F1763) angelegt.

Ich schlage folgende Namenskonvention vor: <system>_<communication scenario>

Zum Beispiel SAC_CH_DEV_SAP_COM_0087

Ihre User beklagen sich über langsame Berichte?

• In meinem Newsletter lernen Sie, wie Sie Abhilfe schaffen.
• Entdecken Sie die Möglichkeiten der Performanceoptimierung.
• Praktische Anleitungen ermöglichen Ihnen schnelle Erfolge bei der Optimierung von SAP Systemen.
• Viele Tipps und Tricks zu SAP BI Themen.
• Holen Sie die maximale Performance aus Ihrem SAP BI!
• Bei der Anmeldung zu meinem Newsletter erhalten Sie das Buch „High Performance SAP BI“ als Willkommensgeschenk.

Jetzt anfordern!

Vorname

E-Mail *

* Pflichtfeld

 

Kein SPAM. Ich hasse Spam genau so wie du.