run_task_chain
Execute an ETL pipeline, data refresh, or synchronization job in a specified space. Returns a log ID to track asynchronous execution status.
Instructions
Execute a task chain in SAP Datasphere and get a log ID for tracking.
Use this tool when:
User asks to "Run the ETL pipeline" or "Execute task chain X"
Triggering scheduled data loads or transformations
Starting data replication or synchronization jobs
Automating data refresh workflows
Executing orchestrated data pipelines
What happens:
Task chain execution is initiated immediately
Returns a logId to track the execution status
Task runs asynchronously (use get_task_log to check status)
All child tasks in the chain are executed in order
Required parameters:
space_id: The space containing the task chain (e.g., 'SALES_SPACE')
object_id: The task chain name/ID (e.g., 'Daily_ETL_Pipeline')
What you'll get:
logId: Unique identifier to track this execution
Use get_task_log(space_id, logId) to monitor progress
Use get_task_history(space_id, object_id) to see all runs
Example queries:
"Run the Daily_ETL_Pipeline in SALES_SPACE"
"Execute task chain Customer_Sync in FINANCE_SPACE"
"Trigger the data refresh pipeline in ANALYTICS"
"Start the nightly batch job in DWH_SPACE"
Important notes:
Task chains run asynchronously - tool returns immediately
Check status with get_task_log using the returned logId
Requires appropriate permissions to run task chains
Failed runs can be investigated with detailed logs
Workflow example:
Run task chain: run_task_chain(space_id='SALES', object_id='Daily_ETL')
Get logId from response (e.g., 2295172)
Check status: get_task_log(space_id='SALES', log_id=2295172)
View details: get_task_log(space_id='SALES', log_id=2295172, detail_level='detailed')
Note: Uses API: POST /api/v1/datasphere/tasks/chains/{space_id}/run/{object_id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| space_id | Yes | The space ID containing the task chain (e.g., 'SALES_SPACE', 'FINANCE'). Must be uppercase. | |
| object_id | Yes | The task chain name/identifier to execute (e.g., 'Daily_ETL_Pipeline', 'Customer_Sync'). |