Criar e gerenciar 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:

• Funções internas, que são funções codificadas que você não pode modificar.

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

  • Funções armazenadas: funções definidas pelo usuário que você armazena e gerencia como entidades de esquema de banco de dados, como tabelas. Para obter mais informações sobre como criar e gerenciar funções armazenadas, consulte a visão geral do gerenciamento de funções armazenadas.
  • Funções definidas por consulta: funções definidas pelo usuário que você define e usa dentro do escopo de uma única consulta. Você define essas funções por meio de uma let instrução. Para obter mais informações sobre como criar funções definidas por consulta, consulte Criar uma função definida pelo usuário.

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

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

Pré-requisitos

• Um workspace com uma capacidade habilitada para Microsoft Fabric
• Um banco de dados KQL com permissões de edição

Criar funções

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

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

   

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

   

   As funções armazenadas aparecem em funções no painel Explorer .

   

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

   

Lista de funções armazenadas

Você pode exibir uma lista de todas as funções armazenadas no banco de dados. Clicando à esquerda na opção Funções ou selecionando Mostrar funções no menu suspenso, você pode abrir a lista de funções.

A lista inclui:

• A pasta da função e sua descrição.
• Recursos opcionais de classificação e pesquisa para ajudá-lo a encontrar funções específicas.

Clicar com o botão esquerdo em uma função na lista abre uma versão prévia somente leitura da função. No menu suspenso, você também pode selecionar Mostrar função para abrir a versão prévia da função, editar ou excluir a função.

Exibir e visualizar uma função armazenada

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

1. No painel do Explorer, expanda a seção Funções. Clique com o botão esquerdo na função desejada para abrir a visualização ou selecionar os três pontos e mostrar a função.

2. Uma versão somente leitura do script de função é aberta na janela Explorar Seus Dados.

   • Você pode selecionar os resultados da versão prévia para visualizar os resultados da função.
   • Se a função incluir parâmetros, você poderá inserir valores para esses parâmetros. Em seguida, selecione Os resultados da versão prévia para ver a saída com base nos valores de parâmetro fornecidos.
   • Os resultados da visualização mostram até 100 registros com base na consulta de função.

   

Editar ou excluir uma função armazenada

Para editar ou excluir uma função armazenada existente, use as seguintes etapas:

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

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

   • Edite com código para editar o script de função na janela Explorar seus dados .
   • excluir

   

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

Conteúdo relacionado

• Consultar dados em um conjunto de consultas KQL
• Alterar políticas de dados
• Criar uma política de atualização de tabela