Compartir a través de

Funciones definidas por el usuario en Azure Confidential Ledger (versión preliminar)

Azure Confidential Ledger proporciona funciones definidas por el usuario (UDF) para ejecutar lógica personalizada dentro del libro de contabilidad. Esta característica le permite ampliar la funcionalidad del libro de contabilidad escribiendo código personalizado que se puede ejecutar dentro de un entorno confidencial e interactuar con los datos del libro de contabilidad.

Las nuevas funcionalidades de programación permiten a los usuarios crear UDF simples y UDF avanzadas para realizar diversas operaciones con un nivel de personalización diferente. Una vez definida, las UDF se pueden invocar desde los clientes del libro de contabilidad confidencial de Azure para que se ejecuten directamente dentro del motor de libro de contabilidad.

Importante

Las funciones definidas por el usuario se encuentran actualmente en versión preliminar. Puede solicitar acceso a esta versión preliminar a través de este formulario de registro. Consulte los Términos de uso complementarios de las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en versión beta, versión preliminar o, de lo contrario, aún no se han publicado en disponibilidad general.

UDF simples y avanzadas

El libro de contabilidad confidencial de Azure ofrece dos tipos de características de UDF:

  • UDF simples: las UDF simples son funciones personalizadas sencillas que se pueden definir y ejecutar dentro del libro de contabilidad. Permiten realizar operaciones sencillas mediante la API de JavaScript y se pueden integrar con la API de escritura del libro de contabilidad existente. Obtenga más información sobre las UDF simples aquí.

  • UDF avanzadas: las UDF avanzadas son puntos de conexión personalizados que se pueden definir y exponer en una aplicación de libro de contabilidad. Estos puntos de conexión se pueden usar para exponer API más sofisticadas con parámetros personalizables, formatos de datos y mecanismos de autenticación. Obtenga más información sobre las UDF avanzadas aquí.

Esta es una comparación de las características y funcionalidades principales de las UDF simples y avanzadas:

Capacidad UDF simples UDF avanzadas
Ejecución de lógica de negocios personalizada Sí Sí
Personalización de argumentos o parámetros en tiempo de ejecución Sí Sí
Exponer nuevas API o puntos de conexión No Sí
Ejecución de funciones individuales Sí No
Ejecución de enlaces antes o después de una operación de escritura de entrada de libro de contabilidad Sí No
Creación y actualización de código personalizado Sí (actualización y eliminación pormenorizadas de cada función) Sí (actualización de agrupación de aplicaciones única para todos los puntos de conexión)
Opciones personalizadas del entorno de ejecución de JavaScript Sí (por cada ejecución) Sí (global)
Ejecución en nodos de copia de seguridad No Sí
Compatibilidad con varios formatos de datos para la entrada y salida No Sí
Autenticación y autorización personalizadas No Sí
Escenarios de destino Ejecución de lógica personalizada sencilla e integración con la API de libro de contabilidad Casos de uso avanzados que requieren API personalizadas y control sobre parámetros avanzados de JavaScript

Alternancia entre Funciones Definidas por el Usuario (UDF) simples y avanzadas

Las UDF simples y avanzadas son características mutuamente excluyentes. No puede crear ni ejecutar UDF simples si se definen UDF avanzadas y viceversa. Es posible cambiar entre las dos características mediante los pasos siguientes.

Importante

Cambiar entre UDF simples y avanzadas es una operación destructiva. Todas las UDF simples o avanzadas existentes se eliminan al cambiar a la otra característica. Asegúrese de realizar una copia de seguridad de los datos importantes antes de continuar.

Desde UDF sencillas a avanzadas

Para cambiar de UDF simples a avanzadas, debe eliminar todas las UDF existentes:

  1. Enumere todas las UDF almacenadas en el libro de contabilidad mediante la GET /app/userDefinedFunctions API.

  2. Elimine cada UDF, una por una, mediante la DELETE /app/userDefinedFunctions/{functionId} API.

Desde UDF avanzadas a sencillas

Para cambiar de UDF avanzadas a sencillas, debe definir UDF avanzadas con módulos vacíos y definiciones de puntos de conexión.

  1. Cree una nueva agrupación de aplicaciones con la siguiente estructura:

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

  2. Implemente la agrupación de aplicaciones con el cuerpo de la solicitud definido en el paso 1 mediante la PUT /app/userDefinedEndpoints API.

Pasos siguientes

Consulte los siguientes artículos para empezar a trabajar con las características de UDF en Azure Confidential Ledger:

Contenido relacionado