.alter function 命令
適用於： ✅Microsoft網狀架構✅Azure 數據總管
改變現有的函式，並將它儲存在資料庫元數據內。
參數類型和 CSL 語句的規則與 語句let的規則相同。
權限
您必須至少有 函式管理員 許可權才能執行此命令。 建立函式的主體會自動成為函式管理員。
語法
.alterfunction [ with ( propertyName = propertyValue [, ...])] functionName(參數) { 主體 }
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| functionName | string |
✔️ | 要改變之函式的名稱。 |
| propertyName、 propertyValue | string |
索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。 | |
| parameters | string |
函式所需的參數逗號分隔清單。 每個參數的格式必須是 ParameterName:ParameterDataType。 |
|
| 身體 | string |
✔️ | 零個或多個 let 語句後面接著有效的 CSL 運算式，會在函式調用時進行評估。 |
注意
- 如果函式不存在，則會傳回錯誤。 如需建立新的函式，請參閱
.create function - 語句中
let不支援所有 Kusto 類型。 支援的型別包括：字串、long、datetime、timespan 和 double。
支援的屬性
| 名稱 | 類型 | 描述 |
|---|---|---|
docstring |
string |
UI 用途之函式的描述。 |
folder |
string |
用於 UI 函式分類的資料夾名稱。 |
view |
bool |
將此函式指定為預存檢視。 預存檢視可以參與 搜尋 和聯集 * 案例。 如需詳細資訊，請參閱 檢視。 |
skipvalidation |
bool |
判斷是否要在函式上執行驗證邏輯，並在函式無效時失敗進程。 預設值為 false。 |
範例
下列範例會使用 description （docstring）， 資料夾修改 MyFunction2 函式，並定義 MyLimit 參數。
.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)
{StormEvents | take myLimit}
| 名稱 | 參數 | 本文 | Folder | DocString |
|---|---|---|---|---|
| MyFunction2 | （myLimit： long） | {StormEvents | take myLimit} | MyFolder | 具有參數的示範函式 |