SuperAPI AI 工具集

fabric-data-store

数据与分析

查看项目

更新于 10-16 06:56

技能介绍

用途

fabric-data-store 用于操作和治理 Microsoft Fabric 数据存储资产,采用确定性的、策略驱动的工作流。它面向需要管理 Fabric 中 Cosmos DB 数据库、SQL 数据库、Snowflake 数据库链接、datamart 以及 Event Schema Set 治理的场景。

主要能力

该技能覆盖以下命令族:

  • /store-setup
  • /fabric-cosmos-db-database-manage
  • /datamart-manage
  • /event-schema-set-manage
  • /fabric-snowflake-database-link
  • /fabric-sql-database-manage

集成上下文契约

规范契约位于 docs/integration-context.md。命令族涉及以下上下文要素:tenantId、subscriptionId、environmentCloud、principalType、scopesOrRoles。

不同操作的上下文要求:

  • 设置/发现:tenantId 必需,subscriptionId 可选,environmentCloud 必需,principalType 为 delegated-user 或 service-principal,scopesOrRoles 为 Fabric.Read.All(或工作区读取角色)。
  • Cosmos/SQL/Snowflake 写操作:tenantId 必需,subscriptionId 可选,environmentCloud 必需,principalType 为 delegated-user 或 service-principal,scopesOrRoles 为 Fabric.ReadWrite.All 加工作区 Contributor/Admin。
  • Datamart/Event Schema Set 治理:tenantId 必需,subscriptionId 可选,environmentCloud 必需,principalType 为 delegated-user 或 service-principal,scopesOrRoles 为 Fabric.ReadWrite.All 加工作区 Contributor/Admin 加语义工件写入权限。

快速失败声明:在发送 API 调用前,拒绝缺失或无效的上下文以及权限不足的情况。

脱敏声明:在所有命令和审查输出中脱敏 ID,并抑制密钥/令牌。

预览注意事项

Datamart 和 Event Schema Set 操作可能运行在预览功能上。在写入操作前验证租户功能状态,避免假设负载向后兼容。

执行模式

  1. 校验集成上下文和目标工作区。
  2. 解析不可变的目标项身份。
  3. 读取当前架构/治理状态。
  4. 应用最小的确定性变更。
  5. 重新读取并报告脱敏差异,附带验证指引。

参考

API 模式:skills/fabric-data-store/references/api-patterns.md

限制

资料未提供该技能的具体安装方式、收费模式、支持平台及实际使用效果等信息。