Analytics Legends Die Wissensplattform für SAP Analytics
Academy-Modul

Datasphere CLI & APIs

Datasphere CLI and API promotion pipeline: DEV space to TEST space via CLI export, Git review, CLI import and an OAuth client-credentials token, then a manual approval gate to PROD space — architecture diagram for Datasphere CLI & APIs, Analytics Legends Academy module M013

Stand 2026-09-03

Bei Datasphere CLI & APIs hört ein Datasphere-Projekt auf, von einer Person abzuhängen, die sich durch die UI klickt, und verhält sich wie Software: versioniert, wiederholbar, auditierbar. Das Liefergut, das dieses Modul rechtfertigt, ist die Content-Package-Promotion-Pipeline DEV→TEST→PROD, die manuellen Export/Import durch einen Git-geprüften, automatisierten Lauf von fünf Minuten statt eines Tages UI-Klicken ersetzt. Zwei Fehlerbilder entscheiden, ob diese Pipeline den Produktivbetrieb übersteht: die Rotation der OAuth-Client-Credentials (Tokens laufen nach 3.600 Sekunden ab) und das undokumentierte Rate Limit von ~50 Aufrufen pro Minute, das bei Massenoperationen 429-Fehler auslöst. Ein Berater, der dieses Muster in Woche eins liefert, macht aus einem wiederkehrenden manuellen Engpass einen Fünf-Minuten-Pipeline-Schritt — genau die Automatisierungsgeschichte, die einen erfahrenen Tagessatz im Scope-Gespräch rechtfertigt.

Was Sie lernen

  • Die Kernkonzepte hinter Datasphere CLI & APIs verstehen
  • CLI in einem typischen SAP-Analytics-Projekt anwenden
  • Die 3-5 häufigsten Fehler erkennen und wissen, wie man sie vermeidet
  • Diese Fähigkeit in der eigenen Personal Brand und im Tagessatzgespräch positionieren

Datasphere CLI and REST APIs: Automation, CI/CD, and When to Script

SAP Datasphere liefert ein Command-Line-Interface und eine REST-API-Ebene mit, die die meisten Praktiker unternutzen. Der Standard-Arbeitsmodus in Datasphere-Projekten ist die browserbasierte UI: Modellierer bauen Views im Data Builder, Fachanwender konfigurieren semantische Ebenen im Business Builder, und Administratoren verwalten Spaces und Benutzer über die UI-Konsole. Das funktioniert für eine Lieferung mit einem Team und einer Umgebung ausreichend. Es bricht zusammen, sobald Multi-Umgebungs-Promotion, wiederholbare Deployments, automatisierte Tests oder ein Projekt mit mehr als fünf parallel arbeitenden Entwicklern hinzukommen. Es folgt: das CLI- und API-Tooling im Detail — was es kann und nicht kann, das Authentifizierungsmodell, konkrete Automatisierungsmuster und die Abwägungen zwischen skriptgesteuerten und UI-basierten Operationen.

Das Datasphere-CLI

Das Datasphere-CLI (datasphere) ist ein Node.js-basiertes Kommandozeilenwerkzeug, das über npm vertrieben wird. Das CLI folgt der kalenderbasierten Release-Versionierung von SAP Datasphere (z. B. verfolgen 2026.x-Releases den Release-Rhythmus des Tenants) und ist die primäre Automatisierungsschnittstelle auf Operator-Ebene für Datasphere.

Installation:

npm install -g @sap/datasphere-cli
datasphere --version

Das CLI benötigt Node.js 18+ und arbeitet gegen einen Datasphere-Tenant über OAuth-2.0-Client-Credentials oder interaktiven browserbasierten Login. In CI/CD-Kontexten werden immer Client Credentials verwendet.

Voraussetzungen

  • Mittlere praktische Erfahrung in SAP-Analytics-Projekten
  • Zunächst die Kernkonzepte durcharbeiten: C008, C006, C005

Lernergebnisse

  • Ein realistisches Szenario durcharbeiten: Ein mittelgroßer Industrieausrüstungshersteller betreibt einen gemeinsamen Datasphere-Tenant über drei Werke hinweg und skaliert sein Analytics-Team von 4 auf 12 Entwickler.
  • Das Antimuster erkennen und vermeiden: OAuth-client_id/client_secret hart in der Pipeline-YAML codieren — Die Credential gilt als kompromittiert, sobald sie in der Git-Historie landet.
  • Die Kernentscheidung des Moduls anwenden: Die Operation skripten oder die UI nutzen? — Skripten wählen für Promotion, Massen-Space-/Benutzer-Provisionierung und Replication-Flow-Monitoring.
  • Beherrschung mit dem KPI verfolgen: Promotion-Zykluszeit (DEV — TEST) (Ziel: < 10 Minuten vom Merge bis zum Import; Warnsignal: > 1 Stunde, oder ein Mensch muss den Lauf beaufsichtigen — die Promotion ist nicht wirklich automatisiert).

Vollständiges Modul für Mitglieder. Das vollständige Modul ergänzt: den Entscheidungsrahmen · das durchgehende Szenario · die KPI-Scorecard · die Anti-Muster · die Codeblöcke · die Wissenskontrolle · die Schemata.

In der App öffnen →