# Osmos Datasets

## Overview

This page outlines the initial process for creating a new Osmos Dataset.

## Creating an Osmos Dataset 

Step 1: Click the Datasets icon and select **Create Dataset.**

Step 2: In the New Dataset Window, enter the name of your **Dataset.**

Step 3: Hit **Save.** 

<figure><img src="/files/8gFU6lLUsjkAclBBb1mA" alt=""><figcaption></figcaption></figure>

## Adding a Table to your Osmos Dataset

Step 1: Click the Dataset icon, and select your newly created **Osmos Dataset**.

Step 2: Select **Add New Table.**

<figure><img src="/files/NlYjFvHKlkSeACEwApaY" alt=""><figcaption></figcaption></figure>

Step 3: Enter the **Table Name.**

Step 4:  Enter the **Schema.**

Design the output schema via two options, either import the schema or build it within Osmos.

#### Option 1: Schema Import

Upload or drag & drop the schema file.

<figure><img src="/files/P8g9PFXbmwdT4CRtG4oO" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Import a file with the headers along with one row of sample data.  This data is used ***only*** in schema creation.
{% endhint %}

<figure><img src="/files/9cvk8KFqqxQWGSza7Fen" alt=""><figcaption></figcaption></figure>

#### **Option 2: Building the Schema for the Destination Connector**

Use the schema designer to build the output schema for your table.

| Parameter       | Description                                                                                                                                                       |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Field Name      | Provide a field name for the output fields. These names will be used as the column headers or field names in the output file you are writing to.                  |
| Type            | Define the type of each field. The field types will be used to enforce rules when you send data to this Connector.                                                |
| Required        | Check this box if the field is nullable. If the field is not nullable, you will be required to provide values for this field when sending data to this Connector. |
| Actions         | Deletes the field.                                                                                                                                                |
| Add Field       | Adds another field to the schema.                                                                                                                                 |
| Upload Schema   | Upload schema or drag & drop header fields                                                                                                                        |
| Add Foreign Key | Add a foreign key column to be used in a lookup & join criteria when the data from a related table is combined                                                    |

A Primary key can be associated with this table.  The key field must be required and unique.&#x20;

{% hint style="info" %}
See [Key Fields](/datasets/getting-started/creating-primary-and-foreign-keys.md) for more detail
{% endhint %}

Select Save Table.

## Dataset Actions

You can take four actions in a Dataset.

1. Create Table
2. Access QueryBuilder
3. Clone a Dataset
4. Edit a Dataset

<figure><img src="/files/0uO4ZYbSk2irJckWttV0" alt=""><figcaption></figcaption></figure>

Here is a drill down on the Dataset options:

<figure><img src="/files/5J2GObMbOtA5HEOYXFOR" alt=""><figcaption></figcaption></figure>

### Create Table

[See above](#creating-an-osmos-dataset)

### Query your Dataset

Drill directly into the Query Builder to build your table filters, joins, and aggregations.

Step 1:  Click the cylinder icon from your **Osmos Dataset**

For more guidance on [the Query Builder.](/datasets/datasets-query-builder.md)

### Cloning your Osmos Dataset

Cloning will duplicate a Dataset.  Note, that this process will move the existing tables but will not clone the data in each table. &#x20;

Step 1: Click the clone icon from your **Osmos Dataset**.

Step 2: Select the **Project.**

Step 3: Enter the new **Dataset Name.**

Step 4:  Click on **Clone.**

<figure><img src="/files/a1TbAMmYitn3MbR6mSn8" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cq2w7QubgY0FVnIGENdy" alt="" width="375"><figcaption></figcaption></figure>


---

# 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://docs.osmos.io/datasets/getting-started.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.