Compartilhar via


Criar funções armazenadas

As funções são consultas reutilizáveis ou partes de consulta. A Inteligência em Tempo Real dá suporte a dois tipos de funções:

  • As funções internas, que são funções embutidas em código que não podem ser modificadas pelos usuários.

  • As funções definidas pelo usuário, que são divididas em dois tipos:

    • Funções armazenadas: são funções definidas pelo usuário que são armazenadas e gerenciadas como entidades de esquema de banco de dados (como tabelas). Para obter mais informações sobre como criar e gerenciar funções armazenadas, confira Visão geral do gerenciamento de funções armazenadas.
    • Funções definidas por consulta: são funções definidas pelo usuário definidas e usadas dentro do escopo de uma única consulta. A definição dessas funções é feita por meio de uma instrução let. Para obter mais informações sobre como criar funções definidas por consulta, confira Criar uma função definida pelo usuário.

Neste artigo, você aprenderá a criar ou alterar uma função armazenada existente usando o .create-or-alter function.

Para obter mais informações sobre o comando .create-or-alter function, confira .create-or-alter function

Pré-requisitos

Funções

Esse recurso permite que você crie ou altere uma função existente usando o comando .create-or-alter function, que a armazena nos metadados do banco de dados. 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, a função nomeada será alterada.

  1. Navegue até o banco de dados KQL e selecione Novo>Função. O .create-or-alter comando é preenchido automaticamente na janela Explorar seus dados .

    Captura de tela de uma página inicial do banco de dados KQL mostrando o menu suspenso Nova opção. A opção intitulada Função está realçada.

  2. Insira o nome da função e os parâmetros de consulta de sua função em vez do texto do espaço reservado e, em seguida, selecione Executar.

    Captura de tela da janela Explorar seus dados mostrando a função recém-criada na Inteligência em tempo real.

    As funções armazenadas aparecem em Funções no panel Explorer.

    Captura de tela do painel Explorer mostrando a lista de funções definidas pelo usuário armazenado.

  3. Na janela Explorar dados, execute uma consulta para verificar se você criou ou alterou com êxito a função.

    Captura de tela da janela Explorar seus dados mostrando os resultados da consulta de uma função armazenada na Inteligência em tempo real.