För att säkerställa konsekvent prestanda finns det flera begränsningar i Wdatas funktioner och API (Application Programming Interface) för utvecklare- som möjliggör anpassad integration för att ansluta dina data till Workiva-plattformen.
Även om dessa begränsningar sätter gränser för din arbetsyta rekommenderar vi att du själv begränsar antalet dataset när det är möjligt. Ytterligare dataset har en kaskadeffekt på bearbetningstiden, och du kan märka av långsammare prestanda när du närmar dig dessa gränser eller kör särskilt komplexa frågor.
Tabeller, frågor, vyer och kedjor
Wdata tillämpar ett antal funktionsbegränsningar på tabeller, frågor, vyer och kedjor.
Tabeller
| Funktion | Gräns |
|---|---|
| Uppladdning av filer |
Rekommenderad filstorlek: 300 MB eller mindre Maximal filstorlek: 1 GB Filformat: CSV eller TSV Obs: ZIP-filer kan användas för att minska uppladdningsstorleken, men de kommer inte att resultera i förbättrad frågeprestanda. |
| Kolumner per tabell | 150 |
| Faktatabeller | 1 miljard rader |
| Dimensionstabeller |
Rekommenderas: 1 miljon rader eller färre Maximalt: 2 miljoner rader |
| Anslutningar per kalkylark | 300 inkommande och 300 utgående |
| Taggvärden |
Max: 300 I stället för att lägga till ytterligare taggvärden rekommenderar vi att du antingen skapar en separat uppslagstabell eller använder frågor för att skapa en join-tabell i kalkylark. |
Frågor
| Funktion | Gräns |
|---|---|
| Parametrar per fråga | 30 |
| Namn på frågeparameter | 256 tecken |
| Objekt per parameter i plocklistan | 512 |
| Fråga SQL Editor-sats | 30.000 tecken |
| Anslutna frågor per kalkylark, dokument eller presentation | 100 |
| Celler per kalkylark | 3,000,000 |
UNION operatorer i SQL Editor |
20 |
Vyer
| Funktion | Gräns |
|---|---|
| Fråga rader per vy | 1,000,000 |
Obs : Försök att minska din frågestorlek genom att lägga till en LIMIT-klausul.
Kedjor
| Funktion | Gräns |
|---|---|
| Kopplingar | En som tillhandahålls med ett Solution-abonnemang Kontakta din Customer Success Manager om du vill köpa ytterligare anslutningar. |
| Variabler | Vi tillämpar inte längre någon gräns, men vi har observerat att applikationens respons försämras när kedjorna närmar sig 1000 variabler. |
| Aviseringar |
40 MB för utgående e-post Obs: Denna sändningsgräns påverkar inte mottagningsgränsen som satts av vissa tredjepartsleverantörer. |
Begränsningar av API-avgifter
Prisgränserna nedan tillämpas på nivån för arbetsytan och inte per användare. Om du överskrider dessa gränser får du ett felsvar med statuskoden 429 För många förfrågningar.
Du bör också notera att API:et begränsar längden på en begäran till 10 minuter.
Obs: API:et kan dessutom begränsa dina förfrågningar baserat på aktuell systembelastning eller överdriven frekvens. Särskilt bandbreddsintensiva körningar, som de som körs på en stor datamängd under en kort tidsperiod, kan medföra en liten fördröjning för att säkerställa att systemet förblir prestandaeffektivt.
Administrativa uppgifter
| Begäran | Begränsning per minut per arbetsyta |
| Ta bort en enskild arbetsyta | 5 |
| Exportera en enda arbetsyta | 5 |
| Importera data | 5 |
| Hämta filer för arbetsyta efter storlek | 10 |
| Hämta användning av arbetsyta för frågor | 55 |
| Hämta användning av uppladdning av arbetsyta | 50 |
| Validera arkivering | 5 |
| Validera tabeller | 5 |
Kedjor
Både dagliga och kortsiktiga gränser gäller för API:et.
Gränser:
- 50.000 förfrågningar till API:et inom en 24-timmarsperiod
- Burst-gräns på 100 förfrågningar inom en 20-sekunders period
Hantering av anslutningar
| Begäran | Begränsning per minut per arbetsyta |
| Hämta anslutningsinformation | 515 |
| Lista anslutningar | 2000 |
| Uppdatera koppling | 203 |
| Uppdatera antalet anslutningar | 20 |
| Hämta status för en batchuppdatering | 1000 |
| Hämta status för uppdateringsanslutning | 1000 |
Hantering av filer
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista med filer | 650 |
| Ladda upp en enda fil | 50 |
| Ta bort en enda fil | 50 |
| Hämta en enda fil | 150 |
| Ladda ner en enda fil | 50 |
| Hämta fel | 20 |
| Exportera en fil till kalkylark | 5 |
Hantering av mappar
| Begäran | Begränsning per minut per arbetsyta |
| Sök | 150 |
| Hämta en lista med mappar | 150 |
| Skapa en ny mapp | 150 |
| Ta bort en enskild mapp | 150 |
| Hämta en enstaka mapp | 150 |
| Uppdatera en enskild mapp | 150 |
| Hämta en lista över mappinnehåll | 150 |
| Flytta innehåll till en mapp | 150 |
Hantering av parametrar
| Begäran | Begränsning per minut per arbetsyta |
| Hämta parametrar | 50 |
| Skapa parameter | 10 |
| Ta bort parameter | 50 |
| Hämta parameter | 10 |
| Uppdatera parameter | 10 |
Hantering av pivot-vyer
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista med pivot-vyer | 50 |
| Skapa en ny vy för pivot | 10 |
| Ta bort en enda pivot-vy | 50 |
| Hämta en enda pivot-vy | 50 |
| Uppdatera en vy med en enda pivot | 10 |
Hantering av förfrågningar
| Begäran | Begränsning per minut per arbetsyta |
| Hämta lista med frågor | 192 |
| Skapa en ny fråga | 57 |
| Hämta data från frågekolumnen | 255 |
| Analyserar frågan för att avgöra om den är giltig | 255 |
| Ta bort en enskild fråga | 150 |
| Hämta en enda fråga | 1139 |
| Uppdatera en enskild fråga | 93 |
| Hämta beroenden | 10 |
| Hämta en lista över anhöriga | 60 |
| Hämta en lista med sökresultat | 39 |
| Exekvera en fråga | 400 |
| Avbryt en pågående fråga | 25 |
| Hämta ett enda sökresultat | 1200 |
| Ladda ner ett sökresultat | 100 |
| Exportera frågeresultat till kalkylark | 400 |
Välj listhantering
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista med utvalda listor | 10 |
| Skapa en ny urvalslista | 36 |
| Ta bort en enskild urvalslista | 10 |
| Hämta en enstaka lista | 108 |
| Uppdatera en enda urvalslista | 12 |
Hantering av aktier i bord
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista över tabeller med aktier | 90 |
| Skapa ett nytt bord för aktier | 8 |
| Ta bort en enda aktie-tabell | 10 |
| Hämta en enda aktie-tabell | 366 |
Tabellhantering
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista med tabeller | 220 |
| Skapa en ny tabell | 100 |
| Ta bort en enskild tabell | 45 |
| Hämta en enstaka tabell | 700 |
| Uppdatera en enskild tabell | 25 |
| Hämta en lista över anhöriga | 60 |
| Importera en enda fil | 50 |
| Återimportera en enda arkivering | 170 |
| Hämta importinformation | 50 |
| Importera från kalkylark | 10 |
Hantering av taggar
| Begäran | Begränsning per minut per arbetsyta |
| Hämta en lista med taggar | 50 |
| Skapa en ny tagg | 10 |
| Ta bort en enskild tagg | 10 |
| Uppdatera en enskild tagg | 10 |
Tokenhantering
| Begäran | Begränsning per minut per arbetsyta |
| Skapa en ny token | 150 |
Allmännyttiga tjänster
| Begäran | Begränsning per minut per arbetsyta |
| Analysera ett datum | 10 |
Begränsningar för lagring och sökning
API:et begränsar för närvarande storleken på livstidslagring och årliga frågor per prenumerationsnivå. Dessa gränser baseras på det totala antalet byte som skannas - inte på storleken på det resultat som skapas av din fråga. Ägare av arbetsytor kan spåra sin användning för att verifiera att deras organisation håller sig inom dessa gränser.
| Prenumeration | Livstids lagring | Årlig förfrågan |
|---|---|---|
| Lösning | 100GB | 120TB |
| Företag | 500GB | 3 000 TB |
I verkligheten kan bara 1 GB lagringsutrymme under fem år innehålla 8 miljoner poster, inklusive:
- Månadssiffrorna minskade med 10 dimensioner
- Rullande 12-månadersprognoser månadsvis
- Budgetuppgifter
Vi rekommenderar att du väljer en prenumerationsnivå som baseras på dina lagrings- eller sökbehov. Till exempel:
- Med en prenumeration på Solution kan du söka i en tabell med 100 GB data 1 200 gånger per år
- Med en prenumeration på Enterprise kan du med en sökgräns på 3000 TB söka efter data 3 gånger per år.
För att köpa ytterligare livstidslagring, kontakta din ägare eller kundansvarige.
Obs: Detta är hårda tak, vilket innebär att framtida import eller förfrågningar inte kan slutföras när gränsen har uppnåtts. Till exempel kommer du inte att kunna importera datauppsättningar till tabeller utöver din lagringsgräns, och Wdata-frågor kommer att misslyckas när frågegränsen överskrids.
Tidsfrister
Workiva Wdata API begränsar för närvarande längden på en begäran till 10 minuter.
Observera att tidsgränserna kan variera beroende på vilket Workiva API du ansluter till. Läs mer på Workiva Developer Hub.
Storlek på nyttolast
Workiva API begränsar storleken på en begäran till högst 10485760 byte (10 MB). Detta är en fastställd gräns för alla Workiva API:er.
Kryptering
För att säkerställa datasekretess och integritet använder API-anrop Transport Layer Security (TLS) 1.3