ポータル エディターを使用してユーザー データ関数を作成および発行する

ユーザー データ関数は、Fabric ポータルから直接編集、発行、管理できます。 この記事では、ツール バー、設定、ナビゲーション要素など、最も頻繁に使用するポータル コンポーネントの概要について説明します。 ポータル インターフェイスを使用して、関数、接続、およびライブラリを管理する方法について説明します。

ポータル エディターの概要

ポータル エディターは、ユーザー データ関数項目を開いたときにアクセスする Web ベースのインターフェイスです。 ポータル エディターの要素を次に示します。

1. [ホーム] タブと [編集] タブ: これらのタブを使用して、[ ホーム ] ツールと [編集] ツールを切り替えます。 各タブで使用できるツールの詳細については、「 ホーム」ツールバー および 「ツールバーの編集」 セクションを参照してください。
2. 設定： このボタンをクリックすると、[ユーザー データ関数] 項目の設定が開きます。 設定には、ユーザー データ関数項目の説明、秘密度ラベル、保証、接続の管理、およびライブラリ管理の設定が含まれます。 このメニューの設定は、この項目のすべての機能に適用されます。
3. 関数の一覧: この一覧には、このユーザー データ関数項目内の関数が含まれています。 リスト アイテムにカーソルを合わせると、実行機能またはテスト機能が表示され、その他のオプションも表示されます。
   • 開発モードでは、リストには公開済み関数と発行されていない関数の両方が [テスト] ボタンと共に含まれます。
   • [実行のみ] モードでは、[実行] ボタンを含むパブリッシュされた関数のみが一覧に表示されます。
4. コード ビューアー/エディター: このユーザー データ関数項目のすべての関数のコードを格納します。
   • 開発モードでは、コードは編集可能であり、発行されていない関数を含めることができます。
   • 実行専用モードでは、コードは読み取り専用であり、発行された関数のみが表示されます。
5. ステータス バー: このバーには、次の 2 つの要素が含まれています。
   1. テスト セッション インジケーター: テスト セッションが実行されているかどうかを示します (開発モードのみ)。 関数のテストの詳細については、 開発モードのドキュメントを参照してください。
   2. 発行プロセス インジケーター: 関数が現在発行されているかどうか、または最後に正常に発行された時刻のタイムスタンプを示します。
6. モード スイッチャー: このドロップダウン メニューでは、 開発 モードと 実行専用 モードを切り替えることができます。 詳細については、 開発モードのドキュメントを参照してください。
7. [共有] ボタン: この機能を使用すると、このユーザー データ関数項目を他のユーザーと共有し、アクセス許可 (共有、編集、実行のアクセス許可) を割り当てることができます。
8. [発行] ボタン: このボタンをクリックすると、ユーザー データ関数項目の発行プロセスが開始されます。 このプロセスでは、アイテム内のすべての関数が発行されます。 関数が発行されると、他のユーザーや Fabric 項目で関数を実行できます。
   • 開発モードでのみ使用できます。

ホーム ツール バー

このツール バーには、ユーザー データ関数項目のすべての関数に適用できる機能が用意されています。 これらの機能の一部は、 開発 モードでのみ使用できます。

1. 設定： このボタンをクリックすると、[ユーザー データ関数] 項目の設定が開きます。 設定には、項目の説明、秘密度ラベル、保証、接続の管理、およびライブラリ管理が含まれます。 このメニューの設定は、[ユーザー データ関数] 項目のすべての関数に適用されます。
2. [更新] ボタン: このボタンをクリックすると、[ユーザー データ関数] 項目が更新され、発行された最新の関数とメタデータが表示されます。 [更新] ボタンを使用して、最新バージョンのコードを使用していることを確認できます。
3. 言語セレクター: この読み取り専用ボタンには、Python が既定のオプションとして表示されます。
4. 呼び出しコードを生成します。 この機能により、外部アプリケーションまたは Fabric 項目から関数を呼び出すためのコード テンプレートが自動的に生成されます。 呼び出しコードの生成について詳しくは、こちらをご覧ください。
5. 接続の管理: この機能を使用すると、OneLake データ カタログを使用して Fabric データ ソースへの接続を作成できます。 このボタンが開き、[設定] の [接続の管理] ページが開きます。 接続の管理機能の詳細を確認します。
6. ライブラリ管理: この機能を使用すると、関数コードで使用するパブリック ライブラリとプライベート ライブラリをインストールできます。 このボタンは、[設定] の [ライブラリ管理] ページに表示されます。 ライブラリ管理機能の詳細を確認します。
7. VS Code ボタンで開く: このボタンを使用すると、 Fabric User Data Functions VS Code 拡張機能を使用して、VS Code エディターで関数を開きます。 VS Code 拡張機能の使用の詳細について説明します。
8. [発行] ボタン: このボタンをクリックすると、ユーザー データ関数項目の発行プロセスが開始されます。 このプロセスでは、アイテム内のすべての関数が発行されます。
   • 開発モードでのみ使用できます。

編集ツール バー

このツール バーには、関数コードの編集に役立つ機能が用意されています。 これらの機能のほとんどは、 開発 モードでのみ使用できます。

1. [コードのリセット] ボタン: このボタンをクリックすると、すべての関数が発行済みのバージョンのコードにリセットされます。 この機能は、発行された関数とは異なるコード変更を元に戻します。
   • 開発モードでのみ使用できます。
2. 編集ボタン: これらのボタンは、コード エディターの [元に戻す]、[やり直し]、[コピー]、[貼り付け] の各機能を提供します。
   • 開発モードでのみ使用できます。
3. サンプルの挿入: この機能は、特定のシナリオの開始に役立つコード テンプレートを提供します。 コード テンプレートを選択すると、関数の下部に挿入されます。 必要なライブラリをインストールし、 プログラミング モデル のガイドラインに従って必要な接続を追加してください。
   • 開発モードでのみ使用できます。
4. 接続の管理: この機能を使用すると、OneLake データ カタログを使用して Fabric データ ソースへの接続を作成できます。 このボタンが開き、[設定] の [接続の管理] ページが開きます。 接続の管理機能の詳細を確認します。
5. ライブラリ管理: この機能を使用すると、関数コードで使用するパブリック ライブラリとプライベート ライブラリをインストールできます。 このボタンは、[設定] の [ライブラリ管理] ページに表示されます。 ライブラリ管理機能の詳細を確認します。
6. 検索と置換: この機能を使用すると、コード エディターでキーワードを検索し、必要に応じて置き換えることができます。
   • 開発モードでのみ使用できます。
7. [発行] ボタン: このボタンをクリックすると、ユーザー データ関数項目の発行プロセスが開始されます。 このプロセスでは、アイテム内のすべての関数が発行されます。
   • 開発モードでのみ使用できます。

ポータル エディター インターフェイスを理解したら、これらのツールを使用して、ユーザー データ関数の作成、編集、テスト、発行を行うことができます。 ポータルには、コードの記述から接続とライブラリの管理まで、関数を管理するために必要なものがすべて用意されています。

関連コンテンツ

• ポータルでユーザー データ関数を作成する - ポータル エディターを使用して最初の関数を作成して実行するためのクイック スタート ガイド
• データ ソースへの接続 - ポータルから Fabric データ ソースへの接続を管理する方法について説明します
• ライブラリの管理 - 関数の Python ライブラリのインストールと管理
• 関数をテストする - テスト用の開発モードと実行専用モードについて説明します