Comando .alter function

Artigo
11/23/2024

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

Partilhar via