.create-or-alter 函式命令

建立預存函數，或更改現有的函數，並將函數儲存在資料庫中繼資料內。

參數類型和 CSL 語句的規則與 let 語句的規則相同。

權限

此命令需要資料庫用戶許可權，才能建立新的函式，以及變更現有函式的 Function 管理員 許可權。

Syntax

.create-or-alterfunction [ with(propertyName=propertyValue [, ...])] functionName(參數){身體}

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
functionName	string	✔️	要建立或改變之函式的名稱。
propertyName， propertyValue	string		索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。
parameters	string		函式所需參數的逗號分隔清單。 每個參數的格式必須是 ParameterName:ParameterDataType。
body	string	✔️	零個或多個 let 語句，後面接著在函數調用時評估的有效 CSL 運算式。

注意

如果具有所提供 functionName 的函式不存在於資料庫元數據中，命令會建立新的函式。 反之，若有相符的函數，此命令就會更改該函數。

支援的屬性

名稱	類型	Description
docstring	string	用於 UI 的函式說明。
folder	string	用於 UI 函式分類的資料夾名稱。

範例

.create-or-alter function with (docstring = 'Demo function with parameter', folder='MyFolder') TestFunction(myLimit:int)
{
    StormEvents | take myLimit 
} 

輸出

名稱	參數	主體	資料夾	DocString
TestFunction	(myLimit:int)	{ StormEvents | take myLimit }	MyFolder	具有參數的示範函數