> For the complete documentation index, see [llms.txt](https://docs.redivis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.redivis.com/reference/workflows/data-sources.md). # Data sources A data source node contains data across Redivis that you want to work with and have access to. These are usually [datasets](/reference/datasets.md) but can also be other workflows. These nodes display overview information about the dataset or workflow it represents, and a list of the tables it contains. You can choose any table to view its contents, or select **Transform** to build a transform on it.

## Adding data source nodes to a workflow Adding a data source to a workflow will make a copy of that dataset or workflow in the form of a circular node at the top of the workflow tree. You can add data to the workflow by: * Selecting **+** **Add data** in the toolbar of any workflow. * Selecting **Analyze in workflow** on a dataset page. * Selecting **Fork** in the toolbar of any workflow. #### Restrictions Workflows cannot contain two copies of the data source or the same version of the same dataset. You can add a different version of the dataset to your workflow by right clicking the dataset name in the **+ Add data** modal. ## Datasets as a data source [Datasets](/reference/datasets.md) are the most common data source added to workflows. They contain data in the original state curated by the data owner. They typically contain one or more tables that can be transformed or analyzed in a notebook. #### Dataset samples Some large datasets have 1% [samples](/reference/datasets/samples.md), which are useful for quickly testing querying strategies before running transforms against the full dataset. If a 1% sample is available for a dataset, it is added to workflows by default instead of the full sample. Samples are indicated by the dark circle icon to the top left of a dataset node in the left panel and in the list of the dataset's tables. All sampled tables in a dataset are sampled on the same variable with the same group of values, so joining two tables in the same dataset with 1% samples will still result in a 1% sample. To switch to the full sample, select **Sampling** in the menu bar with a dataset selected. Your downstream transforms and tables will become stale, since an upstream change has been made. Run these nodes individually or use the run all functionality by selecting the workflow's name in the top menu bar to update their contents. #### Dataset versions When a new [version](/reference/datasets/versions.md) of a dataset is released by an administrator, the corresponding dataset node on your workflow tree will become purple. To upgrade the dataset's version, select **Version** in the menu bar when you have a dataset selected. You can view version diffs and select whichever version you want to use here. After updating, your downstream transforms and tables will become stale. Run these nodes individually or use the run all functionality by selecting the workflow's name in the top menu bar to update their contents. ## Workflows as a data source [Workflows](/reference/workflows.md) can be added to another workflow to build off existing analysis. You might want to continue an analytical pipeline that you've built elsewhere, or elaborate on someone else's analysis. You will have access to all tables this workflow contains. {% hint style="info" %} All workflow data sources are linked to their original workflow and will automatically update with any changes made to the original. {% endhint %} ## Data source node states As you work in a workflow, nodes colors and symbols will change on the tree view to help you keep track of your work progress.

State	Display	Details
Dataset type	Dataset icon in the middle of the circle	This data source is a copy of a dataset on Redivis.
Workflow type	Workflow icon in the middle of the circle	This data source is a copy of another workflow on Redivis.
Sampled	Black circle with 1% icon	Only possible for dataset source nodes. This means that you are using a 1% sample of the data. When a dataset has a sample, it defaults to it when added to a workflow. You can change this to the full sample and back at any time in the dataset node
Outdated version	Purple background on version number	Only possible for dataset source nodes. For datasets this means that you are not using the latest version. This means that you have either intentionally switched to using an older version, or that this dataset's administrator has released a new version you can switch to.
Incomplete access	All black background, or dashed borders	You don't have full access the node. Select Incomplete access in the top bar to apply for access to the relevant datasets.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.redivis.com/reference/workflows/data-sources.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.