Compartilhar via


Comando .create-or-alter function

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âmetro e instruções CSL são as mesmas para instruções let.

Permissões

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

Syntax

.create-or-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 criada ou 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 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 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.

Exemplo

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

Saída

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