1. Treat the semantic model as an architecture decision
During migration, it is tempting to focus first on recreating dashboards. Yet the semantic model determines how report authors and users understand data after migration: which tables are available, how they relate, which measures are authoritative, and how filtering behaves.
A report can preserve its visual appearance while producing different results if grain, relationships, calculations, or filter direction change. The target-model decision should therefore be made before dependent reports are finalized.
- Define authoritative business entities and measures
- Preserve the intended grain of each fact table
- Separate reusable business logic from report-only presentation logic
- Assign ownership for refresh, security, certification, and future changes
2. Choose the right model pattern
Not every migration needs one enterprise-wide model. A practical programme usually uses a combination of three patterns, selected according to reuse, ownership, delivery timing, and the maturity of the target data platform.
- Report-specific model: suitable when a report is independent, needs to move quickly, or relies on unique data and logic
- Existing shared model: suitable when the organization already has a trusted Power BI model that covers the report's required fields and calculations
- Evolving shared model: suitable when several reports use common entities and measures, but the target model still needs controlled expansion
4. Build the decision from inventory evidence
A shared model should be derived from evidence across the relevant report estate. Inventory metadata can reveal repeated datasources, tables, fields, calculations, and report dependencies. That evidence helps identify potential reuse, but it does not prove that two fields have the same business meaning.
MigraBi can suggest an editable semantic model from inventory or project metadata and can read an existing model's metadata for comparison. The user remains responsible for validating grains, relationships, source compatibility, and business definitions before accepting the model.
- Group reports by business domain and compatible source systems
- Union fields used across reports that genuinely share a table
- Keep source identity and connection type visible
- Identify repeated and conflicting calculations
- Record which reports depend on each proposed model object
5. Validate alignment before creating connected reports
A source report should not be switched to a shared model because table names look similar. Alignment should compare the report's required fields and calculations with included model objects, including datatype, role, expression, relationship context, and format where relevant.
MigraBi keeps report-specific analysis separate from shared-model alignment. This allows the original assessment and review trail to remain intact while a selected model acts as a generation choice for connected report output. Missing or conflicting mappings remain review items rather than being silently forced.
- Map exact or confidently normalized field identities
- Treat datatype incompatibility as a review issue
- Compare calculation meaning, not only calculation names
- Exclude Tableau-generated constructs such as Measure Names from physical model-field matching
- Require accepted mappings for every report dependency needed by the output
6. Deploy the model before its dependent reports
A shared-model migration has an explicit dependency order. The semantic model must be validated, published, configured, and made accessible before connected reports can operate in the destination workspace. Reports should then be tested against that deployed model, not only against a local design artifact.
Plan the release as a model-and-reports unit. Confirm datasource credentials, gateway requirements, refresh behavior, permissions, and workspace ownership before business validation begins.
- Publish and configure the semantic model
- Confirm credentials, gateway, refresh, and security
- Grant report authors the required model permissions
- Deploy connected reports after the model is available
- Reconcile results and complete report-level sign-off
7. Govern changes as shared dependencies
Once several reports use one semantic model, a model change can affect many consumers. Version history, impact analysis, ownership, and release coordination become part of normal report delivery. A field rename, relationship change, or measure revision should be evaluated against every dependent report.
This is the trade-off behind reuse: less duplicated logic, but a greater need for disciplined lifecycle management. Maintain an inventory of dependent reports and document accepted exceptions where a report must retain a local model.
- Assign a model owner and named business reviewers
- Track model versions and accepted changes
- Review downstream report impact before release
- Separate shared measures from report-specific measures
- Retest critical reports after model changes
8. A practical decision checklist
Use a shared semantic model when the reports have compatible data domains, grains, definitions, and ownership. Keep a report-specific model when its requirements are materially different or when the shared dependency would slow a justified independent delivery.
- Do the reports use the same business entities and definitions?
- Are source systems and data grains compatible?
- Can required fields and calculations be mapped without changing meaning?
- Is there an owner for model security, refresh, and change control?
- Can the model be deployed before its dependent reports?
- Have exceptions and remaining report-specific logic been documented?
Further reading
Official platform guidance used to support this article:
Apply the guidance
Assess report logic before choosing a target model
Use MigraBi's free analysis to inspect the fields, calculations, datasources, and review work behind a Tableau workbook.