hub
get_dataset
Read one StrataHub dataset card.
strata hub get-datasetdb.hub.get_dataset(name: 'str', *, hub_url: 'Optional[str]' = None) -> 'Any'wire hub_get_dataset
Reads `GET /v1/datasets/<name>` from the effective hub URL and returns the dataset card in an executor-owned JSON envelope.
Status commands return a scalar or compact status payload and do not mutate database state.
To see the complete help for this command, run:
strata hub get-dataset --helphelp(db.hub.get_dataset)
Example
No CLI example in this release.
card = db.hub.get_dataset("titanic") # doctest: +SKIPcard.primitives, card.license # doctest: +SKIP
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Dataset slug. |
| hub_url | string or null | no | Explicit hub URL; when absent the 5-layer resolver runs. |
Returns
StatusResponse<HubDatasetCard>
- dataHubDatasetCard
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| unsupported.executor.hub_feature_disabled | after_state_change | not_started |
| invalid_argument.executor.hub_url | never | not_started |
| unavailable.executor.hub_transport | same_request | not_started |
| invalid_argument.executor.hub_dataset | never | not_started |
| not_found.executor.hub_dataset | never | not_started |