为帮助确保性能的一致性,Wdata 的功能和 开发人员应用编程接口 (API)(可通过自定义集成将您的数据与 Workiva 平台连接起来)执行了多项限制。
虽然这些限制为您的工作空间提供了界限,但我们建议您尽可能自我限制数据集的数量。额外的数据集会对处理时间产生连带影响,当接近这些限制或运行特别复杂的查询时,您可能会发现性能减慢。
表、查询、视图和链
Wdata 会对表、查询、视图和链执行一系列功能限制。
表格
特点 | 限制 |
---|---|
文件上传 |
建议文件大小: 300 MB 或以下 最大文件大小: 1 GB 文件格式: CSV 或 TSV 注意: ZIP 文件可用于减小上传大小,但不会提高查询性能。 |
每个表格的列数 | 150 |
事实表 | 10 亿行 |
尺寸表 |
建议使用: 100 万行或以下 最大: 200 万行 |
每个电子表格的连接数 | 100 个传入和 100 个传出 |
标签值 |
最大值 300 与其添加额外的标签值,我们建议创建一个单独的查找表,或使用 查询 在电子表格中创建一个连接表。 |
查询
特点 | 限制 |
---|---|
每次查询的参数 | 30 |
查询参数名称 | 256 个字符 |
每个参数选单的项目 | 512 |
查询 SQL 编辑器语句 | 30,000 个字符 |
为每个电子表格、文档或演示文稿连接查询 | 100 |
每个电子表格的单元格数 | 2,000,000 |
SQL 编辑器中的 UNION 操作符 |
20 |
查看
特点 | 限制 |
---|---|
每个视图的查询行数 | 1,000,000 |
注意:尝试通过添加 LIMIT 子句来减少查询量。
链结
特点 | 限制 |
---|---|
连线 | 一个提供解决方案订阅;五个提供企业订阅。如需购买更多连接,请联系您的客户成功经理。 |
变量 | 每条链 100 个 |
通知 |
40MB 用于外发电子邮件 注: 此发送限制不影响某些第三方供应商设置的接收限制。 |
API 速率限制
下面的费率限制是在工作区一级执行的,而不是按每个用户执行的。如果超过这些限制,您将收到状态代码为 429 太多请求的错误响应
。
您还应注意,API 将任何请求的长度限制为 10 分钟。
注:API 可能会根据当前系统负载或过高的频率对您的请求进行额外限制。特别是带宽密集型运行,例如在短时间内对大型数据集的运行,可能会产生轻微延迟,以确保系统保持高性能。
行政任务
请求 | 每个工作区每分钟的限制 |
删除单个工作区 | 5 |
导出单个工作区 | 5 |
导入数据 | 5 |
按大小检索工作区文件 | 10 |
检索工作区查询使用情况 | 55 |
检索工作区上传使用情况 | 50 |
验证文件 | 5 |
验证表格 | 5 |
链结
每日和短期限额均适用于 API。
限制:
- 24 小时内向应用程序接口发出 50,000 次请求
- 20 秒内 100 次请求的突发限制
连接管理
请求 | 每个工作区每分钟的限制 |
获取连接详情 | 515 |
连接清单 | 2000 |
重新整理连线 | 203 |
刷新一批连接 | 20 |
获取批量刷新的状态 | 1000 |
获取刷新连接状态 | 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 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
存储和查询限制
目前,应用程序接口会根据订阅级别限制终生存储和年度查询的大小。这些限制基于扫描的总字节数,而不是查询结果的大小。工作空间所有者可以 跟踪其使用情况 ,以验证其组织是否在这些限制范围内。
订阅 | 终生存储 | 年度查询 |
---|---|---|
解决方案 | 100GB | 120TB |
企业 | 500GB | 3,000TB |
在现实世界中,仅 1GB 的存储空间在五年内就可存储 800 万条记录,其中包括:
- 每月实际支出减少 10
- 每月滚动 12 个月预测
- 预算数据
我们建议您根据自己的存储或查询需求选择订阅级别。例如
- 通过 解决方案 订阅,您每年可查询 100GB 数据的表 1200 次;或查询 50GB 数据的表 2400 次。
- 通过 Enterprise 订阅,3000TB 的查询限制允许您每年查询数据 3M 次。
如需购买额外的终身存储空间,请联系您的账户所有人或客户成功经理。
注: 这些都是硬上限,即一旦达到上限,就无法完成今后的导入或查询。例如,如果数据集超过存储限制,就无法将其导入表中,而且一旦超过查询限制,Wdata 查询就会失败。
超时
Workiva Wdata API 目前将任何请求的长度限制为 10 分钟。
请注意,超时时间可能因您连接的 Workiva API 而异。了解更多信息,请访问 Workiva 开发人员中心。
有效载荷大小
Workiva API 将任何请求的大小限制为最大 10485760 字节(10MB)。这是所有 Workiva API 的设定限制。
加密
为确保数据的私密性和完整性,API 调用使用传输层安全(TLS)1.3;静态高级加密标准(AES)256。