Compartilhar via

Funções definidas pelo usuário no Azure Confidential Ledger (prévia)

O Azure Confidential Ledger fornece funções definidas pelo usuário (UDFs) para executar lógica personalizada dentro do ledger. Esse recurso permite que você estenda a funcionalidade do livro-razão escrevendo código personalizado que pode ser executado em um ambiente seguro e que interage com os dados do livro-razão.

Os novos recursos de programação permitem que os usuários criem UDFs simples e UDFs avançadas para executar várias operações com um nível diferente de personalização. Uma vez definidas, as UDFs podem ser invocadas dos clientes do razão confidencial do Azure para serem executadas diretamente dentro do mecanismo do razão.

Importante

As funções definidas pelo usuário estão atualmente em PREVIEW. Você pode solicitar acesso para esta versão prévia por meio deste formulário de inscrição. Consulte os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou ainda não lançados em disponibilidade geral.

UDFs simples e avançados

Azure Confidential Ledger oferece dois tipos de recursos UDF:

  • UDFs simples: UDFs simples são funções personalizadas simples que podem ser definidas e executadas dentro do razão. Eles permitem que você execute operações simples usando a API JavaScript e podem ser integrados à API de gravação de razão existente. Saiba mais sobre UDFs simples aqui.

  • UDFs avançadas: UDFs avançadas são pontos de extremidade personalizados que podem ser definidos e expostos em um aplicativo de razão. Esses endpoints podem ser usados para expor APIs mais sofisticadas com parâmetros personalizáveis, formatos de dados e mecanismos de autenticação. Saiba mais sobre UDFs avançadas aqui.

Aqui está uma comparação dos principais recursos e capacidades de UDFs simples e avançados:

Capacidade UDFs simples UDFs avançados
Executar lógica de negócios personalizada Sim Sim
Personalização de argumentos/parâmetros de runtime Sim Sim
Expor nova API / pontos de extremidade Não Sim
Executar funções individuais Sim Não
Execute ganchos antes / depois de uma operação de gravação de entrada de razão Sim Não
Criação e atualização de código personalizado Sim (atualização granular/exclusão de cada função) Sim (atualização de pacote de aplicativo único para todos os endpoints)
Opções personalizadas de runtime do JavaScript Sim (por cada execução) Sim (globalmente)
Execução em nós de backup Não Sim
Suporte a vários formatos de dados para entrada e saída Não Sim
Autenticação e autorização personalizadas Não Sim
Cenários de destino Execução de lógica personalizada simples e integração com a API do razão Casos de uso avançados que exigem APIs personalizadas e controle sobre parâmetros JavaScript avançados

Alternar entre UDFs simples e avançados

UDFs simples e avançados são recursos mutuamente exclusivos. Você não pode criar ou executar UDFs simples se UDFs avançadas estiverem definidas, e vice-versa. É possível alternar entre os dois recursos usando as etapas a seguir.

Importante

Alternar entre UDFs simples e avançados é uma operação destrutiva. Todas as UDFs simples ou avançadas existentes são excluídas ao alternar para o outro recurso. Faça backup de todos os dados importantes antes de continuar.

De UDFs simples a avançados

Para mudar de UDFs simples para avançadas, você precisa excluir todas as UDFs existentes:

  1. Listar todos os UDFs armazenados no razão usando a GET /app/userDefinedFunctions API.

  2. Exclua cada UDF, um por um, usando a DELETE /app/userDefinedFunctions/{functionId} API.

De UDFs avançados a simples

Para alternar de UDFs avançadas para simples, você precisa definir UDFs avançadas com módulos vazios e definições de pontos de extremidade.

  1. Crie um novo pacote de aplicativos com a seguinte estrutura:

    {
    "metadata": {
        "endpoints": {}
    }, 
   "modules": []
}

  2. Implante o pacote de aplicativos com o corpo da solicitação definido na etapa 1 usando a PUT /app/userDefinedEndpoints API.

Próximas etapas

Consulte os seguintes artigos para explorar os recursos de Funções Definidas pelo Usuário (UDFs) no Azure Confidential Ledger.

Conteúdo relacionado

  • Last updated on