次の方法で共有

ストアド関数の作成と管理

関数は、再利用可能なクエリまたはクエリ部分です。 Real-Time Analytics では、次の 2 種類の関数がサポートされています。

  • 組み込み関数。変更できないハードコーディングされた関数です。

  • ユーザー定義関数。これは次の 2 つの種類に分けることができます。

    • ストアド関数: テーブルなどのデータベース スキーマ エンティティとして格納および管理するユーザー定義関数。 ストアド関数を作成および管理する方法の詳細については、「ストアド関数の管理の概要」を参照してください。
    • クエリ定義関数: 1 つのクエリのスコープ内で定義して使用するユーザー定義関数。 これらの関数は、 ステートメントを使用して定義します。 クエリ定義関数を作成する方法の詳細については、「ユーザー定義関数を作成する」を参照してください。

この記事では、 を使用して既存のストアド関数を作成または変更する方法について説明します。

コマンドの詳細については、を参照してください。

前提条件

  • Microsoft Fabric 対応の capacity を持つ workspace
  • 編集アクセス許可を持つ KQL データベース

関数の作成

この機能を使用すると、 コマンドを使用して既存の関数を作成または変更できます。 このコマンドは、データベース メタデータに関数を格納します。 指定された FunctionName の関数がデータベース メタデータに存在しない場合、コマンドは新しい関数を作成します。 それ以外の場合、コマンドは名前付き関数を変更します。

  1. KQL データベースを参照し、[新しい関数] を選択します。 [データの探索] ウィンドウに コマンドが自動的に表示されます。

    [新規] オプションのドロップダウン メニューを表示している KQL データベース ランディング ページのスクリーンショット。[関数] と表示されているオプションが強調表示されています。

  2. プレースホルダー テキストではなく関数の関数名とクエリ パラメーターを入力し、[ 実行] を選択します。

    リアルタイム分析で新しく作成された関数を表示している [データの探索] ウィンドウのスクリーンショット。

    格納された関数は、[エクスプローラー] ウィンドウの [関数] に表示されます。

    エクスプローラー ペインのスクリーンショットで、ユーザー定義関数の一覧を表示しています。

  3. [ データの探索 ] ウィンドウで、クエリを実行して、関数が正常に作成または変更されたことを確認します。

    リアルタイム分析でストアド関数のクエリ結果を表示している [データの探索] ウィンドウのスクリーンショット。

ストアド関数の一覧

データベース内のすべてのストアド関数の一覧を表示できます。 [関数] オプションを左クリックするか、ドロップダウン メニューの [関数の表示] を選択すると、関数の一覧を開くことができます。
[エクスプローラー] ウィンドウの関数ツリーのスクリーンショット。

この一覧には以下が含まれます。

  • 関数のフォルダーとその説明。
  • 特定の関数を見つけるための補助として、並べ替えや検索のオプション機能があります。

ストアド関数の一覧のスクリーンショット。

一覧で関数を左クリックすると、関数の読み取り専用 プレビュー バージョン が開きます。 ドロップダウン メニューで、[ 関数の表示 ] を選択して、関数のプレビュー バージョンを開いたり、関数を 編集または削除したり することもできます。

格納されている関数を表示およびプレビューする

既存のストアド関数を表示またはプレビューするには、次の手順に従います。

  1. [エクスプローラー] ウィンドウで、[関数] セクションを展開します。 目的の関数を左クリックしてプレビューを開くか、3 つのドットを選択して関数を表示します。

  2. 関数スクリプトの読み取り専用バージョンが [ データの探索 ] ウィンドウに開きます。

    • [結果の プレビュー ] を選択して、関数の結果をプレビューできます。
    • 関数にパラメーターが含まれている場合は、それらのパラメーターの値を入力できます。 次に、[ 結果のプレビュー ] を選択して、指定したパラメーター値に基づいて出力を表示します。
    • プレビュー結果には、関数クエリに基づいて最大 100 個のレコードが表示されます。

    格納されている関数スクリプトを示す [データの探索] ウィンドウのスクリーンショット。

ストアド関数を編集または削除する

既存のストアド関数を編集または削除するには、次の手順に従います。

  1. [エクスプローラー] ウィンドウで、[関数] セクションを展開します。 目的の関数の横にある 3 つのドットを選択します。

  2. ドロップダウン メニューから、次のいずれかを選択します。

    • コードを使用して編集 し、[ データの探索 ] ウィンドウで関数スクリプトを編集します。
    • 削除

    ドロップダウン メニューのスクリーンショット。

  3. 関数スクリプトを変更した場合は、[ 実行 ] を選択して変更を保存します。

関連するコンテンツ

  • KQL クエリセット内のデータにクエリを実行する
  • データ ポリシーを変更する
  • テーブル更新ポリシーを作成する
  • Last updated on