Attivare manualmente il ciclo di modellazione

Questo articolo fornisce informazioni agli sviluppatori che desiderano usare lo strumento Modello ora, che consente di attivare manualmente un ciclo di cottura per la propria risorsa di modellazione.

Dopo che una risorsa di modellazione è stata creata e distribuita, il servizio Raccomandazioni intelligenti continuerà a elaborare i dati attraverso un ciclo di cottura periodico. Per impostazione predefinita il ciclo di cottura dei dati avviene ogni 36 ore.

Puoi scegliere di attivare manualmente il ciclo di modellazione (con alcune limitazioni) prima della pianificazione predefinita di 36 ore. I motivi per un push di modellazione predefinito potrebbero essere dovuti a una messa a punto dei dati dell'ultimo minuto o come risultato di errori di configurazione dei dati in Azure Data Lake Storage.

Per attivare manualmente il processo di modellazione, usa la chiamata API descritta in questo articolo.

Come attivare manualmente il processo di modellazione

Attivare un ciclo di modellazione con Insomnia

La seguente richiesta POST avvia un nuovo ciclo di modellazione:

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

Puoi trovare il tuo URL endpoint usando i passaggi in Guida rapida per vedere i risultati dei consigli.

Limitazioni con l'attivazione manuale del processo di modellazione

Ci sono alcune limitazioni da tenere a mente per l'attivazione manuale del processo di modellazione:

  • Un utente può eseguire una nuova richiesta POST Modello ora ogni 30 minuti.

  • Un utente può fare un numero massimo di 5 richieste POST ogni 24 h (finestra temporale).

  • Il parametro di modellazione è considerato facoltativo. Se non hai specificato alcun parametro, viene attivata la risorsa di modellazione predefinita.

  • Simile a tutte le altre chiamate API, l'attivazione del processo di modellazione con la richiesta POST è una chiamata autenticata all'endpoint di Raccomandazioni intelligenti, quindi devi includere i dettagli di autenticazione. Per ulteriori informazioni, vedi Guida rapida alle chiamate API autenticate.

Esempi di risposta API

Messaggio di operazione completata

Una risposta valida include un messaggio di esito positivo:

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

Error message

Potrebbe verificarsi un messaggio di errore:

  • Se è già in corso un ciclo di cottura
  • Se il numero di richieste di trigger supera la frequenza consentita (non più di 5 tentativi ogni 24 ore o più di una volta ogni 30 minuti).

Il messaggio di errore è simile a questo:

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

Per ulteriori informazioni su altri messaggi di errore che possono verificarsi durante il processo di modellazione, vedi Registri degli errori.

Vedi anche

Panoramica del contratto dati
Guida rapida: creare una richiesta API
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio
Panoramica della distribuzione