次の方法で共有

Data Factory コネクタ認定

  • [アーティクル]

重要

コネクタ認定プログラムは現在変更中であり、新しいコネクタ認定の登録は現在保留されています。 この記事は、新しいパートナー向けにコネクタ認定プログラムが再び開かれると更新されます。 更新する認定コネクタをお持ちの場合は、dataconnectors@microsoft.com のチームに連絡して、新しいバージョンを送信する方法を確認してください。 申請は毎月処理され、提出の締め切り日は毎月第 1 火曜日です。

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

Data Factory コネクタを認定すると、コネクタは一般公開され、次のエクスペリエンスの Microsoft Fabric Data Factory および Microsoft Power BI ですぐに使用できるようになります。

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI セマンティック モデル (Power BI サービス内)
  • Microsoft Power BI Desktop
  • Microsoft Fabric と Microsoft Power BI 用のオンプレミス データ ゲートウェイ

認定コネクタは:

  • パートナー開発者によって管理されます

  • パートナー開発者によってサポートされます

  • Microsoft によって認定されます

  • Microsoft によって配布されます

Microsoft はパートナーと協力して、メンテナンスでサポートを受けられるように努めていますが、コネクタ自体に関する顧客の問題のご対応はパートナー開発者になります。

Note

現在、Power Query SDK を利用して、Data Factory コネクタ認定プログラムを通じて認定できるコネクタを作成できるようになりました。 このツールの詳細については、「Power Query SDK の概要」を参照してください。

認定の概要

前提条件

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

  • コネクタは、パブリック製品用である必要があります。

  • コネクタは、初期リリース バージョンのコード完了と見なす必要があります。 プログラムでは、頻繁なイテレーションや更新が許可されています。 マイクロソフトは、技術的なサポートやカスタム コネクタ開発のコンサルティングの提供はしていません。 SDK ドキュメントやサンプル リポジトリなどのパブリック リソースの使用をお勧めします。 さらにサポートが必要な場合は、Microsoft のプログラムやパートナーシップとは別に、直接関与できる既知のサード パーティ業界のカスタム コネクタ開発コンサルタントの一覧を共有できます。 マイクロソフトはこれらのコンサルタントのいずれとも提携しておらず、そのサービスの使用に対して責任を負いません。 Microsoft は、お客様の便宜のために、保証、推奨事項、または保証なしで一覧を提供します。 詳細については、Microsoft Certification の連絡先にお問い合わせください。

  • 開発者は、現在および将来の使用状況の見積もりを提供する必要があります。

  • ユーザーのニーズやビジネス シナリオを満たすために、コネクタを顧客が直接使用できるようにしておく必要があります。 この条件は、プレビュー プログラムを使用して完成したコネクタをエンド ユーザーや組織に直接配布することで満たすことができます。 コネクタの開発者には、自身の配布メカニズムを使用し、独自のコネクタの内部テストを実行して、制御されたグループの下でコネクタを反復処理することをお勧めします。 各ユーザーまたは組織は、コネクタにビジネス ニーズがあり、コネクタがビジネス要件を満たすために正常に機能しているというフィードバックと検証を提供できる必要があります。

  • コネクタは、顧客が予想するレベルの使用で正常に動作する必要があります。

  • Data Factory や Power BI でコネクタを一般公開する要求を示すために、顧客主導のスレッドが Fabric Ideas フォーラムに存在する必要があります。 エンゲージメントのしきい値は設定されていません。 しかし、エンゲージメントが多いほど、コネクタに対するより大きな需要が証明されます。

これらの前提条件は、認定を受けるコネクタが、認定後も顧客やビジネスにとって重要な用途で使用され、サポートされることを保証するために存在します。

認定要件

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

機能とスタイル

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

  • コネクタは以下の条件を満たす必要があります。

    • セクション ドキュメント形式を使用する。
    • セクション ドキュメントの上に、バージョン ヘッダー/装飾を含めます。
    • 関数ドキュメントのメタデータを指定する。
    • TestConnection ハンドラーがある。
    • 名前付け規則に従っている (例: DataSourceKind.FunctionName)。 "Fabric"、"Power BI"、"コネクタ"、"API" などの単語を含めないでください。
    • リレーショナル データ ソースに関しては、列を含むテーブルに編成された表形式でデータを返します。 キューブ、ディメンション、メジャーに基づく多次元形式はサポートされていません。
    • インポート モードと DirectQuery モードでも同じように動作し、同様の結果が返されます。
    • 初期リリースではベータ フラグを True に設定します。

  • FunctionName は、ドメインにとって意味をなすものである必要があります (例: "Contents"、"Tables"、"Document"、"Databases" など)。

  • コネクタは以下の条件を満たすべきです。

    • アイコンがある。
    • ナビゲーション テーブルを提供する。
    • resources.resx ファイルに文字列を配置する。 URL と値はコネクタ コード内でハードコーディングすべきであり、resources.resx ファイルに配置すべきではありません。

セキュリティ

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

  • Extension.CurrentCredentials() が使用されている場合:

    • その使用は必須ですか。 そうである場合、資格情報はどこに送信されますか。
    • 要求は HTTPS 経由で行われることが保証されますか。
    • 資格情報が Web.Contents() を使って GET 経由で送信される場合:
      • それは POST に変換できますか。
      • GET が必須の場合、コネクタでは CredentialQueryString オプション レコードの Web.Contents() レコードを使用して、機密性の高い資格情報を渡す必要があります。

  • Diagnostics.* 関数が使用されている場合:

    • トレースされている内容を検証してください。データに PII または大量の不要なデータが含まれてはなりません。
    • 開発で重要なトレースを実装した場合は、トレースを有効にすべきかどうかを決定する変数または機能フラグを実装する必要があります。 このトレースは、認定用の提出を行う前にオフにする必要があります。

  • Expression.Evaluate() が使用されている場合:

    • その式の出所と内容について検証します (つまり、Extension.CurrentCredentials() の呼び出しを動的に構築できるかどうか、など)。
    • Expression は、ユーザーが指定したものや、ユーザーによる入力を受け取ることはできません。
    • Expression は、動的である (つまり、Web 呼び出しから取得される) べきではありません。

認定後

Microsoft Fabric と Microsoft Power BI エクスペリエンスを通じてコネクタが認定され、リリースされた後、運用環境にデプロイされ、一般公開されている認定コネクタを確実に正しく使用できるようにするには、いくつかの作業を行う必要があります。

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