Om consistente prestaties te helpen garanderen, leggen de functies van Wdata en Application Programming Interface (API) voor ontwikkelaars- die aangepaste integratie mogelijk maakt om uw gegevens met het Workiva-platform te verbinden - verschillende beperkingen op.
Hoewel deze beperkingen grenzen stellen aan uw werkruimte, raden wij u aan het aantal datasets waar mogelijk zelf te beperken. Extra datasets hebben een cascade-effect op de verwerkingstijd, en u kunt vertraagde prestaties opmerken wanneer u deze limieten nadert of bijzonder complexe queries uitvoert.
Tabellen, query's, weergaven en ketens
Wdata dwingt een aantal feature-limieten af op tabellen, queries, views en ketens.
Tabellen
Functie | Beperk |
---|---|
Bestanden uploaden |
Aanbevolen bestandsgrootte: 300 MB of minder Maximale bestandsgrootte: 1 GB Bestandsformaat: CSV of TSV Opmerking: ZIP-bestanden kunnen gebruikt worden om de uploadgrootte te verminderen, maar ze zullen niet resulteren in betere queryprestaties. |
Kolommen per tabel | 150 |
Feitentabellen | 1 miljard rijen |
Maattabellen |
Aanbevolen: 1 miljoen rijen of minder Maximaal: 2 miljoen rijen |
Aansluitingen per spreadsheet | 100 inkomend & 100 uitgaand |
Tag-waarden |
Maximaal: 300 In plaats van extra tagwaarden toe te voegen, raden wij aan om ofwel een aparte opzoektabel te maken of queries te gebruiken om een join tabel in spreadsheets te maken. |
Zoekopdrachten
Functie | Beperk |
---|---|
Parameters per query | 30 |
Naam van de queryparameter | 256 tekens |
Items per parameter keuzelijst | 512 |
Query SQL Editor-instructie | 30.000 tekens |
Verbonden query's per spreadsheet, document of presentatie | 100 |
Cellen per spreadsheet | 2,000,000 |
UNION operatoren in SQL Editor |
20 |
Weergaven
Functie | Beperk |
---|---|
Query rijen per weergave | 1,000,000 |
Opmerking: Probeer uw query te verkleinen door een LIMIT-clausule toe te voegen.
Kettingen
Functie | Beperk |
---|---|
Verbindingen | Eén geleverd met een Solution abonnement; vijf met Enterprise. Neem contact op met uw Customer Success Manager om extra aansluitingen aan te schaffen. |
Variabelen | 100 per ketting |
Meldingen |
40MB voor uitgaande e-mails Opmerking: Deze verzendlimiet heeft geen invloed op de ontvangstlimiet die door sommige externe providers is ingesteld. |
API-limieten
De onderstaande snelheidslimieten worden afgedwongen op het niveau van de werkruimte en niet per gebruiker. Als u deze limieten overschrijdt, krijgt u een foutmelding met een statuscode van 429 Too Many Requests
.
Houd er ook rekening mee dat de API de lengte van een verzoek beperkt tot 10 minuten.
Opmerking: De API kan uw verzoeken extra beperken op basis van de huidige systeembelasting of overmatige frequentie. Bijzonder bandbreedte-intensieve runs, zoals runs op een grote dataset gedurende een korte periode, kunnen een kleine vertraging oplopen om ervoor te zorgen dat het systeem goed blijft presteren.
Administratieve taken
Aanvraag | Limiet per minuut per werkruimte |
Een enkele werkruimte verwijderen | 5 |
Een enkele werkruimte exporteren | 5 |
Gegevens importeren | 5 |
Werkruimtebestanden op grootte ophalen | 10 |
Werkruimte querygebruik ophalen | 55 |
Uploadgebruik van werkruimte ophalen | 50 |
Bestanden valideren | 5 |
Tabellen valideren | 5 |
Kettingen
Zowel dagelijkse als kortetermijnlimieten zijn van toepassing op de API.
Grenzen:
- 50.000 verzoeken aan de API binnen een periode van 24 uur
- Burst-limiet van 100 verzoeken binnen een periode van 20 seconden
Beheer van verbindingen
Aanvraag | Limiet per minuut per werkruimte |
Verbindingsgegevens ophalen | 515 |
Lijst verbindingen | 2000 |
Verbinding vernieuwen | 203 |
Batch verbindingen vernieuwen | 20 |
Verkrijg de status van een batchverversing | 1000 |
Vernieuw de verbindingsstatus | 1000 |
Bestandsbeheer
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met bestanden ophalen | 650 |
Een enkel bestand uploaden | 50 |
Een enkel bestand verwijderen | 50 |
Een enkel bestand ophalen | 150 |
Een enkel bestand downloaden | 50 |
Fouten ophalen | 20 |
Een bestand exporteren naar spreadsheets | 5 |
Beheer van mappen
Aanvraag | Limiet per minuut per werkruimte |
Zoeken | 150 |
Een lijst met mappen ophalen | 150 |
Een nieuwe map maken | 150 |
Een enkele map verwijderen | 150 |
Een enkele map ophalen | 150 |
Een enkele map bijwerken | 150 |
Een lijst met mapinhoud ophalen | 150 |
Inhoud naar een map verplaatsen | 150 |
Parameterbeheer
Aanvraag | Limiet per minuut per werkruimte |
Verkrijg parameters | 50 |
Parameter aanmaken | 10 |
Parameter verwijderen | 50 |
Parameter krijgen | 10 |
Parameter bijwerken | 10 |
Beheer van draaivieweergaven
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met draaitabelweergaven ophalen | 50 |
Een nieuwe draaitabel maken | 10 |
Een enkele spilweergave verwijderen | 50 |
Een enkele spilweergave ophalen | 50 |
Een enkele draaitabel bijwerken | 10 |
Beheer van zoekopdrachten
Aanvraag | Limiet per minuut per werkruimte |
Lijst met zoekopdrachten ophalen | 192 |
Een nieuwe query maken | 57 |
Query kolomgegevens ophalen | 255 |
Parseert de query om te bepalen of deze geldig is | 255 |
Een enkele query verwijderen | 150 |
Een enkele query ophalen | 1139 |
Een enkele query bijwerken | 93 |
Afhankelijkheden ophalen | 10 |
Een lijst van personen ten laste opvragen | 60 |
Een lijst met queryresultaten ophalen | 39 |
Een query uitvoeren | 400 |
Een lopende query annuleren | 25 |
Een enkel queryresultaat ophalen | 1200 |
Een zoekresultaat downloaden | 100 |
Queryresultaten exporteren naar spreadsheets | 400 |
Lijstbeheer selecteren
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met geselecteerde lijsten ophalen | 10 |
Een nieuwe selectielijst maken | 36 |
Een enkele selectielijst verwijderen | 10 |
Een enkele lijst ophalen | 108 |
Een enkele selectielijst bijwerken | 12 |
Beheer van gedeelde tabellen
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met gedeelde tabellen ophalen | 90 |
Een nieuwe gedeelde tabel aanmaken | 8 |
Een enkele gedeelde tabel verwijderen | 10 |
Een enkele gedeelde tabel ophalen | 366 |
Tabel beheer
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met tabellen ophalen | 220 |
Een nieuwe tabel maken | 100 |
Een enkele tabel verwijderen | 45 |
Een enkele tabel ophalen | 700 |
Een enkele tabel bijwerken | 25 |
Een lijst van personen ten laste opvragen | 60 |
Eén bestand importeren | 30 |
Eén bestand importeren | 170 |
Importinformatie ophalen | 50 |
Importeren vanuit spreadsheets | 10 |
Tag beheer
Aanvraag | Limiet per minuut per werkruimte |
Een lijst met tags ophalen | 50 |
Een nieuwe tag maken | 10 |
Een enkele tag verwijderen | 10 |
Een enkele tag bijwerken | 10 |
Beheer van tokens
Aanvraag | Limiet per minuut per werkruimte |
Een nieuw token aanmaken | 150 |
Hulpprogramma's
Aanvraag | Limiet per minuut per werkruimte |
Een datum ontleden | 10 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
Limieten voor opslag en opvragen
De API beperkt momenteel de grootte van de levenslange opslag en jaarlijkse query's per abonnementsniveau. Deze limieten zijn gebaseerd op het totale aantal gescande bytes -- niet op de grootte van het resultaat dat door uw query wordt aangemaakt. Eigenaars van werkruimten kunnen hun gebruik bijhouden om te controleren of hun organisatie binnen deze limieten blijft.
Abonnement | Levenslange opslag | Jaarlijks opvragen |
---|---|---|
Oplossing | 100GB | 120TB |
Onderneming | 500GB | 3000TB |
In de praktijk kan slechts 1 GB opslagruimte gedurende vijf jaar 8M records bevatten, waaronder:
- Maandelijkse actuals verminderd met 10 dimensies
- Maandelijkse voortschrijdende prognoses voor 12 maanden
- Begrotingsgegevens
Wij raden u aan een abonnementsniveau te kiezen op basis van uw opslag- of querybehoeften. Bijvoorbeeld:
- Met een abonnement op Solution kunt u een tabel met 100 GB gegevens 1200 keer per jaar opvragen; of een tabel met 50 GB gegevens 2400 keer per jaar.
- Met een Enterprise abonnement kunt u met de limiet van 3000 TB gegevens 3M keer per jaar opvragen.
Om extra levenslange opslag aan te schaffen, neemt u contact op met uw accounteigenaar of customer success manager.
Opmerking: Dit zijn harde limieten, wat betekent dat toekomstige importen of query's niet kunnen worden voltooid zodra de limiet is bereikt. U kunt bijvoorbeeld geen datasets importeren in tabellen die uw opslaglimiet overschrijden, en Wdata query's zullen mislukken zodra de querylimiet wordt overschreden.
Time-outs
De Workiva Wdata API beperkt momenteel de lengte van een verzoek tot 10 minuten.
Let op: time-outs kunnen variëren, afhankelijk van met welke Workiva API u verbinding maakt. Meer informatie vindt u op Workiva Developer Hub.
Grootte nuttige lading
De Workiva API beperkt de grootte van een verzoek tot maximaal 10485760 bytes (10MB). Dit is een vaste limiet voor alle Workiva API's.
Versleuteling
Om de privacy en integriteit van gegevens te waarborgen, maken API-oproepen gebruik van Transport Layer Security (TLS) 1.3; Advanced Encryption Standard (AES) 256 in rust.