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

# Use worksheets

> Write, run, organize, and save SQL queries against your DataX catalog.

Worksheets are the SQL workspace in DataX. You can keep multiple queries open in tabs, browse available entities and columns, and return to saved work later.

<Note>
  **Worksheets** appears only when worksheet analytics is enabled for your workspace. You can query
  only the entities and values allowed by your role.
</Note>

## Create and run a query

<Steps>
  <Step title="Open Worksheets">From **Analytics**, select **Worksheets**.</Step>
  <Step title="Create a tab">Select **New Worksheet** or the plus button in the tab strip.</Step>

  <Step title="Build the query">
    Enter SQL in the editor. Autocomplete suggests catalog entities and columns available in the
    current workspace.
  </Step>

  <Step title="Use the explorer">
    Search the schema tree and select an entity or column to insert it into the editor.
  </Step>

  <Step title="Run SQL">
    Select part of the SQL to run only that selection, or leave the editor unselected to run the
    full query.
  </Step>

  <Step title="Save the worksheet">
    Select **Save**. Give a new worksheet a clear name when prompted.
  </Step>
</Steps>

Use **Format** to make SQL easier to review. The run control changes to a cancel action while a query is executing.

## Organize worksheets

The **Explorer** separates **My Worksheets** from **Shared Worksheets** when shared content is available. Search the list by name and sort it to find recent or alphabetical work.

Open the worksheet menu to:

* **Open** it in a tab;
* **Copy** it into a local draft;
* **Rename** it when you have edit access;
* **Delete** it when you have delete access.

Unsaved edits stay associated with the open tab. When you close a changed tab, choose **Save and close**, cancel the close, or discard the changes.

<Warning>
  A copied worksheet starts as a local draft. Save it before you rely on it being available in a
  later session.
</Warning>

## Turn SQL into a blueprint

Open the save menu and select **Save as Blueprint** when the query should become a documented catalog entity. This action requires blueprint management access and opens the blueprint workflow with the worksheet SQL.

Before you convert it:

1. Format the SQL.
2. Run the complete query, not only a selection.
3. Review the returned schema and sample values.
4. Confirm that the query uses stable catalog entities.

Continue with [Create a blueprint](/datax/catalog/create-a-blueprint). For result tools, see [Results and charts](/datax/analytics/results-and-charts).