Partilhar via

Comando da função .create-or-alter

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

Cria uma função armazenada ou altera uma função existente e a armazena dentro dos metadados do banco de dados.

As regras para tipos de parâmetros e instruções CSL são as mesmas que para instruções let.

Permissões

Este comando requer permissões de de Usuário do Banco de Dados para criar uma nova função e permissões de de Administrador de Função para alterar uma função existente.

Sintaxe

.create-or-alter function [ with(propertyName=propertyValue [, ...])] functionName(parâmetros){body}

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
functionName string ✔️ O nome da função a ser criada ou alterada.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades suportadas.
parâmetros string Uma lista separada por vírgulas de parâmetros exigidos pela função. O formato para 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 após a invocação da função.

Observação

Se a função com o functionName fornecido não existir nos metadados do banco de dados, o comando criará uma nova função. Caso contrário, essa função será alterada.

Propriedades suportadas

Designação 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 da interface do usuário.
view bool Designa esta função como uma vista armazenada. As visualizações armazenadas podem participar de de pesquisa e cenários de união *. Para obter mais informações, consulte Views.
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 cria o TestFunction função com uma pasta description (docstring), e define o parâmetro MyLimit.

.create-or-alter function with (docstring = 'Demo function with parameter', folder='MyFolder')
TestFunction(myLimit:int)
{ StormEvents | take myLimit}

Output

Designação Parâmetros Corpo Pasta DocString
TestFunction (myLimit:int) { StormEvents | tome myLimit } MyFolder Função de demonstração com parâmetro

Conteúdo relacionado

  • da função .create
  • Last updated on