---
id: semantic-link-sempy
version: "0.14.2"
license: proprietary and confidential
license_treatment: unclear
maintenance: active
---

# semantic-link-sempy — Semantic link for Microsoft Fabric

License: unclear · Maintenance: active · Downloads: 951.8K/mo

## What it is and what it does

Semantic-link-sempy is the core package of Microsoft's semantic link feature, designed to bridge Power BI datasets and Microsoft Fabric's data science environment. It provides Python APIs to connect Spark notebooks and jobs to Power BI semantic models, query them via DAX, and enrich data analysis with Power BI measures and domain semantics. The package is built for data scientists working in Fabric who need to access and leverage semantic information stored in Power BI without leaving their notebooks.

The package includes connectivity to Power BI through the Spark native connector, data augmentation capabilities, and a comprehensive admin API (75 functions) for managing Fabric workspaces, capacities, domains, datasets, reports, and tenant settings. It depends on a large ecosystem of Azure SDKs, PySpark, pandas, and IPython, reflecting its tight integration with the Fabric platform. The package is classified as Beta, indicating active development and potential API changes.

Use it for:

- Query Power BI semantic models and DAX measures directly from a Fabric notebook to augment pandas or Spark DataFrames with business logic.
- Automate tenant and workspace administration tasks such as listing workspaces, managing user access, and assigning capacities programmatically.
- Deploy or update semantic model definitions across Fabric workspaces, including remapping Direct Lake connections to new lakehouses.
- Extract and modify Power BI report layouts by reading and updating report.json files within a Fabric notebook workflow.
- Propagate semantic metadata and domain knowledge across data science projects to standardize analysis and reduce errors.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Connects Python notebooks and Spark jobs in Microsoft Fabric to Power BI datasets, enabling data scientists to query semantic models, augment data with Power BI measures, and propagate semantic information across analysis workflows.

Yes, if you are actively working in Microsoft Fabric and need to integrate Power BI semantic models into your data science workflows. The package is actively maintained, has low install friction, and provides essential connectivity for Fabric-native development. However, the proprietary license and Beta status mean you should review Microsoft's terms and test thoroughly before production use. Not suitable for standalone Python environments or non-Fabric contexts.

## Install

pip install semantic-link-sempy
uv add semantic-link-sempy
poetry add semantic-link-sempy

## Installing semantic-link-sempy

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a release 24 days ago. Requires Python 3.10 or later and depends on 23 runtime packages including PySpark, pandas, Azure SDKs, and IPython—typical for a Fabric-integrated tool but substantial for lightweight projects.

License in practice: Licensed as proprietary and confidential with unclear treatment. The license is not an open-source SPDX identifier, so redistribution, modification, and commercial use are restricted by Microsoft's terms. Review the linked Terms of Service before integrating into production systems.

Quickstart:

pip install semantic-link-sempy

import sempy.fabric as fabric

# List workspaces in Fabric tenant
workspaces = fabric.admin.list_workspaces()

Requires a Microsoft Fabric subscription and must run within a Fabric notebook or Spark job; not supported in standalone Python environments. Requires Python 3.10 or later.

Verify before relying:

- Whether the 75 admin API functions and semantic propagation features are stable or still evolving in Beta status
- Performance characteristics when querying large Power BI semantic models or executing complex DAX expressions
- Compatibility with non-Microsoft authentication or on-premises Power BI instances

## Package facts

- License: proprietary and confidential (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 951.8K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

power bi fabric integration python, semantic model connectivity spark, fabric notebook power bi access, dax query evaluation python, fabric admin api management, fabric-integration, power-bi, admin-api

[View on SkillFed](https://skillfed.io/packages/semantic-link-sempy) · [View on PyPI](https://pypi.org/project/semantic-link-sempy/)