Clones a dataset from a hub into a new local database directory. Resolution, download, verification, reconstitution, and origin recording run once behind this command; the session database is not touched. The destination directory must not exist or must be empty. When the hub URL is not given, the layered resolver selects it from the flag, environment, and config layers.
Status commands return a scalar or compact status payload and do not mutate database state.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
dataset | string | yes | Dataset to clone. |
dest | string | yes | Destination directory (must not exist, or be empty). |
hub_url | string | no | Explicit hub URL; when absent the 5-layer resolver runs (flag, STRATA_HUB_URL, project config, global config). |
Plus the optional scope: branch and space (default to the session branch and the "default" space).
Returns
StatusResponse<HubClone>.
Errors
failed_precondition.engine.runtime_closedinvalid_argument.executor.hub_datasetinvalid_argument.executor.hub_branchinvalid_argument.executor.hub_feature_disabledinvalid_argument.executor.hub_urlfailed_precondition.executor.hub_cloneunavailable.executor.hub_transport
Invocation
- CLI:
strata clone - Wire type:
hub_clone