Drops the product space from the branch catalog. The default space refuses deletion with invalid_argument.engine.space_delete_default. A space that still contains visible data refuses deletion with failed_precondition.engine.space_not_empty unless force: true is set, which tombstones the visible rows first and reports the count. Deleting a space that does not exist succeeds with deleted: false.

Successful mutations return an acknowledgement that identifies the affected target, the mutation effect, and commit facts when the operation changed stored state.

Examples

Delete a product space.

CLI

$ strata space create temp
$ strata space delete temp
$ strata space exists temp

Wire

{"space":"temp","type":"space_create"}
{"space":"temp","type":"space_delete"}
{"space":"temp","type":"space_exists"}

Parameters

Name	Type	Required	Description
force	boolean	no	Delete visible data in the space before dropping the catalog entry.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

MutationAck<SpaceDelete>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.product_space_reserved
• invalid_argument.engine.space_delete_default
• failed_precondition.engine.space_not_empty
• invalid_argument.engine.space_delete_too_large

Invocation

• CLI: strata space delete
• Wire type: space_delete