Power Query コネクタ認定

[アーティクル]
01/18/2024

Note

この記事では、認定のために Power Query カスタムコネクタを提出するための要件とプロセスについて説明します。認定プロセスを開始する前に、記事全体をよくお読みください。

はじめに

Power Query SDK を使用すると、すべてのユーザーが Power Query からデータソースに接続するカスタム Power Query コネクタを作成できます。現在、カスタムコネクタは Power BI セマンティックモデル (Power BI Desktop および Power BI サービス) でのみサポートされており、Power BI サービスを介して更新するにはオンプレミスデータゲートウェイを使用する必要があります。カスタムコネクタは、開発者が個別に配布する必要があります。

データソースのカスタムコネクタを開発するデータソース所有者は、カスタムコネクタをより広範に Power Query ユーザーに配布する必要がある場合があります。カスタムコネクタがエンドユーザーによって作成、使用、検証されると、データソース所有者は、Microsoft の認定を受けるためにこれを提出することができます。

Power Query カスタムコネクタが認定されると、そのコネクタは Power BI セマンティックモデル (Power BI Desktop およびPower BI サービス)、Power BI データフロー、および Power BI データマート内で、すぐに使用できる状態で公開されます。認定コネクタは、PowerBI.com およびすべてのバージョンの Power BI Premium でサポートされます。

認定コネクタは:

パートナー開発者によって管理されます
パートナー開発者によってサポートされます
Microsoft によって認定されます
Microsoft によって配布されます

私たちはパートナーと協力してそれらのサポートが維持されるようにしますが、コネクタ自体に関する顧客の問題は、パートナー開発者に送られます。

認定コネクタとカスタムコネクタの違い

認定コネクタは、既定のコネクタとして Power BI Desktop にバンドルされ、Power BI サービス、Power BI データフロー、および Power BI データマートにデプロイされます。カスタムコネクタは Power BI セマンティックモデルでのみサポートされており、「Power BI Desktopでの拡張機能の読み込み」の説明に従って、Power BI Desktop に読み込む必要があります。認定コネクタとカスタムコネクタはどちらも、を実装することで、オンプレミスデータゲートウェイを使用して Power BI Desktop または Power BI サービスで更新できます。カスタムコネクタには、オンプレミスデータゲートウェイが必要です。

TestConnection を実装した Power BI Desktop の認定コネクタでは、オンプレミスデータゲートウェイを必要としない、クラウド (Power BI サービス) を使用したエンドツーエンドの更新もサポートします。 Power BI サービス環境では、基本的に、オンプレミスゲートウェイと同様に実行される"クラウドゲートウェイ" がホストされます。認定後は、Microsoft によってこの環境にコネクタが展開され、Power BI のすべてのお客様が利用できるようになります。

追加のコンポーネント (ODBC ドライバーなど) を使用するカスタムコネクタと認定コネクタの両方で、追加のコンポーネントが Power BI クラウドにデプロイされていない限り、追加のコンポーネントをエンドユーザーマシンにインストールする必要があり、オンプレミスデータゲートウェイが必要になります。現時点では、新しい追加コンポーネントの認定と Power BI クラウドへのデプロイを行っていません。そのため、追加のコンポーネントに依存するコネクタの認定では、オンプレミスデータゲートウェイの要件は削除されません。

カスタムコネクタの配布

カスタムコネクタは、認定を受ける前にエンドユーザーに配布でき、配布する必要があります。

M は多目的の言語であり、「認証の処理」で見られるように、保存された資格情報と対話する機能を備えています。そのため、私たちは信頼されたコネクタの実行だけを許可する方法をユーザーに提供する必要があります。

開発者の観点から見た場合、開発者はカスタムコネクタを自己署名し、安全に読み込むための情報 (拇印) をユーザーに提供する必要があります。

ユーザーの観点から見た場合、ユーザーは開発者から提供された拇印を使い、安全にカスタムコネクタの信頼と読み込みを行い、使用する必要があります。また、ユーザーはセキュリティの設定を低くして、マイクロソフトまたは別の開発者によって認定されていないコードの読み込みを許可することもできますが、このオプションはお勧めしません。

認定の概要

前提条件

お客様の最適なエクスペリエンスを実現するために、認定の一連の前提条件を満たすコネクタのみが検討されます。

コネクタはパブリックな製品用である必要があります。
コネクタは、初期リリースバージョンのコードコンプリートと見なす必要があります。プログラムでは、頻繁なイテレーションや更新が許可されています。 Microsoft は、技術的なサポートやカスタムコネクタ開発のコンサルティングを提供していないことに注意してください。 SDK ドキュメントやサンプルリポジトリなどのパブリックリソースを利用することをお勧めします。さらにサポートが必要な場合は、Microsoft のプログラムやパートナーシップとは別に、既知のサードパーティ業界のカスタムコネクタ開発コンサルタントの一覧を共有できます。 Microsoft はこれらのコンサルタントのいずれとも提携しておらず、そのサービスの使用に対して責任を負いません。 Microsoft は、お客様の便宜のために、保証、推奨事項、または保証なしで一覧を提供します。詳細については、Microsoft 認定の連絡先にお問い合わせください。
開発者は、使用の見積もりを提供する必要があります。非常に専門的な製品用のコネクタの開発者は、Microsoft のコネクタ自己署名機能を使って、顧客に直接提供することをお勧めします。
コネクタは、ユーザーのニーズやビジネスシナリオを満たすために、顧客が直接利用できる状態になっている必要があります。これは、プライベートプレビュープログラムを使用し、自己署名を通じて完成したコネクタをエンドユーザーと組織に直接配布することで実行できます。各ユーザーまたは組織は、コネクタにビジネスニーズがあり、コネクタがビジネス要件を満たすために正常に機能しているというフィードバックと検証を提供できる必要があります。
コネクタは、顧客が予想する使用のレベルで正常に動作する必要があります。
コネクタを Power BI Desktop で一般公開する需要を確認するために、顧客によって推進されるスレッドが Power BI Ideas フォーラムに存在している必要があります。エンゲージメントのしきい値は設定されていません。しかし、エンゲージメントが多いほど、コネクタに対するより大きな需要が証明されます。

これらの前提条件は、認定を受けるコネクタに顧客とビジネスの大きなニーズがあり、認定後も使用およびサポートされることを保証するために存在します。

プロセスとタイムライン

認定コネクタは毎月の Power BI Desktop リリースでリリースされます。そのため、各リリースの期限は、Power BI Desktop の各リリース日から逆算されます。登録からリリースまでの認定プロセスに予想される期間は、コネクタの申請の品質と複雑さによって異なります。 Microsoft は、コネクタのレビューと承認に関して具体的なタイムラインの保証を提供していません。各コネクタのレビューの期限が厳しいことについては、次の手順で概説されますが、Microsoft はこれらのタイムラインへの準拠を保証していません。

登録: カスタムコネクタを認定する意図を示す通知。この登録は、目標の Power BI Desktop リリースの 2 か月前に、その月の 15 日までに実行する必要があります。
- たとえば、4 月の Power BI Desktop リリースの場合、期限は 2 月 15 日になります。
提出: Microsoft によるレビューのためのコネクタファイルの提出。この申請は、対象となる Power BI Desktop リリース前の月の 1 日までに行う必要があります。
- たとえば、4 月の Power BI Desktop リリースの場合、期限は 3 月 1 日になります。
テクニカルレビュー: コネクタファイルの完成、Microsoft によるレビューと認定の合格。このレビューは、対象となる Power BI Desktop リリース前の月の 15 日までに行う必要があります。
- たとえば、4 月の Power BI Desktop リリースの場合、期限は 3 月 15 日になります。

テクニカルレビューの複雑さと、遅延、アーキテクチャ変更、テスト上の問題の可能性のため、早期に提出し、初期リリースと認定のために長いリードタイムを設けることを強くお勧めします。最小限のオーバーヘッドで少数の顧客に配信することがコネクタにとって重要であると思われる場合は、自己署名を使って提供することをお勧めします。

認定要件

認定に関する一連の要件があります。私たちは、すべての開発者がこれらの要件を満たせるわけではないことを認識しており、開発者のニーズを迅速に処理できる機能セットの導入を予定しています。

提出ファイル (成果物)

提出するコネクタファイルに次のすべてが含まれていることを確認します。

コネクタ (.mez) ファイル
- .mez ファイルは、スタイル標準に準拠しており、製品名またはサービス名と同じような名前が付けられている必要があります。 "Power BI"、"コネクタ"、"API" などの単語を含めることはできません。
- .mez ファイルに名前を指定します: ProductName.mez
テスト用の Power BI Desktop (.pbix) ファイル
- コネクタのテストに使用するサンプル Power BI レポート (.pbix) が必要です。
- レポートには、ナビゲーションテーブル内の各項目をテストするクエリが少なくとも 1 つ含まれている必要があります。
- セットスキーマ (データベースなど) がない場合、レポートには、コネクタが処理できるテーブルの "種類" ごとにクエリを含める必要があります。
データソースへのテストアカウント
- コネクタのテストとトラブルシューティングは、テストアカウントを使用して行われます。
- 今後の更新も同じアカウントを使って認定できるように、永続的なテストアカウントを指定してください。
テスト手順
- コネクタを使ってその機能をテストする方法についてのドキュメントを提供してください。
外部依存関係 (例: ODBC ドライバー) へのリンク

機能とスタイル

コネクタは、機能とスタイルの規則のセットに従い、その他の認定コネクタと一致するユーザビリティの標準を満たす必要があります。

コネクタは以下の条件を満たす必要があります。
- セクションドキュメント形式を使用する。
- セクションドキュメントの上に、バージョンヘッダー/装飾を含めます。
- 関数ドキュメントのメタデータを指定する。
- TestConnection ハンドラーがある。
- 名前付け規則に従っている (例: DataSourceKind.FunctionName)。 "Power BI"、"コネクタ"、"API" などの単語を含めることはできません。
- 初期リリースではベータフラグを True に設定します。
FunctionName は、ドメインにとって意味をなすものである必要があります (例: "Contents"、"Tables"、"Document"、"Databases" など)。
コネクタは以下の条件を満たすべきです。
- アイコンがある。
- ナビゲーションテーブルを提供する。
- resources.resx ファイルに文字列を配置する。 URL と値はコネクタコード内でハードコーディングすべきであり、resources.resx ファイルに配置すべきではありません。

セキュリティ

コネクタで処理する必要がある、セキュリティ上の特定の考慮事項があります。

Extension.CurrentCredentials() が使用されている場合:
- その使用は必須ですか。そうである場合、資格情報はどこに送信されますか。
- 要求は HTTPS 経由で行われることが保証されますか。
  - HTTPS 強制ヘルパー関数を使用できます。
- 資格情報が Web.Contents() を使って GET 経由で送信される場合:
  - それは POST に変換できますか。
  - GET が必須の場合、コネクタでは Web.Contents() オプションレコードの CredentialQueryString レコードを使用して、機密性の高い資格情報を渡す必要があります。
Diagnostics.* 関数が使用されている場合:
- トレースされている内容を検証してください。データに PII または大量の不要なデータが含まれてはなりません。
- 開発で重要なトレースを実装した場合は、トレースを有効にすべきかどうかを決定する変数または機能フラグを実装する必要があります。このトレースは、認定用の提出を行う前にオフにする必要があります。
Expression.Evaluate() が使用されている場合:
- 式の取得場所と、その内容 (つまり、Extension.CurrentCredentials() への呼び出しを動的に作成できる、など) を検証してください。
- Expression は、ユーザーが指定したものだったり、ユーザーによる入力を受け取ったりすべきではありません。
- Expression は、動的である (つまり、Web 呼び出しから取得される) べきではありません。

認定への登録

カスタムコネクタの認定を取得することに関心がある場合は、ご自分のシナリオとコネクタが、この記事で説明している前提条件と要件を満たしていることを確認してください。満たしていない場合、認定に進む前に私たちのチームがお客様に問題や不整合の修正を求めるため、認定が遅れる原因となります。

コネクタは、コード完成であり、Power BI Desktop での作成と Power BI サービスでの更新および使用の両方についてテスト済みである必要があります。オンプレミスデータゲートウェイを使用して、Power BI サービスでの完全なエンドツーエンドの更新がテスト済みである必要があります。

開始するには、登録フォームに入力してください。プロセスを開始するために、Microsoft の担当者がご連絡いたします。

認定後

Power BI Desktop とPower BI サービスを使用してコネクタが認定され、リリースされた後、運用環境でデプロイされた一般に公開されている認定コネクタを正しく使用できるようにするために、いくつかの操作を行う必要があります。

お客様とエンドユーザーは、Power BI Desktop に含まれている認定済みコネクタバージョンとオンプレミスデータゲートウェイを使用し、認定前に使用されている既存の .mez または .pqx ファイル (カスタムコネクタ) を削除する必要があります。これを行わないと、テスト用のカスタムコネクタが、新しく認定されたコネクタではなく、誤って Power Query によって使用される可能性があります。
カスタムコネクタは、コネクタの新しいバージョンをテストするためにのみ使用する必要があります。
エンドユーザーと顧客が連携する場合は、テストが完了し、新しい認定コネクタバージョンが使用可能になった後で、認定前のテストで使用されているカスタムコネクタバージョンを確実に削除する必要があることを確認します。

テンプレートアプリ (推奨)

データソースへのコネクタを開発したら、テンプレートアプリを作成し、顧客がすばやく準備して実行できるようにすることを検討してください。テンプレートアプリでは、データに接続された事前構築済みのレポートが顧客に提供され、そのまま使用することも、必要に応じてカスタマイズすることもできます。