Activeer de modelleringscyclus handmatig

Artikel
10/07/2024

Dit artikel is een handleiding voor ontwikkelaars die de tool "Nu modelleren" willen gebruiken om handmatig een verwerkingscyclus willen starten voor hun modelleringsresource.

Nadat een modelleringsresource is gemaakt en geïmplementeerd, gaat de service Intelligent Recommendations door met het verwerken van gegevens via een periodieke verwerkingscyclus. Standaard vindt de gegevensverwerkingscyclus elke 36 uur plaats.

U kunt ervoor kiezen om de modelleringscyclus handmatig te activeren (met enkele beperkingen), eerder dan het standaard 36-uurs schema. Redenen voor een standaardpush voor modellering kunnen te maken hebben met het op het laatste moment finetunen van gegevens of kunnen het gevolg zijn van fouten in de gegevensconfiguratie in Azure Data Lake Storage.

Gebruik de API-aanroep die in dit artikel wordt beschreven om het modelleringsproces handmatig te activeren.

Het modelleringsproces handmatig activeren

Een modelleringscyclus activeren met Insomnia

De volgende POST-aanvraag start een nieuw modelleringscyclus:

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

U kunt uw eindpunt-URL vinden met behulp van de stappen in de Aan de slag voor het bekijken van de aanbevelingsresultaten.

Beperkingen bij het handmatig activeren van het modelleringsproces

Er zijn enkele beperkingen waarmee u rekening moet houden bij het handmatig activeren van het modelleringsproces:

Een gebruiker kan elke 30 minuten een nieuwe POST-aanvraag Model Now uitvoeren.
Een gebruiker kan maximaal vijf POST-aanvragen per 24 uur (lopende telling) uitvoeren.
De modelleringsparameter wordt als optioneel beschouwd. Als u geen parameter hebt opgegeven, wordt de standaard modelleringsresource geactiveerd.
Net als bij alle andere API-aanroepen, is het activeren van het modelleringsproces met de POST-aanvraag een geverifieerde aanroep naar het Intelligent Recommendations-eindpunt en dus moet u de authenticatiedetails opnemen. Voor meer informatie, zie Aan de slag voor geverifieerde API-aanroepen.

Voorbeelden van API-respons

Succesbericht

Een geslaagde respons omvat een succesbericht:

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

Error message

Er kan een foutmelding optreden:

Als er al een bewerkingscyclus bezig is
Als er te veel activeringsaanvragen zijn verzonden die de toegestane frequentie overschrijden (maximaal 5 pogingen per 24 uur of meer dan eens per half uur).

De foutmelding ziet er als volgt uit:

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

Voor meer informatie over andere foutmeldingen die kunnen optreden tijdens het modelleringsproces, zie Foutenlogboeken.

Zie ook

Overzicht van gegevenscontracten
Snelstartgids: Een API-aanvraag maken
Snelstartgids: Intelligent Recommendations instellen en uitvoeren met voorbeeldgegevens
Implementatieoverzicht

Delen via