Skip to main content

Pipelines

In Prophecy, data pipelines are designed to facilitate efficient data movement and transformation. In SQL projects, these pipelines execute within a Prophecy fabric that orchestrates operations using Prophecy Automate in conjunction with your chosen SQL warehouse.

Pipeline creation

To create a new pipeline, navigate to the Create Entity page in the left sidebar. You can also create pipelines directly within an open project.

The following table describes the parameters you must provide when you create a pipeline.

ParameterDescription
ProjectThe project where the pipeline will live.
Pipeline nameThe name that identifies the pipeline.
Directory pathThe file path where this pipeline information will be stored in the project Git repository.
The default location is the pipelines directory.

Project editor

When you build a pipeline, it helps to be familiar with the project editor interface. The following sections describe each area of the project editor.

The project sidebar includes the following elements:

FieldDescription
Project BrowserAllows you to browse through all of your existing pipelines and manage different components of your project, such as gems, tables, and functions.
Environment BrowserProvides access to the various data sources and connections that have been configured in your fabric.

Canvas

The canvas includes the following elements:

FieldDescription
CanvasA workspace where you can add and connect various gems to build your pipeline.
It provides a drag-and-drop interface for designing your data flow.
Gem DrawerA toolbox that contains all the available gems, organized by gem category, that you can use in your pipeline.
Run ButtonA button to trigger interactive pipeline execution.
This allows you to test and run the pipeline in real-time, which makes it easier to troubleshoot and verify the pipeline's performance before deployment. To learn more, visit Execution.
CopilotAn AI-powered assistant that helps build your pipeline.
Copilot can generate gems for you or fix diagnostic errors, making it easier to create complex workflows.

The project header includes the following elements:

FieldDescription
Parameter:Defines dynamic pipeline parameters that control how your pipeline behaves.
Pipeline Options MenuAccesses various settings and metadata for your pipeline.
It allows you to configure things like execution frequency, project dependencies, and other project-specific settings.
Visual/Code ToggleSwitch to the code view to see your visually-developed pipeline compiled into raw code.
This view helps users who prefer working with code to understand the underlying logic.
Version MenuIf you create your project using the simple Git storage model, you will see the version menu in the project header.
Use this menu to save your project, publish your project, or view your project history.

The project footer includes the following elements:

FieldDescription
DiagnosticsHighlights any issues or errors in your pipeline that need attention.
It provides detailed feedback on what needs to be fixed to ensure that your pipeline runs successfully.
Runtime LogsOffers detailed insights into the status and progress of your pipeline executions.
They show real-time information, errors, and other diagnostic messages, which helps you monitor and troubleshoot the pipeline's performance.
Git WorkflowIf you create your project using the normal Git storage model, you will see the Git workflow in the project footer.