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