语义链接是一种功能，允许您在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 overflowing column metadata resolving warnings in dataset clients
• update fabric.read_table: 通过onelake_import_method参数支持设置导入选项
• update FabricDataFrame.to_lakehouse_table: 通过方法参数支持设置导出选项

0.7.7

• fix list_partitions: 计算每个段的记录数
• 添加resolve_dataset_id和resolve_dataset_name

0.7.6

• update evaluate_dax: 允许限制行数
• fix create_notebook: 支持从另一个工作区解析默认的Lakehouse
• fix api doc: 删除了损坏的xrefs
• fix get_artifact_id for high concurrency

0.7.5

• FabricRestClient & PowerBIRestClient: 支持等待长时间运行的操作
• FabricRestClient & PowerBIRestClient: 支持分页响应
• 添加resolve_item_id和resolve_item_name
• evaluate_dax: 支持从具有只读访问权限的语义模型中读取数据

0.7.4

• 内部错误修复

0.7.3

• 向FabricDataFrame.to_onelake_table添加delta_column_mapping_mode参数
• update find_relationships: 交换关系中的from/to以与PowerBI保持一致
• 确保用户可以针对他们有权访问且无法访问工作区的语义模型执行DAX
• 支持jupyter运行时
• update list_columns : 添加缺失的工作区参数
• fix list_partitions: 记录/段计算
• fix list_tables_duplicates
• fix list_tables(extended=True)
• fix broken doc links

0.7.2

• list_* (additional_xmla_properties): 处理可能失败的某些行的属性名
• fix list_tables

0.7.1

• fix list_annotations

0.7.0

• add create_tom_server
• 向所有适用的list_*函数添加additional_xmla_properties参数
• 添加list_annotations
• update list_columns: 交替列/表
• 更新list_relationships：添加扩展参数
• 更新list_hierarchies：添加扩展参数
• 更新list_partitions：添加扩展参数
• 更新list_measures：添加额外列
• 修复plot_relationship_metadata：关系箭头指向与PowerBI相同的方向
• 修复list_datasources

0.6.0

• 添加list_datasources
• 添加list_dataflows
• 添加list_apps
• 添加list_list_gateways
• 添加list_tables
• 添加list_calcuation_items
• 添加list_columns
• 添加list_perspectives
• 引入“扩展”标志以查询包含更多信息（例如表大小）的DMVs
• 添加额外的xmla属性
• 将容量ID更新为小写
• 使FabricDataFrame创建更加健壮
• 修复list_translations

下一步

查看我们的示例