.alter function コマンド
既存の関数を変更し、データベース メタデータ内に格納します。
パラメーターの型およびCSLステートメントのルールは、letステートメントの場合と同じです。
アクセス許可
このコマンドを実行するには、少なくとも Function Admin アクセス許可が必要です。 関数を作成するプリンシパルは、自動的に関数管理者になります。
構文
.alterfunction [ with ( propertyName = propertyValue [, ...])] functionName(parameters) { body }
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| functionName | string |
✔️ | 変更する関数の名前。 |
| propertyName, propertyValue | string |
キーと値のプロパティのペアのコンマ区切りのリスト。 サポートされるプロパティを参照してください。 | |
| parameters | string |
関数で必要なパラメーターのコンマ区切りのリスト。 各パラメーターの形式は、 ParameterName:ParameterDataType にする必要があります。 |
|
| body | string |
✔️ | 0 個以上の let ステートメントの後に、関数の呼び出し時に評価される有効な CSL 式が続きます。 |
Note
- 関数が存在しない場合、エラーが返されます。 新しい関数の作成方法については、
.create functionを参照してください - 一部の種類の Kusto は
letステートメントでサポートされていません。 サポートされている型は、string、long、datetime、timespan、double です。
サポートされるプロパティ
| 名前 | 種類 | 説明 |
|---|---|---|
docstring |
string |
UI 用の関数の説明。 |
folder |
string |
UI 関数の分類に使用されるフォルダーの名前。 |
view |
bool |
保存されるビューとしてこの関数を指定します。 保存されたビューは、 search および union * シナリオに参加できます。 詳細については、「 Views」を参照してください。 |
skipvalidation |
bool |
関数に対して検証ロジックを実行するかどうかを決定し、関数が有効でない場合はプロセスを失敗します。 既定値は、false です。 |
例
次の例では、説明 (docstring)、フォルダーを使用して MyFunction2 関数を変更し、MyLimit パラメーターを定義します。
.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)
{StormEvents | take myLimit}
| Name | パラメーター | 本文 | フォルダー | DocString |
|---|---|---|---|---|
| MyFunction2 | (myLimit: long) | {StormEvents | take myLimit} | MyFolder | パラメーターを使用したデモ関数 |