admin

info

Read database identity and a catalog summary.

strata info

wire info

Returns database identity and a catalog summary for one branch: engine version, open target, whether this open created the database, durability, the default branch, the active branch count, the registered space count for the selected branch, and the resolved storage `memory_budget` (its `total_bytes` and its `source` - `explicit`, `derived_from_host`, or `fixed_default`). When no budget is set, the engine derives the default from host memory at open - 25% of usable memory, clamped to a ceiling - so `memory_budget` reveals what the database is actually sized to. The branch defaults to the handle branch when omitted.

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 info --help

Example

Read database identity and catalog counts.

strata info

Parameters

NameTypeRequiredDescription
branchstring or nullnoBranch whose space catalog should be summarized. Defaults to the executor handle branch.

Returns

StatusResponse<AdminDatabaseInfo>

  • dataAdminDatabaseInfo
  • typestring

Errors

Recover by code. Retry policy and commit outcome come from the shipped error registry.

CodeRetryCommit outcome
failed_precondition.engine.runtime_closednevernot_started
not_found.engine.branchnevernot_applicable
invalid_argument.engine.branch_namenevernot_started
← All 11 Admin commands

agents: this page as markdown → /docs/reference/admin/info.md