Le traitement Micro-Batch est une technique dans laquelle vous incluez plus d’un enregistrement dans une seule requête de service. En incluant différents enregistrements dans une requête au lieu d'émettre des requêtes distinctes pour chaque enregistrement, vous pouvez considérablement améliorer les performances lors du traitement d'un grand nombre d'enregistrements via un service. Spectrum Technology Platform prend en charge le traitement Micro-Batch pour les services Web REST et SOAP.
Point final du micro-lot
Pour AMER, utilisez amer-microbatch.precisely.com. Son délai d'attente de 5 minutes permet de plus grandes tailles de micro-lots.Taille du Micro-Batch
Pour les régions AMER et EMEA, avec le point de terminaison de micro-lot spécial, vous pouvez placer autant d'enregistrements que possible dans un délai de 5 minutes. Vous êtes facturé pour chaque enregistrement contenu dans la demande même si elle expire, il est donc recommandé de choisir un nombre d'enregistrements pouvant être traités en 4 minutes au cas où le traitement prendrait plus de temps.
Pour la région APAC, avec le point de terminaison standard, le nombre maximal d’enregistrements autorisé dans une requête dépend de la catégorie du service.
| Catégorie de service | Nombre maximal d’entités d’entrée |
|---|---|
| Adresses | 25 |
| Analytique | 10 |
| Qualité des données | 10 |
| Géocodage | 25 |
| Informations consommateur | 10 |
| PSAP | 25 |
| Routage | 1 |
| Analyste | 1 |
| Juridiction fiscale | 25 |
| Telco | 1 |
Chaque appel Micro-Batch doit être synchrone (1 à l a fois). Envoyez la demande et attendez la réponse avant d'envoyer une autre requête. Les appels Micro-Batch asynchrones peuvent surcharger Spectrum Technology Platform, ce qui risque d'entraîner une baisse des performances pour d'autres clients. Si vous utilisez des appels asynchrones ou si les appels Micro-Batch sont trop volumineux, votre compte peut être désactivé, pour veiller à ce que l'utilisation de Spectrum Technology Platform par d'autres clients ne soit pas affectée.
Utilisation d'un ID d'enregistrement
Il peut vous semblez utile d'assigner un ID à chaque enregistrement d'un Micro-Batch, afin de corréler les enregistrements de la requête avec les enregistrements renvoyés dans la réponse. Pour ce faire, utilisez des champs utilisateur. Pour des informations sur les champs utilisateur, voir L'interface REST. Pour des informations sur les champs utilisateur, voir L'interface SOAP.
Traitement Micro-Batch dans REST
Pour effectuer un traitement Micro-Batch avec un service Web REST, incluez deux ou davantage d'enregistrements au format XML ou JSON dans le corps de la requête et envoyez la requête via la méthode POST. Pour plus d'informations sur l'envoi d'une requête POST à un service Web Spectrum Technology Platform, reportez-vous aux sections Requête JSON POST et Requête XML POST.
Par exemple, cette requête inclut deux enregistrements au format XML dans le corps de la requête :
POST https://spectrum.precisely.com/rest/ValidateAddressPOST/results.xml HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: application/xml Authorization: Basic YWRtaW46YWRtaW4= Content-Length: 533 Host: spectrum.precisely.com Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) <ValidateAddressPOSTRequest xmlns:svc="http://www.pb.com/spectrum/services/ValidateAddressPOST"> <svc:Input> <svc:Row> <svc:AddressLine1>3001 Summer</svc:AddressLine1> <svc:City>Stamford</svc:City> <svc:StateProvince>CT</svc:StateProvince> </svc:Row> <svc:Row> <svc:AddressLine1>33 west monroe</svc:AddressLine1> <svc:City>Chicago</svc:City> <svc:StateProvince>IL</svc:StateProvince> </svc:Row> </svc:Input> </ValidateAddressPOSTRequest>Traitement Micro-Batch dans SOAP
Pour effectuer un traitement Micro-Batch dans un service Web SOAP, incluez deux ou davantage d'enregistrements dans la requête SOAP. Par exemple, cette requête contient deux enregistrements :
POST http://spectrum.example.com:8080/soap/ValidateAddress HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic YWRtaW46YWRtaW4= Content-Length: 782 Host: config813vm0:8080 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:val="http://www.pb.com/spectrum/services/ValidateAddress"> <soapenv:Header/> <soapenv:Body> <val:ValidateAddressRequest> <val:input_port> <val:Address> <val:AddressLine1>1 N. State St.</val:AddressLine1> <val:City>Chicago</val:City> <val:StateProvince>IL</val:StateProvince> </val:Address> <val:Address> <val:AddressLine1>3001 summer</val:AddressLine1> <val:City>stamford</val:City> <val:StateProvince>ct</val:StateProvince> </val:Address> </val:input_port> </val:ValidateAddressRequest> </soapenv:Body> </soapenv:Envelope>