Feat(fabric-cli): document fab find, reframe DataHub V2 as governance complement#23
Merged
Merged
Conversation
… complement fab find (Fabric CLI >= 1.6.1) is the official cross-workspace search and should be the default for routine "find an item" questions. The DataHub V2 script (search_across_workspaces.py) is kept because it surfaces fields fab find does not return: last visit, last refresh, last modified, owner, storage mode, capacity SKU, Copilot/NL support, cache config, isDiscoverable. The script's table, JSON, and detailed outputs now lead with those unique fields so the value-add is visible at a glance. SKILL.md - Quickstart step 2 now leads with fab find and points to the script for governance fields - Common workflows search section split into routine (fab find) vs governance (script) - Install note pinned to fab CLI >= 1.6.1 with a per-version delta in references/whats-new.md - Script bullet reframed as "governance complement to fab find" with link to the delta table references/workspaces.md - "Cross-Workspace Search (DataHub V2)" renamed to "Cross-Workspace Search" - Adds fab find as the primary section with all documented flags - Adds a delta table comparing fields available in fab find vs the script - Adds a "when to use which" decision table - Existing script usage retained with type-name mapping notes references/admin.md - Cross-workspace discovery section now references fab find as the user-level default; the admin path is scoped to tenant audits references/whats-new.md (new) - Per-version notes for 1.4, 1.5, 1.6.1 covering fab find, interactive REPL, fab deploy + fabric-cicd, --format on export, new item types (Map, DigitalTwinBuilder, CosmosDBDatabase, UserDataFunction, GraphQuerySet, VariableLibrary), Lakehouse import/export, rm --hard scripts/search_across_workspaces.py - Top-of-file docstring honestly positions the script vs fab find - JSON output: unique fields lead the dict; identifier fields trail - Detailed output: unique fields lead, identifiers trail - Table output: leads with Last Visit, Last Refresh, Storage, Owner; Name and Workspace still shown for row identification - Surfaces naturalLanguageSupported and cachedModelEnabled (mentioned in the docstring as unique but previously not in any output)
…t fab find OneLake catalog (fab find) does not expose lineage edges or last-visited timestamps. The internal DataHub V2 API still has unique value for both use cases, but the framing in these skills was peer-to-peer with the official Power BI APIs. Updates: semantic-models/lineage-analysis/SKILL.md - The "bulk lineage" tip now points at fab api admin/workspaces/getInfo (admin scan) or fab find for non-admin inventory, calls out that neither surfaces lineage edges, and points at the official Power BI lineage admin API for that. Removes the implicit DataHub-as-default framing. reports/review-report/SKILL.md - The --include-datahub example now carries a one-line label that it is Tier 3 (undocumented) and what it adds (cross-workspace last-visited without admin role). - The two "cross-reference with DataHub" prose bullets now name Tier 1 Activity Events as the official path and Tier 3 DataHub V2 as the non-admin fallback that should be flagged to the user as undocumented. reports/review-report/references/report-metadata.md - "DataHub V2 Fields for Models" heading flags the API as undocumented and points readers at the fabric-cli plugin's search_across_workspaces.py (which surfaces these fields ahead of the identity fields shared with fab find).
- Docstring now flags the JSON output schema change (key order plus two new keys: naturalLanguageSupported, cachedModelEnabled). Downstream consumers pinning field order should switch to key-based lookup. - Widens the Storage column to 14 chars and drops the brittle [:11] slice on the storage label. "DirectQuery" already sat right at the truncation boundary; a future label addition would have started silently truncating.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the fabric-cli skill for fab CLI >= 1.6.1.
fab find(added in 1.6.1) as the primary cross-workspace search. Substring on name/description/workspace,-P type=Xfilter,-P type!=Xexclude,-lfor ids,-q '<jmespath>'for client-side filter/projection.scripts/search_across_workspaces.pyas a governance complement, not a default search tool. The DataHub V2 API is undocumented internal surface area; the script is justified only by fieldsfab finddoes not return (last visit, last refresh, last modified, owner, storage mode, capacity SKU, naturalLanguageSupported, cachedModelEnabled, isDiscoverable).references/whats-new.mdcovering 1.4, 1.5, 1.6.1: interactive REPL, fab deploy + fabric-cicd,--formaton export, new item types (Map, DigitalTwinBuilder, CosmosDBDatabase, UserDataFunction, GraphQuerySet, VariableLibrary), Lakehouse import/export,rm --hard.Test plan
python3 scripts/search_across_workspaces.py --type Model --filter "Sales"for table, json, detailed output formats (verified locally; unique fields lead)fab findagainst a known tenant