批量操作默认将组对象更改为 false

我们优化了 GraphQL Admin API 中批量操作的输出，以提升速度和可靠性。

更新内容

批量查询（bulkOperationRunQuery）

groupObjects 参数现在默认为 false。对对象进行分组会减缓操作速度并增加失败率，尤其是在处理大型数据集时。

批量变更（bulkOperationRunMutation）

groupObjects 参数现已弃用。它不会影响输出文件的顺序，因为变更输出没有父对象。

您需要执行的操作

如果您正在运行批量查询

• 要保留分组输出：设置 groupObjects: true。

mutation { bulkOperationRunQuery( query: """ { products { edges { node { id title } } } } """ groupObjects: true // Add this to maintain grouped output ) { bulkOperation { id status } userErrors { field message } } }

如果您正在运行批量变更操作

从查询中移除 groupObjects 参数。这不会影响输出文件。

做出此更改的原因

大多数应用程序不需要分组输出，且相关的开销会对性能产生负面影响。这些更改能够提供更快速、更可预测的结果，便于大规模处理。仅当您的应用程序特别依赖于分组输出格式时，才启用 groupObjects。由于这曾是默认行为，您可以在 2025-07 之后的任何版本上通过设置 groupObjects 为 false 并测试您的应用程序来验证这一点。

为了获得最佳性能，请在 2026-01 或之后省略 groupObjects，并在您使用 2025-07 或 2025-10 时禁用此选项。

了解更多

• 批量操作查询指南
• 批量操作导入指南
• 处理 JSONL 输出