Per garantire prestazioni costanti, le funzionalità di Wdata e l'API (Application Programming Interface) per sviluppatori - che consente un'integrazione personalizzata per collegare i dati alla piattaforma Workiva - impongono diversi limiti.
Sebbene questi vincoli forniscano dei limiti per l'area di lavoro, si consiglia di autolimitare il numero di set di dati quando possibile. I set di dati aggiuntivi hanno un effetto a cascata sul tempo di elaborazione e si può notare un rallentamento delle prestazioni quando ci si avvicina a questi limiti o si eseguono query particolarmente complesse.
Tabelle, query, viste e catene
Wdata applica una serie di limiti alle tabelle, alle query, alle viste e alle catene.
Tavoli
| Caratteristica | Limite |
|---|---|
| Caricamento dei file |
Dimensioni del file consigliate: 300 MB o meno Dimensione massima del file: 1 GB Formato del file: CSV o TSV Nota: i file ZIP di possono essere utilizzati per ridurre le dimensioni del caricamento, ma non migliorano le prestazioni della query. |
| Colonne per tabella | 150 |
| Tabelle dei fatti | 1 miliardo di righe |
| Tabelle dimensionali |
Consigliato: 1 milione di righe o meno Massimo: 2 milioni di righe |
| Connessioni per foglio di calcolo | 100 in entrata e 100 in uscita |
| Valori dei tag |
Massimo: 300 Piuttosto che aggiungere altri valori di tag, si consiglia di creare una tabella di ricerca separata o di utilizzare le query di per creare una tabella di join nei fogli di calcolo. |
Domande
| Caratteristica | Limite |
|---|---|
| Parametri per query | 30 |
| Nome del parametro della query | 256 caratteri |
| Elenco di voci per parametro | 512 |
| Query SQL Editor | 30.000 caratteri |
| Query collegate per foglio di calcolo, documento o presentazione | 100 |
| Celle per foglio di calcolo | 2,000,000 |
Operatori UNION in SQL Editor |
20 |
Visualizzazioni
| Caratteristica | Limite |
|---|---|
| Query di righe per vista | 1,000,000 |
Nota: provare a ridurre le dimensioni della query aggiungendo una clausola LIMIT.
Catene
| Caratteristica | Limite |
|---|---|
| Connessioni | Uno fornito con un abbonamento Solution; cinque con Enterprise. Per acquistare connessioni aggiuntive, contattate il vostro Customer Success Manager. |
| Variabili | 100 per catena |
| Notifiche |
40MB per le e-mail in uscita Nota: Questo limite di invio non influisce sul limite di ricezione impostato da alcuni provider di terze parti. |
Limiti del tasso API
I limiti di velocità indicati di seguito vengono applicati a livello di area di lavoro e non per utente. Se si superano questi limiti, si riceve una risposta di errore con un codice di stato di 429 Too Many Requests.
Si noti inoltre che l'API limita la durata di ogni richiesta a 10 minuti.
Nota: L'API può limitare ulteriormente le richieste in base al carico attuale del sistema o alla frequenza eccessiva. Le esecuzioni particolarmente impegnative dal punto di vista della larghezza di banda, come quelle eseguite su un grande insieme di dati in un breve periodo di tempo, possono subire un leggero ritardo per garantire che il sistema rimanga performante.
Compiti amministrativi
| Richiesta | Limite al minuto per area di lavoro |
| Eliminare un singolo spazio di lavoro | 5 |
| Esportazione di una singola area di lavoro | 5 |
| Importazione di dati | 5 |
| Recuperare i file dell'area di lavoro per dimensione | 10 |
| Recupero dell'utilizzo della query dell'area di lavoro | 55 |
| Recupero dell'utilizzo del caricamento dello spazio di lavoro | 50 |
| Convalida dei file | 5 |
| Convalidare le tabelle | 5 |
Catene
All'API si applicano limiti sia giornalieri che a breve termine.
Limiti:
- 50.000 richieste all'API in un periodo di 24 ore
- Limite di burst di 100 richieste in un periodo di 20 secondi
Gestione delle connessioni
| Richiesta | Limite al minuto per area di lavoro |
| Ottenere i dettagli della connessione | 515 |
| Elenco connessioni | 2000 |
| Aggiornare la connessione | 203 |
| Aggiornare il gruppo di connessioni | 20 |
| Ottenere lo stato di un aggiornamento batch | 1000 |
| Ottenere lo stato di aggiornamento della connessione | 1000 |
Gestione dei file
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di file | 650 |
| Caricare un singolo file | 50 |
| Eliminare un singolo file | 50 |
| Recuperare un singolo file | 150 |
| Scaricare un singolo file | 50 |
| Recuperare gli errori | 20 |
| Esportare un file in fogli di calcolo | 5 |
Gestione delle cartelle
| Richiesta | Limite al minuto per area di lavoro |
| Ricerca | 150 |
| Recuperare un elenco di cartelle | 150 |
| Creare una nuova cartella | 150 |
| Eliminare una singola cartella | 150 |
| Recuperare una singola cartella | 150 |
| Aggiornare una singola cartella | 150 |
| Recuperare un elenco dei contenuti delle cartelle | 150 |
| Spostare il contenuto in una cartella | 150 |
Gestione dei parametri
| Richiesta | Limite al minuto per area di lavoro |
| Ottenere i parametri | 50 |
| Creare un parametro | 10 |
| Cancellare il parametro | 50 |
| Ottenere il parametro | 10 |
| Parametro di aggiornamento | 10 |
Gestione delle viste pivot
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di viste pivot | 50 |
| Creare una nuova vista pivot | 10 |
| Eliminare una singola vista pivot | 50 |
| Recuperare una singola vista pivot | 50 |
| Aggiornare una singola vista pivot | 10 |
Gestione delle query
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare l'elenco delle query | 192 |
| Creare una nuova query | 57 |
| Recuperare i dati delle colonne della query | 255 |
| Analizza la query per determinare se è valida | 255 |
| Eliminare una singola query | 150 |
| Recuperare una singola query | 1139 |
| Aggiornare una singola query | 93 |
| Recuperare le dipendenze | 10 |
| Recuperare un elenco di persone a carico | 60 |
| Recuperare un elenco di risultati della query | 39 |
| Eseguire una query | 400 |
| Annullare una query in corso | 25 |
| Recuperare un singolo risultato della query | 1200 |
| Scaricare il risultato di una query | 100 |
| Esportazione dei risultati della query in fogli di calcolo | 400 |
Selezionare la gestione dell'elenco
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di elenchi selezionati | 10 |
| Creare un nuovo elenco di selezione | 36 |
| Eliminare un singolo elenco di selezione | 10 |
| Recuperare un singolo elenco | 108 |
| Aggiornare un singolo elenco di selezione | 12 |
Gestione dei tavoli condivisi
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di tabelle condivise | 90 |
| Creare una nuova tabella condivisa | 8 |
| Eliminare una singola tabella condivisa | 10 |
| Recuperare una singola tabella condivisa | 366 |
Gestione della tabella
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di tabelle | 220 |
| Creare una nuova tabella | 100 |
| Eliminare una singola tabella | 45 |
| Recuperare una singola tabella | 700 |
| Aggiornare una singola tabella | 25 |
| Recuperare un elenco di persone a carico | 60 |
| Importare un singolo file | 30 |
| Disimportare un singolo file | 170 |
| Recuperare le informazioni sull'importazione | 50 |
| Importazione da fogli di calcolo | 10 |
Gestione dei tag
| Richiesta | Limite al minuto per area di lavoro |
| Recuperare un elenco di etichette | 50 |
| Creare un nuovo tag | 10 |
| Eliminare un singolo tag | 10 |
| Aggiornare un singolo tag | 10 |
Gestione dei gettoni
| Richiesta | Limite al minuto per area di lavoro |
| Creare un nuovo token | 150 |
Utilità
| Richiesta | Limite al minuto per area di lavoro |
| Analizzare una data | 10 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
Limiti di archiviazione e di interrogazione
Attualmente l'API limita le dimensioni dell'archiviazione a vita e le interrogazioni annuali in base al livello di abbonamento. Questi limiti si basano sul totale dei byte scansionati, non sulla dimensione del risultato creato dalla query. I proprietari dello spazio di lavoro possono tenere traccia del loro utilizzo per verificare che la loro organizzazione rientri nei limiti previsti.
| Abbonamento | Conservazione a vita | Interrogazione annuale |
|---|---|---|
| Soluzione | 100GB | 120TB |
| Impresa | 500GB | 3.000TB |
In termini reali, un solo GB di memoria per cinque anni può contenere 8 milioni di record, tra cui:
- Rilevazioni mensili ridotte di 10 dimensioni
- Previsioni mensili su 12 mesi
- Dati di bilancio
Si consiglia di scegliere un livello di abbonamento in base alle proprie esigenze di archiviazione o di interrogazione. Ad esempio:
- Con un abbonamento a Solution , è possibile interrogare una tabella con 100 GB di dati 1.200 volte all'anno; oppure una tabella con 50 GB di dati, 2400 volte all'anno.
- Con un abbonamento a Enterprise , il limite di 3000 TB di query consente di interrogare i dati 3 volte all'anno.
Per acquistare ulteriore spazio di archiviazione a vita, contattare il proprietario dell'account o il responsabile del successo del cliente.
Nota: Si tratta di limiti rigidi, il che significa che le importazioni o le query future non possono essere completate una volta raggiunto il limite. Ad esempio, non sarà possibile importare insiemi di dati nelle tabelle oltre il limite di archiviazione e le query di Wdata falliranno una volta superato il limite di query.
Timeout
L'API Wdata di Workiva limita attualmente la durata di ogni richiesta a 10 minuti.
Si noti che i timeout possono variare a seconda dell'API di Workiva a cui ci si connette. Per saperne di più, visitate il Workiva Developer Hub.
Dimensione del carico utile
L'API di Workiva limita la dimensione di ogni richiesta a un massimo di 10485760 byte (10MB). Si tratta di un limite impostato per tutte le API di Workiva.
Crittografia
Per garantire la privacy e l'integrità dei dati, le chiamate API utilizzano Transport Layer Security (TLS) 1.3; Advanced Encryption Standard (AES) 256 a riposo.