일관된 성능을 보장하기 위해 Wdata의 기능과 개발자 API(애플리케이션 프로그래밍 인터페이스)에 따른 여러 제한이 적용됩니다. 개발자 API를 사용하면 사용자 지정 통합으로 데이터와 Workiva 플랫폼을 연결할 수 있습니다.
이러한 제약 조건은 Workspace에 대한 경계를 부여하지만, 가능하면 데이터 세트 수를 자체적으로 한도를 정하는 것이 좋습니다.데이터 세트를 추가하면 처리 시간에 연속적으로 영향을 미치며, 한도에 도달하거나 복잡한 쿼리를 실행할 때 성능이 저하될 수 있습니다.
테이블, 쿼리, 뷰, 체인
Wdata는 테이블, 쿼리, 보기, 체인에 대해 여러 기능 제한을 적용합니다.
테이블
| 기능 | 제한 |
|---|---|
| 파일 업로드 |
권장 파일 크기: 300MB 이하 최대 파일 크기 : 1GB 파일 형식: CSV 또는 TSV 참고: ZIP 파일을 사용하여 업로드 크기를 줄일 수 있지만 쿼리 성능이 향상되지는 않습니다. |
| 테이블당 열 수 | 150 |
| 팩트 테이블 | 10억 행 |
| 차원 테이블 |
권장: 100만 행 이하 최대: 2백만 행 |
| 스프레드시트당 연결된 데이터세트 수 | 100 |
| 태그 값 |
최대: 300 추가 태그 값을 추가하는 것보다 별도의 조회 테이블을 생성하거나 쿼리 를 사용하여 스프레드시트에서 조인 테이블을 생성하는 것이 좋습니다. |
쿼리
| 기능 | 제한 |
|---|---|
| 쿼리당 매개 변수 | 30 |
| 쿼리 매개 변수 이름 | 256자 |
| 매개 변수 선택 목록당 항목 | 512 |
| 쿼리 SQL 편집기 명령문 | 30,000자 |
| 스프레드시트, 문서 또는 프레젠테이션당 연결된 쿼리 수 | 100 |
| 스프레드시트당 셀 | 2,000,000 |
SQL 편집기의 UNION 연산자 |
20 |
뷰
| 기능 | 제한 |
|---|---|
| 뷰당 쿼리 행 | 1,000,000 |
체인
| 기능 | 제한 |
|---|---|
| 연결 | 솔루션 구독 시 1개, 엔터프라이즈 구독 시 5개가 제공됩니다. 연결을 추가로 구입하려면 고객 성공 관리자에게 문의하십시오. |
| 변수 | 체인당 100개 |
API 비율 제한
API는 현재 시스템 부하 또는 과도한 빈도를 기준으로 요청의 비율을 제한할 수 있습니다. 이 제한을 초과하면 상태 코드 429 Too Many Requests가 포함된 오류 응답을 받게 됩니다.
또한 API는 모든 요청의 길이를 10분으로 제한합니다.
관리 태스크
| 요청 | 작업 영역 및 분당 제한 |
| 하나의 Workspace 삭제 | 5 |
| 하나의 Workspace 내보내기 | 5 |
| 데이터 가져오기 | 5 |
| 크기로 Workspace 파일 검색 | 10 |
| Workspace 쿼리 사용량 검색 | 55 |
| Workspace 업로드 사용량 검색 | 50 |
| 파일 유효성 검사 | 5 |
| 테이블 유효성 검사 | 5 |
체인
API에 일일 및 단기 한도가 모두 적용됩니다.
한도:
- 24시간 동안 API에 요청 50,000건
- 20초 동안 요청 100건 버스트 한도
연결 관리
| 요청 | 작업 영역 및 분당 제한 |
| 연결 새로 고침 | 200 |
| 연결 일괄 처리 새로 고침 | 1 |
| 연결 새로 고침 상태 가져오기 | 1000 |
파일 관리
| 요청 | 작업 영역 및 분당 제한 |
| 파일 목록 검색 | 650 |
| 하나의 파일 업로드 | 50 |
| 하나의 파일 삭제 | 50 |
| 하나의 파일 검색 | 150 |
| 하나의 파일 다운로드 | 50 |
| 오류 검색 | 20 |
| 파일을 스프레드시트로 내보내기 | 5 |
폴더 관리
| 요청 | 작업 영역 및 분당 제한 |
| 검색 | 150 |
| 폴더 목록 검색 | 150 |
| 새 폴더 만들기 | 150 |
| 하나의 폴더 삭제 | 150 |
| 하나의 폴더 검색 | 150 |
| 하나의 폴더 업데이트 | 150 |
| 폴더 내용 목록 검색 | 150 |
| 콘텐츠를 폴더로 이동 | 150 |
매개변수 관리
| 요청 | 작업 영역 및 분당 제한 |
| 매개변수 가져오기 | 50 |
| 매개 변수 만들기 | 10 |
| 매개 변수 삭제 | 50 |
| 매개변수 가져오기 | 10 |
| 매개 변수 업데이트 | 10 |
피벗 보기 관리
| 요청 | 작업 영역 및 분당 제한 |
| 피벗 보기 목록 검색 | 50 |
| 새 피벗 보기 만들기 | 10 |
| 하나의 피벗 보기 삭제 | 50 |
| 하나의 피벗 보기 검색 | 50 |
| 하나의 피벗 보기 업데이트 | 10 |
쿼리 관리
| 요청 | 작업 영역 및 분당 제한 |
| 쿼리 목록 검색 | 192 |
| 새 쿼리 만들기 | 57 |
| 쿼리 열 데이터 검색 | 255 |
| 쿼리를 구문 분석하여 유효한지 확인 | 255 |
| 하나의 쿼리 삭제 | 150 |
| 하나의 쿼리 검색 | 1139 |
| 하나의 쿼리 업데이트 | 93 |
| 종속 검색 | 10 |
| 종속 목록 검색 | 60 |
| 쿼리 결과 목록 검색 | 39 |
| 쿼리 실행 | 400 |
| 실행 중인 쿼리 취소 | 25 |
| 하나의 쿼리 결과 검색 | 1200 |
| 쿼리 결과 다운로드 | 100 |
| 쿼리 결과를 스프레드시트로 내보내기 | 400 |
목록 선택 관리
| 요청 | 작업 영역 및 분당 제한 |
| 선택 목록의 목록 검색 | 10 |
| 새 선택 목록 만들기 | 36 |
| 하나의 선택 목록 삭제 | 10 |
| 하나의 목록 검색 | 108 |
| 하나의 선택 목록 업데이트 | 12 |
공유 테이블 관리
| 요청 | 작업 영역 및 분당 제한 |
| 공유 테이블 목록 검색 | 90 |
| 새 공유 테이블 생성 | 8 |
| 하나의 공유 테이블 삭제 | 10 |
| 하나의 공유 테이블 검색 | 366 |
테이블 관리
| 요청 | 작업 영역 및 분당 제한 |
| 테이블 목록 검색 | 220 |
| 새 테이블 만들기 | 100 |
| 하나의 테이블 삭제 | 45 |
| 하나의 테이블 검색 | 700 |
| 하나의 테이블 업데이트 | 25 |
| 종속 목록 검색 | 60 |
| 하나의 파일 가져오기 | 30 |
| 하나의 파일 가져오기 취소 | 170 |
| 가져오기 정보 검색 | 50 |
| 스프레드시트에서 가져오기 | 10 |
태그 관리
| 요청 | 작업 영역 및 분당 제한 |
| 태그 목록 검색 | 50 |
| 새 태그 만들기 | 10 |
| 하나의 태그 삭제 | 10 |
| 하나의 태그 업데이트 | 10 |
토큰 관리
| 요청 | 작업 영역 및 분당 제한 |
| 새 토큰 만들기 | 150 |
유틸리티
| 요청 | 작업 영역 및 분당 제한 |
| 날짜 구문 분석 | 10 |
스토리지 및 쿼리 제한
API는 현재 구독 수준에 따라 라이프타임 스토리지와 연간 쿼리 크기를 제한합니다. 이러한 제한은 쿼리로 인해 도출된 결과의 크기가 아니라 스캔된 총 바이트 기준입니다. 워크스페이스 소유자는 사용량을 추적하여 조직이 이러한 제한 범위 내에 있는지 확인할 수 있습니다.
| 구독 | 라이프타임 스토리지 | 연간 쿼리 |
|---|---|---|
| 솔루션 | 100GB | 120TB |
| 엔터프라이즈 | 500GB | 3,000TB |
실제로 5년 동안의 단 1GB 스토리지에는 다음을 포함하는 8M의 레코드가 포함될 수 있습니다.
- 10개 차원으로 분류한(cut) 월별 실제 데이터
- 월별 12개월 예측 데이터
- 예산 데이터
스토리지 또는 쿼리 요구에 따라 구독 수준을 선택하는 것이 좋습니다. 예를 들어 다음과 같습니다.
- 솔루션 구독을 사용하면 100GB 데이터가 있는 테이블을 1년에 1,200회(50GB 데이터가 있는 테이블은 1년에 2,400회) 쿼리할 수 있습니다.
- 엔터프라이즈 구독을 사용하면 3,000TB 쿼리 제한으로 1년에 3백만 번 데이터를 쿼리할 수 있습니다.
추가로 라이프타임 스토리지를 구매하려면 어카운트 소유자나 고객 성공 관리자에게 문의하십시오.
참고: 이러한 제한은 하드 캡이므로, 해당 제한에 도달하면 이후의 가져오기나 쿼리는 완료할 수 없습니다. 예를 들어, 스토리지 제한을 초과하여 테이블로 데이터 세트를 가져올 수 없으며, 쿼리 제한을 초과하면 Wdata 쿼리가 실패합니다.
시간 초과
Workiva Wdata API는 현재 모든 요청의 길이를 10분으로 제한합니다.
연결하는 Workiva API에 따라 시간 초과가 다를 수 있습니다. Workiva 개발자 허브에서 자세히 알아보세요.
페이로드 사이즈
Workiva API는 모든 요청의 크기를 10485760바이트(10MB) 이하로 제한합니다. 모든 Workiva API에 대해 설정된 제한입니다.
암호화
데이터 프라이버시와 무결성을 보장하기 위해 API 호출은 TLS(Transport Layer Security) 1.3을 사용합니다. AES(Advanced Encryption Standard) 256은 사용하지 않습니다.