Errors

Validation and import exceptions raised by the library.

fabric_data_pipelines.PipelineValidationError

Bases: ValueError

Base class for pipeline validation failures.

fabric_data_pipelines.DuplicateActivityNameError

Bases: PipelineValidationError

Raised when two activities share the same name.

Example message::

Duplicate activity name 'copy_table'. Activity names must be unique
across the entire pipeline (including nested scopes).

fabric_data_pipelines.CyclicDependencyError

Bases: PipelineValidationError

Raised when activity dependencies form a cycle.

Example message::

Cyclic dependency detected: a -> b -> a.

fabric_data_pipelines.UnknownDependencyError

Bases: PipelineValidationError

Raised when an activity depends on a name that does not exist.

Example message::

Activity 'copy_table' depends on unknown activity 'missing'.

fabric_data_pipelines.CrossScopeDependencyError

Bases: PipelineValidationError

Raised when an activity depends on a name from a different scope.

Fabric resolves dependsOn only within the same activity list (top-level or a single nested activities / ifTrueActivities block). Cross-scope references are accepted by the UI but fail at runtime.

Example message::

Activity 'inner_copy' depends on 'outer_lookup' which exists in a
different scope. Dependencies must target activities in the same scope.

fabric_data_pipelines.ScheduleValidationError

Bases: PipelineValidationError

Raised when constructing a Fabric pipeline schedule fails validation.

fabric_data_pipelines.InvalidChoiceError

Bases: PipelineValidationError

Raised when a value is not in a known finite set of allowed choices.

Example message::

Unknown dataset 'LakehouseTable' for source 'SqlMISource'. Valid
datasets: `AzureSqlMITable`, `AzureSqlTable`.

fabric_data_pipelines.PipelineImportError

Bases: ValueError

Raised when parsing Fabric pipeline JSON or item folders fails.