Um eine konsistente Leistung zu gewährleisten, setzen die Funktionen von Wdata und die API (Application Programming Interface)- die eine benutzerdefinierte Integration zur Verbindung Ihrer Daten mit der Workiva-Plattform ermöglicht - mehrere Grenzen.
Auch wenn diese Einschränkungen Ihrem Arbeitsbereich Grenzen setzen, empfehlen wir Ihnen, die Anzahl der Datensätze nach Möglichkeit selbst zu begrenzen. Zusätzliche Datensätze haben einen kaskadierenden Effekt auf die Verarbeitungszeit, und Sie können eine verringerte Leistung feststellen, wenn Sie sich diesen Grenzen nähern oder besonders komplexe Abfragen ausführen.
Tabellen, Abfragen, Ansichten und Ketten
Wdata erzwingt eine Reihe von Funktionsbeschränkungen für Tabellen, Abfragen, Ansichten und Ketten.
Tabellen
| Merkmal | Grenzwert |
|---|---|
| Hochladen von Dateien |
Empfohlene Dateigröße: 300 MB oder weniger Maximale Dateigröße: 1 GB Dateiformat: CSV oder TSV Hinweis: ZIP-Dateien können verwendet werden, um die Upload-Größe zu verringern, aber sie führen nicht zu einer verbesserten Abfrageleistung. |
| Spalten pro Tabelle | 150 |
| Faktentabellen | 1 Milliarde Zeilen |
| Maßtabellen |
Empfohlen: 1 Million Zeilen oder weniger Maximum: 2 Millionen Zeilen |
| Verbindungen pro Tabellenkalkulation | 100 eingehende und 100 ausgehende |
| Tag-Werte |
Maximum: 300 Anstatt zusätzliche Tag-Werte hinzuzufügen, empfehlen wir, entweder eine separate Nachschlagetabelle zu erstellen oder Abfragen zu verwenden, um eine Join-Tabelle in Tabellenkalkulationen zu erstellen. |
Abfragen
| Merkmal | Grenzwert |
|---|---|
| Parameter pro Abfrage | 30 |
| Name des Abfrageparameters | 256 Zeichen |
| Positionen pro Parameter Auswahlliste | 512 |
| Abfrage SQL Editor-Anweisung | 30.000 Zeichen |
| Verbundene Abfragen pro Tabellenkalkulation, Dokument oder Präsentation | 100 |
| Zellen pro Arbeitsblatt | 2,000,000 |
UNION Operatoren im SQL Editor |
20 |
Ansichten
| Merkmal | Grenzwert |
|---|---|
| Abfrage von Zeilen pro Ansicht | 1,000,000 |
Hinweis: Versuchen Sie, die Größe Ihrer Abfrage durch Hinzufügen einer LIMIT-Klausel zu verringern.
Ketten
| Merkmal | Grenzwert |
|---|---|
| Verbindungen | Eine wird mit einem Solution-Abonnement geliefert, fünf mit Enterprise. Um zusätzliche Verbindungen zu erwerben, wenden Sie sich an Ihren Customer Success Manager. |
| Variablen | 100 pro Kette |
| Benachrichtigungen |
40 MB für ausgehende E-Mails Hinweis: Dieses Sende-Limit hat keinen Einfluss auf das Empfangs-Limit, das von einigen Drittanbietern festgelegt wurde. |
Grenzwerte für API-Sätze
Die nachstehenden Ratenbeschränkungen werden auf der Ebene des Arbeitsbereichs und nicht auf der Ebene des einzelnen Benutzers durchgesetzt. Wenn Sie diese Grenzen überschreiten, erhalten Sie eine Fehlerantwort mit dem Statuscode 429 Too Many Requests.
Sie sollten auch beachten, dass die API die Länge jeder Anfrage auf 10 Minuten begrenzt.
Hinweis: Die API kann Ihre Anfragen aufgrund der aktuellen Systemauslastung oder übermäßiger Häufigkeit zusätzlich begrenzen. Bei besonders bandbreitenintensiven Läufen, z. B. bei der Bearbeitung eines großen Datensatzes über einen kurzen Zeitraum, kann es zu einer leichten Verzögerung kommen, um die Leistungsfähigkeit des Systems aufrechtzuerhalten.
Administrative Aufgaben
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Einen einzelnen Arbeitsbereich löschen | 5 |
| Einen einzelnen Arbeitsbereich exportieren | 5 |
| Daten importieren | 5 |
| Abrufen von Arbeitsbereichsdateien nach Größe | 10 |
| Abrufen der Arbeitsbereich-Abfragenutzung | 55 |
| Abrufen der Upload-Nutzung des Arbeitsbereichs | 50 |
| Dateien validieren | 5 |
| Tabellen validieren | 5 |
Ketten
Für die API gelten sowohl Tages- als auch Kurzzeitlimits.
Grenzwerte:
- 50.000 Anfragen an die API innerhalb eines Zeitraums von 24 Stunden
- Burst-Limit von 100 Anfragen innerhalb eines Zeitraums von 20 Sekunden
Verwaltung der Verbindungen
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Verbindungsdetails abrufen | 515 |
| Verbindungen auflisten | 2000 |
| Verbindung aktualisieren | 203 |
| Stapel von Verbindungen aktualisieren | 20 |
| Abrufen des Status einer Chargenaktualisierung | 1000 |
| Aktualisierungsstatus der Verbindung abrufen | 1000 |
Dateiverwaltung
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von Dateien | 650 |
| Eine einzelne Datei hochladen | 50 |
| Löschen einer einzelnen Datei | 50 |
| Eine einzelne Datei abrufen | 150 |
| Herunterladen einer einzelnen Datei | 50 |
| Fehler abrufen | 20 |
| Exportieren einer Datei in Tabellenkalkulationen | 5 |
Verwaltung von Ordnern
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Suchen | 150 |
| Abrufen einer Liste von Ordnern | 150 |
| Einen neuen Ordner erstellen | 150 |
| Löschen eines einzelnen Ordners | 150 |
| Einen einzelnen Ordner abrufen | 150 |
| Einen einzelnen Ordner aktualisieren | 150 |
| Abrufen einer Liste von Ordnerinhalten | 150 |
| Inhalte in einen Ordner verschieben | 150 |
Verwaltung der Parameter
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Parameter abrufen | 50 |
| Parameter erstellen | 10 |
| Parameter löschen | 50 |
| Parameter holen | 10 |
| Parameter aktualisieren | 10 |
Verwaltung der Pivot-Ansicht
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von Pivot-Ansichten | 50 |
| Eine neue Pivot-Ansicht erstellen | 10 |
| Löschen einer einzelnen Pivot-Ansicht | 50 |
| Abrufen einer einzelnen Pivot-Ansicht | 50 |
| Aktualisieren einer einzelnen Pivot-Ansicht | 10 |
Verwaltung der Abfragen
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Liste der Abfragen abrufen | 192 |
| Erstellen Sie eine neue Abfrage | 57 |
| Abfragespalten-Daten abrufen | 255 |
| Analysiert die Abfrage, um festzustellen, ob sie gültig ist | 255 |
| Löschen einer einzelnen Abfrage | 150 |
| Eine einzelne Abfrage abrufen | 1139 |
| Eine einzelne Abfrage aktualisieren | 93 |
| Abhängigkeiten abrufen | 10 |
| Abrufen einer Liste von Familienangehörigen | 60 |
| Abrufen einer Liste von Abfrageergebnissen | 39 |
| Ausführen einer Abfrage | 400 |
| Abbrechen einer laufenden Abfrage | 25 |
| Ein einzelnes Abfrageergebnis abrufen | 1200 |
| Download eines Abfrageergebnisses | 100 |
| Abfrageergebnis in Tabellenkalkulationen exportieren | 400 |
Listenverwaltung auswählen
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von Auswahllisten | 10 |
| Eine neue Auswahlliste erstellen | 36 |
| Löschen einer einzelnen Auswahlliste | 10 |
| Eine einzelne Liste abrufen | 108 |
| Eine einzelne Auswahlliste aktualisieren | 12 |
Gemeinsame Tabellenverwaltung
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von gemeinsam genutzten Tabellen | 90 |
| Erstellen Sie eine neue gemeinsame Tabelle | 8 |
| Löschen einer einzelnen gemeinsamen Tabelle | 10 |
| Abrufen einer einzelnen gemeinsamen Tabelle | 366 |
Verwaltung des Tisches
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von Tabellen | 220 |
| Erstellen Sie eine neue Tabelle | 100 |
| Löschen einer einzelnen Tabelle | 45 |
| Eine einzelne Tabelle abrufen | 700 |
| Eine einzelne Tabelle aktualisieren | 25 |
| Abrufen einer Liste von Familienangehörigen | 60 |
| Eine einzelne Datei importieren | 30 |
| Eine einzelne Datei nicht importieren | 170 |
| Abrufen von Importinformationen | 50 |
| Import aus Tabellenkalkulationen | 10 |
Tag-Verwaltung
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Abrufen einer Liste von Tags | 50 |
| Ein neues Tag erstellen | 10 |
| Löschen eines einzelnen Tags | 10 |
| Ein einzelnes Tag aktualisieren | 10 |
Token-Verwaltung
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Ein neues Token erstellen | 150 |
Versorgungsunternehmen
| Anfrage | Limit pro Minute und Arbeitsbereich |
| Parsen eines Datums | 10 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
Speicher- und Abfragegrenzen
Die API begrenzt derzeit die Größe des Lebenszeitspeichers und die jährliche Abfrage nach Abonnementstufe. Diese Grenzen basieren auf der Gesamtzahl der gescannten Bytes, nicht auf der Größe des Ergebnisses Ihrer Abfrage. Besitzer von Arbeitsbereichen können unter ihre Nutzung nachverfolgen , um zu überprüfen, ob ihre Organisation innerhalb dieser Grenzen liegt.
| Abonnement | Lagerung auf Lebenszeit | Jährliche Abfrage |
|---|---|---|
| Lösung | 100GB | 120TB |
| Unternehmen | 500GB | 3.000TB |
In der Praxis kann ein Speicherplatz von nur 1 GB über einen Zeitraum von fünf Jahren 8 Mio. Datensätze enthalten, darunter:
- Monatliche Istwerte um 10 Dimensionen gekürzt
- Monatliche rollierende 12-Monats-Prognosen
- Haushaltsdaten
Wir empfehlen Ihnen, eine Abonnementstufe zu wählen, die auf Ihren Speicher- oder Abfrageanforderungen basiert. Hier einige Beispiele:
- Mit einem Solution Abonnement können Sie eine Tabelle mit 100 GB Daten 1.200 Mal pro Jahr abfragen; oder eine Tabelle mit 50 GB Daten, 2400 Mal pro Jahr.
- Mit einem Enterprise Abonnement können Sie mit dem 3000 TB Abfragelimit 3M Mal pro Jahr Daten abfragen.
Wenn Sie zusätzlichen Speicherplatz auf Lebenszeit erwerben möchten, wenden Sie sich an Ihren Kundenbetreuer oder Kundenerfolgsmanager.
Hinweis: Hierbei handelt es sich um harte Obergrenzen, d. h. künftige Importe oder Abfragen können nicht mehr durchgeführt werden, sobald die Obergrenze erreicht ist. So können Sie beispielsweise keine Datensätze in Tabellen importieren, die Ihr Speicherlimit überschreiten, und Wdata-Abfragen schlagen fehl, sobald das Abfragelimit überschritten wird.
Zeitüberschreitungen
Die Workiva Wdata API begrenzt derzeit die Länge jeder Anfrage auf 10 Minuten.
Bitte beachten Sie, dass die Timeouts je nach Workiva API, mit der Sie sich verbinden, variieren können. Erfahren Sie mehr im Workiva Developer Hub.
Größe der Nutzlast
Die Workiva API begrenzt die Größe jeder Anfrage auf ein Maximum von 10485760 Bytes (10MB). Dies ist eine feste Grenze für alle Workiva APIs.
Verschlüsselung
Um den Datenschutz und die Integrität der Daten zu gewährleisten, verwenden API-Aufrufe Transport Layer Security (TLS) 1.3; Advanced Encryption Standard (AES) 256 im Ruhezustand.