Compartilhar via


Criar e editar 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-alterfunction.

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

Pré-requisitos

Functions

Esse recurso permite que você crie ou altere uma função existente usando o comando .create-or-alterfunction, 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.

Exibir, editar ou excluir uma função armazenada

Para exibir, editar ou excluir uma função armazenada existente, siga estas etapas:

  1. No painel Do Explorer , expanda a seção Funções e clique nos três pontos ao lado da função desejada.

  2. No menu suspenso, escolha uma das opções:

    1. Mostrar script de função para exibir o script de função.
    2. Editar usando código para modificar o script da função na janela Explorar seus dados.
    3. excluir

    Captura de tela do menu suspenso.

  3. Se você modificou o script de função, selecione Executar para salvar suas alterações.