Invantive SQL gör det enkelt att massuppdatera och synkronisera data, eftersom tekniken döljs under huven. Med update-satsen och/eller synchronize-satsen kan du enkelt massuppdatera data i molnapplikationer så att alla dina affärsprocesser använder samma data.
Vissa molnapplikationer begränsar, av tekniska, fair use- och/eller kommersiella skäl, antalet API-anrop. Ofta ges ett felmeddelande vid överskridande, såsom “Too many requests” eller en HTTP 429-statuskod.
Den vanliga termen för en sådan begränsning av API-anrop är “rate limit”. Ibland gäller flera rate limits samtidigt, till exempel per dag, per månad, per minut, per API, per API-operation (läsning/skrivning) eller per API-resultat: med eller utan felmeddelande.
Ofta kan extra API-anrop köpas till så att rate limit höjs, antingen med förskottsbetalning eller efterhandsdebitering. På vissa plattformar är en utökning av API-anropsgränsen till högre/extra gränser relativt dyr, med toppar på flera tiotals euro per styck för komplexa anrop, medan det på andra plattformar är extremt billigt.
Det är klokt att använda det tillgängliga utrymmet i rate limits för API-anrop vid rätt tidpunkter, om antalen är begränsade per tidsenhet, till exempel månad eller dag. Ändringar med låg prioritet bör genomföras i slutet av perioden för att få maximal avkastning på din investering i molnplattformen.
Variera antalet API-anrop över tid endast efter att du först har begränsat antalet API-anrop; funktionella tips om detta finns på Hoe plan ik mijn Exact Online-omgeving op het beschikbare aantal API-calls? och tekniska tips till exempel på Snel en met minder API-calls Exact Online uitlezen met de incrementele "sync API"-tabellen.
Invantive SQL erbjuder funktioner för att använda det tillgängliga utrymmet i rate limits för API-anrop så effektivt som möjligt. Det tillgängliga utrymmet syns hos de flesta plattformar i kolumner i data dictionary-vyn SystemPartitions@DataDictionary. Där finns kolumner för rate limits per dag, timme och minut, samt antalet förfrågningar under innevarande dag, timme och minut.
För synchronize-satsen kan du ange hur många ändringar som maximalt får ske. Detta är dock även möjligt med de traditionella SQL-satserna update, delete och insert.
Det maximala antalet ändringar för update, delete, insert kan du ställa in via limit ANTAL, precis som limit begränsar antalet rader från ett urval via select.
Detta illustreras med hjälp av ett praktikfall med Exact Online-API:t.
Fall: Ändra fakturabilagor
I bokföringssystemet Exact Online kan du per relation i en administration ange i vilka format fakturorna skickas. Detta kan vara en kombination av format, som kombineras till ett tal via så kallad “bitwise AND”. Värdet “1” betyder till exempel endast säljfakturor i PDF-format, värdet “2” betyder UBL-format och värdet “3” betyder både PDF- och UBL-format.
I en Exact Online-databas med administrationer som vardera har 50 000 relationer behöver formatet för fakturabilagor ändras från PDF plus UBL till endast PDF, för alla administrationer. Antalet API-anrop per dag på Exact Online är dock bara en bråkdel av de 50 000 API-anrop som behövs, och omvandlingen har lägre prioritet än den dagliga bearbetningen.
Därför genomförs ändringarna i Exact Online i slutet av dagen, för att förbruka eventuellt återstående API-anropsbudget med dessa extra förfrågningar.
Högst prioritet har denna ändring för säljkunder; övriga relationer har ännu ingen kundstatus.
I jobbet kan antalet ändringar i Exact Online begränsas till 10 via följande uppdatering:
use SELECTIE_ADMINISTRATIES@eol
update exactonlinerest..accounts@eol
set InvoiceAttachmentType = 1
where InvoiceAttachmentType = 3
and status = 'C'
limit 100
Observera att Exact Online-tabellen AccountsIncremental inte används här; den är skrivskyddad och skulle kräva en mer komplex synchronize-sats, medan where-satsen tack vare Invantives server-side filtering och Exact Onlines filter kan skickas direkt till Exact Online, vilket innebär att endast 1 Exact Online API-anrop behövs för att hämta de rader som ska uppdateras.
Denna sats kommer - om det fortfarande finns kunder som behöver ändras - att vara klar efter ungefär 3 sekunder.
En eventuell resterande API-anropsbudget kan användas för att även ställa in typen av fakturabilagor för icke-kunderna:
use SELECTIE_ADMINISTRATIES@eol
update exactonlinerest..accounts@eol
set InvoiceAttachmentType = 1
where InvoiceAttachmentType = 3
limit 100
Förfining: fler administrationer
Massändringen kan enkelt utökas till flera administrationer. Ange först administrationsurvalet, till exempel för alla Exact Online-administrationer:
use all@eol
update exactonlinerest..accounts@eol
set InvoiceAttachmentType = 1
where InvoiceAttachmentType = 3
and status = 'C'
limit 1000
update exactonlinerest..accounts@eol
set InvoiceAttachmentType = 1
where InvoiceAttachmentType = 3
limit 1000
Eftersom API-gränserna på Exact Online för närvarande gäller per administration, är det möjligt att ställa in gränsen högre. I detta exempel har 10 administrationer antagits, där de 1000 uppdateringarna genom den parallella bearbetningen grovt sett kommer att fördelas över alla 10, såvida inte mängden nödvändiga API-uppdateringar per administration varierar betydligt.
Förfining: endast ledigt API-anropsutrymme på kortast möjliga tid
En mer avancerad förfining är att begränsa antalet API-anrop till det tillgängliga antalet för en administration, samt minimera genomloppstiden (utan parallellisering).
Följande block med Invantive PSQL avfyrar upprepade gånger korta serier av uppdateringar, där längden väljs så att Exact Onlines minutgräns på 60 API-anrop per minut fylls så snabbt som möjligt:
declare
l_did_work boolean;
l_dummy_cnt number;
g_max_call_per_minute pls_integer := 50 /* Något lägre än 60 för att kunna växla oftare. */;
begin
use all@eol;
--
-- Se till att siffrorna för återstående API-anrop är aktuella
-- genom att beröra alla administrationer kort.
--
select /*+ http_disk_cache(false) http_memory_cache(false) */ count(*)
into l_dummy_cnt
from exactonlinerest..journals@eol
;
l_did_work := true;
while l_did_work
loop
dbms_output.put_line('Försöker nå API-anropets minutgränser per administration under en minut.');
l_did_work := false;
for r
in
( select 'update exactonlinerest..accounts@eol'
|| ' set InvoiceAttachmentType = 1'
|| ' where InvoiceAttachmentType = 3'
|| ' limit '
|| to_char
( case
when DAILY_REMAINING > g_max_call_per_minute
then g_max_call_per_minute
else DAILY_REMAINING
--
-- Lämna 500 Exact Online API-anrop kvar för oförutsedda
-- prioriteringar senare idag.
--
- 500
end
)
stmt
, 'Uppdatera maximalt '
|| g_max_call_per_minute
|| ' rader i administration '
|| code
|| ' - '
|| name
txt
from SYSTEMPARTITIONS@DataDictionary
where IS_SELECTED = true
and PROVIDER_NAME = 'ExactOnlineAll'
and PROVIDER_DATA_CONTAINER_ALIAS = 'eol'
--
-- Det måste finnas minst 500 API-anrop kvar
-- idag för denna administration.
--
and DAILY_REMAINING > 500
)
loop
dbms_output.put_line(r.txt);
execute immediate r.stmt;
l_did_work := true;
end loop;
end loop;
end;