在 SAP BTP 上构建、建模、集成、管理、监控和迁移…

适用于在 SAP Datasphere / SAP BTP 上进行数据仓库开发、数据集成、空间与权限管理、内容传输、CLI/MCP 自动化，以及用 Edge CDP 只读检查已认证浏览器 UI 状态。

适用场景

解决思路

1. 在大型连接器或集成项目使用包管理工具时，结合 sap-dependency-security 处理安全依赖策略、lockfile 卫生和精确 MCP server pin。
2. 使用 Data Builder 做数据获取与准备，并管理 Views、Tables、Flows、Task Chains。
3. 使用 Business Builder 做语义层建模，并管理 Business Entities、Fact Models、Consumption Models。
4. 使用 Analytic Model 创建分析就绪结构，并管理 Dimensions、Facts、Measures、Hierarchies。
5. 通过 Connections 接入外部数据源；支持 40+ connection types。
6. 使用 Spaces 作为逻辑数据容器，并管理存储、用户、对象。
7. 创建 Graphical View 时通过拖拽源并添加转换进行可视化建模。
8. 创建 SQL View 时用 SQL 定义视图。
9. 创建 Analytic Model 时用分析优化的语义层。
10. 创建 Local Table 时把数据存储在 Datasphere。
11. 创建 Remote Table 时虚拟访问外部数据。
12. 创建 Local Table (File) 时使用 object store-based storage。
13. 创建 Data Flow 时构建 ETL transformations。
14. 创建 Replication Flow 时从源复制数据。
15. 创建 Transformation Flow 时做 delta-aware transformations。
16. Graphical View 支持 Join：Inner、Left Outer、Right Outer、Full Outer、Cross。
17. Graphical View 支持 Union：合并多个源。
18. Graphical View 支持 Projection：选择/重命名列。
19. Graphical View 支持 Filter：行级过滤。
20. Graphical View 支持 Aggregation：Group by 加聚合。
21. Graphical View 支持 Calculated Columns：派生值。
22. Graphical View 最佳实践：使用 input parameters 做动态过滤。
23. Graphical View 最佳实践：应用 data access controls 做行级安全。
24. Graphical View 最佳实践：对频繁访问视图启用 persistence。
25. Graphical View 最佳实践：使用 lineage analysis 理解依赖。
26. 创建 SQL View 时使用 SQL 或 SQLScript。
27. SQL View 示例：SELECT customer_id, customer_name, SUM(order_amount) AS total_orders FROM orders GROUP BY customer_id, customer_name。
28. SQLScript 支持 table variables。
29. SQLScript 支持 scalar variables。
30. SQLScript 支持 control flow（IF、WHILE、FOR）。
31. SQLScript 支持 exception handling。
32. Data Flow 的 operators 包含 Source：remote/local tables、views。
33. Data Flow 的 Target：local tables。
34. Data Flow 支持 Join、Union、Projection、Filter、Aggregation。
35. Data Flow 支持 Script：Python 自定义逻辑。
36. Data Flow 支持 Calculated Columns。
37. 执行 Data Flow：手动运行或通过 task chains 调度。
38. 执行 Data Flow：使用 delta capture 做增量加载。
39. 执行 Data Flow：使用 input parameters 做运行时配置。
40. Replication Flow 支持源：SAP S/4HANA（Cloud/On-Premise）、SAP BW/4HANA、SAP ECC、ABAP-based systems、Cloud storage（S3、Azure Blob、GCS）、Kafka/Confluent、SFTP。
41. Replication Flow 支持目标：SAP Datasphere（local tables）、Apache Kafka、Google BigQuery、Cloud storage providers、SAP Signavio。
42. Replication Flow 的 Load Types：Initial Load 做全量提取。
43. Replication Flow 的 Load Types：Delta Load 仅取变更数据。
44. Replication Flow 的 Load Types：Real-Time 做持续复制。
45. Transformation Flow 做 delta-aware transformations，并自动传播变更。
46. Transformation Flow 关键特性：automatic delta detection。
47. Transformation Flow 关键特性：target table management。
48. Transformation Flow 关键特性：Graphical 或 SQL view 作为源。
49. Transformation Flow 的 Run modes：Start、Delete、Truncate。
50. Task Chain 按顺序或并行编排多个任务。
51. Task Chain 支持任务：Data flows、Replication flows、Transformation flows、Remote table replication、View persistence、Open SQL procedures、API tasks、BW Bridge process chains。
52. Task Chain 功能：parallel execution branches。
53. Task Chain 功能：input parameters。
54. Task Chain 功能：email notifications。
55. Task Chain 功能：nested task chains。
56. Task Chain 功能：scheduling（simple 或 cron）。
57. 创建 Analytic Model：1）添加 fact source（view 或 table）。
58. 创建 Analytic Model：2）添加 dimension associations。
59. 创建 Analytic Model：3）定义 measures with aggregation。
60. 创建 Analytic Model：4）配置 variables for filtering。
61. 创建 Analytic Model：5）设置 data access controls。
62. Analytic Model 组件：Fact 包含 measures（quantitative data）。
63. Analytic Model 组件：Dimension 对数据分类（master data）。
64. Analytic Model 组件：Measure 是可量化指标。
65. Analytic Model 组件：Hierarchy 是 navigation structures。
66. Analytic Model 组件：Variable 是 runtime parameters。
67. Dimensions 类型：Standard。
68. Dimensions 类型：Time。
69. Dimensions 类型：Fiscal Time。
70. Dimensions 类型：Text Entity。
71. Dimension 功能：Hierarchies（level-based、parent-child）。
72. Dimension 功能：Time dependency（SCD Type 2）。
73. Dimension 功能：Compound keys。
74. Dimension 功能：Associated text entities。
75. Measures 类型：Simple。
76. Measures 类型：Calculated。
77. Measures 类型：Restricted。
78. Measures 类型：Currency Conversion。
79. Measures 类型：Unit Conversion。
80. Measures 类型：Count Distinct。
81. Measures 类型：Non-Cumulative。
82. Aggregation Types：SUM、MIN、MAX、COUNT、AVG。
83. 对 non-additive scenarios 使用 exception aggregation。
84. Business Builder 创建 business-oriented semantic models。
85. Business Builder 对象：Business Entity 可复用 dimension/fact definitions。
86. Business Builder 对象：Fact Model 组合 business entities。
87. Business Builder 对象：Consumption Model 是 analytics-ready model。
88. Business Builder 对象：Authorization Scenario 做 row-level security。
89. 配置 SAP Systems 连接：SAP S/4HANA Cloud/On-Premise、SAP BW/4HANA（Model Transfer）、SAP BW Bridge、SAP ECC、SAP HANA（Cloud/On-Premise）、SAP SuccessFactors、SAP Fieldglass、SAP Marketing Cloud、SAP Signavio。
90. 配置 Cloud Platforms 连接：Amazon S3、Athena、Redshift、Google Cloud Storage、BigQuery、Microsoft Azure Blob、Data Lake、SQL Database、Microsoft OneLake。
91. 配置 Databases 连接：Oracle、Microsoft SQL Server、Generic JDBC。
92. 配置 Streaming 连接：Apache Kafka、Confluent。
93. 配置 Other 连接：Generic OData、HTTP、SFTP、Adverity、Precog、SAP Open Connectors。
94. Connection 功能：Remote Tables 做虚拟数据访问。
95. Connection 功能：Data Flows 做 ETL transformation。
96. Connection 功能：Replication Flows 做数据复制。
97. Connection 功能：Model Import 做 BW/4HANA model transfer。
98. Space 配置：storage allocation（disk + in-memory）。
99. Space 配置：user access and roles。
100. Space 配置：priority and statement limits。
101. Space 配置：workload management。
102. Space 操作：创建、复制、删除 spaces。
103. Space 操作：导出/导入 space data。
104. Space 操作：用命令行管理（datasphere CLI）。
105. 使用标准角色：DW Administrator、DW Space Administrator、DW Integrator、DW Modeler、DW Viewer。
106. 使用 Scoped Roles：space-specific permissions 和 custom privilege combinations。
107. 认证：SAP Cloud Identity Services、Custom SAML IdP、OAuth 2.0 clients。
108. 监控 capacity（storage、memory、compute）。
109. 监控 audit logs（database operations）。
110. 监控 activity logs（object changes）。
111. 监控 task logs（flow executions）。
112. 数据库分析：创建 analysis users 用于调试。
113. 数据库分析：监控 HANA views。
114. 数据库分析：停止运行中的 statements。
115. Remote Tables 操作：Replicate data（full/delta/real-time）。
116. Remote Tables 操作：Partition data loads。
117. Remote Tables 操作：Create statistics。
118. Remote Tables 操作：Monitor queries。
119. Real-Time Replication 功能：continuous change capture。
120. Real-Time Replication 功能：Pause/resume capability。
121. Real-Time Replication 功能：Automatic recovery。
122. Real-Time Replication 功能：Watermark tracking。
123. View Persistence 选项：scheduled refresh。
124. View Persistence 选项：on-demand refresh。
125. View Persistence 选项：partition management。
126. View Persistence 选项：memory optimization。
127. 安装 datasphere CLI：npm install -g @sap/datasphere-cli。
128. 交互式登录：datasphere config auth login。
129. CI/CD 服务密钥登录：datasphere config auth login --service-key-path ./key.json。
130. Core commands：datasphere spaces list 列出所有 spaces。
131. Core commands：datasphere spaces create 创建 space。
132. Core commands：datasphere objects export 导出对象。
133. Core commands：datasphere objects import 导入对象。
134. Core commands：datasphere tasks run 执行 task chains。
135. Core commands：datasphere marketplace list 列出 marketplace products。
136. CI/CD 导出导入：datasphere objects export --space DEV --output-file package.zip。
137. CI/CD 导出导入：datasphere objects import --space PROD --input-file package.zip --overwrite。
138. 创建 Data Product：Plan 定义 purpose、target consumers、contents。
139. 创建 Data Product：Prepare 创建 views/models、设置 semantic usage、记录文档。
140. 创建 Data Product：Configure 设置 visibility、access controls、terms。
141. 创建 Data Product：Publish 在 marketplace 中提供。
142. Product 组件：core assets（views、models、entities）。
143. Product 组件：documentation and sample queries。
144. Product 组件：governance metadata（owner、quality score、SLA）。
145. Data Marketplace 消费：Search 按 category、provider、quality 查找。
146. Data Marketplace 消费：Request Access 提交 justification 并等待 approval。
147. Data Marketplace 消费：Consume 在 views 或 SAC stories 中使用。
148. Data Catalog：Asset Discovery 用 metadata 搜索所有数据对象。
149. Data Catalog：Glossary 标准化业务术语定义。
150. Data Catalog：Data Quality 自动质量规则和评分。
151. Data Catalog：Lineage 追踪从源到消费。
152. Data Catalog：Classification 敏感级别和合规标签。
153. Governance workflow：Create Object → Add Metadata → Link Terms → Quality Check → Approve → Publish。
154. Governance 角色：Data Owner 业务问责。
155. Governance 角色：Data Steward 质量和 metadata 管理。
156. Governance 角色：Data Custodian 技术实现。
157. Data Access Controls 类型：Single Values 做简单值匹配。
158. Data Access Controls 类型：Operator and Values 做复杂条件。
159. Data Access Controls 类型：Hierarchy 做基于节点过滤。
160. Data Access Controls 类型：Hierarchy with Directory 做分层权限。
161. 应用 DAC：应用到 views 或 analytic models。
162. 应用 DAC：基于 user attributes。
163. 应用 DAC：从 SAP BW Analysis Authorizations 导入。
164. Content transport 方法：Export/Import packages。
165. Content transport 方法：SAP Cloud Transport Management。
166. Content transport 方法：CSN/JSON file export。
167. Package contents：Views、tables、flows。
168. Package contents：Connections（仅 metadata）。
169. Package contents：Spaces configuration。
170. Error Deployment failed：检查对象依赖（circular dependency）。
171. Error Connection timeout：验证 Cloud Connector/IP allowlist。
172. Error Replication stuck：检查源系统状态（source lock）。
173. Error Out of memory：启用 persistence 或 partitioning。
174. Error Permission denied：验证 space membership 和 privileges。
175. 查阅 references/data-acquisition-preparation.md 获取 data flows、replication flows、transformation flows 和 table management。
176. 查阅 references/graphical-sql-views.md 获取 graphical views、SQL views、E-R models 和 intelligent lookups。
177. 查阅 references/data-modeling.md 获取 Business Builder entities、analytic models、dimensions、measures 和 hierarchies。
178. 查阅 references/connectivity.md 获取 40+ connection types。
179. 查阅 references/data-integration-monitor.md 获取 task scheduling、monitoring、real-time replication 和 delta mechanisms。
180. 查阅 references/administration.md 获取 tenant management、space configuration、user roles 和 elastic compute nodes。
181. 查阅 references/data-access-security.md 获取 row-level security、DAC configurations 和 authorization scenarios。
182. 查阅 references/content-transport.md 获取 package export/import、transport management 和 tenant migration。
183. 查阅 references/cli-commands.md 获取 complete CLI reference、authentication、CI/CD integration patterns。
184. 查阅 references/data-products-marketplace.md 获取 creating/consuming data products、provider workflows、pricing。
185. 查阅 references/catalog-governance.md 获取 data catalog、glossary、quality rules、lineage、classification。
186. 查阅 references/best-practices-patterns.md 获取 architecture patterns、naming conventions、performance optimization、checklists。
187. 查阅 references/whats-new-2025.md 获取 2025 archive、Generic HTTP、REST API tasks、deprecations。
188. 查阅 references/whats-new-2026.md 获取 2026 Datasphere/BDC features、HANA Cloud calculation-view semantic onboarding、replication-flow scheduling、runtime-settings transport、SAP Snowflake、SAPPHIRE announcements。
189. 查阅 references/business-data-cloud.md 获取 SAP Business Data Cloud architecture、Databricks integration、data products vs marketplace、BDC Connect。
190. 查阅 references/mcp-tools-reference.md 获取 complete MCP tool reference、45 tools across 8 categories、API documentation、authentication patterns。
191. 查阅 references/mcp-use-cases.md 获取 8 个 illustrative source-material use cases、personas、planning assumptions。
192. 查阅 references/edge-cdp-control.md 获取 Datasphere-specific Edge/CDP 和 authentication add-on。
193. 加载 MCP references 前先搜索。
194. 使用 rg -n "<space|view|connection|task|lineage|marketplace|governance|admin>" references/mcp-*.md 定位 exact tool 或 scenario，然后只打开该 excerpt。
195. 使用 references/mcp-tools-reference.md 查 tool names、inputs、direct tenant-operation boundaries。
196. 仅在选择 workflow pattern 或 review illustrative impact assumptions 时使用 references/mcp-use-cases.md；普通工具查找不要加载完整 use-case guide。
197. 如果 MCP access unavailable，回退到 matching CLI/reference command，并标记 tenant checks pending。
198. 使用 agents：datasphere-modeler 处理 Data Builder tasks、views、flows、analytic models。
199. 使用 agents：datasphere-integration-advisor 处理 connectivity、replication、data integration。
200. 使用 agents：datasphere-admin-helper 处理 space management、security、monitoring。
201. 使用 commands：/datasphere-space-template 生成 space configurations。
202. 使用 commands：/datasphere-view-template 生成 view templates（graphical/SQL）。
203. 使用 commands：/datasphere-connection-guide 获取 step-by-step connection setup。
204. 使用 commands：/datasphere-cli 获取 CLI command reference and examples。
205. 使用 commands：/datasphere-mcp-tools 获取 SAP Datasphere MCP tool reference and usage guidance。
206. 使用 hooks：PreToolUse validation for SQL/SQLScript code quality。
207. 使用 hooks：PostToolUse suggestions for persistence and optimization。
208. MCP 集成使用 @mariodefe/sap-datasphere-mcp。
209. 使用 approved exact pin 1.5.2。
210. 该 MCP 受 sap-dependency-security 治理，并由 npm run validate:mcp-security 验证。
211. 自 v1.3.0 起 server 默认 lean tool profile；在 MCP env 设置 DATASPHERE_TOOL_PROFILE=full 以暴露完整工具集。
212. 在 harness 加载 server 并验证 available tools 前，把 MCP behavior 和 live tenant tool counts 标记为 pending。
213. MCP Command：npx。
214. MCP Args：-y @mariodefe/sap-datasphere-mcp@1.5.2。
215. MCP Required env：DATASPHERE_BASE_URL、DATASPHERE_CLIENT_ID、DATASPHERE_CLIENT_SECRET、DATASPHERE_TOKEN_URL。
216. MCP Operation safety：有 tenant read tools 加 mutating/destructive tools；在 create、update、delete、reset、deploy、publish、trigger 前先询问。
217. MCP Fallback：使用 Datasphere CLI/reference guidance，并标记 live checks pending。
218. MCP 直接查询：执行 SQL 和 smart queries on live data。
219. MCP 元数据访问：检查 tables、views、analytic models。
220. MCP 用户管理：创建、更新、删除 database users。
221. MCP Catalog Search：按 name 或 column 查找 assets。
222. MCP Connection Testing：验证 connectivity 和 tenant info。
223. MCP Data Profiling：分析 column distributions。
224. MCP 认证：OAuth 2.0 Client Credentials with automatic token refresh。
225. MCP 认证必需 env vars：DATASPHERE_BASE_URL、DATASPHERE_CLIENT_ID、DATASPHERE_CLIENT_SECRET、DATASPHERE_TOKEN_URL。
226. MCP 性能依赖 tenant size、network latency、payload size、permissions、server version。
227. 将 MCP reference material 中的 example timings 或 batch limits 视为 illustrative，直到在目标 tenant 测量并记录为 evidence。
228. 当 MCP、CLI、logs 或 exported artifacts 无法观察所需状态时，用 Microsoft Edge CDP 检查 authenticated Datasphere browser UI state。
229. Datasphere browser triage 使用共享 sap-browser-automation skill 做 manual in-app authentication、consent-gated authenticated Edge profile copying、fresh loopback CDP startup、target selection、recovery。
230. 本地 references/edge-cdp-control.md add-on 保留 Datasphere-specific boundaries。
231. 用 CDP 对 Data Builder、Business Builder、monitoring、connection、catalog、admin UI state 做 local read-only inspection。
232. 在 saving、deploying、deleting、importing、exporting、running task chains、changing users/roles 前先询问。
233. 文档：SAP Help Portal https://help.sap.com/docs/SAP_DATASPHERE。
234. 源码仓库：https://github.com/SAP-docs/sap-datasphere。
235. SAP Community：https://community.sap.com/topics/datasphere。
236. API Reference：https://api.sap.com/package/saaborddatasphere。

适用边界 · 注意事项

• 不适用于非 SAP Datasphere / SAP BTP 的数据仓库或分析平台场景。
• 不适用于没有 SAP Datasphere 租户、MCP/CLI 凭证或无法使用 SAP 专有工具与服务的情况。
• 不要未经确认用 Edge CDP 执行保存、部署、删除、导入、导出、运行 task chain 或修改用户/角色等写操作。