次の方法で共有

Data Factory コネクタ認定

  • [アーティクル]

Note

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

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

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

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI データフロー 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 認定の連絡先にお問い合わせください。

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

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

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

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

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

プロセスとタイムライン

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

  • 登録: カスタム コネクタを認定する意図を示す通知。 この登録は、目標の 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 ファイルは、スタイル標準に準拠しており、製品名またはサービス名と同じような名前が付けられている必要があります。 "Fabric"、"Power BI"、"Connector"、"API" などの単語を含めることはできません。
    • .mez ファイルに名前を指定します: ProductName.mez

  • テスト用の Power BI Desktop (.pbix) ファイル

    • コネクタのテストに使用するサンプル Power BI レポート (.pbix) が必要です。
    • レポートには、ナビゲーション テーブル内の各項目をテストするクエリが少なくとも 1 つ含まれている必要があります。
    • セット スキーマ (データベースなど) がない場合、レポートには、コネクタが処理するテーブルの "型" ごとにクエリを含める必要があります。

  • データ ソースへのテスト アカウント

    • コネクタのテストとトラブルシューティングは、テスト アカウントを使用して行われます。
    • 今後の更新も同じアカウントを使って認定できるように、永続的なテスト アカウントを指定してください。

  • テスト手順

    • コネクタを使ってその機能をテストする方法についてのドキュメントを提供してください。

  • 外部依存関係 (例: ODBC ドライバー) へのリンク

機能とスタイル

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

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

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

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

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

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

セキュリティ

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

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

    • その使用は必須ですか。 そうである場合、資格情報はどこに送信されますか。
    • 要求は 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 の担当者がご連絡いたします。

認定後

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

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