Compartir a través de

Activar manualmente el ciclo de modelado

  • Artículo

Este artículo es una guía para los desarrolladores que desean usar la herramienta "Modelar ahora", una forma de activar manualmente un ciclo de cocción para su recurso de modelado.

Una vez que se ha creado e implementado un recurso de modelado, el servicio Intelligent Recommendations continúa procesando datos a través de un ciclo de cocción periódico. De manera predeterminada, el ciclo de cocción de datos ocurre cada 36 horas.

Puede optar por activar manualmente el ciclo de modelado (con algunas limitaciones) antes de la programación predeterminada de 36 horas. Las razones para un impulso de modelado predeterminado pueden deberse a un ajuste de datos de última hora o como resultado de errores de configuración de datos en Azure Data Lake Storage.

Para desencadenar manualmente el proceso de modelado, use la llamada API descrita en este artículo.

Cómo activar manualmente el proceso de modelado

Desencadenar un ciclo de modelado con Insomnia

La siguiente solicitud POST inicia un nuevo ciclo de modelado:

https://<your-endpoint-url>/Control/V1.0/Model?modeling=<your-modeling-name>

Puede encontrar su URL punto de conexión siguiendo los pasos en la Guía de inicio rápido para ver los resultados de las recomendaciones.

Limitaciones con la activación manual del proceso de modelado

Hay algunas limitaciones a tener en cuenta para activar manualmente el proceso de modelado:

  • Un usuario puede ejecutar una nueva solicitud POST Model Now cada 30 minutos.

  • Un usuario puede hacer un número máximo de 5 solicitudes POST por 24 horas (ventana con desplazamiento).

  • El parámetro de modelado se considera opcional. Si no se especifica ningún parámetro, se desencadenará el recurso de modelado predeterminado.

  • Al igual que todas las demás llamadas a la API, la activación del proceso de modelado con la solicitud POST es una llamada autenticada a las Intelligent Recommendations punto de conexión, por lo que deberá incluir los detalles de autenticación. Para más información, vea Guía de inicio rápido para llamadas API autenticadas.

Ejemplos de respuesta de API

Mensaje de éxito

Una respuesta exitosa incluye un mensaje de éxito:

{
    "status": "Success",
    "environmentId": "your env id will be written here",
    "version": "20210930173241" // this is the timestamp of the trigger
}

Mensaje de error

Puede aparecer un mensaje de error:

  • Si ya hay un ciclo de cocción en curso
  • Si se han enviado demasiadas solicitudes de activación que exceden la frecuencia permitida (un máximo de 5 intentos vez cada 24 horas o más de una vez por ventana de 30 minutos).

El mensaje de error se ve así:

{
    "error": {
        "code": "TooManyRequests",
        "message": "Too many requests"
    }
}

Para obtener más información sobre otros mensajes de error que pueden aparecer durante el proceso de modelado, consulte Registros de errores.

Consulte también

Descripción general del contrato de datos
Guía de inicio rápido: crear una solicitud de API
Guía de inicio rápido: Configurar y ejecutar Intelligent Recommendations con datos de ejemplo
Descripción general de la implementación