Share via


Comando da função .alter

Altera uma função existente e armazena-a dentro dos metadados da base de dados. As regras para tipos de parâmetros e instruções CSL são as mesmas que para let instruções.

Permissões

Tem de ter, pelo menos, permissões de função Administração para executar este comando. O principal que cria a função torna-se automaticamente uma Função Administração.

Syntax

.alterfunction [ with(propertyName=propertyValue [, ...])] functionName(parâmetros){corpo}

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
functionName string ✔️ O nome da função a alterar.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Veja as propriedades suportadas.
parameters string Uma lista separada por vírgulas dos parâmetros exigidos pela função. O formato para cada parâmetro tem de ser ParameterName:ParameterDataType.
corpo string ✔️ Zero ou mais let instruções seguidas de uma expressão CSL válida que é avaliada após invocação de função.

Nota

  • Se a função não existir, é devolvido um erro. Para criar uma nova função, consulte .create function
  • Nem todos os tipos de Kusto são suportados em let instruções. Os tipos suportados são: cadeia, longo, datetime, timespan e duplo.

Propriedades suportadas

Nome Tipo Description
docstring string Uma descrição da função para fins de IU.
folder string O nome de uma pasta utilizada para categorização de funções de IU.
skipvalidation bool Determina se deve ou não ignorar a validação semântica da função. Isto é útil quando as funções são criadas por uma ordem incorreta e F1 que utiliza F2 é criado anteriormente.

Exemplo

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