Skip to content

Commit 4042f3e

Browse files
committed
docs(skill): unify dataset SQL as datasets.<schema>.<table>
Align the Chain workflow bullet and Querying datasets section on the qualified name pattern; keep full_name guidance and workspace example.
1 parent 683513a commit 4042f3e

1 file changed

Lines changed: 2 additions & 8 deletions

File tree

skills/hotdata/SKILL.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ These are **patterns** built from the commands below—not separate CLI subcomma
5959

6060
- **Model** — Markdown semantic map of your workspace (entities, keys, joins). **Store and read it via workspace context** (`hotdata context show DATAMODEL`, `context push DATAMODEL`); refresh content using `connections`, `connections refresh`, `tables list`, and `datasets list`. For a **deep** modeling pass (connector enrichment, indexes, per-table detail), see [references/MODEL_BUILD.md](references/MODEL_BUILD.md).
6161
- **History** — Inspect prior activity via `hotdata queries list` (query runs) and `hotdata results list` / `results <id>` (row data).
62-
- **Chain** — Follow-ups via **`datasets create`** then `query` against `datasets.main.<table>`.
62+
- **Chain** — Follow-ups via **`datasets create`** then `query` against `datasets.<schema>.<table>`.
6363
- **Indexes** — Review SQL and schema, compare to existing indexes, create **sorted**, **bm25**, or **vector** indexes when it clearly helps; see [references/WORKFLOWS.md](references/WORKFLOWS.md#indexes).
6464

6565
Full step-by-step procedures: [references/WORKFLOWS.md](references/WORKFLOWS.md).
@@ -200,13 +200,7 @@ hotdata datasets create --label "My Dataset" --upload-id <upload_id> [--format c
200200

201201
#### Querying datasets
202202

203-
Workspace-scoped datasets (created **outside** a sandbox, or the usual “main” catalog path) are referenced as **`datasets.main.<table_name>`**.
204-
205-
**Sandbox-created datasets** use the **sandbox id as the schema**, not `main`, for example:
206-
```
207-
datasets.<sandbox_id>.<table_name>
208-
```
209-
(e.g. `datasets.s_ufmblmvq.tac_csat`). The create output’s **`full_name`** is authoritative—copy it into `FROM` / `JOIN` clauses instead of guessing `datasets.main.…`.
203+
Qualified dataset tables are **`datasets.<schema>.<table_name>`**: **`main`** for workspace-scoped datasets (created outside a sandbox), or the **sandbox id** for sandbox-created data (e.g. `datasets.s_ufmblmvq.tac_csat`). The create output’s **`full_name`** is authoritative—copy it into `FROM` / `JOIN` clauses instead of guessing `datasets.main.…`.
210204

211205
Example (workspace dataset on `main`):
212206
```

0 commit comments

Comments
 (0)