Traitement Micro-Batch - Spectrum_OnDemand - spectrum_platform - web_services - 23 - 23.1

Guide d'administration Spectrum

Product type
Logiciels
Portfolio
Integrate
Locate
Verify
Product family
Product
Spectrum > Spectrum Platform
Version
23.1
Language
Français
Product name
Spectrum Technology Platform
Title
Guide d'administration Spectrum
Topic type
Conseils
Administration
Aperçu
Référence
Comment faire
First publish date
2007
ft:lastEdition
2023-10-12
ft:lastPublication
2023-10-12T07:14:51.523252

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.
Pour la région EMEA, utilisez emea-microbatch.precisely.com. Son délai d'attente de 5 minutes permet de plus grandes tailles de micro-lots.
Pour la région APAC, utilisez le point de terminaison standard, car elle n'a pas de point de terminaison de micro-lot spécial. Ce point de terminaison a un délai d'expiration de 30 secondes : le nombre d'enregistrements dans un micro-lot devra donc être plus réduit.

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>
Remarque : Par défaut, les services ne prennent pas en charge POST. Pour effectuer un traitement Micro-Batch avec ces services, vous devez activer la prise en charge POST. Pour plus d'informations, reportez-vous à la section Ajout de la prise en charge POST à un service Web REST.

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>