VMware vSphere Web Services SDK编程指南（七）- 7.7 服务器数据传输和 PropertyCollector 性能

7.7 服务器数据传输和 PropertyCollector 性能

---

本章包括以下主题：

■ 7.1 PropertyCollector 介绍
■ 7.2 用于属性收集的 vSphere 数据对象
■ 7.3 用于属性收集的 vSphere 方法
■ 7.4 PropertyCollector 示例 (RetrievePropertiesEx)
■ 7.5 清单遍历
■ 7.6 客户端数据同步(WaitForUpdatesEx)
■ 7.7 服务器数据传输
■ 7.8 PropertyCollector 性能
■ 7.9 SearchIndex

本小节续前面章节继续翻译后续内容

---

7.7 服务器数据传输

属性收集可以涉及大量数据的检索，取决于集合请求中所隐含的属性的数量。vSphere 服务器发送收集的数据到客户端时支持分段或者分组块数据传输。如果收集的数据量超过了块大小，服务器在单个响应中返回一个数据块，并表明还可以检索额外的数据。
关于块大小的信息，可查阅在 vSphere API Reference 中的 RetrieveOptions.maxObjects and WaitOptions.maxObjectUpdates 属性描述。

■ WaitForUpdatesEx 方法返回一个 UpdateSet 数据对象，UpdateSet.truncated 属性指示是否必须再次调用 WaitForUpdatesEx 来检索额外的数据。如果 truncated 为 true，WaitForUpdatesEx 方法返回一个版本字符串来标识分块数据。
当你的客户端应用程序接收到额外的数据可用的指示时，它必须发送在后续对 WaitForUpdatesEx 方法调用时所返回 UpdateSet.version 字符串，以获取下一个数据块。

■ RetrievePropertiesEx 方法返回一个 RetrieveResult 数据对象，RetrieveResult.token 属性指示是否必须调用ContinueRetrievePropertiesEx 方法以检索额外的数据。如果 token 属性有值，它标识分块数据。
当你的客户端应用程序接收到额外的数据可用的指示时，它必须发送在后续对 ContinueRetrievePropertiexEx 方法调用时所返回令牌，以获取下一个数据块。

版本字符串和令牌是有顺序的，客户端应用程序必须保持跟踪这些值的顺序。
如果一个错误中断了收集操作，通过使用这些在中断之前提交的版本字符串或令牌来恢复操作。

7.8 PropertyCollector 性能

下列的因素可以影响任何给定会话的 PropertyCollector 的性能

■ 收集对象的数量

■ 收集的属性数量

■ 属性数据的密度（复合数据结构、嵌套数据对象）

■ 服务器上的对象和属性频繁的更改

■ 遍历的深度（遍历的属性数量）

另外，vSphere 服务器受 PropertyCollector 实例数量及过滤器数量的影响，并且每个实例都支持服务器上的所有会话。

为了最小化客户端应用程序的 PropertyCollector 开销和网络流量，结合 PropertyCollector 一起使用 View 对象，简单 PropertyCollector 示例 （Java）演示了结合 PropertyCollector 使用视图的例子。

---

原文：
VMware vSphere 6.5 Documentation Center：Server Data Transmission

VMware vSphere 6.5 Documentation Center：PropertyCollector Performance