Om consistente prestaties te garanderen, hanteren de functies van Wdata en de API (Application Programming Interface) voor ontwikkelaars — waarmee aangepaste integratie mogelijk is om uw gegevens met het Workiva-platform te verbinden — een aantal beperkingen.
Hoewel deze beperkingen grenzen stellen aan uw werkruimte, raden we u aan het aantal datasets zoveel mogelijk zelf te beperken. Extra datasets hebben een domino-effect op de verwerkingstijd, en u kunt een tragere prestatie merken wanneer u deze limieten nadert of bijzonder complexe query's uitvoert.
Tabellen, query's, weergaven en ketens
Wdata hanteert een aantal beperkingen voor de functionaliteit van tabellen, query's, weergaven en ketens.
Tabellen
| Functie | Beperken |
|---|---|
| Bestanden uploaden |
Aanbevolen bestandsgrootte: 300 MB of minder Maximale bestandsgrootte : 1 GB Bestandsformaat: CSV of TSV Opmerking: ZIP-bestanden kunnen worden gebruikt om de uploadgrootte te verkleinen, maar dit leidt niet tot betere queryprestaties. |
| Kolommen per tabel | 150 |
| Feitentabellen | 1 miljard rijen |
| Dimensietabellen |
Aanbevolen: 1 miljoen rijen of minder Maximum: 2 miljoen rijen |
| Verbindingen per spreadsheet | 300 inkomend & 300 uitgaand |
| Labelwaarden |
Maximum: 300 In plaats van extra tagwaarden toe te voegen, raden we aan om ofwel een aparte opzoektabel te maken, ofwel query's te gebruiken om een koppeltabel in spreadsheets te creëren. |
Query's
| Functie | Beperken |
|---|---|
| Parameters per zoekopdracht | 30 |
| Naam van de queryparameter | 256 tekens |
| Keuzelijst met items per parameter | 512 |
| Query SQL Editor-instructie | 30.000 tekens |
| Gekoppelde query's per spreadsheet, document of presentatie | 100 |
| Aantal cellen per spreadsheet | 3,000,000 |
UNION operators in SQL Editor |
20 |
Weergaven
| Functie | Beperken |
|---|---|
| Aantal rijen per weergave opvragen | 1,000,000 |
Opmerking : Probeer de omvang van uw query te verkleinen door een LIMIT-clausule toe te voegen.
Kettingen
| Functie | Beperken |
|---|---|
| Verbindingen | Eén exemplaar wordt geleverd met een Solution-abonnement; vijf met een Enterprise-abonnement. Neem contact op met uw Customer Success Manager om extra verbindingen aan te schaffen. |
| Variabelen | We hanteren geen limiet meer, maar hebben wel een verminderde responsiviteit van de applicatie geconstateerd wanneer ketens de grens van 1000 variabelen overschrijden. |
| Meldingen |
40 MB voor uitgaande e-mails Opmerking: Deze verzendlimiet heeft geen invloed op de ontvangstlimiet die door sommige externe providers is ingesteld. |
API-snelheidslimieten
De onderstaande snelheidslimieten gelden op werkruimteniveau en niet per gebruiker. Als u deze limieten overschrijdt, ontvangt u een foutmelding met statuscode 429 Too Many Requests .
Houd er ook rekening mee dat de API de maximale duur van een verzoek beperkt tot 10 minuten.
Opmerking : De API kan uw verzoeken bovendien beperken op basis van de huidige systeem belasting of buitensporige frequentie. Vooral bandbreedte-intensieve taken, zoals die op een grote dataset in een korte tijd, kunnen een kleine vertraging veroorzaken om de prestaties van het systeem te garanderen.
Administratieve taken
| Verzoek | Limiet per minuut per werkplek |
| Een enkele werkruimte verwijderen | 5 |
| Exporteer een enkele werkruimte | 5 |
| Importeer gegevens | 5 |
| Werkruimtebestanden ophalen op grootte | 10 |
| Gebruik van werkruimtequery ophalen | 55 |
| Gebruik van de uploadfunctie van de werkruimte ophalen | 50 |
| Valideer bestanden | 5 |
| Tabellen valideren | 5 |
Chains
Er gelden zowel dagelijkse als kortetermijnlimieten voor de API.
Grenzen:
- 50.000 API-aanvragen binnen een periode van 24 uur
- Een burstlimiet van 100 verzoeken binnen een periode van 20 seconden.
Verbindingsbeheer
| Verzoek | Limiet per minuut per werkplek |
| Verbindingsgegevens opvragen | 515 |
| Lijstverbindingen | 2000 |
| Verbinding vernieuwen | 203 |
| Vernieuw de batch verbindingen | 20 |
| De status van een batchverversing opvragen | 1000 |
| Vernieuw de verbindingsstatus | 1000 |
Bestandsbeheer
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met bestanden ophalen | 650 |
| Upload één bestand | 50 |
| Een enkel bestand verwijderen | 50 |
| Een enkel bestand ophalen | 150 |
| Een enkel bestand downloaden | 50 |
| Fouten ophalen | 20 |
| Exporteer een bestand naar spreadsheets. | 5 |
Mapbeheer
| Verzoek | Limiet per minuut per werkplek |
| Zoeken | 150 |
| Een lijst met mappen ophalen | 150 |
| Maak een nieuwe map aan | 150 |
| Een enkele map verwijderen | 150 |
| Een enkele map ophalen | 150 |
| Een enkele map bijwerken | 150 |
| Een lijst met mapinhoud ophalen | 150 |
| Verplaats de inhoud naar een map. | 150 |
Parameterbeheer
| Verzoek | Limiet per minuut per werkplek |
| Parameters ophalen | 50 |
| Parameter aanmaken | 10 |
| Verwijder parameter | 50 |
| Parameter ophalen | 10 |
| Updateparameter | 10 |
Beheer van draaiweergaven
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met draaitabelweergaven ophalen | 50 |
| Een nieuwe draaiweergave maken | 10 |
| Een enkele draaiweergave verwijderen | 50 |
| Een enkele pivotweergave ophalen | 50 |
| Een enkele draaiweergave bijwerken | 10 |
Querybeheer
| Verzoek | Limiet per minuut per werkplek |
| Lijst met zoekopdrachten ophalen | 192 |
| Maak een nieuwe query aan | 57 |
| Gegevens uit querykolommen ophalen | 255 |
| Analyseert de query om te bepalen of deze geldig is. | 255 |
| Een enkele query verwijderen | 150 |
| Een enkele zoekopdracht ophalen | 1139 |
| Een enkele query bijwerken | 93 |
| Afhankelijkheden ophalen | 10 |
| Een lijst met gezinsleden ophalen | 60 |
| Een lijst met zoekresultaten ophalen | 39 |
| Voer een query uit | 400 |
| Een lopende query annuleren | 25 |
| Een enkel zoekresultaat ophalen | 1200 |
| Een zoekresultaat downloaden | 100 |
| Exporteer de zoekresultaten naar spreadsheets. | 400 |
Selectielijstbeheer
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met selectielijsten 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 tafels
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met gedeelde tabellen ophalen | 90 |
| Maak een nieuwe gedeelde tabel aan. | 8 |
| Een enkele gedeelde tabel verwijderen | 10 |
| Een enkele gedeelde tabel ophalen | 366 |
Tabelbeheer
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met tabellen ophalen | 220 |
| Maak een nieuwe tabel aan | 100 |
| Een enkele tabel verwijderen | 45 |
| Een enkele tabel ophalen | 700 |
| Een enkele tabel bijwerken | 25 |
| Een lijst met gezinsleden ophalen | 60 |
| Een enkel bestand importeren | 50 |
| Een enkel bestand de-importeren | 170 |
| Importinformatie ophalen | 50 |
| Importeren vanuit spreadsheets | 10 |
Tagbeheer
| Verzoek | Limiet per minuut per werkplek |
| Een lijst met tags ophalen | 50 |
| Een nieuwe tag aanmaken | 10 |
| Verwijder een enkele tag | 10 |
| Een enkele tag bijwerken | 10 |
Tokenbeheer
| Verzoek | Limiet per minuut per werkplek |
| Een nieuw token aanmaken | 150 |
Hulpprogramma's
| Verzoek | Limiet per minuut per werkplek |
| Een datum ontleden | 10 |
Opslag- en querylimieten
De API beperkt momenteel de omvang van de levenslange opslag en het aantal 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 gegenereerd. Eigenaren van werkruimtes kunnen hun gebruik volgen om te controleren of hun organisatie binnen deze limieten blijft.
| Abonnement | Levenslange opslag | Jaarlijkse controle |
|---|---|---|
| Oplossing | 100GB | 120TB |
| Onderneming | 500GB | 3.000 TB |
In de praktijk kan slechts 1 GB opslagruimte gedurende vijf jaar 8 miljoen records bevatten, waaronder:
- Maandelijkse werkelijke cijfers gedeeld door 10 dimensies
- Maandelijkse voortschrijdende 12-maandsprognoses
- Budgetgegevens
Wij raden u aan een abonnement te kiezen dat aansluit op uw opslag- of zoekbehoeften. Bijvoorbeeld:
- Met een Solution abonnement kunt u een tabel met 100 GB aan gegevens 1200 keer per jaar opvragen; of een tabel met 50 GB aan gegevens 2400 keer per jaar.
- Met een Enterprise abonnement kunt u dankzij de querylimiet van 3000 TB gegevens 3 miljoen keer per jaar opvragen.
Neem contact op met uw accountmanager of klantenservicemanager om extra opslagruimte voor onbepaalde tijd aan te schaffen.
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 groter zijn dan uw opslaglimiet, en Wdata-query's zullen mislukken zodra de querylimiet is overschreden.
Time-outs
De Workiva Wdata API beperkt de maximale duur van een verzoek momenteel tot 10 minuten.
Houd er rekening mee dat de time-outs kunnen variëren, afhankelijk van de Workiva API waarmee u verbinding maakt. Meer informatie vind je in de Workiva Developer Hub.
Laadvermogen
De Workiva API beperkt de grootte van elk verzoek tot maximaal 10485760 bytes (10 MB). Dit is een ingestelde limiet voor alle Workiva API's.
Versleuteling
Om de privacy en integriteit van gegevens te waarborgen, maken API-aanroepen gebruik van Transport Layer Security (TLS) 1.3; voor gegevens in rust wordt Advanced Encryption Standard (AES) 256 gebruikt.