次の方法で共有

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

Fabric ユーザー データ関数は、Fabric ポータルまたは VS Code 拡張機能を使用して、コードの変更をテストおよび検証する機能を提供します。 これらの機能は、関数を発行しなくても正常に実行できるようにするために役立ちます。

この記事では、次の方法について説明します。

  • ポータル エディターで開発モードと表示モード/実行モードを使用します。
  • 開発モードでテスト機能を使用して、関数をテストします。

注

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

開発モードと表示/実行モードとは

Fabric ユーザー データ関数には、Fabric ポータルで関数を操作するための 2 つのモード ( 開発モード と 実行/表示のみモード) が用意されています。 モード スイッチャーは、[ユーザー データ関数] ページの右上隅にあります。

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

開発モード

開発モード では、書き込みアクセス許可を持つユーザーが自分のコードを編集、テスト、発行できます。 このモードでは、ユーザーは、自分が記述した新しい発行されていない関数を含む、変更されたコードを表示できます。

Fabric ポータルの開発モードのコンポーネントを示すスクリーンショット。

開発モードのコンポーネントを次に示します。

  1. モード スイッチャー: このコントロールを使用すると、実行専用モードから開発モードに切り替えることができます。
  2. 関数の一覧: この一覧には、以前に発行された関数と共に新しい関数が含まれています。 関数名の横にあるドットは、関数が新規であり、まだ発行されていないことを示します。
  3. コード エディター: 開発モードでは、コード エディターが有効になり、ユーザーはコードを変更できます。
  4. テスト セッション インジケーター: このインジケーターは、テスト セッションがアクティブかどうかを示します。 テスト セッションはテストの実行後に作成され、15 分間非アクティブになった後にタイムアウトになります。

実行モードまたは表示モード

実行モードでは、実行アクセス許可を持つユーザーは、発行された関数を表示および実行できます。 このエクスペリエンスでは、開発モードで開発中のバージョンの発行済みバージョンのコード間に個別のビューが作成されます。

Fabric ポータルの [実行のみ] モードのコンポーネントを示すスクリーンショット。

実行専用モードのコンポーネントを次に示します。

  1. モード スイッチャー: このコントロールを使用すると、開発モードから実行専用モードに切り替えることができます。
  2. 関数の一覧: 実行専用モードでは、関数の一覧にはパブリッシュされた関数のみが含まれます。
  3. コード エディター: 実行専用モードでは、コード エディターは読み取り専用であり、このモードでは変更できません。
  4. コード変更インジケーター: このメッセージ バーは、開発モードで未発行の変更があるかどうかを示します。 これらの変更を確認するには、バーのボタンをクリックするか、モード スイッチャーを使用して、開発モードに切り替える必要があります。

表示権限のみを持つユーザーは、[ 表示のみ] モードを表示できます。 このモードでは、ユーザーはコードとそのメタデータの読み取り専用バージョンにアクセスできます。

注

ビューのみのモードでコードを表示できるのは、表示アクセス許可を持つユーザーだけです。

開発モードを使用して Fabric ポータルで変更をテストする

開発モードのテスト機能を使用して、コードの変更をリアルタイムでテストできます。 それにアクセスするには、テストする関数の上にマウス ポインターを置き、[テスト] アイコンをクリックします。

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

注

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

この手順では、次のコンポーネントを含む [テスト] パネルを開きます。

  1. テスト セッション インジケーター: テスト セッションがアクティブな場合、このインジケーターは緑色に変わります。 セッションは、テストが初めて実行されたときに開始され、非アクティブ状態が 15 分続くとタイムアウトします。

  2. 関数セレクター: このドロップダウンでは、テストするコード内の任意の関数を選択できます。 この一覧には、発行済み関数と発行されていない関数が含まれます。

  3. [テスト] ボタン: このボタンを使用すると、関数をテストできます。 選択した関数にパラメーターが必要な場合は、関数をテストする前にパラメーターを指定する必要があります。

  4. テスト出力: このパネルには、関数のテスト結果の出力が含まれています。 このパネルには、関数の戻り値、または関数の状態とエラー出力を持つオブジェクトが表示されます。

  5. ログ出力: このパネルには、 logging オブジェクトに追加されたステートメントを含む、コードで生成されたログが含まれます。

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

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

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

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

この情報メッセージが表示された場合でも、関数を発行し、実行機能を使用して、前と同じようにテストできます。 サポートされているリージョンに新しい容量を作成する場合は、 Fabric 容量を管理する方法 について説明します。

次のステップ

  • Last updated on