sap-datasphere

SAP Datasphere 技能

相关技能

• sap-dependency-security：在使用包管理工具管理大型连接器或集成项目时，用于安全依赖策略、锁文件规范，以及精确固定 MCP 服务版本

目录

• 概览
• 快速参考
  • 核心组件
  • 对象类型
• Data Builder
  • 图形视图
  • SQL 视图
  • 表
  • 数据流
  • 任务链
• Business Builder
• 分析模型
• 连接
• 空间管理
• 数据访问控制
• 监控
• CLI 参考
• 数据产品与 Marketplace
• 目录与治理
• 内容传输
• 常见问题
• 捆绑资源
• 文档链接

概览

SAP Datasphere 是 SAP 在 SAP Business Technology Platform (BTP) 上提供的云原生数据仓库解决方案。它是 SAP Business Data Cloud (BDC) 中的数据基础。SAP Business Data Cloud 是 SAP 的统一数据与分析平台，还包括 SAP Analytics Cloud、SAP HANA Cloud、SAP Databricks 和精选数据产品。有关 BDC 架构以及 Datasphere 在其中的定位，请参阅 references/business-data-cloud.md。

本技能提供有关数据获取、准备、建模、管理和集成的全面指导。

何时使用此技能

在以下情况下使用此技能：

• 在 SAP BTP 上创建数据仓库
• 为 SAP Analytics Cloud 构建分析模型
• 设置数据流、复制流或转换流
• 配置与 SAP 或第三方系统的连接
• 管理空间、用户和访问控制
• 实施实时数据复制
• 监控数据集成任务
• 当 MCP、CLI、日志或导出成品无法查看所需状态时，检查 Microsoft Edge 中经过身份验证的 Datasphere 浏览器 UI 状态

对于 Datasphere 浏览器问题排查，请使用共享的 sap-browser-automation 技能，进行应用内手动身份验证、在获得同意后复制经过身份验证的 Edge 配置文件、启动新的环回 CDP、选择目标并进行恢复。此处的 references/edge-cdp-control.md 附录保留了 Datasphere 特定的边界。使用 CDP 对 Data Builder、Business Builder、监控、连接、目录和管理 UI 状态进行本地只读检查；保存、部署、删除、导入、导出、运行任务链或更改用户/角色之前，请先征得同意。

---

快速参考

核心组件

组件	用途	关键对象
Data Builder	数据获取与准备	视图、表、数据流、任务链
Business Builder	语义层建模	业务实体、事实模型、消费模型
分析模型	面向分析的结构	维度、事实、度量、层级
连接	外部数据源	40+ 种连接类型
空间	逻辑数据容器	存储、用户、对象

对象类型

视图：

• 图形视图：使用拖放方式进行可视化数据建模
• SQL 视图：基于 SQL 的视图定义
• 分析模型：针对分析优化的语义层

表：

• 本地表：存储在 Datasphere 中的数据
• 远程表：对外部数据的虚拟访问
• 本地表（文件）：基于对象存储的存储

数据流：

• 数据流：ETL 转换
• 复制流：从源复制数据
• 转换流：支持增量数据的转换

---

Data Builder

图形化视图

通过拖放数据源并添加转换，以可视化方式创建视图。

支持的操作：

• Join：Inner、Left Outer、Right Outer、Full Outer、Cross
• Union：合并多个数据源
• Projection：选择/重命名列
• Filter：行级筛选
• Aggregation：分组并执行聚合
• Calculated Columns：派生值

最佳实践：

• 使用输入参数进行动态筛选
• 应用数据访问控制，实现行级安全
• 为频繁访问的视图启用持久化
• 使用血缘分析了解依赖关系

有关图形化视图操作的详细信息，请参阅 references/graphical-sql-views.md。

SQL 视图

使用 SQL 或 SQLScript 创建视图。

-- Basic SQL View
SELECT
    customer_id,
    customer_name,
    SUM(order_amount) AS total_orders
FROM orders
GROUP BY customer_id, customer_name

SQLScript 支持：

• 表变量
• 标量变量
• 控制流（IF、WHILE、FOR）
• 异常处理

有关 SQL/SQLScript 参考信息，请参阅 references/graphical-sql-views.md。

数据流

用于数据转换和加载的 ETL 管道。

运算符：

• Source：远程/本地表、视图
• Target：本地表
• Join、Union、Projection、Filter、Aggregation
• Script：Python 自定义逻辑
• Calculated Columns

执行：

• 手动运行，或通过任务链定时运行
• 用于增量加载的增量捕获
• 用于运行时配置的输入参数

有关数据流的详细信息，请参阅 references/data-acquisition-preparation.md。

复制流

将数据从源系统复制到 Datasphere 或外部目标。

支持的源：

• SAP S/4HANA（Cloud/On-Premise）
• SAP BW/4HANA
• SAP ECC
• 基于 ABAP 的系统
• 云存储（S3、Azure Blob、GCS）
• Kafka/Confluent
• SFTP

支持的目标：

• SAP Datasphere（本地表）
• Apache Kafka
• Google BigQuery
• 云存储提供商
• SAP Signavio

加载类型：

• 初始加载：提取全部数据
• 增量加载：仅加载已更改的数据
• 实时：持续复制

有关复制流配置的详细信息，请参阅 references/data-acquisition-preparation.md。

转换流

支持增量感知的转换，并自动传播变更。

主要功能：

• 自动检测增量
• 目标表管理
• 以图形化视图或 SQL 视图作为源
• 运行模式：Start、Delete、Truncate

有关转换流的详细信息，请参阅 references/data-acquisition-preparation.md。

任务链

按顺序或并行编排多个任务。

支持的任务：

• 数据流
• 复制流
• 转换流
• 远程表复制
• 视图持久化
• Open SQL 过程
• API 任务
• BW Bridge 流程链

功能：

• 并行执行分支
• 输入参数
• 电子邮件通知
• 嵌套任务链
• 定时（简单计划或 cron）

---

数据建模

分析模型

创建可用于 SAP Analytics Cloud 分析的语义模型。

组成部分：

• 事实：包含度量（定量数据）
• 维度：对数据进行分类（主数据）
• 度量：可量化的指标
• 层级结构：导航结构
• 变量：运行时参数

创建分析模型：

1. 添加事实源（视图或表）
2. 添加维度关联
3. 定义度量及其聚合方式
4. 配置用于筛选的变量
5. 设置数据访问控制

有关详细的建模指南，请参阅 references/data-modeling.md。

维度

对分析数据进行分类和筛选。

类型：

• 标准：基本分类数据
• 时间：基于日历进行筛选
• 财政时间：自定义财年日历
• 文本实体：多语言标签

功能：

• 层级结构（基于级别、父子结构）
• 时间依赖性（SCD Type 2）
• 复合键
• 关联的文本实体

度量

用于分析的可量化值。

类型：

• 简单：直接聚合
• 计算：由其他度量派生
• 受限：筛选后的聚合
• 货币转换：动态转换
• 单位转换：动态转换
• 去重计数：唯一值计数
• 非累积：特定时间点的值

聚合类型：

• SUM、MIN、MAX、COUNT、AVG
• 用于非可加场景的例外聚合

度量配置请参阅 references/data-modeling.md。

Business Builder

创建面向业务的语义模型。

对象：

• 业务实体：可复用的维度／事实定义
• 事实模型：组合业务实体
• 消费模型：可用于分析的模型
• 授权场景：行级安全

Business Builder 详情请参阅 references/data-modeling.md。

---

连接

连接类型

SAP Datasphere 支持 40+ 种连接类型。

SAP 系统：

• SAP S/4HANA Cloud／On-Premise
• SAP BW/4HANA（模型传输）
• SAP BW Bridge
• SAP ECC
• SAP HANA（Cloud／On-Premise）
• SAP SuccessFactors
• SAP Fieldglass
• SAP Marketing Cloud
• SAP Signavio

云平台：

• Amazon S3、Athena、Redshift
• Google Cloud Storage、BigQuery
• Microsoft Azure Blob、Data Lake、SQL Database
• Microsoft OneLake

数据库：

• Oracle
• Microsoft SQL Server
• 通用 JDBC

流式处理：

• Apache Kafka
• Confluent

其他：

• 通用 OData、HTTP、SFTP
• Adverity、Precog
• SAP Open Connectors

连接配置请参阅 references/connectivity.md。

连接功能

功能	说明
远程表	虚拟数据访问
数据流	ETL 转换
复制流	数据复制
模型导入	BW/4HANA 模型传输

---

管理

空间

用于存放数据和对象的逻辑容器。

配置：

• 存储分配（磁盘 + 内存）
• 用户访问权限和角色
• 优先级和语句限制
• 工作负载管理

操作：

• 创建、复制、删除空间
• 导出／导入空间数据
• 命令行管理（datasphere CLI）

空间管理请参阅 references/administration.md。

用户和角色

标准角色：

• DW Administrator
• DW Space Administrator
• DW Integrator
• DW Modeler
• DW Viewer

限定范围的角色：

• 特定空间的权限
• 自定义权限组合

身份验证：

• SAP Cloud Identity Services
• 自定义 SAML IdP
• OAuth 2.0 客户端

用户管理请参阅 references/administration.md。

监控

功能：

• 容量监控（存储、内存、计算）
• 审计日志（数据库操作）
• 活动日志（对象变更）
• 任务日志（流执行情况）

数据库分析：

• 创建分析用户以进行调试
• 监控 HANA 视图
• 停止正在运行的语句

监控详情请参阅 references/administration.md。

---

数据集成监控

远程表

操作：

• 复制数据（全量／增量／实时）
• 对数据加载进行分区
• 创建统计信息
• 监控查询

实时复制

功能：

• 持续捕获变更
• 支持暂停／恢复
• 自动恢复
• 水位跟踪

视图持久化

选项：

• 计划刷新
• 按需刷新
• 分区管理
• 内存优化

监控详情请参阅 references/data-integration-monitor.md。

---

CLI 参考

Datasphere CLI 概览

datasphere CLI 支持通过命令行进行管理和自动化。

安装：

npm install -g @sap/datasphere-cli

身份验证：

# Interactive login
datasphere config auth login

# Service key (CI/CD)
datasphere config auth login --service-key-path ./key.json

核心命令：

命令	用途
datasphere spaces list	列出所有空间
datasphere spaces create	创建空间
datasphere objects export	导出对象
datasphere objects import	导入对象
datasphere tasks run	执行任务链
datasphere marketplace list	列出 Marketplace 产品

CI/CD 集成：

# Export and import workflow
datasphere objects export --space DEV --output-file package.zip
datasphere objects import --space PROD --input-file package.zip --overwrite

完整的 CLI 参考，请参阅 references/cli-commands.md。

---

数据产品与 Marketplace

创建数据产品

打包经过整理的数据，供内部或外部使用：

1. 规划：定义用途、目标使用者和内容
2. 准备：创建视图/模型、设置语义用途并编写文档
3. 配置：设置可见性、访问控制和条款
4. 发布：在 Marketplace 中提供

产品组件：

• 核心资产（视图、模型、实体）
• 文档和示例查询
• 治理元数据（所有者、质量评分、SLA）

数据 Marketplace

发现并使用已发布的数据产品：

• 搜索：按类别、提供方和质量查找
• 申请访问权限：提交理由并等待批准
• 使用：在视图或 SAC 故事中使用

完整的 Marketplace 指南，请参阅 references/data-products-marketplace.md。

---

目录与治理

数据目录功能

集中式发现和治理：

• 资产发现：通过元数据搜索所有数据对象
• 术语表：标准化业务术语定义
• 数据质量：自动化质量规则和评分
• 血缘关系：追踪数据从来源到使用的流向
• 分类：敏感级别和合规性标签

治理工作流

Create Object → Add Metadata → Link Terms → Quality Check → Approve → Publish

角色：

• 数据所有者：承担业务责任
• 数据管理员：管理质量和元数据
• 数据托管人：负责技术实现

详细的治理指南，请参阅 references/catalog-governance.md。

---

数据访问控制

实施行级安全性。

类型：

• 单个值：简单的值匹配
• 运算符和值：复杂条件
• 层级结构：基于节点的筛选
• 带目录的层级结构：层级权限

应用：

• 应用于视图或分析模型
• 基于用户属性
• 从 SAP BW Analysis Authorizations 导入

安全配置，请参阅 references/data-access-security.md。

---

内容传输

在租户之间移动内容。

方法：

• 导出/导入包
• SAP Cloud Transport Management
• CSN/JSON 文件导出

包内容：

• 视图、表、数据流
• 连接（仅元数据）
• 空间配置

传输流程，请参阅 references/content-transport.md。

---

---

常见错误和解决方案

错误	原因	解决方案
部署失败	循环依赖	检查对象依赖项
连接超时	网络/防火墙	验证 Cloud Connector/IP 允许列表
复制卡住	源锁定	检查源系统状态
内存不足	大型视图	启用持久化或分区
权限被拒绝	缺少角色	验证空间成员资格和权限

---

捆绑资源

参考文档

核心数据构建器：

1. references/data-acquisition-preparation.md - 数据流、复制流、转换流和表管理
2. references/graphical-sql-views.md - 图形视图、SQL 视图、E-R 模型和智能查找
3. references/data-modeling.md - Business Builder 实体、分析模型、维度、度量和层级结构

连接与集成： 4. references/connectivity.md - 所有 40 多种连接类型，包括 SAP 系统、云提供商和流平台 5. references/data-integration-monitor.md - 任务调度、监控、实时复制和增量机制

管理与安全： 6. references/administration.md - 租户管理、空间配置、用户角色和弹性计算节点 7. references/data-access-security.md - 行级安全、DAC 配置和授权场景 8. references/content-transport.md - 软件包导出/导入、传输管理和租户迁移

CLI 与自动化： 9. references/cli-commands.md - 完整的 CLI 参考、身份验证和 CI/CD 集成模式

市场与治理： 10. references/data-products-marketplace.md - 创建和使用数据产品、提供方工作流、定价 11. references/catalog-governance.md - 数据目录、术语表、质量规则、血缘关系、分类

最佳实践与更新： 12. references/best-practices-patterns.md - 架构模式、命名约定、性能优化、检查清单 13. references/whats-new-2025.md - 2025 年归档：2025 年 Q1-Q4 功能、Generic HTTP、REST API 任务、弃用内容 14. references/whats-new-2026.md - 2026 年 Datasphere/BDC 功能，包括 Q1-Q2 更新，以及 2026.11 项目，例如 HANA Cloud 计算视图语义引导、复制流调度、运行时设置传输、SAP Snowflake 和 SAPPHIRE 公告

平台背景： 15. references/business-data-cloud.md - SAP Business Data Cloud 架构、Databricks 集成、数据产品与市场的区别、BDC Connect

MCP 集成： 16. references/mcp-tools-reference.md - 完整的 MCP 工具参考，涵盖 8 个类别中的 45 个工具、API 文档和身份验证模式 17. references/mcp-use-cases.md - 8 个示例性源材料用例，包括角色和规划假设 18. references/edge-cdp-control.md - 面向 Datasphere 的附加内容，适用于共享的 sap-browser-automation Edge/CDP 和身份验证层

MCP 参考路由

加载 MCP 参考文档前先进行搜索。使用 rg -n "<space|view|connection|task|lineage|marketplace|governance|admin>" references/mcp-*.md 定位确切的工具或场景，然后仅打开相关摘录。

• 使用 references/mcp-tools-reference.md 查找工具名称、输入项和直接租户操作边界。
• 仅在选择工作流模式或查看示例性影响假设时使用 references/mcp-use-cases.md；普通工具查询时不要加载完整的用例指南。
• 如果无法访问 MCP，请改用对应的 CLI/参考命令，并将租户检查标记为待处理。

插件组件

此插件包含 3 个专用 Agent、5 个斜杠命令和验证钩子：

Agent（位于 agents/ 中）：

• datasphere-modeler - Data Builder 任务、视图、流、分析模型
• datasphere-integration-advisor - 连接、复制、数据集成
• datasphere-admin-helper - 空间管理、安全、监控

命令（位于 commands/ 中）：

• /datasphere-space-template - 生成空间配置
• /datasphere-view-template - 生成视图模板（图形化/SQL）
• /datasphere-connection-guide - 分步设置连接
• /datasphere-cli - CLI 命令参考和示例
• /datasphere-mcp-tools - SAP Datasphere MCP 工具参考和使用指南

钩子（位于 hooks/ 中）：

• PreToolUse：验证 SQL/SQLScript 代码质量
• PostToolUse：提供持久化和优化建议

MCP 集成

此技能包含 SAP Datasphere MCP Server（@mariodefe/sap-datasphere-mcp）的连接配置。捆绑的 MCP 配置使用经批准的精确版本 1.5.2，受 sap-dependency-security 管控，并通过 npm run validate:mcp-security 验证。从 v1.3.0 起，服务默认采用 lean 工具配置文件（精简的诊断范围）；在 MCP 环境中设置 DATASPHERE_TOOL_PROFILE=full，即可开放完整工具集。在你的运行环境加载服务并验证可用工具之前，应将 MCP 行为和实时租户工具数量视为待确认。

MCP 详情	值
命令	npx
参数	-y @mariodefe/[email protected]
必需环境变量	DATASPHERE_BASE_URL、DATASPHERE_CLIENT_ID、DATASPHERE_CLIENT_SECRET、DATASPHERE_TOKEN_URL
操作安全性	租户读取工具以及会产生修改或破坏性影响的工具；执行创建、更新、删除、重置、部署、发布或触发操作前，请先征求确认
回退方案	使用 Datasphere CLI/参考指南，并将实时检查标记为待确认

MCP 工具

MCP 服务支持：

• 直接查询： 对实时数据执行 SQL 和智能查询
• 元数据访问： 检查表、视图和分析模型
• 用户管理： 创建、更新、删除数据库用户
• 目录搜索： 按名称或列查找资产
• 连接测试： 验证连接性和租户信息
• 数据分析： 分析列分布

完整工具列表请参阅 /datasphere-mcp-tools 命令。

身份验证

OAuth 2.0 客户端凭据，支持自动刷新令牌。

必需的环境变量：

• DATASPHERE_BASE_URL
• DATASPHERE_CLIENT_ID
• DATASPHERE_CLIENT_SECRET
• DATASPHERE_TOKEN_URL

性能

性能取决于租户规模、网络延迟、有效负载大小、权限和服务版本。在目标租户中进行测量并记录为证据之前，应将 MCP 参考资料中的示例耗时或批处理限制视为仅供参考。

文件结构

plugins/sap-datasphere/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json                         # MCP server configuration
├── agents/
│   ├── datasphere-modeler.md
│   ├── datasphere-integration-advisor.md
│   └── datasphere-admin-helper.md
├── commands/
│   ├── datasphere-space-template.md
│   ├── datasphere-view-template.md
│   ├── datasphere-connection-guide.md
│   ├── datasphere-cli.md
│   └── datasphere-mcp-tools.md       # MCP tools reference
├── hooks/
│   └── hooks.json
└── skills/
    └── sap-datasphere/
        ├── .claude-plugin/
        │   └── plugin.json
        ├── SKILL.md
        ├── README.md
        └── references/
            ├── data-acquisition-preparation.md
            ├── data-modeling.md
            ├── graphical-sql-views.md
            ├── connectivity.md
            ├── administration.md
            ├── data-integration-monitor.md
            ├── data-access-security.md
            ├── content-transport.md
            ├── cli-commands.md
            ├── data-products-marketplace.md
            ├── catalog-governance.md
            ├── best-practices-patterns.md
            ├── whats-new-2025.md
            ├── whats-new-2026.md
            ├── business-data-cloud.md
            ├── mcp-tools-reference.md    # MCP technical reference
            ├── edge-cdp-control.md       # Edge CDP browser triage

文档链接

• SAP Help Portal：https://help.sap.com/docs/SAP_DATASPHERE
• 源代码仓库：https://github.com/SAP-docs/sap-datasphere
• SAP Community：https://community.sap.com/topics/datasphere
• API 参考：https://api.sap.com/package/saaborddatasphere

---