---
title: "Create a Dataset with a DAT Connector"
slug: "create-a-dataset-with-a-dat-connector"
tags: ["Connector", "DAT", "Create ", "field mapping", "fields", "queue", "dataset"]
updated: 2025-04-25T06:43:07Z
published: 2025-04-25T06:43:07Z
canonical: "docs.revealdata.com/create-a-dataset-with-a-dat-connector"
---

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

# Create a Dataset with a DAT Connector

This procedure describes how to add a dataset with a DAT connector.

> [!NOTE]
> **Note**
> 
> Before adding a dataset with a DAT connector, the DAT files must be added to a new or existing folder in the Builds folder on the Analytics (Build) server root directory, and the DAT connector must exist in the Connectors pane (see [***Create and Manage a Connector***](/brainspace/docs/create-and-manage-a-connector)).

We recommend limiting your DAT file to no more than 3GB to 4GB in size and using external text paths for larger document populations or very large documents. This will provide a more efficient DAT format for ingest and quickly identify any overly large documents that may need to be filtered or excluded prior to loading.

To add a dataset with a DAT connector:

1. In the user drop-down menu, click **Administration**:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-a-dataset-with-a-dat-connector-image-rtafk4nz.jpg)
2. The Datasets page will open.
3. In the Datasets screen, click the **Add Dataset** button:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-a-dataset-with-a-dat-connector-image-e6oaxt5x.png)

The New Dataset dialog will open.
4. In the New Dataset dialog, type a **Dataset Name**, and then toggle switches in the **Dataset Groups** pane to add the new dataset to one or more groups:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-a-dataset-with-a-dat-connector-image-umxm61h6.jpg)
5. Click the **Create** button.

The Dataset Settings dialog will open.
6. Click the **Choose Connector** button:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-a-dataset-with-a-dat-connector-image-9jjd6d5m.png)
7. The Choose Connector dialog will open.
8. In the Choose Connector dialog, click the appropriate DAT connector in the list.

The Select a Source dialog will open.
9. In the Select a Source dialog, click the folder that contains the DAT documents, and then click the **Save and Proceed** button.

The DAT Source dialog will open.
10. In the DAT Source dialog, click the **Browse** button.

The Select File for Path to DAT File dialog will open.
11. Select a file, and then click the **Select File** button.

The DAT Source dialog will refresh.
12. Click the **Proceed** button.

The License Checks dialog will open and run a check on your license document limits.
13. After Brainspace verifies the license document limits, click the **Proceed** button.

The Field Mapping dialog will open.
14. Map the required fields and any additional fields, and then click the **Continue** button.

The Dataset Settings dialog will refresh.

> [!NOTE]
> **Note**
> 
> For information about mapping fields, see [***Field Mapping Categories and Definitions***](/brainspace/docs/field-definitions).
15. Verify the settings, click the **Save** button, and then click the **Build** button.

The Dataset Build Options dialog will open.
16. Choose a build option, and then click the **Run This Build Type** button.

The Schedule Build dialog will open.
17. Click the **Build as soon as possible** button.

> [!NOTE]
> **Note**
> 
> If you choose to build the dataset in the future, click the Schedule Build Time field, select a date and time, and then click the Save button.
18. The Datasets page will refresh and show the Dataset Queue build in progress:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-a-dataset-with-a-dat-connector-image-i50oeyk5.jpg)
19. While the build is in progress, you can click the View Status button to view the build steps in progress. For information on each step in the build process, see [***Build Steps***](/brainspace/docs/dataset-build-steps).

After the build completes successfully, the new dataset will move from the Dataset Queue to the list of active datasets in the Datasets page, and you are ready to create work products with it.

## Related

- [Create a Dataset with a Native Connector](/create-a-dataset-with-a-native-connector.md)
- [Dataset Build Steps](/dataset-build-steps.md)
- [Reveal-Brainspace Connector Guide](/reveal-brainspace-connector-guide.md)