语义链接是一个功能，允许您在Power BI数据集和Microsoft Fabric中的Synapse数据科学之间建立连接。

语义链接的主要目标是促进数据连接、启用语义信息的传播，并无缝集成数据科学家使用的现有工具，如笔记本。

语义链接帮助您以标准化的方式保留有关数据语义的领域知识，从而加快数据分析速度并减少错误。

软件包（PyPi） | API参考文档 | 产品文档 | 示例

通过下载、安装、使用或访问此语义链接的分发包，您同意服务条款。

此软件包已与Microsoft Fabric进行了测试。

入门

先决条件

• 一个Microsoft Fabric订阅。或者注册免费Microsoft Fabric（预览）试用版。
• 登录Microsoft Fabric。
• 创建一个新的笔记本或一个新的Spark作业来使用此包。请注意，语义链接仅支持在Microsoft Fabric内部使用。

关于语义链接软件包

语义链接的功能被分成多个包，以便进行模块化安装。如果您只想安装语义链接功能的子集，可以安装单个包，而不是安装 semantic-link 元包。这有助于解决依赖性问题。以下是一些可用的包：

• semantic-link - 依赖于所有单个语义链接包的元包，可以作为一次性安装所有语义链接包的便捷方式。
• semantic-link-sempy - 包含核心语义链接功能的包。
• semantic-link-functions-holidays - 包含节假日语义函数的包，依赖于 holidays。
• semantic-link-functions-geopandas - 包含地理空间数据语义函数的包，依赖于 geopandas。
• ...

安装 semantic-link 元包

对于 Spark 3.4 及以上版本，当使用 Fabric 时，语义链接作为默认运行时可用，无需安装。如果您使用 Spark 3.3 或以下版本，或者想更新到最新的语义链接版本，您有两个选项：

• 通过在笔记本单元格中执行此代码，在您的笔记本内核中安装最新版本的 semantic-link

  %pip install -U semantic-link
  

• 或者，您可以直接将语义链接添加到您的 Fabric 环境中。有关更多信息，请参阅 Fabric 环境中的库管理。

关键概念

SemPy 提供以下功能：

• 连接到 Power BI
• 通过 Power BI Spark 原生连接器进行连接
• 使用 Power BI 度量进行数据增强
• 针对 pandas 用户的语义传播
• 内置和自定义语义函数

变更日志

0.8.0

• add list_dataflow_storage_accounts
• fix list_dataflows: fix listing wrong results
• fix overflowing column metadata resolving warnings in dataset clients
• update fabric.read_table: support setting the import option by onelake_import_method parameter
• update FabricDataFrame.to_lakehouse_table: support setting the export option by method parameter

0.7.7

• fix list_partitions: records per segment calculation
• Added resolve_dataset_id and resolve_dataset_name

0.7.6

• update evaluate_dax: allow limiting number rows
• fix create_notebook: supported resolving default lakehouse from another workspace
• fix api doc: removed broken xrefs
• fix get_artifact_id for high concurrency

0.7.5

• FabricRestClient & PowerBIRestClient: support waiting for long-run operations
• FabricRestClient & PowerBIRestClient: support paged responses
• Added resolve_item_id and resolve_item_name
• evaluate_dax: support reading data from semantic models with read-only access

0.7.4

• internal bug fixes

0.7.3

• add delta_column_mapping_mode parameter to FabricDataFrame.to_onelake_table
• update find_relationships: swap from/to for relationships to align with PowerBI
• make sure users can execute DAX against semantic models they have access to AND not have access to the workspace
• support jupyter runtime
• update list_columns : added missing workspace parameter
• fix list_partitions: record / segment computation
• fix list_tables_duplicates
• fix list_tables(extended=True)
• fix broken doc links

0.7.2

• list_* (additional_xmla_properties): handle property names that might fail for some rows
• fix list_tables

0.7.1

• fix list_annotations

0.7.0

• add create_tom_server
• add additional_xmla_properties argument to all applicable list_* functions
• add list_annotations
• update list_columns: alternate columns/tables
• update list_relationships: add extended argument
• update list_hierarchies: add extended argument
• 更新分区列表：添加扩展参数
• 更新度量列表：添加额外列
• 修复关系元数据绘图：关系的箭头指向与PowerBI相同的方向
• 修复数据源列表

0.6.0

• 添加数据源列表
• 添加数据流列表
• 添加应用列表
• 添加网关列表
• 添加表列表
• 添加计算项列表
• 添加列列表
• 添加视角列表
• 引入“扩展”标志以查询包含更多信息的DMVs（例如表大小）
• 添加额外的xmla属性
• 更新容量ID为小写
• 使FabricDataFrame创建更健壮
• 修复翻译列表

下一步

查看我们的示例