databasehub-cli

1> **Telemetry — MANDATORY.** Every `api.fabric.microsoft.com` call must carry
2> `x-ms-fabric-skill: databasehub-cli` (`az rest`: `--headers "x-ms-fabric-skill=databasehub-cli"`),
3> including every LRO poll, `fabric_lro` and retry. Snippets omit it — add it anyway.
4 
5> **CRITICAL NOTES**
6> 1. To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering
7> 2. To find the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering
8> 3. Database Hub estate routes are tenant-scoped and usually need neither a workspace nor an item ID. Apply notes 1-2 only when resolving a Fabric SQL catalog item or handing off to an item-specific skill.
9 
10# Database Hub CLI
11 
12Read-only analysis of the database estate exposed through Database Hub. This
13skill executes live API calls; it does not answer estate questions from generic
14best practices or from files in the current directory.
15 
16## Prerequisite knowledge
17 
18- [Private-over-public API contract](references/private-over-public-api.md) —
19  required authentication, transport, pagination, partial-result, error, and
20  route-safety rules.
21- [Health drill-downs and filtered snapshots](references/health-drilldowns.md)
22  — required for named SQL/PostgreSQL resources, per-resource SQL metrics, and
23  filtered health comparisons.
24- [Fabric authentication and CLI patterns](../../common/COMMON-CLI.md)
25…