/datasphere-cli

name: datasphere-cli
description: SAP Datasphere CLI command reference with examples
allowed-tools:
  - Read
  - Bash
argument-hint: "<auth|spaces|objects|tasks|users|marketplace>"
arguments:
  - name: command
    description: "Command category: auth, spaces, objects, tasks, users, marketplace"
    required: true

Shell Snippet Notes

• Shell snippets assume Bash on Linux/macOS, WSL2, or Git Bash.
• Install the command-specific tooling shown near each snippet before running it.
• Confirm before running commands that delete files, change ownership, deploy, or modify remote systems.

Output Contract

Return the relevant Datasphere CLI command set, authentication assumptions, safe read-only examples first, and tenant actions that require confirmation. Do not execute mutating CLI commands by default.

Generate CLI command reference for the specified category.

Available Command Categories

auth

Authentication and configuration setup

spaces

Space management operations

objects

Modeling object operations (views, tables, flows)

tasks

Task and task chain management

users

User and role management

marketplace

Data Marketplace operations

---

Reference: auth

Authentication & Configuration

Install CLI

# Install globally via npm
npm install -g @sap/datasphere-cli

# Verify installation
datasphere --version

Initial Configuration

# Configure CLI with interactive prompts
datasphere configure

# Or set directly
datasphere configure set tenant-url https://your-tenant.eu10.hcs.cloud.sap
datasphere configure set oauth-client-id your-client-id
datasphere configure set oauth-client-secret your-client-secret
datasphere configure set oauth-token-url https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token

Login

# Interactive login
datasphere login

# Login with specific profile
datasphere login --profile production

# Check current session
datasphere login status

Configuration Management

# View all configuration
datasphere configure list

# View specific setting
datasphere configure get tenant-url

# Use environment variables (alternative)
export DATASPHERE_TENANT_URL=https://your-tenant.eu10.hcs.cloud.sap
export DATASPHERE_OAUTH_CLIENT_ID=your-client-id
export DATASPHERE_OAUTH_CLIENT_SECRET=your-client-secret

Profile Management

# Create named profile
datasphere configure --profile dev
datasphere configure --profile prod

# Switch profiles
export DATASPHERE_PROFILE=prod

# Or use per-command
datasphere spaces list --profile prod

---

Reference: spaces

Space Management Commands

List Spaces

# List all spaces (if admin)
datasphere spaces list

# List spaces with details
datasphere spaces list --output json

# Filter by name pattern
datasphere spaces list --filter "DEV*"

Get Space Details

# Get specific space
datasphere spaces read --space DEV_PROJECT

# Get space configuration
datasphere spaces read --space DEV_PROJECT --output json > space-config.json

Create Space

# Create new space
datasphere spaces create \
  --space-id "DEV_ANALYTICS" \
  --space-name "Development Analytics" \
  --disk-storage 100 \
  --memory 32

# Create with full options
datasphere spaces create \
  --space-id "PROD_SALES" \
  --space-name "Production Sales" \
  --disk-storage 500 \
  --memory 128 \
  --priority 2 \
  --allow-public-objects true

Update Space

# Update storage allocation
datasphere spaces update \
  --space DEV_PROJECT \
  --disk-storage 200

# Update priority
datasphere spaces update \
  --space DEV_PROJECT \
  --priority 3

# Update multiple settings
datasphere spaces update \
  --space DEV_PROJECT \
  --disk-storage 200 \
  --memory 64 \
  --priority 2

Space User Management

# List users in space
datasphere spaces users list --space DEV_PROJECT

# Add user to space
datasphere spaces users add \
  --space DEV_PROJECT \
  --user user@company.com \
  --role "DW Modeler"

# Remove user from space
datasphere spaces users remove \
  --space DEV_PROJECT \
  --user user@company.com

# Available roles:
# - DW Space Administrator
# - DW Modeler
# - DW Integrator
# - DW Viewer

Delete Space

# Delete space (requires confirmation)
datasphere spaces delete --space SANDBOX_TEST

# Force delete (careful!)
datasphere spaces delete --space SANDBOX_TEST --force

---

Reference: objects

Modeling Object Commands

List Objects

# List all objects in space
datasphere objects list --space DEV_PROJECT

# List by object type
datasphere objects list --space DEV_PROJECT --type view
datasphere objects list --space DEV_PROJECT --type local-table
datasphere objects list --space DEV_PROJECT --type data-flow

# List with filter
datasphere objects list --space DEV_PROJECT --filter "fact_*"

# Output as JSON
datasphere objects list --space DEV_PROJECT --output json

Read Object Definition

# Get object definition
datasphere objects read \
  --space DEV_PROJECT \
  --technical-name fact_sales

# Export to file (CSN/JSON format)
datasphere objects read \
  --space DEV_PROJECT \
  --technical-name fact_sales \
  --output json > fact_sales.json

Create/Update Objects

# Create object from definition file
datasphere objects create \
  --space DEV_PROJECT \
  --definition-file ./views/fact_sales.json

# Update existing object
datasphere objects update \
  --space DEV_PROJECT \
  --technical-name fact_sales \
  --definition-file ./views/fact_sales_v2.json

Deploy Objects

# Deploy single object
datasphere objects deploy \
  --space DEV_PROJECT \
  --technical-name fact_sales

# Deploy with dependencies
datasphere objects deploy \
  --space DEV_PROJECT \
  --technical-name fact_sales \
  --include-dependencies

Delete Objects

# Delete object
datasphere objects delete \
  --space DEV_PROJECT \
  --t