Acionar manualmente o ciclo de modelação

Artigo
10/07/2024

Este artigo guia os programadores que pretendam utilizar a ferramenta "Modelar Agora": uma forma de acionar manualmente um ciclo de preparação para o seu recurso de modelação.

Depois de um recurso de modelação ter sido criado e implementado, o serviço Intelligent Recommendations continuará a processar dados através de um ciclo de preparação periódico. Por predefinição, o ciclo de preparação de dados ocorre a cada 36 horas.

Pode optar por acionar manualmente o ciclo de modelação (com algumas limitações) antes da agenda predefinida de 36 horas. As razões para emitir uma modelação predefinida podem ser devido ao ajuste de última hora de dados ou como consequência de erros de configuração de dados no Azure Data Lake Storage.

Para acionar manualmente o processo de modelação, utilize a chamada à API delineada neste artigo.

Como acionar manualmente o processo de modelação

Acionar um ciclo de modelação com Insomnia

O seguinte pedido POST inicia um novo ciclo de modelação:

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

Pode encontrar o seu URL de ponto final utilizando os passos no Guia de início rápido para ver os resultados das recomendações.

Limitações do acionamento manual do processo de modelação

Existem algumas limitações a considerar para acionar manualmente o processo de modelação:

Um utilizador pode executar um novo pedido POST de Modelar Agora a cada 30 minutos.
Um utilizador pode fazer um número máximo de 5 pedidos POST por 24h (janela de lançamento).
O parâmetro de modelação é considerado opcional. Se não especificou quaisquer parâmetros, o recurso de modelação predefinido é acionado.
À semelhança de todas as outras chamadas à API, acionar o processo de modelação com o pedido POST é uma chamada autenticada ao ponto final do Intelligent Recommendations, pelo que tem de incluir os detalhes da autenticação. Para mais informações, consulte Guia de início rápido para as chamadas à API autenticadas.

Amostras de resposta da API

Mensagem de êxito

Uma resposta bem sucedida inclui uma mensagem de êxito:

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

Mensagem de erro

Poderá ocorrer uma mensagem de erro:

Se um ciclo de preparação já estiver em curso
Se foram enviados demasiados pedidos de acionador que excedam a frequência permitida (máximo de 5 tentativas a cada 24 horas, ou mais de uma vez por janela de 30 minutos).

A mensagem de erro tem o aspeto seguinte:

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

Para mais informações sobre outras mensagens de erro que possam ocorrer durante o processo de modelação, consulte Registos de erros.

Consulte também

Descrição geral do contrato de dados
Guia de início rápido: Criar um pedido de API
Guia de início rápido: Configurar e executar o Intelligent Recommendations com dados de amostra
Descrição geral da implementação

Partilhar via