Polecenie .alter function
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer
Zmienia istniejącą funkcję i przechowuje ją wewnątrz metadanych bazy danych.
Reguły dla typów parametrów i instrukcji CSL są takie same jak w przypadku let instrukcji.
Uprawnienia
Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia administratora funkcji. Podmiot zabezpieczeń tworzący funkcję jest automatycznie tworzony jako administrator funkcji.
Składnia
.alterfunction [ with ( propertyName = propertyValue [, ...])] Treść parametrów) { functionName( }
Dowiedz się więcej na temat konwencji składni.
Parametry
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| functionName | string |
✔️ | Nazwa funkcji do zmiany. |
| propertyName, propertyValue | string |
Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości. | |
| parameters | string |
Rozdzielana przecinkami lista parametrów wymaganych przez funkcję. Format dla każdego parametru musi mieć wartość ParameterName:ParameterDataType. |
|
| treść | string |
✔️ | Co najmniej let zero instrukcji, po których następuje prawidłowe wyrażenie CSL, które jest oceniane przy wywołaniu funkcji. |
Uwaga
- Jeśli funkcja nie istnieje, zostanie zwrócony błąd. Aby utworzyć nową funkcję, zobacz
.create function - Nie wszystkie typy kusto są obsługiwane w
letinstrukcjach. Obsługiwane typy to: ciąg, długi, data/godzina, przedział czasu i podwójne.
Obsługiwane właściwości
| Nazwisko | Pisz | Opis |
|---|---|---|
docstring |
string |
Opis funkcji dla celów interfejsu użytkownika. |
folder |
string |
Nazwa folderu używanego do kategoryzacji funkcji interfejsu użytkownika. |
view |
bool |
Wyznacza tę funkcję jako przechowywany widok. Przechowywane widoki mogą uczestniczyć w scenariuszach wyszukiwania i unii * . Aby uzyskać więcej informacji, zobacz Widoki. |
skipvalidation |
bool |
Określa, czy należy uruchomić logikę walidacji w funkcji i zakończy się niepowodzeniem procesu, jeśli funkcja nie jest prawidłowa. Wartość domyślna to false. |
Przykład
Poniższy przykład modyfikuje funkcję MyFunction2 z opisem (docstring), folderem i definiuje MyLimit parametr .
.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)
{StormEvents | take myLimit}
| Nazwisko | Parametry | Treść | Folder | DocString |
|---|---|---|---|---|
| MyFunction2 | (myLimit: long) | {StormEvents | take myLimit} | Mójfolder | Funkcja demonstracyjna z parametrem |