Compartilhar via


Comando .alter function

Altera uma função existente e a armazena dentro dos metadados do banco de dados. As regras para tipos de parâmetro e instruções CSL são as mesmas let para instruções .

Permissões

Você deve ter pelo menos permissões do Function Administração para executar esse comando. A entidade de segurança que cria a função é criada automaticamente em um Administração de Função.

Syntax

.alterfunction [ with(propertyName=propertyValue [, ...])] Functionname(Parâmetros){Corpo}

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Functionname string ✔️ O nome da função a ser alterada.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades com suporte.
parameters string Uma lista separada por vírgulas de parâmetros exigidos pela função . O formato para cada parâmetro deve ser ParameterName:ParameterDataType.
body string ✔️ Zero ou mais let instruções seguidas por uma expressão CSL válida que é avaliada após a invocação de função.

Observação

  • Se a função não existir, um erro será retornado. Para criar uma nova função, consulte .create function
  • Nem todos os tipos do Kusto têm suporte em let instruções . Os tipos com suporte são: string, long, datetime, timespan e double.

Propriedades com suporte

Nome Tipo Descrição
docstring string Uma descrição da função para fins de interface do usuário.
folder string O nome de uma pasta usada para categorização de funções de interface do usuário.
skipvalidation bool Determina se a validação semântica da função deve ou não ser ignorada. Isso é útil quando as funções são criadas em uma ordem incorreta e F1 que usa F2 é criado anteriormente.

Exemplo

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
 MyFunction2(myLimit: long)  {StormEvents | take myLimit}
Nome Parâmetros Corpo Pasta DocString
MyFunction2 (myLimit: long) {StormEvents | take myLimit} MyFolder Função de demonstração com parâmetro