Nachfolgend finden Sie eine Übersicht der notwendigen Schritte:

• Voraussetzungen
• Databricks Connection Identifier erhalten
• BDC Connect Provision
• Verbindung in Databricks abschließen
• BDC Connect zur Formation hinzufügen
• Datenprodukt teilen
• Datenprodukt in den Databricks Katalog aufnehmen
• Mit Databricks Assets verknüpfen
• In Power BI anzeigen

Voraussetzungen

Stellen Sie sicher, dass Ihr Benutzer alle benötigten Berechtigungen hat. Führen Sie die Folgende SQL Query aus. Ersetzen Sie dabei die Email durch Ihre eigene.

GRANT CREATE PROVIDER ON METASTORE TO `denis.reis@email.ch`;
GRANT CREATE RECIPIENT ON METASTORE TO `denis.reis@email.ch`;
GRANT USE RECIPIENT ON METASTORE TO `denis.reis@email.ch`;
GRANT USE PROVIDER ON METASTORE TO `denis.reis@email.ch`;
GRANT CREATE CATALOG ON METASTORE TO `denis.reis@email.ch`;

Darüber hinaus sollte ihr Workspace Unity Catalog und OpenSharing unterstützen. Was wohl bei meisten standardmäßig der Fall ist. Weitere Voraussetzungen können Sie unter Databricks Doku und SAP Hilfe nachlesen. Ich hatte vielmehr mit Berechtigungen zu kämpfen.

Databricks Connection Identifier erhalten

Wählen Sie zunächst in Databricks den Eintrag Data Ingestion im Menü aus.

Suchen Sie anschließend nach SAP Business Data Cloud und wählen Sie die entsprechende Kachel aus.

Klicken Sie auf Connection Identifier und speichern Sie diesen ab. Wir werden diesen im nächsten Schritt brauchen.

BDC Connect Provision

Nun müssen wir über SAP for Me eine BDC Connect Instanz bereitstellen. Folgen Sie dem Menüpfad Portfolio & Products → My Products & Packages und Wählen Sie Business Data Cloud aus.

Wählen Sie anschließend Applications aus und klicken Sie bei SAP BDC Connect auf Start Provisioning.

Vergeben Sie einen Namen und weisen Sie einen Pfad zu.

Weisen Sie anschließend Capacity Units zu.

Kopieren Sie im nächsten Schritt den Databricks Connection Idenfier rein und wählen Sie die Region von SAP BDC aus (nicht von Databricks).

Überprüfen Sie anschließend die Einstellungen und klicken Sie auf Finish.

Nun wird die Verbindung eingerichtet. Clicken Sie auf Open Tenant notification und kopieren Sie die dargestellte URL.

Verbindung in Databricks abschließen

Wechseln Sie nun zurück zu Databricks und klicken Sie auf Connect to SAP BDC.

Fügen Sie die zuvor kopierte URL ein und klicken Sie auf Connect.

Anschließend wird eine Erfolgsmeldung angezeigt.

BDC Connect zur Formation hinzufügen

Wechseln Sie nun zurück zu SAP for Me und folgen Sie dem Menüpfad Customer Landscape – Formations – Include Systems.

Wählen Sie das zuvor angelegte SAP BDC Connect System aus.

Klicken Sie anschließend auf Include.

Synchronisieren Sie die Formation neu.

Datenprodukt teilen

Öffnen Sie nun SAP BDC Cockpit, wählen Sie Catalog & Marketplace Menüeintrag aus und suchen Sie nach dem Datenprodukt Ihrer Wahl. Klicken Sie anschließend auf das Teilen Symbol. Das Datenprodukt muss davor über das Menü Intelligent Content and Data Packages installiert werden.

Klicken Sie auf den Add Target Button.

Wählen Sie BDC Connect als das Zielsystem aus.

Klicken Sie anschließend auf Share.

Nun ändert sich der Status auf Share in progress.

Anschließend kann das Datenprodukt in Databricks genutzt werden.

Der Status des Datenprodukts ändert sich auf Shared.

Datenprodukt in den Databricks Katalog aufnehmen

Nun müssen Sie das Datenprodukt in den Databricks Katalog aufnehmen.

Gehen Sie zu Catalog und Settings → OpenSharing.

Wählen Sie den BDC Connect Provider aus.

Klicken Sie nun auf Mount to catalog Schaltfläche.

Wählen Sie den bestehenden Katalog aus oder legen Sie ein neues an.

Nun wird das Datenprodukt im Katalog veröffentlicht.

Unter Shares received können Sie es ganz normal auswählen.

Sie können die Tabelle auswählen und Daten anzeigen.

Mit Databricks Assets verknüpfen

Nun können Sie die SAP Daten für das Machine Learning in Databricks verwenden. In unserem Beispiel legen wir eine neue Tabelle an und füllen diese mit einem Gesundheitsindikator pro Buchungskreis.

Anschließend verknüpfen wir die geteilte Tabelle mit der Databricks Tabelle über einen Join. Um die Performance zu verbessern, materialisieren wir diesen.

CREATE MATERIALIZED VIEW playground.default.company_cashflow_health
SCHEDULE EVERY 1 HOUR
AS
SELECT 
    c.CompanyCode,
    h.FinancialHealth,
    SUM(c.AmountInGlobalCurrency) AS TotalAmountInGlobalCurrency,
    COUNT(c.CashFlowID) AS NumberOfTransactions
FROM cashflow_bdc.cashflow.cashflow c
LEFT JOIN playground.default.company_code_health_indicator h
    ON c.CompanyCode = h.CompanyCode
GROUP BY c.CompanyCode, h.FinancialHealth

In Power BI anzeigen

Nun können Sie das Ergebnis in Power BI anzeigen lassen.

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.

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>",
    "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