# Introduction to CARTO Workflows

## What is CARTO Workflows

CARTO Workflows is a visual modeling tool that allows you to create multi-step analyses without writing any code. With Workflows, you can orchestrate complex spatial analyses with as many steps as needed which can be edited, updated, duplicated, and run as many times as needed. 

<figure><img src="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FWfiovOCUAwnGRibF9E8A%2Fspaces_ybPdpmLltPkzGFvz7m8A_uploads_6Gp0ihz88Cl5K4YJZaZS_22.webp?alt=media&#x26;token=69e658a1-d093-4fc0-9a9b-9ade2efc8075" alt=""><figcaption></figcaption></figure>

## Why Workflows?

Workflows is completely cloud-native, which means that behind the scenes Workflows compiles native SQL to your data warehouse or database and runs the Workflow directly within the database or data warehouse. What does this mean for you?

* Speed: Since Workflows uses native SQL in the data warehouse, the speed of your analysis is comparable to running the analysis directly on the data warehouse itself. For example, a spatial point in polygon count of US Counties (3k+ polygons) to 26 million+ points can take \~6 seconds to run (depending on your infrastructure)
* No data transfer: Your data never leaves your data source. This means that compared to other tools that take data out of the source, the performance boosts are massive, and you ensure your data remains in the same place
* Faster analysis: You can assemble and modify analyses much faster than writing SQL and you can automate repetitive tasks
* Lower costs: In nearly all cases, Workflows is a lower-cost analysis method compared to other desktop-based tools

Our goal with Workflows is to bring the power of spatial SQL to a much larger audience including GIS Analysts, Data Analysts, and Business Users who can now create complex spatial analysis without writing code. It reduces the need of specialist knowledge and for those specialists, they can now automate the repetitive tasks and focus on more complex and valuable analytical tasks.

## Workflows UI elements

Before we jump into workflow's tutorials and templates, let's take a quick look of the Workflows interface so you know your way around before getting started.

### Canvas

First is the Canvas where you will design your Workflow. This is a free-form Canvas meaning you can drag nodes onto any part of the canvas. You can zoom in and out to see different parts of your workflow and see the layout of the workflow in the mini viewer in the lower right corner. As you add nodes to the canvas they will snap to a grid to align.

<figure><img src="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FBOYoeNSHmwOczbXs4hwJ%2FCanvas.png?alt=media&#x26;token=909907ac-ed4e-4f07-a059-ea8035380112" alt=""><figcaption></figcaption></figure>

### Sources & Components panel

On the left side, you will find a menu where you can add data sources from the connection you created the Workflow. You can add any data source that you want that exists in your connection. You also have all the components, or nodes, that you can add to the canvas. You can search for components or scroll to find the component you want.

<figure><img src="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FnslvKCVf26Gdf1U8KAZi%2FComponents.png?alt=media&#x26;token=ceb1d5fe-9893-4b47-be72-6f8256f4a799" alt=""><figcaption></figcaption></figure>

### Results panel

The bottom panel is the results space where you will see four different tabs:

* Messages: Messages about the status of your Workflow including success and error messages.
* Data: After clicking on a node, you can see the tabular data outputs of that specific workflow step.
* Map: After clicking on a node, if that step returns a valid geometry, it will show up in the map. If there is more than one geometry you will have an option to pick which one to show.
* SQL: The compiled SQL of the workflow. This includes different steps and procedural language.

<figure><img src="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FjAvffdhteH6Lffe7H8sp%2FResults.png?alt=media&#x26;token=9489f9ba-7349-449c-bb6c-ff9d025a4e7f" alt=""><figcaption></figcaption></figure>

***

## Resources in CARTO Academy&#x20;

In order to accelerate your onboarding to CARTO and get you ready to get the most out of Workflows for your day-to-day data pipeline and analytics, we have carefully curated a set of detailed step-by-step tutorials and workflow templates, from basic introductory ones to others covering more advanced and industry-specific use-cases.&#x20;

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td><strong>Step-by-step tutorials</strong></td><td>In this section we provide a set of tutorials with step-by-step instructions for you to learn how to perform different spatial analysis examples with CARTO Workflows.</td><td><a href="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FdLKxJdewTA4w9cYHLHU6%2Fspaces_ybPdpmLltPkzGFvz7m8A_uploads_nMRAvTQm59aJ5disAs4a_workflows_ex2_importurl.webp?alt=media&#x26;token=eda98c82-0011-49b7-8f30-e319021bea39">spaces_ybPdpmLltPkzGFvz7m8A_uploads_nMRAvTQm59aJ5disAs4a_workflows_ex2_importurl.webp</a></td><td><a href="step-by-step-tutorials">step-by-step-tutorials</a></td></tr><tr><td></td><td><strong>Workflow templates</strong></td><td>Drag &#x26; drop our workflow templates into your application to get you started in a wide range of scenarios and applications, from simple building blocks for your data pipeline to industry-specific geospatial use-cases.</td><td><a href="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FHpYN0gPmLAkgpU1LlDgq%2FScreenshot%202023-10-17%20at%2017.37.20.png?alt=media&#x26;token=83a8b45e-db72-453e-b2bd-27176edbdd57">Screenshot 2023-10-17 at 17.37.20.png</a></td><td><a href="workflow-templates">workflow-templates</a></td></tr></tbody></table>

***

## Keep learning...

Deep dive in some of the advanced features available in CARTO Workflows to ensure you get the most out of this tool by reading the specifications in our [Product Documentation](https://docs.carto.com/carto-user-manual/workflows).

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Workflow components</strong></td><td>Find the list and reference of all components available in CARTO Workflows in our product documentation.</td><td></td><td><a href="https://docs.carto.com/carto-user-manual/workflows/components">https://docs.carto.com/carto-user-manual/workflows/components</a></td><td><a href="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FJ9lRn16VpyTs2aVIUGxE%2FCaptura%20de%20pantalla%202023-11-29%20a%20las%2019.20.14.png?alt=media&#x26;token=e4593a03-9056-4409-95ff-0ee864893076">Captura de pantalla 2023-11-29 a las 19.20.14.png</a></td></tr><tr><td><strong>Scheduling workflows</strong></td><td>Learn how to schedule periodic executions of your workflows to keep your results always up to date.</td><td></td><td><a href="https://docs.carto.com/carto-user-manual/workflows/how-to-schedule-a-workflow">https://docs.carto.com/carto-user-manual/workflows/how-to-schedule-a-workflow</a></td><td><a href="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FjnqVdyRuutt1Kr1bKnTj%2FCaptura%20de%20pantalla%202023-11-29%20a%20las%2019.13.37.png?alt=media&#x26;token=5206d168-1785-4108-8f89-40ca1fc95f73">Captura de pantalla 2023-11-29 a las 19.13.37.png</a></td></tr><tr><td><strong>Executing workflows via API</strong></td><td>Learn how to execute a workflow via an API call to integrate it in your processes.</td><td></td><td><a href="https://docs.carto.com/carto-user-manual/workflows/executing-workflows-via-api">https://docs.carto.com/carto-user-manual/workflows/executing-workflows-via-api</a></td><td><a href="https://3015558743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFEElAdsRIl9DzfMhbRlB%2Fuploads%2FAnDqQWhptqUvDevnQpWy%2FCaptura%20de%20pantalla%202023-11-29%20a%20las%2019.16.36.png?alt=media&#x26;token=03395d97-6112-4c37-9dc6-9767f39ec9d3">Captura de pantalla 2023-11-29 a las 19.16.36.png</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.carto.com/creating-workflows/introduction-to-carto-workflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.