> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dqlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipelines

> Internal reference for Synapse pipeline observability: permissions, what Prizm collects, and troubleshooting. Not yet available.

> [!WARNING]
>
> Synapse pipeline observability is not implemented yet. This page is internal and records the planned design. It is not part of the released Synapse connector, which covers Dedicated SQL pools and Serverless SQL. See [Azure Synapse overview](https://docs.dqlabs.ai/sources/synapse/overview.md).

## Planned scope

Prizm would catalog Synapse pipelines, activities, triggers, and data flows, monitor run status, duration, and failures, and derive table-level lineage from Copy and Data Flow activities.

## Planned permissions

Pipeline permissions are Synapse RBAC roles, assigned in Synapse Studio under **Manage → Access control → Add**, at workspace scope. The Azure portal doesn't assign them, and Azure Owner or Contributor doesn't grant them. The Azure **Reader** role on the workspace is also needed, because Pipelines and the Monitoring Hub use the Azure Resource Manager API.

| Role | Purpose |
| :- | :- |
| Synapse Artifact User | Read pipelines, activities, data flows, triggers, and linked services |
| Synapse Monitoring Operator | Read pipeline, activity, and trigger runs |

```bash theme={null}
az synapse role assignment create --workspace-name <workspace> \
  --role "Synapse Artifact User" --assignee <client-id-or-principal-id>
az synapse role assignment create --workspace-name <workspace> \
  --role "Synapse Monitoring Operator" --assignee <client-id-or-principal-id>
```

Prizm would need to reach `<workspace>.dev.azuresynapse.net` on port 443. SQL authentication does not apply to pipelines.

## Planned collection

| Synapse object | What Prizm would store |
| :- | :- |
| Pipeline | Pipeline, with its folder, annotations, owner, schedule, last run and status, and activity list |
| Activity | Child of its pipeline |
| Trigger | Schedule metadata |
| Data flow | Child of its pipeline |
| Pipeline runs | Status, duration, activity-level failures, and triggers that have stopped firing |

## Planned troubleshooting

| Symptom | Likely cause |
| :- | :- |
| Pipelines aren't listed | **Synapse Artifact User** is missing, or was granted in Azure instead of Synapse Studio |
| Pipeline runs are missing | **Synapse Monitoring Operator** is missing |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.