Skip to main content
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.
Worksheets appears only when worksheet analytics is enabled for your workspace. You can query only the entities and values allowed by your role.

Create and run a query

1

Open Worksheets

From Analytics, select Worksheets.
2

Create a tab

Select New Worksheet or the plus button in the tab strip.
3

Build the query

Enter SQL in the editor. Autocomplete suggests catalog entities and columns available in the current workspace.
4

Use the explorer

Search the schema tree and select an entity or column to insert it into the editor.
5

Run SQL

Select part of the SQL to run only that selection, or leave the editor unselected to run the full query.
6

Save the worksheet

Select Save. Give a new worksheet a clear name when prompted.
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.
A copied worksheet starts as a local draft. Save it before you rely on it being available in a later session.

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. For result tools, see Results and charts.
Last modified on September 16, 2026