Microsoft Fabric 拡張性ツールキット バリデーター

Microsoft Fabric Extensibility Toolkit Validator は、Microsoft Fabric ワークロード用の包括的な検証ツールです。 これは、発行元が公式の認定を申請する前に、Microsoft Fabric の要件に照らしてワークロードを検証するのに役立ちます。

このツールは、Fabric ワークロードを開発している外部パートナーや顧客向けの パブリック検証ツール です。

概要

検証ツールを使用すると、ワークロード作成者は Microsoft Fabric ワークロードを自己検証できます。 開発プロセスの早い段階で潜在的な問題を特定できるように設計されており、公式の検証プロセスが成功する可能性が高くなります。

Important

自己検証の成功は公式の検証に合格しても保証されませんが、一般的な問題を早期にキャッチすることで成功の可能性が大幅に向上します。

[前提条件]

• Node.js (バージョン 14 以降)
• Fabric ワークロード ハブにアクセスできる Microsoft Fabric アカウント
• Chrome/Chromium ブラウザー (マニフェストの自動ダウンロード用)
• Microsoft Fabric Extensibility Toolkit を使用して構築されたワークロード パッケージ
• 発行済みワークロード - 検証を開始する前に、ワークロードをテナントに発行する必要があります。

ヒント

検証には、発行に使用されるテナントとは異なるテナントを使用します。 これにより、エンド ユーザーに表示される内容を体験でき、より現実的な検証環境が提供されます。

概要

1. ワークロードを構築する

まず、公式のスターター キットを使用してワークロードを作成します。

1. Fabric Extensibility Toolkit (スターター キット) を複製します。
2. ツールキットのドキュメントに従ってワークロードを構築します。

2. 依存関係をインストールする

バリデーター ディレクトリに移動し、依存関係をインストールします。

cd fabric-extensibility-toolkit-validator/validator
npm install

3. 基本的な検証

ワークロードの完全な検証を実行します。

基本的な検証コマンド

node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"

実際のワークロードの例

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"

GA ステージ ワークロードの場合

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"

注

検証を実行する前に、ブラウザーで Microsoft Fabric にログインしていることを確認し、ワークロードがターゲット テナントで公開され、アクセスできることを確認します。

コマンドライン オプション

Option	Description	Example
--workload-name	完全なワークロード名 (Publisher.Product)	"Contoso.DataProcessor"
--workload-stage	検証ステージ	"Preview" または "GA"
--help	ヘルプ情報を表示する	(フラグのみ)

検証プロセス

検証コントロールは、いくつかのステージを実行します。

1. マニフェストのダウンロード - Fabric Workload Hub からワークロード マニフェストを自動的にダウンロードします。
2. テスト検出 - ワークロードの種類に基づいて、適用可能なテスト ケースを識別します。
3. テスト実行 - 構成された検証コントロール (自動と手動の両方) を使用して検証テストを実行します。
4. レポートの生成 - 複数の形式で包括的なレポートを作成します。

出力構造

検証後、 Results ディレクトリに結果が表示されます。

Results/
├── YourPublisher.YourWorkload/
│   └── Preview/
│       └── [ValidationID]/
│           ├── YourPublisher.YourWorkload_Metadata.json
│           ├── YourPublisher.YourWorkload_Manifest.json
│           ├── YourPublisher.YourWorkload_Workload_Tests.json
│           ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│           └── Reports/
│               ├── ValidationReport.md
│               ├── ValidationReport.html
│               └── ValidationReport.pdf

バリデーター

このツールでは、一連の特殊なバリデーターを使用して、ワークロードのさまざまな側面を確認します。 一部の検証コントロールは自動化されていますが、手動操作が必要なバリデーターもあります。

トラブルシューティング

ブラウザーの問題

• Chrome/Chromium がインストールされ、アクセスできることを確認します。
• ブラウザーで Microsoft Fabric にログインしていることを確認します。
• Fabric サービスへのネットワーク接続を確認します。

マニフェストのダウンロードに関する問題

• ワークロード名が正確に一致するかどうかを確認します (大文字と小文字が区別されます)。
• Fabric Workload Hub でワークロードがデプロイされ、アクセスできることを確認します。
• 認証とアクセス許可を確認します。

テスト実行の問題

• 結果ディレクトリで検証ログを確認します。
• validator/validators/で個々のテスト ケースのドキュメントを確認します。
• 必要なすべてのワークロード資産にアクセス可能であることを確認します。

関連コンテンツ

• Microsoft Fabric Extensibility Toolkit - Fabric ワークロードを構築するための公式スターター キット