Development Documentation
View as:

Auto-generated from: security/roles.sql, security/grants/, security/rls/ — Last scanned: 2026-06-08T13:11:14.876627+00:00

Warehouse Roles

SQL warehouse roles are mapped to Function Profile (FP GER) Entra ID security groups. FP GER is the canonical naming convention for all platform security groups -- older sg-fabric-* names are no longer used.

6 roles defined in security/roles.sql:

RoleFunction Profile (Entra Group)StatusPurpose
platform_adminFP GER Fabric Platform Team (Leads)ActiveFull database control for platform team / SPNs.
analyst_fullFP GER Fabric Analysts FullActiveFull read access to Gold + Bronze schemas.
analyst_goldFP GER Fabric AnalystsActiveRead access to non-sensitive Gold tables only. No Bronze access.
app_consumerFP GER Fabric AppsActiveRead access to dimension + non-sensitive fact tables only.
report_viewer(business FP GER groups via workspace app / semantic model)ActiveNo direct SQL access. Data accessed via semantic models (Power BI).
it_admin(none -- merged into platform_admin)DEPRECATEDHistorical: full read + metadata for IT administrators.

Deprecation note: Deprecated roles are retained so existing grants keep working, but no new members should be assigned. Users who previously would have been placed in a deprecated role should be added to FP GER Fabric Platform Team (→ platform_admin) instead.

Workspace-Only Function Profiles (no SQL role)

Not every FP GER group maps to a SQL warehouse role. Some groups get only Fabric workspace access and never query the Gold warehouse directly. These are managed via Terraform (terraform/environments/<env>/terraform.tfvars):

Function Profile (Entra Group)Workspace RolePurpose
FP GER Fabric DevelopersViewer on deployed Gold / Bronze / Semantic / Reports (DEV/UAT/PROD); Contributor on their own feature workspacesPlatform developers -- read-only on deployed workspaces. All changes go through feature branch -> PR -> pipeline (ADR-20). No SQL role: direct warehouse writes are blocked by design. Developers who also need warehouse query access are added to FP GER Fabric Analysts Full as well.
FP GER Fabric ConsultantsViewer on deployed Semantic / Reports (DEV/UAT/PROD); Contributor on their own feature workspaces. No access to Gold or Bronze workspaces.External Power BI consultants. Same read-only-on-deployed model as Developers, scoped to Semantic + Reports only -- consultants never touch Gold or Bronze, and have no SQL warehouse role. Feature workspaces are pre-provisioned for them by an admin (Workflow 5 -- consultants do not self-provision).

Grant Files

FileGrants For
security/grants/analyst_full.sqlanalyst_full
security/grants/analyst_gold.sqlanalyst_gold
security/grants/app_consumer.sqlapp_consumer
security/grants/bronze_write_protection.sqlbronze_write_protection
security/grants/cls_analyst_gold.sqlcls_analyst_gold
security/grants/cls_app_consumer.sqlcls_app_consumer
security/grants/it_admin.sqlit_admin
security/grants/platform_admin.sqlplatform_admin
security/grants/report_viewer.sqlreport_viewer

Row-Level Security

Rule FileDescription
security/rls/commercial_budget_rls.sqlcommercial_budget_rls