sap-datasphere

SAP Datasphere スキル

関連スキル

• sap-dependency-security：パッケージ管理ツールを使用する大規模なコネクターまたは統合プロジェクトで、依存関係のセキュリティポリシー、ロックファイルの衛生管理、および MCP サーバーの正確なバージョン固定に使用します

目次

• 概要
• クイックリファレンス
  • コアコンポーネント
  • オブジェクトの種類
• Data Builder
  • グラフィカルビュー
  • SQL ビュー
  • テーブル
  • フロー
  • タスクチェーン
• Business Builder
• 分析モデル
• 接続
• スペース管理
• データアクセス制御
• モニタリング
• CLI リファレンス
• データ製品とマーケットプレイス
• カタログとガバナンス
• コンテンツの移送
• 一般的な問題
• 同梱リソース
• ドキュメントへのリンク

概要

SAP Datasphere は、SAP Business Technology Platform（BTP）上で提供される SAP のクラウドネイティブなデータウェアハウスソリューションです。SAP Analytics Cloud、SAP HANA Cloud、SAP Databricks、および厳選されたデータ製品も含む、SAP の統合データ・分析プラットフォームである SAP Business Data Cloud（BDC） のデータ基盤として機能します。BDC のアーキテクチャと、その中での Datasphere の位置付けについては、references/business-data-cloud.md を参照してください。

このスキルでは、データの取得、準備、モデリング、管理、統合について包括的に説明します。

このスキルを使用する場合

次の場合にこのスキルを使用します：

• SAP BTP 上にデータウェアハウスを作成する
• SAP Analytics Cloud 用の分析モデルを構築する
• データフロー、レプリケーションフロー、または変換フローを設定する
• SAP システムまたはサードパーティーシステムへの接続を構成する
• スペース、ユーザー、アクセス制御を管理する
• リアルタイムのデータレプリケーションを実装する
• データ統合タスクをモニタリングする
• MCP、CLI、ログ、またはエクスポートされた成果物では必要な状態を確認できない場合に、Microsoft Edge で認証済みの Datasphere ブラウザー UI の状態を調査する

Datasphere のブラウザートリアージでは、手動でのアプリ内認証、同意を得たうえでの認証済み Edge プロファイルのコピー、新しいループバック CDP の起動、ターゲットの選択、復旧に、共通の sap-browser-automation スキルを使用してください。ローカルの references/edge-cdp-control.md アドオンには、Datasphere 固有の制限事項が記載されています。CDP は、Data Builder、Business Builder、モニタリング、接続、カタログ、管理 UI の状態をローカルで読み取り専用で調査するために使用してください。保存、デプロイ、削除、インポート、エクスポート、タスクチェーンの実行、またはユーザー／ロールの変更を行う前に、許可を求めてください。

---

クイックリファレンス

コアコンポーネント

コンポーネント	目的	主なオブジェクト
Data Builder	データの取得と準備	ビュー、テーブル、フロー、タスクチェーン
Business Builder	セマンティックレイヤーのモデリング	ビジネスエンティティ、ファクトモデル、コンシュームモデル
分析モデル	分析に適した構造	ディメンション、ファクト、メジャー、階層
接続	外部データソース	40 種類以上の接続タイプ
スペース	論理的なデータコンテナー	ストレージ、ユーザー、オブジェクト

オブジェクトの種類

ビュー：

• グラフィカルビュー：ドラッグ＆ドロップによるビジュアルデータモデリング
• SQL ビュー：SQL ベースのビュー定義
• 分析モデル：分析に最適化されたセマンティックレイヤー

テーブル：

• ローカルテーブル：Datasphere に保存されるデータ
• リモートテーブル：外部データへの仮想アクセス
• ローカルテーブル（ファイル）：オブジェクトストアベースのストレージ

フロー：

• データフロー：ETL 変換
• レプリケーションフロー：ソースからのデータレプリケーション
• 変換フロー：デルタを認識する変換

---

Data Builder

グラフィカルビュー

ソースをドラッグして変換を追加し、ビューを視覚的に作成します。

サポートされている操作：

• 結合：内部、左外部、右外部、完全外部、クロス
• ユニオン：複数のソースを結合
• プロジェクション：列を選択／名前変更
• フィルター：行レベルのフィルタリング
• 集計：集計関数を使ったグループ化
• 計算列：派生値

ベストプラクティス：

• 動的なフィルタリングには入力パラメーターを使用します
• 行レベルのセキュリティにはデータアクセス制御を適用します
• 頻繁にアクセスされるビューでは永続化を有効にします
• リネージ分析を使用して依存関係を把握します

グラフィカルビューの操作の詳細については、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パイプラインです。

オペレーター：

• ソース：リモート／ローカルのテーブル、ビュー
• ターゲット：ローカルテーブル
• 結合、ユニオン、プロジェクション、フィルター、集計
• スクリプト：Pythonによるカスタムロジック
• 計算列

実行：

• 手動実行、またはタスクチェーンによるスケジュール実行
• 増分ロードのための差分取得
• 実行時設定用の入力パラメーター

データフローの詳細については、references/data-acquisition-preparation.mdを参照してください。

レプリケーションフロー

ソースシステムからDatasphereまたは外部ターゲットにデータを複製します。

サポートされているソース：

• SAP S/4HANA（クラウド／オンプレミス）
• 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ビュー
• 実行モード：開始、削除、切り詰め

変換フローの詳細については、references/data-acquisition-preparation.mdを参照してください。

タスクチェーン

複数のタスクを順次または並列にオーケストレーションします。

サポートされているタスク：

• データフロー
• レプリケーションフロー
• 変換フロー
• リモートテーブルの複製
• ビューの永続化
• Open SQLプロシージャ
• APIタスク
• BW Bridgeプロセスチェーン

機能：

• 並列実行ブランチ
• 入力パラメーター
• メール通知
• ネストされたタスクチェーン
• スケジュール設定（シンプルまたはcron）

---

データモデリング

分析モデル

SAP Analytics Cloud向けに、分析に対応したセマンティックモデルを作成します。

コンポーネント：

• ファクト：メジャー（定量データ）を含みます
• ディメンション：データを分類します（マスターデータ）
• メジャー：定量化可能な指標です
• 階層：ナビゲーション構造です
• 変数：実行時パラメーターです

分析モデルの作成：

1. ファクトソース（ビューまたはテーブル）を追加します
2. ディメンションの関連付けを追加します
3. 集計方法を指定してメジャーを定義します
4. フィルタリング用の変数を設定します
5. データアクセス制御を設定します

モデリングの詳細なガイダンスについては、references/data-modeling.mdを参照してください。

ディメンション

分析データを分類し、フィルタリングします。

タイプ：

• 標準：基本的なカテゴリーデータ
• 時間：カレンダーベースのフィルタリング
• 会計期間：カスタム会計カレンダー
• テキストエンティティ：多言語ラベル

機能：

• 階層（レベルベース、親子）
• 時間依存性（SCDタイプ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
• Generic JDBC

ストリーミング：

• Apache Kafka
• Confluent

その他：

• Generic 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	マーケットプレイスの商品を一覧表示します

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 を参照してください。

---

データプロダクトとマーケットプレイス

データプロダクトの作成

厳選したデータをパッケージ化し、社内または社外で利用できるようにします。

1. 計画：目的、対象となる利用者、内容を定義します
2. 準備：ビュー／モデルを作成し、セマンティックな用途を設定して、ドキュメントを作成します
3. 設定：公開範囲、アクセス制御、利用条件を設定します
4. 公開：マーケットプレイスで利用できるようにします

プロダクトの構成要素：

• 中核となるアセット（ビュー、モデル、エンティティ）
• ドキュメントとサンプルクエリ
• ガバナンスのメタデータ（所有者、品質スコア、SLA）

データマーケットプレイス

公開済みのデータプロダクトを見つけて利用します。

• 検索：カテゴリ、プロバイダー、品質を基準に検索します
• アクセスをリクエスト：理由を提出し、承認を待ちます
• 利用：ビューまたは SAC ストーリーで使用します

マーケットプレイスの詳細なガイダンスについては、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 - SAP システム、クラウドプロバイダー、ストリーミングプラットフォームなど、40 種類以上の接続タイプすべて 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 年第 1～第 4 四半期の機能、Generic HTTP、REST API タスク、非推奨化 14. references/whats-new-2026.md - 2026 年の Datasphere／BDC 機能。第 1～第 2 四半期の更新や、HANA Cloud 計算ビューのセマンティックオンボーディング、レプリケーションフローのスケジュール設定、ランタイム設定のトランスポート、SAP Snowflake、SAPPHIRE の発表などの 2026.11 項目を含みます

プラットフォームの概要： 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 - 共通の sap-browser-automation Edge／CDP および認証レイヤー向けの、Datasphere 固有のアドオン

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 つの専門エージェント、5 つのスラッシュコマンド、検証フックが含まれています。

エージェント（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/ 内）：

• SQL／SQLScript コード品質を検証する PreToolUse
• 永続化と最適化に関する提案を行う PostToolUse

MCP 統合

このスキルには、SAP Datasphere MCP Server（@mariodefe/sap-datasphere-mcp）の接続レシピが含まれています。同梱の MCP 設定では、sap-dependency-security の管理下にあり、npm run validate:mcp-security で検証される、承認済みの正確なバージョン指定 1.5.2 を使用します。v1.3.0 以降、サーバーはデフォルトでleanツールプロファイル（診断対象を絞った構成）を使用します。ツールセット全体を利用するには、MCP の env に DATASPHERE_TOOL_PROFILE=full を設定してください。ハーネスがサーバーを読み込み、利用可能なツールを確認するまでは、MCP の動作と稼働中のテナントにおけるツール数は未確認として扱ってください。

MCP の詳細	値
コマンド	npx
引数	-y @mariodefe/[email protected]
必須 env	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

---