Partilhar via

Comando .alter function

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

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 que para let instruções.

Permissões

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

Sintaxe

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória 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 as propriedades suportadas.
parameters string Uma lista separada por vírgulas de parâmetros exigidos pela função. O formato de cada parâmetro deve ser ParameterName:ParameterDataType.
Corpo string ✔️ Zero ou mais let instruções seguidas por uma expressão CSL válida que é avaliada na invocação da 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 Kusto têm suporte em let instruções. Os tipos com suporte são: string, long, datetime, timespan e double.

Propriedades aceitas

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.
view bool Designa essa função como uma exibição armazenada. As exibições armazenadas podem participar de cenários de pesquisa e união * . Para obter mais informações, consulte Exibições.
skipvalidation bool Determina se a lógica de validação deve ser executada na função e falha no processo se a função não for válida. O padrão é false.

Exemplo

O exemplo a seguir modifica a função MyFunction2 com uma pasta description (docstring), e define o MyLimit parâmetro.

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