Aby zapewnić spójną wydajność, funkcje Wdata i interfejs API dla deweloperów — umożliwiający niestandardową integrację w celu połączenia danych z platformą Workiva — nakładają kilka ograniczeń.
Mimo że ograniczenia te wyznaczają granice Twojej przestrzeni roboczej, zalecamy, abyś w miarę możliwości samodzielnie ograniczył liczbę zestawów danych. Dodatkowe zestawy danych mają kaskadowy wpływ na czas przetwarzania. Możesz zauważyć spowolnienie wydajności, gdy zbliżysz się do tych limitów lub uruchomisz szczególnie złożone zapytania.
Tabele, zapytania, widoki i łańcuchy
Usługa Wdata nakłada szereg ograniczeń na tabele, zapytania, widoki i łańcuchy.
Tabele
| Funkcja | Limit |
|---|---|
| Przesyłanie plików |
Zalecany rozmiar pliku: 300 MB lub mniej Maksymalny rozmiar pliku : 1 GB Format pliku: CSV lub TSV Uwaga: Pliki ZIP można wykorzystać do zmniejszenia rozmiaru przesyłanych danych, jednak nie spowoduje to poprawy wydajności zapytań. |
| Kolumny na tabelę | 150 |
| Tabele faktów | 1 miliard wierszy |
| Tabele wymiarów |
Zalecane: 1 milion wierszy lub mniej Maksymalnie: 2 miliony wierszy |
| Połączenia na arkusz kalkulacyjny | 300 przychodzących i 300 wychodzących |
| Wartości tagów |
Maksymalnie: 300 Zamiast dodawać dodatkowe wartości znaczników, zalecamy utworzenie osobnej tabeli odnośników lub użycie zapytań w celu utworzenia tabeli łączącej w arkuszach kalkulacyjnych. |
Zapytania
| Funkcja | Limit |
|---|---|
| Parametry na zapytanie | 30 |
| Nazwa parametru zapytania | 256 znaków |
| Elementy na liście wyboru parametrów | 512 |
| Instrukcja edytora zapytania SQL | 30 000 znaków |
| Połączone zapytania dla każdego arkusza kalkulacyjnego, dokumentu lub prezentacji | 100 |
| Komórki na arkusz kalkulacyjny | 3,000,000 |
|
20 |
Widoki
| Funkcja | Limit |
|---|---|
| Zapytaj o wiersze na widok | 1,000,000 |
Uwaga : Spróbuj zmniejszyć rozmiar zapytania, dodając klauzulę LIMIT.
Więzy
| Funkcja | Limit |
|---|---|
| Połączenia | Jeden egzemplarz dostarczany jest w ramach subskrypcji Solution, pięć w ramach subskrypcji Enterprise. Aby zakupić dodatkowe połączenia, skontaktuj się z menedżerem ds. obsługi klienta. |
| Zmienne | Nie narzucamy już limitu, ale zaobserwowaliśmy pogorszenie reakcji aplikacji, gdy łańcuchy zbliżają się do zakresu ponad 1000 zmiennych. |
| Powiadomienia |
40 MB na wiadomości e-mail wychodzące Uwaga: Ten limit wysyłania nie ma wpływu na limit odbierania ustalony przez niektórych zewnętrznych dostawców. |
Limity szybkości API
Podane poniżej limity szybkości obowiązują na poziomie obszaru roboczego, a nie dla każdego użytkownika. Jeśli przekroczysz te limity, otrzymasz odpowiedź o błędzie z kodem statusu 429 Zbyt wiele żądań .
Należy również pamiętać, że API ogranicza długość żądania do 10 minut.
Uwaga : API może dodatkowo ograniczać Twoje żądania na podstawie bieżącego obciążenia systemu lub nadmiernej częstotliwości. W przypadku szczególnie intensywnego wykorzystania przepustowości, na przykład w przypadku przetwarzania dużego zbioru danych w krótkim okresie czasu, może wystąpić niewielkie opóźnienie, aby zapewnić stałą wydajność systemu.
Zadania administracyjne
| Wniosek | Limit na minutę na obszar roboczy |
| Usuń pojedynczy obszar roboczy | 5 |
| Eksportuj pojedynczy obszar roboczy | 5 |
| Importuj dane | 5 |
| Pobierz pliki obszaru roboczego według rozmiaru | 10 |
| Pobierz użycie zapytania dotyczącego obszaru roboczego | 55 |
| Pobierz użycie przesyłania obszaru roboczego | 50 |
| Sprawdź poprawność plików | 5 |
| Sprawdź poprawność tabel | 5 |
Chains
W przypadku API obowiązują limity dzienne i krótkoterminowe.
Ograniczenia:
- 50 000 żądań do API w ciągu 24 godzin
- Limit 100 żądań w ciągu 20 sekund
Zarządzanie połączeniami
| Wniosek | Limit na minutę na obszar roboczy |
| Uzyskaj szczegóły połączenia | 515 |
| Wyświetl połączenia | 2000 |
| Odśwież połączenie | 203 |
| Odśwież partię połączeń | 20 |
| Uzyskaj status odświeżania wsadowego | 1000 |
| Odśwież status połączenia | 1000 |
Zarządzanie plikami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę plików | 650 |
| Prześlij pojedynczy plik | 50 |
| Usuń pojedynczy plik | 50 |
| Pobierz pojedynczy plik | 150 |
| Pobierz pojedynczy plik | 50 |
| Pobierz błędy | 20 |
| Eksportuj plik do arkuszy kalkulacyjnych | 5 |
Zarządzanie folderami
| Wniosek | Limit na minutę na obszar roboczy |
| Wyszukaj | 150 |
| Pobierz listę folderów | 150 |
| Utwórz nowy folder | 150 |
| Usuń pojedynczy folder | 150 |
| Pobierz pojedynczy folder | 150 |
| Zaktualizuj pojedynczy folder | 150 |
| Pobierz listę zawartości folderu | 150 |
| Przenieś zawartość do folderu | 150 |
Zarządzanie parametrami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz parametry | 50 |
| Utwórz parametr | 10 |
| Usuń parametr | 50 |
| Pobierz parametr | 10 |
| Aktualizuj parametr | 10 |
Zarządzanie widokiem obrotowym
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę widoków obrotowych | 50 |
| Utwórz nowy widok obrotowy | 10 |
| Usuń pojedynczy widok obrotowy | 50 |
| Pobierz pojedynczy widok obrotowy | 50 |
| Aktualizuj pojedynczy widok obrotowy | 10 |
Zarządzanie zapytaniami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę zapytań | 192 |
| Utwórz nowe zapytanie | 57 |
| Pobierz dane z kolumny zapytania | 255 |
| Analizuje zapytanie, aby ustalić, czy jest ono prawidłowe | 255 |
| Usuń pojedyncze zapytanie | 150 |
| Pobierz pojedyncze zapytanie | 1139 |
| Zaktualizuj pojedyncze zapytanie | 93 |
| Pobierz zależności | 10 |
| Pobierz listę osób na utrzymaniu | 60 |
| Pobierz listę wyników zapytania | 39 |
| Wykonaj zapytanie | 400 |
| Anuluj uruchomione zapytanie | 25 |
| Pobierz pojedynczy wynik zapytania | 1200 |
| Pobierz wynik zapytania | 100 |
| Eksportuj wynik zapytania do arkuszy kalkulacyjnych | 400 |
Wybierz zarządzanie listą
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę wybranych list | 10 |
| Utwórz nową listę wyboru | 36 |
| Usuń pojedynczą listę wyboru | 10 |
| Pobierz pojedynczą listę | 108 |
| Zaktualizuj pojedynczą listę wyboru | 12 |
Współdzielone zarządzanie tabelami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę współdzielonych tabel | 90 |
| Utwórz nową współdzieloną tabelę | 8 |
| Usuń pojedynczą współdzieloną tabelę | 10 |
| Pobierz pojedynczą współdzieloną tabelę | 366 |
Zarządzanie tabelami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę tabel | 220 |
| Utwórz nową tabelę | 100 |
| Usuń pojedynczą tabelę | 45 |
| Pobierz pojedynczą tabelę | 700 |
| Zaktualizuj pojedynczą tabelę | 25 |
| Pobierz listę osób na utrzymaniu | 60 |
| Importuj pojedynczy plik | 50 |
| Odimportuj pojedynczy plik | 170 |
| Pobierz informacje o imporcie | 50 |
| Importuj z arkuszy kalkulacyjnych | 10 |
Zarządzanie tagami
| Wniosek | Limit na minutę na obszar roboczy |
| Pobierz listę tagów | 50 |
| Utwórz nowy tag | 10 |
| Usuń pojedynczy tag | 10 |
| Zaktualizuj pojedynczy tag | 10 |
Zarządzanie tokenami
| Wniosek | Limit na minutę na obszar roboczy |
| Utwórz nowy token | 150 |
Usługi komunalne
| Wniosek | Limit na minutę na obszar roboczy |
| Analizuj datę | 10 |
Limity pamięci masowej i zapytań
Obecnie interfejs API ogranicza rozmiar pamięci masowej na całe życie oraz rocznych zapytań w zależności od poziomu subskrypcji. Limity te opierają się na całkowitej liczbie przeskanowanych bajtów, a nie na rozmiarze wyniku wygenerowanego przez zapytanie. Właściciele przestrzeni roboczej mogą śledzić jej wykorzystanie , aby sprawdzić, czy ich organizacja mieści się w tych ograniczeniach.
| Prenumerata | Dożywotnie przechowywanie | Roczne zapytania |
|---|---|---|
| Rozwiązanie | 100GB | 120TB |
| Przedsiębiorstwo | 500GB | 3000 TB |
W praktyce zaledwie 1 GB pamięci masowej w ciągu pięciu lat może pomieścić 8 milionów rekordów, w tym:
- Miesięczne wartości rzeczywiste podzielone na 10 wymiarów
- Miesięczne prognozy toczące się na okres 12 miesięcy
- Dane budżetowe
Zalecamy wybranie poziomu subskrypcji odpowiadającego Twoim potrzebom w zakresie przechowywania danych lub zapytań. Na przykład:
- Dzięki subskrypcji Solution możesz wykonać zapytanie do tabeli zawierającej 100 GB danych 1200 razy w roku lub do tabeli zawierającej 50 GB danych 2400 razy w roku.
- W przypadku subskrypcji Enterprise limit zapytań wynoszący 3000 TB umożliwia wykonywanie zapytań dotyczących danych 3 mln razy w roku.
Aby zakupić dodatkową, dożywotnią przestrzeń dyskową, skontaktuj się z właścicielem konta lub menedżerem ds. obsługi klienta.
Uwaga: Są to sztywne limity, co oznacza, że po osiągnięciu limitu nie będzie można wykonać żadnych przyszłych importów ani zapytań. Na przykład nie będziesz mógł importować zestawów danych do tabel wykraczających poza limit pamięci, a zapytania Wdata zakończą się niepowodzeniem po przekroczeniu limitu.
Przerwy
Obecnie interfejs API Workiva Wdata ogranicza długość każdego żądania do 10 minut.
Należy pamiętać, że limity czasu mogą się różnić w zależności od interfejsu API Workiva, z którym się łączysz. Dowiedz się więcej w Centrum programistów Workiva.
Rozmiar ładunku
Interfejs API Workiva ogranicza rozmiar dowolnego żądania do maksymalnie 10485760 bajtów (10 MB). Jest to ustalony limit dla wszystkich interfejsów API Workiva.
Szyfrowanie
Aby zagwarantować prywatność i integralność danych, wywołania API korzystają z Transport Layer Security (TLS) 1.3 i Advanced Encryption Standard (AES) 256 w stanie spoczynku.