次の方法で共有

Fabric ポータルでユーザー データ関数をテストする

Fabric ポータルには、発行前にユーザー データ関数コードの変更をテストおよび検証する機能が用意されています。 発行されていないコードは、開発モードでテストすることも、実行専用モードで発行された関数を検証することもできます。 ローカル テストでは、 VS Code 拡張機能を使用できます。

テストは次の場合に役立ちます。

  • 関数がエラーなしで正常に実行されることを検証する
  • 関数が異なる入力で期待される結果を返すかどうかを確認する
  • ログとエラー メッセージを表示して問題をすばやくデバッグする
  • すべての編集後に発行することなく、開発モードでコードの変更をより迅速に反復処理する
  • 発行された関数が実行専用モードで正しく動作することを確認する

注

一部のユーザーは、Fabric テナントのリージョンによっては、開発モードでテスト機能にアクセスできない場合があります。 この記事の 地域の制限事項 に関する注意を確認してください。

[前提条件]

関数をテストする前に、次のものが必要です。

  • Fabric ワークスペース内のユーザー データ関数項目
  • 開発モードにアクセスし、テスト機能を使用するための書き込みアクセス許可
  • コードで定義されている関数 (発行済みまたは発行されていない関数)

開発モードと実行専用モードについて

Fabric ユーザー データ関数には、テストできる内容を決定する 2 つのモードが用意されています。

  • 開発モード - 発行済み関数と発行されていない関数の両方をテストします。 このモードでは、発行前にコードの変更を検証できます。
  • 実行のみモード - 発行された関数のみを実行します。 このモードでは、実行アクセス許可を持つ他のユーザーが実行できる内容が表示されます。

[ユーザー データ関数] ページの右上隅にあるモード スイッチャーを使用して、モードを切り替えることができます。 ポータル インターフェイスの詳細については、「ポータル エディターを使用する」を参照してください。

Fabric ポータルでモードを切り替える方法を示すスクリーンショット。

開発モードで関数をテストする

開発モードで関数をテストするには:

  1. 右上隅にあるモード スイッチャーを使用して 、開発 モードに切り替えます。

  2. 関数の一覧でテストする関数にカーソルを合わせます。

  3. [ テスト ] アイコンを選択して、[テスト] パネルを開きます。

    新しい関数をテストする方法を示すスクリーンショット。

注

テスト セッションの開始には数秒かかる場合があります。 セッションがアクティブになると、コードを変更した後でも、すぐにテストを実行できます。

テストパネルについて理解する

[テスト] アイコンを選択すると、[テスト] パネルがダイアログとして開き、テストを構成して実行します。 このパネルには、関数をテストして結果を確認するために必要なものがすべて表示されます。

[テスト] パネルのさまざまな部分を示すスクリーンショット。

  • 関数セレクター - ドロップダウン メニューからテストする関数を選択します。 この一覧には、パブリッシュされた関数と発行されていない関数の両方が含まれます。
  • パラメーター - パラメーター を必要とする関数の入力値を指定します。
  • テスト出力 - 関数の戻り値または関数が失敗した場合のエラーの詳細を表示します。
  • ログ出力 - logging オブジェクトに追加されたステートメントを含め、コードによって生成されたログを表示します。 ログの表示と分析の詳細については、 関数ログの表示を参照してください。

テストを実行するには、必要なパラメーターを指定し、[ テスト ] ボタンを選択します。 ステータス バーのテスト セッション インジケーターには、テスト セッションがアクティブなタイミングが表示されます。 セッションはアクティブのまま 15 分間非アクティブになり、セッションの再起動を待たずに複数回テストできます。

実行専用モードで発行された関数をテストする

パブリッシュされた関数を他のユーザーが実行するようにテストするには:

  1. まだ行っていない場合は、関数を公開します。
  2. モード スイッチャーを使用して 、実行専用 モードに切り替えます。
  3. 関数の一覧内の関数にカーソルを合わせます。
  4. [実行] アイコンを選択して、[実行] パネルを開きます。
  5. [実行] パネルで必要なパラメーターを指定します。
  6. [ 実行 ] を選択して関数を実行します。

[実行] パネルには、テスト パネルと同じ要素 (関数セレクター、パラメーター、出力、ログ) が用意されています。 このモードは、発行された関数が実行アクセス許可を持つユーザーに対して正しく動作することを確認するのに役立ちます。

テストのベスト プラクティス

関数を効果的にテストするには、次のプラクティスに従います。

  • 早期および頻繁にテスト する - すべてのコードが完了するまで待機するのではなく、開発時に機能をテストします。
  • さまざまな入力でテスト する - エッジ ケースなど、さまざまなパラメーター値を使用して関数を検証します。
  • ログを注意深く確認 する - ログ出力を使用して関数の動作を理解し、問題を特定します。
  • 公開前にテストする - 関数が期待どおりに動作することを確認するには、発行する前に必ず開発モードでテストします。
  • 検証に実行専用モードを使用する - 発行後は、実行専用モードを使用して、発行された関数が正しく動作することを確認します。

テストに関する問題のトラブルシューティング

関数のテスト中に問題が発生した場合は、次の一般的な解決策を検討してください。

テスト セッションが開始されない

  • テスト セッションが初期化されるまで数秒待ちます
  • ネットワーク接続を確認し、Fabric サービスにアクセスできることを確認する
  • リージョンでテスト機能がサポートされていることを確認します ( 地域の制限事項を参照してください)

関数が接続エラーで失敗する

  • 必要なすべての データ接続 が正しく構成されていることを確認する
  • 接続されているデータ ソースにアクセスするためのアクセス許可があることを確認する
  • 接続資格情報が有効であり、有効期限が切れていないことを確認する

関数がインポートエラーまたはモジュール エラーで失敗する

テストタイムアウト

  • 実行タイムアウト制限 (240 秒) を確認する
  • 関数コードを最適化して実行時間を短縮する
  • ログを確認して、最も時間がかかっている操作を特定する

戻り値が大きすぎるエラー

  • 応答サイズの制限 (30 MB) を確認する
  • 関数から返されるデータの量を減らす
  • 改ページまたはフィルター処理の結果を検討する

問題の診断の詳細については、 関数ログの表示を参照してください。

開発モードでのテスト機能に関するリージョンの制限事項

テスト機能は、まだすべての Fabric リージョンで使用できるわけではありません。 テナント リージョンがサポートされていない場合は、Functions ポータルにメッセージが表示されます。 サポートされているリージョンについては、 サービスの詳細と制限事項に関する記事を 参照してください。

リージョンが使用できないバナーを示すスクリーンショット。

テスト機能がリージョンで使用できない場合でも、関数を発行し、実行機能を使用して検証できます。 または、サポートされているリージョン に新しい容量を作成 することもできます。

関連コンテンツ

  • Last updated on